HuskHomesMenus

HuskHomesMenus

HuskHomes 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

- ⭐ Lightweight & focused — Teleport requests are confirmed through clean, readable menus instead of cluttered chat messages. - ⭐ Lightweight & focused — Display homes with information like server, world, dimension, and coordinates - ⭐ Lightweight & focused — Display warps with information like server, world, dimension, and coordinates - ⭐ Lightweight & focused — Complete control over how your menu looks - ⭐ Lightweight & focused — Fully compatible with HuskHomes commands (`/tpa`, `/tpahere`, `/tpaccept`, `/tpdeny`) — no learning curve. - ⭐ Lightweight & focused — Supports proxy environments (Velocity or BungeeCord) when HuskHomes is configured with MySQL/MariaDB. - ⭐ Lightweight & focused — Displays requester skins and request context in menus, including across servers. - ⭐ Lightweight & focused — 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

Home Menu

Warps Menu

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 [player]` | Send a teleport request to another player | `huskhomesmenus.tpa` | | `/tpahere` | `/tpahere [player]` | Ask a player to teleport to you | `huskhomesmenus.tpahere` | | `/tpaccept` | `/tpaccept [player]` | Accept the most recent or a specific teleport request | `huskhomesmenus.tpaccept` | | `/tpdeny` | `/tpdeny [player]` | 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 LuckPerms 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` | Allows toggling `/tpa` request reception | false | | `huskhomesmenus.tpaheretoggle` | Allows toggling `/tpahere` request reception | false | | `huskhomesmenus.tpauto` | Allows toggling automatic acceptance of teleport requests | false | | `huskhomesmenus.tpmenu` | Allows toggling the teleport request GUI menu | false | | `huskhomesmenus.home` | Allows opening the homes menu | false | | `huskhomesmenus.homemenu` | Allows toggling the homes GUI menu | false | | `huskhomesmenus.warp` | Allows opening the warps menu | false | | `huskhomesmenus.warpmenu` | Allows toggling the warps GUI menu | false | | `huskhomesmenus.*` | Grants all HuskHomesMenus permissions | op |

> and accept By default, players must be explicitly granted permissions to send and accept teleport requests.

Placeholders

HuskHomesMenus includes a built-in PlaceholderAPI expansion. No eCloud download is required.

Requires PlaceholderAPI 2.11.0+.

| Category | Placeholder | Description | |----------|-------------|-------------| | Boolean | `%huskhomesmenus_tpa%` | Returns whether `/tpa` requests are enabled | | Boolean | `%huskhomesmenus_tpahere%` | Returns whether `/tpahere` requests are enabled | | Boolean | `%huskhomesmenus_tpmenu%` | Returns whether the teleport menu is enabled | | Boolean | `%huskhomesmenus_tpauto%` | Returns whether auto-accept is enabled | | Text | `%huskhomesmenus_tpa_text%` | Returns `ON` or `OFF` for `/tpa` | | Text | `%huskhomesmenus_tpahere_text%` | Returns `ON` or `OFF` for `/tpahere` | | Text | `%huskhomesmenus_tpmenu_text%` | Returns `ON` or `OFF` for the teleport menu | | Text | `%huskhomesmenus_tpauto_text%` | Returns `ON` or `OFF` for auto-accept | | Icon | `%huskhomesmenus_tpa_icon%` | Returns ✔ or ✘ for `/tpa` | | Icon | `%huskhomesmenus_tpahere_icon%` | Returns ✔ or ✘ for `/tpahere` | | Icon | `%huskhomesmenus_tpmenu_icon%` | Returns ✔ or ✘ for the teleport menu | | Icon | `%huskhomesmenus_tpauto_icon%` | Returns ✔ or ✘ for auto-accept | | Pretty | `%huskhomesmenus_tpa_pretty%` | Colored status for `/tpa` | | Pretty | `%huskhomesmenus_tpahere_pretty%` | Colored status for `/tpahere` | | Pretty | `%huskhomesmenus_tpmenu_pretty%` | Colored status for the teleport menu | | Pretty | `%huskhomesmenus_tpauto_pretty%` | Colored status for auto-accept | | Combined | `%huskhomesmenus_requests_pretty%` | Combined `/tpa` and `/tpahere` status | | Combined | `%huskhomesmenus_all_pretty%` | Combined status of all teleport settings |

Configuration

HuskHomesMenus includes a simple configuration file allowing you to control:

- Teleport confirmation menu behavior - Automatic acceptance and denial logic - Proxy support and cross-server messaging - Cache behavior for remote player data

All options include safe defaults and can be adjusted without restarting the server.

Planned Features

The following features are planned or under consideration for future releases:

- Menus for Public Homes - Expanded menu customization (icons, text, colors)

Planned features are subject to change and will be implemented with a focus on performance, clarity, and network compatibility.

License

HuskHomesMenus is licensed under the Apache License, Version 2.0. See the `LICENSE` file for full license details.

Contributing

Bug reports, suggestions, and pull requests are welcome. Please keep contributions focused and aligned with the plugin’s lightweight design goals.

Credits

- Built as an extension for Chumbucket Network - Developed for use on the Chumbucket Network chumbucket.net

© 2025 Sorekill. Licensed under the Apache-2.0 License.