?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
BetterWarpSystem

BetterWarpSystem

Simple & Powerful Warps

676downloads
0followers
676downloads
0followers

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x
1.20.x

Platforms

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published 2 years ago
Updated 2 years ago

Slogan

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

Command Description Permission
/setwarp <name> Set a warp at your location warpsystem.setwarp
/warp <name> Teleport to a warp (everyone)
/warps List all available warps (everyone)
/delwarp <name> Start deletion flow warpsystem.delete
/delwarp confirm <name> Confirm deletion within TTL warpsystem.delete
/warpsysreloadconfig Reload the config live warpsystem.*

🔐 Permissions

Permission Description Default
warpsystem.setwarp Create warps OP
warpsystem.delete Delete warps OP
warpsystem.* Full access OP

⚙️ Configuration

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

Setting Default Description
actionbar true Show actionbar notifications
message true Send chat messages
sound true Play sounds on actions
color.primary &7 Primary text color
color.secondary &a Highlight/accent color
warps.folder warplocations Folder for warp files

🔊 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
Java 21+
Server Spigot / Paper 1.21.x

🧩 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

Made with ❤️ by Larrox