WarpCore

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