@@ -53,7 +53,7 @@ jobs:
           test ! -e "$GRADLE_USER_HOME"
           mkdir -p "$GRADLE_USER_HOME"
           chmod +x ./gradlew
-          ./gradlew verifyMavenizerCompatibilityFixture help \
+          ./gradlew classes verifyLegacyFixtures verifyMavenizerCompatibilityFixture \
             --no-daemon --no-build-cache --stacktrace --max-workers=2 \
             -Dorg.gradle.java.installations.paths="$JAVA_HOME,$JAVA_HOME_8_X64,$JAVA_HOME_25_X64" \
             -Dorg.gradle.java.installations.auto-detect=false \
@@ -68,14 +68,14 @@ jobs:
             | sort -z | xargs -0 -r sha256sum > "$RUNNER_TEMP/markers-before.sha256"
           test -s "$RUNNER_TEMP/markers-before.sha256"
 
-      - name: Verify same-cache preparation is idempotent
+      - name: Replay the compiled target offline
         shell: bash
         env:
           GRADLE_USER_HOME: ${{ runner.temp }}/orespawn-cold-gradle
         run: |
           set -euo pipefail
-          ./gradlew verifyMavenizerCompatibilityFixture help \
-            --no-daemon --no-build-cache --stacktrace --max-workers=2 \
+          ./gradlew classes verifyLegacyFixtures verifyMavenizerCompatibilityFixture \
+            --offline --rerun-tasks --no-daemon --no-build-cache --stacktrace --max-workers=2 \
             -Dorg.gradle.java.installations.paths="$JAVA_HOME,$JAVA_HOME_8_X64,$JAVA_HOME_25_X64" \
             -Dorg.gradle.java.installations.auto-detect=false \
             -Dorg.gradle.java.installations.auto-download=false
@@ -120,7 +120,7 @@ jobs:
       - name: Build, test, and audit release artifacts
         run: >-
           ./gradlew clean check build javadoc verifyReleaseArtifacts writeReleaseChecksums
-          verifyEclipseProductionClasspath --no-daemon --stacktrace
+          verifyEclipseProductionClasspath --no-daemon --no-build-cache --stacktrace
           -Dorg.gradle.java.installations.paths="$JAVA_HOME,$JAVA_HOME_8_X64,$JAVA_HOME_25_X64"
           -Dorg.gradle.java.installations.auto-detect=false
           -Dorg.gradle.java.installations.auto-download=false
@@ -132,9 +132,9 @@ jobs:
           if-no-files-found: error
           retention-days: 30
           path: |
-            build/libs/OreSpawn-4.0.16.120061.jar
-            build/libs/OreSpawn-4.0.16.120061-sources.jar
-            build/libs/OreSpawn-4.0.16.120061-javadoc.jar
+            build/libs/OreSpawn-4.1.0.120061.jar
+            build/libs/OreSpawn-4.1.0.120061-sources.jar
+            build/libs/OreSpawn-4.1.0.120061-javadoc.jar
             build/release/SHA256SUMS
             CHANGELOG.txt
 
 
@@ -1,3 +1,17 @@
+Version 4.1.0.120061
+
+* Add a Mods directory showing each installed mod's OreSpawn settings.
+* Add Ore Sources controls for shared ores, with Balanced, Single, Custom and Keep Original choices.
+* Start known shared MMD ores in Balanced mode, with one placement budget and all eligible outputs selected.
+* Add custom ore groups, review controls, resets and clearer placement-source choices.
+* Add a biome directory, exact replacements in new terrain and provider palette settings.
+* Make World Materials clearly dimension-wide rather than specific to the selected biome.
+* Keep missing-mod settings and saved world policies when upgrading profiles to schemas 5, 8 and 7.
+* Keep Help & Guide beside Recommended Defaults so the main menus fit smaller windows.
+* Restrict fluid-deposit block selection to fluids and wrap empty-list messages.
+* Clear native ore wrappers when a server stops so settings are rebuilt for the next world.
+* Split the build into smaller commented scripts, improve Eclipse test launches and use LF for shared text files.
+
 Version 4.0.16.120061
 
 * Leave benchmark shutdown to the GameTest harness when a benchmark is run
 
@@ -17,7 +17,7 @@ End" policy used by mods such as Base Metals.
 This is not the unrelated mod that adds mobs and dimensions under the same
 name.
 
-This branch builds target-qualified version `4.0.16.120061`: the OreSpawn 4.0.16
+This branch builds target-qualified version `4.1.0.120061`: the OreSpawn 4.1
 feature set for Minecraft 1.20.6 and Forge. See the
 [versioning policy](docs/VERSIONS.md) for the encoding and release convention.
 
@@ -54,6 +54,15 @@ Important files:
 Profile edits affect newly generated chunks. Ore and flat-bedrock retrogen are
 separate opt-in features; OreSpawn never retro-generates rock strata.
 
+**Ore Sources** groups ores by exact block tags such as `forge:ores/sulfur`.
+When two loaded ordinary MMD providers share one tag, new worlds use a
+Balanced output policy and one placement budget per channel. Older worlds keep
+their saved Keep Original behaviour. Imported Ore Dictionary aliases remain
+visible but dormant until you assign a known exact block tag. The **Biomes**
+directory can replace one loaded biome with another in new terrain; its
+**Overworld Materials** control applies across the dimension, not just the
+selected biome.
+
 When an already-generated world has saved Mineralogy 1.10, 1.12, or 5.x mod
 metadata but no OreSpawn world profile, OreSpawn reads the matching published
 configuration contract and records the exact engine, numeric settings, rock
@@ -119,8 +128,12 @@ and fixtures. Published jars are deterministic and retain Forge 50's official
 runtime names, are audited for their four access-transformer rules and contents, and
 accompanied by SHA-256 checksums.
 
-Machine-specific `AGENTS.md` and `agent-notes/` files are intentionally ignored.
-Public developer and AI integration guidance lives in `docs/` and is included
-in the built jar.
+Developer and player guides live in `docs/` and are included in the built jar.
+
+For shared-ore GUI testing, generate the Eclipse launches and open
+`runOreSourcesClient.launch` or `runTestOreSourcesClient.launch`. These add two
+test-only providers and keep your settings in `run-ore-sources`, separate from
+the ordinary launch. `oreSourcesClientIntegrationTest` runs the corresponding
+automated check without changing that manual profile.
 
 OreSpawn is licensed under LGPL-2.1.