首页 / 资源中心 / 模组菜单 Mod Menu
我的世界1.21.11-1.17.1模组菜单 Mod Menu:直观查看和管理已安装的模组列表功能|Fabric|Quilt模组Mod下载

模组菜单 Mod Menu

模组Mod 更新于 2026-04-27

资源图片

Mod Menu (模组菜单) 概述

Mod Menu 旨在为你提供一个直观的界面,用于查看和管理已安装的模组列表。

该模组不仅能清晰地展示你当前环境下的模组清单,而且如果已安装的模组本身支持,Mod Menu 还能作为一个便捷的入口,让你快速访问并调整这些模组的配置界面。

此外,Mod Menu 还引入了一系列高级功能来增强用户体验和模组展示效果,包括:

  • 本地化支持:允许对模组名称和描述进行翻译。
  • 富文本描述:得益于 Patbox 的 Text Placeholder API,模组描述中支持使用 QuickText 格式。
  • 智能过滤:能够区分并过滤掉基础的前置库模组,使列表更整洁。
  • 更新检测:针对托管在 Modrinth 上的模组或提供自定义更新源的模组,内置了更新检查器。
  • 深度配置:针对 Mod Menu 自身提供的所有功能,都给予了用户高度的配置自由。

支持平台

目前,Mod Menu 适用于 Minecraft Java 版 1.14 及更高版本,并支持 Fabric 或 Quilt 加载器。


开发者指南

Mod Menu 为开发者提供了一套丰富的 API 工具集,旨在优化模组在菜单中的呈现方式。这些工具涵盖了语言键(Language Keys)、JSON 元数据(JSON Metadata)以及通过代码实现的 Java API。

翻译 API (Translation API)

你完全无需编写任何 Java 代码,即可对模组的名称、摘要和详细描述进行本地化处理。只需按照指定格式,将翻译键值添加到你所需的语言文件中即可。

翻译 API 使用示例

以下是一个展示 Mod Menu 被翻译成“海盗语”的示例。若要为你自己的模组创建翻译,只需将翻译键末尾的 modmenu 替换为你自己的模组 ID 即可(请注意,不要替换开头的 modmenu),例如: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!"  

提示:在此示例中,摘要(summary)的翻译其实是多余的,因为它与描述(description)的内容完全一致。这里将其列出主要是为了演示一项功能:你可以将摘要(即对模组的一句话简短介绍)与详细描述分开独立翻译,哪怕是在英文原版中也是如此!

Fabric 元数据 API (Fabric Metadata API)

开发者可以通过在 fabric.mod.json 文件中添加特定的元数据来丰富模组的展示信息。

所有相关配置都需要放置在 fabric.mod.json 的自定义块(custom block)中。以下是一个集成了该 API 众多功能的配置示例:

文件:fabric.mod.json

{  
  ...  
  "custom": {  
    "modmenu": {  
      "links": {  
        "modmenu.discord": "https://discord.gg/jEGF5fb"  
      },  
      "badges": [ "library", "deprecated" ],  
      "parent": {  
        "id": "example-api",  
        "name": "Example API",  
        "description": "Modular example library",  
        "icon": "assets/example-api-module-v1/parent_icon.png",  
        "badges": [ "library" ]  
      },  
      "update_checker": true  
    }  
  }  
}  

徽章系统 ("badges": [ ])

虽然对于在 fabric.mod.json 中设置了 "environment": "client" 的模组,系统会自动添加 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 内置了一些默认的链接翻译键,通常遵循 modmenu.<type> 的格式。你可以查阅 Mod Menu 的语言文件以获取完整列表。

如果你希望添加自定义链接,也可以提供自己的翻译。对于任何自定义键,请务必使用你自己的命名空间(而不是 modmenu),以避免冲突。

父级关系 ("parent": "mod_id" or { })

父级关系用于将一个模组显示为另一个模组的子模组。这通常用于将拆分为多个模块的模组进行归类。

以下示例将当前模组定义为模组 '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  
    }  
}  

Quilt 元数据 API (Quilt Metadata API)

鉴于 Mod Menu 同样支持 Quilt 加载器,上一节 Fabric 元数据 API 中提到的所有功能同样适用于 Quilt 模组,但在自定义元数据的格式上存在细微差别。

在 Quilt 中,你不需要将 "modmenu" 块放置在 "custom" 块内,而是将其直接作为根对象的一个元素。结构如下:

文件:quilt.mod.json

{  
  ...  
  "modmenu": {  
    // 在此处放置你的链接、徽章等配置信息  
  }  
}  

Java API

若要利用 Java API 进行开发,你需要在 Gradle 项目中将 Mod Menu 添加为编译时依赖。这并不会强制你的模组在运行时依赖 Mod Menu,但能确保你在开发环境中可以使用它进行测试。

文件:build.gradle

// 在 repositories 块中添加 Terraformers Maven 仓库  
repositories {  
  maven {  
    name = "Terraformers"  
    url = "https://maven.terraformersmc.com/"  
  }  
}  

// 在 dependencies 块中添加 Mod Menu 作为环境依赖  
dependencies {  
  // 对于 Minecraft 1.20.6 之前的版本,请使用 "modImplementation"  
  implementation("com.terraformersmc:modmenu:${project.modmenu_version}")  
}  

接着,请在 gradle.properties 文件中定义你所使用的 Mod Menu 版本。建议查阅官方版本列表获取最新的版本号;请注意,如果你未使用最新版 Minecraft,可能需要选择对应的旧版 Mod Menu。

文件:gradle.properties

modmenu_version=VERSION_NUMBER_HERE  

提示:如果你不希望在测试环境中加载 Mod Menu,但仍需编译支持 Java API 的代码,可以使用 modCompileOnly 替代 modImplementation(即使 Mod Menu 未更新至你当前运行的 Minecraft 版本,此方法依然有效)。

以此开始 (Getting Started)

要开始使用 API,你需要在一个类上实现 ModMenuApi 接口,并在 fabric.mod.json 中将其添加为类型为 "modmenu" 的入口点(entry point):

文件:fabric.mod.json

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

模组配置屏幕 (Mod Config Screens)

模组可以提供一个屏幕工厂(Screen Factory),以便在用户点击配置按钮时打开自定义的配置界面。为此,请在你的 API 实现类中重写 getModConfigScreenFactory 方法。

此功能的预期用途是让模组能够提供其自身的配置界面。配置屏幕的模组 ID 将由可以自动确定该入口点来源的模组容器决定。

提供的外部配置屏幕 (Provided Config Screens)

模组不仅可以为自己,还可以为其他模组提供屏幕工厂,以便通过配置按钮打开。为此,请在你的 API 实现类中重写 getProvidedConfigScreenFactories 方法。

此功能的典型应用场景是像 Cloth Config 这样的模组,它需要为那些使用了其 API 的其他模组提供配置界面。

整合包徽章 (Modpack Badges)

模组可以通过实现 attachModpackBadges 方法,赋予其他模组 Modpack(整合包)徽章。示例如下:

@Override  
public void attachModpackBadges(Consumer<String> consumer) {  
  consumer.accept("modmenu"); // 声明 'modmenu' 是该整合包的一部分  
}  

请注意,“内部”模组(如 Minecraft 本体和模组加载器)无法被赋予整合包徽章,因为它们通常不包含在常规的整合包分发文件中。

静态辅助方法 (Static Helper Methods)

ModMenuApi 还提供了一些便捷的静态辅助方法,方便那些希望与 Mod Menu进行更好集成的模组使用,例如创建自定义的“模组”按钮。

创建模组屏幕实例

调用此方法可直接获取模组列表屏幕的实例:

Screen createModsScreen(Screen previous)  

获取模组按钮文本

调用此方法可获取 Mod Menu 风格的“模组”按钮上应显示的文本内容:

Text createModsButtonText()

地图存档使用教程:https://www.mcshuo.com/article/14


MOD模组安装使用教程:https://www.mcshuo.com/article/15


资源光影包安装使用教程:https://www.mcshuo.com/article/16

评论与互动

条评论
资源评分 / 5 人评分
我的评分

登录后发表观点、使用图片表情并回复其他玩家。

登录参与讨论
/

评论安全验证

按图中提示完成验证即可继续评论

7日热门资源

实时小地图:在屏幕角落显示周围地形、生物和路径点的附加包 True Minimap
基岩版 模组Mod

实时小地图:在屏幕角落显示周围地形、生物和路径点的附加包 True Minimap

基岩版一直没有原版小地图,实时小地图就是来补这个空缺的:它在屏幕一角画出你周围的世界,边走边更新,地形、洞穴、生物和你自己设的路径点都能在上面看到。

地图本身 地图始终上北下南,金色箭头代表你和你面朝的方向; 可以选方形,也可以选带细钢圈的圆形; 四档缩放:近(56 格)、普通(112 格)、远(168 格)、很远(224 格); 能放在屏幕任意一个角,离边缘多远也能在菜单里调; 带地形明暗,山坡和台阶一眼能看出来,夜间变暗可以开关; 走过的地方会一直留在地图上,地图还会加载模拟距离之外的区块,所以越走越完整。

三个维度和地下

主世界、下界和末地都能显示。在洞穴里,地图会显示你所在的那一层,不会被地表挡住。

生物和首领

生物用彩色小点标出:怪物是红色,中立生物橙色,动物绿色,村民和商人棕色,驯服的动物蓝色。末影龙、凋灵、远古守卫者和监守者还各有一个会动的专属图标。

路径点

路径点在地图上显示为发光的宝石,世界开启 locatorBar 游戏规则时也会显示在定位栏上; 超出地图范围的路径点会停在地图边缘,指向它的方向; 选择导航后,地图上会画一个圈、定位栏上会出现星标,直到你走到那里; 可以在当前位置或输入坐标添加,也可以把已有路径点移到你脚下; 主世界的路径点会按下界传送门比例出现在下界,反过来也一样。 小地图物品

使用「小地图」物品打开菜单,可以设置是否显示、缩放、形状、位置和边距、洞穴、网格、地图风格、地形明暗、夜间变暗、小地图刷新率上限,以及是否显示其他玩家和生物,还有路径点页面。潜行时使用可以直接切换到下一档缩放。物品丢了用指南针和纸就能再合成一个。

安装

导入 .mcaddon 文件,在世界设置里同时启用行为包和资源包,然后退出世界再进入一次。支持到 26.50。

低配设备的提醒

地图是用游戏自带的 HUD 画的,站着不动几乎不吃性能,但每次重绘都要算一下。低配手机和平板在移动时可能会掉帧或短暂卡顿,尤其是开「远」「很远」缩放、用圆形地图或快速飞行的时候。觉得卡就换成普通或近缩放和方形地图,在菜单里调低小地图刷新率(只限制地图重绘频率,不影响游戏帧率),不用时也可以直接关掉。

320 下载
2026-11-11
基岩版进度系统:把 Java 版进度树、弹出提示和自定义进度带到基岩版 Bedrock Advancements
基岩版 模组Mod

基岩版进度系统:把 Java 版进度树、弹出提示和自定义进度带到基岩版 Bedrock Advancements

基岩版一装附加包,原版成就界面就会被关掉。基岩版进度系统把 Java 版那种分页、进度树、提示框和挑战,连同全部基岩版成就,一起带回你的世界。打开界面就能看到「Minecraft」「下界」「末地」「冒险」和「农牧」这些分页,进度会按树状连接,鼠标悬停能看到目标和完成情况。当前版本 2.0.17,支持到 26.60,不需要实验性开关(标准版)。

全部 Java 进度,外加基岩版成就

一共收录了 126 项 Java 版进度:同样的边框、挑战经验奖励(40 到 1000 点),以及会随你推进才显现的隐藏进度。「Minecraft」分页会在你做出第一张工作台后出现,和 Java 版一样。解锁时会弹出「进度完成!」「目标达成!」「挑战完成!」「成就解锁!」等提示,聊天里也会告诉其他玩家。像「冒险时间」和「均衡饮食」这种需要跑很久的进度,可以在界面或「进行中」列表里精确看到还差哪一步。不喜欢弹出提示的话,可以在手册菜单里只关掉自己的,不影响别人。

另外 132 项官方基岩版成就也有独立分页,按分组排列。世界管理员可以在管理菜单里打开这一页,并决定是否允许在创造模式里推进。

进度手册和讲台

用一本再加四块紫水晶碎片就能合成进度手册。使用它会打开进度界面;潜行再使用则打开手册菜单,里面有分数、「进行中」列表,以及自己的弹出提示开关。选「进行中」(或输入 /ba:progress)会列出你已经开始的全部进度,点进去能看到清单:哪些做完了、还差什么。

把手册放到讲台上,你的名字和分数会浮在上方,隔墙也不会穿帮。别人对着讲台使用,就能用同样的进度界面浏览你的完成情况。

自己做进度

还可以在浏览器里制作整页自定义进度:起名、选图标、选目标,做出来的效果和游戏里一致。目标类型包括收集、合成、击杀、驯服、探索、骑乘、酿造等约 40 种,也可以做累计挑战(例如跳跃一万次、走满一百公里),或把条件限制在某个生物群系、维度、高度、夜间或雨天。导出后是普通附加包,和本附加包一起放到世界里即可。给自己的附加包加分页时,也可以用纯 JSON、不必写脚本。

管理与多人

操作员输入 /ba:admin(或从手册菜单进入)可打开管理菜单:按玩家查看在线或离线进度、授予或收回进度,以及保存聊天公告、经验奖励、创造模式进度、讲台文字等设置。重置功能需要输入 CONFIRM 才会执行。每位玩家的进度各自保存,跟着世界走;新加入的玩家不用额外安装。从 1.x 升级到 2.x 时,已解锁的进度、原解锁日期和部分进度都会自动继承,讲台也继续有效。默认支持 29 种语言。

两个版本和安装

推荐使用标准版:不需要实验性玩法,世界仍然可以解锁 Xbox 成就。结构是按方块识别的,合成类目标在你拥有该物品时就算完成。

测试版额外启用 Beta API,结构检测更精确;从 26.60 起,合成目标只有真正合成该物品时才计数。打开实验性玩法会永久关掉该世界的 Xbox 成就,只有需要这份精确度时再选。两套版本的进度可以互通,随时切换。

用 Minecraft 基岩版打开 .mcaddon,在世界设置的行为包里启用 BedrockAdvancements(资源包会一起加上)。需要 1.26.50 或更新版本。常用命令:/ba:advancements 打开进度界面,/ba:progress 查看进行中的项目,/ba:admin 打开管理菜单;操作员在开启作弊时还可用 /ba:grant 和 /ba:revoke 授予或收回进度。

214 下载
2026-11-13
自然灾害TNT:陨石雨、龙卷风、火山等二十多种特殊TNT的附加包 Natural Disaster TNT
基岩版 模组Mod

自然灾害TNT:陨石雨、龙卷风、火山等二十多种特殊TNT的附加包 Natural Disaster TNT

放下、点燃、看灾害降临。自然灾害TNT一共加入 28 种 TNT 方块,点燃后就在你放置的地方引发陨石雨、龙卷风、火山、核爆、轨道激光等场面,而且不需要开启实验性功能。所有灾害都由你亲手放置的 TNT 触发,不会自己发生。

怎么用 在工作台合成:中间放 1 个 TNT,四角放 4 个火药,四边放 4 个对应的特殊物品; 用打火石、火焰弹、红石点燃,或用另一次爆炸引爆; 它会像原版 TNT 一样闪烁、膨胀、被推动,然后灾害开始; 创造模式下可以在物品栏里找,或直接搜索 TNT。

如果合成不出来,请确认行为包和资源包都已在世界里启用,并把游戏更新到最新版。

全部 28 种 TNT

自然灾害

陨石雨:燃烧的陨石从天而降 龙卷风:卷起生物、物品和方块,再抛向四周 火山:地面隆起一座山并喷出岩浆弹 地震:大地震动并裂开 雷暴:闪电一次次落下 冰霜新星:冻结水面、降雪并升起冰锥 黑洞:把一切吸进去,再猛然爆炸

大爆炸

核爆:刺眼的白光、冲击波和蘑菇云 轨道激光:锁定、蓄能,再从天空打下一束钻向地下的光束 空袭:TNT 从天而降 连锁坍塌:一圈圈爆炸让地面塌陷 巨型 TNT 与集束 TNT(会分裂成 8 个 TNT)

实用类

平整:清理上方的地形并用草方块填平坑洞 挖矿:挖出 3x3 的竖井,矿物以物品形式掉落 湖泊、岩浆坑、避难所(玻璃穹顶)、火把(照亮洞穴)、花园(草和花)

纯娱乐(不破坏方块)

烟花表演、涂料(彩色羊毛地面)、农场动物、经验、烟雾弹、发射台、传送

随机

随机灾害:永远不知道会抽到哪一种 设置

在世界设置里点击附加包旁的齿轮按钮即可调整:

效果半径(4–12 格) 引线时间(1–5 秒) 连锁坍塌速度,爆炸是否在水下生效 镜头晃动与闪光(不喜欢可以关闭) 陨石和闪电是否引燃火焰 兼容性

无需实验性功能,比较轻量(大型特效会分散在一段时间内,同时运行的数量有限),支持多人联机。

使用方法 下载并打开 .mcaddon 文件,游戏会自动导入; 在世界设置中同时启用行为包和资源包; 进入世界,在工作台合成或在创造物品栏找到 TNT。

本次文件为 v1.2.0,适用于基岩版 26.50。作者:Kazu_5623。

152 下载
2026-11-11
DPG经济:用手持设备开商店、拍卖行和职业任务来赚金币 DPG Economy
基岩版 模组Mod

DPG经济:用手持设备开商店、拍卖行和职业任务来赚金币 DPG Economy

DPG经济是一份面向基岩版多人世界的经济附加包。玩家可以赚取 DPG 金币,在商店买卖物品,把物品挂到拍卖行,也可以接职业任务获得报酬。这些功能都集中在一件手持的经济设备里。

第一次进入世界时,每位玩家会获得这台设备,并在聊天里看到简短说明。手持设备、潜行并使用,即可在任何地方打开菜单。商店大约有 1000 种物品,分成 16 个分类,可以搜索,也支持一键出售。拍卖行允许玩家自定价格上架,其他人可以买下全部或一部分,并提供搜索、筛选、上架费用,以及过期后取回未售出物品。职业共 12 种、78 项任务,包括伐木、采矿、挖掘、种植、畜牧、狩猎、射箭、建造、园艺、红石、烹饪和探索;接受任务并完成工作后,报酬会自动到账。每位玩家都有余额、收支统计和交易记录。

管理员或带有相应管理标签的玩家可以调整余额、物价、拍卖设置和任务奖励。交易会由游戏脚本校验,余额不会变成负数,奖励不会重复发放,玩家自己放下的方块也不会计入职业任务。如果设备丢失,可以用游戏内命令重新领取,也可以查询余额或再次查看说明。

支持 Minecraft 26.60。把附加包导入并在世界中启用即可。单个文件为 mcaddon。

136 下载
2026-11-13
简易矿石探测器:用不破坏平衡的扫描找到附近矿石 Simple Ore Detector
基岩版 模组Mod

简易矿石探测器:用不破坏平衡的扫描找到附近矿石 Simple Ore Detector

简易矿石探测器是一款成就兼容的生存向附加包。用手持探测器选定要找的矿石后,它只会锁定附近最近的一处同类矿石,并在界面上实时显示名称、坐标和距离,而不会把整片矿脉都暴露出来。

可在菜单中选择煤矿、铁矿、钻石矿、远古残骸等十一种矿石 追踪开始后,距离会用绿、黄、红表示远近,并随你移动更新 挖掉目标后会自动结束追踪、收起界面,可以立刻再扫描下一块 可用原版材料在生存模式中合成,无需开启实验玩法

使用方法

下载并打开 .mcaddon 文件,导入游戏; 在世界设置的「附加包」中启用行为包和资源包; 合成矿石探测器,选好矿种后开始扫描。

适用于基岩版 26.40。原作者:MrDavid13。

120 下载
2026-11-14
更多结构:给世界再添约 40 处村庄、地牢、城堡和树屋 Many more structure
基岩版 模组Mod

更多结构:给世界再添约 40 处村庄、地牢、城堡和树屋 Many more structure

更多结构是一份基岩版附加包,会在世界里再生成大约 40 处建筑,包括村庄、地牢、城堡,以及树上的小屋等。走进新地图,或前往还没探索过的区域时,就有机会遇到这些建筑。

这些结构沿用原版方块和风格,看起来像是世界里本来就会出现的建筑,而不是另外一套外观。具体会出现哪些、会出现多少,需要自己去探索。

支持 Minecraft 26.50。下载后导入附加包,并在世界设置里启用,即可在新探索的区域遇到这些建筑。单个文件为 mcpack。

104 下载
2026-11-13