更好 /求助

图片

一个 Minecraft 模组，用更清晰、可交互、分页的列表取代了 /help。为命令和参数添加了描述，并包含来自其他模组的可选元数据。

文档 GitHub Modrinth CurseForge Ko-fi

✨ 特性

原版 /help 会向你抛出一大段难以阅读的文字，且几乎没有有用的细节。Better /help 用玩家真正能用的东西取代了它。

• 清晰的分页命令列表：逐页浏览命令，而不是在一大段文字中滚动
• 交互式输出：悬停查看详情，点击切换页面
• 命令和参数的描述：覆盖了大多数原版命令，参数也可以有自己的描述
• 易于集成：其他模组只需使用其语言文件即可添加描述和元数据（如主页链接）
• 归属显示：当描述来自其他模组时，玩家可以看到该命令来自哪个模组
• 建议提示：/help <command...> 会自动补全，就像输入命令本身一样，不同于原版 /help

⌨️ 使用方法

命令	作用
/help	显示分页的命令列表
/help <command...>	显示命令或参数的帮助信息

示例：

/help
/help gamemode
/help advancement grant @s everything

💻 模组开发者指南

你可以通过语言文件（例如 assets/<mod_id>/lang/en_us.json）添加描述和其他元数据。Better /help 会在服务器启动时扫描已安装的模组以查找这些键。翻译在服务器端解析。

命令或参数描述

当你添加命令描述时，Better /help 会将该命令归属于你的模组：

{
  "examplemod.commands.examplecommand.description": "Description of your command."
}

将 examplemod 替换为你的模组 ID，examplecommand 替换为你的命令名称。

你可以省略模组 ID 前缀，但由于翻译键冲突，不建议这样做：

{
  "commands.examplecommand.description": "Description of your command."
}

你还可以描述嵌套的字面量和参数。路径片段是 Brigadier 节点名称（即你传递给 Commands.literal("name") 和 Commands.argument("name", ...) 的相同字符串，而不是玩家输入的内容）：

{
  "examplemod.commands.examplecommand.targets.description": "Who the command applies to."
}

例如，注册为 Commands.argument("targets", EntityArgument.players()) 的 EntityArgument 在翻译键中使用 targets，而不是 @s、@a 或玩家名称。

来自 Better /help 的示例：

{
  "commands.advancement.grant.description": "Grants player advancements.",
  "commands.advancement.grant.targets.everything.description": "Grants all advancements to players.",
  "commands.advancement.grant.targets.only.description": "Grants one specified advancement to players."
}

主页链接

设置后，/help <command...> 输出中的模组名称可以变成可点击的链接：

{
  "betterhelp.homepage.examplemod": "https://example.com"
}

将 examplemod 替换为你的模组 ID。

你可以省略模组 ID 后缀，但由于翻译键冲突，不建议这样做：

{
  "betterhelp.homepage": "https://example.com"
}

更多详情请参阅文档。

❓ 常见问题

如果服务器安装了 Better /help，玩家也需要安装吗？ 不需要。这是一个服务端模组。客户端不需要安装。

它在单人游戏中有效吗？ 是的。

如果其他模组的开发者没有与 Better /help 集成，其命令仍然会显示吗？ 是的，但不会有它们的描述或其他元数据。使用方式仍然会显示。

我可以将其包含在整合包中吗？ 是的，无需请求许可。