DigitalWarps

A modern, lightweight Warps plugin for everyone, yet free. Built with a clean architecture and fully configurable via settings.yml and messages.yml.

---

Features

• Create, delete and teleport to warps
• Safe location check when creating warps
• Teleport warmup with movement cancellation
• Configurable cooldown system (OP players bypass cooldown)
• Paginated warp list GUI with warp info (owner, world, coordinates)
• Confirmation GUI for warp deletion
• MiniMessage + legacy & color code support
• Fully configurable settings.yml and messages.yml

---

Commands

Command	Description	Permission
/warp <name>	Teleport to a warp	warp.use
/setwarp <name>	Create a warp at your location	warp.create
/delwarp <name>	Delete a warp	warp.delete
/warps	Open the warp list GUI	—
/adminwarp reload	Reload all configs	warp.admin

---

Permissions

Permission	Description	Default
warp.use	Allows teleporting to warps	true
warp.create	Allows creating warps	op
warp.delete	Allows deleting warps	op
warp.admin	Allows admin commands	op

OP players bypass all permission checks and cooldowns.

---

Configuration

settings.yml

prefix: "<dark_gray>[<white><bold>DigitalWarps</bold></white><dark_gray>]<reset>"

teleport:
  cooldown:
    enabled: true
    time: 5 # seconds — OP players bypass this

list:
  enabled: true
  title: "<dark_gray>Warps"
  item: "ENDER_PEARL"
  lore: "&7Click to teleport to %warp%"
  items:
    next:
      item: "ARROW"
      name: "<green>Next Page <gray>(%nextpage%)"
    previous:
      item: "ARROW"
      name: "<red>Previous Page <gray>(%previouspage%)"

delwarp-gui:
  title: "<dark_red>Delete Warp"
  confirmItem:
    material: "LIME_STAINED_GLASS_PANE"
    slots: [10, 11, 12, 19, 20, 21, 28, 29, 30]
  cancelItem:
    material: "RED_STAINED_GLASS_PANE"
    slots: [14, 15, 16, 23, 24, 25, 32, 33, 34]
  fillItem:
    material: "GRAY_STAINED_GLASS_PANE"
    slots: [13, 22, 31]

messages.yml

only-player: "<red>Only players can use this command."
no-permission: "<red>You don't have permission to do that."
name-required: "<red>Please provide a warp name."
warp-exists: "<red>A warp with that name already exists."
warp-created: "<green>Warp <white>%warp%<green> has been created."
warp-deleted: "<red>Warp <white>%warp%<red> has been deleted."
warp-not-found: "<red>Warp <white>%warp%<red> does not exist."
warp-message: "<green>Teleported to <white>%warp%<green>."
warp-usage: "<red>Usage: /warp <name>"
admin-usage: "<red>Usage: /adminwarp reload"
cooldown: "<red>Please wait <white>%time%s<red> before teleporting again."
teleport-warmup: "<green>Teleporting in a moment, don't move!"
teleport-cancelled: "<red>Teleport cancelled — you moved!"
teleport-warmup: "<green>Teleporting soon, don't move!"
warplist-title: "<dark_gray>Available warps:"
warplist-entry: "<gray>- <white>%warp%"
warplist-empty: "<red>No warps have been created yet."
warp-unsafe: "<red>Warp <white>%warp%<red> is unsafe to teleport to."
warp-unsafe-create: "<red>This location is unsafe. Move to a safe location before creating a warp."
warp-world-not-found: "<red>The world for warp <white>%warp%<red> no longer exists."
reload: "<green>Config reloaded successfully."
confirm: "<green>Confirm"
cancel: "<red>Cancel"

All messages and titles support MiniMessage formatting and legacy & color codes.
MiniMessage reference: https://docs.advntr.dev/minimessage/format.html

---

Installation

1. Download the latest DigitalWarps.jar
2. Place it in your server's plugins/ folder
3. Restart the server
4. Configure plugins/DigitalWarps/settings.yml and messages.yml to your liking
5. Run /adminwarp reload to apply changes without restarting

---

Requirements

• Java 21+
• Spigot / Paper 1.21+

---

Building

./gradlew shadowJar

Output: build/libs/DigitalWarps.jar

---

Author

Made by Digitality
Discord: discord.gg/digitality