🏠 HomeGui

A lightweight, feature-rich home plugin for Minecraft SMP servers.
Set, manage and teleport to your homes through a clean GUI or simple commands.

---

✨ Features

🏡 Home System

Set named homes and teleport to them instantly via command or through an interactive GUI. A maximum number of homes per player is configurable.

🖥️ Interactive GUI

Open your homes list with /home — navigate through pages, and click a home to teleport. Each home displays its coordinates and world.

⚠️ Safe Teleport System

The plugin checks whether a home destination is safe before teleporting. If unsafe teleport is enabled in the config, the player must confirm the teleportation with /confirmhome. Pending confirmations expire after a configurable delay.

🛡️ Admin Commands

Operators and players with the hg.admin permission can teleport to or delete any player's home using player:home syntax with full tab-completion.

⚙️ Full Config Support

Customize the prefix, maximum homes per player, teleportation cooldown, teleportation cancelation, unsafe teleport behavior, and confirmation expiry delay — all from config.yml. Reload without restarting with /homereload.

---

📋 Commands

Command	Description
/home	Open the homes GUI
/home <name>	Teleport to a specific home
/sethome <name>	Set a home at your current location
/delhome <name>	Delete one of your homes
/confirmhome	Confirm teleportation to an unsafe home
/homeadmin <player>:<home>	Teleport to any player's home
/delhomeadmin <player>:<home>	Delete any player's home
/homereload	Reload the config
/back	Return back to the last position

---

🔐 Permissions

Permission	Description
hg.admin	Access to /homeadmin, /delhomeadmin and /homereload

---

⚙️ Config

# HomeGui Configuration

# Maximum number of homes per player (default: 3)
max-homes: 3

# Plugin prefix
prefix: "§x§0§0§8§D§F§F§l§nH§x§2§1§7§6§F§F§l§no§x§4§3§5§E§F§F§l§nm§x§6§4§4§7§F§F§l§ne§x§8§5§2§F§F§F§l§nG§x§A§7§1§8§F§F§l§nU§x§C§8§0§0§F§F§l§nI "

# Allow unsafe teleportation (teleporting to dangerous locations like inside blocks)
# If false, the plugin will check if the destination is safe before teleporting
allow-unsafe-teleport: false

# Pending teleport expiry delay in seconds (default: 60) // ONLY IF "allow-unsafe-teleport" IS SET ON FALSE.
confirm-expiry: 60

# Cooldown between teleportations in seconds (0 = disabled)
teleport-cooldown: 5

# Warmup delay before teleporting in seconds (0 = disabled)
# The player must stand still during this delay
teleport-warmup: 3

# Cancel the warmup if the player moves
cancel-on-move: true

# Cancel the warmup if the player takes damage
cancel-on-damage: true

# Enable /back command (returns to position before last home teleport)
enable-back: true

---

📦 Installation

Drop the .jar into your plugins/ folder and restart your server. No dependencies required.

---

🔧 Compatibility

• ✅ Paper / Spigot
• ✅ Minecraft 1.21.x // 26.x.x

---

Made with ❤️ by Gregwll