dHomeGUI | GUI Home Management v1.0

What is dHomeGUI?
dHomeGUI replaces plain text home commands with a paginated, fully configurable inventory menu. Players set, edit, sort and teleport to their homes through icons instead of memorising names, while you keep full control over limits, costs, worlds and per home privacy. Built on DzusillCore, so storage and messages are consistent and the plugin stays cross version through the framework.

Documentation: https://dzusill.github.io/plugins/dhomegui/


Features

• Paginated homes menu — every home as an icon with world, coordinates, type and last visited lore, left click to teleport, right click to edit
• Per home customisation — rename, set any held item or player head as the icon, write a multiple line description, pick a cosmetic type and pin favourites to the top
• Default home — mark one home so bare /home sends the player straight there
• Visibility and whitelist — keep a home private or share it with a chosen list of players
• Search, sort and filters — anvil search box, sort modes, filter by world and filter by category
• Safe teleporting — warmup countdown that cancels on move or damage, cooldowns, an unsafe destination check, and /back to return
• Home limits — a default cap raised by permission tiers, with an unlimited bypass node
• Economy slots — optional Vault charges for setting, teleporting or renaming, plus a Buy Slots menu to purchase more home space
• World rules — allow or block worlds, whitelist only mode, separate nether and end permissions, and optional WorldGuard region respect
• Storage and import — MySQL or PostgreSQL through DzusillCore with a YAML fallback, JSON backups, and an EssentialsX home importer
• Integrations — Vault, PlaceholderAPI, WorldGuard, LuckPerms and EssentialsX, all optional and loaded only when present
• Folia ready — schedules through a platform layer so it runs on Folia as well as Paper and Spigot

Commands

• /homes — open the homes menu (aliases: homelist, homegui · dhomegui.use)
• /home [name] — teleport to a home, or the default home with no name (alias: h · dhomegui.use)
• /sethome [name] — create a home at your location (alias: createhome · dhomegui.sethome)
• /delhome [name] — delete one of your homes (alias: removehome · dhomegui.delhome)
• /back — return to your previous location after a teleport (dhomegui.back)
• /adminhomes — browse and manage any player's homes in a GUI (dhomegui.admin)
• /dhomeadmin — admin tools: reload, tp, delete, import (aliases: ahomes, homesadmin · dhomegui.admin)

Permissions

• dhomegui.use — open the GUI and teleport (default: all)
• dhomegui.sethome — create homes (default: all)
• dhomegui.delhome — delete your homes (default: all)
• dhomegui.back — use /back (default: all)
• dhomegui.homes.unlimited — bypass the home count cap (default: op)
• dhomegui.world.nether / dhomegui.world.end — set homes in those worlds (default: all)
• dhomegui.bypass.cooldown / cost / worlds / warmup — skip the matching restriction (default: op)
• dhomegui.admin — manage any player's homes and reload (default: op)

Use a permissions plugin such as LuckPerms to grant home tiers like dhomegui.homes.5 for higher caps.


Requirements

• Paper, Spigot, Purpur or Folia 1.21.1 or newer
• DzusillCore installed on the server (required framework)
• Java 17 or newer
• Vault and an economy plugin only if you enable economy features (optional)

Setup

1. Install DzusillCore, then drop dHomeGUI into your plugins/ folder and restart
2. Edit plugins/dHomeGUI/config.yml for limits, worlds and teleport timing
3. Set up storage in plugins/dHomeGUI/database.yml (MySQL or PostgreSQL, or leave YAML)
4. Optionally turn on economy and tune the costs, shown below

Economy:
Enabled: false
Currency: Vault
SlotsPerPurchase: 1
Costs:
SetHome: 0
Teleport: 0
Rename: 0
BuySlot: 1000