BetterWarpSystem

A lightweight and fully configurable warp plugin for Bukkit/Spigot/Paper — with custom sounds, colors, actionbar support, and live config reloads.

---

⚡ Features

• Warps — set, teleport to, list, and delete named warps with ease
• Persistent Storage — every warp is saved as a YAML file on disk, nothing gets lost
• Fully Configurable — customize messages, colors, and sounds via config.yml
• Live Reloading — apply config changes at runtime without restarting
• Deletion Confirmation — prevent accidents with a built-in confirmation flow (with TTL)
• Flexible Notifications — choose between chat messages, actionbar alerts, or both

---

🕹️ Commands

---

🔐 Permissions

---

⚙️ Configuration

All messages, colors, and sounds are defined in config.yml. Key settings:

🔊 Sounds

sounds:
  success: 'ENTITY_VILLAGER_TRADE'
  fail: 'ENTITY_VILLAGER_NO'
  delete_confirm: 'BLOCK_ANVIL_PLACE'

🧨 Deletion Confirmation

confirmation:
  delete:
    enabled: true
    ttl_seconds: 20

💬 Messages

messages:
  warp-set: '&aSuccessfully set warp "{warp}".'
  warp-deleted: '&aWarp "{warp}" deleted successfully.'
  delete-confirm: '&ePlease confirm: &c/delwarp confirm {warp} &ewithin {seconds}s.'

Tip: Use & for color codes — it's more readable than §.

---

🛠️ Installation

1. Download the .jar file
2. Place it in your server's /plugins folder
3. Restart your server — config auto-generates
4. Edit plugins/WarpSysPlugin/config.yml to your liking
5. Use /warpsysreloadconfig to apply changes live

---

🔧 Requirements

---

🧩 Troubleshooting

• Warps not saving? Make sure the plugin has write access to the plugins/ folder
• Sounds not working? Double-check Bukkit Sound enum names — invalid names fall back to defaults

---

🔗 Source Code & Contributing

This plugin is open source — contributions, bug reports, and feature requests are welcome!

View on GitHub · Report Issues

---