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
- Download the latest version
- Place HorizonsHomes.jar in your plugins/ folder
- Restart your server
- Edit configuration files in plugins/HorizonsHomes/
- Use /homeadmin reload to apply changes
Adding Languages
- Copy messages/messages_en_US.yml to messages/messages_xx_XX.yml
- Copy gui/gui_en_US.yml to gui/gui_xx_XX.yml
- Translate all strings
- Set language: xx_XX in config.yml
- 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