SenjuWoo/Minecraft-Forge

A command-line workbench for making Minecraft Java mods with NeoForge, Fabric and Forge, built so an AI agent (or a person) can go from an idea to a verified, tested mod JAR: pinned official templates, one-command content generation (blocks, items, food, tools, weapons, armor, furniture, mobs), Blockbench import and export, free procedural art, popular libraries, resource/data/shader packs, launcher-aware deploys and evidence receipts for every build.
It is an independent project, unaffiliated with the Minecraft Forge project, NeoForged, FabricMC or Mojang; the name describes a workbench. Made with ATLauncher in mind and works with Prism, MultiMC, CurseForge, the Modrinth App and the official launcher.
Point an agent at this folder and tell it to read AGENTS.md. Nothing is registered globally and no server keeps running.
## Bundled targets
Every target is an official template pinned by hash, built and server-loaded in this repository's CI.
| Target | Loader | Minecraft | Java | Build system | Content kit (add writes Java) |
| neoforge-1.21.1 (default) | NeoForge 21.1.265 | 1.21.1 | 21 | ModDevGradle 2.0.148 | yes |
| neoforge-26.3 | NeoForge 26.3.0.103 | 26.3 | 25 | ModDevGradle 2.0.148 | assets + data |
| fabric-1.20.1 | Fabric Loader 0.20.1 | 1.20.1 | 17 | Loom 1.19.4 | yes |
| fabric-1.21.1 | Fabric Loader 0.20.1 | 1.21.1 | 21 | Loom 1.19.4 | yes |
| fabric-26.3 | Fabric Loader 0.20.1 | 26.3 | 25 | Loom 1.19.4 | assets + data |
| forge-1.20.1 | Forge 47.4.28 | 1.20.1 | 17 | ForgeGradle 6.0.54 | yes |
| forge-26.3 | Forge 66.1.8 | 26.3 | 25 | ForgeGradle 7.0.40 | assets + data |
Any other version: init ... --loader fabric --minecraft 1.19.2 --fetch resolves that official template on demand (pinned by hash, clearly marked as not built by this release). Quilt packs load Fabric mods.
## Use it
Requires Python 3.11+ (no packages) and a JDK (the toolkit finds installed ones and can install a verified Temurin with setup-java --major 17|21|25).
powershell
git clone https://github.com/SenjuWoo/Minecraft-Forge.git
cd Minecraft-Forge
.\Minecraft-Forge.ps1 doctor
.\Minecraft-Forge.ps1 instances # your launcher instances + the init options that match each
.\Minecraft-Forge.ps1 quickstart "D:\Mods\Ruby" --mod-id ruby --package dev.you.ruby --name "Ruby" --loader fabric --minecraft 1.21.1
.\Minecraft-Forge.ps1 add "D:\Mods\Ruby" toolset ruby --tier diamond
.\Minecraft-Forge.ps1 add "D:\Mods\Ruby" armor ruby --tier diamond
.\Minecraft-Forge.ps1 add "D:\Mods\Ruby" mob cave_boar --shape quadruped
.\Minecraft-Forge.ps1 add "D:\Mods\Ruby" furniture oak_chair
.\Minecraft-Forge.ps1 verify "D:\Mods\Ruby" # build + headless game-test server + receipt
.\Minecraft-Forge.ps1 deploy "D:\Mods\Ruby" --instance " " --apply
On Linux/macOS use python -m mcforge ... from this folder. install copies the toolkit to %LOCALAPPDATA%\Minecraft-Tools\Minecraft-Forge (or ~/.local/share/minecraft-forge) with a launcher; updates keep a backup.
## What you can make
| Want | Command | Guide |
| A mod for a loader and version | quickstart / init --loader L --minecraft V | guide neoforge, guide fabric, guide forge |
| Blocks, items, food | add P block NAME, add P item NAME, add P food NAME | guide content |