Configuration

Configuration

The config file is located at plugins/ChunkTicker/config.yml. It is created automatically on first startup with default values.

To apply changes without restarting the server, use /ct reload.

---

Full default config

# ============================================================
#  ChunkTicker – Konfiguration
# ============================================================

# Whether ChunkTicker is globally active.
# false = no tickets are set, but the chunk list is preserved.
global-enabled: true

# Ticket mode: plugin | forced | both (recommended)
#   plugin  → addPluginChunkTicket()  (TicketType.PLUGIN,  Level 31)
#   forced  → setChunkForceLoaded()   (TicketType.FORCED,  Level 31)
#   both    → both tickets applied - most reliable for mob farms
ticket-mode: both

# Managed automatically - only edit while the server is stopped
chunks: []

---

Option reference

global-enabled

Type	boolean
Default	true
Command	/ct on / /ct off

Controls whether ChunkTicker is active at all. When false, no chunk tickets are applied and existing tickets are removed. The chunks list is not affected - switching back to true (or running /ct on) restores all tickets.

This value is automatically updated when you run /ct on or /ct off.

---

ticket-mode

Type	string
Default	both
Options	plugin, forced, both

Determines which type of chunk ticket is applied. See the Ticket Modes page for a full explanation. The recommended value is both.

---

chunks

Type	list
Default	[] (empty)

The list of registered chunks. Each entry contains the world name and chunk coordinates (X, Z in chunk space, not block space).

Example:

chunks:
  - world: world
    x: 0
    z: 0
  - world: world
    x: 1
    z: 0
  - world: world_nether
    x: -5
    z: 12

⚠️ Only edit this list while the server is stopped. If you edit it while the server is running, use /ct reload afterwards to apply the changes. Invalid entries (missing world, missing coordinates) are silently skipped on load.

---

Manually adding chunks

If you know the chunk coordinates you want to add, you can add them directly to config.yml while the server is stopped:

1. Stop the server
2. Open plugins/ChunkTicker/config.yml
3. Add entries under chunks:
4. Start the server

To find chunk coordinates from block coordinates: chunk X = floor(block X / 16), chunk Z = floor(block Z / 16).