WarpCore

A lightweight, per-warp configurable teleport (warp) plugin for Paper / Spigot 1.21+.

WarpCore focuses on a clean structure, one file per warp, and full per-warp customization including messages, sounds, broadcasts, and cooldowns.

---

✨ Features

• 🚀 Simple /warp command system
• 📁 One YAML file per warp (no messy warps.yml)
• ⏱️ Per-warp cooldown support
• 🔊 Per-warp teleport sounds (Registry-based, 1.21 compatible)
• 📢 Optional broadcast messages
• 🔐 Permission-based admin controls
• 🎨 Fully configurable messages with placeholders
• ⚡ Lightweight and performance-friendly

---

📦 Requirements

• Paper / Spigot 1.21+
• Java 21+

---

🔧 Commands

Command	Description	Permission
/warp <name>	Teleport to a warp	warpcore.warp.use
/warp create <name>	Create a warp at your location	warpcore.warp.create
/warp delete <name>	Delete a warp	warpcore.warp.delete

---

🔐 Permissions

Permission	Description	Default
warpcore.warp.use	Use warp command	true
warpcore.warp.create	Create warps	OP
warpcore.warp.delete	Delete warps	OP
warpcore.warp.admin	Full warp administration access	OP
warpcore.cooldown.bypass	Bypass warp cooldowns	OP

---

⚙️ Configuration

📄 config.yml (Messages)

messages:
  user-usage: "&cUsage: /warp <name>"
  admin-usage: "&cUsage: /warp create <name>\n&cUsage: /warp delete <name>"
  no-permission: "&cYou do not have permission to use this command."
  only-player: "&cThis command can only be used by players."
  warp-not-found: "&cWarp &e{warp}&c does not exist"
  warp-create-success: "&aWarp &e{warp}&a has been created successfully."
  warp-create-fail: "&cFailed to create warp."
  warp-delete-success: "&cWarp &e{warp}&c has been deleted successfully."

---

📁 Warp Data Files

Each warp is stored as its own YAML file inside the warps/ folder.

Example: plugins/WarpCore/warps/spawn.yml

location:
  world: world
  x: -260.69999998807907
  y: 72.0
  z: -134.402189877212
  yaw: 76.35025
  pitch: 42.300022

teleport-message: "&aTeleported to warp &e{warp}&a."

teleport-sound-enable: true
teleport-sound: "entity.enderman.teleport:1.0:0.9"

broadcast-enable: false
broadcast-message: "&e{player} &7teleported to warp &e{warp}&7."

cooldown: 10
cooldown-message: "&cYou must wait &e{time} &cbefore using this warp again."

---

🔊 Teleport Sounds

WarpCore uses Registry-based sound keys, fully compatible with Minecraft 1.21+.

Sound Format

sound_key:volume:pitch

Example

teleport-sound: "item.chorus_fruit.teleport:1.2:1.1"

---

🧠 Placeholders

Placeholder	Description
{warp}	Warp name
{player}	Player name
{time}	Remaining cooldown time (seconds)

---

📜 License

MIT License