⭐ StarWarps

StarWarps is a premium, production-ready warp management plugin built for modern Minecraft servers and serious networks. It provides fast, secure, highly optimized, and fully configurable teleportation with countdowns, movement cancellation, permissions, a polished warp GUI, persistent warp storage, and Paper/Folia-compatible scheduling.

✨ Features

• 🚀 Fast and optimized warp teleportation
• 📍 Unlimited custom warps
• ⏳ Configurable teleport countdown
• 🛑 Movement-based teleport cancellation
• ⚡ Instant teleportation inside the configured spawn world
• 🖥️ Premium /warps GUI
• 📑 GUI pagination support
• 🔐 Per-warp permissions
• 🎨 Legacy colors, Hex colors, MiniMessage-style formatting, and gradients
• 💾 Dedicated warps.yml storage
• 🔄 Safe /warpreload configuration and warp reloading
• 🧠 Case-insensitive warp names
• 🛡️ Duplicate and invalid warp protection
• 🌎 World and location validation
• 🔊 Configurable teleport and GUI sounds
• 📋 Intelligent tab completion
• 🧹 Automatic cleanup of active teleport tasks
• 🔥 Paper/Folia-compatible scheduling architecture
• ⚙️ Highly configurable YAML files
• 💪 Designed for large servers and networks
• 🛡️ Robust handling of missing worlds, invalid locations, corrupted data, and runtime errors

📦 Installation

1. Download the latest StarWarps .jar.
2. Place it inside your server's plugins folder.
3. Start or restart your server.
4. StarWarps will generate its configuration files.
5. Configure the plugin as required.
6. Use /setwarp <name> to create your first warp.

Always back up config.yml and warps.yml before making major changes.

🧭 Commands

Player Commands

Command	Description
/warp <name>	Teleport to a specific warp
/warps	Open the warp GUI
/warpinfo <name>	View information about a warp

Admin Commands

Command	Description
/setwarp <name>	Create or update a warp at your current location
/delwarp <name>	Delete an existing warp
/warpreload	Reload StarWarps configuration and warp data

Examples

/warp spawn
/warp crates
/warp shop
/warps
/warpinfo spawn

/setwarp spawn
/setwarp crates
/delwarp crates
/warpreload

🔐 Permissions

Permission	Description
starwarps.warp	Allows the player to use /warp
starwarps.warp.<warp>	Allows access to a specific warp
starwarps.setwarp	Allows creating/editing warps
starwarps.delwarp	Allows deleting warps
starwarps.warpinfo	Allows using /warpinfo
starwarps.reload	Allows using /warpreload
starwarps.admin	Administrative StarWarps access
starwarps.bypass.delay	Bypasses the teleport countdown
starwarps.bypass.movement	Prevents movement from cancelling teleportation

Permission Examples

starwarps.warp
starwarps.warp.spawn
starwarps.warp.shop
starwarps.warp.crates
starwarps.bypass.delay
starwarps.bypass.movement

Per-warp permissions can be used to restrict individual destinations, for example:

starwarps.warp.shop

⏳ Teleport System

By default, StarWarps uses a 5-second teleport countdown.

When a player executes:

/warp spawn

StarWarps displays the remaining countdown through chat and the action bar.

Example:

You will be teleported in 5 seconds.

If the player moves beyond the configured movement threshold, the teleport is cancelled:

Teleport cancelled because you moved.

The default movement threshold is 0.5 blocks.

Players with starwarps.bypass.delay can bypass the countdown.

Players with starwarps.bypass.movement can move without cancelling their teleport.

🏠 Spawn World Behavior

When a player is already inside the configured spawn world, warp teleportation can occur instantly without the normal countdown.

This behavior is configurable.

🖥️ Warp GUI

Use:

/warps

to open the StarWarps GUI.

The GUI can display:

• Warp icons
• Warp names
• Descriptions
• Permission/status information
• Click-to-teleport actions
• Filler items
• Configurable inventory size
• Custom GUI title
• Custom sounds
• Pagination for large warp collections

The GUI layout and appearance can be customized through configuration files.

🌎 Warp Storage

Warp locations are stored in:

warps.yml

Each warp stores:

• World
• X coordinate
• Y coordinate
• Z coordinate
• Yaw
• Pitch

Warp names are normalized and handled case-insensitively, preventing duplicate destinations such as Spawn, spawn, and SPAWN.

🌍 Example Destinations

StarWarps can be used for destinations such as:

afk
auction
crates
duels
shop
spawn
world
world_nether
world_the_end

These are examples only. StarWarps does not require or hardcode them. Administrators can create unlimited custom destinations.

Example:

/setwarp spawn
/setwarp shop
/setwarp auction
/setwarp crates
/setwarp duels

🎨 Fully Configurable Messages

StarWarps supports:

• Legacy color codes
• Hex colors
• MiniMessage-style formatting
• Gradients
• Countdown placeholders
• Warp/destination placeholders

Example countdown:

<##A7A7A7>You will be teleported in <##37BFF8>{seconds} <##A7A7A7>seconds.

Cancellation:

<##FB5454>Teleport cancelled because you moved.

Successful teleport:

<##A7A7A7>You were warped to <##37BFF8>{destination}<##A7A7A7>.

All messages can be customized.

⚙️ Configuration

StarWarps provides configuration for:

• Teleport delay
• Movement threshold
• Spawn-world instant teleport
• Teleport sounds
• GUI title
• GUI size
• GUI layout
• Warp icons
• Filler items
• GUI sounds
• Messages
• Permissions
• Warp behavior
• Countdown behavior
• Pagination

🔄 Reloading

Administrators can reload supported configuration and warp data using:

/warpreload

StarWarps safely cleans up active teleport states and scheduled tasks during reloads to prevent duplicated tasks and memory leaks.

🛡️ Reliability & Performance

StarWarps is designed for serious Minecraft networks and uses:

• Modular architecture
• Cached warp data
• Efficient teleport state management
• Minimal scheduled work
• No unnecessary repeating tasks
• Safe task cleanup
• Paper/Folia-compatible scheduling
• Main-thread-safe Bukkit/Paper API access
• World and location validation
• Protection against invalid warp data
• Safe handling of player disconnects
• Cleanup on death and world changes
• Cleanup during reloads and server shutdown

The system is designed to remain performant with large numbers of warps and players.

🧩 Compatibility

Platform: Paper / Folia-compatible architecture

Build System: Maven

Package: me.starog.starstudio.warps

StarWarps is built around modern Paper APIs with a scheduling abstraction designed for long-term maintainability.

📁 Data Files

Typical StarWarps data structure:

plugins/
└── StarWarps/
    ├── config.yml
    ├── messages.yml
    ├── gui.yml
    └── warps.yml

File names may vary depending on the installed version and configuration setup.

🚀 Why StarWarps?

StarWarps isn't designed to be just another basic /warp plugin.

It focuses on providing a premium network-grade teleportation experience with a clean GUI, powerful permissions, reliable persistence, configurable teleport mechanics, modern formatting, and an architecture designed for long-term development.

Simple for players. Powerful for administrators. Optimized for servers.

⭐ StarWarps — Fast. Clean. Reliable. Built for your network.