Installation

Requirements

Requirement	Version
Minecraft Server	Paper or Spigot 1.20+
Java	17 or higher
Advanced Teleport	Required (soft dependency — loads without it, but non-functional)

Installation Steps

1. Ensure Advanced Teleport Is Installed

This addon is a companion to Advanced Teleport. Install and configure AT first.

2. Download the Addon

Obtain AdvancedTeleportAddon.jar from the releases page.

3. Place the JAR

server/
└── plugins/
    ├── AdvancedTeleport.jar    ← must already be here
    └── AdvancedTeleportAddon.jar   ← place here

4. Start the Server

Config is generated on first run:

plugins/
└── HomesGUI-Addon/
    ├── config.yml
    └── home-icons.yml   ← stores per-player custom icons

5. Verify

Console output:

[HomesGUI-Addon] Advanced Teleport detected — hooking in!
[HomesGUI-Addon] Plugin enabled!

If you see a warning about Advanced Teleport not found, double-check that AdvancedTeleport.jar is in plugins/ and fully loaded.

File Layout

File	Purpose
config.yml	GUI layout, display options, command aliases
home-icons.yml	Per-player custom home icons (auto-managed)

Updating

1. Stop the server
2. Replace the addon JAR
3. Start the server — both config files are preserved

Uninstalling

1. Stop the server
2. Remove AdvancedTeleportAddon.jar from plugins/
3. Optionally delete plugins/HomesGUI-Addon/ to remove config and icon data