⭐ 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

Download the latest StarWarps .jar.
Place it inside your server's plugins folder.
Start or restart your server.
StarWarps will generate its configuration files.
Configure the plugin as required.
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.