HuskHomesMenus
HuskHomesMenus 是 HuskHomes 的一款轻量级辅助插件,通过简洁直观的确认菜单来增强传送请求功能。它将原本依赖大量聊天信息的操作流程替换为清晰的 GUI 交互体验,同时保留了熟悉的 HuskHomes 命令操作方式。
专为现代 Paper 服务器及代理网络设计,HuskHomesMenus 能够与 HuskHomes 无缝集成,并在共享数据库环境下支持跨服务器的传送请求。
概述
HuskHomesMenus 并不替代 HuskHomes。相反,它通过玩家友好的菜单、请求开关和可配置的行为,对 HuskHomes 的传送请求命令进行了包装和扩展。
无论是运行单人生存服务器还是多服务器代理网络,HuskHomesMenus 都能提高清晰度,减少误触,并让玩家掌控传送请求的处理方式。
功能
- ⭐ 基于 GUI 的传送确认 — 通过清晰易读的菜单确认传送请求,取代杂乱的聊天信息。
- ⭐ 基于 GUI 的家目录菜单 — 显示家的详细信息,包括所属服务器、世界、维度及坐标。
- ⭐ 基于 GUI 的传送点菜单 — 显示传送点的详细信息,包括所属服务器、世界、维度及坐标。
- ⭐ GUI 自定义 — 完全控制菜单的外观样式。
- ⭐ 原生 HuskHomes 命令封装 — 完全兼容 HuskHomes 命令(
/tpa、/tpahere、/tpaccept、/tpdeny),无需学习成本。
- ⭐ 支持跨服务器 — 当 HuskHomes 配置了 MySQL/MariaDB 时,支持代理环境(Velocity 或 BungeeCord)。
- ⭐ 玩家皮肤与上下文感知 — 在菜单中显示发起者的皮肤及请求上下文,即使跨服务器也能正常显示。
- ⭐ 玩家控制的开关 — 允许玩家拒绝接收请求、禁用菜单或自动接受传送请求。
- ⭐ 轻量且专注 — 没有臃肿的功能——HuskHomesMenus 只做一件事,并且做得很好,不会干扰其他插件。
TP Menu

Home Menu

Warps Menu

要求
- Java 21
- Paper, Purpur, Folia 或 Spigot 1.21.x(或兼容分支)
- HuskHomes(必需依赖)
- (可选)Velocity 或 BungeeCord 用于代理支持
- (可选)PlaceholderAPI 2.11.0+
安装
- 安装并配置 HuskHomes。
- 将
HuskHomesMenus.jar 放入服务器的 plugins/ 目录。
- 重启服务器。
- (可选)在
config.yml 中调整菜单和请求行为。
命令
HuskHomesMenus 为 HuskHomes 的传送请求提供了增强 GUI 的命令封装及玩家偏好设置开关。
| 命令 |
用法 |
描述 |
权限 |
/hmm reload |
/hmm reload |
重载插件 |
huskhomesmenus.admin |
/hmm version |
/hmm version |
获取插件版本 |
huskhomesmenus.admin |
/tpa |
/tpa [player] |
向其他玩家发送传送请求 |
huskhomesmenus.tpa |
/tpahere |
/tpahere [player] |
请求玩家传送到你身边 |
huskhomesmenus.tpahere |
/tpaccept |
/tpaccept [player] |
接受最近或特定的传送请求 |
huskhomesmenus.tpaccept |
/tpdeny |
/tpdeny [player] |
拒绝最近或特定的传送请求 |
huskhomesmenus.tpdeny |
/tpatoggle |
/tpatoggle |
切换是否接收 /tpa 请求 |
huskhomesmenus.tpatoggle |
/tpaheretoggle |
/tpaheretoggle |
切换是否接收 /tpahere 请求 |
huskhomesmenus.tpaheretoggle |
/tpauto |
/tpauto |
切换自动接受传送请求 |
huskhomesmenus.tpauto |
/tpmenu |
/tpmenu |
切换传送请求确认菜单 |
huskhomesmenus.tpmenu |
/home |
/home |
打开家目录菜单 |
huskhomesmenus.home |
/homes |
/homes |
打开家目录菜单 |
huskhomesmenus.home |
/homemenu |
/homemenu |
切换家目录菜单 |
huskhomesmenus.homemenu |
/warp |
/warp |
打开传送点菜单 |
huskhomesmenus.warp |
/warps |
/warps |
打开传送点菜单 |
huskhomesmenus.warp |
/warpmenu |
/warpmenu |
切换传送点菜单 |
huskhomesmenus.warpmenu |
权限
除非另有说明,所有权限默认均为 false,旨在配合 LuckPerms 等权限插件使用。
| 权限 |
描述 |
默认值 |
huskhomesmenus.admin |
允许执行 /hmm reload 和 /hmm version |
false |
huskhomesmenus.tpa |
允许发送 /tpa 请求 |
false |
huskhomesmenus.tpahere |
允许发送 /tpahere 请求 |
false |
huskhomesmenus.tpaccept |
允许接受传送请求 |
false |
huskhomesmenus.tpdeny |
允许拒绝传送请求 |
false |
huskhomesmenus.tpatoggle |
允许切换 /tpa 请求接收状态 |
false |
huskhomesmenus.tpaheretoggle |
允许切换 /tpahere 请求接收状态 |
false |
huskhomesmenus.tpauto |
允许切换自动接受传送请求 |
false |
huskhomesmenus.tpmenu |
允许切换传送请求 GUI 菜单 |
false |
huskhomesmenus.home |
允许打开家目录菜单 |
false |
huskhomesmenus.homemenu |
允许切换家目录 GUI 菜单 |
false |
huskhomesmenus.warp |
允许打开传送点菜单 |
false |
huskhomesmenus.warpmenu |
允许切换传送点 GUI 菜单 |
false |
huskhomesmenus.* |
授予所有 HuskHomesMenus 权限 |
op |
注意: 默认情况下,玩家必须被显式授权才能发送 和接受 传送请求。
占位符
HuskHomesMenus 内置了 PlaceholderAPI 扩展模块,无需从 eCloud 下载。
需要 PlaceholderAPI 2.11.0+。
| 类别 |
占位符 |
描述 |
| 布尔值 |
%huskhomesmenus_tpa% |
返回 /tpa 请求是否已启用 |
| 布尔值 |
%huskhomesmenus_tpahere% |
返回 /tpahere 请求是否已启用 |
| 布尔值 |
%huskhomesmenus_tpmenu% |
返回传送菜单是否已启用 |
| 布尔值 |
%huskhomesmenus_tpauto% |
返回自动接受是否已启用 |
| 文本 |
%huskhomesmenus_tpa_text% |
返回 /tpa 的 ON 或 OFF |
| 文本 |
%huskhomesmenus_tpahere_text% |
返回 /tpahere 的 ON 或 OFF |
| 文本 |
%huskhomesmenus_tpmenu_text% |
返回传送菜单的 ON 或 OFF |
| 文本 |
%huskhomesmenus_tpauto_text% |
返回自动接受的 ON 或 OFF |
| 图标 |
%huskhomesmenus_tpa_icon% |
返回 /tpa 的 ✔ 或 ✘ |
| 图标 |
%huskhomesmenus_tpahere_icon% |
返回 /tpahere 的 ✔ 或 ✘ |
| 图标 |
%huskhomesmenus_tpmenu_icon% |
返回传送菜单的 ✔ 或 ✘ |
| 图标 |
%huskhomesmenus_tpauto_icon% |
返回自动接受的 ✔ 或 ✘ |
| 美观格式 |
%huskhomesmenus_tpa_pretty% |
/tpa 的彩色状态 |
| 美观格式 |
%huskhomesmenus_tpahere_pretty% |
/tpahere 的彩色状态 |
| 美观格式 |
%huskhomesmenus_tpmenu_pretty% |
传送菜单的彩色状态 |
| 美观格式 |
%huskhomesmenus_tpauto_pretty% |
自动接受的彩色状态 |
| 组合 |
%huskhomesmenus_requests_pretty% |
/tpa 和 /tpahere 状态的组合 |
| 组合 |
%huskhomesmenus_all_pretty% |
所有传送设置的组合状态 |
配置
HuskHomesMenus 包含一个简单的配置文件,允许你控制:
- 传送确认菜单的行为
- 自动接受与拒绝逻辑
- 代理支持与跨服务器消息传递
- 远程玩家数据的缓存行为
所有选项均包含安全默认值,并且可以在不重启服务器的情况下进行调整。
计划中的功能
以下功能正在规划中或考虑在未来的版本中推出:
- 公共家园菜单
- 扩展的菜单自定义功能(图标、文本、颜色)
计划中的功能可能会发生变化,并将以性能、清晰度和网络兼容性为重点进行实现。
许可证
HuskHomesMenus 采用 Apache License, Version 2.0 许可。
有关完整的许可证详情,请参阅 LICENSE 文件。
贡献
欢迎提交错误报告、建议和拉取请求。
请确保贡献内容保持聚焦,并与插件轻量级设计目标保持一致。
鸣谢
- 作为 HuskHomes 的扩展构建
- 为在 Chumbucket Network chumbucket.net 上使用而开发
© 2025 Sorekill. Licensed under the Apache-2.0 License.
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.jar into your server’s plugins/ 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧