Naturalist Lag Fix

Fixes a memory leak in Naturalist that slows down servers over time (whale & shark body parts).

Naturalist Lag Fix

A small fix for a memory leak in [Naturalist](https://www.curseforge.com/minecraft/mc-mods/naturalist) (2.0.5, NeoForge 1.21.1) that makes servers slower and slower the longer they run.

The problem
Whales and Great White Sharks have multi-part bodies. Naturalist registers every body part in a list attached to the world, but only removes them when the creature dies or is discarded. When the creature is simply unloaded with its chunk, its parts stay in the list forever — and a new copy is added each time the chunk reloads.

Every time the game searches for nearby entities (mob AI, collisions, item pickup, Create contraptions…), Naturalist loops over that whole list. On our server, `naturalist$includeMobParts` ended up taking about 33% of every server tick in spark.

The fix
- Body parts are removed as soon as their creature leaves the world, including when its chunk unloads.
- Every 10 seconds, any leftover orphan parts are cleaned up.
- Nothing else in Naturalist is changed: whales and sharks behave exactly the same.

Installation
- Server: required.
- Client: recommended (the same leak exists client-side).
- Requires Naturalist. When the fix works, a line `[NaturalistFix] … parties fantomes retirees` appears in the log.

Credits
- Naturalist by Starfish Studios (Crispytwig): all credit for the mod, its creatures and its content goes to them. This is an unofficial fix, not affiliated with the Naturalist team. If they fix the leak upstream, you won't need this mod anymore.

Naturalist Lag Fix Team

profile avatar
Owner
  • 19
    Projects
  • 1.4K
    Downloads

More from IllamaView all

  • Boss Index project image

    Boss Index

    An in-game boss guide in the pause menu: animated list, 3D preview and tips for each boss.

    • 65
    • October 15, 2026
  • Server Clock HUD project image

    Server Clock HUD

    Server time, day/night progress bar, server day and your days on the server — every element movable with a drag-and-drop editor.

    • 29
    • October 15, 2026
  • Compass HUD project image

    Compass HUD

    A compass bar above your hotbar showing cardinal directions and the heads of tracked players, with distance.

    • 67
    • October 14, 2026
  • Illama Inc project image

    Illama Inc

    A fully French modpack: Create, Mekanism, AE2, magic, 40 bosses, colonies, guided quests and huge exploration. Built for multiplayer, from your first tree to the endgame.

    • 10
    • October 14, 2026
  • Boss Index project image

    Boss Index

    An in-game boss guide in the pause menu: animated list, 3D preview and tips for each boss.

    • 65
    • October 15, 2026
  • Server Clock HUD project image

    Server Clock HUD

    Server time, day/night progress bar, server day and your days on the server — every element movable with a drag-and-drop editor.

    • 29
    • October 15, 2026
  • Compass HUD project image

    Compass HUD

    A compass bar above your hotbar showing cardinal directions and the heads of tracked players, with distance.

    • 67
    • October 14, 2026
  • Illama Inc project image

    Illama Inc

    A fully French modpack: Create, Mekanism, AE2, magic, 40 bosses, colonies, guided quests and huge exploration. Built for multiplayer, from your first tree to the endgame.

    • 10
    • October 14, 2026