Repository navigation
Building from Source
jhfuheuiwfh edited this page Oct 11, 2026
·
2 revisions
Compile NEXUS Bodycam yourself β Java 17 target, Gradle 8.5, Fabric Loom.
| Tool | Notes |
|---|---|
| JDK 17 or 21 |
JAVA_HOME pointing to it. (On this project a JDK 8 on PATH is not usable.) |
| Git | to clone the repository |
| TACZ jar | goes into libs/ β not shipped in the repo (third-party binary), see libs/README.md
|
No global Gradle install is needed β the wrapper is included
(gradlew / gradlew.bat, Gradle 8.5).
git clone https://github.com/jhfuheuiwfh/nexus-bodycam-mod.git
cd nexus-bodycam-mod
# 1. put the TACZ jar in libs/ (compile-only dependency)
# libs/TACZ-Refabricated-1.20.1-0.7.1-forge1.1.8-hotfix2.jar
# 2. build
./gradlew build # Windows: gradlew.bat buildResult:
build/libs/NEXUS-bodycam-1.4.3+1.20.1.jar
Copy that jar into your mods folder to test it.
Windows tip: if
JAVA_HOMEis not set, run it inline:$env:JAVA_HOME='C:\Path\To\JDK-17' .\gradlew.bat build --no-daemon --console=plain
-
processResourcesstamps the version fromgradle.propertiesintofabric.mod.json. -
compileJavaβ Java 17, UTF-8,-Xlint:unchecked -Xlint:deprecation. - Loom remaps the jar to intermediary β
build/libs/β¦jar.
minecraft_version=1.20.1
yarn_mappings=1.20.1+build.10
loader_version=0.15.11
fabric_version=0.92.2+1.20.1
modmenu_version=7.2.2
mod_version=1.4.3+1.20.1
maven_group=dev.bodycam
archives_base_name=NEXUS-bodycamBump mod_version for every release and keep it in sync with the README/changelog.
| Error | Cause / fix |
|---|---|
Task 'build' not found |
You are not in the repo root (or build.gradle is missing) |
Mod was built with a newer version of Loom |
The TACZ jar still has Fabric-Loom-Version: / Fabric-Gradle-Version: lines in its MANIFEST β remove them |
tiny-remapper: unfixable conflicts |
Delete the four com/tacz/guns/client/renderer/item/*ItemRenderer.class files from the TACZ jar |
Unable to locate obfuscation mapping |
The jar must be on modCompileOnly, not plain compileOnly (already configured) |
| DNS / repository timeouts | Transient β just rerun the build |
| Out of memory |
org.gradle.jvmargs=-Xmx2G is already set; close other heavy apps |
βββ build.gradle # Fabric Loom build
βββ settings.gradle # rootProject.name = NEXUS-bodycam
βββ gradle.properties # versions
βββ gradlew / gradlew.bat # wrapper (Gradle 8.5)
βββ libs/ # local third-party jars (git-ignored)
βββ src/main/java/dev/bodycam/
β βββ camera/ # effects engine, springs, water, TACZ bridge
β βββ config/ # BodycamConfig (JSON, validated)
β βββ core/ # GameState + RenderCoordinator
β βββ gui/ # config screen
β βββ mixin/ # camera/entity/renderer mixins
β βββ compat/ # Iris bridge
βββ src/main/resources/
β βββ assets/bodycam/ # shaders, sounds, textures, lang
β βββ bodycam.mixins.json
β βββ bodycam.accesswidener
βββ docs/ # CHANGELOG.md Β· DEVNOTES.md
βββ media/ # demo GIFs
- Record every change in
docs/CHANGELOG.mdβ a task without a changelog entry counts as not done. - Keep the code working on 1.20.1 / Fabric only.
- Be honest about AI usage: see the AI transparency statement.
β Home Β· Installation Β· Troubleshooting