Pathfinding optimization

.gitignore

@@ -444,3 +444,6 @@ server.pid
 
 # Crowdin translation automation working directory
 /.crowdin-translate/
+
+# Third-party source code reference files
+ThirdpartyReference/

.skills/mcc-dev-workflow/SKILL.md

@@ -13,7 +13,7 @@ Use this skill when the task needs a real local server loop, not just code readi
 - Runtime target: `.NET 10` / `net10.0`
 - Environment: Linux, macOS, or WSL with Java, tmux, python3, and dotnet available
 - Default server root after `source tools/mcc-env.sh`: `${MCC_SERVERS:-<repo>/MinecraftOfficial/downloads}`
-- Default validation target when the user does not specify a version: `1.21.11`
+- Default validation target when the user does not specify a server directory: `1.21.11-Vanilla`
 
 ## Console modes
 
@@ -51,13 +51,13 @@ Two worktrees can debug against one shared server like this:
 # worktree A
 cd ~/Minecraft/Minecraft-Console-Client
 source tools/mcc-env.sh
-mc-start 1.21.11
-mcc-debug -v 1.21.11 --file-input
+mc-start 1.21.11-Vanilla
+mcc-debug -v 1.21.11-Vanilla --file-input
 
 # worktree B
 cd ~/Minecraft/Minecraft-Console-Client-foo
 source tools/mcc-env.sh
-mcc-debug -v 1.21.11 --file-input
+mcc-debug -v 1.21.11-Vanilla --file-input
 
 # from each worktree, mcc-* targets that worktree's default session
 mcc-state
@@ -84,8 +84,8 @@ Before scripted runs, especially on macOS or in a reused tmux environment:
 
 ```bash
 source tools/mcc-env.sh
-mcc-preflight 1.21.11
-mc-reset-test-env 1.21.11
+mcc-preflight 1.21.11-Vanilla
+mc-reset-test-env 1.21.11-Vanilla
 ```
 
 `mcc-preflight` checks Java, tmux, dotnet, python3, and server directories. It also resolves common Homebrew Java paths on macOS. `mc-reset-test-env` clears stale tmux sessions and stale `stdin.pipe` files before they turn into misleading startup failures.
@@ -107,16 +107,16 @@ Interactive shell:
 source tools/mcc-env.sh
 SESSION="$(_mcc_resolve_session)"
 USERNAME="$(_mcc_resolve_username "$SESSION")"
-mc-start 1.21.11
-mc-log 1.21.11 100
+mc-start 1.21.11-Vanilla
+mc-log 1.21.11-Vanilla 100
 mc-rcon "op $USERNAME"
-mc-stop 1.21.11
+mc-stop 1.21.11-Vanilla
 ```
 
 Non-interactive shell:
 
 ```bash
-tools/start-server.sh 1.21.11
+tools/start-server.sh 1.21.11-Vanilla
 tools/mc-rcon.sh "op mcc_smoke_a"
 ```
 
@@ -135,19 +135,19 @@ The `tools/mcc-debug.sh` script handles build, server startup, config preparatio
 source tools/mcc-env.sh
 
 # Classic mode with FileInput (script-driven debugging):
-mcc-debug -v 1.21.11 --file-input
+mcc-debug -v 1.21.11-Vanilla --file-input
 
 # Classic mode interactive (attach via tmux):
-mcc-debug -v 1.21.11
+mcc-debug -v 1.21.11-Vanilla
 
 # TUI mode:
-mcc-debug -v 1.21.11 -m tui
+mcc-debug -v 1.21.11-Vanilla -m tui
 
 # With debug messages enabled from start:
-mcc-debug -v 1.21.11 --file-input --debug-on
+mcc-debug -v 1.21.11-Vanilla --file-input --debug-on
 
 # Skip build (already built):
-mcc-debug -v 1.21.11 --file-input --no-build
+mcc-debug -v 1.21.11-Vanilla --file-input --no-build
 ```
 
 ### What mcc-debug.sh does
@@ -202,7 +202,7 @@ For agents calling MCC commands programmatically:
 ```bash
 source tools/mcc-env.sh
 SESSION="smoke-a"
-mcc-debug -v 1.21.11 --file-input --session "$SESSION" --no-build
+mcc-debug -v 1.21.11-Vanilla --file-input --session "$SESSION" --no-build
 
 # Send commands:
 mcc-cmd --session "$SESSION" "debug state"
@@ -215,15 +215,15 @@ mcc-log-mcc --session "$SESSION"
 # Stop:
 mcc-cmd --session "$SESSION" "quit"
 mcc-kill --session "$SESSION"
-mc-stop 1.21.11
+mc-stop 1.21.11-Vanilla
 ```
 
 ### Interactive workflow
 
 ```bash
 source tools/mcc-env.sh
 SESSION="live-a"
-mcc-debug -v 1.21.11 --session "$SESSION"
+mcc-debug -v 1.21.11-Vanilla --session "$SESSION"
 
 # In another terminal:
 tmux attach -t "mcc-$SESSION"
@@ -245,7 +245,7 @@ TUI mode runs Consolonia full-screen in a tmux session. Key differences:
 ```bash
 source tools/mcc-env.sh
 SESSION="tui-a"
-mcc-debug -v 1.21.11 -m tui --session "$SESSION" --no-build
+mcc-debug -v 1.21.11-Vanilla -m tui --session "$SESSION" --no-build
 
 # Cannot use mcc-cmd (no FileInput); must use tmux send-keys:
 tmux send-keys -t "mcc-$SESSION" "/debug state" Enter
@@ -330,12 +330,12 @@ If a scripted run fails before MCC joins, check for a harness problem before ass
 ## Typical debug loop
 
 1. `source tools/mcc-env.sh`
-2. `mcc-debug -v 1.21.11 --file-input` (or `-m tui`)
+2. `mcc-debug -v 1.21.11-Vanilla --file-input` (or `-m tui`)
 3. Confirm `Server was successfully joined` in log
 4. `mcc-cmd "debug state"` to verify MCC state
 5. Run test commands
 6. Inspect log output
-7. `mcc-cmd "quit"` and `mc-stop 1.21.11`
+7. `mcc-cmd "quit"` and `mc-stop 1.21.11-Vanilla`
 8. Edit code, rebuild, repeat
 
 ## Debugging tips

.skills/mcc-integration-testing/scripts/prepare_offline_mcc_config.sh

@@ -14,6 +14,20 @@ Usage:
 EOF
 }
 
+normalize_output_ini() {
+    local raw_output_ini="$1"
+    local spill_dir
+
+    if [[ "$raw_output_ini" == *.ini || "$raw_output_ini" == */* ]]; then
+        printf '%s\n' "$raw_output_ini"
+        return 0
+    fi
+
+    spill_dir="${MCC_CONFIG_SPILL_DIR:-$REPO_ROOT/.tmp/mcc-config-spill}"
+    mkdir -p "$spill_dir"
+    printf '%s/%s.ini\n' "$spill_dir" "$raw_output_ini"
+}
+
 if [[ $# -lt 2 || $# -gt 4 ]]; then
     usage
     exit 1
@@ -24,17 +38,27 @@ OUTPUT_INI=""
 MC_VERSION=""
 LOGIN_NAME=""
 
-if [[ $# -ge 3 && -f "$1" ]]; then
+if [[ $# -ge 3 && "$2" == *.ini ]]; then
     TEMPLATE_INI="$1"
     OUTPUT_INI="$2"
     MC_VERSION="$3"
     LOGIN_NAME="${4:-MCCBot}"
+elif [[ $# -eq 4 && "$1" == *.ini && -f "$1" ]]; then
+    TEMPLATE_INI="$1"
+    OUTPUT_INI="$2"
+    MC_VERSION="$3"
+    LOGIN_NAME="$4"
+elif [[ $# -eq 4 ]]; then
+    usage
+    exit 1
 else
     OUTPUT_INI="$1"
     MC_VERSION="$2"
     LOGIN_NAME="${3:-MCCBot}"
 fi
 
+OUTPUT_INI="$(normalize_output_ini "$OUTPUT_INI")"
+
 ACCOUNT_TYPE="${MCC_TEST_ACCOUNT_TYPE:-mojang}"
 PASSWORD_VALUE="${MCC_TEST_PASSWORD-}"
 

.skills/mcc-integration-testing/scripts/run_achievements_test.sh

@@ -126,8 +126,6 @@ cleanup() {
         wait "$MCC_PID" 2>/dev/null || true
     fi
 
-    mc-stop "$SERVER_DIR" --confirm >/dev/null 2>&1 || true
-    wait_for_server_stop "$SERVER_DIR" 20 >/dev/null 2>&1 || true
     ln -sfn "$RUN_DIR" "$LATEST_LINK"
     write_summary
 }

.skills/mcc-integration-testing/scripts/run_full_spectrum_test.sh

@@ -34,9 +34,6 @@ cleanup() {
     mcc-cmd --session "$SESSION_NAME" "quit" >/dev/null 2>&1 || true
     sleep 2
     mcc-kill --session "$SESSION_NAME" >/dev/null 2>&1 || true
-
-    mc-stop "$VERSION" --confirm >/dev/null 2>&1 || true
-    wait_for_server_stop "$VERSION" 20 >/dev/null 2>&1 || true
 }
 trap cleanup EXIT
 

.skills/mcc-integration-testing/scripts/run_parallel_session_smoke_test.sh

@@ -93,8 +93,6 @@ cleanup() {
     sleep 1
     mcc-kill --session "$SESSION_A" >/dev/null 2>&1 || true
     mcc-kill --session "$SESSION_B" >/dev/null 2>&1 || true
-    mc-stop "$VERSION" --confirm >/dev/null 2>&1 || true
-    wait_for_server_stop "$VERSION" 20 >/dev/null 2>&1 || true
 }
 trap cleanup EXIT
 

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

@@ -12,11 +12,11 @@ Systematic workflow for updating Minecraft Console Client to support a new Minec
 - Decompiled server source for both the old and new MC versions in `$MCC_REPO/MinecraftOfficial/<version>-decompiled/`
 - If missing, decompile and download server.jar:
   ```bash
-  $MCC_REPO/tools/decompile.sh --version <ver>
+  $MCC_REPO/tools/decompile.sh --version <ver>-Vanilla
   ```
-  This auto-downloads `MinecraftDecompiler.jar` if needed, produces the decompiled source, and downloads `server.jar` into `$MCC_SERVERS/<ver>/`.
-- `tools/decompile.sh` depends on official mappings. For older versions where it refuses to decompile, fall back to a raw Java decompiler such as `cfr-decompiler` against `$MCC_SERVERS/<ver>/server.jar`. That fallback is good enough for packet inspection and registration order checks even when the output is obfuscated.
-- A test server of the target version in `$MCC_SERVERS/<version>/` (see `mcc-dev-workflow` skill)
+  This auto-downloads `MinecraftDecompiler.jar` if needed, produces the decompiled source under `$MCC_REPO/MinecraftOfficial/<mc-version>-decompiled/`, and downloads `server.jar` into `$MCC_SERVERS/<ver>-Vanilla/`.
+- `tools/decompile.sh` depends on official mappings. For older versions where it refuses to decompile, fall back to a raw Java decompiler such as `cfr-decompiler` against `$MCC_SERVERS/<ver>-Vanilla/server.jar`. That fallback is good enough for packet inspection and registration order checks even when the output is obfuscated.
+- A test server of the target version in `$MCC_SERVERS/<version>-Vanilla/` (see `mcc-dev-workflow` skill)
 
 ## Step 0: Generate Server Reports (CRITICAL since 1.21.9)
 

.vscode/tasks.json

@@ -0,0 +1,41 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "build",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "build",
+                "${workspaceFolder}/MinecraftClient.sln",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary;ForceNoAlign"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "publish",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "publish",
+                "${workspaceFolder}/MinecraftClient.sln",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary;ForceNoAlign"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "watch",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "watch",
+                "run",
+                "--project",
+                "${workspaceFolder}/MinecraftClient.sln"
+            ],
+            "problemMatcher": "$msCompile"
+        }
+    ]
+}

AGENTS.md

@@ -10,7 +10,7 @@
 - Init submodules first: `git submodule update --init --recursive`
 - Build for local development: `source tools/mcc-env.sh && mcc-build`
 - Publish (matches CI shape): `source tools/mcc-env.sh && mcc-publish --rid <RID>`
-- Run/debug from source: `source tools/mcc-env.sh && mcc-debug -v 1.21.11 --file-input`
+- Run/debug from source: `source tools/mcc-env.sh && mcc-debug -v 1.21.11-Vanilla --file-input`
 - Docs: `cd docs && npm install && npm run docs:dev` or `npm run docs:build`
 - Docker: `cd Docker && docker build -t minecraft-console-client:latest .`
 - Tests: no dedicated test project is present in the main solution.

MinecraftClient.Tests/MinecraftClient.Tests.csproj

@@ -0,0 +1,25 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
+    <PackageReference Include="xunit" Version="2.9.2" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="coverlet.collector" Version="6.0.2">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\MinecraftClient\MinecraftClient.csproj" />
+  </ItemGroup>
+</Project>