Ultimate Warps

Advanced warp management plugin for Paper 1.21.x
_{Stunning GUIs • Immersive Teleports • LuckPerms Integration • Full Customization}

---

---

Key Features

• Animated Teleport Effects — Smooth countdown BossBars, particles, sounds, and customizable title messages for every spawn and warp.
• Modern Paginated GUIs — Clean player and admin menus with custom icons, player heads, filler items, and easy navigation.
• Player Warps — Let players create, manage, and share their own warps, completely separate from admin warps. Public or private visibility, custom icons/names, per-rank warp limits, optional placement restrictions (claim/region/world/distance), and the same fully animated teleport effects as admin warps.
• 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.
• Per-Warp Customization — Set unique permissions, icons, names, cooldowns, and teleport delays for each warp.
• Fully Configurable — Editable YAML files, customizable messages, modular settings, and a unified /uwarps command with tab completion.

---

Installation

1. Download the latest .jar file
2. Place it in your server's plugins/ folder
3. Restart the server
4. Edit plugins/UltimateWarps/config.yml to your liking

Soft-dependency: LuckPerms (optional — required for rank-based cooldown/delay multipliers)

---

Commands

Server Warps

Command	Description
/spawn	Teleport to spawn
/setspawn	Set spawn location
/delspawn	Delete spawn location
/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 spawn , /uwarps help , …	Unified sub-commands

Player Warps

Command	Description
/playerwarps , /pwarps	Open the player warps browser GUI
/playerwarps set <name>	Create a player warp at your location
/playerwarps del <name>	Delete one of your own player warps
/playerwarps edit <name>	Open the edit menu for one of your own player warps
/playerwarps list [player]	List your own warps, or another player's public warps
/playerwarps warp <name>	Teleport to one of your own player warps
/playerwarps warp <owner> <name>	Teleport to another player's public warp
/playerwarps admin info <player>	(staff) See a player's warp count and limit
/playerwarps admin wipe <player>	(staff) Delete every warp a player owns
/playerwarps 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.*	true
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 /playerwarps set
ultimatewarps.playerwarps.browse	true	Allows browsing the GUI and visiting public player warps
ultimatewarps.playerwarps.admin	op	Staff oversight — view/wipe any player's warps, teleport regardless of visibility
ultimatewarps.playerwarps.limit.1	false	Allows 1 player warp
ultimatewarps.playerwarps.limit.3	false	Allows 3 player warps
ultimatewarps.playerwarps.limit.5	false	Allows 5 player warps
ultimatewarps.playerwarps.limit.10	false	Allows 10 player warps
ultimatewarps.playerwarps.limit.unlimited	false	Removes the player warp limit entirely

Limit permissions don't stack — the highest number a player holds wins. Players with none of these fall back to default-limit in playerwarps-config.yml. create defaults to false so upgrading server owners can choose which groups get to plant player warps.

---

Configuration File

📁 config.yml (main settings)

#==============================================================================================
#    __  ______  _            __        _      __                
#   / / / / / /_(_)_ _  ___ _/ /____   | | /| / /__ ________  ___
#  / /_/ / / __/ /  ' \/ _ `/ __/ -_)  | |/ |/ / _ `/ __/ _ \/_-<
#  \____/_/\__/_/_/_/_/\_,_/\__/\__/   |__/|__/\_,_/_/ / .__/___/
#                                                      /_/         
#  UltimateWarps - v3.0 by King_Le0_ | Knock Me on Discord for support! username: King_Le0_
#==============================================================================================

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

# spawn settings
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  # Teleports player to spawn EVERY time they join
    message: "<gradient:#5000FF:#00aa00>ᴡᴇʟᴄᴏᴍᴇ ʙᴀᴄᴋ! ʏᴏᴜ ʜᴀᴠᴇ ʙᴇᴇɴ ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ ᴛᴏ sᴘᴀᴡɴ.</gradient>"
  
  teleport-on-first-join:
    enabled: true  # Teleports player to spawn ONLY on their first join ever
    message: "<gradient:#5000FF:#00aa00>ᴡᴇʟᴄᴏᴍᴇ ᴛᴏ ᴛʜᴇ sᴇʀᴠᴇʀ! ʏᴏᴜ ʜᴀᴠᴇ ʙᴇᴇɴ ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ ᴛᴏ sᴘᴀᴡɴ.</gradient>"

# warp settings
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

global:
  cancel-on-move: true
  default-cooldown: 5
  default-delay: 5

# Rank multipliers (for LuckPerms integration)
rank-multipliers:
  default:
    cooldown: 1.0
    delay: 1.0
  vip:
    cooldown: 0.5
    delay: 0.5
  mvp:
    cooldown: 0.5
    delay: 0.5

# Legacy rank multipliers (for permission-based ranks)
ranks:
  default:
    cooldown-multiplier: 1.0
    delay-multiplier: 1.0
  vip:
    cooldown-multiplier: 0.5
    delay-multiplier: 0.7
  mvp:
    cooldown-multiplier: 0.25
    delay-multiplier: 0.4

# default GUI settings
gui:
  warp-gui-title: "<dark_gray>ᴡᴀʀᴘs"
  admin-gui-title: "<dark_gray>ᴡᴀʀᴘ ᴀᴅᴍɪɴ"
  size: 54
  top-filler-material: MAGENTA_STAINED_GLASS_PANE
  mid-filler-material: BLACK_STAINED_GLASS_PANE

# System Messages
messages:
  teleport-cancelled-move: "<red>❌<gradient:#ff5555:#ffaa00>ᴛᴇʟᴇᴘᴏʀᴛ ᴄᴀɴᴄᴇʟʟᴇᴅ ʙᴇᴄᴀᴜsᴇ ʏᴏᴜ ᴍᴏᴠᴇᴅ!</gradient>"
  teleport-cancelled-damage: "<red>💥<gradient:#ff5555:#ffaa00>ᴛᴇʟᴇᴘᴏʀᴛ ᴄᴀɴᴄᴇʟʟᴇᴅ ʙᴇᴄᴀᴜsᴇ ʏᴏᴜ ᴛᴏᴏᴋ ᴅᴀᴍᴀɢᴇ!</gradient>"
  teleportation-confirmed: "<green>✅<gradient:#55ff55:#00aa00>ʏᴏᴜ ʜᴀᴠᴇ ʙᴇᴇɴ ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ ᴛᴏ <white>%warp%</white>!</gradient>"
  warp-not-found: "<red>🚫<gradient:#ff5555:#ffaa00>ᴡᴀʀᴘ ɴᴏᴛ ғᴏᴜɴᴅ!</gradient>"
  no-permission: "<red>🚫<gradient:#ff5555:#ffaa00>ʏᴏᴜ ᴅᴏ ɴᴏᴛ ʜᴀᴠᴇ ᴘᴇʀᴍɪssɪᴏɴ!</gradient>"
  cooldown-active: "<blue>⏳<gradient:#ff5555:#ffaa00>ʏᴏᴜ ᴍᴜsᴛ ᴡᴀɪᴛ <white><b>%seconds%</b></white> sᴇᴄᴏɴᴅs ʙᴇғᴏʀᴇ ᴜsɪɴɢ ᴛʜɪs ᴡᴀʀᴘ ᴀɢᴀɪɴ.</gradient>"
  spawn-set: "<green>🌍<gradient:#55ff55:#00aa00>sᴜᴄᴄᴇssғᴜʟʟʏ sᴇᴛ sᴘᴀᴡɴ ʟᴏᴄᴀᴛɪᴏɴ!</gradient>"
  spawn-not-set: "<red>🚫<gradient:#ff5555:#ffaa00>sᴘᴀᴡɴ ʟᴏᴄᴀᴛɪᴏɴ ɪs ɴᴏᴛ sᴇᴛ!</gradient>"
  spawn-deleted: "<red>🗑<gradient:#55ff55:#00aa00>sᴘᴀᴡɴ ʟᴏᴄᴀᴛɪᴏɴ ᴅᴇʟᴇᴛᴇᴅ!</gradient>"
  warp-created: "<blue>🌍<gradient:#55ff55:#00aa00>sᴜᴄᴄᴇssғᴜʟʟʏ ᴄʀᴇᴀᴛᴇᴅ ᴡᴀʀᴘ <white><b>%name%</b></white>!</gradient>"
  warp-deleted: "<red>🗑<gradient:#55ff55:#00aa00>sᴜᴄᴄᴇssғᴜʟʟʏ ᴅᴇʟᴇᴛᴇᴅ ᴡᴀʀᴘ <white><b>%name%</b></white>!</gradient>"
  warp-edited: "<blue>🌍<gradient:#55ff55:#00aa00>ᴡᴀʀᴘ <white><b>%name%</b></white> ᴜᴘᴅᴀᴛᴇᴅ!</gradient>"
  reload-success: "<blue>🌍<gradient:#55ff55:#00aa00>ᴜʟᴛɪᴍᴀᴛᴇᴡᴀʀᴘs ᴄᴏɴғɪɢᴜʀᴀᴛɪᴏɴ ᴀɴᴅ ᴡᴀʀᴘs ʀᴇʟᴏᴀᴅᴇᴅ!</gradient>"

Support

Join Discord Server for help or updates: