BetterWarpSystem

Плагин BukkitPaperPurpur

Простая и мощная система варпов для серверов Майнкрафт.

604 скачивания 0 подписчиков

Оцените первым

Канал

Ядро

Версия

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

Download the .jar file
Place it in your server's /plugins folder
Restart your server — config auto-generates ✅
Edit plugins/WarpSysPlugin/config.yml to your liking
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