Skip to content

Building from Source

github-actions[bot] edited this page Nov 3, 2026 · 2 revisions

Building from Source

Requirements

  • JDK 17
  • Internet access for Gradle (Forge/Minecraft dependencies)

Layout

One repository, two Gradle projects:

Project Directory Mod id
Core mod repository root simple_bytestorage
Scripting addon scripting/ simple_bytestorage_scripting

The addon compiles against the core mod's classes (compileOnly project(':').sourceSets.main.output) and bundles Rhino 1.7.15 into its own jar. The core jar contains no Rhino.

Build

./gradlew build --no-daemon

Output (re-obfuscated jars for the game):

  • build/reobfJar/output.jar — core mod
  • scripting/build/reobfJar/output.jar — scripting addon

The files in build/libs/ are the dev (deobfuscated) jars.

To build only the addon: ./gradlew :scripting:build.

Versions

The version is set in each project's build.gradle (version = '1.0.0+build.N') and mirrored in each mods.toml. Bump the build number for every new build.

Continuous integration

.github/workflows/build.yml builds on every push to main, uploads separate artifacts (simple_bytestorage-mod-jar, simple_bytestorage_scripting-addon-jar, dev jars) and publishes raw jars to a GitHub Release (build-<run number>).

Using the core API from another mod

CraftingService.requestCraft(IGrid, ItemStack, int) orders a craft. Nodes implement IGridNode; see Logic Bus in the addon for a complete example. The guide book accepts extra chapters via GuideRegistry.register(...) (see Guide Book).

Clone this wiki locally