Skip to main content

Features

Home List GUI​

When a player opens /homesgui, the addon queries Advanced Teleport for all of their set homes and displays each one as an inventory slot. The slot shows:

  • Home name (as item display name)
  • Coordinates (X, Y, Z) in the lore — if show-coordinates: true
  • World name — if show-world-name: true
  • Main home indicator text (e.g. "★ Main Home") for the primary home

If the player has no homes set, a friendly "No homes set" message is displayed instead of an empty GUI.

Teleporting​

Left-clicking any home icon triggers the Advanced Teleport teleport pipeline:

  • AT's configured warmup delay applies (player must stay still)
  • AT's cooldown between teleports is respected
  • AT's distance or world restrictions are honoured
  • All feedback messages (warmup started, teleport complete) come from Advanced Teleport

The addon does not bypass any AT setting.

Deleting Homes​

Right-clicking a home icon opens a confirmation step (or deletes immediately, depending on config). Deletion is performed through the Advanced Teleport API, so home count limits update correctly.

Creating Homes from GUI​

The Create New Home button (configurable slot, default slot 49) sets a new home at the player's current location. The player is prompted to enter a name in chat. The home appears in the GUI immediately after creation.

Custom Icons​

When custom-icons.enabled: true, players can click a special icon-selection button on any home slot to pick a custom block or item as the visual icon. Icons are stored in home-icons.yml and persist across sessions.

The default icon for homes without a custom icon is configurable (default-icon: RED_BED).

Border Layout​

With show-borders: true, the GUI uses a 7-column inner layout surrounded by decorative glass panes, giving a clean framed appearance. This reduces the homes-per-page from 45 to 35.

Disable borders for a maximalist 45-slot layout if players have many homes.

Pagination​

When a player has more homes than fit on one page, Previous and Next navigation buttons appear. Page state is maintained per-player during the session.

Refresh Button​

The Refresh button re-queries Advanced Teleport for the latest home data and redraws the GUI. Useful if a player just set a home in AT and wants to see it without closing and reopening the GUI.

Integration with Advanced Teleport​

The addon only ever interacts with AT through its public API. This means:

  • All AT configuration (home limits, warmups, cooldowns, worlds) remains in full control
  • The addon does not store home coordinates — that data lives in AT's storage
  • Compatible with all AT storage backends (flat file, MySQL, etc.)