HyMenu

HyMenu

为您的玩家提供一个菜单，将重要命令整合在美观的UI中，并让他们了解可用的功能。

生活质量

HyMenu

提升您的用户体验，为您的服务器提供一个沉浸式、美观的界面，将所有重要命令整合在一起。将您的服务器提升到新的水平，告别老式命令！您可以在游戏内的配置界面中编辑所有内容。无需编辑配置文件。

安装说明

正确设置

解压 HyMenuBundle.zip

移动 HyMenu-*.jar 和 HyMenuAssets.zip 到您的 mods/ 文件夹中

忽略 manifest.json

mods/
  |
  ├─── HyMenu-*.jar
  |
  ├─── HyMenuAssets.zip
  |
  └─── your other mods

自定义图标和自定义Logo

HyMenu 会将 HyMenuAssets.zip 的内容解压到 HyMenuAssets 目录，并且不会覆盖现有文件。 如果您添加了名称与现有图标不同的新图标，它们在更新后也不会被覆盖。

HyMenuAssets
    |
    ├─── Common/UI/Custom/ ┬─ Icons/    <- 在此处添加您自己的图标 *
    |
    └─ Logo.png  <- 替换为您自己的Logo *
                           
      * 也适用于服务器运行时，更改后会立即更新。

为您的用户提供所有需要的按钮，让他们体验无需命令的体验！

-> 这是一个示例，需要进行配置！HyMenu 本身不提供任何命令，只提供界面和按钮。 它用于运行来自其他模组和插件中的命令和打开界面。

这个模组/插件让您可以选择哪些命令是您的玩家能够看到的，而无需阅读网站或Discord频道。

命令从未对您的日常用户如此易于访问！

[Join the discord server to view FAQ, get faster Support, make your feature suggestions or report bugs.]

[Thanks to anyone helping me with their Feedback!]

功能

进行中

待办事项：

✅ = 已完成。
🧑‍🍳= 烹饪中..
⬜ = 正在准备材料

  • ✅ - 可配置的"Alt"按键绑定（使用或不使用 :D）

  • ✅ - 管理员配置界面，通过UI配置所有内容

  • ✅ - 可自定义和可浏览的图标

  • ✅ - 编辑项目并重新排序列表

  • ✅ - 配置概览页、传送点列表等的可见性

  • ✅ - 多个可配置的概览类型"标签页"

  • ✅ - 以玩家/服务器身份运行

  • ✅ - 一个按钮运行多个命令

  • ✅ - 简单的占位符，例如 {player}, {uuid} 用于命令

  • ✅ - 命令中完全支持 PAPI (PlaceholderAPI)

  • ✅ - 重命名概览/传送点/命令/自定义页面

  • ✅ - 概览类型页面的按钮大小可更改

  • ✅ - 通过按钮上的文本框输入参数

  • ✅ - 在配置UI中移动额外的页面

  • ✅ - 使用权限隐藏页面上的按钮

  • ✅ - 在配置UI中按标题折叠按钮，以便在编辑/添加内容时更好地聚焦，无需过多滚动

  • ✅ - 向用户发送消息（在行首使用 :）

  • ✅ - 在用户聊天中发送可点击的超链接（自动识别 http:// 和 https://）

  • ✅ - 通过命令配置和打开页面，这些页面最初无法从顶部栏访问

  • ✅ - 黑名单权限（无法打开菜单）

  • ✅ - 白名单权限（忽略黑名单）

  • ✅ - 更改打开菜单的命令

  • ✅ - 为按钮和页面设置多个权限

  • ✅ - 可配置的每个玩家的个人页面（快捷方式/收藏夹）

  • ✅ - 每个玩家的配置文件

  • ✅ - 配置UI中的重新加载按钮

  • ✅ - 可更改的左上角Logo

  • ✅ - 添加您自己的图片作为图标

  • ✅ - 无需重启服务器即可动态重新加载图标/Logo

  • ✅ - 本地化（进行中）

  • ✅ - 创建多个不同的菜单

  • ✅ - 通过占位符评估禁用按钮（需要PAPI）

  • ✅ - 为命令执行添加延迟

  • ✅ - 为链式多个命令之间添加延迟

  • ✅ - 更改按钮大小、图标大小、文本大小、按钮之间的水平间距

  • ✅ - 为按钮添加描述、工具提示和禁用时的工具提示

  • ✅ - 每个菜单和每个用户的快捷方式/收藏夹页面

  • 🧑‍🍳 - 重新排序所有页面，无论类型

  • ⬜ - 选择不同的按钮类型（设计、可用性）-> 服务器按钮

  • ⬜ - 概览类型之外的其他通用页面 -> 规则/信息页面，欢迎屏幕

  • ⬜ - 命令页面的配置 -> 不同样式，可配置选项（隐藏权限）

  • ⬜ - 需要为按钮使用设置货币

⚠️ - 欢迎在评论区提出建议

概览页面

[-> 可以完全隐藏，或仅通过配置的权限可见]

一个概览页面，您可以在这里配置您的用户应该能看到哪些来自其他插件的命令快捷方式。

用户/快捷方式页面 + 每个玩家配置

[-> 可以完全隐藏/禁用]

让玩家选择他们最常用的内容，并将其添加到他们自己的快捷方式页面。它会尊重按钮及其父标签/页面的权限，您甚至可以限制每个按钮的快捷方式使用。 当您更改按钮时，它们也会在用户页面上更新（包括权限等），因此如果用户无法使用/看到该按钮，它将被从他们的页面中移除，直到他们重新获得该权限。

[选择你想看的内容]

作为管理员，您可以启用/禁用此功能：

自定义页面

[-> 可以完全隐藏，或仅通过配置的权限可见]

多个概览类型的页面，您可以在这里配置名称以及您的用户应该能看到哪些来自其他插件的命令快捷方式。您可以配置命令（支持占位符！），甚至可以单独更改每个按钮的大小。

打开自定义页面的命令（即使是那些在顶部栏中不可见的页面）

示例/用法：

  • /open pageidwithoutspaces

  • /open "pageidwithoutspaces"

  • /open 'page id with spaces'

  • /open "page id with spaces" 权限：b3cks.hymenu.command.open

  • /open "page id" --player=playername -> 为玩家打开

  • -> 可从控制台使用，但仍会检查玩家是否有权打开 权限：b3cks.hymenu.command.open.other

  • /open "page id" --player=playername --ignorePermission=true

  • -> 为指定玩家打开菜单，不考虑权限 权限：b3cks.hymenu.command.open.other.bypass

  • 别名：openpage, opencustom, opencustompage, opensubmenu, hymenupage

  • 如果页面ID包含空格，请始终使用 " " 或 ' ' 括起来 - 两者都有效

  • 像任何其他命令一样与我的按钮配合使用

  • 现在您可以创建无限子菜单，并使用命令/按钮在它们之间导航

  • 您现在可以将鼠标悬停在配置UI标题中的名称上查看页面ID，请使用这些ID而不是名称

  • 编辑ID的功能将在稍后添加，暂时它们会采用您最初赋予的名称，但不会跟踪更改。

  • 因此，在添加一个名为"test"的页面后，您只能再添加一个名为"test1"的页面，然后将其重命名回"test"，这样它们就有了相同的名称。

  • 每个按钮现在都可以接受参数。

    • 您可以勾选"Accept Arguments"，这会在按钮上显示一个文本框。您可以在这里编写应作为参数添加到命令中的内容。
    • 在命令内部使用 {arg} 占位符来替换为输入参数。
    • 如果您没有指定 {arg} 占位符，如果链中有多个命令，参数将被添加到每个命令的末尾。
    • 如果您指定了 {arg} 占位符，则只会替换此占位符。如果链中有更多命令，它只会查找 {arg} 占位符，并忽略没有它的命令。那些命令将完全按照指定执行。
    • 参数内部甚至可以使用其他占位符！

[带参数框的示例]

点击按钮时向用户发送包含超链接和颜色的消息

  • 以 ":" 开头的命令行将变为消息
  • 支持十六进制颜色 (#123456, #ffffff,...)
  • 在按钮消息中使用超链接
  • 使用消息中的占位符（内部 & PAPI）
  • 如果消息中包含超链接，它会自动计为消息，行首无需 ":" 前缀

以下是一些有效示例：

[示例图片]

     https://google.de
     https://google.de 是一个测试
     #00ffff访问 #00ffffhttp://google.de 以 #6600ff阅读规则
     : #E2B40D{arg}
     :访问 #ff00ffhttp://test.de 以 #6600ff阅读规则
     :这是 #E2B40D太棒了 #ffffff来自 #97B237的消息 #ffffff给 #00ff00玩家 ({player})
     :#ff55ff全部一种颜色
     :无颜色
     :#00ff00有效 #ffffff如同 #ff0000预期 #0000ff ！！！！！

传送点列表

[-> 可以完全隐藏，或仅通过配置的权限可见]

一个方便且快速访问的传送点列表

使用默认的 Hytale 传送点权限

用户命令

[-> 可以完全隐藏，或仅通过配置的权限可见]

以及一个命令列表，但它们会通过权限和配置进行过滤。 这意味着您的用户只能看到您指定的命令，以避免看到太多永远没人会用的命令。您还会获得一个额外的按钮，可以直接使用命令而无需先将其发送到聊天中。

由于目前还没有自动补全功能，并且并非每个插件/模组都提供界面，这可能是一个非常有用的工具。

配置界面 - 您的管理工具

权限： b3cks.hymenu.configui

无需手动编辑配置文件或通过命令配置！您可以在编辑配置界面内完成所有操作。

将鼠标悬停在命令列表上，查看命令中的占位符会解析成什么

需要安装PAPI以及所需的扩展才能使'%'占位符生效

将鼠标悬停在标签页名称上查看设置的权限：

并在编辑名称时进行编辑

按照您喜欢的方式配置每个按钮！您甚至可以在之后进行编辑

权限

重要：

用户： b3cks.hymenu.command.menu -> 需要用于使用按键绑定打开菜单 b3cks.hymenu.command.menu.hymenu -> 将"hymenu"替换为菜单的名称 -> 需要用于使用其各自的配置命令打开菜单 b3cks.hymenu.command.open -> 通过命令打开页面

管理员： b3cks.hymenu.configui -> 需要用于打开配置界面 b3cks.hymenu.command.menu.reload -> 需要用于完整重载 b3cks.hymenu.command.menu.hymenu.reload -> 需要用于菜单重载（将"hymenu"替换为菜单名称） b3cks.hymenu.command.open.other -> 通过命令为他人打开页面 b3cks.hymenu.command.open.other.bypass -> 通过命令为他人打开页面，并可选择忽略权限

运行命令 让每个人都能使用菜单，无需像这样添加额外的组。 如果您的服务器支持创造模式，您还应该运行

/perm group add Adventure b3cks.hymenu.command.menu (Alt键绑定权限) /perm group add Adventure b3cks.hymenu.command.menu.hymenu (默认菜单权限)

/perm group add Creative b3cks.hymenu.command.menu (Alt键绑定权限) /perm group add Creative b3cks.hymenu.command.menu.hymenu (默认菜单权限)

命令

默认情况下，它使用"Alt"键的变通方法来打开菜单，无需输入命令。

此行为可以在设置中关闭。

感谢 terantia2024

对于那些出于任何原因不想使用'alt'键的人，您可以使用 Okey 模组通过按键'o'来打开它，但您需要按如下方式更改 Okey 配置文件和 permission.json：

在 mods/jox.works_Okey/OkeyConfig.json 中：

"command": "menu", (~line 29) "runAs": "PLAYER", (~line 52)

在 permission.json 中：

{
  "users": {
    "player-uuid": {
      "groups": [
        "Adventure",
        "MenuUsers"
      ]
    }
  },
  "groups": {
    "Default": [],
    "OP": [
      "*"
    ],
    "MenuUsers": [
      "b3cks.hymenu.command.menu"
    ]
  }
}

不言而喻，组名可以任意设置，只需确保它为玩家使用正确的 hymenu 命令并在用户组中调用它即可。

或者，您可以使用命令 "/menu" 打开它

/menu -> 打开 HyMenu /hym -> 打开 HyMenu

/hymenu open -> 打开 HyMenu

/hym r -> 重载 HyMenu /hym reload -> 重载 HyMenu /menu r -> 重载 HyMenu /menu reload -> 重载 HyMenu /hymenu r -> 重载 HyMenu /hymenu reload -> 重载 HyMenu

/open pageidwithoutspaces menuname /open "pageidwithoutspaces" menuname /open 'page id with spaces' menuname /open "page id with spaces" menuname 权限：b3cks.hymenu.command.open /open "page id" menuname --player=playname -> 为玩家打开 -> 可从控制台使用，但仍会检查玩家是否有权打开页面 权限：b3cks.hymenu.command.open.other /open "page id" --player=playname --ignorePermission=true -> 为指定玩家打开菜单，不考虑权限 权限：b3cks.hymenu.command.open.other.bypass 别名：openpage, opencustom, opencustompage, opensubmenu, hymenupage 如果页面ID包含空格，请始终使用 " " 或 ' ' 括起来 - 两者都有效 像任何其他命令一样与我的按钮配合使用

[If you want to support my work you can buy me a coffee 🙂]