Horizons Warps

!(https://cdn.modrinth.com/data/cached_images/3469d3bfb3a2d39bf91ace998306a9fb4831a21f.png) # HorizonsWarps

HorizonsWarps is a modern, fully-featured warp teleportation plugin built for Paper, Purpur, and Spigot 1. 21+. It provides server-wide warp points with a stunning paginated GUI, flexible per-warp permissions, category organization, and deep economy integration -- everything you need to build an intuitive teleportation network for your server.

From small survival servers to large communities, HorizonsWarps scales effortlessly with configurable warmup and cooldown systems, multiple layout patterns, and support for both SQLite and MySQL storage.

## Features at a Glance

• Server-wide warp locations accessible to all players
• Per-warp permissions for fine-grained access control
• Category system for organized warp grouping
• Beautiful paginated GUI with seven layout patterns
• Custom display names and icons for every warp
• Warmup and cooldown systems with multiple display modes
• Economy integration with five currency backends
• Custom item support from eight external item plugins
• Cross-world warps with per-world configuration
• Sound effects and particle effects on teleport
• Configurable sort order per warp
• SQLite and MySQL database backends via HikariCP
• PlaceholderAPI integration
• Multilingual -- English and German included
• bStats metrics

## Warp System

### Server-Wide Warps

Warps are shared locations available to all players on the server (or restricted by permission). Admins create warps at key locations -- spawn, shops, arenas, farms, biomes -- and players can teleport to them instantly.

### Per-Warp Permissions

Every warp can optionally require a specific permission to use. When a permission is set on a warp, only players with that permission will see it in the GUI and be able to teleport to it.

• Permission format: `horizonswarps.warp.`
• Warps without a permission set are accessible to everyone with the base `horizonswarps.warp` permission

This makes it easy to create VIP warps, staff-only locations, or event-specific destinations.

### Custom Display Names

Each warp can have a custom display name separate from its internal identifier. Display names support full HEX color formatting, gradients, and legacy color codes, letting you create visually distinct and descriptive warp labels in the GUI.

### Custom Warp Icons

Every warp can have a custom icon displayed in the GUI. Icons can be any vanilla Minecraft item or a custom item from a supported external plugin. Change icons at any time with the `/warpadmin seticon` command.

### Sort Order

Each warp has a configurable sort position that determines its placement in the GUI. This gives you full control over the order in which warps appear, regardless of when they were created.

### Warp Categories

Warps can be organized into categories for logical grouping. Categories help players find warps quickly on servers with many destinations. Examples of categories might include Shops, Arenas, Farms, Biomes, or Events.

## Teleportation System

### Cross-World Warps

Players can warp to locations in any world on the server. Cross-world teleportation is configurable:

• Enable or disable cross-world warping globally
• Maintain a list of disabled worlds where warping is restricted

### Warmup System

Teleportation can require a warmup delay before the player is moved. The warmup is interrupted if the player moves or takes damage, preventing abuse.

• Configurable delay in seconds
• Cancel on move -- warmup is cancelled if the player moves
• Cancel on damage -- warmup is cancelled if the player takes damage

#### Warmup Display Modes

Choose how the warmup countdown is presented to the player:

| Mode | Description | |------|-------------| | ActionBar | Shows a progress bar in the action bar with customizable characters, length, and HEX colors | | Title | Displays a title and subtitle countdown on screen | | Both | Combines ActionBar progress bar and Title display simultaneously |

The ActionBar progress bar is fully customizable:

• Configurable bar length
• Custom filled and unfilled characters
• HEX color support for both filled and unfilled segments

### Cooldown System

After warping, a cooldown period is enforced before the player can warp again. This prevents teleport spam and ensures fair usage. Players with the bypass permission skip the cooldown entirely.

### Sound Effects

HorizonsWarps supports configurable sound effects played during teleportation. Sounds have adjustable volume and pitch for full control over the audio experience.

### Particle Effects

A particle effect is displayed at the destination when a player warps, providing visual feedback and flair.

## Economy Integration

HorizonsWarps supports charging players for warp teleportation. Costs can be configured globally or