SimpleTP

Homes, warps, TPA, /back, /rtp and spawn, with clean inventory menus. Every setting lives in one commented config.yml.

SimpleTP is a lightweight teleport plugin for Paper servers that want everything an essentials-style teleport system offers, without the bloat. It runs fully async, migrates its own data, and lets you switch off or re-shape any part of it.

Features

Homes

• Paginated homes menu: left-click to teleport, right-click to rename, change icon, move or delete (with confirmation)
• Home limits by permission: simpletp.homes.10, named groups (simpletp.homes.vip) or unlimited
• /home without a name goes to your default or only home

Warps

• Warps menu with categories (Shops, Events, ...), configurable icons and descriptions
• Admins edit warps in-game: icon (pick one or use the item in hand), category, description, permission, location
• Optional per-warp permissions

TPA

• /tpa, /tpahere, /tpaall and clickable [Accept] [Deny] buttons in chat
• Player picker menu with heads, plus an incoming-requests menu with accept, deny, accept all and deny all
• Multiple incoming requests, request timeout, /tpatoggle
• Personal settings: receive requests, auto-deny, sounds

Teleporting

• Warmup with an action bar countdown that cancels when you move or take damage
• Per-command cooldowns and costs (Vault, optional)
• Safe teleport: never lands players in lava, the void or inside blocks, and finds the nearest safe spot instead
• /back to your previous location and death location
• /rtp with per-world radius, world border awareness and safe-spot search (nether supported)
• /spawn, first-join spawn, respawn at spawn without a bed
• Per-world rules: for example no homes in the nether, or no teleporting into an event world

Fully configurable

• Every command can be enabled or disabled, re-permissioned and aliased. Disabled commands disappear from the menus automatically.
• Toggle every system: GUI, warmup, cooldowns, /back, RTP, economy, sounds, particles, TPA timeout, safe teleport, world rules
• Sounds and particles per action (or none)
• GUI layouts: titles, sizes, slots, materials, custom model data (resource packs), filler, visible buttons
• Languages: every text is in a language file with MiniMessage support. Add your own language or let players see their client language.
• /simpletp reload applies changes live. Bad values never crash the plugin: they fall back to defaults with a clear warning.
• The config updates itself on upgrades and keeps your values and comments.

Solid under the hood

• Async database: H2 built in, or MySQL/MariaDB for networks, with HikariCP
• Menus are protected against shift-click, drag, number-key and double-click exploits
• Folia compatible scheduling
• Automatic migration from SimpleTP 1.x, with backups made first

Supported versions

Requirements

• Paper 1.21.4 or newer (or a Paper fork)
• Java 21 or newer
• Optional: Vault and an economy plugin for teleport costs

Commands

Permissions

Every command's permission node can be changed in config.yml.

Upgrading from 1.x

Replace the jar and restart. Homes, config values and custom messages are carried over automatically, and backups are written to plugins/SimpleTP/backups/.

Changelog - 2.0.0

New

• GUI menus: main, homes, warps with categories, TPA player picker, incoming requests, settings
• Warps, /back (including death location), /rtp, /spawn, /tpaall, /tpsettings, /tpmenu
• Cooldowns, Vault costs, safe teleport, per-world rules, particles, MySQL support, multiple languages
• Every command and feature can be toggled, re-permissioned and aliased
• Live reload with validation, self-updating config

Fixed

• A duplicate tpa: section in messages.yml hid the TPA messages
• A second TPA request overwrote the first one
• Home names could inject chat formatting
• /tpatoggle was reset on restart

Changed

• Async HikariCP database layer, Folia-compatible scheduling, no deprecated API usage