ModPedia

Minecraft · Three compatibility lines

Your modpack knowledge, always within reach.

ModPedia is a local mod knowledge assistant for large Minecraft modpacks. It reads manuals from installed mods, builds a searchable local knowledge base, and can connect to your configured AI to organize answers.

Download v1.4.0 Support the project View source

Local first · Search only · Optional AI

ModPedia Knowledge ready ×
What are the prerequisites for the pressure vessel?
Pressure vessel requires a basic framework, a stable pressure source, and the structure requirements for the current version.
↗ Prerequisites and structure
Ask a question…↑
Built for modpacksMarkdown + SQLiteNo AI lock-inOptional integrations

FEATURES

From “can’t find it” to “can understand it.”

Turn information scattered across manuals, quests, and item Tooltips into a clear local retrieval path.

⌕

Local knowledge base

Scan Patchouli, GuideME, and Modonomicon manuals; the 1.12.2 line also supports Mantle/Tinkers' Construct books while preserving complete Markdown, heading paths, and source navigation.

SQLite · FTS5
✦

AI-assisted answers

The model can call local search, calculation, and recipe tools, continue searching when evidence is incomplete, and cite only sources actually retrieved in the current round; four API formats are supported.

Configurable API
▦

Modpack integrations

FTB Quests, JEI, and Jade are optional integrations for task progress, staged recipe queries, item names, and crosshair targets.

Optional dependencies

LOCAL FIRST

Keep your knowledge
on your computer.

You can use ModPedia without AI. Turn on Search-only mode to query the local knowledge base directly; connect a model through any of the four supported API formats when you want more natural explanations.

  • ✓ Prefill manuals and the item catalog during loading
  • ✓ Keep SQLite, retrieval, and AI work in the Worker JVM
  • ✓ Keep the knowledge base, conversations, and AI settings local
knowledge.db● READY
documentsManual textLIVE
segments_ftsFull-text searchFTS5
item_catalogItem names and TooltipsSYNC
task_questsStatic task definitionsOPTIONAL
Every source remains traceable

GET STARTED

Start in three steps.

01

Prepare

Choose Minecraft 1.21.1/NeoForge, 1.20.1/Forge, or 1.12.2/Forge and Cleanroom to match the download.

02

Install the Mod

Put the ModPedia JAR in the instance mods/ directory.

03

Open the Assistant

Wait for the loading-screen prefill, enter the game, and press K; use F9 for a rebuild.

No forced bundles. Patchouli, GuideME, Modonomicon, FTB Quests, JEI, and Jade are all optional integrations. ModPedia still loads normally without them.

SUPPORT THE PROJECT

If ModPedia helps you, support its continued maintenance.

Your support helps fund compatibility testing, knowledge-source adapters, documentation, and release maintenance. Sponsorship is optional and does not affect the local knowledge base or Search-only mode.

爱发电Chinese sponsorship channel Buy Me a CoffeeInternational sponsorship channel

LATEST RELEASE

ModPedia v1.4.0

Three compatibility lines ship together: NeoForge 1.21.1, Forge 1.20.1, and the Forge 1.12.2 / Cleanroom 0.3+ compatibility line. All three have completed current release testing.

Three JARsSeparate Worker JVMSearch-onlyApache 2.0

Local key protection: AI settings store AES-GCM ciphertext derived from a system identifier in the user directory; the game decrypts it in memory and logs never record the API key. Do not copy user-level settings or Worker libraries into a modpack.

Download 1.21.1 NeoForge Download 1.20.1 Forge Download 1.12.2 Forge / Cleanroom View Release assets and SHA-256 ↗ Read the installation guide ↗ Read the mod introduction ↗ Read the v1.4.0 comparison ↗

FEATURE MATRIX

Three version lines, one clear view.

✓ means the adapter is included in that build; — means the feature is not provided by that line or requires the target mod separately.

Feature1.21.1
NeoForge		1.20.1
Forge		1.12.2
Forge / Cleanroom
Local manuals, SQLite / FTS5✓✓✓
Patchouli books✓✓✓ 1.12 API
GuideME / Guide-API✓✓✓ legacy
Mantle / Tinkers' Construct manuals (1.12.2)——✓
Modonomicon / APP JSON✓✓—
Custom Markdown / Wiki sources✓✓✓
Four AI APIs and Search-only✓✓✓
Separate Worker JVM / isolated writes✓✓✓
Item catalog, Tooltips, Ctrl ID view✓✓✓
FTBQ static tasks and on-demand progress✓✓✓ legacy
JEI recipe queries and Shift navigation✓✓✓ legacy
Jade integration✓✓—
Crosshair / Tooltip target freeze and insert✓✓✓
Inline citations and manual navigation✓✓✓
Supported versionsMinecraft 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+
game Java 8 / Worker 21

PACK RELEASE NOTICE

Clean ModPedia config before publishing a modpack.

These files may contain personal player settings, an API key, or a knowledge database generated for the current instance. A modpack should carry only reusable source content.

01Removeruntime/

Remove before publishing

  • 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

The user-level ~/.modpedia/ai.json and ~/.modpedia/worker/lib/worker-baseline-3/ live outside each game instance and are shared between instances. They are not part of a modpack and must not be copied.

02Keepknowledge/

Keep with the modpack

  • 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/ is regenerated on first startup or after pressing F9. media.json stays with its source directory for Wiki media metadata; the current text search indexes Markdown only. Read the complete README rules ↗