WarpCore

WarpCore

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

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

---

✨ Features

- 🚀 Simple `/warp` command system - 📁 Per-warp teleport sounds (no messy `warps.yml`) - ⏱️ Per-warp teleport sounds - 🔊 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 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)

```yml 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`

```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 1.21+, fully compatible with Minecraft 1.21+.

Sound Format

``` sound_key:volume:pitch ```

Example

```yml 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