Random Teleport (RTP)

RandomTeleport

RandomTeleport is a random-teleportation plugin: multiple zones, biome filtering, a warmup with countdown, smart safety checks, a pre-generated point pool with a binary index, a disk budget, optional region protection and economy, and full multilingual support. No hard dependencies; works on Bukkit, Spigot, Paper, Purpur and Folia from 1.12.2 to 26.x (Java 8+).

Features

• Zones - rectangle or circle, per-world, per-zone overrides, world-border validation.
• Instant teleports - a pool of ready points + an index of existing chunks.
• Background refill - on-demand, idle or both, with TTL, spread and per-zone limits.
• Smart search - parallel candidates, biome prefilter; async chunks on Paper/Folia, bounded sync generation on Spigot (no Watchdog).
• Warmup - title/actionbar, cancel on move/damage, ignored causes.
• After teleport - freeze and invulnerability until chunks are ready, preload queue, skip points near players.
• Protection - WorldGuard 6/7, GriefPrevention, Towny, Residence, Lands.
• Economy - optional Vault.
• Disk budget - free-space/weight/reserve limits, chunk registry.
• /rtpstats - pools, index, disk, searches, queue, protection providers (active + installed).
• Languages - EN/RU included, custom lang_XX.json, auto-detect.

Requirements and installation

• Java 8+; Bukkit/Spigot/Paper/Purpur 1.12.2–26.x, Folia 1.19.4+.
• Optional: Vault + economy, WorldGuard, GriefPrevention, Towny, Residence, Lands.

Commands

Players

Administrators

Aliases: /rtp - randomtp, wild; /centre - center; /rtpzone - zone, tpzone; /rtpbiome - biome; /rtpreload - rtprl; /rtpstats - rtpinfo.

Permissions

Configuration

Zones live in zones; any zone-defaults key can be overridden as zones.<name>.<path>:

zones:
  default:
    center: { x: 0, z: 0 }
    radius: { x: 10000, z: 10000 }
    worlds: [world]
  nether:
    center: { x: 0, z: 0 }
    radius: { x: 1000, z: 1000 }
    worlds: [world_nether]

Languages

Create plugins/RandomTeleport/languages/lang_XX.json from lang_en.json, translate values, keep keys unchanged; restart or /rtpreload. Players use /lang XX; console sets the default language. auto-detect-language: true uses the client language on first login.

Notes

• Spigot: synchronous chunk generation is bounded by count, delay and sync-generation-budget-ms; lower the budget on weak hardware.
• Folia: supported; the pool may fill slower in idle because of region scheduling.
• Nether: worlds.world_nether.max-height: 125 keeps points off the roof; set min-height there if you need points below the global 60.
• Ocean-only zone: the pool may stay empty with avoid-water: true; shrink/move the zone or relax safety-checks.