Overview
HomesGUI Addon is a visual GUI layer built on top of the Advanced Teleport plugin. It replaces text-based home management with a fully interactive inventory GUI where players can teleport, delete, create, and customize icons for their homes.
Why Use This Addon?
Advanced Teleport is powerful but command-heavy. HomesGUI Addon gives players a visual, intuitive interface - reducing the learning curve and making home management feel like a natural part of the game.
Key Features
- Visual Home List - All homes displayed in a paginated inventory GUI
- One-Click Teleport - Left-click any home icon to teleport instantly
- In-GUI Deletion - Right-click a home to delete it without typing commands
- Create Home from GUI - New home button inside the GUI
- Custom Icons - Players choose any block or item as their home icon
- Coordinates & World Display - Each home shows its location details
- Main Home Indicator - Visual marker for the primary home
- Border Layout - Clean UI framing with configurable border slots
- Respects AT Settings - Cooldowns, warmups, and home limits from Advanced Teleport are still enforced
- Folia Compatible - Fully async-safe
Supported Versions
| Component | Requirement |
|---|---|
| Minecraft | Paper/Spigot 1.20+ |
| Java | Java 17+ |
| API Version | 1.20 |
| Folia | Supported |
Dependencies
| Plugin | Type | Purpose |
|---|---|---|
| Advanced Teleport | Required (soft) | Home data and teleport logic |
info
The addon will load without Advanced Teleport installed but home features will not function until AT is present.
Quick Example
# Open the homes GUI
/homesgui
# Reload addon config (admin)
/homesguireload
How It Works
- Player runs
/homesgui(or clicks a trigger from another plugin) - The addon queries the Advanced Teleport API for the player's homes
- Each home is displayed as a GUI slot with name, coordinates, and world
- Clicks are routed back through the Advanced Teleport teleport pipeline - cooldowns and warmups apply normally
- Custom icons are stored in a separate data file, independent of AT's data
What's Next?
- Quickstart Guide - Install in minutes
- Configuration Reference - Layout, icons, and display options
- Features - Full GUI behaviour walkthrough