fix: match vanilla mining and placement behavior

.github/workflows/pr.yml

@@ -27,16 +27,20 @@ jobs:
           dotnet-version: 10.0.401
       - run: dotnet restore
       - run: dotnet build --no-restore -c Release
+      # Run one test project at a time; each assembly keeps its own concurrency.
       - name: Test
         if: matrix.os != 'ubuntu-latest'
-        run: dotnet test --no-build -c Release
+        run: dotnet test --no-build -c Release -m:1
       - name: Test with count gate
         if: matrix.os == 'ubuntu-latest'
         shell: bash
         run: |
           set -o pipefail
-          dotnet test UMPK.sln --no-build -c Release 2>&1 | tee /tmp/umpk-test.log
+          dotnet test UMPK.sln --no-build -c Release -m:1 2>&1 | tee /tmp/umpk-test.log
           python3 engineering/testcounts/check_test_counts.py /tmp/umpk-test.log --baseline engineering/testcounts/expected_counts.json
+      - name: Test owned vanilla launcher and RCON
+        if: matrix.os == 'ubuntu-latest'
+        run: python3 -m unittest discover -s tools/minecraft-official -p 'test_*.py' -v
 
   format:
     name: format check
@@ -46,7 +50,7 @@ jobs:
       - uses: actions/setup-dotnet@v5
         with:
           dotnet-version: 10.0.401
-      - run: dotnet format --verify-no-changes
+      - run: dotnet format --verify-no-changes --verbosity diagnostic
 
   datagen-verify:
     name: dataset verify + generated-code freshness

.skills/umpk-integration-testing/SKILL.md

@@ -12,7 +12,7 @@ Use the repository's `Umpk.IntegrationTests` live harness. It boots one isolated
 ## Read first
 
 - Read `references/minecraft-official.md` before provisioning or decompiling game artifacts.
-- Read `tests/Umpk.IntegrationTests/LiveMatrix.cs` for the 49 protocol representatives.
+- Read `tests/Umpk.IntegrationTests/LiveMatrix.cs` for the current protocol representatives.
 - Read the affected live test before running it. Its assertions define the claimed coverage.
 
 ## Workflow
@@ -23,10 +23,10 @@ Use the repository's `Umpk.IntegrationTests` live harness. It boots one isolated
 4. Build UMPK in Release mode.
 5. Run the focused live leg with fresh output under `/tmp`.
 6. Run the adjacent era boundary when the behavior is version-sensitive.
-7. Run `scripts/run_live_matrix.sh` only after all 49 representatives are provisioned.
+7. Run `scripts/run_live_matrix.sh` only after all representatives in `LiveMatrix` are provisioned.
 8. Confirm no server process or listener owned by the run remains.
 
-Never use another checkout's binaries, server directory, Java source tree, or logs. Set `UMPK_SERVER_ROOT` and `UMPK_ORACLE_ROOT` explicitly when the repository-local defaults are not used.
+Use the shared verified artifact seeds. Do not reuse another run's binaries, mutable server directory, or logs. Set `UMPK_SERVER_ROOT` and `UMPK_ORACLE_ROOT` explicitly for the shared artifact root.
 
 ## Location overrides
 
@@ -39,7 +39,7 @@ python3 .skills/umpk-integration-testing/scripts/provision_servers.py \
   --root "$UMPK_ORACLE_ROOT" --accept-eula 26.2
 ```
 
-`UMPK_ORACLE_ROOT` owns downloads, mappings, and `<version>-decompiled` source trees. `UMPK_SERVER_ROOT` owns the per-version directories consumed by the live Harness; omit it when those directories are at `$UMPK_ORACLE_ROOT/downloads`. `--root` overrides the provisioner's destination. Use absolute paths and keep both roots outside tracked repository content.
+`UMPK_ORACLE_ROOT` owns downloads, mappings, and `<version>-decompiled` source trees. `UMPK_SERVER_ROOT` owns the per-version directories consumed by the live Harness; omit it when those directories are at `$UMPK_ORACLE_ROOT/downloads`. `--root` overrides the provisioner's destination. Use absolute paths and keep both roots outside tracked repository content. On this workstation, use `/home/anon/Projects/MinecraftOfficial` and its `downloads` directory.
 
 ## Provisioning
 
@@ -48,14 +48,14 @@ python3 .skills/umpk-integration-testing/scripts/provision_servers.py \
   --accept-eula 1.8 1.12.2 1.16.5 1.20.4 1.21.11 26.2
 ```
 
-The script downloads official artifacts, verifies Mojang's SHA-1, and writes them below the ignored `MinecraftOfficial/downloads/<version>/` tree. It never places artifacts in tracked paths.
+The script downloads official artifacts and verifies Mojang's SHA-1. It writes to the shared `MinecraftOfficial/downloads/<version>/` tree by default. `--root` selects another external directory.
 
 ## Running
 
 ```bash
 dotnet build UMPK.sln -c Release
 UMPK_NIGHTLY=1 \
-UMPK_SERVER_ROOT="$PWD/MinecraftOfficial/downloads" \
+UMPK_SERVER_ROOT="$HOME/Projects/MinecraftOfficial/downloads" \
 dotnet test tests/Umpk.IntegrationTests/Umpk.IntegrationTests.csproj \
   -c Release --no-build --filter 'Category=Nightly'
 ```
@@ -86,3 +86,5 @@ A result is valid only when its assertion is caused by a fresh action in that le
 ## When not to use
 
 Do not use this skill for build-only checks, static source comparison, documentation-only changes, or public-server testing. Public servers and authenticated accounts require explicit authorization.
+
+Read `.skills/umpk-version-adaptation/SKILL.md` for protocol-version work. The adapted `tools/decompile.sh` and `tools/start-server.sh` use the shared artifact root. Server infrastructure smoke checks do not replace this live feature harness.

.skills/umpk-integration-testing/references/minecraft-official.md

@@ -1,79 +1,17 @@
-# Local vanilla artifacts and Java source
+# Local vanilla artifacts and source
 
-Keep official Minecraft artifacts below the repository-local, ignored `MinecraftOfficial/` directory:
-
-```text
-MinecraftOfficial/
-├── downloads/<version>/server.jar
-├── downloads/<version>/server_mappings.txt
-├── downloads/<version>/client.jar
-├── downloads/<version>/client_mappings.txt
-├── <version>-decompiled/
-└── <version>-client-decompiled/
-```
-
-Never commit jars, mappings, libraries, generated worlds, or decompiled Mojang source.
-
-## Create and provision the directory
+Use `/home/anon/Projects/MinecraftOfficial` on this workstation. The portable default is `~/Projects/MinecraftOfficial`. Read `tools/minecraft-official/README.md` from the repository root for hashes, mapping routes, private JVMs, decompiler warnings, and isolated server runs.
 
 ```bash
-mkdir -p MinecraftOfficial/downloads
-python3 .skills/umpk-integration-testing/scripts/provision_servers.py \
-  --accept-eula --client 1.21.11
-export UMPK_ORACLE_ROOT="$PWD/MinecraftOfficial"
+export UMPK_ORACLE_ROOT="$HOME/Projects/MinecraftOfficial"
 export UMPK_SERVER_ROOT="$UMPK_ORACLE_ROOT/downloads"
+export UMPK_JAVA11="$UMPK_ORACLE_ROOT/runtimes/java11/bin/java"
+export UMPK_JAVA25="$UMPK_ORACLE_ROOT/runtimes/java25/bin/java"
+bash tools/decompile.sh --version 1.21.11 --side both --accept-eula
 ```
 
-The provisioner resolves Mojang's version manifest, downloads official artifacts, and verifies every download against the SHA-1 in the version metadata. Omit `--accept-eula` unless you accept Mojang's EULA.
-
-## Override the artifact locations
-
-Use an absolute oracle root when jars, mappings, and decompiled trees live outside this checkout:
-
-```bash
-export UMPK_ORACLE_ROOT=/absolute/path/to/MinecraftOfficial
-python3 .skills/umpk-integration-testing/scripts/provision_servers.py \
-  --root "$UMPK_ORACLE_ROOT" --accept-eula 26.2
-```
-
-The provisioner and extraction tools use `UMPK_ORACLE_ROOT`. The live Harness uses `UMPK_SERVER_ROOT`, whose default is `$UMPK_ORACLE_ROOT/downloads`. Override it independently when the runnable server directories are elsewhere:
-
-```bash
-export UMPK_SERVER_ROOT=/absolute/path/to/server-directories
-```
-
-Expected layouts are `$UMPK_ORACLE_ROOT/<version>-decompiled/` for source and `$UMPK_SERVER_ROOT/<version>/server.jar` for a runnable server.
-
-## Decompile readable Java
-
-Use a compatible JDK and Vineflower. Official Mojang mappings are available for modern releases. UMPK's remapper converts their named-to-obfuscated form before decompilation.
-
-Place these untracked tools at:
-
-```text
-MinecraftOfficial/downloads/decompiler/vineflower.jar
-MinecraftOfficial/downloads/libs/asm-9.6.jar
-```
-
-Then run the repository pipeline for the supported remap band:
-
-```bash
-export UMPK_ORACLE_ROOT="$PWD/MinecraftOfficial"
-tools/extraction/decompile_1_16_to_1_18.sh 1.16.5 1.17.1 1.18.2
-python3 tools/extraction/decompile.py 1.18.2
-```
-
-For another version with `server_mappings.txt`, follow the same stages:
-
-1. If `server.jar` is a bundler, extract its inner server jar from `META-INF/versions/`.
-2. Compile `tools/extraction/ProguardRemapper.java` with ASM and ASM Commons.
-3. Remap the inner jar with that version's `server_mappings.txt`.
-4. Run Vineflower on the remapped jar.
-5. Store the result at `MinecraftOfficial/<version>-decompiled/`.
-6. Run `python3 tools/extraction/decompile.py <version>` to verify discovery and mapping provenance.
-
-For client-only packet behavior, repeat the process with `client.jar` and `client_mappings.txt`, then store the result at `MinecraftOfficial/<version>-client-decompiled/`.
+Use `--accept-eula` only with EULA acceptance. Official jars and available mappings live in `downloads/<version>/`. Server source lives in `<version>-decompiled/`. Client source lives in `<version>-client-decompiled/` when requested. Check `artifacts.json` and `.complete.json` before citing evidence. Never commit official artifacts or source.
 
-Minecraft 1.8 through 1.14.3 require compatible community mappings because Mojang did not publish the modern mapping artifact for those releases. Protocol 47 expects the MCP 1.8.9 tree at `MinecraftOfficial/1.8.9/src/minecraft/`.
+MinecraftDecompiler remaps official Proguard mappings. Vineflower decompiles the remapped jar or an already unobfuscated jar. Releases without official mappings retain obfuscated names and carry the `obfuscated-no-community-mappings` label. Do not use them as readable MCP source. Protocol 47's named legacy oracle still requires a compatible community-mapped 1.8.9 tree at `<root>/1.8.9/src/minecraft/`.
 
-Use `tools/oracle.sh <version> <Class.java[:line]>` to resolve a source citation. Pass `--oracle "$UMPK_ORACLE_ROOT"` to DataGen layout comparisons.
+Use `tools/oracle.sh <version> <Class.java[:line]>` to resolve source citations. Pass `--oracle "$UMPK_ORACLE_ROOT"` to DataGen layout comparisons. The existing live harness copies `downloads/<version>` seeds into temporary directories. Do not boot or mutate the shared seeds during live tests.

.skills/umpk-integration-testing/scripts/preflight.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
 repo_root=$(CDPATH= cd -- "$script_dir/../../.." && pwd)
-official_root=${UMPK_ORACLE_ROOT:-$repo_root/MinecraftOfficial}
+official_root=${UMPK_ORACLE_ROOT:-${MINECRAFT_OFFICIAL_ROOT:-$HOME/Projects/MinecraftOfficial}}
 server_root=${UMPK_SERVER_ROOT:-$official_root/downloads}
 
 for command in dotnet python3 java git pgrep grep; do

.skills/umpk-integration-testing/scripts/provision_servers.py

@@ -47,9 +47,8 @@ def ensure_download(entry: dict, destination: Path) -> None:
 
 
 def default_root() -> Path:
-    repo_root = Path(__file__).resolve().parents[3]
     configured = os.environ.get("UMPK_ORACLE_ROOT")
-    return Path(configured).expanduser().resolve() if configured else repo_root / "MinecraftOfficial"
+    return Path(configured).expanduser().resolve() if configured else Path(os.environ.get("MINECRAFT_OFFICIAL_ROOT", str(Path.home() / "Projects" / "MinecraftOfficial"))).expanduser().resolve()
 
 
 def main() -> int:

.skills/umpk-integration-testing/scripts/run_live_matrix.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
 repo_root=$(CDPATH= cd -- "$script_dir/../../.." && pwd)
-official_root=${UMPK_ORACLE_ROOT:-$repo_root/MinecraftOfficial}
+official_root=${UMPK_ORACLE_ROOT:-${MINECRAFT_OFFICIAL_ROOT:-$HOME/Projects/MinecraftOfficial}}
 server_root=${UMPK_SERVER_ROOT:-$official_root/downloads}
 output=${UMPK_LIVE_LOG:-/tmp/umpk-live-matrix.log}
 

.skills/umpk-version-adaptation/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: umpk-version-adaptation
+description: Adapt UMPK Java protocol versions using vanilla artifacts, canonical datasets, generated tables, wire witnesses, and live boundary tests. Use for new version support or cross-version protocol mismatches.
+---
+
+# UMPK version adaptation
+
+Read `docs/contributing/adding-a-version.md` before editing. UMPK owns protocol codecs, registries, world data, movement, and physics.
+
+## Artifact evidence
+
+Read `tools/minecraft-official/README.md` from the repository root. Use `/home/anon/Projects/MinecraftOfficial` on this workstation. Set `MINECRAFT_OFFICIAL_ROOT` and `UMPK_ORACLE_ROOT` explicitly when selecting another root.
+
+Run `bash tools/decompile.sh --version <version>` for server source. Add `--side client` for client behavior. Check the downloaded artifact hashes and each tree's `.complete.json`. An obfuscated legacy tree cannot satisfy a check that requires readable MCP class names. Decompiler warnings require inspection of the affected methods.
+
+Generate vanilla data reports with the matching jar and compatible Java when that release supports them. Put reports in a fresh external directory. Read UMPK's extraction guide for the correct invocation in each era. Runtime reports determine registry and block-state identifiers. Source field order alone cannot establish those identifiers. A stable packet identifier does not prove a stable layout, registry, feature axis, or lifecycle obligation.
+
+## Implement through the existing dataset pipeline
+
+1. Determine whether the release aliases an existing protocol. Preserve codec timelines and pins for an alias.
+2. Compare matching vanilla jars, mappings, reports, and source for each changed boundary. Record hashes and source citations.
+3. Extract canonical datasets with `tools/extraction/`. Review feature values against vanilla evidence. Obtain authorization for dataset changes when it is absent.
+4. Run DataGen verification and dataset comparisons. Use the layout oracle as a source comparison aid, not a conformance gate.
+5. Regenerate data, language, and codec tables through DataGen. Never edit `.g.cs` files or generated pins directly.
+6. Add a timeline step only when the packet's wire form changes. Keep era rules in dataset features or existing profiles.
+7. Add the required literal rows, real-frame round trips, adjacent-band rejection witnesses, and conformance pins through their documented procedures.
+8. Run focused tests, adjacent protocols, a live vanilla leg, and the complete repository gates.
+
+Do not restore MCC 1.x palette classes, `Protocol18.cs`, or its generated physics data. Those responsibilities now belong to UMPK's canonical extraction and generation pipeline. Vanilla artifacts and real captures remain the acceptance oracle.
+
+For live proof, use `.skills/umpk-integration-testing/SKILL.md`. Report executed commands, observed assertions, inferred conclusions, harness faults, and unexecuted checks separately.

AGENTS.md

@@ -19,8 +19,9 @@ Initialize the shared skills with `git submodule update --init MCC-Skills`.
 | `.skills/dmcbk-marketplace-authoring/SKILL.md` | Schema-2 plugin catalogues and releases |
 | `.skills/asd-ste100/SKILL.md` | Unambiguous procedures, errors, and agent instructions |
 | `.skills/umpk-integration-testing/SKILL.md` | Isolated live tests against vanilla servers |
+| `.skills/umpk-version-adaptation/SKILL.md` | Source-backed version changes through the owning library and package boundaries |
 
-Eight `.skills` entries, including ASD-STE100, link to the pinned [MCC Skills](https://github.com/MCCTeam/MCC-Skills) submodule under `MCC-Skills/skills`. UMPK integration testing remains local. `.claude/skills`, `.agents/skills`, `.codex/skill` and `.codex/skills` link to `.skills`.
+Eight `.skills` entries, including ASD-STE100, link to the pinned [MCC Skills](https://github.com/MCCTeam/MCC-Skills) submodule under `MCC-Skills/skills`. UMPK integration testing and version adaptation remain local. `.claude/skills`, `.agents/skills`, `.codex/skill` and `.codex/skills` link to `.skills`.
 
 Read a matching `SKILL.md` before using a skill. Resolve its relative references from its own directory. Edit shared skills in MCC Skills rather than creating another local copy. Read [agent skills](docs/contributing/agent-skills.md) before updating the submodule revision.
 
@@ -39,6 +40,25 @@ Read a matching `SKILL.md` before using a skill. Resolve its relative references
 
 For the count gate, capture the unfiltered full test output in `/tmp/umpk-test.log`. Never store raw test logs in the repository.
 
+## Shared vanilla artifacts
+
+Use `/home/anon/Projects/MinecraftOfficial` on this workstation. The portable default is `~/Projects/MinecraftOfficial`. Read [the artifact tool guide](tools/minecraft-official/README.md) before provisioning or starting a server.
+
+```bash
+export MINECRAFT_OFFICIAL_ROOT="$HOME/Projects/MinecraftOfficial"
+export UMPK_ORACLE_ROOT="$MINECRAFT_OFFICIAL_ROOT"
+export UMPK_SERVER_ROOT="$MINECRAFT_OFFICIAL_ROOT/downloads"
+export MCC_SERVERS="$UMPK_SERVER_ROOT"
+export UMPK_JAVA11="$MINECRAFT_OFFICIAL_ROOT/runtimes/java11/bin/java"
+export UMPK_JAVA25="$MINECRAFT_OFFICIAL_ROOT/runtimes/java25/bin/java"
+```
+
+Official jars and available mappings live in `downloads/<version>/`. Server source lives in `<version>-decompiled/`. Client source lives in `<version>-client-decompiled/` when requested. Check `artifacts.json` and `.complete.json` before using them as evidence. Legacy trees marked `obfuscated-no-community-mappings` do not provide readable MCP names.
+
+Use `bash tools/decompile.sh --version <version>` for server source. Add `--side client` for client source. Use `--all-releases --through 26.3 --side both --download-only` to provision both jars across the stable release range. Add `--accept-eula` only with the user's EULA acceptance. Never commit official artifacts, source trees, worlds, credentials, or raw logs.
+
+Use `bash tools/start-server.sh <version> --port <unused-port> --rcon-port <unused-rcon-port>` for an isolated local server. The launcher copies a seed into a fresh run directory. Keep shared seeds unchanged during live tests. Stop only processes owned by the run. Server startup and RCON readiness do not prove client behavior.
+
 ## Architecture
 
 ```mermaid

README.md

@@ -4,7 +4,7 @@
 
 UMPK, the Universal Minecraft Protocol Kit, is a .NET 10 toolkit for programs that need to speak Minecraft Java Edition. Use it to build bots, automated players, protocol tools, and other clients without running the official game. The library handles the wire protocol, sessions, game state, authentication, chat, inventory, and movement.
 
-UMPK supports 49 Java protocol revisions across 72 named Minecraft releases. Protocol data comes from Mojang artifacts, vanilla source, and recorded server traffic. Version differences live in data and capability tables instead of separate client forks.
+UMPK supports 50 Java protocol revisions across 75 named Minecraft releases. Protocol data comes from Mojang artifacts, vanilla source, and recorded server traffic. Version differences live in data and capability tables instead of separate client forks.
 
 > [!WARNING]
 > UMPK is still in heavy development. APIs, behavior, and documentation are subject to change. Pin the version or commit that your application uses.
@@ -46,7 +46,7 @@ UMPK supports Java Edition play protocols from 1.8 through 26.3.
 | 1.19 | 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4 |
 | 1.20 | 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6 |
 | 1.21 | 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11 |
-| 26.x | 26.1, 26.2, 26.3 |
+| 26.x | 26.1, 26.1.1, 26.1.2, 26.2, 26.3 |
 
 Minecraft versions earlier than 1.8 are not supported. The legacy status ping can read older server-list responses, but it does not provide play-protocol support. See the [protocol table](docs/reference/supported-versions.md) for protocol numbers and dataset mappings.