Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
Platforms
Links
Tags
Creators
Details
Licensed ARR
Published last month
Updated last month
Description
Let players make places worth visiting. PlayerWarps adds a browsable warp menu with favorites, search, configurable limits, and a confirmation before sending someone to an unsafe landing spot.
✦ What it does
- Browse player warps in a paginated inventory menu.
- Favorite warps and search by warp name or owner.
- Set warps with an optional description; warp data and favorites persist through restarts.
- Set per-player warp limits, with permission tiers for extra slots.
- Add a teleport warmup and cooldown, with optional cancellation when the player moves or takes damage.
- Grant configurable post-teleport immunity from all damage, including PvP and environmental damage.
- Check for a solid floor, clear space, trapdoors, and common hazards. Unsafe spots require
/warps confirmor can be cancelled with/warps cancel. - Optionally charge visitors through Vault and an economy provider.
Commands
| Command | What it does |
|---|---|
/warps |
Open the warp browser. |
/warps set <name> [description] |
Create a warp where you are standing. |
/warps delete <name> |
Delete one of your warps. |
/warps favorite <name> |
Toggle a warp as a favorite. |
/warps visit <name> |
Start a direct warp teleport. |
/warps search |
Search warps by name or owner in chat. |
/warps confirm |
Accept an unsafe landing warning. |
/warps cancel |
Cancel an unsafe landing confirmation. |
/warps reload |
Reload config.yml (admin permission). |
Aliases: /pwarp, /playerwarp.
Permissions
| Permission | Default | Purpose |
|---|---|---|
playerwarps.use |
Everyone | Browse warps and teleport. |
playerwarps.create |
Everyone | Create warps. |
playerwarps.delete.own |
Everyone | Delete your own warps. |
playerwarps.delete.others |
Operators | Delete any player's warp. |
playerwarps.admin |
Operators | Reload config and bypass warp limits and teleport cooldowns. |
playerwarps.limit.<number> |
Not granted by default | Increase a player's limit, for example playerwarps.limit.10. Highest matching tier up to 100 applies. |
Config guide
Edit plugins/PlayerWarps/config.yml, then run /warps reload.
settings.default-warp-limitsets the normal number of warps per player.settings.warp-limit-permissionsturns permission-based limit tiers on or off.settings.name-min-lengthandsettings.name-max-lengthcontrol warp name length.settings.teleport-cooldown-secondsandsettings.teleport-warmup-secondsset teleport timing.settings.post-teleport-damage-immunity-secondssets the all-damage protection window. Default: 60 seconds.settings.unsafe-confirmation-secondssets how long the unsafe-spot confirmation remains valid. Default: 30 seconds.settings.cancel-warmup-on-moveandsettings.cancel-warmup-on-damagecontrol warmup cancellation.settings.allow-cross-world-warpscontrols cross-world browsing and visits;settings.blocked-worldshides and blocks selected worlds.settings.economy.enabledandsettings.economy.visit-costenable optional paid visits. This requires Vault and an economy plugin.gui.*controls the menu title, rows, slots, filler, warp item, and lore. Use%warp%,%owner%,%world%,%x%,%y%,%z%,%visits%, and%description%placeholders in the item text.messages.*lets you customize the plugin's chat messages and prefix.
Compatibility
Built against Spigot API 1.13.2 with Java 8 bytecode and an api-version of 1.13. Intended for Paper 1.13.2 and newer. Paper 26.3 has not yet been runtime-tested for this release. Vault is only needed if paid warp visits are enabled.
Install
- Place
PlayerWarps-1.0.2.jarin your server'spluginsfolder. - Restart the server.
- Adjust
plugins/PlayerWarps/config.ymland run/warps reloadif needed.
Warp locations and favorites are stored in plugins/PlayerWarps/warps.yml and survive server restarts.



