❄️ FrostLag Lite

A lightweight, silent anti-lag plugin for Paper, Spigot and Bukkit (1.20.1 to 26.x). It reduces server lag and improves both server TPS and player FPS without breaking NPCs, holograms, builds or items from other plugins.

Everything is configured and enabled out of the box: just drop it into your plugins/ folder and restart.

---

✨ Why FrostLag?

Most "clear lag" plugins wipe everything off the ground every few minutes, spam the chat with warnings and delete NPCs and holograms along the way. FrostLag works differently:

• 🔇 100% silent: cleanup never sends messages to chat or console.
• 🛡️ Leaves your stuff alone: NPCs, holograms, armor stands, item frames, villagers, named or tamed mobs and plugin items are protected.
• 🧠 Prevents before it removes: it merges items, limits entities and only tightens the rules when TPS actually drops.
• ⚙️ Works with zero setup, and everything can be tuned in config.yml.

---

🚀 Features

🧹 Silent automatic cleanup

• Removes dropped items, XP orbs and arrows stuck in blocks every 10 minutes (every 3 minutes while the server is lagging).
• Freshly dropped items (deaths, broken blocks) are protected for 10 seconds.
• Turn it on or off in-game with /fl auto on and /fl auto off. Your choice is saved.

📦 Item merging

Identical nearby items are merged into a single stack. Fewer entities on the ground means less work for the server and less for players to render (more FPS).

🐄 Mob limit per chunk

Stops farms, spawners and animal breeding from flooding a chunk:

• Normal: 30 monsters, 40 animals and 60 mobs in total per chunk.
• In anti-lag mode: 15 / 25 / 35.
• Spawns from plugins, /summon and spawn eggs are never blocked.

💣 Lag machine protection

Per-chunk limits for falling sand and gravel (16), primed TNT (24), minecarts (20) and boats (20).

🔍 Crowded chunk sweep

Every minute the plugin looks for chunks with piled-up items (over 150) or mobs and removes only the excess.

🐢 Automatic anti-lag mode

If TPS stays below 17 for 30 seconds, FrostLag:

• tightens the mob limits and cleans up more often;
• lowers view and simulation distance (Paper only);
• freezes mob AI in crowded chunks, such as farms.

When TPS gets back to 19, everything is restored automatically.

📊 TPS monitor

• Current, 1-minute and 5-minute TPS, plus MSPT (Paper), RAM, CPU cores and entities per world.
• /fl top lists the chunks with the most entities, with coordinates, so you can find the farm that is causing lag.
• Low TPS and freeze warnings are shown to OPs only, and can be turned off.

---

🛡️ Compatibility with other plugins

Protection is generic and works with any plugin, not only the ones listed here:

Type	Examples
NPCs	Citizens, FancyNpcs, ZNPCsPlus, Denizen, Sentinel
Holograms	DecentHolograms, HolographicDisplays, FancyHolograms, CMI
Builds	WorldEdit, FAWE, Axiom, armor stands, displays, item frames, paintings
Custom items	ItemsAdder, Oraxen, Nexo, MMOItems, Slimefun
Mobs	MythicMobs, ModelEngine, RoseStacker, WildStacker, StackMob
Shops	Shopkeepers, QuickShop, ChestShop
Clients	Geyser/Bedrock, ViaVersion and any client mod (the plugin sends no packets)

---

⌨️ Commands

All commands are OP only (and console). Aliases: /fl and /antilag.

Command	What it does
/fl status	TPS, MSPT, RAM, CPU, entities and chunks per world
/fl top	Chunks with the most entities (with coordinates)
/fl auto <on|off>	Turns automatic cleanup on or off
/fl limpar <itens|mobs|tudo>	Cleans up now (items, mobs or everything)
/fl varrer	Removes the excess from crowded chunks
/fl juntar	Merges identical items on the ground
/fl otimizar	Does all of the above at once
/fl modolag <on|off|auto>	Forces anti-lag mode on or off
/fl reload	Reloads config.yml

The command names and the in-game/config texts are in Portuguese.

---

📋 Requirements

• Server: Paper, Spigot, Bukkit, Purpur or Pufferfish.
• Versions: 1.20.1 to 26.x. It only uses the official Bukkit API (no NMS), so it should keep working on future versions.
• Java: 17 or newer.
• On Spigot and Bukkit, MSPT and the automatic view distance reduction are not available (they are Paper features). Everything else works the same.
• Does not work on Folia or on proxies (Velocity/BungeeCord). Install it on the Paper servers behind your proxy.

ℹ️ Important: when the server starts, the Lite version prints one message in the console advertising the PRO version. It is never shown to players, and FrostLag Lite does not connect to the internet.

---

💎 FrostLag PRO

Everything in Lite, plus a full monitoring system through Discord:

🔔 Automatic Discord alerts (webhook)

Each kind of problem arrives with its own title, color and details:

• 🧩 Plugin errors: which plugin, its version, the exception and the exact line of code.
• 📦 Plugins that failed to load or got disabled.
• 💥 Crashes: including crashes that happened while the server was offline, with the suspected plugins.
• 🧊 Server freezes (watchdog): reads the thread dump and points out the plugin to blame and the likely cause (SQL on the main thread, chunk generation, low RAM...).
• 🐢 Lag: heaviest chunks, plugins with the most tasks and the likely cause.
• 🧱 Chunk, 🗺️ world and 👾 entity errors, with coordinates.
• 🧠 High RAM and 💾 low disk space, showing which plugins use the most space.
• ⚠️ Grouped warnings, 🟢 server started / 🔴 server stopped and 📊 periodic reports.
• Alerts keep arriving even while the server is frozen.

🎙️ Server status on Discord

• A voice channel showing online players, for example 🟢 Online: 37/200. Works with your server's IP or your proxy's (Velocity/BungeeCord).
• A live message that updates every 30 seconds with players, TPS, RAM, worlds, version and MOTD.

💰 Only R$ 40 (BRL), one-time payment, no subscription.

	Lite	PRO
Silent cleanup, item merging, limits and anti-lag mode	✅	✅
Protection for NPCs, holograms, builds and items	✅	✅
Discord alerts for errors, crashes and freezes	❌	✅
Find out which plugin is freezing the server	❌	✅
Voice channel with online players + live status	❌	✅
PRO message in the console	Yes	No
Price	Free	R$ 40 (one-time)

To buy PRO:

• 💬 Discord: 0frostside0_
• 🌐 Website: https://frostside.com.br

---

Made by frostside0 • frostside.com.br