以下是模组菜单翻译成海盗语的一个示例。要创建你自己的翻译，只需将翻译键末尾的 modmenu（不是开头那个）替换为你自己的模组 ID，例如 modmenu.descriptionTranslation.traverse。

en_pt.json

"modmenu.nameTranslation.modmenu": "Menu o' mods!",
"modmenu.descriptionTranslation.modmenu": "Menu o' mods ye installed matey!",
"modmenu.summaryTranslation.modmenu": "Menu o' mods ye installed matey!"

此处的摘要翻译是多余的，无需包含，因为它与描述相同，但这里包含它是为了说明你可以将摘要（模组的一句话简短描述）与描述分开翻译，即使在英语中也是如此！

徽章（"badges": [ ]）

当模组被设置为仅客户端时，Client 徽章会自动添加（在 fabric.mod.json 中设置 "environment": "client" 即可实现）。而其他徽章，例如 Library 和 Deprecated 徽章，则需要在此处定义。

支持的值：

• library – 应分配给那些纯粹作为其他模组依赖的模组，默认情况下不应向用户显示，除非用户主动开启显示。
• deprecated – 应分配给那些纯粹出于历史遗留原因而存在的模组，例如旧的 API 模块等。

其他任何值都将被忽略，并且 Mod Menu 不支持添加你自己的徽章。如果你有令人信服的理由需要新徽章，可以在此处提交 issue。

链接（"links": { }）

links 对象允许模组作者在其描述末尾添加自定义超链接。如果你在官方 fabric.mod.json 元数据中指定了 sources 联系方式，它也会被包含在链接部分中。

links 对象中的任何键都会被包含在链接部分中，该键将用作翻译键。例如，以下内容：

fabric.mod.json

"custom": {
    "modmenu": {
        "links": {
          "modmenu.discord": "https://discord.gg/jEGF5fb"
        }
    }
}

将显示为一个文本为“Discord”的链接，因为“Discord”是 Mod Menu 提供的“modmenu.discord”的英文翻译。

Mod Menu 提供了若干可用于链接的默认翻译。完整列表可在 Mod Menu 的语言文件此处查看。所有默认链接翻译键的形式均为 modmenu.<type>。

如果你想添加自定义链接，也可以提供自己的翻译。请确保为任何自定义键使用你自己的命名空间（而不是 modmenu）。

父级（"parent": "mod_id" or { }）

父级用于将某个模组显示为另一个模组的子级。这适用于被划分为不同模块的模组。fabric.mod.json 中的以下元素会将模组定义为模组 ‘flamingo’ 的子级：

fabric.mod.json

"custom": {
    "modmenu": {
        "parent": "flamingo"
    }
}

不过，如果你想将模组归组到一个父级下，但该父级并不是一个真实的模组，你也可以这样做。在下面的示例中，一个模组正在为一个父级定义元数据。请确保此元数据包含在使用该虚假/占位父级的所有子级中。这也可以用作可选父级的回退方案，如果存在该模组的真实元数据，它将被替换。

fabric.mod.json

"custom": {
    "modmenu": {
        "parent": {
            "id": "this-mod-isnt-real",
            "name": "Fake Mod",
            "description": "Do cool stuff with this fake mod",
            "icon": "assets/real-mod/fake-mod-icon.png",
            "badges": [ "library" ]
        }
    }
}

占位父级模组仅支持以下元数据：

• id（字符串）
• name（字符串）
• description（字符串）
• icon（字符串）
• badges（字符串数组）

禁用更新检查器（"update_checker": false）

默认情况下，Mod Menu 的更新检查器会使用你模组 jar 的哈希值在 Modrinth 上查找最新版本。如果它找到匹配的项目，就会检查支持你的模组加载器和 Minecraft 版本的最新版本，如果该版本的哈希值与你的现有文件不同，就会提示用户有可用更新。

你可以通过在 Mod Menu 元数据中将 update_checker 设为 false 来禁用更新检查器，如下所示：

fabric.mod.json

"custom": {
    "modmenu": {
        "update_checker": false
    }
}

入门

要使用该 API，请在一个类上实现 ModMenuApi 接口，并将其作为类型为 “modmenu” 的入口点添加到你的 fabric.mod.json 中，如下所示：

fabric.mod.json

"entrypoints": {
  "modmenu": [ "com.example.mod.ExampleModMenuApiImpl" ]
}

模组配置界面

模组可以提供 Screen 工厂，以提供通过配置按钮打开的自定义配置界面。在你的 API 实现中实现 getModConfigScreenFactory 方法即可做到这一点。

此功能的预期用途是让模组提供自己的配置界面。配置界面的模组 id 会由入口点来源的源模组容器自动确定。

提供的配置界面

模组可以提供 Screen 工厂，以便通过其他模组的配置按钮打开自定义的配置界面。为此，请在你的 API 实现中实现 getProvidedConfigScreenFactories 方法。

此功能的预期用途是让 Cloth Config 之类的模组为使用其 API 的模组提供配置界面。

整合包徽章

模组可以通过实现 attachModpackBadges 方法为其他模组授予 Modpack 徽章，例如通过以下方式：

@Override
public void attachModpackBadges(Consumer<String> consumer) {
	consumer.accept("modmenu"); // Indicates that 'modmenu' is part of the modpack
}

请注意，像 Minecraft 本身和模组加载器这样的“内部”模组无法获得整合包徽章，因为它们不会在典型的整合包中分发。

静态辅助方法

ModMenuApi 还为希望更好地与 Mod Menu 配合的模组提供了一些辅助方法，例如制作它们自己的模组按钮。

创建模组界面实例

你可以调用此方法获取模组界面的实例：

Screen createModsScreen(Screen previous)

创建模组按钮 Text

你可以调用此方法获取将显示在 Mod Menu 模组按钮上的 Text：

Text createModsButtonText()