MobStacker
MobStacker is a Minecraft mod designed to optimize entity handling and address a common performance issue in both vanilla and modded environments. Through intelligent "stacking" of similar mobs in close proximity, MobStacker significantly reduces server load and improves client-side performance without disrupting gameplay mechanics.
💡 Important: MobStacker preserves all loot and mob properties within stacked entities. Named mobs (via name tags) are excluded from stacking to maintain their uniqueness.
Key Benefits
- 🚀 Server Performance Boost: Substantially reduces entity processing overhead.
- 📈 Enhanced Client FPS: Lowers rendering strain.
- 🌐 Optimized Network Traffic: Minimizes entity data transmission.
- 🎮 Cleaner Gameplay Environment: Reduces visual clutter in mob-dense areas.
- 💾 Memory Usage Reduction: Decreases overall memory consumption.
Performance Improvement
While actual performance gains depend on server specifications, player count, and mod configurations, MobStacker can provide significant improvements, especially in conditions with:
- High mob density
- Numerous entity-adding mods
- Large numbers of active players
🔗 Note: MobStacker includes a built-in configurable spawn cap module to reduce the number of spawning mobs per chunk.
Features
| Feature | Description |
|---|---|
| 📦 Smart Stacking | Automatically combines identical mob types within a configurable radius |
| 🔢 Customizable Stacks | Setting preferred maximum stack sizes |
| ❤️ Flexible Health Management | Configurable parameters for stack health and death mechanics |
| 🚫 Selective Stacking | Ability to exclude specific entities or entire mods |
| 🔪 Stack Splitting | Separator item functionality for dividing stacks |
Configuration
| Option | Description | Default |
|---|---|---|
killWholeStackOnDeath |
Determines whether the entire stack dies when one mob is killed | false |
stackHealth |
Combines health of stacked mobs when enabled | false |
maxMobStackSize |
Maximum number of mobs in a single stack | 16 |
stackRadius |
Radius within which mobs attempt to stack | 6.0 |
enableSeparator |
Enables use of separator item | false |
consumeSeparator |
Determines whether separator item is consumed on use | true |
separatorItem |
Specifies the item used as a separator | "minecraft:diamond" |
enableAssimilator |
Enables use of assimilator for toggling stackability | false |
consumeAssimilator |
Determines whether assimilator is consumed on use | true |
assimilatorItem |
Specifies the item used as an assimilator | "minecraft:emerald" |
ignoredEntities |
List of entities excluded from stacking | [] |
ignoredMods |
List of mod IDs whose entities are excluded from stacking | [] |
Commands
All commands require operator permissions (level 2) and are prefixed with /mobstacker.
Configuration Commands
# Toggle whole stack death
/mobstacker stackerConfig killWholeStackOnDeath [true|false]
# Toggle health stacking
/mobstacker stackerConfig stackHealth [true|false]
# Set maximum stack size
/mobstacker stackerConfig maxStackSize [value]
# Set stack radius
/mobstacker stackerConfig stackRadius [value]
# Toggle separator functionality
/mobstacker stackerConfig separator enableSeparator [true|false]
# Toggle separator consumption
/mobstacker stackerConfig separator consumeSeparator [true|false]
# Set separator item
/mobstacker stackerConfig separator separatorItem [item_id]
# Toggle assimilator functionality
/mobstacker stackerConfig assimilator enableAssimilator [true|false]
# Toggle assimilator consumption
/mobstacker stackerConfig assimilator consumeAssimilator [true|false]
# Set assimilator item
/mobstacker stackerConfig assimilator assimilatorItem [item_id]Entity and Mod Management
# Ignore specific entity
/mobstacker ignore entity [entity_id]
# Ignore all entities from a mod
/mobstacker ignore mod [mod_id]
# Remove entity from ignore list
/mobstacker unignore entity [entity_id]
# Remove mod from ignore list
/mobstacker unignore mod [mod_id]
# Set stack size for specific entity
/mobstacker setStackSize [entity] [size]NOTE: An entity can be given the tag {StackData: {CanStack:0b}} to prevent it from stacking.
Mob Cap Management
# Set mob cap for mob categories
/mobstacker mobCapConfig [options]Additional Information
- 🔄 Automatic stacking occurs when compatible mobs move to a new block.
- 👑 Boss entities receive special handling to preserve custom names and health bars.
- 🔌 API available for custom merging conditions, death handlers, and entity data modifiers.
- 📊 Stacked mobs display stack size in their name (e.g., "Zombie x5").
- 🐑🐷🧟 Compatible with various entity types: animals, monsters, and NPCs.
Report issues to the issue tracker on GitHub.
