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
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
- Install and configure HuskHomes.
- Place
HuskHomesMenus.jarinto your server’splugins/directory. - Restart the server.
- (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 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 | 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 |
Note: 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 HuskHomes
- Developed for use on the Chumbucket Network chumbucket.net
© 2025 Sorekill. Licensed under the Apache-2.0 License.