Описание
**MobStacker** is a performance Minecraft mod to optimize entity handling, addressing a common cause of performance issues in vanilla and modded environments. By intelligently "stacking" similar mobs in close proximity, MobStacker significantly reduces server load and enhances client-side performance without compromising gameplay mechanics.
> 💡 **Note**: MobStacker preserves all loot and mob properties within stacked entities. Named mobs (via name tags) are exempt from stacking to maintain uniqueness.
## Key Benefits
1. **🚀 Server Performance Boost**: Dramatically reduces entity processing overhead.
2. **📈 Enhanced Client FPS**: Lowers strain on client-side rendering.
3. **🌐 Optimized Network Traffic**: Minimizes entity data transmission.
4. **🎮 Cleaner Gameplay**: Reduces visual clutter in mob-dense areas.
5. **💾 Memory Usage Reduction**: Lowers overall memory footprint.
## Performance Improvement
While actual performance gains vary based on server specifications, player count, and mod configurations, MobStacker can provide substantial improvements, especially in environments with:
- High mob density
- Numerous entity-adding mods
- Large, active player bases
> 🔗 **Note**:
> - MobStacker has a built in configurable spawn cap module to reduce mob spawns per chunk.
## Features
| Feature | Description |
|---------|-------------|
| 📦 Smart Stacking | Automatically combines identical mob types within a configurable radius |
| 🔢 Customizable Stacks | Set preferred maximum stack sizes |
| ❤️ Flexible Health Management | Configurable options for stack health and death mechanics |
| 🚫 Selective Stacking | Ability to exclude specific entities or entire mods |
| 🔪 Stack Splitting | Implemented separator item functionality for dividing stacks |
## Configuration
| Option | Description | Default |
|--------|-------------|---------|
| `killWholeStackOnDeath` | Determines if 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` | Toggles use of separator item for stack splitting | `false` |
| `consumeSeparator` | Determines if separator item is consumed on use | `true` |
| `separatorItem` | Specifies the item used as a separator | `"minecraft:diamond"` |
| `enableAssimilator` | Toggles use of assimilator item for stackable toggle | `false` |
| `consumeAssimilator` | Determines if assimilator item is consumed on use | `true` |
| `assimilatorItem` | Specifies the item used as a 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
```bash
# 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
```bash
# 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
```bash
# Set mob cap for mob categories
/mobstacker mobCapConfig [options]
```
## Additional Notes
- 🔄 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.*