密码:2jtj
本分支相较上游 Leaves 的新增内容说明
本文档用于说明当前分支在上游 Leaves dev/26.2 基础上额外加入的功能、补丁、配置项、发布材料与构建调整，方便后续维护、合并、发布与回溯。
总览
当前分支除了继承上游 Leaves 原有能力外，额外加入了以下几类自定义内容：
假人增强与 Carpet 风格控制扩展
大木桶功能
传送门去光照区域控制
坚韧凋零玫瑰
潜影盒 CCE 更新抑制器重引入
苦力怕命令与头颅规则
易碎深板岩 / 黑曜石 / 矿石
还原“发射器给硫方怪穿装备”旧 Bug
硫方怪岩浆块伤害归属修复
船拴绳距离配置化
愚人节方块玩法
非法物品合成配方系统
leaves.yml 中文注释补全
0142-0150 发布补丁包与 recovery 材料
离线构建恢复调整
1. 假人增强与 Carpet 风格控制扩展
主要材料：
fakeplayer-carpet-controls.patch
相关源码位置：
leaves-server/src/main/java/org/leavesmc/leaves/command/bot/PlayerCommand.java
leaves-server/src/main/java/org/leavesmc/leaves/bot/ServerBot.java
leaves-server/src/main/java/org/leavesmc/leaves/bot/BotUtil.java
leaves-server/src/main/java/org/leavesmc/leaves/LeavesConfig.java
主要增强内容：
扩展 /player <name> ... 风格的假人控制命令
增加 /tpb 假人传送能力
支持 spawn、kill、save、shadow
支持 move、look、jump、sneak、sprint
支持 attack、use、stop、dismount
支持 isee / open 远程打开假人背包
支持 keepi
支持 replenish
支持 replenishchest
GUI 与交互增强：
假人背包 GUI 已中文化
GUI 控制栏加入动作按钮与快捷栏按钮
按钮行为尽量通过“点击触发命令”的方式实现，而不是直接短路调用内部逻辑
slot 9、slot 10 的左键动作除了攻击实体，还可模拟破坏方块
slot 11 的右键动作除了使用，还可模拟放置等右键行为
补货逻辑现状：
keepi 已补成真正可用的死亡保留开关
replenish 已补成真正可用的手持补货
replenishchest 已补成真正可用的附近容器补货
当手中物品耗尽时，会尝试从假人背包、末影箱、背包中的潜影盒、末影箱中的潜影盒，以及附近容器中补到手上
2. 大木桶功能
正式补丁：
leaves-server/minecraft-patches/features/0140-Add-large-barrel-pairing.patch
leaves-server/minecraft-patches/features/0141-Refine-large-barrel-interactions.patch
功能说明：
模仿 carpettisaddition 风格，引入“大木桶”
两个木桶只要满足“背对背”条件，就能组成类似大箱子的双容器
不要求只能水平同向摆放，也支持不同朝向组合
支持上下纵向排列，只要满足背对背即可组成大木桶
为大木桶提供独立标题文本
比较器读取大木桶时，红石信号规则与大箱子保持一致
已检查并补强与漏斗 / hopper 的交互，使其更接近双容器视角
3. 传送门去光照区域控制
正式补丁发布材料：
leaves-patches/0142-no-light-portal-region/0142-minecraft-managed.patch
leaves-patches/0142-no-light-portal-region/0142-leaves-main-direct.patch
核心源码：
leaves-server/src/main/java/org/leavesmc/leaves/command/NoLightCommand.java
leaves-server/src/main/java/org/leavesmc/leaves/util/PortalNoLightSavedData.java
功能说明：
新增 /nolight 命令
可对一片区域内的地狱传送门和末地传送门关闭或恢复发光
用途是让指定区域的传送门不再提供光照
命令形式：
/nolight <x1> <y1> <z1> <x2> <y2> <z2> true
/nolight <x1> <y1> <z1> <x2> <y2> <z2> false
说明：
true 表示关闭该区域内传送门光照
false 表示恢复该区域内传送门光照
4. 坚韧凋零玫瑰
正式补丁发布材料：
leaves-patches/0143-resilient-wither-rose/0143-minecraft-managed.patch
功能说明：
允许凋零玫瑰种植在任意方块上
例如可直接种在地狱砖块等原本不允许种植的方块上
5. 潜影盒 CCE 更新抑制器重引入
正式补丁发布材料：
leaves-patches/0144-shulker-box-cce-reintroduced/0144-minecraft-managed.patch
leaves-patches/0144-shulker-box-cce-reintroduced/0144-leaves-main-direct.patch
功能说明：
重新引入基于 ClassCastException 的潜影盒更新抑制器
目标场景是比较器读取带有非 Inventory 类方块实体的潜影盒时触发的旧机制
可配置命名规则，而不再是单一布尔值
配置项：
modify.minecraft-old.block-updater.shulker-box-cce-reintroduced
规则说明：
false：关闭功能
true：命名为 更新抑制器 或 updateSuppression 的潜影盒可用于制作更新抑制器
其它字符串：命名为该字符串的潜影盒可用于制作更新抑制器
附加行为：
可用于更新抑制器的潜影盒被发射器放置时，会移除其自定义名称
6. 苦力怕命令与头颅规则
正式补丁发布材料：
leaves-patches/0145-creeper-command-and-head-rules/0145-minecraft-managed.patch
leaves-patches/0145-creeper-command-and-head-rules/0145-leaves-main-direct.patch
相关源码：
leaves-server/src/main/java/org/leavesmc/leaves/command/CreeperCommand.java
功能说明：
新增 /creeper 命令
可在指定玩家附近制造一次苦力怕爆炸
爆炸只伤害实体，不破坏方块
增强闪电苦力怕多头颅掉落逻辑
增加玩家被闪电苦力怕杀死时掉落头颅规则
配置项：
modify.command-creeper
modify.super-charged-creeper
modify.player-drop-head
7. 易碎深板岩 / 黑曜石 / 矿石
正式补丁发布材料：
leaves-patches/0146-soft-deepslate-obsidian-ores/0146-minecraft-managed.patch
leaves-patches/0146-soft-deepslate-obsidian-ores/0146-leaves-main-direct.patch
功能说明：
soft-deepslate
启用后深板岩及其变种硬度与石头 / 圆石一致
soft-obsidian
启用后黑曜石硬度与末地石一致
soft-ores
启用后矿石硬度与其对应母岩保持一致
配置项：
modify.soft-deepslate
modify.soft-obsidian
modify.soft-ores
8. 还原“发射器给硫方怪穿装备”旧 Bug
正式补丁发布材料：
leaves-patches/0147-sulfur-cube-dispenser-equip-bug/0147-minecraft-managed.patch
leaves-patches/0147-sulfur-cube-dispenser-equip-bug/0147-leaves-main-direct.patch
功能说明：
恢复 26.2 预览版中曾存在、后被修复的旧行为
启用后允许发射器再次给硫方怪穿装备
配置项：
modify.restore-sulfur-cube-dispenser-equip-bug
9. 硫方怪岩浆块伤害归属修复
正式补丁发布材料：
leaves-patches/0148-sulfur-cube-magma-damage-attribution/0148-minecraft-managed.patch
功能说明：
当硫方怪被塞入岩浆块并受到伤害时，伤害来源归属到执行“塞入岩浆块”动作的玩家
方便后续玩法判断、统计或衍生机制处理
10. 船拴绳距离配置化
正式补丁发布材料：
leaves-patches/0149-boat-leash-config/0149-minecraft-managed.patch
leaves-patches/0149-boat-leash-config/0149-leaves-main-direct.patch
功能说明：
针对“船连接拴绳”的场景单独调整参数
将连接船的拴绳弹性距离改为 4
将连接船的断裂距离改为 40
主要服务于硫方怪拖动船、猪 / 马 / 玩家构成的“空中载具”玩法
配置项：
对应配置已加入 LeavesConfig
11. 愚人节方块玩法
受管补丁：
leaves-server/minecraft-patches/features/0142-Add-April-Fools-blocks.patch
发布材料：
leaves-patches/0150-april-fools-blocks/0150-minecraft-managed.patch
leaves-patches/0150-april-fools-blocks/0150-leaves-main-direct.patch
相关源码：
leaves-server/src/main/java/org/leavesmc/leaves/aprilfools/
leaves-server/src/main/java/org/leavesmc/leaves/protocol/aprilfools/AprilFoolsProtocol.java
leaves-server/src/main/resources/data/aprilfools/
功能说明：
加入 April Fools 方块玩法
支持 pickaxe block
支持 place block
支持运行期协议同步
补入配方与标签资源
配置项：
modify.april-fools.pickaxe-block
modify.april-fools.place-block
modify.april-fools.place-block-consume-item-entities
modify.april-fools.pickaxe-block-break-unbreakable
modify.april-fools.use-survival-drops
protocol.april-fools.protocol
12. 非法物品合成配方系统
核心实现：
leaves-server/src/main/java/org/leavesmc/leaves/util/IllegalItemRecipeHelper.java
配置定义：
leaves-server/src/main/java/org/leavesmc/leaves/LeavesConfig.java
功能说明：
可按开关控制非法物品配方是否启用
每个配方都可单独开启
配置项：
modify.illegal-item-recipes.enable
modify.illegal-item-recipes.reinforced-deepslate
modify.illegal-item-recipes.bedrock
modify.illegal-item-recipes.barrier
modify.illegal-item-recipes.end-portal-frame
modify.illegal-item-recipes.light-15
modify.illegal-item-recipes.light-lower
包含的配方能力：
强化深板岩
基岩
屏障
末地传送门框架
15 级光源方块
更低等级光源方块递降合成
额外修复：
修复重载或清理非法配方时刷出的日志警告：
Tried to load unrecognized recipe: leaves:illegal_item_recipe_* removed now.
现在仅在配方真实存在时才调用 Bukkit.removeRecipe(...)
13. 潜影盒进入铜箱子后主动堆叠
功能说明：
Leaves 原有潜影盒堆叠功能通常不主动堆叠，避免影响很多旧机器
本分支额外加入：相同 NBT 的潜影盒进入铜箱子后会主动堆叠
目标是尽量不打扰旧红石机器，同时利用 1.21.11 新铜箱子的低历史兼容负担
相关配置：
modify.shulker-box.stackable-shulker-boxes
modify.shulker-box.same-nbt-stackable
14. leaves.yml 中文注释补全
核心改动：
leaves-server/src/main/java/org/leavesmc/leaves/config/AnnotatedYamlConfigWriter.java
leaves-server/src/main/java/org/leavesmc/leaves/LeavesConfig.java
leaves-server/src/main/java/org/leavesmc/leaves/config/GlobalConfigCreator.java
leaves-server/src/main/java/org/leavesmc/leaves/config/GlobalConfigManager.java
leaves-server/src/main/java/org/leavesmc/leaves/config/annotations/GlobalConfig.java
leaves-server/src/main/java/org/leavesmc/leaves/config/annotations/GlobalConfigCategory.java
功能说明：
不再依赖 Bukkit 默认注释写出行为
改为自定义 YAML 写出器稳定输出注释
将大量配置项中文注释直接补回 LeavesConfig.java
当前 LeavesConfig.java 缺失注释扫描结果已清零
现状说明：
生成的 leaves.yml 会以“配置项上方注释”的稳定方式输出
目标不是行尾内联注释，而是确保绝大多数配置项都有可靠中文说明
15. 发布补丁包与 recovery 材料
文档：
PATCH_RECOVERY_0142_0149.md
leaves-patches/README.md
leaves-patches/INDEX.md
目录说明：
recovery-patches/0142-0149
用于恢复材料整理
leaves-patches/
用于正式发布包目录整理
当前发布包已包含：
0142-no-light-portal-region
0143-resilient-wither-rose
0144-shulker-box-cce-reintroduced
0145-creeper-command-and-head-rules
0146-soft-deepslate-obsidian-ores
0147-sulfur-cube-dispenser-equip-bug
0148-sulfur-cube-magma-damage-attribution
0149-boat-leash-config
0150-april-fools-blocks
归属结论：
这些功能并不全都能简单等价为“正式受管 numbered patch”
其中一部分属于 minecraft-patches 受管侧
另一部分属于 leaves-server/src/main/java 直管源码侧
本分支相较上游 Leaves 的新增内容说明
本文档用于说明当前分支在上游 Leaves dev/26.2 基础上额外加入的功能、补丁、配置项、发布材料与构建调整，方便后续维护、合并、发布与回溯。
总览
当前分支除了继承上游 Leaves 原有能力外，额外加入了以下几类自定义内容：
假人增强与 Carpet 风格控制扩展
大木桶功能
传送门去光照区域控制
坚韧凋零玫瑰
潜影盒 CCE 更新抑制器重引入
苦力怕命令与头颅规则
易碎深板岩 / 黑曜石 / 矿石
还原“发射器给硫方怪穿装备”旧 Bug
硫方怪岩浆块伤害归属修复
船拴绳距离配置化
愚人节方块玩法
非法物品合成配方系统
leaves.yml 中文注释补全
0142-0150 发布补丁包与 recovery 材料
离线构建恢复调整
1. 假人增强与 Carpet 风格控制扩展
主要材料：
fakeplayer-carpet-controls.patch
相关源码位置：
leaves-server/src/main/java/org/leavesmc/leaves/command/bot/PlayerCommand.java
leaves-server/src/main/java/org/leavesmc/leaves/bot/ServerBot.java
leaves-server/src/main/java/org/leavesmc/leaves/bot/BotUtil.java
leaves-server/src/main/java/org/leavesmc/leaves/LeavesConfig.java
主要增强内容：
扩展 /player <name> ... 风格的假人控制命令
增加 /tpb 假人传送能力
支持 spawn、kill、save、shadow
支持 move、look、jump、sneak、sprint
支持 attack、use、stop、dismount
支持 isee / open 远程打开假人背包
支持 keepi
支持 replenish
支持 replenishchest
GUI 与交互增强：
假人背包 GUI 已中文化
GUI 控制栏加入动作按钮与快捷栏按钮
按钮行为尽量通过“点击触发命令”的方式实现，而不是直接短路调用内部逻辑
slot 9、slot 10 的左键动作除了攻击实体，还可模拟破坏方块
slot 11 的右键动作除了使用，还可模拟放置等右键行为
补货逻辑现状：
keepi 已补成真正可用的死亡保留开关
replenish 已补成真正可用的手持补货
replenishchest 已补成真正可用的附近容器补货
当手中物品耗尽时，会尝试从假人背包、末影箱、背包中的潜影盒、末影箱中的潜影盒，以及附近容器中补到手上
2. 大木桶功能
正式补丁：
leaves-server/minecraft-patches/features/0140-Add-large-barrel-pairing.patch
leaves-server/minecraft-patches/features/0141-Refine-large-barrel-interactions.patch
功能说明：
模仿 carpettisaddition 风格，引入“大木桶”
两个木桶只要满足“背对背”条件，就能组成类似大箱子的双容器
不要求只能水平同向摆放，也支持不同朝向组合
支持上下纵向排列，只要满足背对背即可组成大木桶
为大木桶提供独立标题文本
比较器读取大木桶时，红石信号规则与大箱子保持一致
已检查并补强与漏斗 / hopper 的交互，使其更接近双容器视角
3. 传送门去光照区域控制
正式补丁发布材料：
leaves-patches/0142-no-light-portal-region/0142-minecraft-managed.patch
leaves-patches/0142-no-light-portal-region/0142-leaves-main-direct.patch
核心源码：
leaves-server/src/main/java/org/leavesmc/leaves/command/NoLightCommand.java
leaves-server/src/main/java/org/leavesmc/leaves/util/PortalNoLightSavedData.java
功能说明：
新增 /nolight 命令
可对一片区域内的地狱传送门和末地传送门关闭或恢复发光
用途是让指定区域的传送门不再提供光照
命令形式：
/nolight <x1> <y1> <z1> <x2> <y2> <z2> true
/nolight <x1> <y1> <z1> <x2> <y2> <z2> false
说明：
true 表示关闭该区域内传送门光照
false 表示恢复该区域内传送门光照
4. 坚韧凋零玫瑰
正式补丁发布材料：
leaves-patches/0143-resilient-wither-rose/0143-minecraft-managed.patch
功能说明：
允许凋零玫瑰种植在任意方块上
例如可直接种在地狱砖块等原本不允许种植的方块上
5. 潜影盒 CCE 更新抑制器重引入
正式补丁发布材料：
leaves-patches/0144-shulker-box-cce-reintroduced/0144-minecraft-managed.patch
leaves-patches/0144-shulker-box-cce-reintroduced/0144-leaves-main-direct.patch
功能说明：
重新引入基于 ClassCastException 的潜影盒更新抑制器
目标场景是比较器读取带有非 Inventory 类方块实体的潜影盒时触发的旧机制
可配置命名规则，而不再是单一布尔值
配置项：
modify.minecraft-old.block-updater.shulker-box-cce-reintroduced
规则说明：
false：关闭功能
true：命名为 更新抑制器 或 updateSuppression 的潜影盒可用于制作更新抑制器
其它字符串：命名为该字符串的潜影盒可用于制作更新抑制器
附加行为：
可用于更新抑制器的潜影盒被发射器放置时，会移除其自定义名称
6. 苦力怕命令与头颅规则
正式补丁发布材料：
leaves-patches/0145-creeper-command-and-head-rules/0145-minecraft-managed.patch
leaves-patches/0145-creeper-command-and-head-rules/0145-leaves-main-direct.patch
相关源码：
leaves-server/src/main/java/org/leavesmc/leaves/command/CreeperCommand.java
功能说明：
新增 /creeper 命令
可在指定玩家附近制造一次苦力怕爆炸
爆炸只伤害实体，不破坏方块
增强闪电苦力怕多头颅掉落逻辑
增加玩家被闪电苦力怕杀死时掉落头颅规则
配置项：
modify.command-creeper
modify.super-charged-creeper
modify.player-drop-head
7. 易碎深板岩 / 黑曜石 / 矿石
正式补丁发布材料：
leaves-patches/0146-soft-deepslate-obsidian-ores/0146-minecraft-managed.patch
leaves-patches/0146-soft-deepslate-obsidian-ores/0146-leaves-main-direct.patch
功能说明：
soft-deepslate
启用后深板岩及其变种硬度与石头 / 圆石一致
soft-obsidian
启用后黑曜石硬度与末地石一致
soft-ores
启用后矿石硬度与其对应母岩保持一致
配置项：
modify.soft-deepslate
modify.soft-obsidian
modify.soft-ores
8. 还原“发射器给硫方怪穿装备”旧 Bug
正式补丁发布材料：
leaves-patches/0147-sulfur-cube-dispenser-equip-bug/0147-minecraft-managed.patch
leaves-patches/0147-sulfur-cube-dispenser-equip-bug/0147-leaves-main-direct.patch
功能说明：
恢复 26.2 预览版中曾存在、后被修复的旧行为
启用后允许发射器再次给硫方怪穿装备
配置项：
modify.restore-sulfur-cube-dispenser-equip-bug
9. 硫方怪岩浆块伤害归属修复
正式补丁发布材料：
leaves-patches/0148-sulfur-cube-magma-damage-attribution/0148-minecraft-managed.patch
功能说明：
当硫方怪被塞入岩浆块并受到伤害时，伤害来源归属到执行“塞入岩浆块”动作的玩家
方便后续玩法判断、统计或衍生机制处理
10. 船拴绳距离配置化
正式补丁发布材料：
leaves-patches/0149-boat-leash-config/0149-minecraft-managed.patch
leaves-patches/0149-boat-leash-config/0149-leaves-main-direct.patch
功能说明：
针对“船连接拴绳”的场景单独调整参数
将连接船的拴绳弹性距离改为 4
将连接船的断裂距离改为 40
主要服务于硫方怪拖动船、猪 / 马 / 玩家构成的“空中载具”玩法
配置项：
对应配置已加入 LeavesConfig
11. 愚人节方块玩法
受管补丁：
leaves-server/minecraft-patches/features/0142-Add-April-Fools-blocks.patch
发布材料：
leaves-patches/0150-april-fools-blocks/0150-minecraft-managed.patch
leaves-patches/0150-april-fools-blocks/0150-leaves-main-direct.patch
相关源码：
leaves-server/src/main/java/org/leavesmc/leaves/aprilfools/
leaves-server/src/main/java/org/leavesmc/leaves/protocol/aprilfools/AprilFoolsProtocol.java
leaves-server/src/main/resources/data/aprilfools/
功能说明：
加入 April Fools 方块玩法
支持 pickaxe block
支持 place block
支持运行期协议同步
补入配方与标签资源
配置项：
modify.april-fools.pickaxe-block
modify.april-fools.place-block
modify.april-fools.place-block-consume-item-entities
modify.april-fools.pickaxe-block-break-unbreakable
modify.april-fools.use-survival-drops
protocol.april-fools.protocol
12. 非法物品合成配方系统
核心实现：
leaves-server/src/main/java/org/leavesmc/leaves/util/IllegalItemRecipeHelper.java
配置定义：
leaves-server/src/main/java/org/leavesmc/leaves/LeavesConfig.java
功能说明：
可按开关控制非法物品配方是否启用
每个配方都可单独开启
配置项：
modify.illegal-item-recipes.enable
modify.illegal-item-recipes.reinforced-deepslate
modify.illegal-item-recipes.bedrock
modify.illegal-item-recipes.barrier
modify.illegal-item-recipes.end-portal-frame
modify.illegal-item-recipes.light-15
modify.illegal-item-recipes.light-lower
包含的配方能力：
强化深板岩
基岩
屏障
末地传送门框架
15 级光源方块
更低等级光源方块递降合成
额外修复：
修复重载或清理非法配方时刷出的日志警告：
Tried to load unrecognized recipe: leaves:illegal_item_recipe_* removed now.
现在仅在配方真实存在时才调用 Bukkit.removeRecipe(...)
13. 潜影盒进入铜箱子后主动堆叠
功能说明：
Leaves 原有潜影盒堆叠功能通常不主动堆叠，避免影响很多旧机器
本分支额外加入：相同 NBT 的潜影盒进入铜箱子后会主动堆叠
目标是尽量不打扰旧红石机器，同时利用 1.21.11 新铜箱子的低历史兼容负担
相关配置：
modify.shulker-box.stackable-shulker-boxes
modify.shulker-box.same-nbt-stackable
14. leaves.yml 中文注释补全
核心改动：
leaves-server/src/main/java/org/leavesmc/leaves/config/AnnotatedYamlConfigWriter.java
leaves-server/src/main/java/org/leavesmc/leaves/LeavesConfig.java
leaves-server/src/main/java/org/leavesmc/leaves/config/GlobalConfigCreator.java
leaves-server/src/main/java/org/leavesmc/leaves/config/GlobalConfigManager.java
leaves-server/src/main/java/org/leavesmc/leaves/config/annotations/GlobalConfig.java
leaves-server/src/main/java/org/leavesmc/leaves/config/annotations/GlobalConfigCategory.java
功能说明：
不再依赖 Bukkit 默认注释写出行为
改为自定义 YAML 写出器稳定输出注释
将大量配置项中文注释直接补回 LeavesConfig.java
当前 LeavesConfig.java 缺失注释扫描结果已清零
现状说明：
生成的 leaves.yml 会以“配置项上方注释”的稳定方式输出
目标不是行尾内联注释，而是确保绝大多数配置项都有可靠中文说明
15. 发布补丁包与 recovery 材料
文档：
PATCH_RECOVERY_0142_0149.md
leaves-patches/README.md
leaves-patches/INDEX.md
目录说明：
recovery-patches/0142-0149
用于恢复材料整理
leaves-patches/
用于正式发布包目录整理
当前发布包已包含：
0142-no-light-portal-region
0143-resilient-wither-rose
0144-shulker-box-cce-reintroduced
0145-creeper-command-and-head-rules
0146-soft-deepslate-obsidian-ores
0147-sulfur-cube-dispenser-equip-bug
0148-sulfur-cube-magma-damage-attribution
0149-boat-leash-config
0150-april-fools-blocks
归属结论：
这些功能并不全都能简单等价为“正式受管 numbered patch”
其中一部分属于 minecraft-patches 受管侧
另一部分属于 leaves-server/src/main/java 直管源码侧
