# Mob Merger - Comprehensive Summary
**Mob Merger** is a performance optimization mod for Fabric on Minecraft 1.20.1 (v1.0.9) that merges nearby farm mobs to reduce lag in massive farms while maintaining equivalent production.
## Core Functionality
- **Automatic Merging**: Combines farm mobs of the same type within a 5-block radius into a single entity with a counter
- **Mob Super-Stacking**: A single mob can represent up to 100 individual mobs
- **Performance Optimization**: Significantly reduces entity count, minimizing ticks, AABB checks, and rendering overhead
## Technical Parameters
- **Merge Radius**: 5.0 blocks
- **Merge Interval**: 20 ticks (1 second), staggered by entity ID
- **Max Merged Count**: 100 mobs per entity
- **Minimum Age for Merge**: 40 ticks (2 seconds) - allows prior detection by automated systems
## Key Features
### 1. **Realistic Death System**
- You must kill a merged mob as many times as its counter indicates
- Each "death" decrements the counter by 1, drops loot for 1 mob, and fully restores health
- Only when the counter reaches 1 does the mob die permanently
- Example: Mob with counter 10 = kill it 10 times to eliminate it
### 2. **Functional Breeding System**
- Merged mobs can breed normally
- Accumulates breeding food: every 2 foods = 1 baby
- When breeding, the merged mob's counter decrements based on babies born
- Automatic spawning of multiple babies according to accumulated food
- Equal distribution of decrements between both parents
### 3. **Scaled Production by Type**
#### **Chickens**
- Accelerate egg timer according to counter (up to 10x faster)
- When laying eggs, drop as many eggs as their counter indicates
- Additional egg-laying sounds
#### **Sheep**
- When sheared, drop wool multiplied by counter
- Random base amount (1-3) × counter
- Splits into stacks to avoid overflow (max 64 per stack)
- Correctly maintains wool color
#### **Cows**
- Can be milked normally
- Each use works the same as vanilla
#### **Pigs**
- Maintain normal behavior
### 4. **Jade Integration**
- Displays "Merged: X mobs" in tooltip when looking at a merged mob
- Client-server synchronization for accurate data
## Safety Exclusions
- ❌ Does NOT merge baby mobs
- ❌ Does NOT merge mobs during breeding (isInLove)
- ❌ Does NOT merge villagers (don't inherit from Animal)
- ❌ Does NOT merge bats (they are Ambient, not Animal)
- ✅ Allows merged mobs to breed after merging
## Supported Mobs
Any entity that inherits from `Animal`:
- ✅ Chickens, cows, pigs, sheep
- ✅ All vanilla farm animals
- ❌ Villagers and bats are automatically excluded
## Technical Implementation
### Code Structure
- **`IMergedMob`**: Interface for tracking merged mob counter and breeding food
- **`AnimalMixin`**: Main merging logic, breeding, and NBT persistence
- **`LivingEntityMixin`**: Multiple death system with loot drops
- **`ChickenMixin`**: Egg production acceleration
- **`SheepMixin`**: Wool multiplication when sheared
- **`CowMixin` & `PigMixin`**: Maintain normal behavior
- **`MergedMobProvider`**: Jade integration for tooltips
### Persistence
- Saves `MergedCount` and `BreedingFoodCount` to NBT
- Persists when saving/loading chunks
### Staggering
- Uses `(gameTime + entityID) % MERGE_INTERVAL` to distribute CPU load across ticks
## Use Cases
- Massive Create mod farms with hundreds of animals
- Lag reduction on servers with many automated farms
- Performance optimization without sacrificing gameplay mechanics
- Compatible with Create and other automation mods
## Configuration
Configurable values in `MobMerger.java`:
- `MERGE_RADIUS`: Search radius for merging (default: 5.0 blocks)
- `MERGE_INTERVAL`: Check frequency (default: 20 ticks = 1 second)
- `MAX_MERGED_COUNT`: Maximum mobs in one (default: 100)
- `MIN_AGE_FOR_MERGE`: Minimum age to merge (default: 40 ticks = 2 seconds)
## Compatibility
- Minecraft 1.20.1
- Fabric Loader 0.16.9+
- Fabric API 0.92.2+
- Jade (optional, for displaying information)
- Compatible with Create and other automation mods
## Supported Languages
- English (en_us)
- Spanish (es_es) available in assets
## Installation
1. Ensure you have Fabric Loader installed
2. Download the compiled .jar file
3. Place the file in your server/client `mods` folder
4. Restart the server/client
## Building
```bash
./gradlew build
```
The .jar file will be generated in `build/libs/`
## License
MIT License - See LICENSE file for more details
## Credits
Created by Julia
Inspired by the Item Merger concept for Create farm optimization
