Citadel Chunkloader

Citadel Chunkloading

A lightweight, command-driven chunkloader for Citadel. Define force-loaded regions by exact block coordinates or straight from your WorldEdit selection, manage overlaps safely, and keep everything persistent across restarts.

Features

• Coordinate-based loaders — define a rectangular chunkload region using precise block coordinates.
• WorldEdit integration — instantly turn your active //pos1 / //pos2 selection into a loader, no manual coordinate entry needed.
• Two loading modes:   – always — chunks stay loaded regardless of who’s online.   – online — chunks stay loaded only while the owner/relevant player is online.
• Overlap protection — creating a loader that overlaps an existing one triggers a warning instead of silently conflicting, with full control over how to resolve it.
• Persistent storage — loader data is saved to disk and can be reloaded on demand without a server restart.
• Full management commands — list, inspect, and remove loaders at any time.
• Universal Mod: Works on both multiplayer and survival

Commands

• /chunkload <x1> <z1> <x2> <z2> <type> — Create a loader over a block-coordinate rectangle. type is always or online.
• /chunkload worldedit <type> — Create a loader from your active //pos1 / //pos2 WorldEdit selection.
• /chunkload confirm (after an overlap warning) — Create the new loader anyway, allowing overlap.
• /chunkload overwrite (after an overlap warning) — Delete the conflicting loader(s) and replace them with the new one.
• /chunkload expand (after an overlap warning, only if exactly one loader overlaps) — Merge the new selection into the existing loader.
• /chunkload cancel (after an overlap warning) — Discard the pending creation.
• /chunkload remove <id> — Delete a loader by its ID.
• /chunkload list — List every registered loader with its ID, type, dimension, and chunk range.
• /chunkload info <id> — Show full details on a specific loader.
• /chunkload reload — Re-read chunkloader.dat from disk and re-apply force-load state.

WorldEdit Compatibility

Citadel Chunkloading hooks directly into your active WorldEdit selection — just make a //pos1 and //pos2 selection as normal, then run /chunkload worldedit to instantly convert that region into a chunk loader. No need to manually calculate or re-enter coordinates.

Overlap Handling

When a new loader would overlap an existing one, the mod stops and warns you before making any changes. From there you choose how to proceed:

• confirm to allow the overlap anyway
• overwrite to replace the conflicting loader(s)
• expand to merge into a single existing overlapping loader
• cancel to back out entirely

This prevents accidental double-loading of the same chunks and gives admins full control over how conflicts are resolved.

Requirements

• Will Require Citadel Core
• WorldEdit-based commands require WorldEdit (or a compatible fork) installed