🛡️ LAG SHIELD
so my girlfriend and i have a survival world with 10+ addons and it started LAGGING. i looked for an addon that could actually help… and nothing really specialized in it. so i built one.
**5.0 is "The Control Update".** Lag Shield always told you which addon was lagging you. now you control it.
## 🎛️ THE ADDON CONTROL CENTER
**sneak + tap a COMPASS → Addon Control Center.** every addon in your world gets its own page: how many mobs it has loaded, what % of your world's load that is, and its top mobs. then:
• **mob budget**: the most mobs it's allowed to have loaded. extras go, farthest from players first
• **freeze new spawns**: its new mobs get removed as they show up
• **clear its mobs now**: one-time cleanup, with a confirm first
• **never touch**: nothing in Lag Shield ever removes anything from it
**the addon that tanks your world doesn't have to go. just give it a budget.**
vehicles, anything you can ride, storage mobs, bosses, named/tamed/leashed mobs and your safe zones are never touched, whatever you set.
## 🤖 AUTOPILOT
Lag Shield tunes itself. TPS drops → it tightens the mob cap, far cull range and sweep timer. TPS recovers → it eases back off, one step at a time. if one addon floods your world while TPS is critical, autopilot holds it down until things calm down.
every move goes in a log you can read, and your own settings never get overwritten. on by default.
## 🔍 THE SPYGLASS
**point at anything.** one line on your action bar: what it is, which addon made it, and whether Lag Shield will ever touch it.
• mobs show their health and their status: **never removed** · **safe zone** · **budget 60** · **far cull past 96m**
• addon blocks name the addon behind them — so you can finally tell which pack put that thing there
• chests and machines show how full they are
• vanilla names come through in your own language
three modes in Settings → **Spyglass**: off, mobs + addon blocks (the default), or everything. it steps aside on its own while TPS is low — a lag addon shouldn't be the thing costing you frames.
## 🌍 WORLD PRE-GEN
generate your world ahead of time: pick a radius (256–3000 blocks) and it works outward from where you stand, in the background, with a progress bar. exploring there later loads saved chunks instead of generating new ones. it pauses itself when TPS drops and picks back up after a relog.
## 🗺️ LAG MAP
a live map of the load around you: every chunk colored by how many entities are in it, plus the worst spots with direction, distance and the addon behind them.
## 🏠 SAFE ZONES + 📜 REMOVAL LOG
mark your base or farm as a **safe zone** and nothing inside it ever gets cleaned up.
the **removal log** shows the last things any cleanup removed: what, which addon, where and when. if it's not in the log, Lag Shield didn't remove it.
## 🏆 ACHIEVEMENT-FRIENDLY
the whole addon runs from the **compass menu**, so no commands and no cheats needed. the manifest carries the `"product_type": "addon"` flag Minecraft looks for, so the pack itself shouldn't disable achievements either. keep cheats OFF and skip the Experiments toggles.
*(if your world still turns them off, comment and i'll keep digging — Mojang changes how this is detected.)*
## 🔎 THE DETECTIVE KIT
• **report card**: grades your world A–F and says what to fix in plain english, including when the lag ISN'T the world's fault
• **flight recorder**: logs every lag spike while you play, with the addon it came from, so you can see the lag you missed
• **which addon**: every loaded entity grouped by the addon that made it
• **benchmark**: test any addon's real TPS cost before it earns a slot in your world
• **who's loading**: on a realm, which player is carrying the load and where
• tps, census, hotspot coords, lifetime stats, live TPS on your action bar
## 🧹 THE AUTO-CLEANER
• **far cull**: removes hostile mobs no player is anywhere near (the cave-addon killer). add more mob types to it yourself if you want
• **mob thinner**: caps entity floods per type
• **auto-sweep**: items, xp orbs and stuck arrows every 5 min, with a countdown first
• 💎 never touches netherite/diamond gear, shulkers, elytra, totems, tridents, enchanted books or named items
• zero-hitch: clearing 10,000 items causes no freeze
🧭 **haven't got a compass?** you get one when you load into the world, and again after a death if you lost it. nobody gets locked out of the menu. (Settings → Compass on load, if you'd rather it didn't.)
⚙️ everything is in the compass menu, or type `/scriptevent lag:help` if you like commands.
## ✅ THE IMPORTANT PART
• 100% stable script APIs, **NO experimental toggles** (safe for your world/Realm)
• only the **HOST** needs it, it covers everyone
• tested on Bedrock 26.52
⚠️ honest limits (i won't lie to you): no addon can make chunk generation itself faster or see redstone/hopper lag. pre-gen does the generating ahead of time so it's not happening while you explore. entity load is the #1 lag source in modded worlds and that's exactly what this controls. for chunk lag: Simulation Distance 4-6 in world settings.
🙏 thanks to **@MrSimple2i** (safer far cull), **@YoSnowww** (far cull exists because of you), **@sahilsourav4u** + **@Xgodsentx13** (achievements) and everyone who's commented. 1.0 → 5.0 because you kept talking.
— see your TPS. find your lag. control it. 🛡️
-Rely
