How the Mod Generator Works
A deep dive into the tri-model AI pipeline, the self-evolution engine, and the technology that turns your ideas into real Minecraft mods.
Tri-Model Pipeline
Three specialized AI models work in a sequential pipeline. Each model handles what it does best, producing higher quality output than any single model could achieve alone.
Plans mod structure, designs class hierarchies, and maps Minecraft API patterns. Handles high-level system design and memory integration.
Implements Java source code with precise Fabric API calls. Ensures correct imports, registries, event hooks, and generates textures/assets.
Reviews compiled code for bugs, API mismatches, and performance issues. Suggests targeted fixes before the build runs.
The 6 Pipeline Phases
Memory
~5sGPT-5.4The tri-model pipeline reviews past successful builds and failure patterns from the self-evolution engine to inform code decisions.
Blueprint
~15sGPT-5.4GPT-5.4 architects the mod structure: class hierarchy, registries, event subscriptions, and asset file layout.
Draft
~1-3mGLM-5.2GLM-5.2 implements the actual Java source code, Fabric API calls, and generates textures/assets for the mod.
Audit
~30sKimi K3Kimi K3 reviews the drafted code for API mismatches, missing imports, logic errors, and performance issues.
Compile
~1-2mBuild ServerThe Gradle build system compiles Java sources, packages assets, and produces a signed .jar file.
Package
~5sBuild ServerFinal artifact verification, source code bundling, and cloud delivery with instant download link.
Self-Evolution Engine
The system learns from every build. Successes and failures are analyzed, categorized, and fed back into the pipeline to improve future generations automatically.
Pattern Recognition
Identifies which code patterns compile successfully across different Minecraft versions and loader combinations.
Error Classification
Build failures are categorized into 60+ known error types. Each feeds a specific fix into the retry logic.
Prompt Optimization
Successful generations refine the system prompts. The AI learns what wording produces better code.
Template Evolution
The guaranteed-compiling fallback templates are continuously improved with real working code snippets.
Supported Mod Loaders
Currently Fabric is fully supported. NeoForge and Forge are on the roadmap.
Lightweight, modular, and fast. Our primary target with the most mature support.
Next-gen Forge fork. Full support planned for Q3 2026.
Classic Forge. Legacy compatibility layer in development.
Multi-loader abstraction. Will enable single-generation multi-platform builds.
Minecraft 26.2+ Technical Specs
The generator targets the latest stable Minecraft release with modern Java and data-driven components.
Latest stable release. 26.1.x support maintained for backward compatibility.
Required for modern language features and performance improvements.
Lightweight mod loading with fast iteration and minimal overhead.
Modern item data system replacing NBT for cleaner, type-safe item properties.
Custom blocks, items, entities, and dimensions registered at runtime.
Hook into player interaction, world generation, entity spawning, and more.
API Endpoints
The mod generator exposes a REST API for programmatic access. Authentication is via Supabase JWT.
/api/mod-pipeline/startAuth RequiredStart a new mod generation pipeline. Returns a jobId for polling.
{ description, side, version, loader }/api/mod-pipeline/start?jobId={id}PublicPoll the status of an active generation job.
/api/mod-pipeline/start?jobId={id}&result=trueAuth RequiredDownload the completed .jar artifact after status returns done.
/api/mod-clarifyPublicPre-generation system detection and complexity estimation.
{ prompt }/api/mod-creditsAuth RequiredGet current credit balance and transaction history.
/api/mod-credits-checkoutAuth RequiredInitiate Stripe checkout for credit packs or subscriptions.
{ pack, subscription, userId, email }Evolution Dashboard
Watch the self-evolution engine in real-time. See build success rates, error patterns, model performance metrics, and how the system improves over time.
Open Evolution DashboardReady to Generate?
Head to the generator and describe your mod idea in plain English. The tri-model pipeline handles the rest.
Open the Generator