ModPedia

Minecraft · 三版本兼容线

让整合包里的知识，随时可查。

ModPedia 是一个面向大型 Minecraft 整合包的本地模组知识助手。它读取已安装模组的手册，建立可搜索的本地知识库，也可以连接你配置的 AI 来整理答案。

下载 v1.4.0 支持项目 查看源码

本地优先 · 可仅搜索 · 可选 AI

模组百科 知识库就绪 ×
压力容器需要哪些前置条件？
压力容器需要先准备基础框架、稳定的气压来源，并确认当前版本的结构要求。
↗ 前置条件与结构要求
输入问题……↑
为整合包而生Markdown + SQLite不绑定 AI 服务可选联动模组

FEATURES

从“搜不到”到“看得懂”。

把分散在手册、任务和物品 Tooltip 里的信息，整理成一条清晰的本地检索链路。

⌕

本地知识库

扫描已安装内容模组的 Patchouli、GuideME、Modonomicon 手册；1.12.2 额外支持 Mantle/匠魂书籍，保留完整 Markdown、标题路径和来源跳转。

SQLite · FTS5
✦

AI 辅助回答

模型可以调用本地搜索、计算和配方工具。证据不足时继续补搜，回答只引用本轮真正检索到的来源；支持四种 API 格式。

可配置 API
▦

整合包联动

FTB Quests、JEI、Jade 都是可选联动：任务进度、分阶段配方查询、物品名称和视线目标都能接入助手。

可选依赖

LOCAL FIRST

先把资料放在
你的电脑里。

没有 AI 也可以使用。打开“仅搜索”模式，直接查询本地知识库；需要更自然的解释时，再接入四种协议中的任意一种模型。

  • ✓ 加载屏幕阶段完成手册与物品目录预填充
  • ✓ Worker JVM 隔离 SQLite、检索和 AI 工作
  • ✓ 知识库、会话和 AI 设置保存在本地
knowledge.db● READY
documents手册正文动态
segments_fts全文检索FTS5
item_catalog物品名称与 Tooltip同步
task_quests静态任务定义可选
所有来源均可追溯

GET STARTED

三步开始使用。

01

准备环境

按下载文件选择 Minecraft 1.21.1/NeoForge、1.20.1/Forge 或 1.12.2/Forge 与 Cleanroom。

02

放入 Mod

将 ModPedia JAR 放入实例的 mods/ 目录。

03

打开助手

等待加载屏幕完成预填充后进入游戏，按 K 打开；需要重建时按 F9。

不强制捆绑。 Patchouli、GuideME、Modonomicon、FTB Quests、JEI 和 Jade 均为可选联动；缺少它们时 ModPedia 仍可正常进入游戏。

SUPPORT THE PROJECT

如果 ModPedia 帮到了你，欢迎支持后续维护。

你的支持会用于兼容性回归、知识库适配、文档整理和版本维护。赞助完全自愿，不影响本地知识库和“仅搜索”模式的使用。

爱发电中文赞助渠道 Buy Me a Coffee国际赞助渠道

LATEST RELEASE

ModPedia v1.4.0

三条兼容线同步发布：NeoForge 1.21.1、Forge 1.20.1，以及 Forge 1.12.2 / Cleanroom 0.3+ 兼容线；三条版本线均已完成当前发布测试。

三版本 JAR独立 Worker JVM仅搜索可用Apache 2.0

本地密钥保护：AI 设置只在用户目录保存系统标识派生的 AES-GCM 密文；游戏启动时解密到内存，日志不记录 API Key。整合包发布时不要复制用户级配置或 Worker 库。

下载 1.21.1 NeoForge 下载 1.20.1 Forge 下载 1.12.2 Forge / Cleanroom 查看 Release 资产与 SHA-256 ↗ 阅读完整安装说明 ↗ 查看模组介绍 ↗ 查看 v1.4.0 对比记录 ↗

FEATURE MATRIX

三条版本线，功能一目了然。

✓ 表示该版本已包含对应适配；— 表示当前版本线不提供该项或需要目标模组另行支持。

功能1.21.1
NeoForge		1.20.1
Forge		1.12.2
Forge / Cleanroom
本地手册扫描、SQLite / FTS5✓✓✓
Patchouli 书籍✓✓✓ 1.12 API
GuideME / Guide-API✓✓✓ legacy
Mantle / 匠魂手册（1.12.2）——✓
Modonomicon / APP JSON✓✓—
自定义 Markdown / Wiki 来源✓✓✓
四种 AI API 与仅搜索✓✓✓
独立 Worker JVM / SQLite 写入隔离✓✓✓
物品目录、Tooltip 与 Ctrl 显示 ID✓✓✓
FTBQ 静态任务与按需进度✓✓✓ legacy
JEI 配方查询与 Shift 跳转✓✓✓ legacy
Jade 联动✓✓—
准星 / Tooltip 目标冻结与插入✓✓✓
来源正文标注与手册跳转✓✓✓
支持版本Minecraft 1.21.1
NeoForge 21.1.x
Java 21		Minecraft 1.20.1
Forge 47.x
Java 21		Minecraft 1.12.2
Forge 14.23.5.2847 / Cleanroom 0.3+
游戏 Java 8 / Worker 21

PACK RELEASE NOTICE

发布整合包前，请先清理 ModPedia 配置。

这些文件可能包含玩家个人配置、API Key 或当前实例生成的知识库。整合包只应携带可复用的原始知识源。

01不需要保留runtime/

发布整合包前移除

  • config/modpedia/runtime/conversations/
  • config/modpedia/runtime/diagnostics/
  • config/modpedia/runtime/worker/
  • config/modpedia/runtime/assistant-window.json
  • config/modpedia/runtime/assistant-glass.json
  • config/modpedia/runtime/knowledge/knowledge.db*
  • config/modpedia/runtime/knowledge/generated/
  • config/modpedia/runtime/knowledge/cache/
  • config/modpedia/runtime/knowledge/manifest.json
  • config/modpedia/runtime/knowledge/keyword-index.json
  • config/modpedia/runtime/knowledge/state.json

用户级 ~/.modpedia/ai.json 和 ~/.modpedia/worker/lib/worker-baseline-3/ 位于游戏实例之外，由不同实例共享；它们不属于整合包，发布时不要复制。

02需要保留knowledge/

随整合包一起保留

  • config/modpedia/knowledge/custom/**/*.md
  • config/modpedia/knowledge/sources/<source-id>/source.json
  • config/modpedia/knowledge/sources/<source-id>/documents/**/*.md
  • config/modpedia/knowledge/sources/<source-id>/media.json
  • config/modpedia/knowledge/source-overrides.json
  • config/modpedia/knowledge/search-synonyms.json

runtime/ 会在玩家首次启动或按 F9 重建。media.json 随来源目录保留，用于保留 Wiki 媒体元数据；当前文本检索只建立 Markdown 内容索引。查看 README 中的完整规则 ↗