GlymeraChunkLoader

GlymeraChunkLoader - Keep Chunks Alive!

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

---

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.

---

The Chunk Loader Block (v4)

Want your players to keep chunks loaded — without giving them commands? Place the Chunk Loader block: a little clock on a stone base with a status lamp on top.

• One click = active: the lamp turns green and the chunk the block stands in stays loaded and ticking. Click again: lamp turns red, the chunk unloads normally.
• No crafting recipe on purpose — hand it out with /cl give <player> or sell it in your server store / economy plugin (item id: Glymera_Chunk_Loader).
• Owner-protected: only the placer (or an OP) can toggle or break it. Breaking it always returns the item.
• Per-player limit: maxLoadersPerPlayer in the config (default 3, -1 = unlimited).
• Restart-safe: placed loaders and their on/off state survive restarts.
• Fits its shape: collision and aiming outline match the actual clock model (half a block wide, ~3/4 high) — no invisible full-block box around it.

---

Commands

All commands are OP-only (regular players just use the block).

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