mob merger

# 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