Horizons Homes icon

Horizons Homes -----

A modern, feature-rich home teleportation plugin for Spigot/Paper



Commands

Code (Text):

/home [name]     - Teleport to a home (opens GUI if no name given)
/sethome [name]  - Set a home at your current location
/delhome <name>  - Delete a home
/homes           - List all your homes / Open GUI
 
Admin Commands

Code (Text):

/homeadmin reload                  - Reload all configuration files
/homeadmin list <player>           - View a player's homes
/homeadmin tp <player> <home>      - Teleport to a player's home
/homeadmin delete <player> <home>  - Delete a player's home
/homeadmin deleteall <player>      - Delete all homes of a player
/homeadmin info <player>           - View player info (homes, cooldown)
/homeadmin clearcooldown <player>  - Clear a player's teleport cooldown
 
Command Aliases

  • /home → /h
  • /sethome → /createhome
  • /delhome → /removehome, /deletehome
  • /homes → /homelist, /listhomes
  • /homeadmin → /hadmin, /homeadm

Permissions

Basic Permissions

Code (Text):

horizonshomes.home     - Teleport to homes (default: everyone)
horizonshomes.sethome  - Set homes (default: everyone)
horizonshomes.delhome  - Delete homes (default: everyone)
horizonshomes.homes    - List homes (default: everyone)
horizonshomes.respawn  - Respawn at default home (default: everyone)
horizonshomes.admin    - Access admin commands (default: OP)
horizonshomes.*        - All permissions (default: OP)
 
Limit Permissions

Control how many homes players can have:

Code (Text):

horizonshomes.limit.3   - 3 homes
horizonshomes.limit.5   - 5 homes
horizonshomes.limit.10  - 10 homes
horizonshomes.limit.50  - 50 homes
horizonshomes.unlimited - Unlimited homes
 
The highest limit permission takes priority.

Bypass Permissions

Code (Text):

horizonshomes.bypass.warmup   - Skip teleport warmup
horizonshomes.bypass.cooldown - Skip teleport cooldown
horizonshomes.bypass.economy  - Free teleports and home creation
horizonshomes.bypass.*        - All bypass permissions
 
GUI Features

Home List
  • View all your homes at a glance
  • Left-click: Teleport to home
  • Right-click: Open home settings
  • Shift+Left: Quick delete (with confirmation)
  • Shift+Right: View home info (coordinates, creation date, safety status)
  • Pagination for many homes

Home Settings
  • Teleport - Quick teleport button
  • Change Icon - Choose from 57+ customizable icons
  • Rename - Rename your home via chat input
  • Delete - Delete with confirmation

Icon Selection
  • All icons have custom names and descriptions
  • Support for custom items (HeadDatabase, ItemsAdder, Oraxen)
  • Current icon highlighted with enchantment glint
  • Paginated for large icon lists

⚙️ Configuration

config.yml

Code (Text):

# Language: de_DE or en_US (add your own in messages/ and gui/ folders)
language: en_US

# Database: sqlite or mysql
database:
  type: sqlite
  table-prefix: "hh_"
  mysql:
    host: localhost
    port: 3306
    database: horizonshomes
    username: root
    password: ""

# Home Settings
homes:
  default-max-homes: 3        # Default limit (override with permissions)
  default-home-name: "home"   # Name when /sethome is used without argument
  case-sensitive-names: false
  max-name-length: 32
  block-unsafe-locations: true
  respawn-at-default-home: false
  allow-cross-world: true
  disabled-worlds:
    - "example_world"

# Teleport Settings
teleport:
  warmup-seconds: 3           # 0 = instant teleport
  cooldown-seconds: 30        # 0 = no cooldown
  cancel-on-move: true
  cancel-on-damage: true
  show-countdown: true
  sound: ENTITY_ENDERMAN_TELEPORT
  show-particles: true

# Economy (requires Vault)
economy:
  enabled: false
  sethome-cost: 100
  teleport-cost: 50
  delhome-cost: 0
 
Custom Icons

Each icon can be fully customized in gui/gui_en_US.yml:

Code (Text):

icons:
  # Simple format (auto-generated name)
  - RED_BED
 
  # Full format with custom name and lore
  - material: RED_BED
    name: "&cRed Bed"
    lore:
      - "&7The classic home icon"
      - "&7Cozy and comfortable"
 
  # Custom items from other plugins
  - material: "hdb:12345"
    name: "&6Special Head"
    lore:
      - "&7A unique HeadDatabase icon"
     
  - material: "itemsadder:furniture:home_sign"
    name: "&aCustom Sign"
    lore:
      - "&7ItemsAdder custom item"
     
  - material: "oraxen:custom_bed"
    name: "&bOraxen Bed"
    lore:
      - "&7Special Oraxen icon"
 
PlaceholderAPI

Code (Text):

%horizonshomes_count%        - Number of homes (e.g. 3)
%horizonshomes_max%          - Maximum homes allowed (e.g. 5 or ∞)
%horizonshomes_remaining%    - Homes left to create (e.g. 2 or ∞)
%horizonshomes_list%         - Comma-separated home names (e.g. home, base, farm)
%horizonshomes_has_home%     - Has at least one home (true/false)
%horizonshomes_cooldown%     - Remaining cooldown in seconds (e.g. 15)
%horizonshomes_has_cooldown% - Is on cooldown (true/false)
 
Home Placeholders

Replace <name> with the home name, e.g. %horizonshomes_home_base_world%

Code (Text):

%horizonshomes_home_<name>_world%  - World name of specific home
%horizonshomes_home_<name>_x%      - X coordinate
%horizonshomes_home_<name>_y%      - Y coordinate
%horizonshomes_home_<name>_z%      - Z coordinate
%horizonshomes_home_<name>_coords% - Formatted coordinates
%horizonshomes_home_<name>_exists% - Home exists (true/false)
 
Installation

  1. Download the latest version
  2. Place HorizonsHomes.jar in your plugins/ folder
  3. Restart your server
  4. Edit configuration files in plugins/HorizonsHomes/
  5. Use /homeadmin reload to apply changes

Adding Languages

  1. Copy messages/messages_en_US.yml to messages/messages_xx_XX.yml
  2. Copy gui/gui_en_US.yml to gui/gui_xx_XX.yml
  3. Translate all strings
  4. Set language: xx_XX in config.yml
  5. Reload with /homeadmin reload

Color Codes

HorizonsHomes supports:

  • Legacy codes: &a, &b, &c, etc.
  • Hex colors: &#FF5555 or &x&F&F&5&5&5&5
  • Gradients: <gradient:FF5555:5555FF>Text</gradient>
  • MiniMessage: Full MiniMessage format support
Resource Information
Author:
----------
Total Downloads: 5
First Release: Jan 16, 2026
Last Update: Jan 16, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings