🦠 Slime — Heuristic Memory Purger 🦠

The silent guardian of your Minecraft server.

Slime is a 100% server-side mod that automatically monitors and cleans your Minecraft server's RAM. No more crashes after a few hours of uptime, no more OutOfMemoryError in the middle of the night — Slime handles everything in the background, with zero intervention required.

⚠️ The Problem

Minecraft runs on Java. Java uses a Garbage Collector (GC) to clean up memory automatically. In theory, it works great. In practice, once you start stacking mods, some of them "forget" to release their data: an unloaded chunk still referenced somewhere, a dead entity lingering in a forgotten list, a cache that keeps growing and never flushes...

These memory leaks pile up silently. After 2, 4, 8 hours of gameplay, the server starts lagging, stuttering, and eventually crashes. You restart, and the cycle begins again.

♻️ The Solution

Slime acts as a janitor for your server's brain. It continuously patrols memory, spots data that hasn't been touched in a suspiciously long time, and forces it to be released — freeing up the RAM that Java's Garbage Collector couldn't reach on its own.

✨ Features

🟢 Automatic Heuristic Purging

Slime timestamps every tracked piece of data in memory. If a chunk, entity, or cache entry hasn't been accessed in over 10 minutes (configurable), it's flagged as "stale" and destroyed. Everything runs in the background with no impact on server performance.

🟢 Real-Time Heap Monitoring

The mod continuously watches memory usage. If it exceeds 85%, an emergency purge is triggered immediately — without waiting for the next scheduled cycle. If it hits 92%, a forced System.gc() is called as a last resort.

🟢 Non-Blocking Thread

All purging logic runs on a low-priority daemon thread. The server experiences zero lag, zero freezes, zero slowdowns from this mod.

🟢 In-Game Commands

Monitor and control the purger directly from chat:

Command	Description
`/purger status`	Memory state, tracked entries, statistics
`/purger force`	Trigger an immediate purge cycle
`/purger gc`	Force the garbage collector (last resort)

Clients do NOT need to install this mod.
Slime doesn't touch any Forge registry — no blocks, no items, no textures. Just drop it in your server's mods/ folder and players connect as usual, with nothing to change on their end.

⚙️ Installation

Download the .jar
Drop it in your server's mods/ folder (Forge 1.20.1)
Start the server — that's it

On first launch, slime-purger.toml is auto-generated in the config/ folder. Tweak it to your needs and restart.

🎯 Who Is This For?

Dedicated server admins who need 24/7 stability
Modpack creators stacking dozens (or hundreds) of mods
Solo players on long sessions whose game slows down after a few hours
Hosting providers looking to reduce forced restarts

🧩 Compatibility

Minecraft: 1.20.1
Forge: 47+
Side: Server only
Known conflicts: None — the mod doesn't interact with any registry or other mod.

❓ FAQ

Does it cause lag?
No. The monitoring thread runs at minimum priority and never blocks the main server tick.

Can it delete important data?
The mod uses WeakReference. It can only release data that is no longer used by any other part of the code. If an entity is still alive in a world, it will never be purged.

Do clients need to install it?
Never. The mod is completely invisible to connected players.

Why do the logs say "0 entries purged"?
That's normal! It means memory is healthy and no stale data was found. The mod keeps watching silently in the background.