Lag Shield

# LAG SHIELD 5.0 🛡️ — THE CONTROL UPDATE

## 🎛️ THE ADDON CONTROL CENTER
Lag Shield could always tell you WHICH addon is lagging your world. now you can actually do something about it, without uninstalling it.
**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, its top mobs, and four controls:
- **mob budget**: the most mobs it's allowed to have loaded at once. extras get removed farthest-from-players first
- **freeze new spawns**: its new mobs get removed as they show up
- **clear its mobs now**: a one-time cleanup, with a confirm first
- **never touch**: nothing in Lag Shield will ever remove anything from that addon

vehicles, anything you can ride, storage mobs, bosses, named/tamed/leashed mobs and your safe zones are never touched, whatever you set. (typing instead? `lag:addon <addon> budget 60`)

## 🤖 AUTOPILOT
Lag Shield tunes itself now. when your TPS drops it tightens the mob cap, the far cull range and the sweep timer, and when TPS recovers it eases back off one step at a time. if one addon floods your world while TPS is critical, autopilot holds that addon down until things calm down.
every move it makes goes in a log you can read (menu → Autopilot). your own settings never get overwritten. it's on by default and one tap turns it off.

## 🔍 THE SPYGLASS
point at anything. the action bar tells you **what it is**, **which addon made it**, and **whether Lag Shield will ever touch it** — "never removed", "safe zone", "budget 60", "far cull past 96m". mobs show their health, chests show how full they are, and vanilla names come through in your own language.
three modes in menu → Settings → **Spyglass**: off, mobs + addon blocks (default), or everything. it gets out of the way on its own while your TPS is low. (`lag:spy off|on|all`)

## 🌍 WORLD PRE-GEN
generate your world ahead of time. pick a radius (256 up to 3000 blocks) and it works outward from where you're standing, in the background, with a progress bar. exploring there later loads saved chunks instead of generating new ones.
it pauses itself whenever TPS drops, picks back up after a relog, and cleans up after itself. still no experiments.

## 🗺️ LAG MAP
a live map of the load around you, right in the menu: every chunk colored by how many entities are in it, plus the worst spots with direction, distance and the addon behind them.

## 🏠 SAFE ZONES
mark your base, farm or build, and nothing inside it ever gets cleaned up: no sweeps, no thinning, no far cull, no budgets. you get a little notice when you walk into one.

## 📜 REMOVAL LOG
"did Lag Shield remove my stuff?" finally has an answer. it keeps the last removals: what they were, which addon, where and when. if it's not in the log, Lag Shield didn't remove it.

## 🚁 FAR CULL IS SAFER
@MrSimple2i's helicopter got despawned by far cull when he flew away from it. that one's on me. far cull now only removes **hostile mobs** by default, and **nothing in Lag Shield ever removes** vehicles or anything you can ride, anything that holds items, bosses, named/tamed/leashed mobs, furniture and decoration entities, paintings, ender pearls, thrown tridents, boats or minecarts.
- `lag:cull add <mob>` puts a specific mob on the far cull list. `lag:toggle cullall` switches far cull to all living mobs (the protected stuff stays safe even then)
- menu → Settings → **Mob lists** does the same with a text box, no cheats needed

## ✅ also
- `lag:fix` now also turns autopilot on and gives an addon that's flooding your world a budget
- the report card tells you when one addon is 30%+ of your whole world and points you at the control center
- **you get a compass when you load in** if you haven't got one — the whole addon lives on it, so nobody is locked out of the menu. after a death too. (Settings → Compass on load turns it off)
- the compass menu got reorganized: control center up top, the detective tools moved into **More tools**
- still stable API, no experiments, achievement-friendly flag kept

thanks @MrSimple2i for the far cull report 🙏 and everyone in the comments. keep it coming.