Ultimate Warps

Advanced warp management plugin
_{Stunning GUIs • Immersive Teleports • Player Warps • LuckPerms Integration • Full Customization}

Key Features

Animated Teleport Effects — Smooth countdown BossBars, particles, sounds, and customizable title messages for every spawn, server warp, and player warp.
Modern GUIs — Clean player and admin menus with custom icons, player heads, pinned or auto slots, filler items, and easy navigation.
In-Game Admin Warp Editor — Edit warp icons, display names, lore descriptions, GUI slots, permissions, cooldowns, delays, particles, and sounds directly from /warpsadmin.
Complete Player Warps System — Let players create, customize, and manage their own warps completely separate from admin warps, with their own config (playerwarps-config.yml) and GUI (playerwarps-gui.yml).
Advanced MiniMessage Support — Use gradients, hex colors, hover text, click actions, bold, italic, and more in every message.
LuckPerms Integration — Automatically detects player ranks and applies custom cooldown or delay multipliers from config.
Fully Configurable — Editable YAML files, independent feature toggles, customizable messages, and a unified /uwarps command with tab completion.

Required Dependency: LuckPerms Optional Integrations: PlaceholderAPI and any economy plugin (for paid player warps), GriefPrevention & WorldGuard (for claim/region warp creation checks)

Player Warps Features

Browser & In-Game Warp Editor GUIs — Players can browse all warps in a paginated GUI and edit their own warp's display name, lore description, and custom icon (by dragging and dropping an item) from /pwarps edit.
Public & Private Visibility — Warp owners can toggle their warps between public (visible to everyone in the browser) and private (accessible only to the owner and staff).
Safe Warp Detection — Checks nearby blocks at the warp position (solid ground below and at least 2 blocks of air above) during warp creation and teleportation, cancelling the teleport if unsafe.
Warps Rating — Sends a clickable chat prompt after visiting a warp so players can rate it (1–5 stars) in a GUI. The rating is shown on the first line of the warp lore (Not rated yet when unrated).
Money Requirement (Paid Warps) — Players with permission can enable a teleport cost on their warp via the Edit GUI or /pwarps cost. Uses PlaceholderAPI (%vault_eco_balance%) to check visitor balance and runs configurable give/take economy commands.
Whitelist & Blacklist — Warp owners can toggle whitelist mode and manage whitelisted and blacklisted players through separate GUIs or commands. The blacklist blocks players even when whitelist mode is off.
Favourite Warps — Players can right-click warps in /pwarps to add or remove them from their favourites list and filter them using the Favourite button.

Commands

Server Warps

Command	Description
`/spawn`	Teleport to spawn
`/setspawn`	Set spawn location
`/delspawn`	Delete spawn location
`/spawnforce <player>`	(Admin) Force teleport a player to spawn
`/warp` , `/warps` , `/warplist`	Open warp GUI
`/warp <name>`	Teleport directly to a warp
`/setwarp <name>`	Create a new warp at your location
`/delwarp <name>`	Delete a warp
`/warpsadmin`	Open admin management GUI
`/ultimatewarps reload` , `/uwarps reload`	Reload config & warps
`/uwarps help`	Unified Sub-Commands

Player Warps

Command	Description
`/playerwarps` , `/pwarps`	Open the player warps browser GUI
`/pwarps set <name>`	Create a player warp at your location
`/pwarps del <name>`	Delete one of your own player warps
`/pwarps edit <name>`	Open the edit menu for one of your own player warps
`/pwarps list [player]`	List your own warps, or another player's public warps
`/pwarps warp <name>`	Teleport to one of your own player warps
`/pwarps warp <owner> <name>`	Teleport to another player's public warp
`/pwarps rate [owner] <warp> [1-5]`	Rate a warp (1–5 stars) after visiting it
`/pwarps cost <warp> <amount/on/off/toggle>`	Set teleport cost or toggle money requirement on your warp
`/pwarps whitelist <warp> [gui/on/off/toggle/add/remove/list] [player]`	Manage your warp's whitelist or open the Whitelist GUI
`/pwarps blacklist <warp> [gui/add/remove/list] [player]`	Manage your warp's blacklist or open the Blacklist GUI
`/pwarps favourite [owner] [warp]`	View favourite warps in GUI or add/remove a favourite warp
`/pwarps admin info <player>`	(staff) See a player's warp count and limit
`/pwarps admin wipe <player>`	(staff) Delete every warp a player owns
`/pwarps admin tp <owner> <name>`	(staff) Teleport to any warp, regardless of visibility

Permissions

Server Warps

Permission	Default
`ultimatewarps.admin`	`op`
`ultimatewarps.spawn`	`true`
`ultimatewarps.warp.*`	`false`
`ultimatewarps.warp.<name>`	`true`
`ultimatewarps.bypass.cooldown`	`false`
`ultimatewarps.bypass.delay`	`false`
`ultimatewarps.rank.vip`	`false`
`ultimatewarps.rank.mvp`	`false`

Player Warps

Permission	Default	Description
`ultimatewarps.playerwarps.create`	`false`	Allows creating player warps with `/pwarps set`
`ultimatewarps.playerwarps.browse`	`true`	Allows browsing the GUI and visiting public player warps
`ultimatewarps.playerwarps.money`	`false`	Allows enabling money requirement and setting a cost on owned warps
`ultimatewarps.playerwarps.admin`	`op`	Staff oversight — view/wipe any player's warps, bypass visibility, cost, and lists
`ultimatewarps.playerwarps.limit.<number>`	`false`	Allows `<number>` of player warp creation for a player
`ultimatewarps.playerwarps.limit.unlimited`	`false`	Removes the player warp limit entirely

Limit permissions don't stack — the highest number overwrites the lower. Players with none of these fall back to default-limit in playerwarps-config.yml. create defaults to false for server owners to choose which groups or players have the permission to set player warps.

Configuration Files

config.yml (Server Warps & Spawn)

#==============================================================================================
#    __  ______  _            __        _      __                
#   / / / / / /_(_)_ _  ___ _/ /____   | | /| / /__ ________  ___
#  / /_/ / / __/ /  ' \/ _ `/ __/ -_)  | |/ |/ / _ `/ __/ _ \/_-<
#  \____/_/\__/_/_/_/_/\_,_/\__/\__/   |__/|__/\_,_/_/ / .__/___/
#                                                      /_/         
#  UltimateWarps - v4.0 by King_Le0_ | Join Discord: [https://discord.gg/r4gRhda8Mw]
#==============================================================================================

settings:
  teleport-cancel-on-move: true
  teleport-cancel-on-damage: true

spawn:
  enabled: true
  cancel-on-move: true
  cooldown: 10
  delay: 5
  title:
    enabled: true
    message: "<b><gradient:#FF0000:#9400FF>ᴛᴇʟᴇᴘᴏʀᴛɪɴɢ ᴛᴏ sᴘᴀᴡɴ</gradient></b>"
    subtitle: "<b><gradient:#5000FF:#9400FF>ᴘʟᴇᴀsᴇ ᴡᴀɪᴛ <white>%seconds%</white> sᴇᴄᴏɴᴅs</gradient></b>"
  bossbar:
    enabled: true
    color: PURPLE
    style: SOLID
    text: "<b><gradient:#5000FF:#00B3FF>ᴛᴇʟᴇᴘᴏʀᴛɪɴɢ...</gradient></b>"
  particle:
    enabled: true
    type: DUST
    count: 30
    dust:
      color: "#FF0000"
      size: 1.0
  sound:
    enabled: true
    type: BLOCK_NOTE_BLOCK_PLING
    volume: 1.0
    pitch: 1.0
  teleport-on-every-join:
    enabled: false
    message: "<gradient:#5000FF:#00aa00>ᴡᴇʟᴄᴏᴍᴇ ʙᴀᴄᴋ! ʏᴏᴜ ʜᴀᴠᴇ ʙᴇᴇɴ ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ ᴛᴏ sᴘᴀᴡɴ.</gradient>"
  teleport-on-first-join:
    enabled: true
    message: "<gradient:#5000FF:#00aa00>ᴡᴇʟᴄᴏᴍᴇ ᴛᴏ ᴛʜᴇ sᴇʀᴠᴇʀ! ʏᴏᴜ ʜᴀᴠᴇ ʙᴇᴇɴ ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ ᴛᴏ sᴘᴀᴡɴ.</gradient>"

warp:
  enabled: true
  cancel-on-move: true
  cooldown: 5
  delay: 3
  title:
    enabled: true
    message: "<gradient:#00DCFF:#0036FF><b>ᴛᴇʟᴇᴘᴏʀᴛɪɴɢ ᴛᴏ</b> <white>%warp%</white></gradient>"
    subtitle: "<gradient:#4547FF:#A4B7FE><b>ᴘʟᴇᴀsᴇ ᴡᴀɪᴛ</b><white> %seconds% </white><b>sᴇᴄᴏɴᴅs</b></gradient>"
  bossbar:
    enabled: true
    color: BLUE
    style: SOLID
    text: "<b><gradient:#4547FF:#00DCFF>ᴛᴇʟᴇᴘᴏʀᴛɪɴɢ ᴛᴏ %warp%</gradient></b>"
  particle:
    enabled: true
    type: DUST
    count: 30
    dust:
      color: "#5555FF"
      size: 1.0
  sound:
    enabled: true
    type: BLOCK_NOTE_BLOCK_PLING
    volume: 1.0
    pitch: 1.0

rank-multipliers:
  default:
    cooldown: 1.0
    delay: 1.0
  vip:
    cooldown: 0.5
    delay: 0.5
  mvp:
    cooldown: 0.5
    delay: 0.5

playerwarps-config.yml (Player Warps)

enabled: true
default-limit: 1

# 1. Safe Warp Place Detection
safe-warp:
  enabled: true
  check-on-create: true
  check-on-teleport: true

# 2. Warps Rating
rating:
  enabled: true
  rated-lore-format: "&7ʀᴀᴛɪɴɢ: &e{stars} &f({average}/5) &7({count})"
  unrated-lore: "&7Not rated yet"

# 3. Money Require (Teleport Cost)
money-require:
  enabled: true
  permission: "ultimatewarps.playerwarps.money"
  balance-placeholder: "%vault_eco_balance%"
  give-command: "/eco give %warpowner% %amount%"
  take-command: "/eco take %visitor% %amount%"

# 4. Whitelist & Blacklist
whitelist:
  enabled: true
blacklist:
  enabled: true

# 5. Favourite Warps
favourites:
  enabled: true

# Placement Restrictions
location-requirements:
  require-own-claim: false
  require-outside-worldguard-region: false
  overworld-only: false
  min-distance-from-spawn: 0
  min-distance-from-other-playerwarps: 0

Support

Join Discord Server for help or updates:

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Key Features

Player Warps Features

Commands

Server Warps

Player Warps

Permissions

Server Warps

Player Warps

Configuration Files

Support