终极沉思扩充包

终极沉思扩展

终极沉思扩展（Ultimate Ponder Additions）是 Ponder 的一个内容扩展模组，为其他模组添加互动式文档。

Ponder 是一个工具，允许玩家直接在 Minecraft 内通过互动式 3D 场景了解机器、方块和系统的工作原理。然而，Ponder 本身并未为每个模组提供场景。模组作者必须自行创建并提供文档。

终极沉思扩展填补了这一空白。

本模组为多个热门模组提供了开箱即用的 Ponder 场景，同时也为开发者及整合包作者提供了一种简单的方式来创建他们自己的场景、指南和文档。

📚 包含内容

该模组目前包含 20 个场景，涵盖约 90 个方块和机器。

⚙️ 工业前兆（Industrial Foregoing）

互动场景包括：

• 植物播种机
• 植物收割机
• 植物施肥机
• 生物复制机
• 粉碎机
• 屠宰工厂
• 矿石镭射基座
• 镭射钻机
• 生物反应器
• 生物燃料发电机
• 传送带
• 方块放置器
• 方块破坏器

📦 功能存储（Functional Storage）

场景包括：

• 1、2 和 4 格抽屉
• 存储控制器
• 扩展件
• 压缩抽屉
• 末影抽屉
• 军械库柜

🐔 现代鸡（Modern Chickens）

包含以下文档：

• 鸡舍
• 收集器
• 繁殖器
• 巢
• 母鸡棚
• 孵化器
• 禽类转换器

⚡ 应用能源 2（Applied Energistics 2）

包含场景：

• 印刻机
• 发芽石英
• 加速生长器
• 基础 ME 网络
• 合成 CPU
• 充电器
• 曲柄

🎮 场景如何运作？

模组安装后，只需在物品栏中找到受支持的方块，然后按住 W 键即可打开其 Ponder 文档。

接下来，你就可以直接在 Minecraft 内通过互动式 3D 场景探索该机器或系统。

无需退出游戏或搜索外部 Wiki 来了解机器的工作原理。

📖 GuideME 集成

安装了 GuideME 后，终极沉思扩展还可以提供一本文档书，其中包含以互动式 3D 场景呈现的相同机器和设置。

该模组也拥有自己的创造模式标签页。

GuideME 是完全可选的。没有它，Ponder 场景仍可正常工作。

🛠️ 创建你自己的指南

终极沉思扩展不仅限于模组自带的场景。

它还提供了用于创建你自己文档的工具。

📄 指南页面

指南页面使用 Markdown 编写，并放置在：

assets/<yourmod>/guides/ultimateponderadditions/guide/

仅此而已。

创建指南页面无需任何 Java 代码。

该系统同样支持通过资源包运作，这意味着整合包无需创建额外的模组即可添加或修改文档。

这可以让你创建：

• 手册
• 教程
• 机器文档
• 进度指南
• 系统解析
• 整合包专属章节

🎬 创建你自己的 Ponder 场景

开发者也可以使用提供的 API 创建自己的 Ponder 场景。

基本集成仅需要：

• 一个类
• 一个注解
• 大约 30 行代码

无需手动注册调用，也无需担心加载顺序的设置。

你的语言键保留在你自己的模组命名空间内，有助于防止与其他集成产生冲突。

场景结构可以用 Java 编写并生成 .nbt 和 .snbt 文件，因此你无需在创造世界中手动搭建每个结构。

完整的 API 记录在 API.md 中。

对工业前兆、功能存储、现代鸡和应用能源 2 的集成也作为实用示例提供。

🔌 依赖项

必需

• Ponder — 提供场景系统并附带 Flywheel。

可选

• GuideME — 启用文档书。

GuideME 并非 Ponder 场景所必需。

被文档化的模组同样为可选项，且彼此完全独立。

例如，如果你安装了工业前兆和应用能源 2，你将获得它们各自的场景，而无需安装功能存储或现代鸡。

集成模组也不是编译期依赖。

如果其中一个模组重命名或移除了某个机器，仅会丢失对应的场景，其他任何内容都不会受影响。

⚙️ 配置

配置文件位于：

config/ultimateponderadditions-client.toml

可用选项：

• enablePonderScenes — 启用或禁用 Ponder 场景。
• enableGuidebook — 启用或禁用 GuideME 集成。
• disabledAddons — 按 ID 禁用特定集成：
  • industrialforegoing
  • functionalstorage
  • chickens
  • ae2

🌎 语言

目前支持：

• 英语
• 西班牙语

未来版本可能会添加更多翻译。

🤝 致谢

• Ponder 由 Create 团队开发。
• GuideME 由应用能源 2 团队开发。
• 两个库均未捆绑在终极沉思扩展中。

对于与 Ponder 界面或 GuideME 书籍渲染器相关的问题，请分别向对应的原始项目报告。