Advanced warp management plugin
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
/uwarpscommand with tab completion.
Dependency: LuckPerms
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 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.* |
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 /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.<number> |
false |
Allows 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-limitinplayerwarps-config.yml.createdefaults tofalsefor server owners to choose which groups or players have the permission to set player warps.
Configuration File
📁 config.yml (main settings)
#========================================================================================================
# __ ______ _ __ _ __
# / / / / / /_(_)_ _ ___ _/ /____ | | /| / /__ ________ ___
# / /_/ / / __/ / ' \/ _ `/ __/ -_) | |/ |/ / _ `/ __/ _ \/_-<
# \____/_/\__/_/_/_/_/\_,_/\__/\__/ |__/|__/\_,_/_/ / .__/___/
# /_/
# UltimateWarps - v3.0.2 by King_Le0_, Join discord server for support. https://discord.gg/r4gRhda8Mw
#========================================================================================================
# 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:
