diff --git a/src/main/java/top/r3944realms/lib39/base/datagen/value/Lib39LangKey.java b/src/main/java/top/r3944realms/lib39/base/datagen/value/Lib39LangKey.java
index 743dd22..a8bc7da 100644
--- a/src/main/java/top/r3944realms/lib39/base/datagen/value/Lib39LangKey.java
+++ b/src/main/java/top/r3944realms/lib39/base/datagen/value/Lib39LangKey.java
@@ -116,6 +116,9 @@ public enum Lib39LangKey implements ILangKeyValueCollection {
                         true
                 )
         );
+        /**
+         * The constant DOLL_SOUND.
+         */
         public static final LangKeyValue DOLL_SOUND = addAndRet(
                 LangKeyValue.ofKey(
                         Lib39SoundEvents.getSubTitleTranslateKey("duck_toy"), ModPartEnum.SOUND,
diff --git a/src/main/java/top/r3944realms/lib39/core/event/CommonEventHandler.java b/src/main/java/top/r3944realms/lib39/core/event/CommonEventHandler.java
index 2ae6520..50c7b00 100644
--- a/src/main/java/top/r3944realms/lib39/core/event/CommonEventHandler.java
+++ b/src/main/java/top/r3944realms/lib39/core/event/CommonEventHandler.java
@@ -241,6 +241,11 @@ public class CommonEventHandler {
         static volatile CompatManager compatManager;
 
 
+        /**
+         * On construct mod.
+         *
+         * @param event the event
+         */
         @SubscribeEvent
         public static void onConstructMod(FMLConstructModEvent event) {
             event.enqueueWork(() -> {
@@ -255,6 +260,11 @@ public class CommonEventHandler {
             });
         }
 
+        /**
+         * On fml common setup.
+         *
+         * @param event the event
+         */
         @SubscribeEvent
         public static void onFMLCommonSetup(FMLCommonSetupEvent event) {
             event.enqueueWork(() -> {
diff --git a/src/main/java/top/r3944realms/lib39/example/compat/Lib39Compat.java b/src/main/java/top/r3944realms/lib39/example/compat/Lib39Compat.java
index e7629e2..f0c1415 100644
--- a/src/main/java/top/r3944realms/lib39/example/compat/Lib39Compat.java
+++ b/src/main/java/top/r3944realms/lib39/example/compat/Lib39Compat.java
@@ -8,8 +8,17 @@ import org.jetbrains.annotations.NotNull;
 import top.r3944realms.lib39.Lib39;
 import top.r3944realms.lib39.core.compat.ICompat;
 
+/**
+ * The type Lib 39 compat.
+ */
 public class Lib39Compat implements ICompat {
+    /**
+     * The constant INSTANCE.
+     */
     public static Lib39Compat INSTANCE = new Lib39Compat();
+    /**
+     * The constant ID.
+     */
     public static ResourceLocation ID = Lib39.rl("lib39");
     @Override
     public ResourceLocation id() {
diff --git a/src/main/java/top/r3944realms/lib39/example/core/event/ExCommonEventHandler.java b/src/main/java/top/r3944realms/lib39/example/core/event/ExCommonEventHandler.java
index d3ef394..431f202 100644
--- a/src/main/java/top/r3944realms/lib39/example/core/event/ExCommonEventHandler.java
+++ b/src/main/java/top/r3944realms/lib39/example/core/event/ExCommonEventHandler.java
@@ -65,10 +65,16 @@ public class ExCommonEventHandler {
      */
     public static class Mod extends ExCommonEventHandler {
 
+        /**
+         * On register compat.
+         *
+         * @param event the event
+         */
         @SubscribeEvent
         public static void onRegisterCompat (RegisterCompatEvent event) {
             event.registerCompat(Lib39Compat.ID, Lib39Compat.INSTANCE);
         }
+
         /**
          * On fml common setup.
          *
diff --git a/src/main/java/top/r3944realms/lib39/util/nbt/NBTWriter.java b/src/main/java/top/r3944realms/lib39/util/nbt/NBTWriter.java
index 0b1f688..6956173 100644
--- a/src/main/java/top/r3944realms/lib39/util/nbt/NBTWriter.java
+++ b/src/main/java/top/r3944realms/lib39/util/nbt/NBTWriter.java
@@ -574,8 +574,8 @@ public class NBTWriter {
      * String if nbt writer.
      *
      * @param key       the key
-     * @param value     the value
      * @param condition the condition
+     * @param value     the value
      * @return the nbt writer
      */
 // 条件添加方法
@@ -590,8 +590,8 @@ public class NBTWriter {
      * Int value if nbt writer.
      *
      * @param key       the key
-     * @param value     the value
      * @param condition the condition
+     * @param value     the value
      * @return the nbt writer
      */
     public NBTWriter intValueIf(String key, boolean condition, Supplier<Integer> value) {
@@ -605,8 +605,8 @@ public class NBTWriter {
      * Long value if nbt writer.
      *
      * @param key       the key
-     * @param value     the value
      * @param condition the condition
+     * @param value     the value
      * @return the nbt writer
      */
     public NBTWriter longValueIf(String key, boolean condition, Supplier<Long> value) {
@@ -620,8 +620,8 @@ public class NBTWriter {
      * Uuid value if nbt writer.
      *
      * @param key       the key
-     * @param value     the value
      * @param condition the condition
+     * @param value     the value
      * @return the nbt writer
      */
     public NBTWriter uuidValueIf(String key, boolean condition, Supplier<UUID> value) {
@@ -635,8 +635,8 @@ public class NBTWriter {
      * Boolean value if nbt writer.
      *
      * @param key       the key
-     * @param value     the value
      * @param condition the condition
+     * @param value     the value
      * @return the nbt writer
      */
     public NBTWriter booleanValueIf(String key, boolean condition, Supplier<Boolean> value) {
diff --git a/src/main/java/top/r3944realms/lib39/util/shape/ShapeUtil.java b/src/main/java/top/r3944realms/lib39/util/shape/ShapeUtil.java
index 3b303de..879563b 100644
--- a/src/main/java/top/r3944realms/lib39/util/shape/ShapeUtil.java
+++ b/src/main/java/top/r3944realms/lib39/util/shape/ShapeUtil.java
@@ -66,7 +66,7 @@ public class ShapeUtil {
      * 创建支持全方向的形状映射（包括上下）
      *
      * @param shape 基础形状（默认为NORTH方向）
-     * @return 全方向形状映射
+     * @return 全方向形状映射 map
      */
     public static @NotNull Map<Direction, VoxelShape> createFullDirectionMap(VoxelShape shape) {
         EnumMap<Direction, VoxelShape> directionMap = new EnumMap<>(Direction.class);
@@ -157,6 +157,7 @@ public class ShapeUtil {
         }
         return result;
     }
+
     /**
      * 将形状旋转到向上方向（绕X轴-90度）
      *