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

Aliases: /pwarp, /playerwarp.

Permissions

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.