Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ifishcool merged 1 commit into from
Feb 23, 2026
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
16 changes: 15 additions & 1 deletion CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@

#### 方式一：可视化编辑（推荐）

- 使用在线配方编辑器：https://crafting.thedungeone7i0n.ca/
- 使用在线配方编辑器：https://crafting.thedestruc7i0n.ca/
- **配置选项**：在编辑器中设置 `Minecraft Version` 为 `Java 1.21.11`。
- 在编辑器中拖拽设计配方，导出 JSON。
- **重要**：导出的 JSON 使用原版方块 ID，你需要手动替换为神岛方块 ID（带 `box3:` 前缀）。
Expand All @@ -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 文件。
Expand Down
52 changes: 26 additions & 26 deletions block_id.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/A.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:A"
"name": "box3:a"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/B.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:B"
"name": "box3:b"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/C.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:C"
"name": "box3:c"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/D.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:D"
"name": "box3:d"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/E.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:E"
"name": "box3:e"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/F.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:F"
"name": "box3:f"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/G.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:G"
"name": "box3:g"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/H.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:H"
"name": "box3:h"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/I.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:I"
"name": "box3:i"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/J.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:J"
"name": "box3:j"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/K.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:K"
"name": "box3:k"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/L.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:L"
"name": "box3:l"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/M.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:M"
"name": "box3:m"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/N.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:N"
"name": "box3:n"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/O.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:O"
"name": "box3:o"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/P.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:P"
"name": "box3:p"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/Q.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:Q"
"name": "box3:q"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/R.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:R"
"name": "box3:r"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
4 changes: 2 additions & 2 deletions box3formula/data/box3/loot_table/blocks/S.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"entries": [
{
"type": "minecraft:item",
"name": "box3:S"
"name": "box3:s"
}
],
"conditions": [
Expand All @@ -16,4 +16,4 @@
]
}
]
}
}
Loading