Wiki / Safety System v1.0.0 MIT

Safety System

PracRTP performs multiple checks before confirming a teleport destination to ensure the player always lands somewhere safe.

Built-in Checks

CheckConfig KeyDefault
Watersafety.deny_watertrue
Lavasafety.deny_lavatrue
Mid-air (void/air)safety.deny_airtrue
Underground / Cavesafety.deny_cavetrue
Custom materialssafety.deny_materialsFIRE, MAGMA_BLOCK, CACTUS…
Minimum Y levelsafety.min_y62
Maximum Y levelsafety.max_y-1 (no limit)

Custom Material Blacklist

Add any Bukkit Material name to deny_materials:

yaml
safety:
  deny_materials:
    - FIRE
    - MAGMA_BLOCK
    - CACTUS
    - SWEET_BERRY_BUSH
    - POWDER_SNOW

How Cave Detection Works

After finding the highest block at a random X/Z coordinate, the plugin scans upward to the world ceiling. If any solid block exists above that point, the location is considered underground and is rejected.

⚠️ Increase max_tries if your world has heavy terrain generation and players often see "Could not find a safe location".

Player Distance Check

KeyDescription
distance_from_players.enabledEnable / disable check
distance_from_players.min_distanceMinimum blocks from any online player
distance_from_players.min_distance_from_spawnMinimum blocks from world spawn (0 = off)