堆叠者

Stacknator

Stacknator 是一个轻量级的 Fabric Minecraft 模组，让你可以通过简单的配置文件自定义任何原版或模组物品的最大堆叠数量。通过在游戏初始化期间修改物品数据组件，Stacknator 提供了一种干净、高效的解决方案，没有性能开销，也没有取巧的变通手段。

兼容性

• 必需： Fabric API
• 原版物品： 完全兼容。
• 模组物品： 通常与大多数模组兼容。

标签： 通过填充器（Filler）功能支持。

提示： 要查找物品的标识符，请在游戏内按 F3 + H 启用高级提示框，然后将鼠标悬停在物品上。

安装

1. 将 Stacknator 的 .jar 文件放入你的 mods 文件夹。
2. 启动服务器或加载进入世界。
3. 编辑 stacknator.json 配置文件以设置你想要的堆叠数量。
4. 尽情享受！

在 survival（生存）玩法中仅在服务端需要，但建议客户端也安装，以便与某些界面（例如创造模式界面）完全兼容。

文档

• enabled：
  启用或禁用该模组。
  类型：boolean 默认值：true
• log_modified_items：
  切换是否记录成功的堆叠数量更改（其他日志始终显示）。
  类型：boolean 默认值：true
• checks：
  定义要执行的检查。
  类型：object 默认值：
  
  • enable_checks：
    启用或禁用所有检查。
    类型：boolean 默认值：true
    
  • check_damageable：
    启用或禁用可损坏检查。
    类型：boolean 默认值：true
    
  • check_stackable：
    启用或禁用可堆叠检查。
    类型：boolean 默认值：false
    
  • check_minimum_stack_size：
    启用或禁用最小堆叠数量检查。
    类型：boolean 默认值：true
    
  • check_maximum_stack_size：
    启用或禁用最大堆叠数量检查。
    类型：boolean 默认值：true
    
• remove_defaults：
  移除所有与默认堆叠数量匹配的物品条目。
  类型：boolean 默认值：false
  
• filler：
  定义填充器设置。
  类型：object 默认值：{}
  
  • enable_filler：
    启用或禁用填充器。启用后，模组将遍历所有已注册的物品，并在执行配置的检查的同时对每个物品应用填充规则。
    类型：boolean 默认值：false
    
  • reset_stacks：
    启用或禁用将堆叠数量重置为默认值，覆盖任何已定义的自定义堆叠数量。
    类型：boolean 默认值：false
    
  • run_once：
    运行一次后禁用填充器。
    类型：boolean 默认值：true
    
  • tag_priority：
    在应用填充器时启用或禁用标签优先于物品条目。
    类型：boolean 默认值：true
    
  • tags：
    定义标签标识符及其自定义堆叠数量。
    类型：object 默认值：{}
    
• sort_items：
  启用或禁用按条目键对物品条目进行字母顺序排序。
  类型：boolean 默认值：true
  
• items：
  定义物品标识符及其自定义堆叠数量。
  类型：object 默认值：{}
  

检查

Stacknator 会对配置文件中每个物品/标签条目执行以下检查：

• 条目键格式：
  验证条目键是否遵循 namespace:item 格式。
  失败时：跳过该条目。
• 物品可损坏：
  确保物品不可损坏（例如工具、武器和盔甲）。
  失败时：跳过该条目。
• 物品可堆叠：
  确认物品可堆叠（默认最大堆叠数大于 1）。
  失败时：跳过该条目。
• 条目值小于 1：
  检查堆叠数量是否小于 1。
  失败时：跳过该条目。
• 条目值大于 99：
  检查堆叠数量是否超过 99。
  失败时：调整为 99。

完整配置示例

{
  "enabled": true,
  "log_modified_items": true,
  "checks": {
    "enable_checks": true,
    "check_damageable": true,
    "check_stackable": false,
    "check_minimum_stack_size": true,
    "check_maximum_stack_size": true
  },
  "remove_defaults": false,
  "filler": {
    "enable_filler": false,
    "reset_stacks": false,
    "run_once": true,
    "tag_priority": true,
    "tags": {
        "#minecraft:logs": 16,
        "#minecraft:planks": 32
    }
  },
  "sort_items": true,
  "items": {
    "minecraft:egg": 64,
    "minecraft:red_bed": 16,
    "minecraft:ender_pearl": 32,
    "minecraft:tnt": 1
  }
}