Horizons Homes

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

HorizonsHomes is a modern, feature-rich home teleportation plugin built for Paper, Purpur, and Spigot 1. 21+. It gives your players a seamless home management experience with a beautiful GUI, flexible economy support, and deep configurability -- all backed by robust SQLite or MySQL storage.

Whether you run a small survival server or a large network, HorizonsHomes adapts to your needs with permission-based home limits, cross-world teleportation, warmup and cooldown systems, and full multilingual support.

## Features at a Glance

• Multiple homes per player with permission-based limits
• Beautiful GUI for managing homes (teleport, rename, change icon, delete)
• Safe location detection -- prevents setting homes in dangerous locations
• Warmup and cooldown systems with multiple display modes
• Economy integration with five currency backends
• Custom item support from eight external item plugins
• Cross-world teleportation with per-world configuration
• Respawn at home on death
• Full HEX color support including gradients and rainbow text
• SQLite and MySQL database backends via HikariCP
• PlaceholderAPI integration
• Multilingual -- English and German out of the box

## Home Management

### Multiple Homes with Limits

Every player can set multiple homes. The number of allowed homes is controlled through permissions:

• `horizonshomes.limit.` -- Grants the player exactly `` homes (e.g., `horizonshomes.limit. 5`)
• `horizonshomes.unlimited` -- Grants unlimited homes

The plugin automatically resolves the highest limit a player has. A sensible default limit can also be configured for players without any specific limit permission.

### Home Naming

Home names are validated against a configurable regex pattern to keep things clean and consistent. Names are capped at a maximum length of 32 characters. Players can rename existing homes at any time, either through commands or the GUI.

### Safe Location Detection

When a player sets a home, HorizonsHomes checks the surrounding environment for hazards. The plugin prevents homes from being set in:

• Lava or fire
• The void (below the world)
• Suffocating blocks (inside solid materials)

This keeps players safe and avoids frustrating deaths on teleport.

## Teleportation System

### Cross-World Teleportation

Players can teleport to homes in any world on the server. This feature is fully configurable:

• Enable or disable cross-world teleportation globally
• Disable teleportation to or from specific worlds individually

### Warmup System

Teleportation can require a warmup delay before the player is moved. The warmup is fully configurable:

• Configurable delay in seconds
• Cancel on move -- the warmup is interrupted if the player moves
• Cancel on damage -- the warmup is interrupted 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 configurable characters, length, and HEX colors | | Title | Displays a title and subtitle countdown on screen | | Both | Combines ActionBar progress bar and Title display simultaneously | | Chat | Sends countdown messages in chat |

The progress bar is highly customizable:

• Configurable bar length (number of characters)
• Custom filled and unfilled characters
• Full HEX color support for both filled and unfilled portions

### Cooldown System

After teleporting, a cooldown period can be enforced before the player can teleport again. This prevents teleport spam and can be bypassed with the appropriate permission.

### Sound Effects

HorizonsHomes supports two configurable sound events:

• Teleport sound -- played when the player arrives at their home
• Countdown tick sound -- played on each second of the warmup countdown

Both sounds have configurable volume and pitch values, giving you full control over the audio experience.

### Particle Effects

A configurable particle effect is displayed at the teleport destination when a player arrives, adding a visual flair to each teleport.

## Economy Integration

HorizonsHomes supports charging players for home-related actions. Each action can have an independent cost:

| Action | Description | |--------|-------------| | Set Home | Charge players when they create a new home | | Teleport | Charge players each time they teleport to a home | | Delete Home | Charge players when they remove a home | | Rename Home | Charge players when they rename an existing home |

### Supported Currencies

The plugin supports five different currency backends:

| Currency | Description | |----------|-------------| | Vault | Standard economy integration via Vault-compa