Wiki /
Configuration
v1.0.0 MIT
Configuration Reference
Full config.yml with every available option.
safety
| Key | Type | Default | Description |
|---|
| deny_water | boolean | true | Block teleport into water |
| deny_lava | boolean | true | Block teleport into lava |
| deny_air | boolean | true | Block teleport mid-air |
| deny_cave | boolean | true | Block teleport underground |
| deny_materials | list | FIRE… | Extra unsafe block types |
| max_tries | int | 25 | Max location search attempts |
| min_y | int | 62 | Minimum Y coordinate |
| max_y | int | -1 | Maximum Y (-1 = no limit) |
delay
| Key | Type | Default | Description |
|---|
| enabled | boolean | true | Enable pre-teleport countdown |
| seconds | int | 5 | Countdown duration in seconds |
| cancel_on_move | boolean | true | Cancel if player moves |
| cancel_on_damage | boolean | true | Cancel if player takes damage |
| countdown_channel | string | ACTION_BAR | ACTION_BAR / CHAT / BOTH / TITLE |
| countdown_message | string | …stand still! | Message with {time} placeholder |
| cancelled_message | string | Cancelled! | Shown on cancel |
| cancelled_channel | string | ACTION_BAR | ACTION_BAR / CHAT |
wait_effect
| Key | Type | Default | Description |
|---|
| enabled | boolean | true | Show particles while waiting |
| particle | string | PORTAL | Particle type (Bukkit enum) |
| particle_count | int | 10 | Particles per second |
| sound_enabled | boolean | true | Play sound each second |
| sound | string | BLOCK_NOTE_BLOCK_PLING | Sound name (Bukkit enum) |
| volume | double | 1.0 | Sound volume |
| pitch | double | 1.0 | Sound pitch |
cooldown
| Key | Type | Default | Description |
|---|
| seconds | int | 30 | Cooldown after successful TP (0 = off) |
| message_channel | string | CHAT | ACTION_BAR or CHAT |
| show_countdown_bar | boolean | false | Live countdown in action bar |
rtp_queue
| Key | Type | Default | Description |
|---|
| enabled | boolean | true | Enable queue system |
| process_interval_ticks | int | 10 | Ticks between each queue process |
| max_queue_size | int | 20 | Max players in queue (0 = unlimited) |
| notify_interval_ticks | int | 60 | Ticks between position reminders (0 = off) |
teleport_effects
| Key | Type | Default | Description |
|---|
| sound_on_teleport | string | ENTITY_ENDERMAN_TELEPORT | Sound on success |
| sound_volume | double | 1.0 | Volume |
| sound_pitch | double | 1.0 | Pitch |
| particle_on_teleport | string | PORTAL | Particle on success |
| particle_count | int | 30 | Particle count |
| title | string | &6&lTeleported! | Screen title (empty = off) |
| subtitle | string | …new location. | Screen subtitle |
| title_fade_in | int | 10 | Ticks |
| title_stay | int | 40 | Ticks |
| title_fade_out | int | 10 | Ticks |