Merge pull request #12 from box3lab/dev

docs(contributing): 更新贡献指南和修复链接

Author: ifishcool

CONTRIBUTING.md

@@ -31,7 +31,7 @@
 
 #### 方式一：可视化编辑（推荐）
 
-- 使用在线配方编辑器：https://crafting.thedungeone7i0n.ca/
+- 使用在线配方编辑器：https://crafting.thedestruc7i0n.ca/
 - **配置选项**：在编辑器中设置 `Minecraft Version` 为 `Java 1.21.11`。
 - 在编辑器中拖拽设计配方，导出 JSON。
 - **重要**：导出的 JSON 使用原版方块 ID，你需要手动替换为神岛方块 ID（带 `box3:` 前缀）。
@@ -50,6 +50,20 @@
 box3formula/data/box3/recipe/grass.json
 ```
 
+#### 同一方块的多个合成配方
+
+- 如果一个方块只有 **一个** 合成配方：
+  - 文件名为去掉命名空间后的方块名，例如：`grass.json`、`special_grass_14.json`。
+- 如果一个方块有 **多个** 合成配方：
+  - 在方块名后追加下划线和自定义标识，例如：
+    - 以`grass`方块为例，`grass_fast.json`、`grass_slow.json`
+    - 以`special_grass_14`方块为例，`special_grass_14_mode1.json`、`special_grass_14_mode2.json`
+  - 约定形式为：`<方块名>_<自定义后缀>.json`，例如：`special_grass_14_xxx.json`。
+- **group 字段要求**：
+  - 所有属于**同一个方块**的产出配方，其 JSON 中的 `group` 字段必须与方块名完全一致（去掉命名空间）。
+  - 例如：方块 ID 为 `box3:special_grass_14`，则所有该方块的配方文件（如 `special_grass_14.json`、`special_grass_14_mode1.json`）中：
+    - `group` 字段都应为：`"special_grass_14"`。
+
 ### 3. 创建战利品表（方块破坏掉落）
 
 - 在 `box3formula/data/box3/loot_table/blocks/` 目录下新建 JSON 文件。

block_id.json

@@ -17,32 +17,32 @@
   "31": "box3:seven",
   "33": "box3:eight",
   "35": "box3:nine",
-  "37": "box3:A",
-  "39": "box3:B",
-  "41": "box3:C",
-  "43": "box3:D",
-  "45": "box3:E",
-  "47": "box3:F",
-  "49": "box3:G",
-  "51": "box3:H",
-  "53": "box3:I",
-  "55": "box3:J",
-  "57": "box3:K",
-  "59": "box3:L",
-  "61": "box3:M",
-  "63": "box3:N",
-  "65": "box3:O",
-  "67": "box3:P",
-  "69": "box3:Q",
-  "71": "box3:R",
-  "73": "box3:S",
-  "75": "box3:T",
-  "77": "box3:U",
-  "79": "box3:V",
-  "81": "box3:W",
-  "83": "box3:X",
-  "85": "box3:Y",
-  "87": "box3:Z",
+  "37": "box3:a",
+  "39": "box3:b",
+  "41": "box3:c",
+  "43": "box3:d",
+  "45": "box3:e",
+  "47": "box3:f",
+  "49": "box3:g",
+  "51": "box3:h",
+  "53": "box3:i",
+  "55": "box3:j",
+  "57": "box3:k",
+  "59": "box3:l",
+  "61": "box3:m",
+  "63": "box3:n",
+  "65": "box3:o",
+  "67": "box3:p",
+  "69": "box3:q",
+  "71": "box3:r",
+  "73": "box3:s",
+  "75": "box3:t",
+  "77": "box3:u",
+  "79": "box3:v",
+  "81": "box3:w",
+  "83": "box3:x",
+  "85": "box3:y",
+  "87": "box3:z",
   "89": "box3:cadet_blue",
   "91": "box3:sky_blue",
   "93": "box3:powder_blue",

box3formula/data/box3/loot_table/blocks/A.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:A"
+          "name": "box3:a"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/B.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:B"
+          "name": "box3:b"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/C.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:C"
+          "name": "box3:c"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/D.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:D"
+          "name": "box3:d"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/E.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:E"
+          "name": "box3:e"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/F.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:F"
+          "name": "box3:f"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/G.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:G"
+          "name": "box3:g"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}

box3formula/data/box3/loot_table/blocks/H.json

@@ -6,7 +6,7 @@
       "entries": [
         {
           "type": "minecraft:item",
-          "name": "box3:H"
+          "name": "box3:h"
         }
       ],
       "conditions": [
@@ -16,4 +16,4 @@
       ]
     }
   ]
-}
+}