Stop choosing between performance and gameplay. Most "Clear Lag" addons are destructive—they delete your pets, clear your farms, and cause massive lag spikes every time they run. Hybrid Optimizer is different. It uses a smart "Split-Logic" System that aggressively cleans up monsters and junk while completely ignoring your pets, villagers, and farm animals. It runs on a Time-Sliced Generator, meaning it cleans the world gently over multiple ticks, ensuring 0% TPS drop even during heavy cleanups.

🌟 Key Features

🧠 Smart Auto-Detection (Addon Compatible)

Automatically detects "Hostile" mobs (Zombies, Creepers, etc.) using type_family and behavior checks.
Works with Custom Mobs: If you add a "Mutant Zombie" addon, Hybrid Optimizer instantly recognizes it as a monster and manages it. If you add a "Cute Pets" addon, it instantly recognizes them as safe. No configuration needed!
Hard-Coded Safety: Includes a built-in safe list for Iron Golems, Villagers, Allays, and all vanilla pets.

⚡ Zero-Lag "Time Slicing"

Instead of freezing the server to clean everything at once, this script processes entities in small batches (50 per tick).
Your game logic (Redstone, Physics) runs smoothly between the cleanup steps, eliminating the "lag spike" common in other optimizers.

🧹 Aggressive Hostile Cleanup

Distance Despawning: Instantly removes monsters >128 blocks away from players.
Chunk Limits: If a mob farm overflows, it intelligently caps monsters at 8 per chunk (configurable) to prevent crashes.
AFK Detection: Removes monsters that have been idle (taking no damage/dealing no damage) for 30 seconds.

📦 Intelligent Item Management

Smart Merging: Stacks nearby floating items to reduce entity count (e.g., 50 individual cobblestone items become 1 stack).
Density Caps: Limits floating items to 20 per chunk to stop explosion lag.
⚙️ How It Works

Passive Mobs (Cows, Pets, Villagers): The script ignores them completely. They follow standard Vanilla Minecraft rules. They will never be deleted by this addon.
Hostile Mobs (Zombies, Skeletons): The script actively manages them. They are despawned if they are too far, too old, or too crowded.
Items & XP: Actively merged and cleaned up to maintain high FPS.

🎨 Client-Side: The "Visual" Optimizer

The beauty of the operation. Runs on your device to boost FPS.

Optimized Particles: Redesigned particle JSONs (Explosions, Smoke, Potions) to look great but render faster.
Texture Optimization: Compressed textures for leaves, water, and UI elements to lower memory usage.
Fog & Render Distance: Custom fog settings to obscure distant chunk loading without ruining the view.
Flipbook Optimization: Smoother animations for water, fire, and portals that demand less from your GPU.

📝 Configuration

The script is plug-and-play, but you can edit the Config variable at the top of the main.js file to tune it to your server's needs:

JavaScript (pack\scripts\main.js)

const C = {
    h: { d: 128, mpc: 8, mit: 600, ci: 100 }, // Hostile Mobs Settings
    i: { mpc: 20, mr: 3, da: 6000 }           // Item Settings
}

d: Despawn Distance (Blocks)
mpc: Max Per Chunk
mit: Max Idle Time (Ticks)
ci: Check Interval (Ticks)

Optimized for: Minecraft Bedrock 1.21+ (Script API) License: MIT (Free to use in modpacks)

HYBRID OPTIMIZATION