MobStacker

MobStacker 是一个用于优化实体处理的 Minecraft 性能模组，解决了原版和模组环境中常见的性能问题根源。通过智能地“堆叠”靠近的相似生物，MobStacker 在不影响游戏机制的前提下，显著降低了服务器负载并提升了客户端性能。

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

主要优势

1. 🚀 服务器性能提升：大幅减少实体处理开销。
2. 📈 客户端 FPS 增强：降低客户端渲染压力。
3. 🌐 网络流量优化：减少实体数据传输。
4. 🎮 更清爽的游戏体验：减少生物密集区域中的视觉杂乱。
5. 💾 内存占用减少：降低整体内存使用。

性能改进

实际性能提升因服务器规格、玩家数量和模组配置而异，但 MobStacker 在以下环境中可以提供显著改善：

• 生物密度高
• 添加大量实体的模组
• 大型活跃玩家群体

🔗 注意：

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

功能

功能	描述
📦 智能堆叠	在可配置半径内自动合并相同类型的生物
🔢 可自定义堆叠	设置首选的最大堆叠大小
❤️ 灵活的堆叠管理	针对堆叠生命值和死亡机制的可配置选项
🚫 选择性堆叠	能够排除特定实体或整个模组
🔪 堆叠拆分	实现了用于拆分堆叠的分隔物品功能

配置

选项	描述	默认值
killWholeStackOnDeath	决定一个生物被杀死时整个堆叠是否死亡	false
stackHealth	启用后合并已堆叠生物的生命值	false
maxMobStackSize	单个堆叠中的最大生物数量	16
stackRadius	生物尝试堆叠的半径范围	6.0
enableSeparator	切换分隔物品用于拆分堆叠的功能	false
consumeSeparator	决定分隔物品使用时是否被消耗	true
separatorItem	指定用作分隔物的物品	"minecraft:diamond"
enableAssimilator	切换同化物品用于开启堆叠的功能	false
consumeAssimilator	决定同化物品使用时是否被消耗	true
assimilatorItem	指定用作同化物的物品	"minecraft:emerald"
ignoredEntities	从堆叠中排除的实体列表	[]
ignoredMods	其实体被排除堆叠的模组 ID 列表	[]

命令

所有命令都需要操作员权限（等级 2），并以 /mobstacker 为前缀。

配置命令

# 切换整堆死亡
/mobstacker stackerConfig killWholeStackOnDeath [true|false]

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

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

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

# 切换分隔功能
/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]

# 设置特定实体的堆叠大小
/mobstacker setStackSize [entity] [size]

注意：可以给实体添加标签 {StackData: {CanStack:0b}} 来防止其堆叠。

生物上限管理

# 设置生物类别的生成上限
/mobstacker mobCapConfig [options]

附加说明

• 🔄 兼容生物移动到一个新方块时会自动发生堆叠。
• 👑 BOSS 实体得到特殊处理，以保留自定义名称和生命条。
• 🔌 可用于自定义合并条件、死亡处理和实体数据修改器的 API。
• 📊 已堆叠生物在其名称中显示堆叠大小（例如“僵尸 x5”）。
• 🐑🐷🧟 兼容各种实体类型：动物、怪物和 NPC。

---

请在 GitHub 上的问题跟踪器报告问题。