虚空工厂 / Void Factory

Minecraft 1.21.1 + NeoForge 科技向 mod。通过少量资源合成机器，自动化生产相关资源。

技术栈

项目	版本
Minecraft	1.21.1
NeoForge	21.1.233
ModDevGradle	2.0.141
Gradle Wrapper	9.2.1
Java	21

构建方法

gradlew.bat build

产物在 build/libs/voidfactory-1.0.0.jar（生产 JAR，可直接放入游戏 mods 文件夹）。 注意：不要使用 build/devlibs/voidfactory-1.0.0-dev.jar，那是开发版，在真实游戏混淆环境下无法运行。

开发调试

gradlew.bat runClient     :: 启动客户端
gradlew.bat runServer     :: 启动服务端
gradlew.bat runData       :: 生成数据资源到 src/generated/resources/

项目结构

src/main/
├── java/com/voidfactory/
│   ├── VoidFactory.java           @Mod 主入口
│   ├── client/                    客户端专属代码（Screen、渲染器、按键）
│   ├── config/                    ModConfigSpec 配置
│   ├── data/                      数据生成 Provider
│   └── registration/              所有 DeferredRegister 注册表
│       ├── ModBlocks.java
│       ├── ModItems.java
│       ├── ModBlockEntities.java
│       ├── ModMenus.java
│       ├── ModCreativeTabs.java
│       ├── ModRecipeTypes.java
│       ├── ModRecipeSerializers.java
│       └── ModDataComponents.java
├── resources/
│   ├── pack.mcmeta
│   └── assets/voidfactory/lang/   语言文件（en_us / zh_cn）
└── templates/
    └── META-INF/neoforge.mods.toml  带占位符的元数据模板

添加新机器的标准流程

1. 写 Block 子类（位于 block/ 子包）
2. 写 BlockEntity 子类（持有库存/能量/进度）→ blockentity/
3. 写 Menu + Screen → menu/ 和 client/screen/
4. 在 registration/Mod* 对应类里加一行注册
5. 运行 gradlew runData 生成方块状态/模型/配方 JSON