UltraWarps

UltraWarps

UltraWarps is a modern, high-performance server warp system built for Paper, Purpur, and Folia. Designed for admin-controlled server warps, it provides safe, smooth, and fully configurable teleportation with proper warmup handling and cancellation.

---

✨ Features

⚡ Performance Focused

- Async warp loading and saving - Thread-safe teleport scheduling - Folia-supported - No main-thread blocking operations

⏳ Teleport Warmup System

- Configurable countdown timer - Title-based countdown display - Instant cancellation on movement - Cancel title + chat message - Success title + chat message

🎨 Fully Configurable Messages

- Custom headers - Custom titles & subtitles - Placeholder support (`%warp%`, `%seconds%`) - Clean formatting system

🔐 Admin-Controlled Warps

- `/uw set <name>` - `/uw delete <name>` - `/warp <name>` - `/listwarps`

No player-created warps — only server-defined locations.

🛠 Admin Utilities

- `/uw reload` (shows reload time in ms) - `/uw info` (version, total warps, storage type) - `/uw help`

💾 Storage Options

- YAML storage (default) - JSON-ready structure - Async saving during runtime - Safe synchronous save on shutdown

---

📜 Commands

Player Commands

| Command | Description | |----------|-------------| | `/warp <name>` | Teleport to a server warp | | `/listwarps` | View available warps |

Admin Commands

| Command | Description | |----------|-------------| | `/uw set <name>` | Create a warp at your location | | `/uw delete <name>` | Delete a warp | | `/uw reload` | Reload configuration | | `/uw info` | View plugin information | | `/uw help` | View command list |

Alias: /uw

---

🔑 Permissions

| Permission | Description | Default | |------------|------------|----------| | `ultrawarps.use` | Use `/warp` | true | | `ultrawarps.list` | Use `/listwarps` | true | | `ultrawarps.admin` | Access admin commands | op |

---

🧩 Compatibility

- Paper 1.20+ - Purpur - Folia - Java 17+

---

📦 Installation

1. Download `UltraWarps.jar` 2. Place it inside your `/plugins` folder 3. Restart your server 4. Configure `config.yml` 5. Start creating warps

---

🎯 Design Goals

UltraWarps is built with: - Clean architecture - Maintainability - Performance - Modern API usage - No legacy hacks