/Cleanroom

Cleanroom Minecraft.

Primary LanguageJavaGNU Lesser General Public License v2.1LGPL-2.1

Cleanroom Minecraft

Features

Implemented

  • 1.12.2 on Java 21
  • LWJGL3
  • A working mod development template/kit
  • Patches for loading incompatible mods
  • Built-in Mixin

Planning

  • CleanroomGradle to replace ForgeGradle
  • No more Late and Early mixin
  • Classfile API
  • Scala 3 + Kotlin 2
  • Actually useful APIs (See here)
  • Optimized
  • Compatibility

Components:

  • Minecraft Coder Pack
  • CleanroomLoader (Continuation + Revamp of ForgeModLoader)
  • Cleanroom Minecraft (Continuation + Revamp of MinecraftForge)
  • Mixin (Coming Soon)
  • Bytecode Patcher (Coming Soon) [Inspired by Bansoukou and Bytecode Patcher]
  • Fugue, a mod patches many incompatibilities. (temporary)

Build Instructions:

  1. Clone this repository
  2. Import the build.gradle into your IDE (most preferably IntelliJ IDEA)
  3. Once the import has finished, run gradlew setup
  4. Build with gradlew build

Development Tips:

  • Only modify projects/cleanroom/src/ directory if you want to change vanilla
  • Run gradlew genPatches before commit, or the changes won't exist
  • Modifications on src/ doesn't need generating patches
  • Tips from Forge are still apply, keep the patches clean!
  • The current patches is full of useless hunks after we switched to VineFlower, we encourage contributors to manual clean up their patches

Mod Development:

There's an unofficial template exist. Note: You need to build before run.

Roadmap flow chart

graph TD;
    A(Mixin integration)-->D(Bouncepad overhaul - we are here);
    B(LWJGL compat)-->D;
    C(Newer Java compat)-->D;
    D-->E(Config any time);
    D-->G(Minor improvement and fixes)
    E-->F(Greater improvement needs configs)
    X(Cleanroom Gradle)-->D
    D-->X
    D-->Y(Better Mixin Integration)
    Y-->D
Loading