Player Warps

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 confirm or 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-limit sets the normal number of warps per player.
• settings.warp-limit-permissions turns permission-based limit tiers on or off.
• settings.name-min-length and settings.name-max-length control warp name length.
• settings.teleport-cooldown-seconds and settings.teleport-warmup-seconds set teleport timing.
• settings.post-teleport-damage-immunity-seconds sets the all-damage protection window. Default: 60 seconds.
• settings.unsafe-confirmation-seconds sets how long the unsafe-spot confirmation remains valid. Default: 30 seconds.
• settings.cancel-warmup-on-move and settings.cancel-warmup-on-damage control warmup cancellation.
• settings.allow-cross-world-warps controls cross-world browsing and visits; settings.blocked-worlds hides and blocks selected worlds.
• settings.economy.enabled and settings.economy.visit-cost enable 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

1. Place PlayerWarps-1.0.2.jar in your server's plugins folder.
2. Restart the server.
3. Adjust plugins/PlayerWarps/config.yml and run /warps reload if needed.

Warp locations and favorites are stored in plugins/PlayerWarps/warps.yml and survive server restarts.