\n# HorizonsHomes<\/p>\n
**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.<\/p>\n
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.<\/p>\n
—<\/p>\n
## Features at a Glance<\/p>\n
– **Multiple homes per player** with permission-based limits
\n– **Beautiful GUI** for managing homes (teleport, rename, change icon, delete)
\n– **Safe location detection** — prevents setting homes in dangerous locations
\n– **Warmup and cooldown systems** with multiple display modes
\n– **Economy integration** with five currency backends
\n– **Custom item support** from eight external item plugins
\n– **Cross-world teleportation** with per-world configuration
\n– **Respawn at home** on death
\n– **Full HEX color support** including gradients and rainbow text
\n– **SQLite and MySQL** database backends via HikariCP
\n– **PlaceholderAPI** integration
\n– **Multilingual** — English and German out of the box<\/p>\n
—<\/p>\n
## Home Management<\/p>\n
### Multiple Homes with Limits<\/p>\n
Every player can set multiple homes. The number of allowed homes is controlled through permissions:<\/p>\n
– `horizonshomes.limit. 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.<\/p>\n ### Home Naming<\/p>\n 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.<\/p>\n ### Safe Location Detection<\/p>\n When a player sets a home, HorizonsHomes checks the surrounding environment for hazards. The plugin prevents homes from being set in:<\/p>\n – **Lava** or **fire** This keeps players safe and avoids frustrating deaths on teleport.<\/p>\n —<\/p>\n ## Teleportation System<\/p>\n ### Cross-World Teleportation<\/p>\n Players can teleport to homes in any world on the server. This feature is fully configurable:<\/p>\n – Enable or disable cross-world teleportation globally ### Warmup System<\/p>\n Teleportation can require a warmup delay before the player is moved. The warmup is fully configurable:<\/p>\n – **Configurable delay** in seconds #### Warmup Display Modes<\/p>\n Choose how the warmup countdown is presented to the player:<\/p>\n | Mode | Description | The **progress bar** is highly customizable:<\/p>\n – Configurable bar length (number of characters) ### Cooldown System<\/p>\n 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.<\/p>\n ### Sound Effects<\/p>\n HorizonsHomes supports two configurable sound events:<\/p>\n – **Teleport sound** — played when the player arrives at their home Both sounds have configurable **volume** and **pitch** values, giving you full control over the audio experience.<\/p>\n ### Particle Effects<\/p>\n A configurable particle effect is displayed at the teleport destination when a player arrives, adding a visual flair to each teleport.<\/p>\n —<\/p>\n ## Economy Integration<\/p>\n HorizonsHomes supports charging players for home-related actions. Each action can have an independent cost:<\/p>\n | Action | Description | ### Supported Currencies<\/p>\n The plugin supports **five** different currency backends:<\/p>\n | Currency | Description | Economy can also be disabled entirely in the configuration if no costs are desired.<\/p>\n —<\/p>\n ## GUI System<\/p>\n HorizonsHomes includes a polished graphical interface for managing homes. Players open the GUI with `\/homes` and can perform all home management tasks visually.<\/p>\n ### GUI Features<\/p>\n – **Browse all homes** in a paginated, easy-to-navigate layout ### Custom Item Support<\/p>\n Home icons in the GUI can use items from the following external plugins:<\/p>\n | Plugin | Description | These integrations are detected automatically — just install the plugin and it works.<\/p>\n —<\/p>\n ## Respawn at Home<\/p>\n When enabled, players who have a **default home** set will respawn there upon death instead of at the world spawn. This is toggled by a dedicated permission and provides a convenient survival experience.<\/p>\n —<\/p>\n ## Commands<\/p>\n ### Player Commands<\/p>\n | Command | Description | Permission | ### Admin Commands<\/p>\n All admin commands are subcommands of `\/homeadmin` and require the `horizonshomes.admin` permission.<\/p>\n | Command | Description | —<\/p>\n ## Permissions<\/p>\n ### Player Permissions<\/p>\n | Permission | Description | Default | ### Limit Permissions<\/p>\n | Permission | Description | ### Bypass Permissions<\/p>\n | Permission | Description | ### Admin Permissions<\/p>\n | Permission | Description | —<\/p>\n ## Getting Started<\/p>\n 1. **Download** HorizonsHomes and place the `.jar` file in your server’s `plugins` folder. —<\/p>\n ## Configuration<\/p>\n HorizonsHomes is configured through its `config.yml` file. Key configuration sections include:<\/p>\n – **Database** — Choose between SQLite (file-based, zero setup) and MySQL (remote, scalable). Connection pooling is handled by HikariCP for optimal performance. All changes can be applied at runtime using `\/homeadmin reload`.<\/p>\n —<\/p>\n ## Text Formatting<\/p>\n HorizonsHomes fully supports modern Minecraft text formatting:<\/p>\n – **HEX colors** — Use `&#RRGGBB` or `<#RRGGBB>` syntax for any color —<\/p>\n ## Compatibility<\/p>\n ### Requirements<\/p>\n | Requirement | Version | ### Soft Dependencies<\/p>\n All soft dependencies are **optional**. HorizonsHomes detects them automatically at startup.<\/p>\n | Plugin | Purpose | ### Metrics<\/p>\n HorizonsHomes uses **bStats** to collect anonymous usage statistics. This helps the developer understand how the plugin is used and prioritize features. You can opt out of bStats in the bStats configuration file.<\/p>\n —<\/p>\n ## PlaceholderAPI<\/p>\n HorizonsHomes provides the following placeholders (requires PlaceholderAPI):<\/p>\n ### General Placeholders<\/p>\n | Placeholder | Description | ### Per-Home Placeholders<\/p>\n Replace ` | Placeholder | Description | —<\/p>\n ## Database<\/p>\n HorizonsHomes supports two database backends:<\/p>\n | Backend | Best For | Setup | Both backends use **HikariCP** for efficient connection pooling, ensuring reliable and performant database access under load.<\/p>\n —<\/p>\n ## Support<\/p>\n If you encounter any issues, have feature requests, or need help with configuration, feel free to reach out through the following channels:<\/p>\n – **Issue Tracker** — Report bugs or request features on the project’s issue tracker We appreciate feedback and are committed to keeping HorizonsHomes updated and reliable.<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight home plugin that allows players to set, manage, and teleport to their personal home locations.<\/p>\n","protected":false},"featured_media":81931,"template":"","meta":{"_minecraft_slug":"horizons-homes","_minecraft_project_id":"HAmEnBbq","_minecraft_author":"raawn","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":27,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"horizons-homes.zip","_minecraft_size_bytes":722275,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:13:22.250258Z","_minecraft_date_created":"2026-01-24T19:47:27.034421Z","_minecraft_date_modified":"2026-03-31T12:58:15.830726Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/horizons-homes","_minecraft_icon_attachment_id":81931,"_minecraft_imported_at":"2026-06-04T17:00:56+00:00","_minecraft_import_hash":"6907fd7e45d37b86a2228885602f26fd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,129,869,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-81937","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `horizonshomes.unlimited` — Grants unlimited homes<\/p>\n
\n– **The void** (below the world)
\n– **Suffocating blocks** (inside solid materials)<\/p>\n
\n– Disable teleportation to or from specific worlds individually<\/p>\n
\n– **Cancel on move** — the warmup is interrupted if the player moves
\n– **Cancel on damage** — the warmup is interrupted if the player takes damage<\/p>\n
\n|——|————-|
\n| **ActionBar** | Shows a progress bar in the action bar with configurable characters, length, and HEX colors |
\n| **Title** | Displays a title and subtitle countdown on screen |
\n| **Both** | Combines ActionBar progress bar and Title display simultaneously |
\n| **Chat** | Sends countdown messages in chat |<\/p>\n
\n– Custom filled and unfilled characters
\n– Full HEX color support for both filled and unfilled portions<\/p>\n
\n– **Countdown tick sound** — played on each second of the warmup countdown<\/p>\n
\n|——–|————-|
\n| **Set Home** | Charge players when they create a new home |
\n| **Teleport** | Charge players each time they teleport to a home |
\n| **Delete Home** | Charge players when they remove a home |
\n| **Rename Home** | Charge players when they rename an existing home |<\/p>\n
\n|———-|————-|
\n| **Vault** | Standard economy integration via Vault-compatible plugins |
\n| **PlayerPoints** | Uses PlayerPoints as the currency |
\n| **CoinsEngine** | Integrates with CoinsEngine for custom currencies (configurable currency name) |
\n| **XP-based** | Uses the player’s experience levels or points as currency (configurable mode) |
\n| **Item-based** | Requires specific items from the player’s inventory (configurable material) |<\/p>\n
\n– **Teleport** to any home with a single click
\n– **Change the icon** of a home to any item or custom item
\n– **Rename** a home directly from the GUI
\n– **Delete** a home with confirmation<\/p>\n
\n|——–|————-|
\n| **ItemsAdder** | Custom items from ItemsAdder |
\n| **Oraxen** | Custom items from Oraxen |
\n| **HeadDatabase** | Custom player heads from HeadDatabase |
\n| **MMOItems** | Items from MMOItems |
\n| **Slimefun** | Items from Slimefun |
\n| **Nexo** | Custom items from Nexo |
\n| **ExecutableItems** | Items from ExecutableItems |
\n| **EcoItems** | Items from EcoItems |<\/p>\n
\n|———|————-|————|
\n| `\/home [name]` | Teleport to a home. If no name is given, teleports to the default home. | `horizonshomes.home` |
\n| `\/sethome [name]` | Set a new home at your current location. If no name is given, a default name is used. | `horizonshomes.sethome` |
\n| `\/delhome
\n| `\/homes` | Open the home management GUI. | `horizonshomes.homes` |<\/p>\n
\n|———|————-|
\n| `\/homeadmin reload` | Reload the plugin configuration and language files. |
\n| `\/homeadmin list
\n| `\/homeadmin tp
\n| `\/homeadmin delete
\n| `\/homeadmin deleteall
\n| `\/homeadmin info
\n| `\/homeadmin clearcooldown
\n|————|————-|———|
\n| `horizonshomes.home` | Allows teleporting to homes | `true` |
\n| `horizonshomes.sethome` | Allows setting homes | `true` |
\n| `horizonshomes.delhome` | Allows deleting homes | `true` |
\n| `horizonshomes.homes` | Allows opening the home GUI | `true` |
\n| `horizonshomes.respawn` | Respawn at default home on death | `false` |<\/p>\n
\n|————|————-|
\n| `horizonshomes.limit.
\n| `horizonshomes.unlimited` | Grants unlimited homes |<\/p>\n
\n|————|————-|
\n| `horizonshomes.bypass.warmup` | Skip the teleport warmup delay |
\n| `horizonshomes.bypass.cooldown` | Skip the teleport cooldown |
\n| `horizonshomes.bypass.economy` | Bypass all economy costs |
\n| `horizonshomes.bypass.world` | Bypass cross-world teleportation restrictions |<\/p>\n
\n|————|————-|
\n| `horizonshomes.admin` | Access to all `\/homeadmin` commands |<\/p>\n
\n2. **Start or restart** your server. The plugin will generate its default configuration files.
\n3. **Configure home limits** by assigning `horizonshomes.limit.
\n4. **Adjust the configuration** in `config.yml` to set warmup delays, cooldowns, economy costs, and display preferences.
\n5. **Customize messages** by editing the language files. HorizonsHomes ships with English and German translations.
\n6. Players can immediately start using `\/sethome` and `\/home` to manage their homes.<\/p>\n
\n– **Teleportation** — Set warmup delays, cooldown durations, and cross-world restrictions. Configure which worlds to disable.
\n– **Warmup Display** — Choose the display mode (ActionBar, Title, Both, Chat) and customize the progress bar appearance with HEX colors.
\n– **Sound Effects** — Configure teleport and countdown sounds with volume and pitch.
\n– **Particle Effects** — Set the particle type displayed on teleport.
\n– **Economy** — Select a currency backend and set costs for each action (sethome, teleport, delhome, rename).
\n– **Home Naming** — Define a regex validation pattern and maximum name length.
\n– **Safe Location** — Toggle safety checks for dangerous locations.
\n– **GUI** — Customize the home management interface layout and behavior.
\n– **Respawn** — Enable or disable respawning at the default home on death.<\/p>\n
\n– **Gradients** — Apply smooth color transitions across text
\n– **Rainbow text** — Automatic rainbow coloring
\n– **Legacy codes** — Standard `&` color codes remain supported<\/p>\n
\n|————-|———|
\n| **Server Software** | Paper, Purpur, or Spigot |
\n| **Minecraft Version** | 1.21 or newer |
\n| **Java Version** | Java 21 or newer |<\/p>\n
\n|——–|———|
\n| **Vault** | Economy integration |
\n| **PlayerPoints** | Alternative currency |
\n| **CoinsEngine** | Alternative currency |
\n| **PlaceholderAPI** | Placeholder support for other plugins |
\n| **ItemsAdder** | Custom GUI item icons |
\n| **Oraxen** | Custom GUI item icons |
\n| **HeadDatabase** | Custom head icons |
\n| **MMOItems** | Custom GUI item icons |
\n| **Slimefun** | Custom GUI item icons |
\n| **Nexo** | Custom GUI item icons |
\n| **ExecutableItems** | Custom GUI item icons |
\n| **EcoItems** | Custom GUI item icons |<\/p>\n
\n|—|—|
\n| `%horizonshomes_count%` | Number of homes owned by the player |
\n| `%horizonshomes_max%` | Maximum homes allowed (displays “\u221e” if unlimited) |
\n| `%horizonshomes_remaining%` | Remaining homes the player can create (displays “\u221e” if unlimited) |
\n| `%horizonshomes_list%` | Comma-separated list of all home names |
\n| `%horizonshomes_has_home%` | Whether the player has at least one home (`true`\/`false`) |
\n| `%horizonshomes_cooldown%` | Remaining teleport cooldown in milliseconds |
\n| `%horizonshomes_has_cooldown%` | Whether the player is on cooldown (`true`\/`false`) |<\/p>\n
\n|—|—|
\n| `%horizonshomes_home_
\n| `%horizonshomes_home_
\n| `%horizonshomes_home_
\n| `%horizonshomes_home_
\n| `%horizonshomes_home_
\n| `%horizonshomes_home_
\n|———|———-|——-|
\n| **SQLite** | Small to medium servers, single-instance setups | Zero configuration — works out of the box |
\n| **MySQL** | Large servers, multi-instance setups, networks | Requires connection details in the config |<\/p>\n
\n– **Discord** — Join the community Discord server for real-time support and discussion
\n– **Modrinth Comments** — Leave a comment on the Modrinth project page<\/p>\n