MCG核心[API]

MCG Core 是 MCG-Modding 旗下每个模组的共享基础，同时它本身也是一个模组：它提供了所有 MCG 模组都会写入的游戏内指南书。安装任意 MCG 模组，它便会自动向 Core 注册自身，无需配置、无需设置步骤、也不会出现第二个按键与相同字母冲突。按下 H 键，书本便会打开，并为每个已安装的 MCG 模组和每本 MCG 指南书提供一个标签页。Core 是客户端侧的，因此它既能用于单人游戏，也能在任何服务器（无论服务器是否运行它）和任何整合包中正常工作。

 

Core 存在的原因在于，每个模组各配一本指南书的方式无法扩展。五个模组意味着五本书、五个按键和五种需要学习的布局，而且其中大多数只被打开过一次便不再使用。Core 扭转了这一局面：只有一本书、一个按键和一套需学习的操作习惯，每个接入它的模组都能继承完整界面、翻页美术、搜索、提示、设置和物品查找功能。模组作者因此免费获得一套完整的文档系统，玩家也能在一个统一的地方查找信息。

进度会随着你的游戏过程自动填充。Core 会悄悄记录每个经过你物品栏的物品，按世界分别存储在你本机上的一个普通文件中，并且绝不会发送到任何地方。你尚未找到的物品在指南的物品列表中会以淡色显示，因此一本你几乎没看过的页面与一本你已逐条查过的页面看起来截然不同。当“入门指南”步骤所要求的物品真正出现在你的物品栏中时，对应的勾选步骤便会自动完成。

Core 还额外提供了共享对话系统：你的模组提供文字、分支和数据，而 Core 负责绘制卷轴、分页、选项和文本输入，这样 NPC 对话在使用该系统的每个模组中都会保持一致的观感。指南还可以根据你的模组版本拆分成多个文件加载，因此为 1.x 编写的一套页面和为 2.x 编写的另一套页面可以共存于同一个 jar 文件中，并且会加载正确的那一套。

 

要求：Forge 47+ 上的 Minecraft 1.20.1，以及 NeoForge 21.1+ 上的 Minecraft 1.21.1