Clear Lagg Nicktale

Server-side cleanup for dropped items and arrows, with multilingual countdowns, TPS and RAM triggers, and optional limits for hoppers, mob spawns, and TNT.

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

  1. 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.
  2. 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.
  3. Start the server once to generate config/clear-lagg-nicktale.toml. Scheduled cleanup and TPS monitoring start enabled.
  4. 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.
  5. 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). enabled toggles the schedule. intervalSeconds uses real seconds. minimumItemAgeTicks and minimumArrowEmbeddedTicks set the minimum ages in game ticks for eligible dropped items and embedded arrows in either cleanup mode.
  • Cleanup targets (autoRemoval and emergency). Each section has its own items, embeddedArrows, experienceOrbs, otherProjectiles, fallingBlocks, hostileMobs, and otherMobs switches. Cleanup acts on loaded entities and removes them without generating loot.
  • Chat (chat). warningsEnabled toggles countdowns and summaryEnabled toggles post-cleanup chat summaries. warningSeconds lists the countdown offsets. Use offsets shorter than the cleanup interval. Edit warningMessage and warningTranslations to customize the countdown.
  • TPS monitoring (tps). Set enabled to toggle monitoring, and use sampleSeconds to set the sampling interval. Below moderateBelow, a moderate cleanup can remove up to moderateEntityLimit entities. Below severeBelow, the cap becomes severeEntityLimit. A drop of at least suddenDropTps between samples also uses the severe cap if TPS ends below the moderate threshold. Set suddenDropTps to 0 to turn off that trigger. Keep severeBelow at or below moderateBelow.
  • 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). villagers covers villagers and wandering traders. namedEntities covers custom-named entities, and tamedAnimals covers tamed animals. To let a cleanup remove villagers, set villagers = false and enable otherMobs in that cleanup's target list.
  • RAM monitoring (ram). Set enabled = true to monitor Java heap usage. If usage reaches thresholdPercent for consecutiveSamples checks, the mod can remove up to entityLimit entities. Checks use tps.sampleSeconds. Add server console commands to commands to run them after a RAM-triggered cleanup.
  • Hopper limiter (hopperLimiter). Turn it on with enabled = true. Set cyclesPerChunk and windowSeconds to limit successful block-hopper transfer cycles per chunk. A cycle can move multiple items.
  • Mob and spawner limits (mobLimiter). Use naturalEnabled and naturalMaxMobsPerChunk for natural spawning. Use spawnerEnabled and spawnerMaxMobsPerChunk for spawners. Each limit checks how many living mobs already occupy the destination chunk.
  • TNT limiter (tntLimiter). Turn it on with enabled = true. The mod blocks an additional primed TNT entity when maxPrimed other primed TNT entities are already within radiusBlocks.

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

Clear Lagg Nicktale Team

profile avatar
Owner
  • 1
    Followers
  • 26
    Projects
  • 12.1K
    Downloads

More from NitanzView all