大更新 (#22)

haiman233 · web-flow · commit b0f30920bb80 · 2025-07-03T20:12:16.000+08:00
* 补充

* 补充

* 补充

* 补充

* 更新

* 1
diff --git a/pages/SUMMARY.md b/pages/SUMMARY.md
@@ -43,4 +43,5 @@
 * [模板机器](file/template\_machines.md)
 * [工作台](file/workbenches.md)
 * [强配方机器](file/linked\_recipe\_machines.md)
+* [自然生成](file/generations.md)
 * [研究](file/research.md)
diff --git a/pages/_sidebar.md b/pages/_sidebar.md
@@ -45,12 +45,14 @@
   * [模板机器](file/template_machines.md)
   * [工作台](file/workbenches.md)
   * [强配方机器](file/linked_recipe_machines.md)
+  * [自然生成](file/generations.md)
   * [研究](file/research.md)
 
 - 脚本-基础
   - [介绍](scripts-basic/introduction.md)
   - [基础](scripts-basic/basic.md)
   - [机器](scripts-basic/machines.md)
+  - [多方块机器](scripts-basic/multiblock_machines.md)
   - [物品](scripts-basic/items.md)
   - [机器菜单](scripts-basic/machine_menus.md)
   - [食物](scripts-basic/foods.md)
diff --git a/pages/addon/learn-to-write-addons-information.md b/pages/addon/learn-to-write-addons-information.md
@@ -15,6 +15,15 @@ description: "RSC示例附属"
 authors: ["mmmjjkx"]
 repo: "SlimefunReloadingProject/rsc-example"
 idPattern: EXAMPLE_%0
+loadStartTexts:
+- "===="
+- "Example附属 开始加载"
+- "===="
+enabledTexts:
+- "===="
+- "Example附属 加载成功"
+- "欢迎使用"
+- "===="
 ```
 
 | 内容 | 描述 |
@@ -29,6 +38,8 @@ idPattern: EXAMPLE_%0
 | \*authors | 附属的作者。 |
 | \*repo | 附属对应的github库，这是附属更新的必填项。 |
 | idPattern | 附属的通用前缀，示例中实际注册时会为所有物品加上**EXAMPLE_**前缀，%0表示原物品ID。 |
+| loadStartTexts | rsc附属开始加载时后台显示的文本 |
+| enabledTexts | rsc附属加载成功时后台显示的文本 |
 
 注意：当你设置idPattern之后，在引用附属内的物品时需要加上这个前缀。
 
diff --git a/pages/file/armors.md b/pages/file/armors.md
@@ -64,6 +64,24 @@ rsc_example_armor:
 | potion_effects | 穿上盔甲时给予的药水效果格式为 药水效果ID + 药水等级 **(数字+1)级** |
 | recipe等 | 遵循[通用物品格式](format/universal-item-format.md) |
 
+## 有关potion_effects
+
+potion_effects的id改动较多，需要根据服务器的我的世界版本自行调整
+
+以下列出受过更改的药水效果id，可通过使用rsc的[注册选项](file/context-options.md)功能来适配不同我的世界版本的盔甲
+
+| 药水名称 | 1.20.5之前的id | 1.20.5之后的id |
+| --- | ----------- | ----------------- |
+| 急迫 | FAST_DIGGING | HASTE |
+| 瞬间伤害 | HARM | INSTANT_DAMAGE |
+| 瞬间治疗 | HEAL | INSTANT_HEALTH |
+| 跳跃提升 | JUMP | JUMP_BOOST |
+| 挖掘疲劳 | SLOW_DIGGING | MINING_FATIGUE |
+| 反胃 | CONFUSION | NAUSEA |
+| 抗性提升 | DAMAGE_RESISTANCE | RESISTANCE |
+| 力量 | INCREASE_DAMAGE | STRENGTH |
+
+
 ## 保护类型
 
 保护类型详见[盔甲保护类型](https://slimefun.github.io/javadocs/Slimefun4/docs/io/github/thebusybiscuit/slimefun4/core/attributes/ProtectionType.html)
diff --git a/pages/file/context-options.md b/pages/file/context-options.md
@@ -20,6 +20,7 @@ OBJECT_FOR_REGISTER_2:
        - "hasplugin DyeBench"
        - "!hasplugin DynaTech"
        - "version >= 1.18.1"
+       - "itemexist EXAMPLE_ITEM"
     unfinished: false
 ```
 
@@ -47,6 +48,8 @@ OBJECT_FOR_REGISTER_2:
 | hasplugin  | 需要某插件   | hasplugin DyeBench   |
 | !hasplugin | 与某插件冲突/不兼容 | !hasplugin DynaTech |
 | version | 检查MC版本是否达到要求(使用>=,<=,>,<这些符号来判断) | version >= 1.18.1 |
+| itemexist | 检查是否存在某个粘液科技物品的id | itemexist EXAMPLE_ITEM |
+| !itemexist | 检查是否不存在某个粘液科技物品的id | !itemexist EXAMPLE_ITEM |
 | config.boolean | 检查配置文件某一项的布尔值是否为true(真) | config.boolean isSomethingEnabled |
 | config.int | 检查配置文件某一项的数字值是否达到要求(使用>=,<=,>,<这些符号来判断) | config.int theIntValue >= 64 |
 | config.string | 检查配置文件某一项的值是否跟目标字符串相同 | config.string theStringValue 你好 |
diff --git a/pages/file/foods.md b/pages/file/foods.md
@@ -1,6 +1,6 @@
 # 食物(foods.yml)
 
-> 用于自定义食物(类似于粘液科技食物分类中的肉干，无法自定义类似于异域花园的食品)。
+> 用于自定义食物/果汁(类似于粘液科技食物分类中的肉干和果汁，无法自定义类似于异域花园的食品)。
 
 > 脚本-进阶中会详细介绍如何自定义类似于异域花园的食品
 
@@ -28,6 +28,22 @@ RSC_EXAMPLE_FOOD:
     3:
       material: dark_oak_planks
       amount: 1
+RSC_EXAMPLE_JUICE:
+  item_group: rsc_example_sub_group
+  item:
+    name: "果汁 1"
+    material: POTION
+    color: "0,255,0"
+  script: "example_food" # 可沿用食物的脚本
+  nutrition: 1
+  saturation: 0
+  eatseconds: 1.6
+  always_eatable: false
+  recipe_type: JUICER
+  recipe:
+    1:
+      material: birch_planks
+      amount: 1
 ```
 
 | 内容 | 描述 | 有效输入 |
diff --git a/pages/file/generations.md b/pages/file/generations.md
@@ -0,0 +1,61 @@
+# 世界生成(generations.yml)
+
+<mark style="color:red;">**注意：**</mark>带\*为必填
+
+> 用于自定义自然生成于世界中的粘液科技方块。
+
+**示例：**
+
+```yaml
+EXAMPLE_GENERATION:
+  slimefun_id: "EXAMPLE_GENERATIONS" # 此物品必须是一个方块或头颅，且必须是已经注册的id
+  areas:
+    1:
+      maxHeight: 64
+      minHeight: 0
+      most: 30
+      amount: 2
+      maxSize: 4
+      minSize: 1
+      replacement: stone
+      environment: NORMAL
+    2:
+      maxHeight: 64
+      minHeight: 0
+      most: 30
+      amount: 2
+      maxSize: 4
+      minSize: 1
+      replacement: netherrock
+      environment: NETHER
+```
+
+| 内容 | 描述 | 有效输入 |
+| --- | ----------- | ----------------- |
+| \*`WT_G1` | 自然生成的ID。<br>该ID不能与任何其他物品的ID相同!注意：此ID并非是物品ID!! | **仅支持大写字母、数字、下划线!** |
+| slimefun_id | 粘液科技方块物品的id，可以是其它附属的id，也可以是自己在items/geo/mob_drops等配置中自定义的物品(物品必须为方块或头颅) |
+| areas | 可供方块生成的多个区域 |
+| maxHeight | 最大生成高度，不可以小于minHeight |
+| minHeight | 最小生成高度，不可以大于maxHeight |
+| most | 此方块在哪一层生成的最多，且越靠近此层，生成的概率越大 |
+| amount | 每个区块最大可生成的矿脉数量，最大为200。具体详见下文。| 注意：此值设置太大会导致服务器卡顿，建议此值控制在1~5之间 |
+| maxSize | 矿脉的最大可连续生成粘液方块的数量，此值决定了矿脉肉眼看上去的最大规模 |
+| minSize | 矿脉的最小可连续生成粘液方块的数量，最小为1，注意：若此值为0，则此粘液方块将无法在世界中生成 |
+| replacement | 在自然世界中替代的原版方块，且不建议替换草方块，具体详见下文 |
+| environment | 世界生成的维度。 | **仅包括：NORMAL/NETHER/THE_END/CUSTOM** |
+
+### 有关自然生成的生成规则
+
+矿脉中生成的粘液方块数量会在[minSize,maxSize]间随机取值，约接近于most定义的层数，取的值越大
+
+amount实际为在一个区块中尝试生成矿脉的次数，每次尝试生成直至尝试生成失败或者到达设定的值(如果全部尝试生成成功了，那么这个区块中就会生成amount条矿脉)
+
+矿脉数量指的是在视觉表现中，类似于矿石成坨或成条刷新的规模数量（再通俗点，拿原版的铁矿石来说，就是一个区块能生成几坨铁矿）
+
+### 有关replacement
+
+如果你想自定义类似矿石之类的方块想遵循rsc定义的生成条件，则可以将replacement:设置为stone，如果想遵循原版的矿石生成规律，则可以将replacement:设置为相应的原版矿石(前提是这种原版矿石能在你设定的[minHeight,maxHeight]间生成)
+
+注意：不建议替换草方块，这将会使异域花园无法正常自然生成树木从而导致报错
+
+注意：replacement:后填的id为原版的方块id，具体的方块id可以在我的世界wiki上查看，需要与物品id区别的是，部分方块状态id是不具备物品形式的，例如作物之类，马铃薯作物的方块状态id：POTATOES，而填马铃薯的id：POTATO是不生效的，因为马铃薯不是方块，更特殊点的诸如竹子与竹笋的关系，竹子既具有方块形式又具有物品形式，其物品id和方块id都为bamboo，而竹笋有方块形式但没有物品形式，其方块id为bamboo_sapling且没有对应的物品id
diff --git a/pages/file/items.md b/pages/file/items.md
@@ -219,6 +219,7 @@ recipe_type: BARTER_DROP # 猪灵交易
 ```
 
 类似于硼砂，在这里是挖掘灰化土掉落这个粘液物品（参考上面 可变泥土 ）
+注意：此值填的是原版方块id，关于原版方块id与物品id区别，详见[自然生成](file/generations.md)的**有关replacement**。
 你还可以设置掉落的几率以及数量（与drop_from同级）：
 
 ```yaml
diff --git a/pages/file/machine.md b/pages/file/machine.md
@@ -80,4 +80,4 @@ RSC_EXAMPLE_MACHINE_ENERGY:
 
 ## 其它
 
-如果想自定义machine.yml里的机器菜单(menu），详见 [机器菜单](file/menu.md) 。
+如果想自定义machine.yml里的机器菜单（menu），详见 [机器菜单](file/menu.md) 。
diff --git a/pages/file/recipe_type.md b/pages/file/recipe_type.md
@@ -45,38 +45,38 @@ recipe_type: NULL
 
 你可以设置配方类型为这些（粘液自带），但并不代表此配方一定存在，不过你仍然可以设置recipe来解释说明
 
-[参考代码](https://github.com/StarWishsama/Slimefun4/blob/master/src/main/java/io/github/thebusybiscuit/slimefun4/api/recipes/RecipeType.java)
+[参考代码](https://github.com/SlimefunGuguProject/Slimefun4/blob/master/src/main/java/io/github/thebusybiscuit/slimefun4/api/recipes/RecipeType.java)
 
 ```yaml
 # 自动设置配方的类型
-ARMOR_FORGE # 盔甲锻造台
-GRIND_STONE # 磨石
-SMELTERY # 冶炼炉
-ORE_CRUSHER # 碎矿机
-COMPRESSOR # 压缩机
-PRESSURE_CHAMBER # 压力机
-MAGIC_WORKBENCH # 魔法工作台
-ORE_WASHER # 洗矿机
+ARMOR_FORGE             # 盔甲锻造台
+GRIND_STONE             # 磨石
+SMELTERY                # 冶炼炉
+ORE_CRUSHER             # 碎矿机
+COMPRESSOR              # 压缩机
+PRESSURE_CHAMBER        # 压力机
+MAGIC_WORKBENCH         # 魔法工作台
+ORE_WASHER              # 洗矿机
 ENHANCED_CRAFTING_TABLE # 增强型工作台
-ANCIENT_ALTAR # 远古祭坛
-JUICER # 榨汁机
-HEATED_PRESSURE_CHAMBER # 加热压力舱
-MOB_DROP # 生物掉落
-INFINITY_FORGE # 无尽工作台
-TINKERS_WORKBENCH # 匠魂工作台
+ANCIENT_ALTAR           # 远古祭坛
+JUICER                  # 榨汁机
+MOB_DROP                # 生物掉落
+INFINITY_FORGE          # 无尽工作台
+TINKERS_WORKBENCH       # 匠魂工作台
 
 # 仅展示的类型
-MULTIBLOCK # 多方块结构
-GOLD_PAN # 淘金
-BARTER_DROP # 猪灵交易
-INTERACT # 交互
-FOOD_FABRICATOR # 食品加工机
-FOOD_COMPOSTER # 食品堆肥机
-FREEZER # 冰箱
-REFINERY # 炼油机
-GEO_MINER # 自然资源开采机
-NUCLEAR_REACTOR # 核反应堆
-NULL # 无配方
+MULTIBLOCK              # 多方块结构
+GOLD_PAN                # 淘金盘
+BARTER_DROP             # 猪灵交易
+INTERACT                # 交互
+FOOD_FABRICATOR         # 食品加工机
+FOOD_COMPOSTER          # 食品堆肥机
+HEATED_PRESSURE_CHAMBER # 加热压力舱
+FREEZER                 # 冰箱
+REFINERY                # 炼油机
+GEO_MINER               # 自然资源开采机
+NUCLEAR_REACTOR         # 核反应堆
+NULL                    # 无配方
 ```
 
 ### 以下配方类型仅支持数量为1的物品输入
diff --git a/pages/file/template_machines.md b/pages/file/template_machines.md
@@ -22,7 +22,7 @@ RSC_EXAMPLE_TEMPLATE_MACHINE:
       material: RSC_EXAMPLE_ITEM
   consumption: 300
   capacity: 3000
-  templateSlot: 0
+  templateSlot: 2
   input: [2, 3, 4, 5, 6, 7, 8]
   output: [18, 19, 20, 21, 22, 23, 24, 25, 26]
   fasterIfMoreTemplates: true
@@ -49,6 +49,8 @@ RSC_EXAMPLE_TEMPLATE_MACHINE:
           1:
             material_type: slimefun
             material: RSC_EXAMPLE_ITEM
+# 注意：以下示例仅适用于我的世界1.20.5以前的版本
+# 此实例展示的是模版机器在不设置输入物品的情况下仅放置模版即可输出相应物品
     RSC_EXAMPLE_ITEM:
       2item:
         seconds: 1
@@ -60,6 +62,7 @@ RSC_EXAMPLE_TEMPLATE_MACHINE:
             material_type: slimefun
             material: RSC_EXAMPLE_ITEM
             chance: 15
+
 ```
 
 | 内容 | 描述 | 有效输入 |
@@ -73,11 +76,12 @@ RSC_EXAMPLE_TEMPLATE_MACHINE:
 | \*output | 物品输出的对应槽位。<br>**请不要在菜单中为这些槽位设置物品！** |
 | \*consumption | 模板机器每粘液刻消耗的电量。 |
 | \*capacity | 设置模板机器可储存的能量，最大为 2147483647。 |
+| \*templateSlot | 设置模版的槽位，此槽位必须是input槽位的其中一个 |
 | \*recipes | 模板机器的自定义配方。 |
 | \*recipes."sfid" | 在第一缩进中需要填写识别物的粘液id，识别物只能是粘液物品 |
 | \*recipes."sfid".# | 在第二缩进中填写工作配方，同[配方机器](file/recipes_machines.md)，在模板槽的物品与第一缩进的粘液id相同时，便会进入此缩进进行工作配方的匹配 |
-| fasterIfMoreTemplates | 存在多个模板在模板槽时，机器是否运行更快，默认 false |
-| moreOutputIfMoreTemplates | 存在多个模板在模板槽时，是否输出更多物品，默认 false |
+| fasterIfMoreTemplates | 存在多个模板在模板槽时，机器是否运行得更快，默认 false |
+| moreOutputIfMoreTemplates | 存在多个模板在模板槽时，机器是否输出的物品更多，默认 false |
 
 # 注意
 
diff --git a/pages/format/Recipe.md b/pages/format/Recipe.md
@@ -2,6 +2,8 @@
 
 配方的格式跟SC大致相同，每一格代表一个物品(**写法参考通用物品格式**)。
 
+但是rsc也提供了更多便捷的写配方的方法
+
 格式：
 
 ```yaml
@@ -45,6 +47,23 @@ recipe:
 
 当然，如果这个物品是不可合成的，可以省略recipe（即不填）。
 
+当你面对类似于动力科技这种会频繁修改粘液物品id的附属，需要在配方中适配来自动力科技不同版本的粘液科技物品id的情况，可使用“ | ”符号
+
+```yaml
+recipe:
+  1: 
+    material: cobblestone
+  2:
+    material_type: none
+  3:
+    material_type: slimefun
+    material: MATERIAL_HIVE | DT_MATERIAL_HIVE | DYNATECH_MATERIAL_HIVE
+```
+
+当MATERIAL_HIVE不存在时，则向后调用DT_MATERIAL_HIVE，当DT_MATERIAL_HIVE不存在时，则向后调用DYNATECH_MATERIAL_HIVE
+
+此方法同样适用于机器的输入与输出
+
 ## 应用
 
 详见 [**配置文件-物品**](file/items.md) 。
diff --git a/pages/format/Universal-item-format.md b/pages/format/Universal-item-format.md
@@ -19,7 +19,7 @@ name: "物品名称"
 <br>RSC不对任何超出原本限制的物品数量做检查
 <br>如有任何相关错误，请不要找RSC
 
-小技巧：如果将机器所需输入物品的数量设置为0，那么此物品将不会被消耗，但是需要此物品在输入槽内才能运行。(适用于1.20.5以前的版本)
+小技巧：如果将机器所需输入物品的数量设置为0，那么此物品将不会被消耗，但是需要此物品在输入槽内才能运行。(适用于我的世界1.20.5以前的版本)
 
 ```yaml
 amount: (数字)
@@ -73,6 +73,15 @@ material: bb0f722aec27490cf056f560afdd457a0a794e703556cc4c3b51a582f5c57aa4
 
 当`material_type: slimefun`时，你可以在同级的情况下添加`glow`，修改`name`和`lore`，可用于在不改变物品材质的情况下，编辑一个粘液物品，可用于机器的输出项。
 
+5、mc
+
+在填写原版物品id时，你可以省略`material_type: mc`，为了让rsc附属具备更好的兼容性，rsc默认兼容了以下被修改过的原版物品id
+
+草：旧id：GRASS 新id：SHORT_GRASS
+鳞甲：旧id：SCUTE 新id：TURTLE_SCUTE
+
+你可以在填写上述两个原版物品id时随意使用旧id或新id
+
 ### \*材料
 
 设置物品材料，填写内容由材料类型决定。
@@ -112,3 +121,13 @@ lore:
 ```yaml
 glow: true/false
 ```
+
+### 颜色
+
+设置药水/皮革套装/烟火之星的颜色
+
+```yaml
+color: "0,255,0"
+```
+
+使用RGB颜色值
diff --git a/pages/format/recipe.md b/pages/format/recipe.md
diff --git a/pages/format/universal-item-format.md b/pages/format/universal-item-format.md
diff --git a/pages/scripts-basic/foods.md b/pages/scripts-basic/foods.md

Original file line number	Diff line number	Diff line change
`@@ -80,4 +80,4 @@ RSC_EXAMPLE_MACHINE_ENERGY:`
`80`	`80`
`81`	`81`	`## 其它`
`82`	`82`
`83`		`-如果想自定义machine.yml里的机器菜单(menu），详见 [机器菜单](file/menu.md) 。`
	`83`	`+如果想自定义machine.yml里的机器菜单（menu），详见 [机器菜单](file/menu.md) 。`