Eyelib

the renderer lib for Minecraft.

English | 中文

The lib is published to Maven Central.

Eyelib supports multiple Minecraft / loader combinations. Each combination is a separate artifact with a version following the format:

{mod_version}+{minecraft_version}-{loader}

Pick the one that matches your target:

Check Maven Central for the latest available mod_version.

Groovy DSL (build.gradle):

repositories {
    mavenCentral()
}

dependencies {
    implementation "io.github.tt432:eyelib:21.1.14+1.20.1-forge"
}

Kotlin DSL (build.gradle.kts):

repositories {
    mavenCentral()
}

dependencies {
    implementation("io.github.tt432:eyelib:21.1.14+1.20.1-forge")
}

If your mod will bundle eyelib inside its own jar instead of requiring users to install it separately, use jarJar (Forge / NeoForge) in addition to compileOnly.

<dependency>
    <groupId>io.github.tt432</groupId>
    <artifactId>eyelib</artifactId>
    <version>21.1.14+1.20.1-forge</version>
</dependency>

Add eyelib as a dependency in your mod metadata so the loader enforces it at runtime.

Forge — src/main/resources/META-INF/mods.toml:

[[dependencies."your_mod_id"]]
    modId="eyelib"
    mandatory=true
    versionRange="[21.1.14,)"
    ordering="AFTER"
    side="CLIENT"

NeoForge — src/main/resources/META-INF/neoforge.mods.toml:

[[dependencies."your_mod_id"]]
    modId="eyelib"
    mandatory=true
    versionRange="[21.1.14,)"
    ordering="AFTER"
    side="CLIENT"

The versionRange uses the mod version (21.1.14) without the +mc-loader suffix, because that is the version the mod reports in-game. Set side to "CLIENT" (eyelib is a client-side rendering library) or "BOTH" depending on your needs.

• Handwritten recursive-descent parser for Molang (ANTLR removed).
• jdk-classfile-backport for generate bytecode for Molang.
• lombok for generate getter/setter and more.
• Chin for utils.

|- Architecture decisions: docs/decisions/ |- Module boundaries: docs/decisions/0002-module-boundaries.md |- Side boundaries: docs/decisions/0003-side-boundaries.md |- Generated code policy: docs/decisions/0004-generated-code-policy.md |- Functional module debt ledger: docs/decisions/0005-mc-debt-ledger.md