Runecraft Core

Compatibility patch mod for the Runecraft modpack (Minecraft 1.20.1, Forge 47.3.0+). Fixes broken model references, loot-modifier syntax, and missing assets in third-party mods via bundled resource/data overrides + one Mixin.

What this mod is

Mostly it is a Forge-branded resource + data pack with a manifest. The JAR ships:

An assets/ tree that overrides broken model JSONs in third-party mods (goblins_tyranny, simply_traps) via Forge's built-in resource-pack ordering.
A data/ tree that overrides one loot modifier (nethersdelight), five empty loot tables + one Patchouli book-metadata file (dtarsnouveau), and bundles the Runecraft treasure bag datapack under the runic_loot namespace (consumed by the Treasure Bags mod).
One functional Mixin (SpellFilterMixin) — a Gson API compat redirect for Iron's Spellbooks that the resource tree cannot replace.
A tiny Java runtime that, on common setup, reads patch-manifest.json and walks every installed mod to log a version-diagnostic report, then runs a loot-reference validator that resolves every bundled treasure-bag reward id against the live item registry. It performs no patching at runtime — the patches are the bundled files riding on Forge's normal override order.

Current shipped version: 0.9.3 — 27 patches, schema version 2, plus the runic_loot treasure-bag datapack (28 profession sacks × 4 rarities + a starter bag).

Runecraft Core has no dependency on FTB Quests, ExtraQuests, or any quest mechanic. The bundled treasure bags drop via the Treasure Bags mod's own dropsFromGroups system, independent of the pack's questbook.

Building

Requirements:

JDK 17
Internet access to reach maven.minecraftforge.net and repo.spongepowered.org the first time.

./gradlew build

Produces build/libs/runecraftcore-0.9.3.jar.

Compile-time dependency

SpellFilterMixin targets io.redspace.ironsspellbooks.loot.SpellFilter. To compile the mixin against the real class, drop the Iron's Spellbooks jar (e.g. irons_spellbooks-forge-1.20.1-3.15.5.1.jar) into libs/:

libs/
└── irons_spellbooks-forge-1.20.1-3.15.5.1.jar

build.gradle picks up everything in libs/*.jar as compileOnly so the mixin compiles but the jar stays self-contained. At runtime, the mixin is a no-op when Iron's Spellbooks is absent (required: true plus defaultRequire: 1 — Mixin simply skips missing targets).

Layout

runecraft_core/
├── build.gradle                  ForgeGradle 6 + Mixin plugin
├── gradle.properties
├── settings.gradle
├── docs/
│   ├── PATCH_MATRIX.md           human-readable patch index
│   └── RECREATION_AND_EXPANSION_PLAN.md
└── src/main/
    ├── java/com/otectus/runecraftcore/
    │   ├── RunecraftCore.java              entrypoint (@Mod)
    │   ├── RunecraftCoreConfig.java        Forge config spec
    │   ├── mixin/SpellFilterMixin.java     Gson API compat redirect
    │   └── patch/                          manifest + validators
    │       ├── JsonFieldSpec.java
    │       ├── PatchEntry.java
    │       ├── PatchManifest.java
    │       ├── PatchStatus.java
    │       ├── PatchType.java
    │       ├── PatchValidator.java
    │       ├── LootReferenceIndex.java     loads runic_loot_reference_index.json
    │       └── LootReferenceValidator.java checks bag rewards vs item registry
    └── resources/
        ├── META-INF/mods.toml
        ├── pack.mcmeta
        ├── runecraftcore.mixins.json
        ├── patch-manifest.json             27-entry schema-v2 manifest
        ├── runic_loot_reference_index.json bag → reward-id index (regenerate on edits)
        ├── assets/                         19 bundled model overrides (goblins_tyranny, simply_traps)
        └── data/
            ├── nethersdelight/, dtarsnouveau/  bundled loot/metadata overrides
            └── runic_loot/                 treasure-bag types + loot tables

Installation

Drop runecraftcore-<version>.jar into the modpack's mods/ folder. On startup you should see:

Runecraft Core loaded — patching third-party mod resources
…
=== Runecraft Core Patch Validation ===
Manifest version: 0.9.3 | Schema: v2
Total patches: 27 (active: 27, deprecated: 0, under_review: 0, disabled: 0)
  [FOUND] goblins_tyranny v1.2.3 - 18 patches (18 active)
  [FOUND] simply_traps v1.7 - 1 patches (1 active)
  [FOUND] nethersdelight v1.20.1-4.0 - 1 patches (1 active)
  [FOUND] dtarsnouveau v1.20.1-1.2.0 - 6 patches (6 active)
  [FOUND] irons_spellbooks v1.20.1-3.16.1 - 1 patches (1 active)
=== Summary: 5/5 target mods detected, 0 version mismatches ===
…
=== Runecraft Core Loot Reference Validation ===
Loot index version: 0.9.3 | Schema: v1 | 113 bags | 2 tag ref(s)
=== Loot Summary: 0 bag(s) with rot, 0 unknown-from-loaded item(s), 0 absent-mod item(s) ===

Configuration

config/runecraftcore-common.toml:

[general]
  # When true, version mismatch warnings for patched mods are logged at WARN level.
  # When false (default), they are logged at INFO level.
  strictMode = false

  # List of patch IDs to "disable" (see docs/PATCH_MATRIX.md).
  # In 0.9.x this is advisory only — the validator logs the entries as
  # disabled but the bundled resources still take effect.
  disabledPatches = []

  # When true, the treasure-bag loot validator escalates "unknown item from a
  # loaded mod" findings from WARN to ERROR (for CI / server-start smoke tests).
  # An unknown id whose owning mod is simply absent stays at INFO (expected).
  strictLoot = false

Treasure bags (`runic_loot` datapack)

The jar bundles the Runecraft treasure-bag content consumed by the Treasure Bags mod: 28 profession sacks (alchemists, miners, relichunters, merchants, collectors, beastmasters, wayfarers, …) each in common/uncommon/rare/epic, plus a single-grant starter bag. Definitions live in data/runic_loot/treasurebags_types/ and their loot tables in data/runic_loot/loot_tables/bags/.

Drop sources are gated by rarity (group runecraft_sacks): common/uncommon drop from hostile, rare from hostile+boss, epic from boss only. No bag drops from peaceful mobs or players.

Editing rewards:

Edit the loot tables under data/runic_loot/loot_tables/bags/.
Regenerate the validator index so startup validation stays accurate. The index is runic_loot_reference_index.json (one entry per bag → the item ids it references). On next launch LootReferenceValidator reports any reward id that no longer resolves against the installed mods.

The starter bag has no drop groups and is never handed out by this mod (no first-spawn listener, by design). Grant it externally, e.g. /givebag @p runic_loot:starter from a server script or a KubeJS PlayerEvents.loggedIn first-join handler in the pack.

Roadmap

See docs/RECREATION_AND_EXPANSION_PLAN.md for the full 0.10.0→0.13.0 expansion plan (runtime reference repair, recipe guarding, tooltip provider, tuning engine, orphan advisor, diagnostics command, public API).