premium banner
Force-load chunks to stay active without players nearby. Crops grow, entities tick, everything runs as if someone is there. Built-in chest clock proves ticking while you're away. Config persists across restarts. OP-only.

Description

GlymeraChunkLoader - Keep Chunks Alive!

Permanently keep chunks loaded and ticking without any player nearby. Survives server restarts.

Don't miss my other exciting projects — take a look at GlymeraCraft's Profile Discord: https://discord.gg/s5NRFWfxgy


What is GlymeraChunkLoader?

GlymeraChunkLoader lets server operators force-load specific chunks so they remain active even when no player is present. Loaded chunks keep ticking — crops grow, redstone fires, entities move, everything behaves as if a player is standing right there.

All configured chunks persist across server restarts via a simple JSON config that can also be edited by hand.


Commands

All commands are OP-only.

Load & Unload

/cl load [radius]  - Force-load the chunk you're standing in (radius 0-16, default 0)
/cl unload         - Release the chunk you're standing in

Radius example: /cl load 3 force-loads a 7x7 area (49 chunks) centered on your position.

Management

/cl list           - List all force-loaded chunks (grouped by world)
/cl status         - Verify which chunks are actually loaded and ticking right now
/cl reload         - Reload config from disk after manual edits

Tick-Test Clock

/cl test           - Mark a nearby chest as a tick-test clock
/cl test off       - Stop the tick-test

Stand next to a chest and run /cl test. The plugin will add 1 Rock_Stone every 60 real seconds to the chest. Walk away, come back later, count the stones — that's how many minutes the chunk was actively ticking in your absence.

  • Chest full? Pauses automatically, resumes when space is freed.
  • Chest destroyed? Test stops automatically.

Config

Located at plugins/GlymeraChunkLoader/config.json. Can be edited manually — use /cl reload to apply changes.

{
  "chunks": [
    {
      "world": "default",
      "x": -56,
      "z": 47
    },
    {
      "world": "plains_1",
      "x": 10,
      "z": -3
    }
  ]
}

Each entry specifies the world name and chunk coordinates (not block coordinates). Chunks from different worlds are fully supported.


How It Works

  • Uses Hytale's native WorldChunk.addKeepLoaded() API (ref-counted, prevents unloading)
  • A maintenance task runs every 5 seconds to ensure all configured chunks stay loaded and ticking
  • Sets the TICKING flag and resets keepAlive / activeTimer to prevent the unload system from evicting chunks
  • Chunks are loaded asynchronously via getChunkReferenceAsync() on first activation
  • All chunk operations run on the world thread for thread safety
  • No fake players, no network overhead — minimal performance impact

Installation

Drop GlymeraChunkLoader-1.0.0.jar into your server's mods/ folder and restart. No asset pack required.


Requirements

  • Hytale Server (any version)
  • OP permissions to use commands