HuskHomesMenus

# HuskHomesMenus **HuskHomesMenus** is a lightweight companion plugin for **HuskHomes** that enhances teleport requests with clean, intuitive confirmation menus. It replaces chat-heavy workflows with clear GUI interactions while preserving the familiar HuskHomes command experience. Designed for modern Paper servers and proxy networks, HuskHomesMenus integrates seamlessly with HuskHomes and supports cross-server teleport requests when used in a shared database environment. ## Overview HuskHomesMenus does **not replace** HuskHomes. Instead, it wraps and extends HuskHomes teleport request commands with player-friendly menus, request toggles, and configurable behavior. Whether you run a single survival server or a multi-server proxy network, HuskHomesMenus improves clarity, reduces misclicks, and gives players control over how teleport requests are handled. ## Features - ⭐ **GUI-based teleport confirmations** — Teleport requests are confirmed through clean, readable menus instead of cluttered chat messages. - ⭐ **GUI-based home menu** — Display homes with information like server, world, dimension, and coordinates - ⭐ **GUI-based warps menu** — Display warps with information like server, world, dimension, and coordinates - ⭐ **GUI Customization** — Complete control over how your menu looks - ⭐ **HuskHomes-native command wrappers** — Fully compatible with HuskHomes commands (`/tpa`, `/tpahere`, `/tpaccept`, `/tpdeny`) — no learning curve. - ⭐ **Cross-server ready** — Supports proxy environments (Velocity or BungeeCord) when HuskHomes is configured with MySQL/MariaDB. - ⭐ **Player skins & context awareness** — Displays requester skins and request context in menus, including across servers. - ⭐ **Player-controlled toggles** — Allow players to opt out of requests, disable menus, or automatically accept teleport requests. - ⭐ **Lightweight & focused** — No bloated features — HuskHomesMenus does one thing well and stays out of the way. TP Menu !(https://cdn.modrinth.com/data/cached_images/ffd16a088f5afdba6a9cb9365e98649b465db008.png) Home Menu !(https://cdn.modrinth.com/data/cached_images/3895d57835fde68ea374064c45466c2a97b638ca.png) Warps Menu !(https://cdn.modrinth.com/data/cached_images/3be67d2f282336f0973396e19e6eaba055d0f11c.png) ## Requirements - Java 21 - Paper, Purpur, Folia or Spigot 1.21.x (or compatible forks) - HuskHomes (required dependency) - (Optional) Velocity or BungeeCord for proxy support - (Optional) PlaceholderAPI 2.11.0+ ## Installation 1. Install and configure **HuskHomes**. 2. Place `HuskHomesMenus.jar` into your server’s `plugins/` directory. 3. Restart the server. 4. (Optional) Adjust menu and request behavior in `config.yml`. ## Commands HuskHomesMenus provides GUI-enhanced wrappers and player preference toggles for HuskHomes teleport requests. | Command | Usage | Description | Permission | |--------|---------|------------|------------| | `/hmm reload` | `/hmm reload` | Reload the plugin | `huskhomesmenus.admin` | | `/hmm version` | `/hmm version` | Get the plugin version | `huskhomesmenus.admin` | | `/tpa` | `/tpa ` | Send a teleport request to another player | `huskhomesmenus.tpa` | | `/tpahere` | `/tpahere ` | Ask a player to teleport to you | `huskhomesmenus.tpahere` | | `/tpaccept` | `/tpaccept ` | Accept the most recent or a specific teleport request | `huskhomesmenus.tpaccept` | | `/tpdeny` | `/tpdeny ` | Deny the most recent or a specific teleport request | `huskhomesmenus.tpdeny` | | `/tpatoggle` | `/tpatoggle` | Toggle receiving `/tpa` requests | `huskhomesmenus.tpatoggle` | | `/tpaheretoggle` | `/tpaheretoggle` | Toggle receiving `/tpahere` requests | `huskhomesmenus.tpaheretoggle` | | `/tpauto` | `/tpauto` | Toggle automatic acceptance of teleport requests | `huskhomesmenus.tpauto` | | `/tpmenu` | `/tpmenu` | Toggle the teleport request confirmation menu | `huskhomesmenus.tpmenu` | | `/home` | `/home` | Opens the home menu | `huskhomesmenus.home` | | `/homes` | `/homes` | Opens the home menu | `huskhomesmenus.home` | | `/homemenu` | `/homemenu` | Toggles the homes menu | `huskhomesmenus.homemenu` | | `/warp` | `/warp` | Opens the warp menu | `huskhomesmenus.warp` | | `/warps` | `/warps` | Opens the warps menu | `huskhomesmenus.warp` | | `/warpmenu` | `/warpmenu` | Toggles the warps menu | `huskhomesmenus.warpmenu` | ## Permissions All permissions default to **false** unless otherwise noted and are intended for use with permission plugins such as **LuckPerms**. | Permission | Description | Default | |-----------|------------|---------| | `huskhomesmenus.admin` | Allows `/hmm reload` and `/hmm version` | false | | `huskhomesmenus.tpa` | Allows sending `/tpa` requests | false | | `huskhomesmenus.tpahere` | Allows sending `/tpahere` requests | false | | `huskhomesmenus.tpaccept` | Allows accepting teleport requests | false | | `huskhomesmenus.tpdeny` | Allows denying teleport requests | false | | `huskhomesmenus.tpatoggle`