PlaceholderAPI

RTP registers a PlaceholderAPI expansion under the identifier rtp, so every placeholder below is used as %rtp_<key>% in any PlaceholderAPI-aware plugin (scoreboards, holograms, tab lists, chat).

The same keys also resolve inside RTP's own messages.yml as [key] (square brackets), so you can drop them into RTP's messages without PlaceholderAPI installed.

Note PlaceholderAPI is an optional soft dependency - it is only needed to expose these values to other plugins. The [key] form inside messages.yml works regardless.

Values are resolved for the requesting player and reflect the region context relevant to them (their current/last region). A key with no value resolves to an empty string.

Region information

Key	Resolves to
world	The region's target world.
name	The region's identity name.
region	The active region name.
displayName	The region's cosmetic display name (falls back to the region name).
shape	The region's shape (e.g. CIRCLE, POLYGON).
requirePermission	Whether the region requires rtp.regions.<name>.
override	The region's no-permission redirect target.
worldBorderOverride	Whether the region honors the vanilla world border.
pluginForced	Whether a plugin forced the region.
serverForced	Whether the server forced the region.

Cache and queue depth

Key	Resolves to
cacheCap	Configured max pre-calculated locations for the region.
cached	Total currently cached locations.
keptCache	Locations whose chunks are kept loaded (hot/ready-to-serve).
unkeptCache	Verified locations whose chunks were released (warm).
backlogCache	Unverified backlog buffer depth.
backlogCacheCap	Configured backlog buffer capacity.
locationQueue	Number of players waiting on a coordinate.
inFlightCalculations	Location calculations currently in progress.

Pipeline diagnostics

Key	Resolves to
pipelineMsP50	Teleport-pipeline latency, 50th percentile (ms).
pipelineMsP75	Pipeline latency, 75th percentile (ms).
pipelineMsP90	Pipeline latency, 90th percentile (ms).
pipelineMsP95	Pipeline latency, 95th percentile (ms).
pipelineMsP99	Pipeline latency, 99th percentile (ms).
pipelineSampleCount	Number of latency samples in the current window.
slowPipelineCount	Count of pipeline runs over the slow threshold.
slowPipelineThresholdMs	The slow-pipeline threshold (ms).
queueGrowthWarnCount	How many times queue growth tripped the warning.
queueGrowthWarnThreshold	The queue-growth warning threshold.

Spatial memory

Key	Resolves to
memCoveragePct	Percentage of the region mapped by spatial memory.
memBadPct	Percentage of mapped area marked unsafe.
memBadCount	Count of known-bad cells.
memTopCause	Most common rejection cause (biome, unsafe block, claim, ...).
memTopCausePct	Share of rejections attributable to memTopCause.

Example

# In a scoreboard / tab plugin:
%rtp_region%  ->  default
%rtp_cached%  ->  37

# In RTP's own messages.yml:
queueDepth: "&aReady locations for [region]: [keptCache]"

See also: Messages, Diagnostics, Scan and Spatial Memory.