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

./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