Mob Stacker Ind.

MobStacker 是一款用于优化实体处理的 Minecraft 性能模组，可解决原版和模组环境中常见的性能问题。MobStacker 会智能地将近距离的同类生物“堆叠”起来，从而大幅降低服务器负载并提升客户端性能，同时不影响游戏机制。

需要：Dungeon Config 和 Fabric API。MobStacker 仅需安装在服务器端：玩家无需安装即可加入。

注意：MobStacker 会保留堆叠实体中的所有战利品和生物属性。已命名的生物（通过命名牌命名）不会被堆叠，以保持其独特性。

主要优点

1. 提升服务器性能：大幅降低实体处理开销。
2. 提升客户端 FPS：减轻客户端渲染负担。
3. 优化网络流量：减少实体数据传输。
4. 游戏画面更整洁：减少生物密集区域的视觉杂乱。
5. 降低内存占用：减少整体内存使用量。

性能提升

实际性能提升会因服务器配置、玩家数量和模组配置而异；在以下环境中，MobStacker 尤其能带来显著改善：

• 生物密度较高
• 安装了大量添加实体的模组
• 玩家群体规模大且活跃

🔗 注意：

• MobStacker 内置可配置的生成上限模块，可减少每个区块中的生物生成数量。

功能

不会堆叠的生物

为保持游戏玩法不变，MobStacker 不会对以下生物进行堆叠：

• 幼年生物、没有 AI 的生物以及有自定义名称的生物
• 正在骑乘、被骑乘或被拴住的生物，装有鞍的生物以及穿戴护甲的生物
• 已驯服或有主人的生物、马及其近亲，以及从桶中放出的生物
• 携带物品的生物、处于繁殖模式的动物以及玩家建造的铁傀儡
• 正在进行的袭击中的掠夺者和巡逻队长
• 有职业、床或集合点的村民（无业村民和傻子村民可以堆叠；村民一旦认领工作站或床，就会立刻离开堆叠，因此交易大厅、繁殖场和铁傀儡农场仍能正常运作）
• 手持必定掉落装备的生物
• Boss（属于 #c:bosses 或基础生命值至少达到 bossHealthThreshold 的任何生物），除非启用了 stackBosses
• 属于 #mobstacker:unstackable 实体类型标签的任何生物；默认包括末影龙、凋灵、监守者、远古守卫者、流浪商人、悦灵、蜜蜂、恼鬼、快乐恶魂、铜傀儡和嘎吱怪

配置

配置文件位于 config/mobstacker/mobstacker.json5，也可以在游戏内通过 Dungeon Config 界面进行编辑。旧版 mobstacker.json 配置（包括生物组和区块覆盖设置）会在首次启动时自动导入。

堆叠

死亡与战利品

繁殖

战斗

物品

显示

过滤器

生物上限

规则与领地

规则

规则会更改某些生物或某些位置的设置，例如在你的刷怪塔中设置更大的堆叠数量，或在 Boss 竞技场中完全禁用堆叠。一条规则可以匹配：

• 生物：像 minecraft:zombie 这样的 ID、像 #minecraft:undead 这样的标签，或像 @alexsmobs 这样的整个模组（留空 = 所有生物）
• 维度：例如 minecraft:the_nether（留空 = 全部）
• 生物群系：像 minecraft:plains 这样的 ID 或像 #minecraft:is_ocean 这样的标签（留空 = 全部）
• 位置：区块或方块区域，例如 minecraft:overworld 0 0 63 63（留空 = 所有地方）

在一条规则内部，上述各节中的每个设置（模组/实体的过滤器、生物上限和检查间隔除外）都可以被覆盖，或保留为全局，并且堆叠本身也可以关闭。当多条规则匹配同一个生物时，列表中靠前的规则生效。规则按世界保存在 serverconfig/mobstacker-rules.json 中。

安装 FTB Chunks（配合 FTB Teams）或 Open Parties and Claims 后，非管理员的玩家也可以创建规则。他们的规则仅在团队已认领的区块内生效，并且只能更改服务器允许的设置。

命令

所有命令都以 /mobstacker 为前缀。除 /mobstacker rule 外，其他所有命令都需要管理员权限（等级 2）。

通用

# Reload the config from disk
/mobstacker reload

# Show stack information for a mob
/mobstacker info [entity]

# Set stack size for specific entity
/mobstacker setStackSize [entity] [size]

配置命令

# 切换整组生物死亡
/mobstacker stackerConfig killWholeStackOnDeath [true|false]

# 切换生命值叠加
/mobstacker stackerConfig stackHealth [true|false]

# 设置最大堆叠数量
/mobstacker stackerConfig maxStackSize [value]

# 设置堆叠半径
/mobstacker stackerConfig stackRadius [value]

# 设置生物检查堆叠的频率（刻）
/mobstacker stackerConfig stackCheckInterval [value]

# 切换堆叠生物的近战伤害倍率
/mobstacker stackerConfig stackOutgoingDamage [true|false]

# 设置每次击杀死亡的生物数量
/mobstacker stackerConfig killBatchSize [value]

# 设置批量繁殖数量和冷却时间
/mobstacker stackerConfig breedBatchSize [value]
/mobstacker stackerConfig breedCooldown [value]

# 切换工具和武器耐久消耗缩放
/mobstacker stackerConfig scaleToolDamage [true|false]
/mobstacker stackerConfig damageWeaponPerHit [true|false]

# 切换村民堆叠
/mobstacker stackerConfig stackVillagers [true|false]

# 切换分离器功能
/mobstacker stackerConfig separator enableSeparator [true|false]

# 切换分离器消耗
/mobstacker stackerConfig separator consumeSeparator [true|false]

# 设置分离器物品
/mobstacker stackerConfig separator separatorItem [item_id]

# 切换吸收器功能
/mobstacker stackerConfig assimilator enableAssimilator [true|false]

# 切换吸收器消耗
/mobstacker stackerConfig assimilator consumeAssimilator [true|false]

# 设置吸收器物品
/mobstacker stackerConfig assimilator assimilatorItem [item_id]

实体与模组管理

# 忽略指定实体
/mobstacker ignore entity [entity_id]

# 忽略某个模组的所有实体
/mobstacker ignore mod [mod_id]

# 将实体从忽略列表中移除
/mobstacker unignore entity [entity_id]

# 将模组从忽略列表中移除
/mobstacker unignore mod [mod_id]

注意：可以为实体添加标签 {StackData: {CanStack:0b}}，以禁止其堆叠。也可以通过数据包将实体类型添加到 #mobstacker:unstackable 标签中。

生物上限管理

# 切换生物上限覆盖
/mobstacker mobCapConfig enableMobCapOverrides [true|false]

# 设置某个生物类别的上限
/mobstacker mobCapConfig monsterMobCap [value]
/mobstacker mobCapConfig creatureMobCap [value]
/mobstacker mobCapConfig ambientMobCap [value]
/mobstacker mobCapConfig axolotlsMobCap [value]
/mobstacker mobCapConfig undergroundWaterCreatureMobCap [value]
/mobstacker mobCapConfig waterCreatureMobCap [value]
/mobstacker mobCapConfig waterAmbientMobCap [value]

规则管理

聊天中的规则页面可以点击操作，因此大部分设置无需输入完整命令即可完成。

# 列出规则（也可以直接使用 /mobstacker rule）
/mobstacker rule list

# 创建或删除规则
/mobstacker rule add [name]
/mobstacker rule remove [rule]

# 打开规则页面
/mobstacker rule [rule]

# 启用或禁用规则
/mobstacker rule [rule] enable
/mobstacker rule [rule] disable

# 更改多个规则匹配时的优先顺序（仅限管理员）
/mobstacker rule [rule] priority [position]

# 编辑规则适用的生物、维度和生物群系
/mobstacker rule [rule] mob [add|remove] [mob_id|#tag|@mod_id]
/mobstacker rule [rule] mob clear
/mobstacker rule [rule] dimension [add|remove] [dimension_id]
/mobstacker rule [rule] dimension here
/mobstacker rule [rule] biome [add|remove] [biome_id|#tag]
/mobstacker rule [rule] biome here

# 为规则添加地点
/mobstacker rule [rule] place chunk [chunkX] [chunkZ]
/mobstacker rule [rule] place chunks [radius]
/mobstacker rule [rule] place area [x1] [z1] [x2] [z2]
/mobstacker rule [rule] place remove [number]
/mobstacker rule [rule] place clear

# 查看和更改规则设置
/mobstacker rule [rule] settings [page]
/mobstacker rule [rule] set [setting] [value]
/mobstacker rule [rule] reset [setting]

API

其他模组可以通过 MobStackerAPI 进行集成：

• getStackSize(mob)：一个生物代表多少个生物
• addMergingCondition(...)：两个生物合并必须满足的额外条件
• addDeathHandler(...)：当堆叠生物死亡且堆叠中剩余生物取而代之的时候运行
• addEntityDataModifiers(...)：调整替代死亡或爆炸的堆叠生物的生物
• addEntityDataModifiersOnSeparation(...)：调整用分离器分离出来的生物
• registerClaimProvider(...)：添加对另一个领地模组的支持

附加说明

• 生物会定期寻找附近的堆叠加入（每 stackCheckInterval 刻）。
• 当堆叠的苦力怕爆炸或末影人拾取方块时，只有那一个生物会这样做；堆叠中剩余的生物会留在原地。
• 堆叠生物会在名称中显示堆叠数量（例如“Zombie x5”），并以每个玩家自己的语言显示。
• 兼容各种实体类型：动物、怪物和NPC。

请将问题报告到 github 上的问题追踪器。