Skip to content

Config yml

Leaf26 edited this page Jun 17, 2026 · 1 revision

Core settings that don't fit a more specific file live in config.yml. Edit on disk and /rtp reload, or change a key at runtime with /rtp config config <key>=<value>.

Locale selection lives in language.yml (loaded before config.yml), not here.

Teleportation

Key Default Purpose
teleportDelay 2 Seconds to wait before a queued teleport executes. 0 teleports immediately and skips the cancel-on-move window.
cancelDistance 2 Max blocks a player may move during teleportDelay before the teleport is cancelled.
teleportCooldown 300 Seconds between successful /rtp uses by the same player. Bypassed by rtp.nocooldown.
lockAfterUses 0 Max successful uses within the lockAfterResetSeconds window before lockout. 0 disables. Bypassed by rtp.nolock.
lockAfterResetSeconds 0 Length of the rolling usage-cap window. 0 makes the cap a hard lifetime cap that never resets.
setRespawnOnTeleport false When true, a successful /rtp sets the landed location as the player's persistent spawn anchor.

Post-teleport commands

Commands run after a successful teleport. Use [player] for the target's name; empty entries are ignored.

  • consoleCommands - executed by the server console.
  • playerCommands - executed as the player.

Database

Nested under database:. Stores cached locations and player data.

Key Default Purpose
type sqlite Backend: yaml, sqlite, mysql, or postgresql. yaml/sqlite are file-backed and need no extra config.
host / port / name / username / password 127.0.0.1 / 3306 / rtp / root / password Used by mysql/postgresql only.

No JDBC driver is shaded into the jar. To use sqlite/mysql/postgresql, drop the matching driver jar onto the server classpath; otherwise RTP falls back toward yaml and logs a WARNING. The Fabric build supports flat-file (yaml) only.

Network (Redis)

Nested under network.redis:. Enables the Redis-backed shared state for multi-server sync.

Key Default Purpose
enabled false Enable the Redis-backed network state binding.
host / port / password 127.0.0.1 / 6379 / "" Redis connection. Empty password disables auth.

Full multi-server "network mode" (transports, routing, wait queue, reservation tokens) is configured separately in network.yml.

Menu

Nested under menu:.

Key Default Purpose
renderer [ book ] Ordered preference list of menu renderer ids (book, chat). The framework falls back to the next entry on a missing adapter or exception.

version is an internal config version - do not change it.

Clone this wiki locally