Перейти к содержимому
Mineforgian

Ultimate Warps

A modern plugin for server spawn, server warps and player warps with interactive GUI and commands

Загрузки
103
Подписчики
1
Обновлён
5 июля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 23 мая 2026 г.

Исходный код
uwarp-v3

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

Minecraft Java 21 LuckPerms MiniMessage

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:

discordhelpbanner

Ченджлог

3.0.1Релиз26.1, 26.1.1, 26.1.2 · 5 июля 2026 г.

3.0.1 Changes

  • Fixed a crash on 1.21.1 and lower verison when opening or clicking the player warps GUI
  • Fixed warp icons breaking when moving data between different server versions — unsupported icons now silently revert to default instead of spamming errors in the console
  • Fixed the teleport-cancel-on-damage setting.
3.0Релиз26.1, 26.1.1, 26.1.2 · 24 июня 2026 г.

New Features

Player Warps — a full player-created warps system, separate from admin warps:

  • /playerwarps (/pwarps): gui, set, del, edit, list, warp <name>, warp <owner> <name>, and admin info|wipe|tp for staff.
  • Per-player limits via numbered permission nodes (ultimatewarps.playerwarps.limit.<n>, highest wins) or unlimited.
  • Public/private visibility, custom icons/descriptions, own edit GUI.
  • Optional creation requirements: own GriefPrevention claim, outside WorldGuard regions, overworld-only, min distance from spawn/other warps. Works without those plugins installed.
  • Fully configurable teleport countdown — boss bar (color/style/text), title/subtitle, particles (type/count/dust), sound (type/volume/pitch) — plus own storage, config, and GUI layout files.

Formatting — a shared formatting engine used everywhere a name or message is rendered, supporting MiniMessage tags, legacy & codes, hex (&#RRGGBB/&x&R&R...), and § codes together without one breaking the other.

Usability — tab-completion added to /delwarp.

Behavior Changes

  • Teleporting to a player warp now requires the explicit warp subcommand (/playerwarps warp <name>) instead of being the unnamed default. Previously a warp named edit, del, set, list, gui, or admin could never be teleported to directly. warp is now the only reserved name, and it's blocked at creation time.

Bug Fixes

  • Fixed permissions not being checked on /warp <name>.
  • Fixed a security issue with crafted warp names in /setwarp.
  • Fixed /spawn cooldown bypass and missing cooldown after a delayed spawn.
  • Fixed the warp GUI sometimes not teleporting when clicked right after opening.
  • Fixed GUI clicks sometimes teleporting to the wrong warp.
  • Fixed custom display names and icons not showing in the warp GUI, boss bars, titles, or chat.
  • Fixed colors and gradients breaking in messages, titles, and boss bars when a name was inserted.
  • Fixed display names showing as plain text in some admin confirmation messages.
  • Fixed display name formatting not showing in player-warp boss bars/titles.
  • Fixed player-warp teleport effects (boss bar, title, particles, sound) being fixed instead of configurable.
  • Fixed a stray </gradient> tag showing up in the player-warp title.
  • Fixed the player-warps menu showing {current}/{total} instead of real page numbers.
  • Fixed player-warps menu navigation buttons not showing their custom head textures.
  • Fixed legacy hex color codes sometimes being stripped from display names when set via chat.
  • Fixed teleport countdowns not stopping properly on plugin reload/disable.
2.1.1Бета26.1, 26.1.1, 26.1.2 · 20 июня 2026 г.

v2.1.1 — Bug Fixes & Improvements

Security/Permissions

  • Fixed /warp <name> bypassing per-warp permissions (GUI was filtered correctly, the command wasn't)
  • Added warp name validation to prevent path traversal via /setwarp

Cooldowns

  • Fixed /spawn ignoring ultimatewarps.bypass.cooldown
  • Fixed delayed /spawn never applying a cooldown after teleport

Custom Icons & Display Names

  • Fixed custom warp icons (set via /warpsadmin) not appearing in the /warp GUI
  • Fixed custom display names not appearing in the GUI or in teleport messages (boss bar, title, chat confirmation)
  • Fixed custom GUI items/buttons silently overwriting warp icons on slot overlap

Stability

  • Fixed teleport tasks not being cancelled on plugin reload/disable
  • Fixed dead movement-cancel listener (teleports now cancel instantly on move)
  • Removed false Folia support claim from plugin.yml
  • Fixed AdminGUI inventory holder contract violation (getInventory() returning null)
  • Migrated deprecated AsyncPlayerChatEvent to AsyncChatEvent

Misc

  • Added tab-completion to /delwarp
  • Fixed inconsistent particle/version fallback values
  • Hardened /spawnforce against message formatting injection
2.1.0Бета26.1, 26.1.1, 26.1.2 · 12 июня 2026 г.

Bug fixed from v2.0

2.0Альфа26.1, 26.1.1, 26.1.2 · 12 июня 2026 г.

UltimateWarps v2.0 - New Features

Spawn Enhancements

  • Auto-teleport on first join - New players teleported to spawn automatically
  • Auto-teleport on every join - Optional teleport on each login
  • Force teleport - /spawnforce <player> - Teleport any player (online/offline)

GUI Improvements

  • Fully customizable warps GUI - control every slot and button
  • Custom decorative items (borders, separators)
  • Per-button click sounds
  • Custom player head textures and commands on buttons

Sound System

  • Click sounds for GUI buttons (configurable per button)
  • Separate sound settings for spawn and warp teleports

Data Storage

  • Spawn location stored in separate spawn.yml file
  • Player data tracking for first-join detection

New Commands

  • /spawnforce <player> - Force teleport player (admin)

Configuration Additions

  • teleport-on-first-join - First join teleport settings
  • teleport-on-every-join - Every join teleport settings
  • Customizable welcome messages with gradients

Комментарии

Загружаем…