Ultimate Warps

Modrinth

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

49 Downloads 1 Follower aktualisiert 5h ago

neueste v2.1.1 Modrinth

Paper Purpur 1.21 – 26.1.2 Game-mechanicsTechnologyUtility

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.
Fully Customizable warps GUI — control every slot and buttons, per-button click sounds, Custom player head textures and commands on buttons.
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.
Modern Server Spawn — Server spawn can be set easily with a single command and has features like forcespawn, teleport to spawn on first join or every join and many more!
Fully Configurable — Editable YAML files, customizable messages, modular settings, and a unified /uwarps command with tab completion.

Installation

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

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

Commands

| Command | Description |
|---|---|
| /spawn | Teleport to spawn |
| /setspawn | Set spawn location |
| /delspawn | Delete spawn location |
| /warp , /warps , /warplist, /warpslist | 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 , /uwarps help , … | Unified sub-commands |
| /forcespawn , /spawnforce , … | Force teleports a player to spawn, even if they are offline! |

Permissions

| Permission | Default |
|---|---|
| ultimatewarps.admin | op |
| ultimatewarps.spawn | true |
| ultimatewarps.warp.* | true |
| ultimatewarps.warp.<name> | true |

Configuration File

📁 config.yml (main settings)

#==============================================================================================
#    __  ______  _            __        _      __                
#   / / / / / /_(_)_ _  ___ _/ /____   | | /| / /__ ________  ___
#  / /_/ / / __/ /  ' \/ _ `/ __/ -_)  | |/ |/ / _ `/ __/ _ \/_-<
#  \____/_/\__/_/_/_/_/\_,_/\__/\__/   |__/|__/\_,_/_/ / .__/___/
#                                                      /_/         
#  UltimateWarps - v2.1.1 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:

Versionen

Release

2.1.1

paper, purpur · 1.21, 1.21.1, 1.21.2 · 5h ago

## v2.1.1 — Bug Fixes & Improvements **Security/Permissions** - Fixed `/warp <name>` bypassing per-warp permissions (GUI was filtered correctly, the command…

Beta

2.1.0

paper, purpur · 1.21, 1.21.1, 1.21.2 · 8d ago

## Bug fixed from v2.0

Alpha

2.0

paper, purpur · 1.21, 1.21.1, 1.21.2 · 8d ago

# UltimateWarps v2.0 - New Features ## Spawn Enhancements - **Auto-teleport on first join** - New players teleported to spawn automatically - **Auto-teleport…