HomeGUI - Home Gui for EssentialsX

ECHomeGUI

ECHomeGUI is a plugin for Spigot / Paper servers that takes the home system to the next level with a fully customizable graphical interface, perfect for survival servers, SMPs, or networks that want a modern and user-friendly way to manage player homes.

Works on Minecraft 1.16 → 1.21.8, with full support for compatible forks (Purpur, etc.).

This project is a fork of the original TechnoVision plugin, updated and expanded for modern versions of Minecraft with improved performance and new customization features.

---

✨ Key Features

• Full GUI menu to create, manage, and teleport to homes.
• Customizable icons for each home (choose your own block/item).
• Flexible configuration in config.yml and lang.yml with HEX color support.
• Advanced permissions system to restrict actions or grant admin control.
• Configurable sounds & particles for teleporting, creating, and deleting homes.
• Extra GUI buttons: go back to menu, close inventory, or run commands.
• Teleport cooldowns & cancelation when moving or taking damage.
• Title, subtitle, and actionbar support without intrusive prefixes.
• Full EssentialsX compatibility (optional).
• Lightweight & optimized: built to avoid performance impact.

---

📖 Main Commands

• /home → Opens your homes menu.
• /home <player|home> → Teleports to a specific home or opens another player’s menu.
• /homegui reload → Reloads the configuration without restarting the server.
• /homeadmin <player|reload> → Admin tools to manage other players’ homes.

---

🔑 Permissions

• homegui.admin → Full access to /homeadmin.
• homegui.admin.reload → Reload the configuration.
• homegui.admin.view → View and manage other players’ homes.

---

⚙️ Quick Configuration

• Main GUI

  • gui-main-header: menu title.
  • size: inventory size.
  • home-slots: home slot positions.
  • filler-item: filler item for empty spaces.
  • create-home-button: button to create new homes.

• Homes

  • title-home: name and color of each home.
  • home-lore: extra info with placeholders like {world}, {location}, {player}.

• Extras

  • extra-buttons: customizable buttons (command:, close, empty).

• Chat

  • Prompts the player to enter a name for the home.
  • Type "cancel" to abort.

• Messages

  • Fully editable in lang.yml.
  • Supports & and HEX colors (&#rrggbb).

• Effects

  • Customize sounds and particles for all key actions.

---

🎮 Example Flow

1. The player opens the GUI with /home.
2. Selects an empty slot and creates a new home.
3. Types a name in chat (example: main_base).
4. Customizes the home icon directly from the GUI.
5. Left-click → instant teleport.

---

🔧 Dependencies

• Optional: EssentialsX (integration with classic /home commands).