Clear Lagg Nicktale
Summary
Server-side cleanup for dropped items and arrows, with multilingual countdowns, TPS and RAM triggers, and optional limits for hoppers, mob spawns, and TNT.
What it does
Clear Lagg Nicktale clears dropped items and embedded arrows every 60 seconds by default. If server TPS drops, it can run an emergency cleanup with separate entity limits for moderate and severe lag. Villagers, wandering traders, named entities, and tamed animals are protected by default. Configure scheduled and emergency cleanup separately so each removes only the entity types you select.
Compatibility
| Minecraft | Server loaders | Java |
|---|---|---|
| 1.20.1 | Forge, Fabric, NeoForge | 17 |
| 1.21.1 | Forge, Fabric, NeoForge | 21 |
| 26.2 | Forge, Fabric, NeoForge | 25 |
| 26.3 | Forge, Fabric, NeoForge | 25 |
Install the mod on the dedicated server. Players can join with their normal client setup.
Installation and setup
- Choose the JAR for your server's Minecraft version and loader. On NeoForge 1.20.1, use the JAR ending in
neoforge-1.20.1.jar. - Stop the server and place the matching JAR in its
mods/folder. When updating, replace the previous Clear Lagg Nicktale JAR and keep your existing TOML. - Start the server once to generate
config/clear-lagg-nicktale.toml. Scheduled cleanup and TPS monitoring start enabled. - Edit the TOML to set the interval, select targets, customize the countdown, or enable optional limiters. Restart the server after editing to apply the settings.
- Check the console and chat during the first cleanup. By default, warnings appear 20 and 5 seconds before cleanup, and the removal summary appears when entities are removed.
Configuration reference
- Scheduled cleanup (
autoRemoval).enabledtoggles the schedule.intervalSecondsuses real seconds.minimumItemAgeTicksandminimumArrowEmbeddedTicksset the minimum ages in game ticks for eligible dropped items and embedded arrows in either cleanup mode. - Cleanup targets (
autoRemovalandemergency). Each section has its ownitems,embeddedArrows,experienceOrbs,otherProjectiles,fallingBlocks,hostileMobs, andotherMobsswitches. Cleanup acts on loaded entities and removes them without generating loot. - Chat (
chat).warningsEnabledtoggles countdowns andsummaryEnabledtoggles post-cleanup chat summaries.warningSecondslists the countdown offsets. Use offsets shorter than the cleanup interval. EditwarningMessageandwarningTranslationsto customize the countdown. - TPS monitoring (
tps). Setenabledto toggle monitoring, and usesampleSecondsto set the sampling interval. BelowmoderateBelow, a moderate cleanup can remove up tomoderateEntityLimitentities. BelowsevereBelow, the cap becomessevereEntityLimit. A drop of at leastsuddenDropTpsbetween samples also uses the severe cap if TPS ends below the moderate threshold. SetsuddenDropTpsto0to turn off that trigger. KeepsevereBelowat or belowmoderateBelow. - Emergency cooldown (
emergency.cooldownSeconds). TPS and RAM cleanups share this cooldown. Escalation to severe TPS lag can trigger a cleanup before the cooldown expires. - Entity protection (
protection).villagerscovers villagers and wandering traders.namedEntitiescovers custom-named entities, andtamedAnimalscovers tamed animals. To let a cleanup remove villagers, setvillagers = falseand enableotherMobsin that cleanup's target list. - RAM monitoring (
ram). Setenabled = trueto monitor Java heap usage. If usage reachesthresholdPercentforconsecutiveSampleschecks, the mod can remove up toentityLimitentities. Checks usetps.sampleSeconds. Add server console commands tocommandsto run them after a RAM-triggered cleanup. - Hopper limiter (
hopperLimiter). Turn it on withenabled = true. SetcyclesPerChunkandwindowSecondsto limit successful block-hopper transfer cycles per chunk. A cycle can move multiple items. - Mob and spawner limits (
mobLimiter). UsenaturalEnabledandnaturalMaxMobsPerChunkfor natural spawning. UsespawnerEnabledandspawnerMaxMobsPerChunkfor spawners. Each limit checks how many living mobs already occupy the destination chunk. - TNT limiter (
tntLimiter). Turn it on withenabled = true. The mod blocks an additional primed TNT entity whenmaxPrimedother primed TNT entities are already withinradiusBlocks.
Multilingual countdowns
Add entries to warningTranslations in locale=message format. The mod checks the player's exact game locale first, such as es_cl, then the language, such as es, and finally warningMessage. Use {seconds} wherever the countdown number should appear. Set warningTranslations = [] to show your base message to every player.
Complete default TOML
[autoRemoval]
enabled = true
intervalSeconds = 60
minimumItemAgeTicks = 100
minimumArrowEmbeddedTicks = 20
items = true
embeddedArrows = true
experienceOrbs = false
otherProjectiles = false
fallingBlocks = false
hostileMobs = false
otherMobs = false
[chat]
warningsEnabled = true
summaryEnabled = true
warningSeconds = [20, 5]
warningMessage = "Clear Lag Nicktale will clear dropped items in {seconds} seconds."
warningTranslations = ["es=Clear Lag Nicktale limpiará los ítems del suelo en {seconds} segundos."]
[tps]
enabled = true
sampleSeconds = 5
moderateBelow = 18.0
severeBelow = 15.0
suddenDropTps = 3.0
moderateEntityLimit = 75
severeEntityLimit = 400
[emergency]
cooldownSeconds = 30
items = true
embeddedArrows = true
experienceOrbs = true
otherProjectiles = false
fallingBlocks = false
hostileMobs = true
otherMobs = false
[protection]
villagers = true
namedEntities = true
tamedAnimals = true
[ram]
enabled = false
thresholdPercent = 90.0
consecutiveSamples = 3
entityLimit = 150
commands = []
[hopperLimiter]
enabled = false
windowSeconds = 1
cyclesPerChunk = 64
[mobLimiter]
naturalEnabled = false
naturalMaxMobsPerChunk = 48
spawnerEnabled = false
spawnerMaxMobsPerChunk = 32
[tntLimiter]
enabled = false
maxPrimed = 32
radiusBlocks = 16.0