Sable Fix Mod

Sable Fix Mod is a server-side compatibility and bug-fix mod for Minecraft 1.21.1 / NeoForge, designed to fix item duplication and block duplication issues that may occur during Sable's physics assembly, conversion, and de-physicalization processes.

Sable Fix Mod 是一个面向 Minecraft 1.21.1 / NeoForge 的服务端兼容与漏洞修复模组，专门处理 Sable 在物理结构组装、物理化和取消物理化过程中可能出现的物品复制与方块重复掉落问题。

修复内容 | Fixes

方块实体库存复制 | Block Entity Inventory Duplication

When Sable moves blocks, it saves the block entity NBT and clears the original inventory. Some vanilla or modded block entities do not fully implement Clearable, causing items to drop from the original location while the moved block still keeps the inventory.

Sable 搬运方块时会先保存方块实体 NBT，再清理原位置的库存。部分原版或模组方块实体没有完整实现 Clearable，可能导致原位置掉出物品，而相同物品仍保留在搬运后的方块实体中。

This mod adds support for clearing:

本模组会补充清理以下库存入口：

• Vanilla Container inventories
• NeoForge IItemHandler capabilities
• Directional item handler capabilities
• Loot Table based containers

附着方块复制 | Attached Block Duplication

Prevents Sable from performing unnecessary shape updates after copying block states, fixing attached blocks that break and drop items during physics conversion or restoration while remaining duplicated.

阻止 Sable 在复制全部方块状态后执行多余的形状传播，修复下列方块在物理化或还原时破坏、掉落物品，但本体仍保留在结构中的问题：

• 红石粉；铁轨；火把；按钮、拉杆和压力板；其他依赖支撑方块的附着方块。
• Redstone dust；Rails；Torches；Buttons, levers, and pressure plates；Other support-dependent attached blocks

农作物重复掉落 | Crop Duplication Drops

During Sable movement operations, this mod only blocks extra Block.popResource drops from the current source and destination positions.

在 Sable 搬运执行期间，只针对本次搬运的源坐标和目标坐标拦截额外的 Block.popResource 掉落。该保护用于修复耕地作物等方块的复制，同时不会影响正常挖掘、收割或结构外方块的掉落。

模组兼容 | Mod Compatibility

• 机械动力（Create）桌布：清理 TableClothBlockEntity 单独保存的手动物品列表。
• Fixes duplication caused by TableClothBlockEntity storing additional manual item lists.
• 精妙背包（Sophisticated Backpacks）：保留通过 UUID 存放在世界 SavedData 中的真实背包库存，避免通用物品能力清理误删背包内容。
• Preserves real backpack inventories stored through UUID-based world SavedData, preventing accidental removal by generic inventory cleanup.

环境要求 | Requirements

项目	要求
Minecraft	1.21.1
NeoForge	21.1 或更高的 1.21.1 版本
Sable	2.0.0 或更高版本
Java	21

Create and Sophisticated Backpacks are optional dependencies. Compatibility features are only enabled when the corresponding mods are installed.

机械动力和精妙背包不是必需依赖；只有安装对应模组时，相关兼容逻辑才会生效。

安装方法 | Installation

1. 安装 Minecraft 1.21.1、NeoForge 和 Sable。
2. 将 sable_fix_mod-1.1.0.jar 放入游戏或服务端的 mods 文件夹。
3. 启动一次游戏或服务端，让 NeoForge 自动生成配置文件。
4. 建议先备份世界，再测试已有物理结构的物理化与还原。

Dedicated servers only need the server installation. Single-player worlds require installation on the client instance.

专用服务器只需安装服务端；单人游戏需要安装客户端实例。

配置文件 | Configuration

Generated at:

首次启动后会生成：

config/sable_fix_mod-common.toml

All options are enabled by default.

全部选项默认开启：

配置项	默认值	作用
duplicationFixes.inventoryDuplication	true	修复方块实体库存复制 / Fix block entity inventory duplication
duplicationFixes.attachedBlockDuplication	true	修复附着方块复制 / Fix attached block duplication
duplicationFixes.assemblyBlockDrops	true	修复搬运过程额外掉落 / Fix extra drops during movement
compatibility.createTableCloth	true	Create 桌布兼容 / Create table cloth compatibility
compatibility.sophisticatedBackpacks	true	精妙背包兼容 / Sophisticated Backpacks compatibility

Restarting the game or server after changing configuration is recommended.

修改配置后建议重启游戏或服务器。排查模组冲突时可以逐项关闭，但正常使用建议保持全部开启。

许可证 | License

This project is licensed under the MIT License.

本项目使用 MIT License。