docs: add jump-to-top links below all section headings

Fixes #74

The multiple punch SFX bug has been fixed.
Cause: The is_charged_strike state was never cleared after pushing a player, causing the push logic to re-trigger and play the sound every frame while the movement key was held.
Fix: is_charged_strike is now immediately cleared upon a successful push.

.gitea/workflows/ci.yml

@@ -0,0 +1,154 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    name: Build & Release
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    env:
+      GITEA_TOKEN: ${{ secrets.TEKTON_RELEASE_TOKEN }}
+      TAG_NAME: ${{ github.ref_name }}
+    steps:
+      - name: Install tools
+        run: apt-get update -qq && apt-get install -y -qq curl unzip zip
+
+      - name: Checkout Code
+        run: |
+          git config --global credential.helper store
+          echo "http://god:${{ secrets.TEKTON_RELEASE_TOKEN }}@52.74.133.55:3000" > ~/.git-credentials
+          git clone http://52.74.133.55:3000/danchie/tekton.git .
+          git checkout $TAG_NAME
+
+      - name: Setup Godot (Cached)
+        run: |
+          apt-get update -qq && apt-get install -y -qq unzip curl
+          if [ ! -f /cache/godot_4.7 ]; then
+             echo "Downloading Godot 4.7..."
+             curl -sL -o /tmp/godot.zip "https://github.com/godotengine/godot-builds/releases/download/4.7-stable/Godot_v4.7-stable_linux.x86_64.zip"
+             unzip -q -o /tmp/godot.zip -d /cache/
+             mv /cache/Godot_v4.7-stable_linux.x86_64 /cache/godot_4.7
+          fi
+          cp /cache/godot_4.7 /usr/local/bin/godot
+          chmod +x /usr/local/bin/godot
+          mkdir -p ~/.local/share/godot/export_templates/4.7.stable
+          if [ ! -f /cache/Godot_v4.7-stable_export_templates.tpz ]; then
+             echo "Downloading templates..."
+             curl -sL -o /cache/Godot_v4.7-stable_export_templates.tpz \
+               "https://github.com/godotengine/godot-builds/releases/download/4.7-stable/Godot_v4.7-stable_export_templates.tpz"
+          fi
+          cd ~/.local/share/godot/export_templates/4.7.stable
+          unzip -q -o /cache/Godot_v4.7-stable_export_templates.tpz
+          mv templates/* .
+          rm -rf templates
+          cd $GITHUB_WORKSPACE
+          mkdir -p build
+
+      - name: Export Windows
+        run: |
+          mkdir -p build/windows
+          cp addons/godotsteam/libgodotsteam* build/windows/ 2>/dev/null || true
+          godot --headless --export-release "Windows Desktop" build/windows/tekton_armageddon_windows.exe || true
+          cd build/windows && zip -r ../tekton_armageddon_windows_${TAG_NAME}.zip .
+
+      - name: Export Linux
+        run: |
+          mkdir -p build/linux
+          godot --headless --export-release "Linux/X11" build/linux/tekton_armageddon_linux.x86_64 || true
+          cd build/linux && zip -r ../tekton_armageddon_linux_${TAG_NAME}.zip .
+
+      - name: Export macOS
+        run: |
+          mkdir -p build/macos
+          godot --headless --export-release "macOS" build/macos/tekton_armageddon_macos.zip 2>&1 | tail -5 || true
+          if [ -f build/macos/tekton_armageddon_macos.zip ]; then
+            mv build/macos/tekton_armageddon_macos.zip build/tekton_armageddon_macos_${TAG_NAME}.zip
+          fi
+
+      - name: Extract changelog
+        run: |
+          # Extract changelog for this tag version from CHANGELOG_DRAFT.md
+          V="${TAG_NAME#v}"
+          BODY=$(awk -v ver="[$V]" '
+            /^## / { if (found) exit }
+            /^## / && index($0, ver) { found=1; next }
+            found { print }
+          ' CHANGELOG_DRAFT.md | sed 's/^ *//')
+          echo "CHANGELOG_BODY<<EOF" >> $GITHUB_ENV
+          echo "$BODY" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+      - name: Create Gitea Release
+        run: |
+          set -e
+          API="http://52.74.133.55:3000/api/v1/repos/danchie/tekton/releases"
+          TAG="$TAG_NAME"
+          echo "Checking existing release for $TAG..."
+          RELEASE_JSON=$(curl -s -H "Authorization: token $GITEA_TOKEN" "$API/tags/$TAG" 2>/dev/null || echo "")
+          RELEASE_ID=$(echo "$RELEASE_JSON" | grep -o '"id":[0-9]*' | head -1 | grep -o '[0-9]*' || true)
+          if [ -z "$RELEASE_ID" ]; then
+            echo "Creating new release for $TAG..."
+            # Escape body for JSON
+            BODY_ESCAPED=$(echo "$CHANGELOG_BODY" | python3 -c "import json,sys; print(json.dumps(sys.stdin.read().strip()))" 2>/dev/null || echo '""')
+            RELEASE_JSON=$(curl -s -X POST \
+              -H "Authorization: token $GITEA_TOKEN" \
+              -H "Content-Type: application/json" \
+              -d "{\"tag_name\":\"$TAG\",\"name\":\"$TAG\",\"body\":$BODY_ESCAPED,\"draft\":true}" \
+              "$API")
+            echo "API response: $RELEASE_JSON"
+            RELEASE_ID=$(echo "$RELEASE_JSON" | grep -o '"id":[0-9]*' | head -1 | grep -o '[0-9]*')
+            if [ -z "$RELEASE_ID" ]; then
+              echo "FATAL: Could not create release"
+              exit 1
+            fi
+          fi
+          echo "release_id=$RELEASE_ID"
+          echo "$RELEASE_ID" > /tmp/release_id.txt
+
+      - name: Upload Windows asset
+        run: |
+          RELEASE_ID=$(cat /tmp/release_id.txt)
+          curl -s -X POST \
+            -H "Authorization: token $GITEA_TOKEN" \
+            -H "Content-Type: multipart/form-data" \
+            -F "attachment=@build/tekton_armageddon_windows_${TAG_NAME}.zip" \
+            "http://52.74.133.55:3000/api/v1/repos/danchie/tekton/releases/$RELEASE_ID/assets"
+          echo "Windows uploaded"
+
+      - name: Upload Linux asset
+        run: |
+          RELEASE_ID=$(cat /tmp/release_id.txt)
+          curl -s -X POST \
+            -H "Authorization: token $GITEA_TOKEN" \
+            -H "Content-Type: multipart/form-data" \
+            -F "attachment=@build/tekton_armageddon_linux_${TAG_NAME}.zip" \
+            "http://52.74.133.55:3000/api/v1/repos/danchie/tekton/releases/$RELEASE_ID/assets"
+          echo "Linux uploaded"
+
+      - name: Upload macOS asset
+        run: |
+          RELEASE_ID=$(cat /tmp/release_id.txt)
+          if [ -f "build/tekton_armageddon_macos_${TAG_NAME}.zip" ]; then
+            curl -s -X POST \
+              -H "Authorization: token $GITEA_TOKEN" \
+              -H "Content-Type: multipart/form-data" \
+              -F "attachment=@build/tekton_armageddon_macos_${TAG_NAME}.zip" \
+              "http://52.74.133.55:3000/api/v1/repos/danchie/tekton/releases/$RELEASE_ID/assets"
+            echo "macOS uploaded"
+          else
+            echo "macOS asset not built, skipping"
+          fi
+
+      - name: Publish release
+        run: |
+          RELEASE_ID=$(cat /tmp/release_id.txt)
+          curl -s -X PATCH \
+            -H "Authorization: token $GITEA_TOKEN" \
+            -H "Content-Type: application/json" \
+            -d '{"draft":false}' \
+            "http://52.74.133.55:3000/api/v1/repos/danchie/tekton/releases/$RELEASE_ID"
+          echo "Published: https://git.klud.top/danchie/tekton/releases/tag/$TAG_NAME"

.gitea/workflows/deploy_patch.yml

@@ -0,0 +1,68 @@
+name: Deploy Patch
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Patch version (e.g., 2.4.2)'
+        required: true
+        type: string
+      notes:
+        description: 'Release notes'
+        required: false
+        type: string
+
+jobs:
+  build-and-deploy:
+    name: Build & Deploy Patch
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repository (shallow)
+        env:
+          GITEA_TOKEN: ${{ secrets.TEKTON_RELEASE_TOKEN }}
+        run: |
+          git clone --depth 1 http://god:$GITEA_TOKEN@52.74.133.55:3000/danchie/tekton.git .
+          git config user.name "god"
+          git config user.email "god@noreply.git.klud.top"
+
+      - name: Setup Godot (Cached)
+        run: |
+          if [ ! -f /cache/godot_4.7 ]; then
+             echo "Downloading Godot 4.7..."
+             apt-get update -qq && apt-get install -y -qq unzip curl
+             curl -sL -o /tmp/godot.zip "https://github.com/godotengine/godot-builds/releases/download/4.7-stable/Godot_v4.7-stable_linux.x86_64.zip"
+             unzip -q -o /tmp/godot.zip -d /cache/
+             mv /cache/Godot_v4.7-stable_linux.x86_64 /cache/godot_4.7
+          fi
+          cp /cache/godot_4.7 /usr/local/bin/godot
+          chmod +x /usr/local/bin/godot
+          mkdir -p build
+
+      - name: Generate version.json & bump version
+        env:
+          PATCH_VERSION: ${{ github.event.inputs.version }}
+          PATCH_NOTES: ${{ github.event.inputs.notes }}
+        run: |
+          python3 tools/generate_version_json.py --skip-changelog
+
+      - name: Export patch PCK
+        run: |
+          godot --headless --export-pack "Windows Desktop" build/patch.pck 2>&1 | tail -5
+
+      - name: Push to patches branch
+        env:
+          GITEA_TOKEN: ${{ secrets.TEKTON_RELEASE_TOKEN }}
+        run: |
+          mkdir -p patch-deploy
+          cp build/patch.pck patch-deploy/
+          cp assets/data/version.json patch-deploy/
+          cd patch-deploy
+          git init
+          git config user.name "god"
+          git config user.email "god@noreply.git.klud.top"
+          git remote add origin http://god:$GITEA_TOKEN@52.74.133.55:3000/danchie/tekton.git
+          git checkout -b patches
+          git add .
+          git commit -m "patch ${{ github.event.inputs.version }}"
+          git push -f origin patches

.github/workflows/build.yml

@@ -1,128 +0,0 @@
-name: Build and Export
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-    inputs:
-      version:
-        description: 'Version to build (e.g., 2.4.0)'
-        required: true
-        type: string
-
-jobs:
-  build-windows:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout Source Code
-        uses: actions/checkout@v4
-
-      - name: Setup Godot
-        uses: chickensoft-games/setup-godot@v1
-        with:
-          version: '4.6.0'
-          use-dotnet: false
-
-      - name: Setup Export Templates
-        run: |
-          TEMPLATES_DIR=~/.local/share/godot/export_templates/4.6.stable
-          mkdir -p "$TEMPLATES_DIR"
-          wget -q https://github.com/godotengine/godot/releases/download/4.6-stable/Godot_v4.6-stable_export_templates.tpz -O templates.tpz
-          unzip -q templates.tpz -d "$TEMPLATES_DIR"
-          mv "$TEMPLATES_DIR/templates/"* "$TEMPLATES_DIR/"
-          rmdir "$TEMPLATES_DIR/templates"
-
-      - name: Export Windows Build
-        run: |
-          mkdir -p build
-          godot --headless --export-release "Windows Desktop" build/tekton_armageddon_windows.exe
-
-      - name: Zip Windows Build
-        run: cd build && zip tekton_armageddon_windows.zip tekton_armageddon_windows.exe
-
-      - name: Upload Windows Artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: windows-build
-          path: build/tekton_armageddon_windows.zip
-          retention-days: 30
-
-  build-linux:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout Source Code
-        uses: actions/checkout@v4
-
-      - name: Setup Godot
-        uses: chickensoft-games/setup-godot@v1
-        with:
-          version: '4.6.0'
-          use-dotnet: false
-
-      - name: Setup Export Templates
-        run: |
-          TEMPLATES_DIR=~/.local/share/godot/export_templates/4.6.stable
-          mkdir -p "$TEMPLATES_DIR"
-          wget -q https://github.com/godotengine/godot/releases/download/4.6-stable/Godot_v4.6-stable_export_templates.tpz -O templates.tpz
-          unzip -q templates.tpz -d "$TEMPLATES_DIR"
-          mv "$TEMPLATES_DIR/templates/"* "$TEMPLATES_DIR/"
-          rmdir "$TEMPLATES_DIR/templates"
-
-      - name: Export Linux Build
-        run: |
-          mkdir -p build
-          godot --headless --export-release "Linux/X11" build/tekton_armageddon_linux.x86_64
-
-      - name: Zip Linux Build
-        run: cd build && zip tekton_armageddon_linux.zip tekton_armageddon_linux.x86_64
-
-      - name: Upload Linux Artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: linux-build
-          path: build/tekton_armageddon_linux.zip
-          retention-days: 30
-
-  create-release:
-    needs: [build-windows, build-linux]
-    runs-on: ubuntu-latest
-    if: always() && startsWith(github.ref, 'refs/tags/')
-    permissions:
-      contents: write
-
-    steps:
-      - name: Extract Version
-        id: version
-        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
-
-      - name: Download All Artifacts
-        uses: actions/download-artifact@v4
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
-        with:
-          files: |
-            windows-build/tekton_armageddon_windows.zip
-            linux-build/tekton_armageddon_linux.zip
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Mirror to tekton-updates
-        env:
-          GITHUB_TOKEN: ${{ secrets.PUBLIC_REPO_PAT }}
-        run: |
-          gh release create "v${{ steps.version.outputs.version }}" \
-            --repo "${{ github.actor }}/tekton-updates" \
-            --title "v${{ steps.version.outputs.version }}" \
-            --notes "Mirror of https://github.com/${{ github.repository }}/releases/tag/v${{ steps.version.outputs.version }}" \
-            "windows-build/tekton_armageddon_windows.zip#Windows" \
-            "linux-build/tekton_armageddon_linux.zip#Linux"

.github/workflows/build_artifacts.yml

@@ -1,177 +0,0 @@
-name: Build Platform Artifacts
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-  workflow_dispatch:
-    inputs:
-      version:
-        description: 'Version to build (e.g., 2.4.0)'
-        required: true
-        type: string
-
-jobs:
-  build-artifacts:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    strategy:
-      matrix:
-        platform:
-          - name: Windows
-            preset: "Windows Desktop"
-            extension: exe
-          - name: Linux
-            preset: "Linux/X11"
-            extension: x86_64
-          - name: Android
-            preset: "Android"
-            extension: apk
-
-    steps:
-      - name: Checkout Source Code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Godot
-        uses: chickensoft-games/setup-godot@v1
-        with:
-          version: '4.6.0'
-          use-dotnet: false
-
-      - name: Setup Export Templates
-        run: |
-          TEMPLATES_DIR=~/.local/share/godot/export_templates/4.6.stable
-          mkdir -p "$TEMPLATES_DIR"
-          wget -q https://github.com/godotengine/godot/releases/download/4.6-stable/Godot_v4.6-stable_export_templates.tpz -O templates.tpz
-          unzip -q templates.tpz -d "$TEMPLATES_DIR"
-          mv "$TEMPLATES_DIR/templates/"* "$TEMPLATES_DIR/"
-          rmdir "$TEMPLATES_DIR/templates"
-
-      - name: Setup Android SDK (Android only)
-        if: matrix.platform.name == 'Android'
-        uses: android-actions/setup-android@v3
-
-      - name: Extract Version
-        id: version
-        run: |
-          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
-            VERSION="${{ inputs.version }}"
-          else
-            VERSION="${GITHUB_REF#refs/tags/v}"
-          fi
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "Building version: $VERSION"
-
-      - name: Create Build Directory
-        run: mkdir -p build
-
-      - name: Export Game
-        run: |
-          godot --headless --export-release "${{ matrix.platform.preset }}" \
-            "build/tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.${{ matrix.platform.extension }}"
-
-      - name: Generate Checksums
-        run: |
-          cd build
-          sha256sum tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.${{ matrix.platform.extension }} \
-            > tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.sha256
-
-      - name: Upload Artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: tekton-${{ matrix.platform.name }}-v${{ steps.version.outputs.version }}
-          path: |
-            build/tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.${{ matrix.platform.extension }}
-            build/tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.sha256
-          retention-days: 90
-          compression-level: 0
-
-      - name: Create Release Asset
-        if: startsWith(github.ref, 'refs/tags/')
-        uses: softprops/action-gh-release@v1
-        with:
-          files: |
-            build/tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.${{ matrix.platform.extension }}
-            build/tekton_armageddon_${{ matrix.platform.name }}_v${{ steps.version.outputs.version }}.sha256
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  build-patch:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout Source Code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Godot
-        uses: chickensoft-games/setup-godot@v1
-        with:
-          version: '4.6.0'
-          use-dotnet: false
-
-      - name: Extract Version
-        id: version
-        run: |
-          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
-            VERSION="${{ inputs.version }}"
-          else
-            VERSION="${GITHUB_REF#refs/tags/v}"
-          fi
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-
-      - name: Generate Changed Files List
-        run: |
-          find scripts/ scenes/ assets/ -type f > changed_files.txt
-          echo "Patching $(wc -l < changed_files.txt) files"
-
-      - name: Build Patch PCK
-        run: godot --headless -s tools/build_patch.gd
-
-      - name: Generate Patch Checksum
-        run: |
-          sha256sum patch.pck > patch.pck.sha256
-
-      - name: Upload Patch Artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: tekton-patch-v${{ steps.version.outputs.version }}
-          path: |
-            patch.pck
-            patch.pck.sha256
-          retention-days: 90
-
-      - name: Push to Updates Repository
-        if: startsWith(github.ref, 'refs/tags/')
-        uses: dmnemec/copy_file_to_another_repo_action@main
-        env:
-          API_TOKEN_GITHUB: ${{ secrets.PUBLIC_REPO_PAT }}
-        with:
-          source_file: 'patch.pck'
-          destination_repo: '${{ github.actor }}/tekton-updates'
-          destination_folder: 'v${{ steps.version.outputs.version }}'
-          user_email: 'action@github.com'
-          user_name: 'PatchBot'
-          commit_message: '[AUTO] Release v${{ steps.version.outputs.version }} patch'
-
-      - name: Push Checksum to Updates Repository
-        if: startsWith(github.ref, 'refs/tags/')
-        uses: dmnemec/copy_file_to_another_repo_action@main
-        env:
-          API_TOKEN_GITHUB: ${{ secrets.PUBLIC_REPO_PAT }}
-        with:
-          source_file: 'patch.pck.sha256'
-          destination_repo: '${{ github.actor }}/tekton-updates'
-          destination_folder: 'v${{ steps.version.outputs.version }}'
-          user_email: 'action@github.com'
-          user_name: 'PatchBot'
-          commit_message: '[AUTO] Release v${{ steps.version.outputs.version }} checksum'

.github/workflows/deploy_patch.yml

@@ -1,130 +0,0 @@
-name: Build and Release Patch PCK
-
-on:
-  push:
-    branches:
-      - 'patch-release'
-    paths:
-      - 'scripts/**'
-      - 'scenes/**'
-      - 'assets/**'
-      - 'CHANGELOG_DRAFT.md'
-  workflow_dispatch:
-
-jobs:
-  build-and-deploy-patch:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout Source Code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      # ── 1. Auto-generate version.json from CHANGELOG_DRAFT.md ────────────
-      - name: Generate Version JSON & Bump Version
-        run: python3 tools/generate_version_json.py
-
-      # ── 2. Commit bumped files back to the repo ───────────────────────────
-      - name: Commit Version Bump
-        run: |
-          git config user.name  "PatchBot"
-          git config user.email "action@github.com"
-          git add assets/data/version.json project.godot CHANGELOG_DRAFT.md
-          git diff --staged --quiet || git commit -m "[AUTO] Version bump & changelog update"
-          git push
-
-      # ── 3. Detect changed files for patch PCK ────────────────────────────
-      - name: Generate Changed Files List
-        run: |
-          git diff --name-only HEAD^ HEAD -- 'scripts/**' 'scenes/**' 'assets/**' > changed_files.txt
-          echo "Files to patch:"
-          cat changed_files.txt
-
-      # ── 4. Build patch.pck ────────────────────────────────────────────────
-      - name: Setup Godot
-        uses: chickensoft-games/setup-godot@v1
-        with:
-          version: '4.6.0'
-          use-dotnet: false
-
-      - name: Run Build Patch Script
-        run: godot --headless -s tools/build_patch.gd
-
-      # ── 5. Generate checksums ─────────────────────────────────────────────────
-      - name: Generate Checksums
-        run: |
-          sha256sum patch.pck > patch.pck.sha256
-          sha256sum assets/data/version.json > version.json.sha256
-
-      # ── 6. Upload artifacts to GitHub ─────────────────────────────────────────
-      - name: Upload Patch Artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: patch-pck-${{ github.sha }}
-          path: |
-            patch.pck
-            patch.pck.sha256
-          retention-days: 90
-
-      - name: Upload Version Manifest
-        uses: actions/upload-artifact@v4
-        with:
-          name: version-manifest-${{ github.sha }}
-          path: |
-            assets/data/version.json
-            version.json.sha256
-          retention-days: 90
-
-      # ── 7. Push patch.pck to public repo ─────────────────────────────────────
-      - name: Push patch.pck to Public Repository
-        uses: dmnemec/copy_file_to_another_repo_action@main
-        env:
-          API_TOKEN_GITHUB: ${{ secrets.PUBLIC_REPO_PAT }}
-        with:
-          source_file: 'patch.pck'
-          destination_repo: '${{ github.actor }}/tekton-updates'
-          destination_folder: 'latest'
-          user_email: 'action@github.com'
-          user_name: 'PatchBot'
-          commit_message: '[AUTO] Pushed new patch.pck'
-
-      - name: Push patch checksum to Public Repository
-        uses: dmnemec/copy_file_to_another_repo_action@main
-        env:
-          API_TOKEN_GITHUB: ${{ secrets.PUBLIC_REPO_PAT }}
-        with:
-          source_file: 'patch.pck.sha256'
-          destination_repo: '${{ github.actor }}/tekton-updates'
-          destination_folder: 'latest'
-          user_email: 'action@github.com'
-          user_name: 'PatchBot'
-          commit_message: '[AUTO] Pushed patch checksum'
-
-      # ── 8. Push version.json to public repo ──────────────────────────────────
-      - name: Push version.json to Public Repository
-        uses: dmnemec/copy_file_to_another_repo_action@main
-        env:
-          API_TOKEN_GITHUB: ${{ secrets.PUBLIC_REPO_PAT }}
-        with:
-          source_file: 'assets/data/version.json'
-          destination_repo: '${{ github.actor }}/tekton-updates'
-          destination_folder: 'latest'
-          user_email: 'action@github.com'
-          user_name: 'PatchBot'
-          commit_message: '[AUTO] Pushed new version.json'
-
-      - name: Push version checksum to Public Repository
-        uses: dmnemec/copy_file_to_another_repo_action@main
-        env:
-          API_TOKEN_GITHUB: ${{ secrets.PUBLIC_REPO_PAT }}
-        with:
-          source_file: 'version.json.sha256'
-          destination_repo: '${{ github.actor }}/tekton-updates'
-          destination_folder: 'latest'
-          user_email: 'action@github.com'
-          user_name: 'PatchBot'
-          commit_message: '[AUTO] Pushed version checksum'

.github/workflows/test.yml

@@ -1,59 +0,0 @@
-name: Automated Testing
-
-on:
-  push:
-    branches:
-      - main
-      - develop
-      - 'feature/**'
-      - 'patch-release'
-  pull_request:
-    branches:
-      - main
-      - develop
-  workflow_dispatch:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-
-    steps:
-      - name: Checkout Source Code
-        uses: actions/checkout@v4
-
-      - name: Setup Godot
-        uses: chickensoft-games/setup-godot@v1
-        with:
-          version: '4.6.0'
-          use-dotnet: false
-
-      - name: Verify GUT Installation
-        run: |
-          if [ ! -d "addons/gut" ]; then
-            echo "ERROR: GUT addon not found at addons/gut"
-            exit 1
-          fi
-          echo "GUT addon found"
-
-      - name: Run Unit Tests
-        run: |
-          godot --headless --path . -s res://addons/gut/gut_cmdln.gd \
-            -gdir=res://tests/ \
-            -gexit \
-            -glog=2
-
-      - name: Check Test Results
-        if: failure()
-        run: |
-          echo "Tests failed. Check logs above for details."
-          exit 1
-
-      - name: Upload Test Reports
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: test-reports
-          path: test_reports/
-          retention-days: 30

.gitignore

@@ -4,7 +4,10 @@
 .agent/
 _daily_basis/
 _daily_changes/
+tools/gitea-kanban
 build/
+label_mapping.json
+milestone_mapping.json
 
 /android/
 .tmp

CHANGELOG_DRAFT.md

@@ -1,3 +1,20 @@
+## [NEXT]
+- Fixed playerboard desync where host-side board changes weren't reflected on remote clients in multiplayer sessions.
+- Fixed punch/smack SFX playing repeatedly when quickly attacking another player.
+- Fixed currency split between Gacha and Shop — wallet balance now updates immediately after purchase without needing to reopen the panel.
+- Fixed fatal crash in Multiplayer Gauntlet caused by missing `has_method` check on smack cooldown timers on remote peers.
+- Upgraded engine from Godot 4.6 to 4.7 stable for better performance and stability.
+- Migrated patch delivery from GitHub Pages to Gitea native raw endpoint — no more external dependencies for game updates.
+- CI: optimized build cache for Godot binary, eliminating repeated 140MB downloads on every workflow run.
+- CI: shallow repository checkout (--depth 1) for faster clone times.
+- CI: removed unnecessary export template download from patch deployment workflow (--export-pack doesn't need them).
+
+## [2.4.3] — 2026-07-04
+- Fixed multiplayer desync issue where the playerboard UI would get stuck and not refresh properly.
+- Fixed a bug where attacking or pushing another player would cause the smack/punch sound effect to play repeatedly.
+- Fixed an issue where the Gacha panel's currency balance would not update immediately after purchasing currency in the Shop.
+- Fixed a fatal client crash in Multiplayer Gauntlet mode caused by smack cooldown timers.
+
 ## [2.4.0] — 2026-06-18
 - Rebuilt the **Gauntlet** game mode from the ground up — new wave-based mechanics, arena redesign, and tighter difficulty scaling.
 - Added **freeze-area VFX** — the freeze powerup now shows a visible icy floor spread across the affected tiles.
@@ -152,7 +169,17 @@
 - Fragment Craft system — collect drops to craft exclusive skins
 - Fixed boot screen stuck on "Checking versions..."
 
-## [2.4.1] — $(date +"%Y-%m-%d")
+## [2.4.2] — 2026-07-03
+- Replaced the **Cleanser** mechanic in Gauntlet mode with a **Ghost powerup** sticky-bypass system.
+- Ghost (Invisible Mode) now lets players walk through sticky candy tiles in Gauntlet — no more hard block.
+- Players earn a Ghost powerup every 2 completed missions in Gauntlet (replaces Cleanser charge grants).
+- Ghost powerup tiles now spawn naturally on the Gauntlet arena (15% chance alongside common tiles).
+- Removed Cleanser HUD elements (icon, label, charge counter) from the Gauntlet overlay.
+- Removed `use_cleanser` input action — Ghost uses the existing powerup activation keybind.
+- Bots now activate Ghost powerup when boxed in by sticky tiles instead of using Cleanser.
+- Players pushed into sticky tiles while in Ghost mode are no longer slowed.
+
+## [2.4.1] — 2026-06-28
 - Fixed Gauntlet map layout to remove red unpassable barrier blocks and center blocks. They are now standard walkable floors but act as hard blockers in physics so players cannot pass them.
 - Fixed Gauntlet mode to prevent powerups or sticky bubbles from spawning on boundary tiles or under the central cannon.
 - Center Candy Cannon now shoots actual projectiles that fly towards sticky cells and leave a VFX trail behind them.

README.md

@@ -1,141 +1,37 @@
 # Tekton Dash Armageddon
 
+> Full developer documentation lives in this repo's **wiki** (sidebar link).
+>
+> See in particular: [Skin Creation Workflow](https://git.klud.top/danchie/tekton/wiki/Skin-Creation-Workflow), [Nakama Deployment](https://git.klud.top/danchie/tekton/wiki/Nakama-Deployment), and [Patch Release Workflow](https://git.klud.top/danchie/tekton/wiki/Patch-Release-Workflow).
 
-## 🛠️ Developer Workflows
+## Clone
 
-### Creating a Skin Material
+SSH is preferred:
-To create dynamic, color-maskable 3D materials for new character skins:
-- Open the **Skin Shader Generator** tool in the editor: `res://scenes/tools/skin_shader_generator.tscn`
-- Run the scene. 
-- Import your base albedo and mask textures.
-- Use the UI to visualize UV overlays and adjust color channels (Red, Green, Blue, Alpha masks).
-- Export the configured material as a `.tres` file into the `assets/materials/skins/` directory.
 
-### Adding a Skin to the Shop
+```bash
-Once your material is ready, you need to update the game's catalog and deploy the changes to the Nakama server.
+git clone git@ssh.git.klud.top:danchie/tekton.git
-
-#### Using the Catalog Editor Tool
-- Open the **Skin Catalog Editor** tool in the Godot Editor: `res://scenes/tools/skin_catalog_editor.tscn`
-- Press **F6** (or Right-click -> Run Current Scene).
-- **Manage Skins:**
-   - Click **"＋ New Skin"** to create a new entry.
-   - Fill in the **ID**, **Name**, **Category**, and **Price** (Gold/Stars).
-   - Assign the `.tres` material path generated in Step 1.
-- Click **"💾 Save & Generate"**. This automatically rewrites:
-   - `res://scripts/managers/skin_manager.gd` (Local catalog)
-   - `res://server/nakama/tekton_admin.js` (Server-side shop logic)
-
-#### Nakama VPS Deployment
-After generating the updated `tekton_admin.js` locally, you must sync it with your remote server.
-
-- **Copy the latest script:** Open `server/nakama/tekton_admin.js` locally and copy its updated contents (including your new skin).
-- **Connect to your VPS** via SSH.
-- **Create/Edit the file on the remote server:**
-   ```bash
-   nano ~/tekton_admin.js
-   # Or use micro (recommended): micro ~/tekton_admin.js
-   ```
-   Paste the copied contents and save the file.
-- **Find your Nakama Container ID:**
-   It is highly recommended to use **lazydocker** to manage containers.
-   *(To install on Ubuntu: `curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash`)*
-   Open lazydocker or run `docker ps` to find the Container ID for your Nakama server.
-- **Copy the file into the Nakama container:**
-   ```bash
-   # Replace ed21ac5d442a with your actual Container ID
-   docker cp ~/tekton_admin.js ed21ac5d442a:/nakama/data/modules/tekton_admin.js
-   ```
-- **Restart the container** (via lazydocker or `docker restart <Container ID>`) for Nakama to load the new modules. Live game clients will fetch this new catalog automatically upon booting.
-
-#### 🎨 Skin Creation & Deployment Flow
-```mermaid
-flowchart TD
-    %% Creation Phase
-    subgraph phase1 [Skin Material Creation]
-        A[Albedo & Mask Textures] --> B{Skin Shader Generator}
-        B -->|Export| C[material.tres]
-    end
-
-    %% Catalog Phase
-    subgraph phase2 [Catalog Definition]
-        C --> D{Skin Catalog Editor}
-        D -->|Save & Generate| E[tekton_admin.js]
-        D -->|Save & Generate| F[skin_manager.gd]
-    end
-
-    %% Deployment Phase (Dual Path)
-    subgraph phase3 ["Shop Backend (VPS)"]
-        E -->|SSH & nano| G[VPS: ~/tekton_admin.js]
-        G -->|docker cp| H[Nakama Container]
-        H -->|Restart| I[Live Shop Logic Sync]
-    end
-
-    subgraph phase4 ["Asset Delivery (CI/CD)"]
-        C --> J[Git Push]
-        F --> J
-        J -->|GitHub Actions| K[patch.pck]
-        K -->|Automatic Download| L[Player Client Assets Sync]
-    end
 ```
 
-### Pushing a New Version (Automated Patching)
+HTTPS also works:
-When you're ready to deploy new features or assets to players:
-- Document your changes in `CHANGELOG_DRAFT.md` using player-friendly language.
-- Run the version generation script from the terminal:
-   ```bash
-   python generate_version_json.py --bump patch
-   ```
-   *(Use `--bump minor` or `--bump major` for larger updates.)*
-- Commit and push your changes to the `main` branch on GitHub:
-   ```bash
-   git add .
-   git commit -m "Release version X.Y.Z"
-   git push origin main
-   ```
-- The **GitHub Actions Workflow** (`deploy_patch.yml`) will automatically detect the push, build the patch manifest (`version.json`), and deploy it to the public `gh-pages` branch.
-- Live game clients will detect the new version on boot, download the updated files, and apply the patch seamlessly.
 
-### Local Testing & Understanding the Patch System
+```bash
-When a player (or you) downloads an in-game patch, Godot downloads a `patch.pck` file to the system's `user://` directory. 
+git clone https://git.klud.top/danchie/tekton.git
-- **Virtual File System:** Godot mounts this `.pck` file over the `res://` directory purely in memory. **It does not physically overwrite your local source files** (like `assets/data/version.json`).
-- **Editor Bypass:** When testing locally in the Godot Editor, the `BootScreen` is configured to skip the remote network download and instead automatically parse your *local* `assets/data/version.json`.
-- **Previewing Changelogs:** To preview how your changelog will look before pushing to GitHub:
-  - Add your notes under the `## [NEXT]` section in `CHANGELOG_DRAFT.md`.
-  - Run `py tools/generate_version_json.py` from the terminal.
-  - Run the `BootScreen` scene in the Godot Editor. It will instantly display the updated local UI!
-- **Syncing:** After the GitHub Actions CI builds a release online, remember to run `git pull origin main` to sync your local project files with the CI-generated files.
-
-#### 🗺️ Architecture Flowchart
-```mermaid
-flowchart TD
-    %% Local Dev Flow
-    subgraph Local Dev Environment
-        A[📝 CHANGELOG_DRAFT.md] -->|py tools/generate_version_json.py| B[(📄 version.json)]
-        B -.->|Test in Editor| C{BootScreen}
-        C -- Editor Bypass --> D[Reads Local version.json directly]
-    end
-
-    %% CI Pipeline
-    subgraph "CI/CD Pipeline"
-        B -->|git push| E[⚡ GitHub Actions]
-        E -->|Compiles & Builds| F[📦 patch.pck]
-        F -->|Deploys| G((🌍 Public Repository))
-    end
-
-    %% Live Client Flow
-    subgraph Player Client
-        G -.->|HTTP Download on Boot| H[📂 user://patch.pck]
-        H -->|ProjectSettings.load_resource_pack| I[🧠 Godot Virtual File System]
-        I -.->|Overrides res:// in Memory| J[Game Starts Updated!]
-    end
 ```
 
----
+First-time SSH setup:
 
-## 🚀 Ongoing Features (Incoming)
+- [Linux](https://git.klud.top/danchie/tekton/wiki/SSH-Setup-Linux)
+- [macOS](https://git.klud.top/danchie/tekton/wiki/SSH-Setup-macOS)
+- [Windows](https://git.klud.top/danchie/tekton/wiki/SSH-Setup-Windows)
 
-### 🎰 Gacha System Backend Editor
+SSH test:
-Currently in development: A dedicated backend editor tool (similar to `skin_catalog_editor.tscn`) specifically for managing the Gacha System.
+
-- **Nakama Syncing:** Will allow developers to push updated gacha pools, rates, and fragment costs directly to Nakama Storage.
+```bash
-- **Dynamic Banners:** Will support updating specific slots on the gacha banner dynamically.
+ssh -T git@ssh.git.klud.top
-- **Seasonal Rotations:** Will introduce automated scheduling so banners rotate based on active seasons and automatically remove themselves when the season ends.
+```
+
+Expected output:
+
+```text
+Hi there, <yourname>! You've successfully authenticated with the key named <key-title>, but Gitea does not provide shell access.
+```

TASKS.md

@@ -1,174 +0,0 @@
-# AI Agent Workflow Guide for Tekton Dash
-
-This document tells AI agents how to work on Tekton Dash tasks end-to-end.
-
----
-
-## 1. Task Source: Notion MCP
-
-All tasks live on the **"TektonDash - Armageddon PR Tasks"** Notion board.
-
-https://www.notion.so/danchiego-game/36433be43b29800c8422ed5bdd65671b?v=36433be43b2980de8635000c0a910a0d
-
-### Finding Tasks
-
-**CRITICAL:** Always start by finding tasks from Notion. Priority order: P0 > P1 > P2 > P3. Status order: In Progress > To Do.
-
-Example search for "Gauntlet" tasks:
-```
-Use: mcp_notion_API_post_search
-  query: "[Gauntlet]" or task name
-  filter: {"property": "object", "value": "page"}
-```
-
-### Reading a Task
-
-**CRITICAL:** The **Description** field contains the actual implementation requirements. TASKS.md defines workflow procedure only — each task's unique problem and solution are in Notion's Description field.
-
-Always read full task details:
-```
-Use: mcp_notion_API_retrieve_a_page
-  page_id: "<task_page_id_from_search>"
-```
-
-Each task page has these properties:
-
-| Property | Type | Purpose |
-|---|---|---|
-| **Name** | title | Task title, e.g. `[Gauntlet] #1 Game Mode Registration` |
-| **Status** | select | `To Do` → `In Progress` → `Done` |
-| **Priority** | select | `P0` (critical) / `P1` / `P2` / `P3` |
-| **Effort** | select | `S - Small` / `M - Medium` / `L - Large` / `XL - Epic` |
-| **Sprint** | select | `Alpha` / `Beta` / `Release` |
-| **ProjectType** | select | `CORE` / `CLIENT` / `SERVER` / `INFRA` |
-| **Description** | rich_text | Full task description — **read this to understand what to do** |
-| **Acceptance** | checkbox | Check when task is verified complete |
-| **DueDate** | date | Optional deadline |
-| **UnitTest** | date | Optional test completion date |
-
-### Task Lifecycle
-
-```
-To Do → In Progress → Done
-```
-
-**CRITICAL WORKFLOW:**
-
-1. **Read task from Notion**: Use `mcp_notion_API_retrieve_a_page(page_id="...")` to get full task details
-2. **Read Description field carefully**: This contains the actual implementation requirements — file names, function signatures, integration points, RPC patterns, etc.
-3. **Implement exactly what Description specifies**: Don't invent your own approach — follow the Description's technical requirements
-4. **Write unit tests**: Follow pattern in `tests/` directory (see GUT_SETUP_SKILLS.md)
-5. **Update changelog**: Add entry to `CHANGELOG_DRAFT.md` (consumer-facing language, not technical jargon)
-6. **Version management**: Check git diff for existing version changes (see Version Bumping section below)
-7. **Mark complete in Notion**: Set `Status` → `Done`, check `Acceptance` ✅
-
-```
-Use: mcp_notion_API_patch_page
-  page_id: "<task_page_id>"
-  properties: {"Status": {"select": {"name": "Done"}}, "Acceptance": {"checkbox": true}}
-```
-
----
-
-## 2. Code Structure
-
-| Path | Purpose |
-|---|---|
-| `scripts/game_mode.gd` | GameMode enum + helpers (add new modes here) |
-| `scripts/managers/` | All game mode managers (lobby, stop_n_go, portal, gauntlet) |
-| `scenes/main.gd` | Central orchestrator — init, setup, game start routing |
-| `tests/` | GUT unit tests — one file per task/feature |
-
-### Adding a New Game Mode
-
-1. Add enum to `scripts/game_mode.gd` → update `from_string()`, `mode_to_string()`, `get_all_modes()`, `is_restricted()`
-2. Add mode name to `LobbyManager.available_game_modes` in `lobby_manager.gd`
-3. Add arena name to `_update_available_areas()` in `lobby_manager.gd`
-4. Add manager var + init branch in `main.gd` `_init_managers()`
-5. Add setup branch in `_setup_host_game()` and `_setup_client_game()`
-6. Add start branch in `_start_game()`
-7. Add background in `_apply_arena_background()`
-
----
-
-## 3. Unit Testing
-
-### Pattern
-
-All tests extend `GutTest` and live in `tests/`. Naming: `test_<feature>.gd`
-
-```gdscript
-extends GutTest
-
-func before_all():
-    gut.p("=== Feature Tests [Task ID] ===")
-
-func test_something():
-    assert_eq(actual, expected, "Description")
-
-func after_all():
-    gut.p("=== Feature Tests Complete ===")
-```
-
-### Running Tests
-
-```cmd
-run_tests.cmd                              # all tests
-run_tests.cmd test_gauntlet_registration   # specific test
-```
-
-Reports saved to `test_reports/` with timestamps.
-
----
-
-## 4. Version Bumping
-
-**Before bumping, check git for existing uncommitted version changes:**
-
-```cmd
-git diff --cached -- project.godot CHANGELOG_DRAFT.md
-git diff -- project.godot CHANGELOG_DRAFT.md
-```
-
-### If version changes already exist (staged or unstaged):
-→ **APPEND** your changelog bullet to the existing version block in `CHANGELOG_DRAFT.md`
-→ **DO NOT** bump `project.godot` or `export_presets.cfg` — you're joining an in-progress batch
-
-### If NO version changes exist (clean state):
-→ **BUMP** version (increment patch: `2.3.5` → `2.3.6`)
-→ **UPDATE** all locations below
-
-Version appears in **4 locations** — all must match:
-
-| File | Field |
-|---|---|
-| `CHANGELOG_DRAFT.md` | `## [X.Y.Z] — YYYY-MM-DD` header |
-| `project.godot` | `config/version="X.Y.Z"` |
-| `export_presets.cfg` | `application/file_version` and `application/product_version` (per preset) |
-| `export_presets.cfg` | `export_path` filenames containing version |
-| `export_presets.cfg` | `version/name` (Android preset) |
-
-### Changelog Style
-
-Entries are **consumer-facing** (readable by players). No internal jargon.
-
-```markdown
-## [2.3.6] — 2026-05-22
-- Added new game mode: Candy Cannon Survival
-```
-
-**Bad:** "Added GAUNTLET = 3 to GameMode.Mode enum"
-**Good:** "Added new game mode: Candy Cannon Survival"
-
----
-
-## 5. Key Conventions
-
-- **Caveman Mode**: Be terse. No filler. Execute first, talk second.
-- **Read task from Notion FIRST**: Always use `mcp_notion_API_retrieve_a_page` to get the Description field before implementing
-- **Description field is the spec**: TASKS.md is workflow procedure only. Each task's unique requirements (file names, function signatures, RPC patterns, integration points) are in Notion's Description field
-- **Read before edit**: Always check whole files before modifying `.gd`, `.tscn`, `.tres`, `.res` files
-- **Notion status flow**: `To Do` → `In Progress` → `Done` (never skip steps)
-- **Test everything**: Every completed task gets a `test_<feature>.gd` in `tests/`
-- **GUT framework**: Tests use the Godot Unit Test (GUT) addon at `addons/gut/`
-- **Version discipline**: Check `git diff -- project.godot CHANGELOG_DRAFT.md` before bumping version (see Version Bumping section)

TODO.md

@@ -0,0 +1,20 @@
+# Tekton Game - TODO
+
+## Bugs to fix (checked 2026-07-04)
+
+- [x] **Playerboard desync** — doesn't refresh correctly, stuck (fixed sync ready order)
+- [x] **Multiple punch SFX** — sounds play more than once per punch (fixed charged strike state clearance)
+- [x] **Currency not shared** — gacha wallet and shop wallet are separate (fixed UI state sync)
+- [x] **Multiplayer gauntlet mode broken** — single player works, multiplayer doesn't (fixed client crash from bad indentation)
+
+## In Progress
+
+- [ ] CI release pipeline (`docker network connect` approach pending verification)
+
+## Done
+
+- [x] Cleanup test runs 96-99
+- [x] Remove test tag `v9.9.9-test`
+- [x] Remove orphan Docker containers/networks/volumes
+- [x] Prune dangling images (~7.7GB reclaimed)
+- [x] Tailscale status check (peer traffic works; coordination-server sync is the only red)

addons/godot_ai/README.md

@@ -14,7 +14,7 @@ The plugin auto-starts the MCP server and connects over WebSocket. No manual con
 
 ## Requirements
 
-- Godot 4.3+ (4.7+ recommended)
+- Godot 4.3+ (4.4+ recommended)
 - [uv](https://docs.astral.sh/uv/) (used to install the Python server)
   <details>
   <summary>Install uv</summary>

addons/godot_ai/client_configurator.gd

@@ -24,7 +24,6 @@ const CliStrategy := preload("res://addons/godot_ai/clients/_cli_strategy.gd")
 const ManualCommand := preload("res://addons/godot_ai/clients/_manual_command.gd")
 const CliFinder := preload("res://addons/godot_ai/clients/_cli_finder.gd")
 const WindowsPortReservation := preload("res://addons/godot_ai/utils/windows_port_reservation.gd")
-const PortResolver := preload("res://addons/godot_ai/utils/port_resolver.gd")
 
 const SERVER_NAME := "godot-ai"
 
@@ -38,14 +37,8 @@ const DEFAULT_WS_PORT := 9500
 const STARTUP_TRACE_ENV := "GODOT_AI_STARTUP_TRACE"
 const MIN_PORT := 1024
 const MAX_PORT := 65535
-## Cap on `can_bind_local_port` probes per `suggest_free_port` call so a
-## pathological run of occupied ports can't stall the (cold-path) caller.
-## 64 localhost binds are sub-millisecond; finding a free port realistically
-## takes one or two probes, so this only bounds the worst case.
-const SUGGEST_PORT_MAX_PROBES := 64
 const SETTING_WS_PORT := "godot_ai/ws_port"
 const SETTING_STARTUP_TRACE := "godot_ai/log_startup_timing"
-const _DISCOVERY_TIMEOUT_MS := 3000
 
 
 ## Active HTTP port: user override (if in range) or `DEFAULT_HTTP_PORT`.
@@ -138,39 +131,15 @@ static func excluded_domains() -> String:
 	return ",".join(parts)
 
 
-## Suggest a port the caller can actually switch to. Walks
+## Clamp `start` into the legal port range, then walk
-## `candidate`..`candidate+span-1` and returns the first port that is both
+## `candidate`..`candidate+span-1` and return the first port that is NOT
-## (a) NOT inside a Windows winnat reservation range (Hyper-V / WSL2 / Docker
+## currently excluded by Windows' winnat reservation table. Falls back to the
-## grab these; bind fails with WinError 10013 and netstat shows nothing) and
+## clamped candidate if nothing clears (caller can apply anyway — user may
-## (b) actually bindable right now on 127.0.0.1. The bind probe is what makes
+## just retry). On non-Windows this is a no-op: all ports pass, returns the
-## "free" honest on macOS/Linux, where the reservation table is empty but the
+## clamped candidate.
-## next port up may still be occupied — the same suggestion feeds the dock
-## crash body, the port-picker spinbox, and the non-recoverable INCOMPATIBLE
-## log line. Falls back to the clamped candidate if nothing in the window
-## clears both checks (caller surfaces it as a best-effort hint; the user can
-## retry or pick another). Best-effort by nature: a TOCTOU window remains
-## between the probe and the caller actually binding the port. The bind probe
-## is bounded to `SUGGEST_PORT_MAX_PROBES` attempts so this cold path can't
-## stall on a pathological run of occupied ports.
 static func suggest_free_port(start: int, span: int = 2048) -> int:
 	var candidate := clampi(start, MIN_PORT, MAX_PORT - span + 1)
-	var limit := mini(candidate + span - 1, MAX_PORT)
+	return WindowsPortReservation.suggest_non_excluded_port(candidate, span, MAX_PORT)
-	var p := candidate
-	var probes := 0
-	while p <= limit and probes < SUGGEST_PORT_MAX_PROBES:
-		## Jump past a whole Windows-reserved range in one step (no-op on
-		## POSIX: returns `p` unchanged), so we don't probe port-by-port
-		## through the large adjacent ranges those services reserve. The
-		## jump itself runs no bind probes, so it doesn't count against the cap.
-		var not_reserved := WindowsPortReservation.suggest_non_excluded_port(p, limit - p + 1, MAX_PORT)
-		if not_reserved < p or not_reserved > limit:
-			break
-		p = not_reserved
-		probes += 1
-		if PortResolver.can_bind_local_port(p):
-			return p
-		p += 1
-	return candidate
 
 
 # --- Client operations (string id) ---------------------------------------
@@ -540,8 +509,8 @@ static func invalidate_uvx_cli_cache() -> void:
 ## Thread safety: `CliFinder.invalidate()` guards `_cache` / `_searched`
 ## with a mutex so it can race safely against worker threads calling
 ## `find()` from `_run_client_action_worker`. The mutex is held only
-## across the dictionary clear, never across the bounded subprocess lookup,
+## across the dictionary clear, never across `OS.execute`, so this call
-## so this call can never block the main thread on a subprocess.
+## can never block the main thread on a subprocess.
 static func invalidate_cli_cache() -> void:
 	CliFinder.invalidate()
 
@@ -552,9 +521,10 @@ static var _uv_version_searched: bool = false
 
 ## Cached for the editor session. The dock's `_refresh_setup_status`
 ## (called via `call_deferred` from `_build_ui`) calls this on the
-## main thread in user mode, so the cold `uvx --version` probe is
+## main thread in user mode, so a single cold `OS.execute(uvx,
-## wall-clock bounded and cached. Subsequent calls (focus-in refresh,
+## ["--version"])` adds ~80 ms to the dock's first paint on Linux and
-## manual Refresh clicks) reuse the cached string.
+## more on Windows. Subsequent calls (focus-in refresh, manual Refresh
+## clicks) reuse the cached string.
 ##
 ## Invalidate via `invalidate_uv_version_cache()` when the user
 ## installs / reinstalls uv via the dock so the next refresh reflects
@@ -569,10 +539,9 @@ static func check_uv_version() -> String:
 		_uv_version_searched = true
 		_uv_version_cache = ""
 		return ""
-	var result := McpCliExec.run(uvx, ["--version"], _DISCOVERY_TIMEOUT_MS, false)
+	var output: Array = []
-	if int(result.get("exit_code", -1)) == 0:
+	if OS.execute(uvx, ["--version"], output, true) == 0 and output.size() > 0:
-		var lines := PackedStringArray(str(result.get("stdout", "")).split("\n"))
+		_uv_version_cache = output[0].strip_edges()
-		_uv_version_cache = lines[0].strip_edges() if lines.size() > 0 else ""
 	else:
 		_uv_version_cache = ""
 	_uv_version_searched = true
@@ -643,12 +612,9 @@ static func find_worktree_src_dir(start_dir: String) -> String:
 
 static func _find_system_install() -> String:
 	var cmd := "which" if OS.get_name() != "Windows" else "where"
-	var result := McpCliExec.run(cmd, ["godot-ai"], _DISCOVERY_TIMEOUT_MS, false)
+	var output: Array = []
-	if int(result.get("exit_code", -1)) == 0:
+	if OS.execute(cmd, ["godot-ai"], output, true) == 0 and output.size() > 0:
-		var lines := PackedStringArray(str(result.get("stdout", "")).split("\n"))
+		var found: String = output[0].strip_edges()
-		if lines.is_empty():
-			return ""
-		var found := CliFinder._pick_best_path(lines) if OS.get_name() == "Windows" else lines[0].strip_edges()
 		if not found.is_empty():
 			return found
 	return ""

addons/godot_ai/clients/_cli_exec.gd

@@ -34,7 +34,6 @@ extends RefCounted
 
 const DEFAULT_TIMEOUT_MS := 8000
 const _POLL_INTERVAL_MS := 50
-const _KILL_GRACE_MS := 500
 
 
 static func run(
@@ -45,21 +44,6 @@ static func run(
 ) -> Dictionary:
 	if exe.is_empty():
 		return _spawn_failed_result()
-	if _uses_blocking_legacy_path():
-		## Godot 4.3 keeps the old blocking path because execute_with_pipe
-		## capture/exit semantics differ there. The bounded timeout/kill
-		## behavior is available on Godot 4.4+ only.
-		return _run_blocking_legacy(exe, args)
-
-	return _run_piped(exe, args, timeout_ms, capture_stderr)
-
-
-static func _run_piped(
-	exe: String,
-	args: Array,
-	timeout_ms: int,
-	capture_stderr: bool,
-) -> Dictionary:
 
 	var spawn_exe := exe
 	var spawn_args := args
@@ -92,18 +76,12 @@ static func _run_piped(
 	var deadline := Time.get_ticks_msec() + maxi(timeout_ms, _POLL_INTERVAL_MS)
 	while OS.is_process_running(pid):
 		if Time.get_ticks_msec() >= deadline:
-			## Kill before draining: a pipe read can block while the child is
+			## Read whatever made it to the pipes before we kill the
-			## still alive. Once it exits, drain any buffered partial output.
+			## process — partial output beats blank "timed out" when the
+			## CLI was emitting useful diagnostics on its way to hanging.
+			var partial_stdout := _drain_pipe(stdio)
+			var partial_stderr := _drain_pipe(stderr_pipe) if capture_stderr else ""
 			OS.kill(pid)
-			var kill_deadline := Time.get_ticks_msec() + _KILL_GRACE_MS
-			while OS.is_process_running(pid) and Time.get_ticks_msec() < kill_deadline:
-				OS.delay_msec(_POLL_INTERVAL_MS)
-
-			var partial_stdout := ""
-			var partial_stderr := ""
-			if not OS.is_process_running(pid):
-				partial_stdout = _drain_pipe(stdio)
-				partial_stderr = _drain_pipe(stderr_pipe) if capture_stderr else ""
 			_close_pipes(stdio, stderr_pipe)
 			return {
 				"exit_code": -1,
@@ -129,27 +107,6 @@ static func _run_piped(
 	}
 
 
-static func _run_blocking_legacy(exe: String, args: Array) -> Dictionary:
-	## Godot 4.3's OS.execute_with_pipe has capture/exit-code differences
-	## locked by the 4.3 canary skips in test_cli_exec.gd. Preserve the old
-	## blocking discovery behavior there so startup-critical probes keep the
-	## same semantics that worked before the bounded-pipe path landed.
-	var output: Array = []
-	var exit_code := OS.execute(exe, args, output, true)
-	var lines := PackedStringArray()
-	for line in output:
-		lines.append(str(line))
-	var stdout := "\n".join(lines)
-	return {
-		"exit_code": exit_code,
-		"stdout": stdout,
-		"stderr": "",
-		"output": stdout,
-		"timed_out": false,
-		"spawn_failed": exit_code == -1,
-	}
-
-
 static func _spawn_failed_result() -> Dictionary:
 	return {
 		"exit_code": -1,
@@ -162,19 +119,9 @@ static func _spawn_failed_result() -> Dictionary:
 
 
 static func _drain_pipe(pipe: Variant) -> String:
-	if not (pipe is FileAccess):
+	if pipe is FileAccess:
-		return ""
+		return (pipe as FileAccess).get_as_text()
-	var f := pipe as FileAccess
+	return ""
-	var bytes := PackedByteArray()
-	var max_bytes := 1 << 20  # 1 MiB, far above expected client CLI output.
-	while bytes.size() < max_bytes:
-		var chunk := f.get_buffer(mini(4096, max_bytes - bytes.size()))
-		if chunk.is_empty():
-			break
-		bytes.append_array(chunk)
-		if f.eof_reached():
-			break
-	return bytes.get_string_from_utf8()
 
 
 static func _join_streams(stdout: String, stderr_text: String) -> String:
@@ -194,10 +141,3 @@ static func _close_pipes(stdio: Variant, stderr_pipe: Variant) -> void:
 		(stdio as FileAccess).close()
 	if stderr_pipe is FileAccess:
 		(stderr_pipe as FileAccess).close()
-
-
-static func _uses_blocking_legacy_path() -> bool:
-	var version := Engine.get_version_info()
-	var major := int(version.get("major", 4))
-	var minor := int(version.get("minor", 0))
-	return major < 4 or (major == 4 and minor < 4)

addons/godot_ai/clients/_cli_finder.gd

@@ -14,7 +14,7 @@ extends RefCounted
 ## the main thread (manual Refresh path). Godot `Dictionary` is not safe for
 ## concurrent mutation, so `_cache` / `_searched` access is guarded by
 ## `_mutex`. The mutex is held only across dictionary read/write — the slow
-## `_resolve()` path (FileAccess + bounded subprocess lookup) runs unlocked, so a
+## `_resolve()` path (FileAccess + `OS.execute`) runs unlocked, so a
 ## main-thread `invalidate()` can never block on a worker's subprocess.
 ## Two workers racing the same exe both call `_resolve()` and both write
 ## back the same answer; that's wasted work, not corruption.
@@ -24,8 +24,6 @@ static var _mutex: Mutex = Mutex.new()
 static var _cache: Dictionary = {}  # exe_name -> resolved path (or "")
 static var _searched: Dictionary = {}
 
-const _LOOKUP_TIMEOUT_MS := 3000
-
 
 ## Find any of the supplied exe names; returns the first hit.
 ## On Windows pass the .exe variant in `exe_names` if relevant.
@@ -56,8 +54,8 @@ static func _find_one(exe_name: String) -> String:
 	_mutex.unlock()
 	if already_searched:
 		return cached
-	# `_resolve()` does FileAccess + bounded subprocess lookup (forks
+	# `_resolve()` does FileAccess + `OS.execute` (forks `bash -lc` /
-	# `bash -lc` / `which`), which can take 100ms-1s. Holding the mutex across that
+	# `which`), which can take 100ms-1s. Holding the mutex across that
 	# would let a concurrent `invalidate()` on the main thread freeze the
 	# editor for the duration of the subprocess — which defeats the whole
 	# point of running CLI lookup off the main thread.
@@ -83,19 +81,20 @@ static func _resolve(exe_name: String) -> String:
 		var shell := OS.get_environment("SHELL")
 		if shell.is_empty():
 			shell = "/bin/bash"
+		var login_output: Array = []
 		var stripped := exe_name.trim_suffix(".exe")
-		var login_result := McpCliExec.run(shell, ["-lc", "command -v %s" % stripped], _LOOKUP_TIMEOUT_MS, false)
+		var login_exit := OS.execute(shell, ["-lc", "command -v %s" % stripped], login_output, true)
-		if int(login_result.get("exit_code", -1)) == 0:
+		if login_exit == 0 and login_output.size() > 0:
-			var login_found: String = str(login_result.get("stdout", "")).strip_edges()
+			var login_found: String = login_output[0].strip_edges()
 			if not login_found.is_empty() and FileAccess.file_exists(login_found):
 				return login_found
 
 	# 3. which / where with inherited PATH
 	var lookup := "where" if is_windows else "which"
-	var result := McpCliExec.run(lookup, [exe_name], _LOOKUP_TIMEOUT_MS, false)
+	var output: Array = []
-	if int(result.get("exit_code", -1)) == 0:
+	var exit_code := OS.execute(lookup, [exe_name], output, true)
-		var output := str(result.get("stdout", ""))
+	if exit_code == 0 and output.size() > 0:
-		var lines := PackedStringArray(output.split("\n"))
+		var lines := PackedStringArray(output[0].split("\n"))
 		var found := _pick_best_path(lines) if is_windows else lines[0].strip_edges()
 		if not found.is_empty():
 			return found

addons/godot_ai/debugger/mcp_debugger_plugin.gd

@@ -64,7 +64,6 @@ const EVAL_PROBE_INTERVAL_SEC := 0.35
 
 var _log_buffer: McpLogBuffer
 var _game_log_buffer: McpGameLogBuffer
-var _editor_log_buffer: McpEditorLogBuffer
 
 ## Pending request_id -> {connection, timer, timeout_callable}.
 ## We retain the bound timeout lambda so `_clear_pending` can disconnect
@@ -81,16 +80,12 @@ var _game_run_token := 0
 var _ready_run_token := -1
 var _game_session_id := -1
 var _game_run_active := false
-var _game_run_started_msec := 0
-var _game_run_started_editor_cursor := 0
-var _game_helper_expected := true
 signal game_ready
 
 
-func _init(log_buffer: McpLogBuffer = null, game_log_buffer: McpGameLogBuffer = null, editor_log_buffer: McpEditorLogBuffer = null) -> void:
+func _init(log_buffer: McpLogBuffer = null, game_log_buffer: McpGameLogBuffer = null) -> void:
 	_log_buffer = log_buffer
 	_game_log_buffer = game_log_buffer
-	_editor_log_buffer = editor_log_buffer
 
 
 func _has_capture(prefix: String) -> bool:
@@ -112,23 +107,14 @@ func _setup_session(session_id: int) -> void:
 	_game_session_id = session_id
 
 
-func begin_game_run(editor_log_cursor: int = 0, helper_expected: bool = true) -> void:
+func begin_game_run() -> void:
 	_game_run_token += 1
 	_game_run_active = true
 	_game_ready = false
 	_ready_run_token = -1
 	_game_session_id = -1
-	_game_run_started_msec = Time.get_ticks_msec()
-	_game_run_started_editor_cursor = maxi(0, editor_log_cursor)
-	_game_helper_expected = helper_expected
-	var run_id := ""
-	if _game_log_buffer:
-		run_id = _game_log_buffer.clear_for_new_run()
 	if _log_buffer:
-		var log_text := "[debug] game capture pending run token %d" % _game_run_token
+		_log_buffer.log("[debug] game capture pending run token %d" % _game_run_token)
-		if not run_id.is_empty():
-			log_text += " (run %s)" % run_id
-		_log_buffer.log(log_text)
 
 
 func end_game_run() -> void:
@@ -142,158 +128,6 @@ func is_game_capture_ready() -> bool:
 	return _game_run_active and _game_ready and _ready_run_token == _game_run_token
 
 
-static func with_liveness_flags(status: Dictionary) -> Dictionary:
-	var enriched := status.duplicate(true)
-	var state := str(enriched.get("status", "stopped"))
-	enriched["helper_live"] = state == "live"
-	enriched["session_active"] = not state in ["not_live", "stopped"]
-	return enriched
-
-
-func get_game_status(now_msec: int = -1, ready_wait_sec: float = GAME_READY_WAIT_SEC) -> Dictionary:
-	var resolved_now := Time.get_ticks_msec() if now_msec < 0 else now_msec
-	var ready_wait_msec := maxi(0, int(ready_wait_sec * 1000.0))
-	var elapsed_msec := maxi(0, resolved_now - _game_run_started_msec) if _game_run_active else 0
-	## "stopped" also covers idle/never-ran; no game run is currently active.
-	var status := "stopped"
-	if _game_run_active:
-		if is_game_capture_ready():
-			status = "live"
-		elif not _game_helper_expected:
-			status = "no_helper"
-		elif elapsed_msec >= ready_wait_msec:
-			status = "not_live"
-		else:
-			status = "launching"
-	return with_liveness_flags({
-		"status": status,
-		"run_token": _game_run_token,
-		"active": _game_run_active,
-		"ready": is_game_capture_ready(),
-		"helper_expected": _game_helper_expected,
-		"run_started_msec": _game_run_started_msec,
-		"elapsed_msec": elapsed_msec,
-		"ready_wait_msec": ready_wait_msec,
-		"editor_log_cursor": _game_run_started_editor_cursor,
-	})
-
-
-func _explain_not_live(status: Dictionary, code: String = ErrorCodes.INTERNAL_ERROR) -> Dictionary:
-	var state := str(status.get("status", "stopped"))
-	var errors_info := recent_editor_errors_since(int(status.get("editor_log_cursor", 0)))
-	var recent_errors: Array = errors_info.get("errors", [])
-	var recent_errors_scope := str(errors_info.get("scope", "none"))
-	var truncated := bool(errors_info.get("truncated", false))
-	var data := {
-		"game_status": status.duplicate(true),
-		"recent_errors": recent_errors,
-		"recent_errors_scope": recent_errors_scope,
-		"recent_errors_may_predate_run": recent_errors_scope == "retained_recent",
-		"recent_errors_truncated": truncated,
-	}
-	var message := ""
-	match state:
-		"not_live":
-			if not recent_errors.is_empty() and recent_errors_scope == "run":
-				message = "The game failed to load or crashed before the Godot AI game helper registered: %s. Check logs_read(source='editor', include_details=true)." % _format_editor_error_summary(recent_errors[0])
-				if truncated:
-					message += " Editor logs since this run may be truncated; showing retained errors."
-			elif not recent_errors.is_empty():
-				message = "The game is not responding and reported no load errors during this run. A recent editor error may be related, but may predate this run: %s. Check logs_read(source='editor', include_details=true)." % _format_editor_error_summary(recent_errors[0])
-			else:
-				message = "The game is not responding and reported no load errors before the helper-ready window elapsed. It may still be booting or may have failed silently; check logs_read(source='editor', include_details=true) and retry."
-		"no_helper":
-			message = "The running game has no _mcp_game_helper autoload, so game-side tools cannot connect. If this is a headless or custom-main-loop project, use editor_screenshot(source='viewport') where applicable. Otherwise, re-enable the plugin and relaunch the game."
-		"launching":
-			message = "The game is still starting (%.1fs elapsed); the Godot AI game helper has not registered yet. Retry shortly." % (float(status.get("elapsed_msec", 0)) / 1000.0)
-		"stopped":
-			message = "The game is not running. Start the project and retry the game-side tool."
-		_:
-			message = "The game-side tool could not confirm the game is live (status=%s). Check logs_read(source='editor', include_details=true) and retry." % state
-	var err := ErrorCodes.make(code, message)
-	var inner: Dictionary = err.get("error", {})
-	inner["data"] = data
-	err["error"] = inner
-	return err
-
-
-func recent_editor_errors_since(cursor: int) -> Dictionary:
-	return _recent_editor_errors_since(cursor)
-
-
-func _recent_editor_errors_since(cursor: int) -> Dictionary:
-	var out: Array[Dictionary] = []
-	var truncated := false
-	if _editor_log_buffer == null:
-		return {"errors": out, "truncated": false, "scope": "none"}
-	var captured: Dictionary = _editor_log_buffer.get_since(maxi(0, cursor), -1)
-	truncated = bool(captured.get("truncated", false))
-	for raw_entry in captured.get("entries", []):
-		var compact := _compact_editor_error(raw_entry)
-		if compact.is_empty():
-			continue
-		out.append(compact)
-		if out.size() >= 5:
-			break
-	if not out.is_empty():
-		return {"errors": out, "truncated": truncated, "scope": "run"}
-
-	for raw_entry in _reversed_entries(_editor_log_buffer.get_recent(McpEditorLogBuffer.MAX_LINES)):
-		var compact := _compact_editor_error(raw_entry, true)
-		if compact.is_empty():
-			continue
-		out.append(compact)
-		if out.size() >= 5:
-			break
-	if not out.is_empty():
-		return {"errors": out, "truncated": false, "scope": "retained_recent"}
-	return {"errors": out, "truncated": false, "scope": "none"}
-
-
-func _compact_editor_error(raw_entry: Variant, fallback_recent: bool = false) -> Dictionary:
-	if not raw_entry is Dictionary:
-		return {}
-	var entry := raw_entry as Dictionary
-	if str(entry.get("level", "info")) != "error":
-		return {}
-	var path := str(entry.get("path", ""))
-	if fallback_recent and _is_diagnostic_noise_path(path):
-		return {}
-	var compact := {
-		"source": "editor",
-		"level": "error",
-		"text": str(entry.get("text", "")),
-		"path": path,
-		"line": int(entry.get("line", 0)),
-		"function": str(entry.get("function", "")),
-	}
-	if entry.has("details"):
-		compact["details"] = entry["details"].duplicate(true)
-	return compact
-
-
-func _is_diagnostic_noise_path(path: String) -> bool:
-	return path.begins_with("res://addons/godot_ai/") or path.begins_with("res://tests/")
-
-
-func _reversed_entries(entries: Array[Dictionary]) -> Array[Dictionary]:
-	var out: Array[Dictionary] = []
-	for i in range(entries.size() - 1, -1, -1):
-		out.append(entries[i])
-	return out
-
-
-func _format_editor_error_summary(entry: Dictionary) -> String:
-	var text := str(entry.get("text", "editor error"))
-	var path := str(entry.get("path", ""))
-	var line := int(entry.get("line", 0))
-	if not path.is_empty() and line > 0:
-		return "%s (%s:%d)" % [text, path, line]
-	if not path.is_empty():
-		return "%s (%s)" % [text, path]
-	return text
-
-
 func _capture(message: String, data: Array, session_id: int) -> bool:
 	## Godot passes the full "prefix:tail" string as `message`.
 	match message:
@@ -318,15 +152,18 @@ func _capture(message: String, data: Array, session_id: int) -> bool:
 			## Boot beacon from the game-side autoload. Tells us the
 			## game has registered its "mcp" capture and is safe to send
 			## take_screenshot to — before this, Godot's debugger would
-			## drop our message silently.
+			## drop our message silently. Also marks a fresh play
+			## cycle: rotate the game-log buffer so each run starts
+			## clean and gets a new run_id.
 			_game_ready = true
 			_ready_run_token = _game_run_token
 			game_ready.emit()
-			if _log_buffer:
+			if _game_log_buffer:
-				if _game_log_buffer:
+				var run_id := _game_log_buffer.clear_for_new_run()
-					_log_buffer.log("[debug] <- mcp:hello from game_helper (run %s)" % _game_log_buffer.run_id())
+				if _log_buffer:
-				else:
+					_log_buffer.log("[debug] <- mcp:hello from game_helper (run %s)" % run_id)
-					_log_buffer.log("[debug] <- mcp:hello from game_helper")
+			elif _log_buffer:
+				_log_buffer.log("[debug] <- mcp:hello from game_helper")
 			return true
 		"mcp:eval_response":
 			_on_eval_response(data)
@@ -425,8 +262,8 @@ func _wait_then_send(
 	while not is_game_capture_ready() and Time.get_ticks_msec() < deadline:
 		await tree.process_frame
 	if not is_game_capture_ready():
-		_send_error_response(connection, request_id,
+		_send_error(connection, request_id, ErrorCodes.INTERNAL_ERROR,
-			_explain_not_live(get_game_status(-1, GAME_READY_WAIT_SEC), ErrorCodes.INTERNAL_ERROR))
+			"Game-side autoload never registered its debugger capture within %ds. Is the game actually running? Check Project Settings → Autoload for _mcp_game_helper." % int(GAME_READY_WAIT_SEC))
 		return
 	_send_take_screenshot(tree, request_id, max_resolution, connection, timeout_sec)
 
@@ -520,23 +357,16 @@ func _on_timeout(request_id: String) -> void:
 	var connection: McpConnection = pending.connection
 	if connection == null or not is_instance_valid(connection):
 		return
-	var status := get_game_status(-1, GAME_READY_WAIT_SEC)
+	_send_error(connection, request_id, ErrorCodes.INTERNAL_ERROR,
-	var err := ErrorCodes.make(ErrorCodes.INTERNAL_ERROR,
+		"Game screenshot timed out. The running game must include the _mcp_game_helper autoload (added automatically when the plugin is enabled — check Project Settings → Autoload). If the autoload is missing, re-enable the plugin and relaunch the game. For headless or custom-main-loop builds, use source='viewport' instead.")
-		"Game screenshot timed out after reaching the game helper. The game may be busy or unable to render a frame. Check logs_read(source='game') and retry.")
-	if status.get("status", "") != "live":
-		err = _explain_not_live(status, ErrorCodes.INTERNAL_ERROR)
-	_send_error_response(connection, request_id, err)
 	if _log_buffer:
 		_log_buffer.log("[debug] !! screenshot timeout (%s)" % request_id)
 
 
 func _send_error(connection: McpConnection, request_id: String, code: String, message: String) -> void:
-	_send_error_response(connection, request_id, ErrorCodes.make(code, message))
-
-
-func _send_error_response(connection: McpConnection, request_id: String, err: Dictionary) -> void:
 	if connection == null or not is_instance_valid(connection):
 		return
+	var err := ErrorCodes.make(code, message)
 	connection.send_deferred_response(request_id, err)
 
 
@@ -617,8 +447,8 @@ func _wait_then_eval(
 		## but the game-side capture didn't register within the short wait. Fast
 		## and caller-actionable; classifying it apart from the opaque 10s hang
 		## keeps the INTERNAL_ERROR telemetry bucket meaning "the eval truly hung".
-		_send_error_response(connection, request_id,
+		_send_error(connection, request_id, ErrorCodes.EVAL_GAME_NOT_READY,
-			_explain_not_live(get_game_status(-1, EVAL_READY_WAIT_SEC), ErrorCodes.EVAL_GAME_NOT_READY))
+			"Game-side capture didn't register within %ds. The play session is already running, so the game is most likely still booting — wait a moment and retry. If it persists, the _mcp_game_helper autoload is missing or disabled (Project Settings → Autoload; added automatically when the plugin is enabled), or the game uses a custom main loop." % int(EVAL_READY_WAIT_SEC))
 		return
 	_send_eval(tree, code, request_id, connection, timeout_sec)
 
@@ -874,8 +704,8 @@ func _wait_then_game_command(
 	while not is_game_capture_ready() and Time.get_ticks_msec() < deadline:
 		await tree.process_frame
 	if not is_game_capture_ready():
-		_send_error_response(connection, request_id,
+		_send_error(connection, request_id, ErrorCodes.INTERNAL_ERROR,
-			_explain_not_live(get_game_status(-1, GAME_READY_WAIT_SEC), ErrorCodes.INTERNAL_ERROR))
+			"Game-side autoload never registered its debugger capture within %ds. Is the game actually running?" % int(GAME_READY_WAIT_SEC))
 		return
 	_send_game_command(tree, op, params, request_id, connection, timeout_sec)
 

addons/godot_ai/dispatcher.gd

@@ -16,7 +16,6 @@ const DEFAULT_DEFERRED_TIMEOUT_MS := 4500
 const DEFERRED_TIMEOUT_MS_BY_COMMAND := {
 	"create_script": 4500,
 	"stop_project": 4500,
-	"run_project": 6000,
 	"take_screenshot": 30000,
 	"game_eval": 15000,
 	"game_command": 15000,

addons/godot_ai/handlers/editor_handler.gd

@@ -28,7 +28,6 @@ func _init(log_buffer: McpLogBuffer, connection: McpConnection = null, debugger_
 
 func get_editor_state(_params: Dictionary) -> Dictionary:
 	var scene_root := EditorInterface.get_edited_scene_root()
-	var game_status := _current_game_status()
 	var data := {
 		"godot_version": Engine.get_version_info().get("string", "unknown"),
 		"project_name": ProjectSettings.get_setting("application/config/name", ""),
@@ -39,9 +38,6 @@ func get_editor_state(_params: Dictionary) -> Dictionary:
 		## false between Play→Stop cycles. Lets capture-source=game callers
 		## poll for a real ready signal instead of guessing with sleep().
 		"game_capture_ready": _debugger_plugin != null and _debugger_plugin.is_game_capture_ready(),
-		"game_status": game_status,
-		"helper_live": bool(game_status.get("helper_live", false)),
-		"session_active": bool(game_status.get("session_active", false)),
 	}
 	## Half-installed addon tree from a failed self-update rollback. When
 	## non-empty, the agent / dock paint the operator-facing recovery copy
@@ -76,7 +72,6 @@ func get_logs(params: Dictionary) -> Dictionary:
 	var include_details: bool = bool(params.get("include_details", false))
 	var has_since_cursor := params.has("since_cursor") and params.get("since_cursor") != null
 	var since_cursor: int = maxi(0, int(params.get("since_cursor", 0)))
-	var since_run_id := "" if params.get("since_run_id", null) == null else str(params.get("since_run_id", ""))
 	if not source in VALID_LOG_SOURCES:
 		return ErrorCodes.make(
 			ErrorCodes.VALUE_OUT_OF_RANGE,
@@ -87,7 +82,7 @@ func get_logs(params: Dictionary) -> Dictionary:
 		"plugin":
 			return _get_plugin_logs(count, offset)
 		"game":
-			return _get_game_logs(count, offset, include_details, since_run_id)
+			return _get_game_logs(count, offset, include_details)
 		"editor":
 			return _get_editor_logs(count, offset, include_details, has_since_cursor, since_cursor)
 		"all":
@@ -95,17 +90,6 @@ func get_logs(params: Dictionary) -> Dictionary:
 	return ErrorCodes.make(ErrorCodes.INTERNAL_ERROR, "Unreachable")
 
 
-func _current_game_status() -> Dictionary:
-	if _debugger_plugin == null:
-		return McpDebuggerPlugin.with_liveness_flags({
-			"status": "stopped",
-			"active": false,
-			"ready": false,
-			"helper_expected": true,
-		})
-	return _debugger_plugin.get_game_status()
-
-
 func _get_plugin_logs(count: int, offset: int) -> Dictionary:
 	var all_lines := _log_buffer.get_recent(_log_buffer.total_count())
 	var page: Array[Dictionary] = []
@@ -123,10 +107,7 @@ func _get_plugin_logs(count: int, offset: int) -> Dictionary:
 	}
 
 
-func _get_game_logs(count: int, offset: int, include_details: bool, since_run_id: String = "") -> Dictionary:
+func _get_game_logs(count: int, offset: int, include_details: bool) -> Dictionary:
-	var game_status := _current_game_status()
-	var helper_live := bool(game_status.get("helper_live", false))
-	var session_active := bool(game_status.get("session_active", false))
 	if _game_log_buffer == null:
 		return {
 			"data": {
@@ -136,35 +117,21 @@ func _get_game_logs(count: int, offset: int, include_details: bool, since_run_id
 				"returned_count": 0,
 				"offset": offset,
 				"run_id": "",
-				"current_run_id": "",
+				"is_running": false,
-				"is_running": session_active,
-				"helper_live": helper_live,
-				"session_active": session_active,
-				"game_status": game_status,
 				"dropped_count": 0,
-				"stale_run_id": false,
 			}
 		}
-	var current_run_id := _game_log_buffer.run_id()
+	var page := _entries_for_response(_game_log_buffer.get_range(offset, count), include_details)
-	var target_run_id := since_run_id if not since_run_id.is_empty() else current_run_id
-	var stale_run_id := not since_run_id.is_empty() and since_run_id != current_run_id
-	var run_page := _game_log_buffer.get_run_page(target_run_id, offset, count)
-	var page := _entries_for_response(run_page.get("entries", []), include_details)
 	return {
 		"data": {
 			"source": "game",
 			"lines": page,
-			"total_count": int(run_page.get("total_count", 0)),
+			"total_count": _game_log_buffer.total_count(),
 			"returned_count": page.size(),
 			"offset": offset,
-			"run_id": target_run_id,
+			"run_id": _game_log_buffer.run_id(),
-			"current_run_id": current_run_id,
+			"is_running": EditorInterface.is_playing_scene(),
-			"is_running": session_active,
-			"helper_live": helper_live,
-			"session_active": session_active,
-			"game_status": game_status,
 			"dropped_count": _game_log_buffer.dropped_count(),
-			"stale_run_id": stale_run_id,
 		}
 	}
 
@@ -244,24 +211,21 @@ func _get_all_logs(count: int, offset: int, include_details: bool) -> Dictionary
 		combined.append({"source": "plugin", "level": "info", "text": line})
 	for entry in _collect_editor_log_entries():
 		combined.append(entry)
-	var run_id := ""
-	var current_run_id := ""
-	var dropped := 0
 	if _game_log_buffer != null:
-		run_id = _game_log_buffer.run_id()
+		for entry in _game_log_buffer.get_range(0, _game_log_buffer.total_count()):
-		current_run_id = run_id
-		dropped = _game_log_buffer.dropped_count()
-		var run_page := _game_log_buffer.get_run_page(run_id, 0, McpGameLogBuffer.MAX_LINES)
-		for entry in run_page.get("entries", []):
 			combined.append(entry)
 	var stop := mini(combined.size(), offset + count)
 	var page: Array[Dictionary] = []
 	for i in range(mini(offset, combined.size()), stop):
 		page.append(combined[i])
 	page = _entries_for_response(page, include_details)
+	var run_id := ""
+	var dropped := 0
+	if _game_log_buffer != null:
+		run_id = _game_log_buffer.run_id()
+		dropped = _game_log_buffer.dropped_count()
 	if _editor_log_buffer != null:
 		dropped += _editor_log_buffer.dropped_count()
-	var game_status := _current_game_status()
 	return {
 		"data": {
 			"source": "all",
@@ -270,11 +234,7 @@ func _get_all_logs(count: int, offset: int, include_details: bool) -> Dictionary
 			"returned_count": page.size(),
 			"offset": offset,
 			"run_id": run_id,
-			"current_run_id": current_run_id,
+			"is_running": EditorInterface.is_playing_scene(),
-			"is_running": bool(game_status.get("session_active", false)),
-			"helper_live": bool(game_status.get("helper_live", false)),
-			"session_active": bool(game_status.get("session_active", false)),
-			"game_status": game_status,
 			"dropped_count": dropped,
 		}
 	}

addons/godot_ai/handlers/node_handler.gd

@@ -239,10 +239,16 @@ func set_property(params: Dictionary) -> Dictionary:
 		# properties. Mirrors resource_create's inline-assign path but
 		# avoids a separate tool call for the common case.
 		var type_str: String = value.get("__class__", "")
-		var made := ResourceHandler._instantiate_resource(type_str)
+		var class_err := ResourceHandler._validate_resource_class(type_str)
-		if made is Dictionary:
+		if class_err != null:
-			return made
+			return class_err
-		var res: Resource = made
+		var instance := ClassDB.instantiate(type_str)
+		if instance == null or not (instance is Resource):
+			return ErrorCodes.make(
+				ErrorCodes.INTERNAL_ERROR,
+				"Failed to instantiate %s as a Resource" % type_str
+			)
+		var res: Resource = instance
 		var remaining: Dictionary = (value as Dictionary).duplicate()
 		remaining.erase("__class__")
 		if not remaining.is_empty():
@@ -522,7 +528,6 @@ func _set_owner_recursive(node: Node, owner: Node) -> void:
 ## is optional — the coercer defaults it to 1.0 when absent.
 const VECTOR2_KEYS: Array[String] = ["x", "y"]
 const VECTOR3_KEYS: Array[String] = ["x", "y", "z"]
-const VECTOR4_KEYS: Array[String] = ["x", "y", "z", "w"]
 const COLOR_KEYS: Array[String] = ["r", "g", "b"]
 
 
@@ -551,8 +556,6 @@ static func _check_coerced(value: Variant, target_type: int, prefix: String = ""
 			ok = value is PackedVector2Array
 		TYPE_PACKED_VECTOR3_ARRAY:
 			ok = value is PackedVector3Array
-		TYPE_PACKED_VECTOR4_ARRAY:
-			ok = value is PackedVector4Array
 		TYPE_PACKED_COLOR_ARRAY:
 			ok = value is PackedColorArray
 		TYPE_PACKED_INT32_ARRAY:
@@ -565,31 +568,8 @@ static func _check_coerced(value: Variant, target_type: int, prefix: String = ""
 			ok = value is PackedFloat64Array
 		TYPE_PACKED_STRING_ARRAY:
 			ok = value is PackedStringArray
-		TYPE_VECTOR2I: ok = value is Vector2i
-		TYPE_VECTOR3I: ok = value is Vector3i
-		TYPE_VECTOR4: ok = value is Vector4
-		TYPE_VECTOR4I: ok = value is Vector4i
-		TYPE_QUATERNION: ok = value is Quaternion
-		TYPE_RECT2: ok = value is Rect2
-		TYPE_RECT2I: ok = value is Rect2i
-		TYPE_AABB: ok = value is AABB
-		TYPE_PLANE: ok = value is Plane
-		TYPE_BASIS: ok = value is Basis
-		TYPE_TRANSFORM2D: ok = value is Transform2D
-		TYPE_TRANSFORM3D: ok = value is Transform3D
-		TYPE_PROJECTION: ok = value is Projection
 		_:
-			# null / untyped-TYPE_NIL / already-correct-type are handled by
+			return null
-			# Godot's setter; anything else would silently no-op, so error.
-			if value == null or target_type == TYPE_NIL or typeof(value) == target_type:
-				return null
-			var unsupported := ErrorCodes.make(
-				ErrorCodes.WRONG_TYPE,
-				"Cannot write %s to a %s property; godot-ai has no coercion for that type" % [
-					type_string(typeof(value)), type_string(target_type),
-				],
-			)
-			return ErrorCodes.prefix_message(unsupported, prefix)
 	if ok:
 		return null
 	var dict_err := _check_dict_coerce_failed(value, target_type)
@@ -617,8 +597,6 @@ static func _shape_hint(target_type: int) -> String:
 			return "[{\"x\":0,\"y\":0}, ...]"
 		TYPE_PACKED_VECTOR3_ARRAY:
 			return "[{\"x\":0,\"y\":0,\"z\":0}, ...]"
-		TYPE_PACKED_VECTOR4_ARRAY:
-			return "[{\"x\":0,\"y\":0,\"z\":0,\"w\":0}, ...]"
 		TYPE_PACKED_COLOR_ARRAY:
 			return "[{\"r\":0,\"g\":0,\"b\":0,\"a\":1}, ...]"
 		TYPE_PACKED_INT32_ARRAY, TYPE_PACKED_INT64_ARRAY:
@@ -627,24 +605,6 @@ static func _shape_hint(target_type: int) -> String:
 			return "[float, ...]"
 		TYPE_PACKED_STRING_ARRAY:
 			return "[\"...\", ...]"
-		TYPE_VECTOR2I:
-			return "{\"x\":0,\"y\":0}"
-		TYPE_VECTOR3I:
-			return "{\"x\":0,\"y\":0,\"z\":0}"
-		TYPE_VECTOR4, TYPE_VECTOR4I, TYPE_QUATERNION:
-			return "{\"x\":0,\"y\":0,\"z\":0,\"w\":0}"
-		TYPE_RECT2, TYPE_RECT2I, TYPE_AABB:
-			return "{\"position\":{...},\"size\":{...}}"
-		TYPE_PLANE:
-			return "{\"normal\":{...},\"d\":0}"
-		TYPE_BASIS:
-			return "{\"x\":{...},\"y\":{...},\"z\":{...}}"
-		TYPE_TRANSFORM2D:
-			return "{\"x\":{...},\"y\":{...},\"origin\":{...}}"
-		TYPE_TRANSFORM3D:
-			return "{\"basis\":{...},\"origin\":{...}}"
-		TYPE_PROJECTION:
-			return "{\"x\":{...},\"y\":{...},\"z\":{...},\"w\":{...}}"
 	var keys: Array[String] = []
 	match target_type:
 		TYPE_VECTOR2: keys = VECTOR2_KEYS
@@ -757,17 +717,6 @@ static func _coerce_value(value: Variant, target_type: int) -> Variant:
 					else:
 						return value
 				return out
-		TYPE_PACKED_VECTOR4_ARRAY:
-			if value is Array:
-				var out := PackedVector4Array()
-				for item in value:
-					if item is Vector4:
-						out.append(item)
-					elif item is Dictionary and item.has_all(VECTOR4_KEYS):
-						out.append(Vector4(item["x"], item["y"], item["z"], item["w"]))
-					else:
-						return value
-				return out
 		TYPE_PACKED_COLOR_ARRAY:
 			if value is Array:
 				var out := PackedColorArray()
@@ -808,72 +757,6 @@ static func _coerce_value(value: Variant, target_type: int) -> Variant:
 					else:
 						return value
 				return out
-		TYPE_VECTOR2I:
-			if value is Dictionary and value.has_all(VECTOR2_KEYS):
-				return Vector2i(int(value["x"]), int(value["y"]))
-		TYPE_VECTOR3I:
-			if value is Dictionary and value.has_all(VECTOR3_KEYS):
-				return Vector3i(int(value["x"]), int(value["y"]), int(value["z"]))
-		TYPE_VECTOR4:
-			if value is Dictionary and value.has_all(VECTOR4_KEYS):
-				return Vector4(value["x"], value["y"], value["z"], value["w"])
-		TYPE_VECTOR4I:
-			if value is Dictionary and value.has_all(VECTOR4_KEYS):
-				return Vector4i(int(value["x"]), int(value["y"]), int(value["z"]), int(value["w"]))
-		TYPE_QUATERNION:
-			if value is Dictionary and value.has_all(VECTOR4_KEYS):
-				return Quaternion(value["x"], value["y"], value["z"], value["w"])
-		TYPE_RECT2:
-			if value is Dictionary and value.has("position") and value.has("size"):
-				var p: Variant = _coerce_value(value["position"], TYPE_VECTOR2)
-				var s: Variant = _coerce_value(value["size"], TYPE_VECTOR2)
-				if p is Vector2 and s is Vector2:
-					return Rect2(p, s)
-		TYPE_RECT2I:
-			if value is Dictionary and value.has("position") and value.has("size"):
-				var p: Variant = _coerce_value(value["position"], TYPE_VECTOR2I)
-				var s: Variant = _coerce_value(value["size"], TYPE_VECTOR2I)
-				if p is Vector2i and s is Vector2i:
-					return Rect2i(p, s)
-		TYPE_AABB:
-			if value is Dictionary and value.has("position") and value.has("size"):
-				var p: Variant = _coerce_value(value["position"], TYPE_VECTOR3)
-				var s: Variant = _coerce_value(value["size"], TYPE_VECTOR3)
-				if p is Vector3 and s is Vector3:
-					return AABB(p, s)
-		TYPE_PLANE:
-			if value is Dictionary and value.has("normal") and value.has("d"):
-				var n: Variant = _coerce_value(value["normal"], TYPE_VECTOR3)
-				if n is Vector3:
-					return Plane(n, float(value["d"]))
-		TYPE_BASIS:
-			if value is Dictionary and value.has_all(["x", "y", "z"]):
-				var bx: Variant = _coerce_value(value["x"], TYPE_VECTOR3)
-				var by: Variant = _coerce_value(value["y"], TYPE_VECTOR3)
-				var bz: Variant = _coerce_value(value["z"], TYPE_VECTOR3)
-				if bx is Vector3 and by is Vector3 and bz is Vector3:
-					return Basis(bx, by, bz)
-		TYPE_TRANSFORM2D:
-			if value is Dictionary and value.has_all(["x", "y", "origin"]):
-				var tx: Variant = _coerce_value(value["x"], TYPE_VECTOR2)
-				var ty: Variant = _coerce_value(value["y"], TYPE_VECTOR2)
-				var to_: Variant = _coerce_value(value["origin"], TYPE_VECTOR2)
-				if tx is Vector2 and ty is Vector2 and to_ is Vector2:
-					return Transform2D(tx, ty, to_)
-		TYPE_TRANSFORM3D:
-			if value is Dictionary and value.has("basis") and value.has("origin"):
-				var b: Variant = _coerce_value(value["basis"], TYPE_BASIS)
-				var o: Variant = _coerce_value(value["origin"], TYPE_VECTOR3)
-				if b is Basis and o is Vector3:
-					return Transform3D(b, o)
-		TYPE_PROJECTION:
-			if value is Dictionary and value.has_all(VECTOR4_KEYS):
-				var px: Variant = _coerce_value(value["x"], TYPE_VECTOR4)
-				var py: Variant = _coerce_value(value["y"], TYPE_VECTOR4)
-				var pz: Variant = _coerce_value(value["z"], TYPE_VECTOR4)
-				var pw: Variant = _coerce_value(value["w"], TYPE_VECTOR4)
-				if px is Vector4 and py is Vector4 and pz is Vector4 and pw is Vector4:
-					return Projection(px, py, pz, pw)
 		# PackedByteArray intentionally unhandled — needs design decision
 		# (base64 string vs. raw int list); JSON has no native byte type.
 	return value

addons/godot_ai/handlers/project_handler.gd

@@ -6,17 +6,14 @@ const ErrorCodes := preload("res://addons/godot_ai/utils/error_codes.gd")
 ## Handles project settings and filesystem search commands.
 
 const NodeHandler := preload("res://addons/godot_ai/handlers/node_handler.gd")
-const RUN_READY_WAIT_SEC := 3.0
 
 var _connection: McpConnection
 var _debugger_plugin
-var _editor_log_buffer
 
 
-func _init(connection: McpConnection = null, debugger_plugin = null, editor_log_buffer = null) -> void:
+func _init(connection: McpConnection = null, debugger_plugin = null) -> void:
 	_connection = connection
 	_debugger_plugin = debugger_plugin
-	_editor_log_buffer = editor_log_buffer
 
 
 func get_project_setting(params: Dictionary) -> Dictionary:
@@ -84,15 +81,16 @@ func run_project(params: Dictionary) -> Dictionary:
 	# stop-not-running case in telemetry). Surface state via was_already_running
 	# so a caller wanting a *different* scene can detect and stop+restart.
 	if EditorInterface.is_playing_scene():
-		return _run_project_current_liveness_response(
+		return {
-			_run_project_base_data(
+			"data": {
-				mode,
+				"mode": mode,
-				str(params.get("scene", "")),
+				"scene": params.get("scene", ""),
-				autosave,
+				"autosave": autosave,
-				true,
+				"was_already_running": true,
-				"Project was already running; no action taken"
+				"undoable": false,
-			)
+				"reason": "Project was already running; no action taken",
-		)
+			}
+		}
 
 	var validation_error: Variant = null
 	if mode == "custom":
@@ -127,7 +125,7 @@ func run_project(params: Dictionary) -> Dictionary:
 		restore_setting = true
 
 	if _debugger_plugin != null:
-		_debugger_plugin.begin_game_run(_editor_log_cursor(), _game_helper_autoload_expected())
+		_debugger_plugin.begin_game_run()
 
 	match mode:
 		"main":
@@ -144,173 +142,18 @@ func run_project(params: Dictionary) -> Dictionary:
 	if _connection:
 		_connection.pause_processing = false
 
-	var base_data := _run_project_base_data(
-		mode,
-		str(params.get("scene", "")),
-		autosave,
-		false,
-		"Play/stop is a runtime action"
-	)
-	var request_id: String = params.get("_request_id", "")
-	if _connection != null and _debugger_plugin != null and not request_id.is_empty():
-		_finish_run_project_deferred(request_id, base_data)
-		return McpDispatcher.DEFERRED_RESPONSE
-
-	return _run_project_current_liveness_response(base_data)
-
-
-func _editor_log_cursor() -> int:
-	return _editor_log_buffer.appended_total() if _editor_log_buffer != null else 0
-
-
-func _game_helper_autoload_expected() -> bool:
-	return ProjectSettings.has_setting("autoload/_mcp_game_helper")
-
-
-func _run_project_base_data(
-	mode: String,
-	scene: String,
-	autosave: bool,
-	was_already_running: bool,
-	reason: String
-) -> Dictionary:
 	return {
-		"mode": mode,
+		"data": {
-		"scene": scene,
+			"mode": mode,
-		"autosave": autosave,
+			"scene": params.get("scene", ""),
-		"was_already_running": was_already_running,
+			"autosave": autosave,
-		"undoable": false,
+			"was_already_running": false,
-		"reason": reason,
+			"undoable": false,
+			"reason": "Play/stop is a runtime action",
+		}
 	}
 
 
-func _run_project_current_liveness_response(base_data: Dictionary) -> Dictionary:
-	if _debugger_plugin == null:
-		return {"data": base_data}
-	var status: Dictionary = _debugger_plugin.get_game_status(-1, RUN_READY_WAIT_SEC)
-	var errors_info: Dictionary = _debugger_plugin.recent_editor_errors_since(int(status.get("editor_log_cursor", 0)))
-	return _run_project_response(base_data, _run_project_liveness_decision(status, errors_info))
-
-
-func _finish_run_project_deferred(request_id: String, base_data: Dictionary) -> void:
-	var tree := _connection.get_tree()
-	while true:
-		await tree.process_frame
-		if not is_instance_valid(_connection):
-			return
-		var pre_status: Dictionary = _debugger_plugin.get_game_status(-1, RUN_READY_WAIT_SEC)
-		if (
-			not EditorInterface.is_playing_scene()
-			and int(pre_status.get("elapsed_msec", 0)) > 100
-			and str(pre_status.get("status", "stopped")) == "launching"
-		):
-			_debugger_plugin.end_game_run()
-		var status: Dictionary = _debugger_plugin.get_game_status(-1, RUN_READY_WAIT_SEC)
-		var errors_info: Dictionary = _debugger_plugin.recent_editor_errors_since(int(status.get("editor_log_cursor", 0)))
-		var decision := _run_project_liveness_decision(status, errors_info)
-		if not bool(decision.get("resolve", false)):
-			continue
-		_connection.send_deferred_response(request_id, _run_project_response(base_data, decision))
-		return
-
-
-func _run_project_response(base_data: Dictionary, decision: Dictionary) -> Dictionary:
-	var data := base_data.duplicate(true)
-	var game_status: Dictionary = decision.get("game_status", {})
-	data["game_status"] = game_status
-	data["helper_live"] = bool(game_status.get("helper_live", false))
-	data["session_active"] = bool(game_status.get("session_active", false))
-	if bool(data.get("was_already_running", false)):
-		data["reason"] = _run_project_already_running_message(decision)
-	else:
-		data["reason"] = decision.get("message", data.get("reason", "Play/stop is a runtime action"))
-	data["recent_errors"] = decision.get("recent_errors", [])
-	data["recent_errors_scope"] = decision.get("recent_errors_scope", "none")
-	data["recent_errors_may_predate_run"] = decision.get("recent_errors_may_predate_run", false)
-	data["recent_errors_truncated"] = decision.get("recent_errors_truncated", false)
-	return {"data": data}
-
-
-func _run_project_already_running_message(decision: Dictionary) -> String:
-	var state := str(decision.get("liveness_status", "unknown"))
-	match state:
-		"live":
-			return "Project was already running; the Godot AI game helper is live."
-		"not_live":
-			var errors: Array = decision.get("recent_errors", [])
-			var scope := str(decision.get("recent_errors_scope", "none"))
-			if not errors.is_empty() and scope == "run":
-				return "Project was already running but failed to load before the Godot AI game helper registered: %s. Check logs_read(source='editor', include_details=true)." % _format_editor_error_summary(errors[0])
-			if not errors.is_empty():
-				return "Project was already running but is not responding. A recent editor error may be related, but may predate this run: %s. Check logs_read(source='editor', include_details=true)." % _format_editor_error_summary(errors[0])
-			return "Project was already running but did not become live before the helper-ready window elapsed. Check logs_read(source='editor', include_details=true) and poll editor_state."
-		"no_helper":
-			return "Project was already running, but no _mcp_game_helper autoload is expected. Headless or custom-main-loop projects cannot confirm helper liveness."
-		"launching":
-			return "Project was already running and is still waiting for the Godot AI game helper to register. Poll editor_state shortly."
-		"stopped":
-			return "Project was already marked playing by the editor, but no active game liveness run exists."
-		_:
-			return "Project was already running; current liveness status is %s." % state
-
-
-func _run_project_liveness_decision(status: Dictionary, errors_info: Dictionary = {}) -> Dictionary:
-	var enriched_status := McpDebuggerPlugin.with_liveness_flags(status)
-	var state := str(status.get("status", "stopped"))
-	var recent_errors: Array = errors_info.get("errors", [])
-	var errors_scope := str(errors_info.get("scope", "none"))
-	var truncated := bool(errors_info.get("truncated", false))
-	var correlated_error := not recent_errors.is_empty() and errors_scope == "run"
-	var elapsed_msec := int(status.get("elapsed_msec", 0))
-	var ready_wait_msec := int(status.get("ready_wait_msec", int(RUN_READY_WAIT_SEC * 1000.0)))
-	var decision := {
-		"resolve": false,
-		"game_status": enriched_status,
-		"liveness_status": state,
-		"recent_errors": recent_errors,
-		"recent_errors_scope": errors_scope,
-		"recent_errors_may_predate_run": errors_scope == "retained_recent",
-		"recent_errors_truncated": truncated,
-		"message": "",
-	}
-	if state == "live":
-		decision["resolve"] = true
-		decision["message"] = "Game launched and the Godot AI game helper is live."
-	elif correlated_error:
-		decision["resolve"] = true
-		decision["liveness_status"] = "not_live"
-		decision["message"] = "Game launched but failed to load before the Godot AI game helper registered: %s. Check logs_read(source='editor', include_details=true)." % _format_editor_error_summary(recent_errors[0])
-		if truncated:
-			decision["message"] += " Editor logs since this run may be truncated; showing retained errors."
-	elif state == "not_live":
-		decision["resolve"] = true
-		if not recent_errors.is_empty():
-			decision["message"] = "Game launched but is not responding. A recent editor error may be related, but may predate this run: %s. Check logs_read(source='editor', include_details=true)." % _format_editor_error_summary(recent_errors[0])
-		else:
-			decision["message"] = "Game launched but did not become live before the helper-ready window elapsed. It may still be booting or may have failed silently; check logs_read(source='editor', include_details=true) and poll editor_state."
-	elif state == "no_helper":
-		decision["resolve"] = true
-		decision["message"] = "Game launched, but no _mcp_game_helper autoload is expected. Headless or custom-main-loop projects cannot confirm helper liveness; use editor_state and viewport/editor tools where applicable."
-	elif state == "stopped":
-		decision["resolve"] = true
-		decision["message"] = "The play session stopped, or no active game liveness run exists, before the Godot AI game helper became live."
-	elif state == "launching" and elapsed_msec >= ready_wait_msec:
-		decision["resolve"] = true
-		decision["message"] = "Game launched but is not yet live after %.1fs; it may still be booting. Poll editor_state and check logs_read(source='editor', include_details=true)." % (float(elapsed_msec) / 1000.0)
-	return decision
-
-
-func _format_editor_error_summary(entry: Dictionary) -> String:
-	var text := str(entry.get("text", "editor error"))
-	var path := str(entry.get("path", ""))
-	var line := int(entry.get("line", 0))
-	if not path.is_empty() and line > 0:
-		return "%s (%s:%d)" % [text, path, line]
-	if not path.is_empty():
-		return "%s (%s)" % [text, path]
-	return text
-
-
 func stop_project(params: Dictionary) -> Dictionary:
 	# Idempotent: a project that's already stopped satisfies the caller's intent.
 	# Returning INVALID_PARAMS here was the largest single source of fleet-wide

addons/godot_ai/handlers/resource_handler.gd

@@ -178,10 +178,19 @@ func create_resource(params: Dictionary) -> Dictionary:
 		return home_err
 	var has_file_target := not resource_path.is_empty()
 
-	var made := _instantiate_resource(type_str)
+	var class_err := _validate_resource_class(type_str)
-	if made is Dictionary:
+	if class_err != null:
-		return made
+		return class_err
-	var res: Resource = made
+
+	var instance := ClassDB.instantiate(type_str)
+	if instance == null:
+		return ErrorCodes.make(ErrorCodes.INTERNAL_ERROR, "Failed to instantiate %s" % type_str)
+	if not (instance is Resource):
+		return ErrorCodes.make(
+			ErrorCodes.INTERNAL_ERROR,
+			"Instantiated %s but result is not a Resource (got %s)" % [type_str, instance.get_class()]
+		)
+	var res: Resource = instance
 
 	if not properties.is_empty():
 		var apply_err := _apply_resource_properties(res, properties)
@@ -217,56 +226,6 @@ static func _validate_resource_class(type_str: String) -> Variant:
 	return null
 
 
-## Resolve a resource type name to a fresh instance. Handles engine built-ins
-## (ClassDB) and project `class_name` Resources (the global script-class
-## registry). Returns a Resource on success, or an error dict on failure.
-static func _instantiate_resource(type_str: String) -> Variant:
-	if ClassDB.class_exists(type_str):
-		var class_err: Variant = _validate_resource_class(type_str)
-		if class_err != null:
-			return class_err
-		var built_in := ClassDB.instantiate(type_str)
-		if built_in == null or not (built_in is Resource):
-			return ErrorCodes.make(ErrorCodes.INTERNAL_ERROR, "Failed to instantiate %s as a Resource" % type_str)
-		return built_in
-	for entry in ProjectSettings.get_global_class_list():
-		if entry.get("class", "") == type_str:
-			var script_path: String = entry.get("path", "")
-			var scr: Variant = load(script_path)
-			# Reject non-Resource script classes BEFORE constructing them:
-			# scr.new() runs _init(), and an @tool class_name extending a
-			# non-RefCounted type (e.g. Node) would otherwise build — and leak —
-			# an orphan instance this path never frees. get_instance_base_type()
-			# resolves to the native base, so multi-level custom Resource
-			# hierarchies (B extends A extends Resource) still pass.
-			var base_or_err: Variant = _script_base_type_or_error(scr, type_str, script_path)
-			if base_or_err is Dictionary:
-				return base_or_err
-			var base_type: StringName = base_or_err
-			if not ClassDB.is_parent_class(base_type, "Resource"):
-				return ErrorCodes.make(ErrorCodes.WRONG_TYPE, "%s is not a Resource type (extends %s)" % [type_str, base_type])
-			if not scr.can_instantiate():
-				return ErrorCodes.make(ErrorCodes.WRONG_TYPE, "%s cannot be instantiated in the editor (abstract, or a non-@tool script — add @tool to instantiate it here)" % type_str)
-			# Reject scripts whose _init() requires arguments BEFORE scr.new():
-			# scr.new() passes no args, so a required-arg _init raises and aborts
-			# this handler mid-call, null-cascading into a generic "malformed
-			# result" error instead of a clean rejection. get_script_method_list()
-			# reports the effective (incl. inherited) _init; required args =
-			# args - default_args. Statically detectable only — a _init that runs
-			# but throws still falls through to scr.new() and the dispatcher catch.
-			for method in scr.get_script_method_list():
-				if method.get("name", "") == "_init":
-					var required_args: int = (method.get("args", []) as Array).size() - (method.get("default_args", []) as Array).size()
-					if required_args > 0:
-						return ErrorCodes.make(ErrorCodes.WRONG_TYPE, "%s cannot be instantiated: its _init() requires arguments" % type_str)
-					break
-			var made: Variant = scr.new()
-			if made == null or not (made is Resource):
-				return ErrorCodes.make(ErrorCodes.INTERNAL_ERROR, "Failed to instantiate %s as a Resource" % type_str)
-			return made
-	return ErrorCodes.make(ErrorCodes.VALUE_OUT_OF_RANGE, "Unknown resource type: %s" % type_str)
-
-
 ## Apply a dict of property values to a freshly-instantiated Resource,
 ## reusing NodeHandler's coercion so Vector3/Color/etc. dicts land typed.
 ## Returns null on success or an error dict on failure.
@@ -281,17 +240,9 @@ static func _apply_resource_properties(res: Resource, properties: Dictionary) ->
 				if prop.get("usage", 0) & PROPERTY_USAGE_EDITOR:
 					valid.append(prop.name)
 			valid.sort()
-			# Name the script's class_name (e.g. MyTestResource) rather than the
-			# native base (Resource) so the hint names the type the agent created,
-			# and point at the real MCP verb — resource_manage(op="get_info") now
-			# answers for project class_name Resources too.
-			var type_label := res.get_class()
-			var res_script: Variant = res.get_script()
-			if res_script is Script and not String(res_script.get_global_name()).is_empty():
-				type_label = String(res_script.get_global_name())
 			var err := ErrorCodes.make(
 				ErrorCodes.PROPERTY_NOT_ON_CLASS,
-				"Property '%s' not found on %s. Call resource_manage(op=\"get_info\", params={\"type\": \"%s\"}) to list available properties." % [key, type_label, type_label]
+				"Property '%s' not found on %s. Call resource_get_info('%s') to list available properties." % [key, res.get_class(), res.get_class()]
 			)
 			err["error"]["data"] = {"valid_properties": valid}
 			return err
@@ -319,15 +270,16 @@ static func _apply_resource_properties(res: Resource, properties: Dictionary) ->
 			# resource_create/environment_create callers can populate
 			# sub-resource slots (ShaderMaterial.shader, etc.) in one shot.
 			var sub_type: String = v.get("__class__", "")
-			# Resolve via the shared helper so the nested shortcut accepts both
+			var class_err := _validate_resource_class(sub_type)
-			# engine built-ins (ClassDB) and project `class_name` Resources,
+			if class_err != null:
-			# exactly like the top-level resource_create path.
+				return class_err
-			var sub_made := _instantiate_resource(sub_type)
+			var sub_instance := ClassDB.instantiate(sub_type)
-			if sub_made is Dictionary:
+			if sub_instance == null or not (sub_instance is Resource):
-				# Preserve the property-slot context the inline path used to add.
+				return ErrorCodes.make(
-				sub_made["error"]["message"] = "%s (for property '%s')" % [sub_made["error"]["message"], key]
+					ErrorCodes.INTERNAL_ERROR,
-				return sub_made
+					"Failed to instantiate %s as a Resource for property '%s'" % [sub_type, key]
-			var sub_res: Resource = sub_made
+				)
+			var sub_res: Resource = sub_instance
 			var remaining: Dictionary = (v as Dictionary).duplicate()
 			remaining.erase("__class__")
 			if not remaining.is_empty():
@@ -409,12 +361,6 @@ func get_resource_info(params: Dictionary) -> Dictionary:
 		return ErrorCodes.make(ErrorCodes.MISSING_REQUIRED_PARAM, "Missing required param: type")
 
 	if not ClassDB.class_exists(type_str):
-		# Project class_name Resources aren't in ClassDB; resolve them through the
-		# global script-class registry so get_info answers for the same custom
-		# types resource_create can make. Read-only — never instantiates.
-		var custom_info: Variant = _custom_resource_info(type_str)
-		if custom_info != null:
-			return custom_info
 		return ErrorCodes.make(ErrorCodes.VALUE_OUT_OF_RANGE, "Unknown resource type: %s" % type_str)
 	if ClassDB.is_parent_class(type_str, "Node"):
 		return ErrorCodes.make(
@@ -450,82 +396,3 @@ func get_resource_info(params: Dictionary) -> Dictionary:
 		data["concrete_subclasses"] = class_info.concrete_inheritors
 
 	return {"data": data}
-
-
-## Resolve a loaded global-class script to its native base type, or an error if
-## the script failed to load (not a Script) or to compile (empty base type).
-## Shared by the create and get_info custom-Resource paths so both report a
-## compile failure rather than a misleading "is not a Resource type (extends )".
-static func _script_base_type_or_error(scr: Variant, type_str: String, script_path: String) -> Variant:
-	if not (scr is Script):
-		return ErrorCodes.make(ErrorCodes.INTERNAL_ERROR, "Failed to load script class %s from %s" % [type_str, script_path])
-	var base_type: StringName = scr.get_instance_base_type()
-	if String(base_type).is_empty():
-		return ErrorCodes.make(ErrorCodes.INTERNAL_ERROR, "%s failed to compile or parse (script %s)" % [type_str, script_path])
-	return base_type
-
-
-## get_info for a project `class_name` Resource (not in ClassDB). Returns an info
-## dict, an error dict (for a class_name whose native base is not a Resource), or
-## null if `type_str` is not a registered global class. Read-only: resolves
-## properties from the script + its native base WITHOUT instantiating (no _init()).
-static func _custom_resource_info(type_str: String) -> Variant:
-	for entry in ProjectSettings.get_global_class_list():
-		if entry.get("class", "") != type_str:
-			continue
-		var script_path: String = entry.get("path", "")
-		var scr: Variant = load(script_path)
-		var base_or_err: Variant = _script_base_type_or_error(scr, type_str, script_path)
-		if base_or_err is Dictionary:
-			return base_or_err
-		var base_type: StringName = base_or_err
-		if not ClassDB.is_parent_class(base_type, "Resource"):
-			return ErrorCodes.make(ErrorCodes.WRONG_TYPE, "%s is not a Resource type (extends %s)" % [type_str, base_type])
-		var can_instantiate: bool = scr.can_instantiate()
-		# Inherited (native) properties come from the engine base via ClassDB...
-		var class_info := ClassIntrospection.build(String(base_type), {
-			"sections": ["properties"],
-			"include_inherited": true,
-			"limit": 0,
-		})
-		var props: Array = []
-		for native_prop in class_info.properties:
-			props.append(native_prop)
-		# ...and the script's own (and inherited script) exported properties come
-		# from the Script itself, so we never construct the resource. A real
-		# default isn't available without instantiating, so script props carry an
-		# explicit null — keeping one uniform key set across the array (native
-		# props carry their real default).
-		for raw_prop in scr.get_script_property_list():
-			var prop: Dictionary = raw_prop
-			var usage := int(prop.get("usage", 0))
-			if not (usage & PROPERTY_USAGE_EDITOR):
-				continue
-			props.append({
-				"name": str(prop.get("name", "")),
-				"type": type_string(int(prop.get("type", TYPE_NIL))),
-				"class_name": str(prop.get("class_name", "")),
-				"hint": int(prop.get("hint", PROPERTY_HINT_NONE)),
-				"hint_string": str(prop.get("hint_string", "")),
-				"usage": usage,
-				"default": null,
-			})
-		props.sort_custom(func(a, b): return a.name < b.name)
-		# parent_class is the immediate script parent when there is one (so a
-		# multi-level chain B -> A -> Resource reports A), else the native base.
-		var parent_name := String(base_type)
-		var base_script: Variant = scr.get_base_script()
-		if base_script is Script and not String(base_script.get_global_name()).is_empty():
-			parent_name = String(base_script.get_global_name())
-		return {"data": {
-			"type": type_str,
-			"parent_class": parent_name,
-			"can_instantiate": can_instantiate,
-			# is_abstract reflects real abstractness (the @abstract annotation),
-			# NOT editor-instantiability — a non-@tool concrete Resource has
-			# can_instantiate()==false in-editor but is not abstract.
-			"is_abstract": scr.is_abstract(),
-			"properties": props,
-			"property_count": props.size(),
-		}}
-	return null

addons/godot_ai/handlers/signal_handler.gd

@@ -152,7 +152,7 @@ func connect_signal(params: Dictionary) -> Dictionary:
 		return ErrorCodes.make(ErrorCodes.INVALID_PARAMS, "Signal '%s' already connected to %s.%s" % [signal_name, params.target, method])
 
 	_undo_redo.create_action("MCP: Connect signal %s" % signal_name)
-	_undo_redo.add_do_method(source, "connect", signal_name, callable, Object.CONNECT_PERSIST)
+	_undo_redo.add_do_method(source, "connect", signal_name, callable)
 	_undo_redo.add_undo_method(source, "disconnect", signal_name, callable)
 	_undo_redo.commit_action()
 
@@ -174,19 +174,9 @@ func disconnect_signal(params: Dictionary) -> Dictionary:
 	if not source.is_connected(signal_name, callable):
 		return ErrorCodes.make(ErrorCodes.INVALID_PARAMS, "Signal '%s' is not connected to %s.%s" % [signal_name, params.target, method])
 
-	# Capture the connection's current flags so undo restores it exactly as it
-	# was, not unconditionally as CONNECT_PERSIST. Hardcoding PERSIST here would
-	# silently promote a runtime-only connection into one that serializes on the
-	# next save. (The connection still exists at this point — checked above.)
-	var reconnect_flags := 0
-	for conn in source.get_signal_connection_list(signal_name):
-		if conn.get("callable", Callable()) == callable:
-			reconnect_flags = int(conn.get("flags", 0))
-			break
-
 	_undo_redo.create_action("MCP: Disconnect signal %s" % signal_name)
 	_undo_redo.add_do_method(source, "disconnect", signal_name, callable)
-	_undo_redo.add_undo_method(source, "connect", signal_name, callable, reconnect_flags)
+	_undo_redo.add_undo_method(source, "connect", signal_name, callable)
 	_undo_redo.commit_action()
 
 	return {"data": _signal_response(source, signal_name, target, method, scene_root)}

addons/godot_ai/mcp_dock.gd

@@ -40,17 +40,8 @@ const LogViewerScript := preload("res://addons/godot_ai/dock_panels/log_viewer.g
 const PortPickerPanelScript := preload("res://addons/godot_ai/dock_panels/port_picker_panel.gd")
 
 const DEV_MODE_SETTING := "godot_ai/dev_mode"
-## "Change the port + reconfigure your clients" guide. Surfaced from the crash
-## panel when a foreign process holds the HTTP port — the one piece of recovery
-## (per-client config rewrite) that doesn't fit in the inline crash body.
-## Resolved against the installed plugin version at click time (see
-## `_port_conflict_docs_url`) so a shipped build opens the guide as it shipped,
-## not tip-of-main, which may have drifted from that build's UI.
-const PORT_CONFLICT_DOCS_PATH := "docs/port-conflicts.md"
-const REPO_BLOB_BASE := "https://github.com/hi-godot/godot-ai/blob"
 const CLIENT_STATUS_REFRESH_COOLDOWN_MSEC := 15 * 1000
 const CLIENT_STATUS_REFRESH_TIMEOUT_MSEC := 30 * 1000
-const CLIENT_ACTION_TIMEOUT_MSEC := 30 * 1000
 static var COLOR_MUTED := Color(0.7, 0.7, 0.7)
 static var COLOR_HEADER := Color(0.95, 0.95, 0.95)
 ## Used for "in-progress" / "stale, action needed" UI: the startup-grace
@@ -69,13 +60,12 @@ var _status_icon: ColorRect
 var _status_label: Label
 var _client_grid: VBoxContainer
 var _client_configure_all_btn: Button
-var _client_empty_cta_btn: Button
 var _clients_summary_label: Label
 var _clients_window: Window
 var _dev_mode_toggle: CheckButton
 var _install_label: Label
 
-# Tools tab (secondary window, Tab 2) — domain-exclusion UI for clients
+# Settings tab (secondary window, Tab 2) — domain-exclusion UI for clients
 # that cap total tool count (Antigravity: 100). Pending set is mutated by
 # checkbox clicks; saved set reflects what the spawned server actually
 # sees. `Apply & Restart Server` writes pending → setting and triggers a
@@ -157,24 +147,23 @@ static var _orphaned_client_status_refresh_threads: Array[Thread] = []
 
 ## Per-row worker state for Configure / Remove. Issue #239: shelling out
 ## to a hung CLI on main hangs the editor. We dispatch each click to its
-## own thread (one slot per client), then `_process` reaps completed workers
+## own thread (one slot per client) and apply the result via call_deferred
-## and applies returned payloads on main. The buttons stay disabled while
+## once the subprocess returns or the wall-clock budget in McpCliExec
-## the slot is busy so the user can't queue a re-click on the same row.
+## kicks in. The buttons stay disabled while the slot is busy so the user
+## can't queue a re-click on the same row.
 ##
 ## Per-client (not single-slot) so Configure-all can fan out — the
 ## workers are independent, only the row UI is shared, and McpCliExec
 ## bounds the wall-clock for each.
 ##
-## A watchdog can abandon a slot when a worker fails to report completion.
+## No orphan-thread list (unlike the refresh worker): action threads
-## The thread object is retained in `_orphaned_client_action_threads` until
+## never get abandoned mid-flight. McpCliExec's wall-clock budget caps
-## it finishes so GDScript does not destroy a live Thread object.
+## the worst case at ~10s, so the `_exit_tree` / `McpUpdateManager`
+## install-time drain blocks briefly and finishes — there's no path that
+## "gives up" on an action thread the way `_abandon_client_status_refresh_thread`
+## does for the refresh worker.
 var _client_action_threads: Dictionary = {}
 var _client_action_generations: Dictionary = {}
-var _client_action_started_msec: Dictionary = {}
-var _client_action_names: Dictionary = {}
-## Timed-out Configure/Remove workers are abandoned but retained here until
-## they finish, so GDScript does not destroy a live Thread object.
-static var _orphaned_client_action_threads: Array[Thread] = []
 
 # Dev-mode only
 var _dev_section: VBoxContainer
@@ -204,11 +193,6 @@ var _crash_panel: VBoxContainer
 var _crash_output: RichTextLabel
 var _crash_restart_btn: Button
 var _crash_reload_btn: Button
-## Help link — visible only for the genuinely-foreign-occupant INCOMPATIBLE
-## case (no `can_recover_incompatible` proof). The inline body names a free
-## port; this button carries the per-client reconfigure steps that don't fit
-## inline. See `PORT_CONFLICT_DOCS` and `_update_crash_panel`.
-var _crash_docs_btn: Button
 ## Port-picker escape hatch — visible inside the crash panel when the root
 ## cause is port contention (PORT_EXCLUDED or FOREIGN_PORT). The dock writes
 ## the EditorSetting and reloads the plugin in response to the panel's
@@ -254,14 +238,10 @@ func _ready() -> void:
 
 
 func _process(_delta: float) -> void:
-	_prune_orphaned_client_status_refresh_threads()
-	_prune_orphaned_client_action_threads()
-	_poll_completed_client_status_refresh_thread()
-	_poll_completed_client_action_threads()
-	_check_client_status_refresh_timeout()
-	_check_client_action_timeouts()
 	if _connection == null:
 		return
+	_prune_orphaned_client_status_refresh_threads()
+	_check_client_status_refresh_timeout()
 	_retry_deferred_client_status_refresh()
 	_update_status()
 	if _log_viewer != null and _log_viewer.visible:
@@ -295,8 +275,6 @@ func _exit_tree() -> void:
 ## drains directly because it has additional state-machine work
 ## (SHUTTING_DOWN sticky-set) that the install-time path must NOT inherit.
 func prepare_for_self_update_drain() -> void:
-	_poll_completed_client_status_refresh_thread()
-	_poll_completed_client_action_threads()
 	_drain_client_status_refresh_workers()
 	_drain_client_action_workers()
 
@@ -331,13 +309,13 @@ func _drain_client_action_workers() -> void:
 	## plugin disable / install-update path reloads our script class, so any
 	## live Thread must finish before its slot is GC'd or we hit
 	## `~Thread … destroyed without its completion having been realized` →
-	## VM corruption. Normal UI recovery is handled by the per-row watchdog;
+	## VM corruption. Bounded by `McpCliExec` wall-clock budgets, so the
-	## teardown still blocks because GDScript's Thread API has no kill/timeout
+	## worst case is a ~10s blocking drain, vs. an unbounded SIGSEGV.
-	## primitive and destroying a live Thread corrupts the VM.
 	##
-	## Generation-bumped per-row so any result from a worker that finished
+	## Generation-bumped per-row so any pending `call_deferred(
-	## after we started draining detects the generation mismatch and
+	## "_apply_client_action_result")` from a worker that finished after we
-	## short-circuits without touching freed UI state.
+	## started draining detects the generation mismatch and short-circuits
+	## without touching freed UI state.
 	##
 	## After draining, restore the row UI for any in-flight rows: bare
 	## `_client_action_threads.clear()` would leave the dock stuck showing
@@ -350,8 +328,6 @@ func _drain_client_action_workers() -> void:
 		if t != null:
 			t.wait_to_finish()
 		_client_action_generations[client_id] = int(_client_action_generations.get(client_id, 0)) + 1
-		_client_action_started_msec.erase(client_id)
-		_client_action_names.erase(client_id)
 		_finalize_action_buttons(String(client_id))
 		var row: Dictionary = _client_rows.get(String(client_id), {})
 		if not row.is_empty():
@@ -361,71 +337,6 @@ func _drain_client_action_workers() -> void:
 				""
 			)
 	_client_action_threads.clear()
-	for thread in _orphaned_client_action_threads:
-		if thread != null:
-			thread.wait_to_finish()
-	_orphaned_client_action_threads.clear()
-	_client_action_started_msec.clear()
-	_client_action_names.clear()
-
-
-func _check_client_action_timeouts() -> void:
-	var now := Time.get_ticks_msec()
-	for client_id in _client_action_threads.keys():
-		if not _client_action_started_msec.has(client_id):
-			continue
-		var started := int(_client_action_started_msec.get(client_id, 0))
-		if now - started >= CLIENT_ACTION_TIMEOUT_MSEC:
-			_abandon_client_action_thread(String(client_id))
-
-
-func _abandon_client_action_thread(client_id: String) -> void:
-	if not _client_action_threads.has(client_id):
-		return
-	var thread: Thread = _client_action_threads[client_id]
-	var elapsed := Time.get_ticks_msec() - int(_client_action_started_msec.get(client_id, Time.get_ticks_msec()))
-	var worker_alive := thread != null and thread.is_alive()
-	if thread != null:
-		_orphaned_client_action_threads.append(thread)
-	_client_action_threads.erase(client_id)
-	_client_action_started_msec.erase(client_id)
-	var action := str(_client_action_names.get(client_id, "configure"))
-	_client_action_names.erase(client_id)
-	_client_action_generations[client_id] = int(_client_action_generations.get(client_id, 0)) + 1
-	_finalize_action_buttons(client_id)
-	print("MCP | client action timed out: client=%s action=%s elapsed_ms=%d worker_alive=%s" % [
-		client_id,
-		action,
-		elapsed,
-		str(worker_alive),
-	])
-	var label := "Remove" if action == "remove" else "Configure"
-	_apply_row_status(
-		client_id,
-		Client.Status.ERROR,
-		"%s did not report completion in time; refreshing current status." % label
-	)
-	_refresh_clients_summary()
-	if is_inside_tree():
-		_request_client_status_refresh(true)
-
-
-func _prune_orphaned_client_action_threads() -> void:
-	var completed_orphan := false
-	for i in range(_orphaned_client_action_threads.size() - 1, -1, -1):
-		var thread := _orphaned_client_action_threads[i]
-		if thread == null:
-			_orphaned_client_action_threads.remove_at(i)
-		elif not thread.is_alive():
-			thread.wait_to_finish()
-			_orphaned_client_action_threads.remove_at(i)
-			completed_orphan = true
-	if completed_orphan and is_inside_tree():
-		_request_client_action_completion_refresh()
-
-
-func _request_client_action_completion_refresh() -> void:
-	_request_client_status_refresh(true)
 
 
 func _notification(what: int) -> void:
@@ -562,13 +473,6 @@ func _build_ui() -> void:
 	_crash_reload_btn.pressed.connect(_on_reload_plugin)
 	_crash_panel.add_child(_crash_reload_btn)
 
-	_crash_docs_btn = Button.new()
-	_crash_docs_btn.text = "How to change the port"
-	_crash_docs_btn.tooltip_text = "Open the guide: change godot_ai/http_port and reconfigure your MCP clients"
-	_crash_docs_btn.visible = false
-	_crash_docs_btn.pressed.connect(func(): OS.shell_open(_port_conflict_docs_url()))
-	_crash_panel.add_child(_crash_docs_btn)
-
 	_crash_panel.add_child(HSeparator.new())
 	add_child(_crash_panel)
 
@@ -654,45 +558,30 @@ func _build_ui() -> void:
 	add_child(HSeparator.new())
 
 	# --- Clients ---
-	var clients_header_row := HBoxContainer.new()
+	var clients_row := HBoxContainer.new()
-	clients_header_row.add_theme_constant_override("separation", 8)
+	clients_row.add_theme_constant_override("separation", 8)
 
 	var clients_header := _make_header("Clients")
-	clients_header_row.add_child(clients_header)
+	clients_row.add_child(clients_header)
 
 	_clients_summary_label = Label.new()
 	_clients_summary_label.add_theme_color_override("font_color", COLOR_MUTED)
-	_clients_summary_label.clip_text = true
-	_clients_summary_label.text_overrun_behavior = TextServer.OVERRUN_TRIM_ELLIPSIS
 	_clients_summary_label.size_flags_horizontal = Control.SIZE_EXPAND_FILL
-	clients_header_row.add_child(_clients_summary_label)
+	clients_row.add_child(_clients_summary_label)
-
-	var clients_actions := HFlowContainer.new()
-	clients_actions.add_theme_constant_override("h_separation", 8)
-	clients_actions.add_theme_constant_override("v_separation", 4)
 
 	var clients_refresh_btn := Button.new()
 	clients_refresh_btn.text = "Refresh"
 	clients_refresh_btn.tooltip_text = "Refresh client status in the background. Cached status stays visible while checks run."
 	clients_refresh_btn.pressed.connect(_on_refresh_clients_pressed)
-	clients_actions.add_child(clients_refresh_btn)
+	clients_row.add_child(clients_refresh_btn)
 
 	var clients_open_btn := Button.new()
-	clients_open_btn.text = "Clients & Tools"
+	clients_open_btn.text = "Clients & Settings"
-	clients_open_btn.tooltip_text = "Open the Clients & Tools window — configure AI clients, choose telemetry preferences, or disable tool domains to fit under a client's hard tool-count cap (e.g. Antigravity's 100)."
+	clients_open_btn.tooltip_text = "Open the MCP settings window — configure AI clients, choose telemetry preferences, or disable tool domains to fit under a client's hard tool-count cap (e.g. Antigravity's 100)."
 	clients_open_btn.pressed.connect(_on_open_clients_window)
-	clients_actions.add_child(clients_open_btn)
+	clients_row.add_child(clients_open_btn)
 
-	add_child(clients_header_row)
+	add_child(clients_row)
-	add_child(clients_actions)
-
-	_client_empty_cta_btn = Button.new()
-	_client_empty_cta_btn.text = "Configure an AI client ->"
-	_client_empty_cta_btn.tooltip_text = "Open the Clients tab to configure an AI coding client for this Godot AI server."
-	_client_empty_cta_btn.size_flags_horizontal = Control.SIZE_EXPAND_FILL
-	_client_empty_cta_btn.visible = false
-	_client_empty_cta_btn.pressed.connect(_on_open_clients_window)
-	add_child(_client_empty_cta_btn)
 
 	# Drift banner — hidden until a sweep finds at least one mismatched client.
 	_drift_banner = VBoxContainer.new()
@@ -711,7 +600,7 @@ func _build_ui() -> void:
 	add_child(_drift_banner)
 
 	_clients_window = Window.new()
-	_clients_window.title = "Godot AI"
+	_clients_window.title = "MCP Clients & Settings"
 	## `Vector2i * float` yields Vector2; wrap the result back to Vector2i.
 	_clients_window.min_size = Vector2i(Vector2(560, 460) * EditorInterface.get_editor_scale())
 	_clients_window.visible = false
@@ -869,7 +758,7 @@ func _build_client_row(client_id: String) -> void:
 # --- Status updates ---
 
 func _update_status() -> void:
-	var connected: bool = _connection != null and _connection.is_connected
+	var connected: bool = _connection.is_connected
 	## During plugin self-update there's a brief window where this dock
 	## script is already the new version (Godot hot-reloads scripts on
 	## file change) but `_plugin` is still the old `EditorPlugin` instance
@@ -896,7 +785,7 @@ func _update_status() -> void:
 		status_text = "Restarting server..."
 		status_color = COLOR_AMBER
 	elif connected:
-		status_text = _connected_status_text()
+		status_text = "Connected"
 		status_color = Color.GREEN
 	elif state == ServerStateScript.CRASHED:
 		var exit_ms: int = server_status.get("exit_ms", 0)
@@ -969,15 +858,6 @@ func _update_crash_panel(server_status: Dictionary) -> void:
 			not show_recovery_restart
 			and state != ServerStateScript.INCOMPATIBLE
 		)
-	## Docs link only for the genuinely-foreign occupant: a recoverable
-	## (older godot-ai) server gets Restart Server instead, and the inline
-	## body already names a free port — the link carries the per-client
-	## reconfigure steps that don't fit inline.
-	if _crash_docs_btn != null:
-		_crash_docs_btn.visible = (
-			state == ServerStateScript.INCOMPATIBLE
-			and not bool(server_status.get("can_recover_incompatible", false))
-		)
 
 	var port_picker_visible := (
 		state == ServerStateScript.PORT_EXCLUDED
@@ -1007,16 +887,9 @@ static func _crash_body_for_state(state: int, server_status: Dictionary = {}) ->
 				if not message.is_empty():
 					return "%s Click Restart Server below to replace it with godot-ai v%s." % [message, expected]
 				return "Port %d is occupied by an older godot-ai server. Click Restart Server below to replace it with godot-ai v%s." % [port, expected]
-			## Genuinely foreign occupant (no recovery proof). Name a concrete
-			## free port so the user doesn't have to hunt for one, and let the
-			## crash panel's "How to change the port" link carry the per-client
-			## reconfigure steps. `suggest_free_port` already routes through the
-			## Windows reservation table, so the named port won't itself fail
-			## with WinError 10013.
-			var hint := _free_port_hint(port)
 			if not message.is_empty():
-				return "%s %s" % [message, hint]
+				return message
-			return "Port %d is occupied by an incompatible server. %s" % [port, hint]
+			return "Port %d is occupied by an incompatible server. Stop it or change both HTTP and WS ports." % port
 		ServerStateScript.FOREIGN_PORT:
 			return "Another process is already bound to port %d. Pick a free port or stop the other process." % port
 		ServerStateScript.CRASHED:
@@ -1034,31 +907,6 @@ static func _crash_body_for_state(state: int, server_status: Dictionary = {}) ->
 			return ""
 
 
-## One sentence naming concrete free ports for the user to switch to. Names
-## BOTH http and ws: this branch also fires for an incompatible godot-ai
-## server we can't prove we own, which commonly holds both ports — moving only
-## http would then leave the new server unable to bind ws. Both suggestions are
-## routed through `suggest_free_port` so they clear Windows' winnat reservation
-## table (no point suggesting a port that 10013s on bind). Only the http port
-## reaches client configs; the ws port is server↔plugin, hence the wording.
-## The per-client reconfigure steps live behind the crash panel's docs link.
-static func _free_port_hint(port: int) -> String:
-	var free_http := ClientConfigurator.suggest_free_port(port + 1)
-	var free_ws := ClientConfigurator.suggest_free_port(ClientConfigurator.ws_port() + 1)
-	return "Ports %d (HTTP) and %d (WS) are free — set `godot_ai/http_port` and `godot_ai/ws_port` in Editor Settings, then update your client config with the new HTTP port (How to change the port, below)." % [free_http, free_ws]
-
-
-## URL for the port-conflict guide, pinned to the release tag that matches the
-## installed plugin version (releases are tagged `v<version>`). The crash-panel
-## button only exists in builds that ship `docs/port-conflicts.md`, so the
-## versioned ref always resolves — and a shipped build never points users at a
-## tip-of-main guide that has drifted from its own UI.
-static func _port_conflict_docs_url() -> String:
-	var version := ClientConfigurator.get_plugin_version()
-	var git_ref := ("v%s" % version) if not version.is_empty() else "main"
-	return "%s/%s/%s" % [REPO_BLOB_BASE, git_ref, PORT_CONFLICT_DOCS_PATH]
-
-
 ## Build the mixed-state banner. Hidden until `_refresh_mixed_state_banner`
 ## confirms `*.update_backup` files exist in the addons tree. Mirrors the
 ## issue #354 fix shape: structured, agent-readable diagnostic that survives
@@ -1632,30 +1480,6 @@ func _update_dev_section_buttons() -> void:
 		_dev_stop_btn.tooltip_text = stop_state["tooltip"]
 
 
-func _configured_client_count() -> int:
-	var configured := 0
-	for client_id in _client_rows:
-		var status: Client.Status = _client_rows[client_id].get("status", Client.Status.NOT_CONFIGURED)
-		if status == Client.Status.CONFIGURED:
-			configured += 1
-	return configured
-
-
-func _client_status_refresh_has_completed() -> bool:
-	return _last_client_status_refresh_completed_msec > 0
-
-
-func _connected_status_text() -> String:
-	var configured := _configured_client_count()
-	if configured == 0:
-		if not _client_status_refresh_has_completed():
-			return "Server connected · checking AI client configuration"
-		return "Server connected · no AI client configured"
-	if configured == 1:
-		return "Server connected · 1 AI client configured"
-	return "Server connected · %d AI clients configured" % configured
-
-
 func _on_install_uv() -> void:
 	match OS.get_name():
 		"Windows":
@@ -1724,65 +1548,28 @@ func _dispatch_client_action(client_id: String, action: String) -> void:
 	_client_action_generations[client_id] = generation
 	var thread := Thread.new()
 	_client_action_threads[client_id] = thread
-	_client_action_started_msec[client_id] = Time.get_ticks_msec()
-	_client_action_names[client_id] = action
 	var err := thread.start(
 		Callable(self, "_run_client_action_worker").bind(client_id, action, server_url, generation)
 	)
 	if err != OK:
 		_client_action_threads.erase(client_id)
-		_client_action_started_msec.erase(client_id)
-		_client_action_names.erase(client_id)
 		_finalize_action_buttons(client_id)
 		_apply_row_status(client_id, Client.Status.ERROR, "couldn't start worker thread")
 		_refresh_clients_summary()
 
 
-func _run_client_action_worker(client_id: String, action: String, server_url: String, generation: int) -> Dictionary:
+func _run_client_action_worker(client_id: String, action: String, server_url: String, generation: int) -> void:
 	var result: Dictionary
 	if action == "remove":
 		result = ClientConfigurator.remove(client_id, server_url)
 	else:
 		result = ClientConfigurator.configure(client_id, server_url)
-	return {
+	if _refresh_state != ClientRefreshStateScript.SHUTTING_DOWN:
-		"client_id": client_id,
+		call_deferred("_apply_client_action_result", client_id, action, result, generation)
-		"action": action,
-		"result": result,
-		"generation": generation,
-	}
-
-
-func _poll_completed_client_action_threads() -> void:
-	for client_id in _client_action_threads.keys():
-		var thread: Thread = _client_action_threads[client_id]
-		if thread == null or thread.is_alive():
-			continue
-		var payload: Variant = thread.wait_to_finish()
-		_client_action_threads[client_id] = null
-		if payload is Dictionary:
-			var data := payload as Dictionary
-			var result: Dictionary = data.get("result", {})
-			_apply_client_action_result(
-				String(data.get("client_id", client_id)),
-				String(data.get("action", _client_action_names.get(client_id, "configure"))),
-				result,
-				int(data.get("generation", _client_action_generations.get(client_id, 0)))
-			)
-		else:
-			_apply_client_action_result(
-				String(client_id),
-				String(_client_action_names.get(client_id, "configure")),
-				{"status": "error", "message": "worker returned no result"},
-				int(_client_action_generations.get(client_id, 0))
-			)
 
 
 func _apply_client_action_result(client_id: String, action: String, result: Dictionary, generation: int) -> void:
 	if int(_client_action_generations.get(client_id, 0)) != generation:
-		if _client_action_threads.get(client_id, null) == null:
-			_client_action_threads.erase(client_id)
-			_client_action_started_msec.erase(client_id)
-			_client_action_names.erase(client_id)
 		return
 	if _refresh_state == ClientRefreshStateScript.SHUTTING_DOWN:
 		return
@@ -1790,9 +1577,7 @@ func _apply_client_action_result(client_id: String, action: String, result: Dict
 		var t: Thread = _client_action_threads[client_id]
 		if t != null:
 			t.wait_to_finish()
-	_client_action_threads.erase(client_id)
+		_client_action_threads.erase(client_id)
-	_client_action_started_msec.erase(client_id)
-	_client_action_names.erase(client_id)
 	_finalize_action_buttons(client_id)
 	if _server_blocks_client_health():
 		_apply_row_status(client_id, Client.Status.ERROR, _server_blocked_client_message())
@@ -1860,7 +1645,7 @@ func _on_configure_all_clients() -> void:
 			_apply_row_status(String(client_id), Client.Status.ERROR, _server_blocked_client_message())
 		_refresh_clients_summary()
 		return
-	if ClientRefreshStateScript.should_disable_client_actions(_refresh_state):
+	if ClientRefreshStateScript.has_worker_alive(_refresh_state):
 		return
 	for client_id in _client_rows:
 		var status: Client.Status = _client_rows[client_id].get("status", Client.Status.NOT_CONFIGURED)
@@ -1915,7 +1700,7 @@ func _build_tools_tab(tabs: TabContainer) -> void:
 	var tools_tab := VBoxContainer.new()
 	tools_tab.add_theme_constant_override("separation", 8)
 	var tools_margin := _build_margin_container()
-	tools_margin.name = "Tools"
+	tools_margin.name = "Settings"
 	tools_margin.add_child(tools_tab)
 	tabs.add_child(tools_margin)
 
@@ -2191,11 +1976,8 @@ func _refresh_clients_summary() -> void:
 		)
 	_clients_summary_label.text = text
 	if _client_configure_all_btn != null:
-		_client_configure_all_btn.disabled = ClientRefreshStateScript.should_disable_client_actions(_refresh_state)
+		_client_configure_all_btn.disabled = ClientRefreshStateScript.has_worker_alive(_refresh_state)
-	if _client_empty_cta_btn != null:
-		_client_empty_cta_btn.visible = configured == 0 and _client_status_refresh_has_completed()
 	_refresh_drift_banner(mismatched_ids)
-	_update_status()
 
 
 func _show_manual_command_for(client_id: String) -> void:
@@ -2385,8 +2167,8 @@ func _warm_strategy_bytecode() -> void:
 
 func _begin_client_status_refresh_run() -> int:
 	## Marks a refresh as starting and returns the new generation token.
-	## Generation is bumped here (not at completion) so that a worker result
+	## Generation is bumped here (not at completion) so that a worker callback
-	## reaped after `_abandon_client_status_refresh_thread` or `_exit_tree`
+	## arriving after `_abandon_client_status_refresh_thread` or `_exit_tree`
 	## fires can be detected as stale via generation mismatch.
 	_refresh_state = ClientRefreshStateScript.RUNNING
 	_client_status_refresh_pending = false
@@ -2399,7 +2181,7 @@ func _begin_client_status_refresh_run() -> int:
 
 func _finalize_completed_refresh() -> void:
 	## Stamps cooldown and clears in-flight state. Called at the end of every
-	## refresh that successfully applied results — the worker reaping path
+	## refresh that successfully applied results — the worker callback path
 	## and the no-CLI fast path in `_perform_initial_client_status_refresh`.
 	_last_client_status_refresh_completed_msec = Time.get_ticks_msec()
 	if _refresh_state != ClientRefreshStateScript.SHUTTING_DOWN:
@@ -2526,7 +2308,7 @@ func _retry_deferred_client_status_refresh() -> void:
 		_request_client_status_refresh(force)
 
 
-func _run_client_status_refresh_worker(client_probes: Array[Dictionary], server_url: String, generation: int) -> Dictionary:
+func _run_client_status_refresh_worker(client_probes: Array[Dictionary], server_url: String, generation: int) -> void:
 	var results: Dictionary = {}
 	for probe in client_probes:
 		var client_id := String(probe.get("id", ""))
@@ -2543,25 +2325,8 @@ func _run_client_status_refresh_worker(client_probes: Array[Dictionary], server_
 			"installed": installed,
 			"error_msg": details.get("error_msg", ""),
 		}
-	return {"results": results, "generation": generation}
+	if _refresh_state != ClientRefreshStateScript.SHUTTING_DOWN:
-
+		call_deferred("_apply_client_status_refresh_results", results, generation)
-
-func _poll_completed_client_status_refresh_thread() -> void:
-	if _client_status_refresh_thread == null:
-		return
-	if _client_status_refresh_thread.is_alive():
-		return
-	var payload: Variant = _client_status_refresh_thread.wait_to_finish()
-	_client_status_refresh_thread = null
-	if payload is Dictionary:
-		var data := payload as Dictionary
-		var results: Dictionary = data.get("results", {})
-		_apply_client_status_refresh_results(
-			results,
-			int(data.get("generation", _client_status_refresh_generation))
-		)
-	else:
-		_apply_client_status_refresh_results({}, _client_status_refresh_generation)
 
 
 func _apply_client_status_refresh_results(results: Dictionary, generation: int) -> void:

addons/godot_ai/plugin.cfg

@@ -3,5 +3,5 @@
 name="Godot AI"
 description="MCP server and AI tools for Godot"
 author="Godot AI"
-version="2.8.1"
+version="2.7.6"
 script="plugin.gd"

addons/godot_ai/plugin.gd

@@ -233,14 +233,14 @@ func _enter_tree() -> void:
 
 	_telemetry = Telemetry.new(_connection)
 
-	_debugger_plugin = DebuggerPlugin.new(_log_buffer, _game_log_buffer, _editor_log_buffer)
+	_debugger_plugin = DebuggerPlugin.new(_log_buffer, _game_log_buffer)
 	add_debugger_plugin(_debugger_plugin)
 	_ensure_game_helper_autoload()
 
 	var editor_handler := EditorHandler.new(_log_buffer, _connection, _debugger_plugin, _game_log_buffer, _editor_log_buffer)
 	var scene_handler := SceneHandler.new(_connection)
 	var node_handler := NodeHandler.new(get_undo_redo())
-	var project_handler := ProjectHandler.new(_connection, _debugger_plugin, _editor_log_buffer)
+	var project_handler := ProjectHandler.new(_connection, _debugger_plugin)
 	var client_handler := ClientHandler.new()
 	var script_handler := ScriptHandler.new(get_undo_redo(), _connection)
 	var resource_handler := ResourceHandler.new(get_undo_redo(), _connection)

addons/godot_ai/runtime/loggers/game_logger.gd

@@ -81,9 +81,9 @@ func _log_error(
 		## Collect every function name in the first non-empty backtrace so
 		## game_helper can match its eval's uniquely named wrapper function.
 		var funcs := PackedStringArray()
-		for bt: RefCounted in script_backtraces:
+		for bt in script_backtraces:
 			if bt != null and bt.get_frame_count() > 0:
-				for i: int in bt.get_frame_count():
+				for i in bt.get_frame_count():
 					funcs.append(bt.get_frame_function(i))
 				break
 		_mutex.lock()

addons/godot_ai/utils/game_log_buffer.gd

@@ -6,8 +6,9 @@ extends McpStructuredLogRing
 ## ferried back from the playing game over the EngineDebugger channel.
 ##
 ## Larger cap than McpEditorLogBuffer because games can be noisy. `run_id`
-## rotates at play-start, giving agents a stable cursor for "lines from
+## rotates each time clear_for_new_run() fires (called on the game's
-## this run" even when the game never reaches the mcp:hello boot beacon.
+## mcp:hello boot beacon), giving agents a stable cursor for "lines since
+## this play started".
 ##
 ## Single-threaded — game_helper.gd drains its logger from `_process` and
 ## calls `append` from the main thread, so this subclass can use the base
@@ -16,7 +17,6 @@ extends McpStructuredLogRing
 const MAX_LINES := 2000
 
 var _run_id := ""
-var _run_seq := 0
 
 
 func _init() -> void:
@@ -24,22 +24,17 @@ func _init() -> void:
 
 
 func append(level: String, text: String, details: Dictionary = {}) -> void:
-	var entry := {
+	var entry := {"source": "game", "level": _coerce_level(level), "text": text}
-		"source": "game",
-		"level": _coerce_level(level),
-		"text": text,
-		"run_id": _run_id,
-	}
 	if not details.is_empty():
 		entry["details"] = details.duplicate(true)
 	_append_entry(entry)
 
 
-## Rotate the run identifier without dropping buffered entries. Called at
+## Rotate the run identifier and drop all buffered entries. Called when the
-## play-start so even no-hello parse failures get a fresh current-run identity.
+## game-side autoload sends its mcp:hello beacon, marking a fresh play cycle.
-## Historical lines stay tagged with their original run_id and can still be
+## Returns the new run_id.
-## queried explicitly.
 func clear_for_new_run() -> String:
+	_clear_storage()
 	_run_id = _generate_run_id()
 	return _run_id
 
@@ -48,38 +43,8 @@ func run_id() -> String:
 	return _run_id
 
 
-func get_run_range(run_id: String, offset: int, count: int) -> Array[Dictionary]:
+static func _generate_run_id() -> String:
-	return get_run_page(run_id, offset, count).entries
-
-
-func run_total_count(run_id: String) -> int:
-	return int(get_run_page(run_id, 0, 0).total_count)
-
-
-func get_run_page(run_id: String, offset: int, count: int) -> Dictionary:
-	var entries := _entries_for_run(run_id)
-	var start := mini(maxi(0, offset), entries.size())
-	var stop := mini(entries.size(), start + maxi(0, count))
-	var out: Array[Dictionary] = []
-	for i in range(start, stop):
-		out.append(entries[i])
-	return {
-		"entries": out,
-		"total_count": entries.size(),
-	}
-
-
-func _entries_for_run(run_id: String) -> Array[Dictionary]:
-	var out: Array[Dictionary] = []
-	for entry in get_range(0, total_count()):
-		if str(entry.get("run_id", "")) == run_id:
-			out.append(entry)
-	return out
-
-
-func _generate_run_id() -> String:
 	## Opaque to agents — they only check equality. Time-based is plenty
-	## unique within a single editor session; the local sequence protects
+	## unique within a single editor session and avoids the RNG-seed
-	## fast back-to-back test runs within the same millisecond.
+	## reproducibility footgun.
-	_run_seq += 1
+	return "r%d" % Time.get_ticks_msec()
-	return "r%d-%d" % [Time.get_ticks_msec(), _run_seq]

addons/godot_ai/utils/mcp_client_refresh_state.gd

@@ -57,14 +57,6 @@ static func has_worker_alive(state: int) -> bool:
 	return state == RUNNING or state == RUNNING_TIMED_OUT
 
 
-## True while the status worker is still within its healthy budget. Once a
-## refresh has timed out, the dock keeps the warning badge but must let users
-## retry Configure / Configure all instead of stranding the controls behind an
-## orphaned, uninterruptible worker.
-static func should_disable_client_actions(state: int) -> bool:
-	return state == RUNNING
-
-
 ## True when the dock should reject new refresh spawns. Used by the
 ## focus-in / manual button / cooldown-timer entrypoints.
 static func is_blocked_for_spawn(state: int) -> bool:

addons/godot_ai/utils/server_lifecycle.gd

@@ -300,15 +300,6 @@ func _set_incompatible_server(live: Dictionary, expected_version: String, port:
 	var proof_name := str(proof.get("proof", ""))
 	_can_recover_incompatible = not proof_name.is_empty()
 	print("MCP | proof: %s" % (proof_name if _can_recover_incompatible else "(none)"))
-	if not _can_recover_incompatible:
-		## Non-recoverable: a foreign / unprovable occupant holds the port and
-		## we have no ownership proof, so we must NOT kill it — surface a
-		## concrete free port the user can switch to instead (the same hint
-		## the dock crash body renders). Logging it to the editor output also
-		## lets `ci-stale-server-smoke --mode foreign` assert this upstream
-		## classification from CI. Reservation-aware on Windows.
-		var suggested := ClientConfigurator.suggest_free_port(port + 1)
-		print("MCP | port %d occupant not recoverable (no ownership proof); suggested free port %d (set godot_ai/http_port)" % [port, suggested])
 	_host._refresh_dock_client_statuses()
 
 

addons/godot_ai/utils/update_manager.gd

@@ -314,8 +314,6 @@ static func _is_trusted_download_url(url: String) -> bool:
 	const SCHEME := "https://"
 	if not url.begins_with(SCHEME):
 		return false
-	if url.find("\\") >= 0:
-		return false
 	var rest := url.substr(SCHEME.length())
 	var authority := rest
 	var slash := rest.find("/")
@@ -459,7 +457,7 @@ func _on_checksum_completed(
 
 	print("MCP | self-update checksum verified (sha256 %s)" % actual)
 	install_state_changed.emit({"button_text": "Installing..."})
-	_install_zip.call_deferred()
+	_install_zip()
 
 
 ## Surface an integrity-check failure and drop the staged zip so the bad
@@ -485,9 +483,8 @@ static func _parse_sha256_digest(text: String) -> String:
 	if trimmed.is_empty():
 		return ""
 	## First whitespace-delimited token; `sha256sum` separates digest and
-	## filename with two spaces, but some tools use tabs.
+	## filename with two spaces, so allow_empty=false collapses the run.
-	var normalized := trimmed.replace("\t", " ").replace("\n", " ").replace("\r", " ")
+	var tokens := trimmed.split(" ", false)
-	var tokens := normalized.split(" ", false)
 	if tokens.is_empty():
 		return ""
 	var digest := String(tokens[0]).strip_edges().to_lower()

assets/characters/Bob.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Bob.glb-b36d843833d2bf8fe73ce6b24284a2e6.scn"
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -50,3 +52,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/Gatot.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Gatot.glb-7ed2e6cfe1354f044d634ce57f159a9a.sc
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -50,3 +52,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/Masbro.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Masbro.glb-c019c78827ce632933ba37f4b2937305.s
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -50,3 +52,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/Oldpop.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Oldpop.glb-c0496f43d11bd79e0865e1e20da606da.s
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -50,3 +52,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/animation-0.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/animation-0.glb-c294d3c96ec1222f9f04a65d47868
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -46,3 +48,4 @@ _subresources={
 }
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/animation.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/animation.glb-d28e509f062b0ed9227a1d97e8075ed
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=0
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/mektons/mekton_bull.glb.import

@@ -1,42 +0,0 @@
-[remap]
-
-importer="scene"
-importer_version=1
-type="PackedScene"
-uid="uid://dsi2vtxfvqdm7"
-path="res://.godot/imported/mekton_bull.glb-55daae491fc640a3c58139492aec6bb6.scn"
-
-[deps]
-
-source_file="res://assets/characters/mektons/mekton_bull.glb"
-dest_files=["res://.godot/imported/mekton_bull.glb-55daae491fc640a3c58139492aec6bb6.scn"]
-
-[params]
-
-nodes/root_type=""
-nodes/root_name=""
-nodes/root_script=null
-nodes/apply_root_scale=true
-nodes/root_scale=1.0
-nodes/import_as_skeleton_bones=false
-nodes/use_name_suffixes=true
-nodes/use_node_type_suffixes=true
-meshes/ensure_tangents=true
-meshes/generate_lods=true
-meshes/create_shadow_meshes=true
-meshes/light_baking=1
-meshes/lightmap_texel_size=0.2
-meshes/force_disable_compression=false
-skins/use_named_skins=true
-animation/import=true
-animation/fps=30
-animation/trimming=false
-animation/remove_immutable_tracks=true
-animation/import_rest_as_RESET=false
-import_script/path=""
-materials/extract=0
-materials/extract_format=0
-materials/extract_path=""
-_subresources={}
-gltf/naming_version=2
-gltf/embedded_image_handling=1

assets/characters/mektons/mekton_bull_texture_pbr_20250901.png.import

@@ -1,45 +0,0 @@
-[remap]
-
-importer="texture"
-type="CompressedTexture2D"
-uid="uid://c5nsxhrn7kgln"
-path.s3tc="res://.godot/imported/mekton_bull_texture_pbr_20250901.png-97dcb0c09da703b22c3ddc99680d3a89.s3tc.ctex"
-path.etc2="res://.godot/imported/mekton_bull_texture_pbr_20250901.png-97dcb0c09da703b22c3ddc99680d3a89.etc2.ctex"
-metadata={
-"imported_formats": ["s3tc_bptc", "etc2_astc"],
-"vram_texture": true
-}
-generator_parameters={
-"md5": "74daccd2f257ba6ddc877d0e3112b374"
-}
-
-[deps]
-
-source_file="res://assets/characters/mektons/mekton_bull_texture_pbr_20250901.png"
-dest_files=["res://.godot/imported/mekton_bull_texture_pbr_20250901.png-97dcb0c09da703b22c3ddc99680d3a89.s3tc.ctex", "res://.godot/imported/mekton_bull_texture_pbr_20250901.png-97dcb0c09da703b22c3ddc99680d3a89.etc2.ctex"]
-
-[params]
-
-compress/mode=2
-compress/high_quality=false
-compress/lossy_quality=0.7
-compress/uastc_level=0
-compress/rdo_quality_loss=0.0
-compress/hdr_compression=1
-compress/normal_map=0
-compress/channel_pack=0
-mipmaps/generate=true
-mipmaps/limit=-1
-roughness/mode=0
-roughness/src_normal=""
-process/channel_remap/red=0
-process/channel_remap/green=1
-process/channel_remap/blue=2
-process/channel_remap/alpha=3
-process/fix_alpha_border=true
-process/premult_alpha=false
-process/normal_map_invert_y=false
-process/hdr_as_srgb=false
-process/hdr_clamp_exposure=false
-process/size_limit=0
-detect_3d/compress_to=0

assets/characters/mektons/mekton_bull_texture_pbr_20250901_metallic-texture_pbr_20250901_roughness.png.import

@@ -1,45 +0,0 @@
-[remap]
-
-importer="texture"
-type="CompressedTexture2D"
-uid="uid://ctf5kpns0edj8"
-path.s3tc="res://.godot/imported/mekton_bull_texture_pbr_20250901_metallic-texture_pbr_20250901_roughness.png-62ac095e69dd6ffb8b3cae70302b88e6.s3tc.ctex"
-path.etc2="res://.godot/imported/mekton_bull_texture_pbr_20250901_metallic-texture_pbr_20250901_roughness.png-62ac095e69dd6ffb8b3cae70302b88e6.etc2.ctex"
-metadata={
-"imported_formats": ["s3tc_bptc", "etc2_astc"],
-"vram_texture": true
-}
-generator_parameters={
-"md5": "30794e134a9d90aee14b4cd127e9d1cb"
-}
-
-[deps]
-
-source_file="res://assets/characters/mektons/mekton_bull_texture_pbr_20250901_metallic-texture_pbr_20250901_roughness.png"
-dest_files=["res://.godot/imported/mekton_bull_texture_pbr_20250901_metallic-texture_pbr_20250901_roughness.png-62ac095e69dd6ffb8b3cae70302b88e6.s3tc.ctex", "res://.godot/imported/mekton_bull_texture_pbr_20250901_metallic-texture_pbr_20250901_roughness.png-62ac095e69dd6ffb8b3cae70302b88e6.etc2.ctex"]
-
-[params]
-
-compress/mode=2
-compress/high_quality=false
-compress/lossy_quality=0.7
-compress/uastc_level=0
-compress/rdo_quality_loss=0.0
-compress/hdr_compression=1
-compress/normal_map=0
-compress/channel_pack=0
-mipmaps/generate=true
-mipmaps/limit=-1
-roughness/mode=0
-roughness/src_normal=""
-process/channel_remap/red=0
-process/channel_remap/green=1
-process/channel_remap/blue=2
-process/channel_remap/alpha=3
-process/fix_alpha_border=true
-process/premult_alpha=false
-process/normal_map_invert_y=false
-process/hdr_as_srgb=false
-process/hdr_clamp_exposure=false
-process/size_limit=0
-detect_3d/compress_to=0

assets/characters/mektons/mekton_bull_texture_pbr_20250901_normal.png.import

@@ -1,45 +0,0 @@
-[remap]
-
-importer="texture"
-type="CompressedTexture2D"
-uid="uid://2f4nyuypxmfl"
-path.s3tc="res://.godot/imported/mekton_bull_texture_pbr_20250901_normal.png-9d20462c1c392e7ca3ebdf37e3bf1c72.s3tc.ctex"
-path.etc2="res://.godot/imported/mekton_bull_texture_pbr_20250901_normal.png-9d20462c1c392e7ca3ebdf37e3bf1c72.etc2.ctex"
-metadata={
-"imported_formats": ["s3tc_bptc", "etc2_astc"],
-"vram_texture": true
-}
-generator_parameters={
-"md5": "a8a4c3a73bd7e809157f8fc65b8872c9"
-}
-
-[deps]
-
-source_file="res://assets/characters/mektons/mekton_bull_texture_pbr_20250901_normal.png"
-dest_files=["res://.godot/imported/mekton_bull_texture_pbr_20250901_normal.png-9d20462c1c392e7ca3ebdf37e3bf1c72.s3tc.ctex", "res://.godot/imported/mekton_bull_texture_pbr_20250901_normal.png-9d20462c1c392e7ca3ebdf37e3bf1c72.etc2.ctex"]
-
-[params]
-
-compress/mode=2
-compress/high_quality=false
-compress/lossy_quality=0.7
-compress/uastc_level=0
-compress/rdo_quality_loss=0.0
-compress/hdr_compression=1
-compress/normal_map=1
-compress/channel_pack=0
-mipmaps/generate=true
-mipmaps/limit=-1
-roughness/mode=1
-roughness/src_normal="res://assets/characters/mektons/mekton_bull_texture_pbr_20250901_normal.png"
-process/channel_remap/red=0
-process/channel_remap/green=1
-process/channel_remap/blue=2
-process/channel_remap/alpha=3
-process/fix_alpha_border=true
-process/premult_alpha=false
-process/normal_map_invert_y=false
-process/hdr_as_srgb=false
-process/hdr_clamp_exposure=false
-process/size_limit=0
-detect_3d/compress_to=0

assets/characters/tektons/ted_mesh.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/ted_mesh.glb-3a244082b66ad864a2330884dc3cfef0
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/tektons/tekton_chuck.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tekton_chuck.glb-635c14eb795891e496e379a5e8e8
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/tektons/tekton_fishing_animation.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tekton_fishing_animation.glb-4469ef86e01e801d
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/tektons/tekton_nest.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tekton_nest.glb-36c2a8dfaddd466203be329bdc5cb
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/characters/tektons/tekton_throwing_tiles.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tekton_throwing_tiles.glb-ed040127419938b4e09
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/data/version.json

@@ -1,7 +1,34 @@
 {
-	"latest_version": "2.4.1",
+	"latest_version": "2.4.3",
 	"minimum_app_version": "2.1.0",
 	"releases": [
+		{
+			"version": "2.4.3",
+			"date": "2026-07-04",
+			"pck_url": "https://git.klud.top/danchie/tekton/raw/branch/patches/patch.pck",
+			"pck_size": 0,
+			"changelog": [
+				"Fixed multiplayer desync issue where the playerboard UI would get stuck and not refresh properly.",
+				"Fixed a bug where attacking or pushing another player would cause the smack/punch sound effect to play repeatedly.",
+				"Fixed an issue where the Gacha panel's currency balance would not update immediately after purchasing currency in the Shop.",
+				"Fixed a fatal client crash in Multiplayer Gauntlet mode caused by smack cooldown timers."
+			]
+		},
+		{
+			"version": "2.4.2",
+			"date": "2026-07-03",
+			"pck_url": "https://raw.githubusercontent.com/adtpdn/tekton-updates/main/latest/patch.pck",
+			"pck_size": 0,
+			"changelog": [
+				"Replaced Cleanser mechanic in Gauntlet with Ghost powerup sticky-bypass system.",
+				"Ghost (Invisible Mode) now lets players walk through sticky candy tiles in Gauntlet.",
+				"Players earn a Ghost powerup every 2 completed missions in Gauntlet.",
+				"Ghost powerup tiles now spawn naturally on the Gauntlet arena (15% chance).",
+				"Removed Cleanser HUD elements from Gauntlet overlay.",
+				"Bots now activate Ghost powerup when boxed in by sticky tiles.",
+				"Players pushed into sticky tiles while in Ghost mode are no longer slowed."
+			]
+		},
 		{
 			"version": "2.4.1",
 			"date": "2026-06-28",

assets/models/arena/free_mode/Terrainv2.gltf.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Terrainv2.gltf-6439acacda69bfc8b96d1611ca8f5f
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/arena/gauntlet/Gauntlet terrain.gltf.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Gauntlet terrain.gltf-2ceb7292a7914d9403e396e
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/arena/stop_n_go/Terrain.gltf.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/Terrain.gltf-c727a544f574f1f4cd0808dd390e94ae
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/character_pointer/character_pointer.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/character_pointer.glb-104658ccca94ef9661e3256
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/meshes/block.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/block.glb-fb6bc8a4474a482c37edd6c5ac8ce3c9.sc
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -52,3 +54,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/meshes/tekton/tekton.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tekton.glb-cf03c9120f9a286ceda76a1bd03efb7b.s
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/meshes/tekton/tekton_walking.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tekton_walking.glb-4042e6c5856f09fa2cc375563a
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/meshes/tile.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tile.glb-a2c57836b49962e6adb25601bd8d4a59.scn
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -52,3 +54,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/meshes/tiles_armagedon.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/tiles_armagedon.glb-f07b282b31fcdfdfd952d6096
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -123,3 +125,4 @@ _subresources={
 }
 gltf/naming_version=1
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/props/box_block.gltf.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/box_block.gltf-4e37264bb9b1903a1ad0284c855511
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/props/wall_animation.fbx.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/wall_animation.fbx-22f993a05720796858e5daa12a
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false

assets/models/props/wheat_block_0.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/wheat_block_0.glb-35fd252da9f0a42b79ed5759815
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/props/wheat_block_1.glb.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/wheat_block_1.glb-5d996ad9d4004837507f80c51b7
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/tekton_stand/stand_1.gltf.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/stand_1.gltf-361364203c5fe17f6842f22d99f7d2d8
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

assets/models/tekton_stand/stand_2.gltf.import

@@ -16,6 +16,8 @@ dest_files=["res://.godot/imported/stand_2.gltf-aa7bce8b5c8fdf784210ca33e5e3c47f
 nodes/root_type=""
 nodes/root_name=""
 nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
 nodes/apply_root_scale=true
 nodes/root_scale=1.0
 nodes/import_as_skeleton_bones=false
@@ -40,3 +42,4 @@ materials/extract_path=""
 _subresources={}
 gltf/naming_version=2
 gltf/embedded_image_handling=1
+gltf/texture_map_mode=0

docs/VERSIONING.md

@@ -1,157 +0,0 @@
-# Versioning & Artifact Storage Strategy
-
-## Version Format
-
-Tekton Armageddon uses semantic versioning: `MAJOR.MINOR.PATCH`
-
-- **MAJOR**: Breaking changes, incompatible API changes
-- **MINOR**: New features, backward-compatible
-- **PATCH**: Bug fixes, content updates, backward-compatible
-
-Current version source: `project.godot` → `config/version`
-
-## Artifact Types
-
-### 1. Patch PCK Files
-- **Purpose**: Hot-patch content updates without full client reinstall
-- **Storage**: GitHub Actions artifacts (90 days) + tekton-updates repo
-- **Naming**: `patch.pck` (latest), versioned in tekton-updates repo
-- **Integrity**: SHA256 checksums generated and stored alongside
-
-### 2. Platform Builds
-- **Platforms**: Windows, Linux, Android
-- **Storage**: GitHub Actions artifacts (90 days) + GitHub Releases (permanent)
-- **Naming**: `tekton_armageddon_{Platform}_v{VERSION}.{ext}`
-- **Trigger**: Git tags (`v*.*.*`) or manual workflow dispatch
-- **Integrity**: SHA256 checksums for each platform build
-
-### 3. Version Manifest
-- **File**: `assets/data/version.json`
-- **Purpose**: Client version checking, changelog delivery, patch URLs
-- **Storage**: Embedded in builds + tekton-updates repo
-- **Integrity**: SHA256 checksum
-
-## Workflows
-
-### Patch Deployment (`deploy_patch.yml`)
-**Trigger**: Push to `patch-release` branch or manual dispatch
-
-**Process**:
-1. Auto-bump patch version from `project.godot`
-2. Extract changelog from `CHANGELOG_DRAFT.md` [NEXT] section
-3. Generate `version.json` with new release entry
-4. Commit version bump back to repo
-5. Build `patch.pck` from changed files
-6. Generate SHA256 checksums
-7. Upload artifacts to GitHub Actions (90-day retention)
-8. Push to `tekton-updates` public repo (`latest/` folder)
-
-**Artifacts**:
-- `patch-pck-{SHA}`: patch.pck + checksum
-- `version-manifest-{SHA}`: version.json + checksum
-
-### Platform Builds (`build_artifacts.yml`)
-**Trigger**: Git tag push (`v*.*.*`) or manual dispatch with version input
-
-**Process**:
-1. Matrix build for Windows, Linux, Android
-2. Export using Godot export presets
-3. Generate SHA256 checksums per platform
-4. Upload artifacts to GitHub Actions (90-day retention)
-5. Create GitHub Release with all platform builds + checksums
-
-**Artifacts**:
-- `tekton-{Platform}-v{VERSION}`: platform binary + checksum
-
-## Artifact Retention
-
-| Artifact Type | Storage Location | Retention | Purpose |
-|--------------|------------------|-----------|---------|
-| Patch PCK | GitHub Actions | 90 days | CI/CD history, rollback |
-| Patch PCK | tekton-updates repo | Permanent | Client downloads |
-| Platform Builds | GitHub Actions | 90 days | CI/CD history |
-| Platform Builds | GitHub Releases | Permanent | Distribution |
-| Version Manifest | tekton-updates repo | Permanent | Client version checks |
-
-## Checksum Verification
-
-All artifacts include SHA256 checksums for integrity verification:
-
-```bash
-# Verify patch.pck
-sha256sum -c patch.pck.sha256
-
-# Verify platform build
-sha256sum -c tekton_armageddon_Windows_v2.3.8.sha256
-```
-
-## Version Compatibility
-
-`version.json` includes `minimum_app_version` field:
-- Clients below this version must reinstall full build
-- Clients at or above can use patch system
-
-## Changelog Management
-
-**Source**: `CHANGELOG_DRAFT.md`
-
-**Format**:
-```markdown
-## [NEXT]
-- Feature or fix description
-- Another change
-
-## [2.3.7] — 2026-05-15
-- Archived release notes
-```
-
-**Process**:
-1. Developers add entries under `[NEXT]`
-2. CI extracts `[NEXT]` entries on patch deployment
-3. CI archives to versioned section
-4. CI clears `[NEXT]` for next cycle
-
-## Manual Version Bump
-
-For local testing without CI:
-
-```bash
-# Update versions but keep changelog
-python3 tools/generate_version_json.py --local
-
-# Skip changelog update entirely
-python3 tools/generate_version_json.py --skip-changelog
-```
-
-## Release Process
-
-### Patch Release
-1. Merge changes to `patch-release` branch
-2. CI auto-bumps version, builds, deploys
-3. Clients auto-download on next launch
-
-### Full Release
-1. Tag commit: `git tag v2.4.0`
-2. Push tag: `git push origin v2.4.0`
-3. CI builds all platforms, creates GitHub Release
-4. Distribute via Steam, Google Play, etc.
-
-## Rollback Strategy
-
-**Patch Rollback**:
-1. Locate previous patch in GitHub Actions artifacts or tekton-updates repo
-2. Manually push to `tekton-updates/latest/`
-3. Update `version.json` to point to previous version
-
-**Full Build Rollback**:
-1. Download previous release from GitHub Releases
-2. Re-tag or create hotfix branch
-3. Redeploy via standard release process
-
-## Future Enhancements
-
-- [ ] Automated rollback on failed health checks
-- [ ] Delta patching for bandwidth optimization
-- [ ] Multi-region CDN distribution
-- [ ] Staged rollout (canary deployments)
-- [ ] Automated compatibility testing matrix

docs/gauntlet-technical-docs.html

@@ -1,1366 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Candy Cannon Survival — Technical Documentation</title>
-<meta name="description" content="Technical implementation documentation for the Candy Cannon Survival (Gauntlet) game mode in Tekton Dash">
-<link rel="preconnect" href="https://fonts.googleapis.com">
-<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800;900&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
-<style>
-:root {
-  --bg-primary: #0a0a0f;
-  --bg-secondary: #111118;
-  --bg-card: #16161f;
-  --bg-card-hover: #1c1c28;
-  --bg-code: #1a1a26;
-  --border: #2a2a3a;
-  --border-glow: #ff6bb5;
-  --text-primary: #e8e6f0;
-  --text-secondary: #8b89a0;
-  --text-muted: #5a586e;
-  --accent-pink: #ff6bb5;
-  --accent-pink-dim: #ff6bb540;
-  --accent-candy: #ff85c8;
-  --accent-purple: #a855f7;
-  --accent-blue: #6366f1;
-  --accent-cyan: #22d3ee;
-  --accent-green: #34d399;
-  --accent-yellow: #fbbf24;
-  --accent-orange: #fb923c;
-  --accent-red: #f87171;
-  --new-badge: #34d399;
-  --existing-badge: #6366f1;
-  --adapt-badge: #fbbf24;
-  --glass: rgba(22, 22, 31, 0.7);
-  --glass-border: rgba(255, 107, 181, 0.12);
-  --shadow-xl: 0 25px 50px -12px rgba(0,0,0,0.5);
-}
-
-* { margin: 0; padding: 0; box-sizing: border-box; }
-
-html {
-  scroll-behavior: smooth;
-  scrollbar-width: thin;
-  scrollbar-color: var(--accent-pink-dim) transparent;
-}
-
-body {
-  font-family: 'Inter', -apple-system, sans-serif;
-  background: var(--bg-primary);
-  color: var(--text-primary);
-  line-height: 1.6;
-  overflow-x: hidden;
-}
-
-/* === AMBIENT BG === */
-.ambient-bg {
-  position: fixed;
-  inset: 0;
-  z-index: 0;
-  pointer-events: none;
-  overflow: hidden;
-}
-.ambient-bg .orb {
-  position: absolute;
-  border-radius: 50%;
-  filter: blur(120px);
-  opacity: 0.15;
-  animation: orbFloat 20s ease-in-out infinite;
-}
-.ambient-bg .orb:nth-child(1) {
-  width: 600px; height: 600px;
-  background: var(--accent-pink);
-  top: -200px; left: -100px;
-  animation-delay: 0s;
-}
-.ambient-bg .orb:nth-child(2) {
-  width: 500px; height: 500px;
-  background: var(--accent-purple);
-  bottom: -150px; right: -100px;
-  animation-delay: -7s;
-}
-.ambient-bg .orb:nth-child(3) {
-  width: 400px; height: 400px;
-  background: var(--accent-blue);
-  top: 50%; left: 50%;
-  transform: translate(-50%, -50%);
-  animation-delay: -14s;
-}
-@keyframes orbFloat {
-  0%, 100% { transform: translate(0, 0) scale(1); }
-  25% { transform: translate(30px, -40px) scale(1.05); }
-  50% { transform: translate(-20px, 20px) scale(0.95); }
-  75% { transform: translate(40px, 30px) scale(1.02); }
-}
-
-/* === LAYOUT === */
-.wrapper {
-  position: relative;
-  z-index: 1;
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 0 24px;
-}
-
-/* === HERO === */
-.hero {
-  padding: 80px 0 60px;
-  text-align: center;
-  position: relative;
-}
-.hero-badge {
-  display: inline-flex;
-  align-items: center;
-  gap: 8px;
-  padding: 6px 16px;
-  border-radius: 100px;
-  background: var(--accent-pink-dim);
-  border: 1px solid var(--accent-pink);
-  font-size: 12px;
-  font-weight: 600;
-  text-transform: uppercase;
-  letter-spacing: 1.5px;
-  color: var(--accent-candy);
-  margin-bottom: 24px;
-}
-.hero-badge .dot {
-  width: 6px; height: 6px;
-  border-radius: 50%;
-  background: var(--accent-pink);
-  animation: pulse 2s infinite;
-}
-@keyframes pulse {
-  0%, 100% { opacity: 1; }
-  50% { opacity: 0.3; }
-}
-.hero h1 {
-  font-size: clamp(2.5rem, 5vw, 4rem);
-  font-weight: 900;
-  letter-spacing: -0.03em;
-  line-height: 1.1;
-  background: linear-gradient(135deg, #fff 0%, var(--accent-candy) 50%, var(--accent-purple) 100%);
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-  background-clip: text;
-  margin-bottom: 16px;
-}
-.hero .subtitle {
-  font-size: 18px;
-  color: var(--text-secondary);
-  max-width: 640px;
-  margin: 0 auto 40px;
-}
-.hero-stats {
-  display: flex;
-  justify-content: center;
-  gap: 32px;
-  flex-wrap: wrap;
-}
-.hero-stat {
-  text-align: center;
-}
-.hero-stat .value {
-  font-size: 2rem;
-  font-weight: 800;
-  color: var(--accent-candy);
-}
-.hero-stat .label {
-  font-size: 12px;
-  color: var(--text-muted);
-  text-transform: uppercase;
-  letter-spacing: 1px;
-}
-
-/* === NAV === */
-.sticky-nav {
-  position: sticky;
-  top: 0;
-  z-index: 100;
-  backdrop-filter: blur(20px);
-  -webkit-backdrop-filter: blur(20px);
-  background: rgba(10,10,15,0.85);
-  border-bottom: 1px solid var(--border);
-  padding: 0;
-  margin-bottom: 48px;
-}
-.nav-inner {
-  display: flex;
-  gap: 4px;
-  padding: 8px 0;
-  overflow-x: auto;
-  scrollbar-width: none;
-}
-.nav-inner::-webkit-scrollbar { display: none; }
-.nav-link {
-  padding: 8px 16px;
-  border-radius: 8px;
-  font-size: 13px;
-  font-weight: 500;
-  color: var(--text-secondary);
-  text-decoration: none;
-  white-space: nowrap;
-  transition: all 0.2s;
-}
-.nav-link:hover, .nav-link.active {
-  background: var(--accent-pink-dim);
-  color: var(--accent-candy);
-}
-
-/* === SECTIONS === */
-section {
-  margin-bottom: 64px;
-}
-.section-header {
-  margin-bottom: 32px;
-}
-.section-header h2 {
-  font-size: 1.75rem;
-  font-weight: 800;
-  letter-spacing: -0.02em;
-  display: flex;
-  align-items: center;
-  gap: 12px;
-}
-.section-header h2 .icon {
-  width: 36px; height: 36px;
-  display: flex; align-items: center; justify-content: center;
-  border-radius: 10px;
-  font-size: 18px;
-}
-.section-header p {
-  color: var(--text-secondary);
-  margin-top: 8px;
-  max-width: 700px;
-}
-
-/* === CARDS === */
-.card {
-  background: var(--bg-card);
-  border: 1px solid var(--border);
-  border-radius: 16px;
-  padding: 24px;
-  transition: all 0.3s;
-}
-.card:hover {
-  border-color: var(--glass-border);
-  background: var(--bg-card-hover);
-  box-shadow: 0 0 30px var(--accent-pink-dim);
-}
-
-/* === GLOSSARY === */
-.glossary-grid {
-  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(360px, 1fr));
-  gap: 16px;
-}
-.glossary-item {
-  background: var(--bg-card);
-  border: 1px solid var(--border);
-  border-radius: 14px;
-  padding: 20px;
-  display: flex;
-  gap: 16px;
-  transition: all 0.3s;
-  position: relative;
-  overflow: hidden;
-}
-.glossary-item::before {
-  content: '';
-  position: absolute;
-  top: 0; left: 0;
-  width: 4px; height: 100%;
-  border-radius: 4px 0 0 4px;
-}
-.glossary-item.new::before { background: var(--new-badge); }
-.glossary-item.adapt::before { background: var(--adapt-badge); }
-.glossary-item.existing::before { background: var(--existing-badge); }
-
-.glossary-item:hover {
-  border-color: var(--glass-border);
-  transform: translateY(-2px);
-  box-shadow: 0 8px 30px rgba(0,0,0,0.3);
-}
-.glossary-icon {
-  width: 44px; height: 44px;
-  min-width: 44px;
-  border-radius: 12px;
-  display: flex; align-items: center; justify-content: center;
-  font-size: 20px;
-}
-.glossary-item.new .glossary-icon { background: rgba(52,211,153,0.12); }
-.glossary-item.adapt .glossary-icon { background: rgba(251,191,36,0.12); }
-.glossary-item.existing .glossary-icon { background: rgba(99,102,241,0.12); }
-
-.glossary-content h3 {
-  font-size: 15px;
-  font-weight: 700;
-  margin-bottom: 4px;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  flex-wrap: wrap;
-}
-.glossary-content p {
-  font-size: 13px;
-  color: var(--text-secondary);
-  line-height: 1.5;
-}
-.glossary-content .code-ref {
-  font-family: 'JetBrains Mono', monospace;
-  font-size: 11px;
-  color: var(--accent-cyan);
-  background: rgba(34,211,238,0.08);
-  padding: 2px 8px;
-  border-radius: 4px;
-  margin-top: 6px;
-  display: inline-block;
-}
-
-/* === BADGES === */
-.badge {
-  display: inline-flex;
-  align-items: center;
-  padding: 2px 10px;
-  border-radius: 100px;
-  font-size: 10px;
-  font-weight: 700;
-  text-transform: uppercase;
-  letter-spacing: 0.8px;
-}
-.badge-new { background: rgba(52,211,153,0.15); color: var(--new-badge); }
-.badge-adapt { background: rgba(251,191,36,0.15); color: var(--adapt-badge); }
-.badge-existing { background: rgba(99,102,241,0.15); color: var(--existing-badge); }
-
-/* === LEGEND === */
-.legend {
-  display: flex;
-  gap: 20px;
-  flex-wrap: wrap;
-  margin-bottom: 24px;
-  padding: 16px 20px;
-  background: var(--bg-secondary);
-  border-radius: 12px;
-  border: 1px solid var(--border);
-}
-.legend-item {
-  display: flex; align-items: center; gap: 8px;
-  font-size: 13px; color: var(--text-secondary);
-}
-.legend-dot {
-  width: 10px; height: 10px;
-  border-radius: 3px;
-}
-.legend-dot.new { background: var(--new-badge); }
-.legend-dot.adapt { background: var(--adapt-badge); }
-.legend-dot.existing { background: var(--existing-badge); }
-
-/* === ARCHITECTURE DIAGRAM === */
-.arch-diagram {
-  background: var(--bg-code);
-  border: 1px solid var(--border);
-  border-radius: 16px;
-  padding: 32px;
-  overflow-x: auto;
-}
-.arch-tree {
-  font-family: 'JetBrains Mono', monospace;
-  font-size: 13px;
-  line-height: 2;
-}
-.arch-tree .node { color: var(--accent-cyan); font-weight: 600; }
-.arch-tree .new-node { color: var(--accent-green); font-weight: 600; }
-.arch-tree .label { color: var(--text-muted); }
-.arch-tree .connector { color: var(--text-muted); }
-.arch-tree .tag-new {
-  font-size: 10px;
-  background: rgba(52,211,153,0.15);
-  color: var(--new-badge);
-  padding: 1px 6px;
-  border-radius: 4px;
-  margin-left: 4px;
-  font-weight: 700;
-}
-
-/* === TABLES === */
-.table-wrap {
-  overflow-x: auto;
-  border-radius: 14px;
-  border: 1px solid var(--border);
-}
-table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: 13px;
-}
-thead th {
-  background: var(--bg-secondary);
-  padding: 14px 16px;
-  text-align: left;
-  font-size: 11px;
-  font-weight: 700;
-  text-transform: uppercase;
-  letter-spacing: 1px;
-  color: var(--text-muted);
-  border-bottom: 1px solid var(--border);
-  white-space: nowrap;
-}
-tbody td {
-  padding: 12px 16px;
-  border-bottom: 1px solid rgba(42,42,58,0.5);
-  vertical-align: top;
-}
-tbody tr:last-child td { border-bottom: none; }
-tbody tr:hover { background: rgba(255,107,181,0.03); }
-tbody td:first-child { font-weight: 600; }
-.td-code {
-  font-family: 'JetBrains Mono', monospace;
-  font-size: 12px;
-  color: var(--accent-cyan);
-}
-
-/* === REUSE TABLE === */
-.reuse-direct { color: var(--accent-green); font-weight: 600; }
-.reuse-heavy { color: var(--accent-cyan); font-weight: 600; }
-.reuse-partial { color: var(--accent-yellow); font-weight: 600; }
-.reuse-adapt { color: var(--accent-orange); font-weight: 600; }
-.reuse-pattern { color: var(--accent-purple); font-weight: 600; }
-
-/* === PHASE TIMELINE === */
-.timeline {
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 16px;
-}
-@media (max-width: 768px) { .timeline { grid-template-columns: 1fr; } }
-.phase-card {
-  background: var(--bg-card);
-  border: 1px solid var(--border);
-  border-radius: 16px;
-  padding: 24px;
-  position: relative;
-  overflow: hidden;
-}
-.phase-card::after {
-  content: '';
-  position: absolute;
-  top: 0; left: 0; right: 0;
-  height: 3px;
-}
-.phase-card.phase-1::after { background: linear-gradient(90deg, var(--accent-green), var(--accent-cyan)); }
-.phase-card.phase-2::after { background: linear-gradient(90deg, var(--accent-yellow), var(--accent-orange)); }
-.phase-card.phase-3::after { background: linear-gradient(90deg, var(--accent-orange), var(--accent-red)); }
-
-.phase-time {
-  font-size: 11px;
-  font-weight: 700;
-  color: var(--text-muted);
-  text-transform: uppercase;
-  letter-spacing: 1px;
-  margin-bottom: 8px;
-}
-.phase-card h3 {
-  font-size: 18px;
-  font-weight: 800;
-  margin-bottom: 12px;
-}
-.phase-card ul {
-  list-style: none;
-  padding: 0;
-}
-.phase-card li {
-  font-size: 13px;
-  color: var(--text-secondary);
-  padding: 4px 0;
-  padding-left: 16px;
-  position: relative;
-}
-.phase-card li::before {
-  content: '›';
-  position: absolute;
-  left: 0;
-  color: var(--accent-pink);
-  font-weight: 700;
-}
-
-/* === FILE LISTS === */
-.file-grid {
-  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
-  gap: 12px;
-}
-.file-card {
-  background: var(--bg-card);
-  border: 1px solid var(--border);
-  border-radius: 12px;
-  padding: 16px;
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  transition: all 0.2s;
-}
-.file-card:hover {
-  border-color: var(--glass-border);
-  transform: translateY(-1px);
-}
-.file-icon {
-  width: 36px; height: 36px; min-width: 36px;
-  border-radius: 8px;
-  display: flex; align-items: center; justify-content: center;
-  font-size: 16px;
-}
-.file-card.new-file .file-icon { background: rgba(52,211,153,0.12); }
-.file-card.mod-file .file-icon { background: rgba(251,191,36,0.12); }
-.file-info h4 {
-  font-size: 13px;
-  font-weight: 600;
-  font-family: 'JetBrains Mono', monospace;
-}
-.file-info p {
-  font-size: 12px;
-  color: var(--text-muted);
-}
-
-/* === CODE BLOCKS === */
-.code-block {
-  background: var(--bg-code);
-  border: 1px solid var(--border);
-  border-radius: 12px;
-  padding: 20px 24px;
-  overflow-x: auto;
-  font-family: 'JetBrains Mono', monospace;
-  font-size: 12.5px;
-  line-height: 1.8;
-}
-.code-block .kw { color: var(--accent-purple); }
-.code-block .fn { color: var(--accent-cyan); }
-.code-block .str { color: var(--accent-green); }
-.code-block .cm { color: var(--text-muted); font-style: italic; }
-.code-block .num { color: var(--accent-orange); }
-.code-block .type { color: var(--accent-yellow); }
-
-/* === RISK CARDS === */
-.risk-grid {
-  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(380px, 1fr));
-  gap: 12px;
-}
-.risk-card {
-  background: var(--bg-card);
-  border: 1px solid var(--border);
-  border-radius: 12px;
-  padding: 20px;
-  display: grid;
-  grid-template-columns: auto 1fr;
-  gap: 14px;
-}
-.risk-indicator {
-  width: 36px; height: 36px;
-  border-radius: 10px;
-  display: flex; align-items: center; justify-content: center;
-  font-size: 16px;
-  background: rgba(248,113,113,0.12);
-}
-.risk-content h4 { font-size: 14px; font-weight: 700; margin-bottom: 4px; }
-.risk-content p { font-size: 12px; color: var(--text-secondary); }
-
-/* === PRIORITY LIST === */
-.priority-list {
-  counter-reset: priority;
-}
-.priority-item {
-  display: flex;
-  gap: 16px;
-  padding: 16px 0;
-  border-bottom: 1px solid rgba(42,42,58,0.4);
-  align-items: flex-start;
-}
-.priority-item:last-child { border-bottom: none; }
-.priority-num {
-  counter-increment: priority;
-  width: 36px; height: 36px; min-width: 36px;
-  border-radius: 10px;
-  background: var(--accent-pink-dim);
-  color: var(--accent-candy);
-  display: flex; align-items: center; justify-content: center;
-  font-size: 14px;
-  font-weight: 800;
-}
-.priority-info h4 { font-size: 14px; font-weight: 700; }
-.priority-info p {
-  font-size: 12px;
-  color: var(--text-secondary);
-  font-family: 'JetBrains Mono', monospace;
-}
-
-/* === NETWORK TABLE ACCENTS === */
-.sync-method {
-  font-family: 'JetBrains Mono', monospace;
-  font-size: 11px;
-  color: var(--accent-cyan);
-}
-
-/* === FOOTER === */
-footer {
-  text-align: center;
-  padding: 48px 0;
-  border-top: 1px solid var(--border);
-  color: var(--text-muted);
-  font-size: 13px;
-}
-
-/* === SEARCH === */
-.search-bar {
-  position: relative;
-  margin-bottom: 20px;
-}
-.search-bar input {
-  width: 100%;
-  padding: 12px 16px 12px 44px;
-  background: var(--bg-secondary);
-  border: 1px solid var(--border);
-  border-radius: 12px;
-  color: var(--text-primary);
-  font-size: 14px;
-  font-family: 'Inter', sans-serif;
-  outline: none;
-  transition: border-color 0.2s;
-}
-.search-bar input:focus {
-  border-color: var(--accent-pink);
-}
-.search-bar input::placeholder {
-  color: var(--text-muted);
-}
-.search-bar .search-icon {
-  position: absolute;
-  left: 14px; top: 50%;
-  transform: translateY(-50%);
-  color: var(--text-muted);
-  font-size: 16px;
-  pointer-events: none;
-}
-
-/* === FILTER BTNS === */
-.filter-btns {
-  display: flex; gap: 8px; margin-bottom: 20px; flex-wrap: wrap;
-}
-.filter-btn {
-  padding: 6px 14px;
-  border-radius: 8px;
-  font-size: 12px;
-  font-weight: 600;
-  cursor: pointer;
-  border: 1px solid var(--border);
-  background: transparent;
-  color: var(--text-secondary);
-  transition: all 0.2s;
-}
-.filter-btn:hover, .filter-btn.active {
-  border-color: var(--accent-pink);
-  color: var(--accent-candy);
-  background: var(--accent-pink-dim);
-}
-
-/* === SCROLL TOP === */
-.scroll-top {
-  position: fixed;
-  bottom: 32px; right: 32px;
-  width: 44px; height: 44px;
-  border-radius: 12px;
-  background: var(--accent-pink);
-  color: #fff;
-  border: none;
-  cursor: pointer;
-  font-size: 18px;
-  display: none;
-  align-items: center; justify-content: center;
-  box-shadow: 0 4px 20px var(--accent-pink-dim);
-  transition: transform 0.2s;
-  z-index: 200;
-}
-.scroll-top:hover { transform: translateY(-2px); }
-.scroll-top.show { display: flex; }
-</style>
-</head>
-<body>
-
-<div class="ambient-bg">
-  <div class="orb"></div>
-  <div class="orb"></div>
-  <div class="orb"></div>
-</div>
-
-<div class="wrapper">
-
-  <!-- ============ HERO ============ -->
-  <header class="hero">
-    <div class="hero-badge"><span class="dot"></span> Technical Documentation</div>
-    <h1>Candy Cannon Survival</h1>
-    <p class="subtitle">Gauntlet Mode — Implementation blueprint mapping GDD mechanics to existing Tekton Dash systems</p>
-    <div class="hero-stats">
-      <div class="hero-stat"><div class="value">70%</div><div class="label">Code Reuse</div></div>
-      <div class="hero-stat"><div class="value">4</div><div class="label">New Files</div></div>
-      <div class="hero-stat"><div class="value">7</div><div class="label">Modified Files</div></div>
-      <div class="hero-stat"><div class="value">12</div><div class="label">New Terms</div></div>
-      <div class="hero-stat"><div class="value">10</div><div class="label">Reused Terms</div></div>
-    </div>
-  </header>
-
-  <!-- ============ NAV ============ -->
-  <div class="sticky-nav">
-    <nav class="nav-inner wrapper">
-      <a class="nav-link" href="#glossary">Glossary</a>
-      <a class="nav-link" href="#architecture">Architecture</a>
-      <a class="nav-link" href="#reuse">Reuse Map</a>
-      <a class="nav-link" href="#phases">Phases</a>
-      <a class="nav-link" href="#systems">Systems</a>
-      <a class="nav-link" href="#files">Files</a>
-      <a class="nav-link" href="#network">Network</a>
-      <a class="nav-link" href="#priority">Priority</a>
-      <a class="nav-link" href="#risks">Risks</a>
-    </nav>
-  </div>
-
-  <!-- ============ GLOSSARY ============ -->
-  <section id="glossary">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(255,107,181,0.12)">📖</span> Glossary</h2>
-      <p>All terms used in Gauntlet mode — categorized by whether they're new, adapted, or already implemented in Tekton Dash.</p>
-    </div>
-
-    <div class="legend">
-      <div class="legend-item"><div class="legend-dot new"></div> New — unique to Gauntlet</div>
-      <div class="legend-item"><div class="legend-dot adapt"></div> Adapted — modified from existing mechanic</div>
-      <div class="legend-item"><div class="legend-dot existing"></div> Existing — already in game, reused as-is</div>
-    </div>
-
-    <div class="search-bar">
-      <span class="search-icon">🔍</span>
-      <input type="text" id="glossarySearch" placeholder="Search terms..." oninput="filterGlossary()">
-    </div>
-
-    <div class="filter-btns">
-      <button class="filter-btn active" onclick="setFilter('all', this)">All</button>
-      <button class="filter-btn" onclick="setFilter('new', this)">🟢 New Only</button>
-      <button class="filter-btn" onclick="setFilter('adapt', this)">🟡 Adapted</button>
-      <button class="filter-btn" onclick="setFilter('existing', this)">🔵 Existing</button>
-    </div>
-
-    <div class="glossary-grid" id="glossaryGrid">
-
-      <!-- ===== NEW TERMS ===== -->
-      <div class="glossary-item new" data-type="new" data-name="sticky cell">
-        <div class="glossary-icon">🍬</div>
-        <div class="glossary-content">
-          <h3>Sticky Cell <span class="badge badge-new">New</span></h3>
-          <p>A grid cell hit by the Candy Cannon that becomes impassable. Players stepping onto or pushed into a sticky cell are <em>trapped</em>. Remains until cleansed or round ends. Rendered as Layer 2 overlay (pink translucent mesh, ID 17).</p>
-          <span class="code-ref">TILE_STICKY = 17 → GridMap Layer 2</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="telegraph">
-        <div class="glossary-icon">⚡</div>
-        <div class="glossary-content">
-          <h3>Telegraph <span class="badge badge-new">New</span></h3>
-          <p>1-second warning before cannon impact. Target cell glows pink/candy color with a shadow preview and charge-up sound. Uses temporary overlay tile (ID 18) on Layer 2, animated alpha 0→1 over 0.8s, then replaced by Sticky Cell on impact.</p>
-          <span class="code-ref">TILE_TELEGRAPH = 18 → rpc("sync_telegraph")</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="candy cannon">
-        <div class="glossary-icon">💥</div>
-        <div class="glossary-content">
-          <h3>Candy Cannon <span class="badge badge-new">New</span></h3>
-          <p>Central NPC occupying a permanent 3×3 zone at arena center. Fires volleys of 5 candy shots every 5 seconds, creating sticky cells. Static body — cannot be grabbed, thrown, or interacted with. Not a Tekton — it's a dedicated hazard entity.</p>
-          <span class="code-ref">CandyCannonController → candy_cannon.tscn</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="volley">
-        <div class="glossary-icon">🎯</div>
-        <div class="glossary-content">
-          <h3>Volley <span class="badge badge-new">New</span></h3>
-          <p>A batch of 5 simultaneous cannon shots fired at different target cells. One volley fires every 5 seconds (36 total over 3 minutes = 180 impacts). Each shot in a volley has an independent impact size roll (1×1, 1×2, or 2×2).</p>
-          <span class="code-ref">_fire_volley() → cannon_interval = 5.0</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="impact size">
-        <div class="glossary-icon">📐</div>
-        <div class="glossary-content">
-          <h3>Impact Size <span class="badge badge-new">New</span></h3>
-          <p>The footprint of each cannon shot. Three sizes: 1×1 (single cell), 1×2 (two adjacent), 2×2 (four cells square). Distribution changes per phase — early favors 1×1, endgame favors 2×2.</p>
-          <span class="code-ref">phase_weights[phase_idx]["2x2"]</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="trapped">
-        <div class="glossary-icon">🪤</div>
-        <div class="glossary-content">
-          <h3>Trapped <span class="badge badge-new">New</span></h3>
-          <p>Player state when standing on a sticky cell. Cannot move normally. Escape only via Cleanser power-up. Players can be trapped by stepping onto sticky, being pushed into sticky, or direct cannon hit. Trapped players keep their score but are out of active play.</p>
-          <span class="code-ref">trapped_players: Dict → rpc("sync_trapped")</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="cleanser">
-        <div class="glossary-icon">✨</div>
-        <div class="glossary-content">
-          <h3>Cleanser <span class="badge badge-new">New</span></h3>
-          <p>Power-up earned by completing 2 missions. Allows 5 cells of movement through sticky candy, cleansing traversed cells back to walkable. Inventory limit: 1. Cannot activate while stunned. 0.3s activation delay.</p>
-          <span class="code-ref">player_cleansers[peer_id] → GoalsCycleManager signal</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="clash">
-        <div class="glossary-icon">💫</div>
-        <div class="glossary-content">
-          <h3>Clash <span class="badge badge-new">New</span></h3>
-          <p>When two players activate Smack simultaneously (within 0.5s) and are in range of each other. Both get stunned for 1.0s, no push occurs, both smack bars are consumed. Server-authoritative timestamp comparison.</p>
-          <span class="code-ref">clash detection → 0.5s window, server authority</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="charged state">
-        <div class="glossary-icon">🔋</div>
-        <div class="glossary-content">
-          <h3>Charged State <span class="badge badge-new">New</span></h3>
-          <p>3-second window after Smack activation where the player model turns pink. If a target enters range during this window, the smack triggers. If no target is hit within 3s, energy is consumed with no effect.</p>
-          <span class="code-ref">smack_charged[player_id] → 3.0s window</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="anti-unfairness">
-        <div class="glossary-icon">⚖️</div>
-        <div class="glossary-content">
-          <h3>Anti-Unfairness <span class="badge badge-new">New</span></h3>
-          <p>Targeting rules preventing the cannon from feeling random/cheap. No same-player twice in a row, 2×2 never directly on player, path validation ensures escape routes exist (except final 30s). Uses AStar pathfinding.</p>
-          <span class="code-ref">last_targeted_player_id → EnhancedGridMap.initialize_astar()</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="route blocking">
-        <div class="glossary-icon">🚧</div>
-        <div class="glossary-content">
-          <h3>Route Blocking <span class="badge badge-new">New</span></h3>
-          <p>Cannon targeting strategy (25% chance) that places sticky cells on pathfinding bottlenecks — narrow corridors between sticky regions. Forces players to reroute. Calculated using EnhancedGridMap neighbor analysis.</p>
-          <span class="code-ref">_get_route_blocking_target() → 25% weight</span>
-        </div>
-      </div>
-
-      <div class="glossary-item new" data-type="new" data-name="gauntlet arena">
-        <div class="glossary-icon">🏟️</div>
-        <div class="glossary-content">
-          <h3>Gauntlet Arena <span class="badge badge-new">New</span></h3>
-          <p>20×20 cell arena with 391 playable cells (400 minus 3×3 NPC zone). Players spawn at outer edges/corners. Target: 80% sticky coverage by round end (313 cells), leaving ~78 safe cells.</p>
-          <span class="code-ref">ARENA_SIZE = 20 → gauntlet.tscn</span>
-        </div>
-      </div>
-
-      <!-- ===== ADAPTED TERMS ===== -->
-      <div class="glossary-item adapt" data-type="adapt" data-name="smack">
-        <div class="glossary-icon">👊</div>
-        <div class="glossary-content">
-          <h3>Smack <span class="badge badge-adapt">Adapted</span></h3>
-          <p>Gauntlet-specific melee push. Adapts existing <code>try_push()</code> from Attack Mode but replaces boost-meter gating with 8s auto-refill cooldown, adds 3s charged window, sticky landing trap, and clash detection. Push distance: 3 cells.</p>
-          <span class="code-ref">PlayerMovementManager.try_push() → smack_cooldowns</span>
-        </div>
-      </div>
-
-      <div class="glossary-item adapt" data-type="adapt" data-name="phase">
-        <div class="glossary-icon">⏱️</div>
-        <div class="glossary-content">
-          <h3>Phase <span class="badge badge-adapt">Adapted</span></h3>
-          <p>Three escalation phases in Gauntlet: <strong>Open Arena</strong> (0–60s), <strong>Route Pressure</strong> (60–120s), <strong>Survival Endgame</strong> (120–180s). Adapts StopNGoManager's Go/Stop phase pattern but uses time-elapsed triggers instead of cycle signals.</p>
-          <span class="code-ref">enum Phase { OPEN_ARENA, ROUTE_PRESSURE, SURVIVAL_ENDGAME }</span>
-        </div>
-      </div>
-
-      <div class="glossary-item adapt" data-type="adapt" data-name="bot ai cannon avoidance">
-        <div class="glossary-icon">🤖</div>
-        <div class="glossary-content">
-          <h3>Bot AI — Cannon Avoidance <span class="badge badge-adapt">Adapted</span></h3>
-          <p>Extends BotStrategicPlanner with Gauntlet-specific logic: telegraph awareness, sticky path planning, safe-zone pathfinding. Adapts existing bot movement heuristics to factor in shrinking arena.</p>
-          <span class="code-ref">BotStrategicPlanner → new evaluate_gauntlet()</span>
-        </div>
-      </div>
-
-      <!-- ===== EXISTING TERMS ===== -->
-      <div class="glossary-item existing" data-type="existing" data-name="attack mode">
-        <div class="glossary-icon">⚔️</div>
-        <div class="glossary-content">
-          <h3>Attack Mode <span class="badge badge-existing">Existing</span></h3>
-          <p>Existing player state toggled via PowerUpManager when boost bar is full. In Gauntlet, <em>not used directly</em> — replaced by Smack mechanic. The push physics from <code>try_push()</code> are reused but the activation logic differs.</p>
-          <span class="code-ref">PowerUpManager.is_attack_mode → NOT used in Gauntlet</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="stagger">
-        <div class="glossary-icon">😵</div>
-        <div class="glossary-content">
-          <h3>Stagger <span class="badge badge-existing">Existing</span></h3>
-          <p>Existing 1.5s movement disable after being push-attacked. Gauntlet's Smack uses a shorter 1.0s stun, but the underlying <code>apply_stagger()</code> function is reused with a duration parameter.</p>
-          <span class="code-ref">PlayerMovementManager.apply_stagger(duration)</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="mission / goals">
-        <div class="glossary-icon">🎯</div>
-        <div class="glossary-content">
-          <h3>Mission / Goals <span class="badge badge-existing">Existing</span></h3>
-          <p>3×3 pattern-matching tile collection system. Reused as-is from GoalManager + GoalsCycleManager. In Gauntlet, completing every 2 missions also triggers Cleanser unlock (new hook on existing signal).</p>
-          <span class="code-ref">GoalManager → GoalsCycleManager.goal_count_updated</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="layer 2 overlay">
-        <div class="glossary-icon">🗂️</div>
-        <div class="glossary-content">
-          <h3>Layer 2 Overlay <span class="badge badge-existing">Existing</span></h3>
-          <p>GridMap's Y=2 layer used for visual overlays (safe zones in Stop N Go, freeze in Freemode, highlights). Gauntlet uses it for Sticky Cell and Telegraph meshes. No conflict — modes are mutually exclusive.</p>
-          <span class="code-ref">GridMap.set_cell_item(Vector3i(x, 2, z), id)</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="try push">
-        <div class="glossary-icon">🫸</div>
-        <div class="glossary-content">
-          <h3>try_push() <span class="badge badge-existing">Existing</span></h3>
-          <p>Player push mechanic in PlayerMovementManager. Pushes target 3 cells backward. Gauntlet's Smack wraps this with direction-based push, sticky landing detection, and clash rules.</p>
-          <span class="code-ref">PlayerMovementManager.try_push(target, direction)</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="screen shake">
-        <div class="glossary-icon">📳</div>
-        <div class="glossary-content">
-          <h3>Screen Shake <span class="badge badge-existing">Existing</span></h3>
-          <p>Camera shake effect triggered via RPC. Used on cannon impact with "medium" intensity. Already implemented system-wide.</p>
-          <span class="code-ref">player.rpc("trigger_screen_shake", "medium")</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="tekton projectile">
-        <div class="glossary-icon">🎪</div>
-        <div class="glossary-content">
-          <h3>Tekton Projectile <span class="badge badge-existing">Existing</span></h3>
-          <p>Arc-tween projectile from Tekton NPC. Candy Cannon reuses this exact visual pattern (spawn_projectile_rpc) — creating a mesh, arc-tweening position, then freeing on arrival.</p>
-          <span class="code-ref">tekton.gd → spawn_projectile_rpc(target, duration)</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="rpc sync pattern">
-        <div class="glossary-icon">📡</div>
-        <div class="glossary-content">
-          <h3>RPC Sync Pattern <span class="badge badge-existing">Existing</span></h3>
-          <p>Server-authoritative state sync via <code>@rpc("authority", "call_local", "reliable")</code>. All Gauntlet state changes (sticky, phase, trap, cleanser) use this identical pattern.</p>
-          <span class="code-ref">@rpc("authority", "call_local", "reliable")</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="timed match">
-        <div class="glossary-icon">⏰</div>
-        <div class="glossary-content">
-          <h3>Timed Match <span class="badge badge-existing">Existing</span></h3>
-          <p>Global match timer from GoalsCycleManager. Gauntlet passes 180s duration. System handles countdown, HUD timer, and match-end trigger.</p>
-          <span class="code-ref">goals_cycle_manager.start_match(180.0)</span>
-        </div>
-      </div>
-
-      <div class="glossary-item existing" data-type="existing" data-name="special tiles manager">
-        <div class="glossary-icon">💎</div>
-        <div class="glossary-content">
-          <h3>SpecialTilesManager <span class="badge badge-existing">Existing</span></h3>
-          <p>Handles power-up tiles, inventory, and effects. Gauntlet restricts certain powerups (like Stop N Go restrictions) and adds Cleanser as a new inventory slot via the existing signal/slot system.</p>
-          <span class="code-ref">SpecialTilesManager.inventory → mode-based restrictions</span>
-        </div>
-      </div>
-
-    </div>
-  </section>
-
-  <!-- ============ ARCHITECTURE ============ -->
-  <section id="architecture">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(99,102,241,0.12)">🏗️</span> Architecture</h2>
-      <p>How GauntletManager slots into the existing manager tree, following the StopNGoManager pattern exactly.</p>
-    </div>
-    <div class="arch-diagram">
-      <div class="arch-tree">
-<span class="node">main.gd</span><br>
-<span class="connector">├──</span> <span class="node">_init_managers()</span> <span class="label">← instantiate GauntletManager</span><br>
-<span class="connector">├──</span> <span class="node">_setup_host_game()</span> <span class="label">← arena setup branch</span><br>
-<span class="connector">├──</span> <span class="node">_start_game()</span> <span class="label">← start_game_mode() call</span><br>
-<span class="connector">│</span><br>
-<span class="new-node">GauntletManager</span> <span class="tag-new">NEW</span><br>
-<span class="connector">├──</span> <span class="new-node">_setup_arena()</span> <span class="label">← 20×20 grid, center 3×3 NPC zone</span><br>
-<span class="connector">├──</span> <span class="new-node">_setup_hud()</span> <span class="label">← mission label, cleanser indicator</span><br>
-<span class="connector">├──</span> <span class="new-node">start_game_mode()</span> <span class="label">← start cannon timer, spawn tiles</span><br>
-<span class="connector">├──</span> <span class="new-node">_process()</span> <span class="label">← cannon volley timer, phase escalation</span><br>
-<span class="connector">├──</span> <span class="new-node">CandyCannonController</span> <span class="tag-new">NEW</span> <span class="label">← targeting, volley fire</span><br>
-<span class="connector">├──</span> <span class="new-node">StickyCell system</span> <span class="tag-new">NEW</span> <span class="label">← Layer 2 overlay, trap logic</span><br>
-<span class="connector">├──</span> <span class="new-node">Cleanser system</span> <span class="tag-new">NEW</span> <span class="label">← powerup via missions</span><br>
-<span class="connector">├──</span> <span class="new-node">Smack system</span> <span class="tag-new">NEW</span> <span class="label">← modified push with charge/cooldown</span><br>
-<span class="connector">└──</span> <span class="new-node">Win condition</span> <span class="label">← highest score at timer end</span><br>
-      </div>
-    </div>
-  </section>
-
-  <!-- ============ REUSE MAP ============ -->
-  <section id="reuse">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(52,211,153,0.12)">♻️</span> Reuse Map</h2>
-      <p>How each GDD feature maps to existing systems — showing what's reused vs what's new.</p>
-    </div>
-    <div class="table-wrap">
-      <table>
-        <thead>
-          <tr><th>GDD Feature</th><th>Existing System</th><th>Reuse</th><th>New Work</th></tr>
-        </thead>
-        <tbody>
-          <tr><td>Game Mode Registration</td><td class="td-code">GameMode.gd + LobbyManager</td><td><span class="reuse-direct">Direct</span></td><td>Add enum + strings</td></tr>
-          <tr><td>20×20 Arena</td><td class="td-code">StopNGoManager._setup_arena()</td><td><span class="reuse-heavy">Heavy</span></td><td>Custom layout, same API</td></tr>
-          <tr><td>Tile Collection / Scoring</td><td class="td-code">GoalsCycleManager</td><td><span class="reuse-direct">Direct</span></td><td>Reuse as-is</td></tr>
-          <tr><td>Mission System</td><td class="td-code">GoalManager + goals_cycle_manager</td><td><span class="reuse-direct">Direct</span></td><td>Same 3×3 pattern matching</td></tr>
-          <tr><td>Timed Match</td><td class="td-code">GoalsCycleManager.start_match()</td><td><span class="reuse-direct">Direct</span></td><td>Pass 180s duration</td></tr>
-          <tr><td>Player Movement</td><td class="td-code">PlayerMovementManager</td><td><span class="reuse-direct">Direct</span></td><td>No changes</td></tr>
-          <tr><td>Powerup System</td><td class="td-code">SpecialTilesManager</td><td><span class="reuse-partial">Partial</span></td><td>Cleanser = new type</td></tr>
-          <tr><td>Smack Mechanic</td><td class="td-code">PlayerMovementManager.try_push()</td><td><span class="reuse-adapt">Adapt</span></td><td>Modified push rules</td></tr>
-          <tr><td>Candy Cannon NPC</td><td class="td-code">tekton.gd + TektonController</td><td><span class="reuse-pattern">Pattern</span></td><td>New NPC, reuses projectile</td></tr>
-          <tr><td>Sticky Cells</td><td class="td-code">StopNGoManager safe zone overlay</td><td><span class="reuse-pattern">Pattern</span></td><td>New tile type, same layer</td></tr>
-          <tr><td>Telegraph VFX</td><td class="td-code">VFXManager / animation.gd</td><td><span class="reuse-pattern">Pattern</span></td><td>New animations, same system</td></tr>
-          <tr><td>HUD</td><td class="td-code">StopNGoManager._setup_hud()</td><td><span class="reuse-direct">Direct</span></td><td>Mode-specific labels</td></tr>
-          <tr><td>Network Sync</td><td class="td-code">RPC patterns</td><td><span class="reuse-direct">Direct</span></td><td>Same patterns</td></tr>
-          <tr><td>Lobby Settings</td><td class="td-code">LobbyManager signal/sync</td><td><span class="reuse-direct">Direct</span></td><td>Gauntlet settings</td></tr>
-          <tr><td>Bot AI</td><td class="td-code">BotController + BotStrategicPlanner</td><td><span class="reuse-adapt">Adapt</span></td><td>Cannon avoidance strategy</td></tr>
-        </tbody>
-      </table>
-    </div>
-  </section>
-
-  <!-- ============ PHASES ============ -->
-  <section id="phases">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(251,191,36,0.12)">🌊</span> Phase Timeline</h2>
-      <p>Three escalation phases that control cannon intensity and impact size distribution.</p>
-    </div>
-    <div class="timeline">
-      <div class="phase-card phase-1">
-        <div class="phase-time">0:00 — 1:00</div>
-        <h3>Open Arena</h3>
-        <ul>
-          <li>Collect tiles, learn the mission</li>
-          <li>Slow candy pressure</li>
-          <li>1×1 shots: <strong>60%</strong></li>
-          <li>1×2 shots: <strong>40%</strong></li>
-          <li>2×2 shots: <strong>0%</strong></li>
-          <li>~60 impacts total</li>
-        </ul>
-      </div>
-      <div class="phase-card phase-2">
-        <div class="phase-time">1:00 — 2:00</div>
-        <h3>Route Pressure</h3>
-        <ul>
-          <li>Candy shapes arena topology</li>
-          <li>Smack becomes dangerous</li>
-          <li>1×1 shots: <strong>30%</strong></li>
-          <li>1×2 shots: <strong>55%</strong></li>
-          <li>2×2 shots: <strong>15%</strong></li>
-          <li>Cleanser used strategically</li>
-        </ul>
-      </div>
-      <div class="phase-card phase-3">
-        <div class="phase-time">2:00 — 3:00</div>
-        <h3>Survival Endgame</h3>
-        <ul>
-          <li>~80% arena is sticky</li>
-          <li>Safe zones limited, high tension</li>
-          <li>1×1 shots: <strong>15%</strong></li>
-          <li>1×2 shots: <strong>55%</strong></li>
-          <li>2×2 shots: <strong>30%</strong></li>
-          <li>Aggressive route-blocking allowed</li>
-        </ul>
-      </div>
-    </div>
-  </section>
-
-  <!-- ============ CORE SYSTEMS ============ -->
-  <section id="systems">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(168,85,247,0.12)">⚙️</span> Core Systems</h2>
-      <p>Deep-dive into the four new systems and how they integrate.</p>
-    </div>
-
-    <!-- Sticky Cell -->
-    <div class="card" style="margin-bottom: 16px;">
-      <h3 style="margin-bottom:16px; display:flex; align-items:center; gap:8px;">🍬 Sticky Cell System</h3>
-      <div class="table-wrap">
-        <table>
-          <thead><tr><th>Feature</th><th>Implementation</th></tr></thead>
-          <tbody>
-            <tr><td>Visual</td><td>Layer 2 overlay — transparent candy-pink mesh (ID 17)</td></tr>
-            <tr><td>Movement Block</td><td class="td-code">PlayerMovementManager.simple_move_to() — add sticky check alongside wall check</td></tr>
-            <tr><td>Trap on Step</td><td class="td-code">GauntletManager._check_player_on_sticky() in _process()</td></tr>
-            <tr><td>Trap on Push</td><td class="td-code">PlayerMovementManager.try_push() — check landing cell</td></tr>
-            <tr><td>Cleanser Bypass</td><td>Temporary flag (like <code>is_invisible</code> wall bypass)</td></tr>
-            <tr><td>Network Sync</td><td class="td-code">main.rpc("sync_grid_item", x, 2, z, 17)</td></tr>
-          </tbody>
-        </table>
-      </div>
-    </div>
-
-    <!-- Smack -->
-    <div class="card" style="margin-bottom: 16px;">
-      <h3 style="margin-bottom:16px; display:flex; align-items:center; gap:8px;">👊 Smack vs Attack Mode</h3>
-      <div class="table-wrap">
-        <table>
-          <thead><tr><th>Property</th><th>Current Attack Mode</th><th>Gauntlet Smack</th></tr></thead>
-          <tbody>
-            <tr><td>Charge Source</td><td>Boost bar fills to 100</td><td>8s auto-refill cooldown</td></tr>
-            <tr><td>Activation</td><td>Toggle <code>is_attack_mode</code></td><td>3s charged window (pink model)</td></tr>
-            <tr><td>Push Distance</td><td>3 cells backward</td><td>3 cells in push direction</td></tr>
-            <tr><td>Stagger Duration</td><td>1.5s <code>apply_stagger()</code></td><td>1.0s stun</td></tr>
-            <tr><td>Sticky Landing</td><td>N/A</td><td>Trapped on first sticky cell</td></tr>
-            <tr><td>Clash Rule</td><td>N/A</td><td>Both stunned, no push, bars consumed</td></tr>
-          </tbody>
-        </table>
-      </div>
-    </div>
-
-    <!-- Cleanser -->
-    <div class="card" style="margin-bottom: 16px;">
-      <h3 style="margin-bottom:16px; display:flex; align-items:center; gap:8px;">✨ Cleanser Power-Up</h3>
-      <div class="table-wrap">
-        <table>
-          <thead><tr><th>Property</th><th>Value</th></tr></thead>
-          <tbody>
-            <tr><td>Unlock Trigger</td><td class="td-code">GoalsCycleManager.goal_count_updated → count % 2 == 0</td></tr>
-            <tr><td>Storage</td><td class="td-code">GauntletManager.player_cleansers[peer_id] = 1</td></tr>
-            <tr><td>Effect</td><td>5 cells movement through sticky — crossed cells become passable</td></tr>
-            <tr><td>Sync</td><td class="td-code">rpc("sync_cleanser_state", peer_id, count)</td></tr>
-            <tr><td>Clear Sticky</td><td class="td-code">main.rpc("sync_grid_item", x, 2, z, -1)</td></tr>
-            <tr><td>Inventory Limit</td><td>1 per player</td></tr>
-          </tbody>
-        </table>
-      </div>
-    </div>
-
-    <!-- Cannon Targeting -->
-    <div class="card">
-      <h3 style="margin-bottom:16px; display:flex; align-items:center; gap:8px;">🎯 Cannon Targeting Intelligence</h3>
-      <div class="table-wrap">
-        <table>
-          <thead><tr><th>Roll %</th><th>Target Strategy</th><th>Purpose</th></tr></thead>
-          <tbody>
-            <tr><td><strong>60%</strong></td><td>Near a player (not same as last)</td><td>Direct pressure</td></tr>
-            <tr><td><strong>25%</strong></td><td>Route-blocking bottleneck</td><td>Cut escape paths</td></tr>
-            <tr><td><strong>10%</strong></td><td>Random non-sticky area</td><td>Spread coverage</td></tr>
-            <tr><td><strong>5%</strong></td><td>Previously sticky / chaos</td><td>Unpredictability</td></tr>
-          </tbody>
-        </table>
-      </div>
-    </div>
-  </section>
-
-  <!-- ============ FILES ============ -->
-  <section id="files">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(34,211,238,0.12)">📁</span> File Changes</h2>
-    </div>
-
-    <h3 style="margin-bottom:12px; font-size:14px; color:var(--accent-green);">New Files</h3>
-    <div class="file-grid" style="margin-bottom:28px">
-      <div class="file-card new-file">
-        <div class="file-icon">📜</div>
-        <div class="file-info"><h4>gauntlet_manager.gd</h4><p>Core mode logic, phases, sticky cells, cleanser, smack</p></div>
-      </div>
-      <div class="file-card new-file">
-        <div class="file-icon">📜</div>
-        <div class="file-info"><h4>candy_cannon_controller.gd</h4><p>Cannon targeting, volley fire, telegraph</p></div>
-      </div>
-      <div class="file-card new-file">
-        <div class="file-icon">🎬</div>
-        <div class="file-info"><h4>gauntlet.tscn</h4><p>3D arena environment scene</p></div>
-      </div>
-      <div class="file-card new-file">
-        <div class="file-icon">🎬</div>
-        <div class="file-info"><h4>candy_cannon.tscn</h4><p>Candy Cannon NPC (3×3, static)</p></div>
-      </div>
-    </div>
-
-    <h3 style="margin-bottom:12px; font-size:14px; color:var(--accent-yellow);">Modified Files</h3>
-    <div class="file-grid">
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>game_mode.gd</h4><p>Add GAUNTLET = 3 enum, string mappings</p></div>
-      </div>
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>lobby_manager.gd</h4><p>Mode list, gauntlet settings, area mapping</p></div>
-      </div>
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>main.gd</h4><p>Manager init, arena setup branch, start branch</p></div>
-      </div>
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>player_movement_manager.gd</h4><p>Sticky check in move + push</p></div>
-      </div>
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>goals_cycle_manager.gd</h4><p>Cleanser grant on 2nd goal</p></div>
-      </div>
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>special_tiles_manager.gd</h4><p>Gauntlet powerup restrictions</p></div>
-      </div>
-      <div class="file-card mod-file">
-        <div class="file-icon">✏️</div>
-        <div class="file-info"><h4>MeshLibrary .tres</h4><p>Add TILE_STICKY (17) and TILE_TELEGRAPH (18)</p></div>
-      </div>
-    </div>
-  </section>
-
-  <!-- ============ NETWORK ============ -->
-  <section id="network">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(248,113,113,0.12)">📡</span> Network Sync</h2>
-      <p>All sync follows existing RPC patterns — no new networking paradigms needed.</p>
-    </div>
-    <div class="table-wrap">
-      <table>
-        <thead><tr><th>Data</th><th>Sync Method</th><th>Existing Pattern</th></tr></thead>
-        <tbody>
-          <tr><td>Sticky Cells</td><td class="sync-method">main.rpc("sync_grid_item", x, 2, z, 17)</td><td>Safe zone / freeze overlay</td></tr>
-          <tr><td>Telegraph</td><td class="sync-method">rpc("sync_telegraph", targets_array)</td><td>StopNGoManager.sync_phase()</td></tr>
-          <tr><td>Phase Changes</td><td class="sync-method">rpc("sync_gauntlet_phase", idx, elapsed)</td><td>StopNGoManager.sync_phase()</td></tr>
-          <tr><td>Trap State</td><td class="sync-method">player.rpc("sync_trapped", true)</td><td>player.rpc("sync_stop_freeze")</td></tr>
-          <tr><td>Cleanser Grant</td><td class="sync-method">rpc("sync_cleanser", peer_id, count)</td><td>goals_cycle_manager.sync_goal_count()</td></tr>
-          <tr><td>Smack State</td><td class="sync-method">player.rpc("sync_smack_state", charged)</td><td>player.rpc("sync_modulate")</td></tr>
-          <tr><td>Cannon NPC</td><td colspan="2" style="color:var(--text-muted)">Static scene — no movement sync needed</td></tr>
-        </tbody>
-      </table>
-    </div>
-  </section>
-
-  <!-- ============ PRIORITY ============ -->
-  <section id="priority">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(251,191,36,0.12)">📋</span> Implementation Priority</h2>
-    </div>
-    <div class="card">
-      <div class="priority-list">
-        <div class="priority-item"><div class="priority-num">1</div><div class="priority-info"><h4>Game Mode Registration</h4><p>game_mode.gd, lobby_manager.gd, main.gd</p></div></div>
-        <div class="priority-item"><div class="priority-num">2</div><div class="priority-info"><h4>Arena Setup</h4><p>gauntlet_manager._setup_arena(), 20×20 grid</p></div></div>
-        <div class="priority-item"><div class="priority-num">3</div><div class="priority-info"><h4>Tile Spawning</h4><p>StopNGoManager._spawn_mission_tiles() pattern</p></div></div>
-        <div class="priority-item"><div class="priority-num">4</div><div class="priority-info"><h4>Cannon Timer + Volley</h4><p>5s interval, 5 shots, 1×1 only</p></div></div>
-        <div class="priority-item"><div class="priority-num">5</div><div class="priority-info"><h4>Sticky Cell System</h4><p>Layer 2 overlay, movement block, trap detection</p></div></div>
-        <div class="priority-item"><div class="priority-num">6</div><div class="priority-info"><h4>Telegraph VFX</h4><p>Warning glow → impact transition</p></div></div>
-        <div class="priority-item"><div class="priority-num">7</div><div class="priority-info"><h4>Impact Sizes</h4><p>1×2 and 2×2 shapes, phase weights</p></div></div>
-        <div class="priority-item"><div class="priority-num">8</div><div class="priority-info"><h4>Smack Mechanic</h4><p>Modified push with cooldown/charge</p></div></div>
-        <div class="priority-item"><div class="priority-num">9</div><div class="priority-info"><h4>Cleanser</h4><p>Unlock tracking, sticky bypass</p></div></div>
-        <div class="priority-item"><div class="priority-num">10</div><div class="priority-info"><h4>Targeting Intelligence</h4><p>Player proximity, route blocking, anti-unfairness</p></div></div>
-        <div class="priority-item"><div class="priority-num">11</div><div class="priority-info"><h4>Bot AI</h4><p>Cannon avoidance, sticky path planning</p></div></div>
-        <div class="priority-item"><div class="priority-num">12</div><div class="priority-info"><h4>Polish</h4><p>VFX, SFX, HUD animations, 3D scene</p></div></div>
-      </div>
-    </div>
-  </section>
-
-  <!-- ============ RISKS ============ -->
-  <section id="risks">
-    <div class="section-header">
-      <h2><span class="icon" style="background:rgba(248,113,113,0.12)">⚠️</span> Risk Assessment</h2>
-    </div>
-    <div class="risk-grid">
-      <div class="risk-card">
-        <div class="risk-indicator">🗂️</div>
-        <div class="risk-content">
-          <h4>Layer 2 Conflict</h4>
-          <p>GridMap Layer 2 used by freeze/safe overlays. <strong>Mitigated:</strong> Gauntlet mode is exclusive — no freeze/safe tiles exist.</p>
-        </div>
-      </div>
-      <div class="risk-card">
-        <div class="risk-indicator">📊</div>
-        <div class="risk-content">
-          <h4>20×20 Grid Performance</h4>
-          <p>400 cells + overlays. <strong>Mitigated:</strong> Existing 23×12 and 14×14 arenas work fine; 20×20 comparable.</p>
-        </div>
-      </div>
-      <div class="risk-card">
-        <div class="risk-indicator">🚫</div>
-        <div class="risk-content">
-          <h4>Impossible Arenas</h4>
-          <p>Cannon could seal all paths. <strong>Mitigated:</strong> AStar pathfinding check before each volley.</p>
-        </div>
-      </div>
-      <div class="risk-card">
-        <div class="risk-indicator">🔢</div>
-        <div class="risk-content">
-          <h4>MeshLibrary ID Collision</h4>
-          <p>IDs 17–18 might exist. <strong>Mitigated:</strong> Verify max ID in .tres before adding.</p>
-        </div>
-      </div>
-      <div class="risk-card">
-        <div class="risk-indicator">⏱️</div>
-        <div class="risk-content">
-          <h4>Smack Clash Timing</h4>
-          <p>Network latency affects clash detection. <strong>Mitigated:</strong> Server-authoritative timestamp, 0.5s window.</p>
-        </div>
-      </div>
-    </div>
-  </section>
-
-</div>
-
-<footer>
-  <div class="wrapper">
-    Tekton Dash — Candy Cannon Survival Technical Docs · Generated from gauntlet-technical-implementation.md
-  </div>
-</footer>
-
-<button class="scroll-top" id="scrollTop" onclick="window.scrollTo({top:0,behavior:'smooth'})">↑</button>
-
-<script>
-// Scroll-to-top button
-window.addEventListener('scroll', () => {
-  document.getElementById('scrollTop').classList.toggle('show', window.scrollY > 400);
-});
-
-// Active nav link
-const sections = document.querySelectorAll('section[id]');
-const navLinks = document.querySelectorAll('.nav-link');
-window.addEventListener('scroll', () => {
-  let current = '';
-  sections.forEach(s => {
-    if (window.scrollY >= s.offsetTop - 120) current = s.id;
-  });
-  navLinks.forEach(l => {
-    l.classList.toggle('active', l.getAttribute('href') === '#' + current);
-  });
-});
-
-// Glossary filter
-let activeFilter = 'all';
-function setFilter(type, btn) {
-  activeFilter = type;
-  document.querySelectorAll('.filter-btn').forEach(b => b.classList.remove('active'));
-  btn.classList.add('active');
-  filterGlossary();
-}
-function filterGlossary() {
-  const q = document.getElementById('glossarySearch').value.toLowerCase();
-  document.querySelectorAll('.glossary-item').forEach(item => {
-    const name = item.dataset.name;
-    const type = item.dataset.type;
-    const text = item.textContent.toLowerCase();
-    const matchFilter = activeFilter === 'all' || type === activeFilter;
-    const matchSearch = !q || text.includes(q);
-    item.style.display = matchFilter && matchSearch ? '' : 'none';
-  });
-}
-</script>
-
-</body>
-</html>

docs/gauntlet-technical-implementation.md

@@ -1,793 +0,0 @@
-# Candy Pump Survival (Gauntlet) — Technical Implementation Plan
-
-## 1. Feasibility Summary
-
-**Verdict: Feasible.** The existing codebase provides ~70% of the infrastructure needed. The game mode architecture is modular — each mode has its own manager (`StopNGoManager`, `PortalModeManager`) that handles arena setup, HUD, phase logic, and win conditions. A new `GauntletManager` follows this identical pattern.
-
-### Reuse Breakdown
-
-| GDD Feature | Existing System | Reuse Level | New Work |
-|---|---|---|---|
-| Game Mode registration | `GameMode.gd` enum + `LobbyManager` | **Direct** | Already registered (`GAUNTLET = 3`) |
-| 24×24 Arena setup | `StopNGoManager._setup_arena()` pattern | **Heavy** | Custom layout, same GridMap API |
-| Tile collection / scoring | `GoalsCycleManager` | **Direct** | Reuse goal completion + scoring |
-| Mission system (goals) | `GoalManager` + `goals_cycle_manager.gd` | **Direct** | Same 3×3 pattern matching |
-| Timed match (3 min) | `GoalsCycleManager.start_match()` | **Direct** | Pass 180s duration |
-| Player movement | `PlayerMovementManager` | **Direct** | Add sticky checks to `simple_move_to()` |
-| Sticky cells | `StopNGoManager` safe zone overlay (Layer 2) | **Pattern** | New tile type, same GridMap layer approach |
-| Telegraph VFX | Existing GauntletManager telegraph system | **Direct** | Adapt for growth ticks instead of cannon |
-| Smack mechanic | Existing GauntletManager smack system | **Direct** | Already implemented |
-| Cleanser power-up | Existing GauntletManager cleanser system | **Direct** | Already implemented |
-| HUD | `StopNGoManager._setup_hud()` pattern | **Direct** | Mode-specific labels |
-| Network sync | RPC patterns throughout codebase | **Direct** | Same `rpc()` / `sync_*` patterns |
-| Bot AI | `BotController` + `BotStrategicPlanner` | **Adapt** | New strategy for sticky avoidance |
-| Candy bubbles | **NEW** | **New** | Bubble spawn, grow, explode system |
-| Candidate scoring | **NEW** | **New** | Cellular-automation growth algorithm |
-| Movement buffers | **NEW** | **New** | Hidden safe zone detection/decay |
-
-### What Changes from Current Implementation
-
-The current `GauntletManager` uses a **cannon shooting** model (NPC fires projectiles at targets). The new GDD replaces this with a **ground growth** model (candy spreads from the ground via cellular-automation scoring). This requires:
-
-1. **Remove** `_fire_volley()`, cannon timer, volley size, projectile spawning
-2. **Add** growth tick timer, candidate scoring, weighted cell selection
-3. **Add** candy bubble system (spawn, grow, explode)
-4. **Add** movement buffer detection and decay
-5. **Add** layer-based priority logic
-6. **Change** arena from 20×20 to 24×24
-
----
-
-## 2. Architecture Overview
-
-```
-main.gd
-├── _init_managers()          ← GauntletManager instantiation (existing)
-├── _setup_host_game()        ← GauntletManager._setup_arena()
-├── _start_game()             ← GauntletManager.start_game_mode()
-│
-GauntletManager (MODIFY EXISTING)
-├── _setup_arena()            ← 24×24 grid, center 3×3 NPC zone
-├── _setup_hud()              ← Mission label, cleanser indicator
-├── start_game_mode()         ← Start growth timer, spawn tiles
-├── _process()                ← Growth tick timer, bubble timer, phase escalation
-├── GrowthTick system         ← Candidate scoring, weighted selection, telegraph
-├── CandyBubble system        ← Bubble spawn, grow, explode
-├── StickyCell system          ← Layer 2 overlay, trap logic
-├── MovementBuffer system     ← Hidden safe zone detection, decay, camping override
-├── Cleanser system            ← Existing powerup
-├── Smack system               ← Existing modified push
-└── Win condition              ← Highest score at timer end
-```
-
----
-
-## 3. File-by-File Implementation
-
-### 3.1 Game Mode Registration — Already Done
-
-The existing `game_mode.gd` already has:
-```gdscript
-enum Mode {
-	FREEMODE = 0,
-	STOP_N_GO = 1,
-	TEKTON_DOORS = 2,
-	GAUNTLET = 3          # Already registered
-}
-```
-
-And `LobbyManager` already has `"Candy Cannon Survival"` in `available_game_modes`. The mode name string can remain as-is or be updated to `"Candy Pump Survival"` if desired.
-
----
-
-### 3.2 Core Manager — `gauntlet_manager.gd` (MODIFY EXISTING)
-
-**Location:** `scripts/managers/gauntlet_manager.gd`
-
-**Major structural changes:**
-
-#### Remove (cannon-based system):
-
-```
-var cannon_timer: float
-var cannon_interval: float
-var volley_size: int
-var last_targeted_player_id: int
-func _fire_volley()
-func _select_targets()
-func _get_near_player_target()
-func _get_route_blocking_target()
-func _get_random_non_sticky_target()
-func _get_random_target()
-```
-
-#### Add (growth-based system):
-
-```gdscript
-class_name GauntletManager
-extends Node
-
-# Signals
-signal phase_changed(phase_index: int)
-signal growth_tick(targets: Array)
-signal player_trapped(player_id: int)
-signal cleanser_granted(player_id: int)
-signal bubble_spawned(center: Vector2i)
-signal bubble_exploded(center: Vector2i, area: Array[Vector2i])
-
-# Constants
-const ARENA_SIZE = 24
-const NPC_SIZE = 3
-const NPC_CENTER = Vector2i(11, 11)  # Center of 24×24
-const TILE_STICKY = 17
-const TILE_TELEGRAPH = 18
-const TILE_WALKABLE = 0
-const TILE_OBSTACLE = 4
-
-# Phase timing
-enum Phase { OUTER_PRESSURE, MIDDLE_PRESSURE, INNER_SURVIVAL }
-var current_phase: Phase = Phase.OUTER_PRESSURE
-var elapsed_time: float = 0.0
-
-# Growth tick state
-var growth_timer: float = 0.0
-var growth_interval: float = 3.0
-var telegraph_duration: float = 1.0
-var sticky_cells: Dictionary = {}       # Vector2i -> true
-var telegraphed_cells: Dictionary = {}  # Vector2i -> true
-
-# Phase-based growth config
-var phase_growth_config: Array = [
-	{"cells_per_tick": [4, 6], "distribution": {"outer": 0.75, "middle": 0.10, "inner": 0.00, "near_player": 0.10, "random": 0.05}},
-	{"cells_per_tick": [6, 8], "distribution": {"outer": 0.20, "middle": 0.50, "inner": 0.00, "near_player": 0.15, "sticky_expansion": 0.10, "random": 0.05}},
-	{"cells_per_tick": [8, 10], "distribution": {"outer": 0.10, "middle": 0.25, "inner": 0.35, "near_player": 0.15, "sticky_expansion": 0.15, "random": 0.10}},
-]
-
-# Candy bubble state
-var bubble_timer: float = 0.0
-var bubbles_this_phase: int = 0
-var max_bubbles_per_phase: Array = [0, 2, 3]
-var active_bubbles: Array = []  # [{center, grow_timer, warning_area}]
-var recent_bubble_positions: Array = []  # For RepetitionPenalty
-
-# Movement buffer state
-var movement_buffers: Dictionary = {}  # Vector2i -> {penalty: float, created_at: float}
-var camping_tracker: Dictionary = {}   # player_id -> {position: Vector2i, since: float}
-
-# Smack state (per-player) — unchanged
-var smack_cooldowns: Dictionary = {}
-var smack_charged: Dictionary = {}
-
-# Cleanser tracking — unchanged
-var player_mission_completions: Dictionary = {}
-var player_cleansers: Dictionary = {}
-
-# Trapped players — unchanged
-var trapped_players: Dictionary = {}
-
-# Arena layer cache
-var arena_layers: Dictionary = {}  # Vector2i -> "outer"/"middle"/"inner"
-```
-
----
-
-### 3.3 Arena Setup — `_setup_arena()`
-
-**Pattern source:** `StopNGoManager._setup_arena()`
-
-Key changes from 20×20 to 24×24:
-
-```gdscript
-func _setup_arena():
-	if not multiplayer.is_server():
-		return
-	# Resize gridmap to 24×24
-	enhanced_gridmap.columns = ARENA_SIZE
-	enhanced_gridmap.rows = ARENA_SIZE
-	enhanced_gridmap.floors = 3
-	# Clear all layers
-	enhanced_gridmap.clear_floor(0)
-	enhanced_gridmap.clear_floor(1)
-	enhanced_gridmap.clear_floor(2)
-	# Fill Floor 0 with walkable tiles
-	for x in range(ARENA_SIZE):
-		for z in range(ARENA_SIZE):
-			enhanced_gridmap.set_cell_item(Vector3i(x, 0, z), TILE_WALKABLE)
-	# Block center 3×3 for Candy Pump NPC
-	for x in range(NPC_CENTER.x - 1, NPC_CENTER.x + 2):
-		for z in range(NPC_CENTER.y - 1, NPC_CENTER.y + 2):
-			enhanced_gridmap.set_cell_item(Vector3i(x, 0, z), TILE_OBSTACLE)
-	# Build arena layer map
-	_build_arena_layers()
-	# Sync to clients
-	rpc("sync_arena_setup", ARENA_SIZE, NPC_CENTER)
-	enhanced_gridmap.initialize_astar()
-	enhanced_gridmap.update_astar_costs()
-```
-
----
-
-### 3.4 Layer Calculation — `_build_arena_layers()`
-
-**New method.** Precomputes the layer for every cell based on edge distance.
-
-```gdscript
-func _build_arena_layers():
-	arena_layers.clear()
-	for x in range(ARENA_SIZE):
-		for z in range(ARENA_SIZE):
-			var edge_dist = mini(x, z, ARENA_SIZE - 1 - x, ARENA_SIZE - 1 - z)
-			var layer: String
-			if edge_dist <= 3:
-				layer = "outer"
-			elif edge_dist <= 7:
-				layer = "middle"
-			else:
-				layer = "inner"
-			arena_layers[Vector2i(x, z)] = layer
-```
-
----
-
-### 3.5 Growth Tick System — `_process_growth_tick()`
-
-**Replaces** `_fire_volley()`. Called every 3 seconds.
-
-```gdscript
-func _process_growth_tick():
-	if not multiplayer.is_server():
-		return
-	var config = phase_growth_config[current_phase]
-	var cell_count = randi_range(config.cells_per_tick[0], config.cells_per_tick[1])
-	var candidates = _generate_candidates()
-	var selected = _select_cells_weighted(candidates, cell_count)
-	# Path safety check
-	selected = _apply_path_safety(selected)
-	# Movement buffer check
-	selected = _apply_movement_buffer_check(selected)
-	# Telegraph
-	_telegraph_cells(selected)
-	# After telegraph_duration: apply sticky
-	get_tree().create_timer(telegraph_duration).timeout.connect(func():
-		_apply_sticky_cells(selected)
-	)
-```
-
----
-
-### 3.6 Candidate Generation — `_generate_candidates()`
-
-**New method.** Builds scored list of all SAFE cells.
-
-```gdscript
-func _generate_candidates() -> Array:
-	var candidates: Array = []
-	var players = get_tree().get_nodes_in_group("Players")
-	for x in range(ARENA_SIZE):
-		for z in range(ARENA_SIZE):
-			var pos = Vector2i(x, z)
-			if not _is_cell_valid_for_growth(pos):
-				continue
-			var score = _calculate_candidate_score(pos, players)
-			candidates.append({"pos": pos, "score": score})
-	return candidates
-```
-
----
-
-### 3.7 Candidate Scoring — `_calculate_candidate_score()`
-
-**New method.** Implements the full Candidate Score formula from the GDD.
-
-```gdscript
-func _calculate_candidate_score(pos: Vector2i, players: Array) -> float:
-	var score: float = 0.0
-
-	# LayerPriority
-	var layer = arena_layers.get(pos, "outer")
-	var layer_scores = {
-		Phase.OUTER_PRESSURE: {"outer": 60.0, "middle": 15.0, "inner": -40.0},
-		Phase.MIDDLE_PRESSURE: {"outer": 20.0, "middle": 60.0, "inner": 5.0},
-		Phase.INNER_SURVIVAL: {"outer": 10.0, "middle": 35.0, "inner": 60.0},
-	}
-	score += layer_scores[current_phase].get(layer, 0.0)
-
-	# StickyNeighborScore (+8 per sticky neighbor, max +64)
-	var neighbors = _get_8_neighbors(pos)
-	for n in neighbors:
-		if sticky_cells.has(n):
-			score += 8.0
-
-	# InwardPressureScore
-	var center_dist = pos.distance_to(Vector2(NPC_CENTER))
-	var max_dist = Vector2(ARENA_SIZE, ARENA_SIZE).length() / 2.0
-	var inward_ratio = 1.0 - (center_dist / max_dist)
-	match current_phase:
-		Phase.OUTER_PRESSURE: score += lerpf(0.0, 10.0, inward_ratio)
-		Phase.MIDDLE_PRESSURE: score += lerpf(5.0, 20.0, inward_ratio)
-		Phase.INNER_SURVIVAL: score += lerpf(10.0, 30.0, inward_ratio)
-
-	# PlayerPressureScore
-	var min_player_dist = INF
-	for p in players:
-		var p_pos = Vector2i(p.grid_position.x, p.grid_position.z) if p.has_method("get_grid_position") else Vector2i(p.position.x, p.position.z)
-		var dist = pos.distance_to(p_pos)
-		min_player_dist = mini(min_player_dist, int(dist))
-	if min_player_dist >= 2 and min_player_dist <= 4:
-		score += 20.0
-	elif min_player_dist == 0:
-		if elapsed_time < 150.0:  # Before final 30s
-			score -= 50.0
-		else:
-			score += 10.0
-
-	# ClusterGrowthScore
-	if _connects_sticky_clusters(pos):
-		score += 25.0
-	elif _expands_sticky_cluster(pos):
-		score += 15.0
-
-	# RoutePressureScore
-	if _is_high_traffic_route(pos):
-		score += randf_range(10.0, 25.0)
-
-	# CampingPressureScore
-	for pid in camping_tracker:
-		var camp = camping_tracker[pid]
-		if pos.distance_to(camp.position) <= 4:
-			var camp_duration = elapsed_time - camp.since
-			if camp_duration > 10.0 and player_cleansers.get(pid, 0) > 0:
-				score += 60.0
-			elif camp_duration > 8.0:
-				score += 40.0
-			elif camp_duration > 5.0:
-				score += 20.0
-
-	# RandomNoise
-	score += randf_range(-20.0, 20.0)
-
-	# MovementBufferPenalty
-	if movement_buffers.has(pos):
-		var buffer = movement_buffers[pos]
-		var penalty = _get_buffer_penalty(buffer.penalty)
-		score += penalty
-
-	# PathSafetyPenalty
-	if _would_trap_player(pos) and elapsed_time < 150.0:
-		score -= 100.0
-	elif _removes_last_exit(pos):
-		score -= 60.0
-	elif _makes_route_too_narrow(pos):
-		score -= 20.0
-
-	# RepetitionPenalty
-	if _was_recently_targeted(pos):
-		score -= 30.0
-	elif _region_targeted_repeatedly(pos):
-		score -= 15.0
-
-	return score
-```
-
----
-
-### 3.8 Weighted Cell Selection — `_select_cells_weighted()`
-
-**New method.** Selects cells using weighted randomness from scored candidates.
-
-```gdscript
-func _select_cells_weighted(candidates: Array, count: int) -> Array[Vector2i]:
-	# Sort by score descending
-	candidates.sort_custom(func(a, b): return a.score > b.score)
-	# Build weight array
-	var weights: Array[float] = []
-	var total_weight: float = 0.0
-	for c in candidates:
-		var w = maxf(c.score + 100.0, 1.0)  # Offset to ensure positive weights
-		weights.append(w)
-		total_weight += w
-	# Weighted random selection without replacement
-	var selected: Array[Vector2i] = []
-	var available = candidates.duplicate()
-	var available_weights = weights.duplicate()
-	for i in range mini(count, available.size()):
-		var roll = randf() * total_weight
-		var cumulative = 0.0
-		for j in range(available.size()):
-			cumulative += available_weights[j]
-			if roll <= cumulative:
-				selected.append(available[j].pos)
-				total_weight -= available_weights[j]
-				available.remove_at(j)
-				available_weights.remove_at(j)
-				break
-	return selected
-```
-
----
-
-### 3.9 Candy Bubble System
-
-#### Bubble Spawn Timer
-
-```gdscript
-func _process_bubbles(delta: float):
-	if not multiplayer.is_server():
-		return
-	# Tick active bubbles
-	for i in range(active_bubbles.size() - 1, -1, -1):
-		var bubble = active_bubbles[i]
-		bubble.grow_timer -= delta
-		if bubble.grow_timer <= 0:
-			_explode_bubble(bubble)
-			active_bubbles.remove_at(i)
-```
-
-#### Bubble Spawn Logic
-
-```gdscript
-func _try_spawn_bubble():
-	var max_bubbles = max_bubbles_per_phase[current_phase]
-	if bubbles_this_phase >= max_bubbles:
-		return
-	var candidates = _generate_bubble_candidates()
-	if candidates.is_empty():
-		return
-	# Weighted selection
-	var selected = _select_bubble_target(candidates)
-	_spawn_bubble(selected)
-	bubbles_this_phase += 1
-```
-
-#### Bubble Candidate Scoring
-
-```gdscript
-func _generate_bubble_candidates() -> Array:
-	var candidates: Array = []
-	var players = get_tree().get_nodes_in_group("Players")
-	for x in range(ARENA_SIZE):
-		for z in range(ARENA_SIZE):
-			var pos = Vector2i(x, z)
-			if not _is_cell_valid_for_bubble(pos):
-				continue
-			var score = _calculate_bubble_score(pos, players)
-			candidates.append({"pos": pos, "score": score})
-	return candidates
-
-func _calculate_bubble_score(pos: Vector2i, players: Array) -> float:
-	var score: float = 0.0
-
-	# CampingScore
-	for pid in camping_tracker:
-		var camp = camping_tracker[pid]
-		if pos.distance_to(camp.position) <= 4:
-			var camp_duration = elapsed_time - camp.since
-			if camp_duration > 10.0 and player_cleansers.get(pid, 0) > 0:
-				score += 80.0
-			elif camp_duration > 8.0:
-				score += 60.0
-			elif camp_duration > 5.0:
-				score += 40.0
-
-	# UntouchedAreaScore
-	if _is_near_untouched_cluster(pos):
-		score += 30.0
-
-	# PlayerClusterScore
-	var nearby_players = 0
-	for p in players:
-		var p_pos = Vector2i(p.position.x, p.position.z)
-		if pos.distance_to(p_pos) <= 5:
-			nearby_players += 1
-	if nearby_players >= 2:
-		score += 20.0
-
-	# MissionRouteScore
-	if _is_important_for_scoring(pos):
-		score += randf_range(10.0, 20.0)
-
-	# RandomNoise
-	score += randf_range(-20.0, 20.0)
-
-	# DirectHitPenalty
-	for p in players:
-		var p_pos = Vector2i(p.position.x, p.position.z)
-		if pos == p_pos:
-			score -= 60.0
-			break
-
-	# RecentBubblePenalty
-	for recent in recent_bubble_positions:
-		if pos.distance_to(recent) <= 5:
-			score -= 50.0
-			break
-
-	# UnfairTrapPenalty
-	if _would_create_unfair_trap(pos):
-		score -= 100.0
-
-	return score
-```
-
-#### Bubble Explosion
-
-```gdscript
-func _explode_bubble(bubble: Dictionary):
-	var center = bubble.center
-	var explosion_area: Array[Vector2i] = []
-	for dx in range(-1, 2):
-		for dz in range(-1, 2):
-			var pos = Vector2i(center.x + dx, center.y + dz)
-			if _is_cell_valid_for_growth(pos):
-				explosion_area.append(pos)
-	# Telegraph 3×3 area briefly, then apply sticky
-	_telegraph_cells(explosion_area)
-	get_tree().create_timer(0.5).timeout.connect(func():
-		_apply_sticky_cells(explosion_area)
-		rpc("sync_bubble_explode", center, explosion_area)
-		recent_bubble_positions.append(center)
-		if recent_bubble_positions.size() > 5:
-			recent_bubble_positions.remove_at(0)
-	)
-	rpc("sync_bubble_explode_vfx", center)
-```
-
----
-
-### 3.10 Movement Buffer System
-
-#### Buffer Detection
-
-```gdscript
-func _detect_movement_buffers():
-	# Find all connected clusters of SAFE cells
-	var visited: Dictionary = {}
-	var clusters: Array = []
-	for x in range(ARENA_SIZE):
-		for z in range(ARENA_SIZE):
-			var pos = Vector2i(x, z)
-			if visited.has(pos) or not _is_cell_safe(pos):
-				continue
-			var cluster = _flood_fill_safe_cluster(pos, visited)
-			clusters.append(cluster)
-	# Apply buffer penalties to clusters that are critical for movement
-	for cluster in clusters:
-		if _is_critical_for_movement(cluster):
-			for pos in cluster:
-				if not movement_buffers.has(pos):
-					movement_buffers[pos] = {"penalty": 1.0, "created_at": elapsed_time}
-```
-
-#### Buffer Decay
-
-```gdscript
-func _decay_movement_buffers():
-	var to_remove: Array = []
-	for pos in movement_buffers:
-		var buffer = movement_buffers[pos]
-		# Every 5 seconds: reduce penalty by 25%
-		var age = elapsed_time - buffer.created_at
-		var decay_cycles = int(age / 5.0)
-		buffer.penalty *= pow(0.75, decay_cycles)
-		# Phase change: reduce by 50%
-		# (Applied once at phase transition, tracked separately)
-		# Final 30s: remove most
-		if elapsed_time > 150.0:
-			buffer.penalty *= 0.1
-		if buffer.penalty < 0.05:
-			to_remove.append(pos)
-	for pos in to_remove:
-		movement_buffers.erase(pos)
-```
-
-#### Camping Detection
-
-```gdscript
-func _update_camping_tracker():
-	var players = get_tree().get_nodes_in_group("Players")
-	for p in players:
-		var pid = p.get_multiplayer_authority()
-		var p_pos = Vector2i(p.position.x, p.position.z)
-		if camping_tracker.has(pid):
-			var camp = camping_tracker[pid]
-			if p_pos == camp.position:
-				pass  # Still camping
-			else:
-				camping_tracker[pid] = {"position": p_pos, "since": elapsed_time}
-		else:
-			camping_tracker[pid] = {"position": p_pos, "since": elapsed_time}
-```
-
----
-
-### 3.11 Sticky Cell Application
-
-```gdscript
-func _apply_sticky_cells(positions: Array[Vector2i]):
-	for pos in positions:
-		if not _is_cell_valid_for_growth(pos):
-			continue
-		sticky_cells[pos] = true
-		telegraphed_cells.erase(pos)
-		# Set Layer 2 overlay
-		enhanced_gridmap.set_cell_item(Vector3i(pos.x, 2, pos.y), TILE_STICKY)
-		# Check if any player is now on sticky
-		_check_players_on_sticky()
-	# Update A* costs
-	enhanced_gridmap.update_astar_costs()
-	# Sync to clients
-	rpc("sync_sticky_cells", sticky_cells.keys())
-```
-
----
-
-### 3.12 Player Sticky Check
-
-```gdscript
-func _check_players_on_sticky():
-	var players = get_tree().get_nodes_in_group("Players")
-	for p in players:
-		var p_pos = Vector2i(p.position.x, p.position.z)
-		if sticky_cells.has(p_pos):
-			var pid = p.get_multiplayer_authority()
-			if is_cleanser_active(pid):
-				clear_sticky_cell(p_pos)
-				use_cleanser_cell(pid)
-			else:
-				_trap_player(p)
-```
-
----
-
-### 3.13 Path Safety Check
-
-```gdscript
-func _apply_path_safety(selected: Array[Vector2i]) -> Array[Vector2i]:
-	if elapsed_time > 150.0:  # Final 30s: softer rules
-		return selected
-	var players = get_tree().get_nodes_in_group("Players")
-	var result = selected.duplicate()
-	for p in players:
-		var pid = p.get_multiplayer_authority()
-		if trapped_players.has(pid):
-			continue
-		var p_pos = Vector2i(p.position.x, p.position.z)
-		# Temporarily apply selected cells
-		var temp_sticky = sticky_cells.duplicate()
-		for pos in result:
-			temp_sticky[pos] = true
-		# Check if player has reachable safe cells within 6–8 cells
-		var has_escape = _has_reachable_safe_cell(p_pos, temp_sticky, 8)
-		if not has_escape:
-			# Replace some cells with safer alternatives
-			result = _replace_with_safer_candidates(result, 2)
-	return result
-```
-
----
-
-### 3.14 Telegraph System (Modified)
-
-The existing telegraph system works but needs adaptation for growth ticks instead of cannon volleys.
-
-```gdscript
-func _telegraph_cells(positions: Array[Vector2i]):
-	for pos in positions:
-		telegraphed_cells[pos] = true
-		enhanced_gridmap.set_cell_item(Vector3i(pos.x, 2, pos.y), TILE_TELEGRAPH)
-	rpc("sync_growth_telegraph", positions)
-	# Animate telegraph
-	_animate_growth_telegraph(positions)
-```
-
-**Reuse existing** `_animate_telegraph()` tween pattern from current GauntletManager.
-
----
-
-### 3.15 Network Sync
-
-| Data | Sync Method | Pattern |
-|---|---|---|
-| Sticky cells | `rpc("sync_sticky_cells", positions)` | Same as `sync_grid_item` |
-| Growth telegraph | `rpc("sync_growth_telegraph", positions)` | Same as `sync_telegraph` |
-| Phase changes | `rpc("sync_gauntlet_phase", phase_idx, elapsed)` | Same as `sync_phase` |
-| Bubble spawn | `rpc("sync_bubble_spawn", center, grow_duration)` | New RPC |
-| Bubble explode | `rpc("sync_bubble_explode", center, area)` | New RPC |
-| Trap state | `player.rpc("sync_trapped", true)` | Same as `sync_stop_freeze` |
-| Cleanser grant | `rpc("sync_cleanser", peer_id, count)` | Same as `sync_goal_count` |
-| Smack state | `player.rpc("sync_smack_state", charged)` | Same as `sync_modulate` |
-
----
-
-### 3.16 Integration Points in `main.gd`
-
-The existing integration in `main.gd` already handles GauntletManager. No changes needed unless the mode name string is updated.
-
----
-
-## 4. New Files Summary
-
-| File | Type | Purpose |
-|---|---|---|
-| (none) | — | All changes are modifications to existing `gauntlet_manager.gd` |
-
-## 5. Modified Files Summary
-
-| File | Changes |
-|---|---|
-| `scripts/managers/gauntlet_manager.gd` | **Major rewrite:** Replace cannon system with growth tick system, add candidate scoring, add candy bubble system, add movement buffer system, add layer calculation, change arena to 24×24 |
-| `scripts/game_mode.gd` | Optionally rename string to `"Candy Pump Survival"` |
-| `scripts/managers/lobby_manager.gd` | Optionally rename mode string; update settings (remove cannon_interval, volley_size; add growth_interval, cells_per_tick) |
-| `scripts/mode_config.gd` | Update schema: remove `gauntlet_cannon_interval`, `gauntlet_volley_size`; add `gauntlet_growth_interval`, `gauntlet_cells_per_tick_phase1/2/3` |
-| `scenes/main.gd` | Update mode string match if renamed |
-
----
-
-## 6. Helper Methods Required
-
-These utility methods need to be added to `gauntlet_manager.gd`:
-
-```gdscript
-# Cell validation
-func _is_cell_valid_for_growth(pos: Vector2i) -> bool
-func _is_cell_valid_for_bubble(pos: Vector2i) -> bool
-func _is_cell_safe(pos: Vector2i) -> bool
-
-# Neighbor queries
-func _get_8_neighbors(pos: Vector2i) -> Array[Vector2i]
-func _flood_fill_safe_cluster(start: Vector2i, visited: Dictionary) -> Array[Vector2i]
-
-# Cluster analysis
-func _expands_sticky_cluster(pos: Vector2i) -> bool
-func _connects_sticky_clusters(pos: Vector2i) -> bool
-func _is_near_untouched_cluster(pos: Vector2i) -> bool
-func _is_critical_for_movement(cluster: Array) -> bool
-
-# Route analysis
-func _is_high_traffic_route(pos: Vector2i) -> bool
-func _is_important_for_scoring(pos: Vector2i) -> bool
-func _would_trap_player(pos: Vector2i) -> bool
-func _removes_last_exit(pos: Vector2i) -> bool
-func _makes_route_too_narrow(pos: Vector2i) -> bool
-func _would_create_unfair_trap(pos: Vector2i) -> bool
-func _has_reachable_safe_cell(from: Vector2i, temp_sticky: Dictionary, radius: int) -> bool
-
-# Repetition tracking
-func _was_recently_targeted(pos: Vector2i) -> bool
-func _region_targeted_repeatedly(pos: Vector2i) -> bool
-
-# Bubble helpers
-func _select_bubble_target(candidates: Array) -> Vector2i
-func _replace_with_safer_candidates(selected: Array[Vector2i], count: int) -> Array[Vector2i]
-```
-
----
-
-## 7. Implementation Priority (Recommended Order)
-
-1. **Update arena to 24×24** — Modify `_setup_arena()`, update `NPC_CENTER`, update `_build_arena_layers()`
-2. **Replace cannon with growth tick** — Remove `_fire_volley()`, add `_process_growth_tick()`, `_generate_candidates()`, `_calculate_candidate_score()`
-3. **Weighted cell selection** — `_select_cells_weighted()`, sticky application, A* cost update
-4. **Movement buffer system** — `_detect_movement_buffers()`, `_decay_movement_buffers()`, buffer penalty in scoring
-5. **Path safety check** — `_apply_path_safety()`, `_has_reachable_safe_cell()`, replace unsafe selections
-6. **Candy bubble system** — Bubble timer, `_try_spawn_bubble()`, bubble scoring, `_explode_bubble()`
-7. **Camping detection** — `_update_camping_tracker()`, camping score in candidate and bubble scoring
-8. **Update HUD** — Growth tick indicator, bubble warning, phase label
-9. **Network sync** — New RPCs for growth telegraph, bubble spawn/explode
-10. **Bot AI** — Sticky avoidance, pathfinding through sticky, cleanser usage
-11. **Polish** — VFX for growth ticks, bubble animations, screen shake on explosion, sound effects
-12. **Update lobby settings** — Replace cannon/volley settings with growth settings in `lobby_manager.gd` and `mode_config.gd`
-
----
-
-## 8. Risk Assessment
-
-| Risk | Mitigation |
-|---|---|
-| GridMap Layer 2 conflict with existing freeze/safe overlays | Gauntlet mode is exclusive — no freeze/safe tiles in this mode |
-| 24×24 grid performance (576 cells + scoring every 3s) | Scoring runs on server only; candidate list is max 567 cells; weighted selection is O(n log n) |
-| Movement buffer creating invisible safe zones that feel unfair | Buffers decay aggressively; camping override removes them; final 30s removes most; players experience it as "uneven growth" not "protected zones" |
-| Path safety check preventing any arena pressure | Only triggers when a player would be fully trapped; final 30s disables strict check |
-| Bubble stacking creating unavoidable traps | RecentBubblePenalty (-50) prevents nearby bubbles; max 5 per round; UnfairTrapPenalty (-100) prevents instant failures |
-| Candidate scoring feeling too complex to tune | Start with simple weights; each component is independent and tunable; playtest to adjust |
-| A* pathfinding cost updates every 3s causing lag | `update_astar_costs()` is lightweight (updates existing AStar2D); only runs on server |

docs/gauntlet-visualization.html

@@ -1,1209 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Candy Pump Survival — Gameplay Visualization</title>
-<style>
-  * { margin: 0; padding: 0; box-sizing: border-box; }
-  body {
-    background: #1a1a2e;
-    color: #eee;
-    font-family: 'Segoe UI', system-ui, sans-serif;
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    min-height: 100vh;
-    overflow-x: hidden;
-  }
-  h1 {
-    margin: 12px 0 4px;
-    font-size: 22px;
-    color: #ff99cc;
-    text-shadow: 0 0 12px #ff66b288;
-    letter-spacing: 1px;
-  }
-  .subtitle {
-    font-size: 12px;
-    color: #888;
-    margin-bottom: 8px;
-  }
-  #top-bar {
-    display: flex;
-    gap: 24px;
-    align-items: center;
-    margin-bottom: 6px;
-    flex-wrap: wrap;
-    justify-content: center;
-  }
-  .stat-box {
-    background: #16213e;
-    border: 1px solid #333;
-    border-radius: 8px;
-    padding: 6px 14px;
-    text-align: center;
-    min-width: 90px;
-  }
-  .stat-box .label { font-size: 10px; color: #888; text-transform: uppercase; }
-  .stat-box .value { font-size: 22px; font-weight: bold; }
-  .stat-box .value.timer { color: #ffcc33; }
-  .stat-box .value.phase1 { color: #ff99cc; }
-  .stat-box .value.phase2 { color: #ffcc33; }
-  .stat-box .value.phase3 { color: #ff4d4d; }
-  .stat-box .value.score { color: #61ff54; }
-  .stat-box .value.sticky { color: #ff66b2; }
-
-  #game-container {
-    position: relative;
-    display: flex;
-    gap: 12px;
-    align-items: flex-start;
-  }
-  canvas {
-    border: 2px solid #333;
-    border-radius: 4px;
-    cursor: crosshair;
-  }
-  #sidebar {
-    width: 200px;
-    display: flex;
-    flex-direction: column;
-    gap: 8px;
-  }
-  .panel {
-    background: #16213e;
-    border: 1px solid #333;
-    border-radius: 8px;
-    padding: 10px;
-  }
-  .panel h3 {
-    font-size: 12px;
-    color: #ff99cc;
-    text-transform: uppercase;
-    margin-bottom: 6px;
-    border-bottom: 1px solid #333;
-    padding-bottom: 4px;
-  }
-  .player-entry {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-    padding: 3px 0;
-    font-size: 13px;
-  }
-  .player-dot {
-    width: 12px;
-    height: 12px;
-    border-radius: 50%;
-    border: 2px solid #000;
-    flex-shrink: 0;
-  }
-  .player-name { flex: 1; }
-  .player-score { font-weight: bold; color: #61ff54; font-size: 15px; }
-
-  .legend {
-    display: flex;
-    flex-wrap: wrap;
-    gap: 6px;
-    margin-top: 4px;
-  }
-  .legend-item {
-    display: flex;
-    align-items: center;
-    gap: 4px;
-    font-size: 10px;
-    color: #aaa;
-  }
-  .legend-swatch {
-    width: 14px;
-    height: 14px;
-    border-radius: 3px;
-    border: 1px solid #555;
-  }
-
-  .controls {
-    font-size: 11px;
-    color: #666;
-    margin-top: 4px;
-    line-height: 1.6;
-  }
-  .controls kbd {
-    background: #222;
-    border: 1px solid #444;
-    border-radius: 3px;
-    padding: 1px 5px;
-    font-size: 10px;
-    color: #ccc;
-  }
-
-  #bottom-bar {
-    display: flex;
-    gap: 16px;
-    margin-top: 8px;
-    flex-wrap: wrap;
-    justify-content: center;
-  }
-  .log-entry {
-    font-size: 11px;
-    color: #888;
-    padding: 1px 0;
-  }
-  .log-entry.trap { color: #ff4d4d; }
-  .log-entry.cleanse { color: #66e6ff; }
-  .log-entry.bubble { color: #ff99cc; }
-  .log-entry.score { color: #61ff54; }
-  .log-entry.phase { color: #ffcc33; }
-</style>
-</head>
-<body>
-<h1>Candy Pump Survival</h1>
-<div class="subtitle">Gauntlet Mode — Gameplay Visualization</div>
-
-<div id="top-bar">
-  <div class="stat-box"><div class="label">Timer</div><div class="value timer" id="timer">3:00</div></div>
-  <div class="stat-box"><div class="label">Phase</div><div class="value phase1" id="phase-label">OUTER PRESSURE</div></div>
-  <div class="stat-box"><div class="label">Coverage</div><div class="value sticky" id="coverage">0%</div></div>
-  <div class="stat-box"><div class="label">Growth Tick</div><div class="value" id="tick-count" style="color:#ff99cc">0</div></div>
-  <div class="stat-box"><div class="label">Bubbles</div><div class="value" id="bubble-count" style="color:#ff66cc">0</div></div>
-</div>
-
-<div id="game-container">
-  <canvas id="canvas"></canvas>
-  <div id="sidebar">
-    <div class="panel">
-      <h3>Players</h3>
-      <div id="player-list"></div>
-    </div>
-    <div class="panel">
-      <h3>Legend</h3>
-      <div class="legend">
-        <div class="legend-item"><div class="legend-swatch" style="background:#4f4f4f"></div>Safe</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#d6268a"></div>Sticky</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#e8a020"></div>Telegraph</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#ff5722"></div>Bubble</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#cc3380"></div>NPC</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#d10000"></div>Wall</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#66e6ff"></div>Cleansed</div>
-        <div class="legend-item"><div class="legend-swatch" style="background:#e8ba38"></div>Mission</div>
-      </div>
-    </div>
-    <div class="panel">
-      <h3>Controls</h3>
-      <div class="controls">
-        All 4 players are autonomous bots.<br>
-        <kbd>R</kbd> Restart simulation<br>
-        <kbd>P</kbd> Pause / resume<br>
-        <kbd>D</kbd> Toggle bot paths
-      </div>
-    </div>
-  </div>
-</div>
-
-<div id="bottom-bar">
-  <div class="panel" style="min-width:500px;max-width:700px">
-    <h3>Event Log</h3>
-    <div id="log" style="max-height:120px;overflow-y:auto;font-size:11px;"></div>
-  </div>
-</div>
-
-<script>
-// ── Constants ──
-const ARENA = 24;
-const NPC_CENTER = { x: 11, y: 11 };
-const NPC_SIZE = 3;
-const CELL_PX = 26;
-const WALL = 4, WALKABLE = 0, STICKY = 17, TELEGRAPH = 18, NPC_BLOCK = 5;
-const TOTAL_PLAYABLE = ARENA * ARENA - NPC_SIZE * NPC_SIZE;
-
-const PHASE_NAMES = ['OUTER PRESSURE', 'MIDDLE PRESSURE', 'INNER SURVIVAL'];
-const PHASE_CLASSES = ['phase1', 'phase2', 'phase3'];
-const PHASE_GROWTH = [
-  { min: 4, max: 6, bubbles: 0 },
-  { min: 6, max: 8, bubbles: 2 },
-  { min: 8, max: 10, bubbles: 3 },
-];
-
-const PLAYER_COLORS = ['#33cc33', '#4d80ff', '#ff9933', '#cc66ff'];
-const PLAYER_NAMES = ['Pip', 'Dabro', 'Gatot', 'Copper'];
-
-// ── Canvas ──
-const canvas = document.getElementById('canvas');
-const ctx = canvas.getContext('2d');
-canvas.width = ARENA * CELL_PX;
-canvas.height = ARENA * CELL_PX;
-
-// ── Game State ──
-let grid = [];          // 0=walkable, 4=wall, 5=npc, 17=sticky, 18=telegraph, 6=cleansed
-let cellScores = [];    // candidate scores for debug overlay
-let missionTiles = {};  // "x,y" -> true if has mission tile
-let players = [];
-let elapsed = 0;
-let paused = false;
-let growthTimer = 0;
-let totalTicks = 0;
-let bubblesSpawned = 0;
-let activeBubbles = [];  // {x, y, growTimer, maxGrow}
-let recentBubbles = [];
-let cleanserCount = [0, 0, 0, 0];
-let cleanserActive = [false, false, false, false];
-let cleanserCellsLeft = [0, 0, 0, 0];
-let trapped = [false, false, false, false];
-let scores = [0, 0, 0, 0];
-let missions = [0, 0, 0, 0];
-let logs = [];
-let currentPhase = 0;
-let showPaths = false;
-
-// ── Initialization ──
-function initGrid() {
-  grid = [];
-  cellScores = [];
-  for (let y = 0; y < ARENA; y++) {
-    grid[y] = [];
-    cellScores[y] = [];
-    for (let x = 0; x < ARENA; x++) {
-      // Walls on perimeter
-      if (x === 0 || y === 0 || x === ARENA - 1 || y === ARENA - 1) {
-        grid[y][x] = WALL;
-      }
-      // NPC center 3x3
-      else if (x >= NPC_CENTER.x - 1 && x <= NPC_CENTER.x + 1 &&
-               y >= NPC_CENTER.y - 1 && y <= NPC_CENTER.y + 1) {
-        grid[y][x] = NPC_BLOCK;
-      }
-      else {
-        grid[y][x] = WALKABLE;
-      }
-      cellScores[y][x] = 0;
-    }
-  }
-}
-
-function initMissionTiles() {
-  missionTiles = {};
-  for (let y = 1; y < ARENA - 1; y++) {
-    for (let x = 1; x < ARENA - 1; x++) {
-      if (grid[y][x] === WALKABLE) {
-        missionTiles[`${x},${y}`] = true;
-      }
-    }
-  }
-}
-
-function initPlayers() {
-  const spawns = [
-    { x: 2, y: 2 }, { x: ARENA - 3, y: 2 },
-    { x: 2, y: ARENA - 3 }, { x: ARENA - 3, y: ARENA - 3 }
-  ];
-  players = [];
-  for (let i = 0; i < 4; i++) {
-    players.push({
-      x: spawns[i].x, y: spawns[i].y,
-      targetX: spawns[i].x, targetY: spawns[i].y,
-      moving: false, moveProgress: 0,
-      startX: spawns[i].x, startY: spawns[i].y
-    });
-  }
-}
-
-function resetGame() {
-  elapsed = 0;
-  growthTimer = 0;
-  totalTicks = 0;
-  bubblesSpawned = 0;
-  activeBubbles = [];
-  recentBubbles = [];
-  currentPhase = 0;
-  cleanserCount = [0, 0, 0, 0];
-  cleanserActive = [false, false, false, false];
-  cleanserCellsLeft = [0, 0, 0, 0];
-  trapped = [false, false, false, false];
-  scores = [0, 0, 0, 0];
-  missions = [0, 0, 0, 0];
-  logs = [];
-  initGrid();
-  initMissionTiles();
-  initPlayers();
-  addLog('Game started! Collect tiles and survive the candy.', 'phase');
-  updateUI();
-}
-
-// ── Logging ──
-function addLog(msg, cls = '') {
-  logs.unshift({ msg, cls, time: formatTime(elapsed) });
-  if (logs.length > 50) logs.pop();
-  renderLog();
-}
-
-function renderLog() {
-  const el = document.getElementById('log');
-  el.innerHTML = logs.slice(0, 15).map(l =>
-    `<div class="log-entry ${l.cls}">[${l.time}] ${l.msg}</div>`
-  ).join('');
-}
-
-// ── Layer / Edge Distance ──
-function getLayer(x, y) {
-  const edge = Math.min(x, y, ARENA - 1 - x, ARENA - 1 - y);
-  if (edge <= 3) return 'outer';
-  if (edge <= 7) return 'middle';
-  return 'inner';
-}
-
-function getEdgeDistance(x, y) {
-  return Math.min(x, y, ARENA - 1 - x, ARENA - 1 - y);
-}
-
-// ── Candidate Scoring ──
-function isCellValidForGrowth(x, y) {
-  if (x < 0 || y < 0 || x >= ARENA || y >= ARENA) return false;
-  return grid[y][x] === WALKABLE || grid[y][x] === 6; // walkable or cleansed
-}
-
-function getNeighbors8(x, y) {
-  const n = [];
-  for (let dy = -1; dy <= 1; dy++) {
-    for (let dx = -1; dx <= 1; dx++) {
-      if (dx === 0 && dy === 0) continue;
-      const nx = x + dx, ny = y + dy;
-      if (nx >= 0 && ny >= 0 && nx < ARENA && ny < ARENA) n.push({ x: nx, y: ny });
-    }
-  }
-  return n;
-}
-
-function countStickyNeighbors(x, y) {
-  return getNeighbors8(x, y).filter(n => grid[n.y][n.x] === STICKY).length;
-}
-
-function expandsStickyCluster(x, y) {
-  const neighbors = getNeighbors8(x, y);
-  return neighbors.filter(n => grid[n.y][n.x] === STICKY).length >= 2;
-}
-
-function connectsStickyClusters(x, y) {
-  // Check if placing sticky here connects two separate sticky regions
-  const neighbors = getNeighbors8(x, y).filter(n => grid[n.y][n.x] === STICKY);
-  if (neighbors.length < 2) return false;
-  // Simple heuristic: multiple sticky neighbors from different directions
-  const dirs = neighbors.map(n => Math.atan2(n.y - y, n.x - x));
-  const uniqueDirs = new Set(dirs.map(d => Math.round(d * 10) / 10));
-  return uniqueDirs.size >= 3;
-}
-
-function distToCenter(x, y) {
-  return Math.sqrt((x - NPC_CENTER.x) ** 2 + (y - NPC_CENTER.y) ** 2);
-}
-
-function distToNearestPlayer(x, y) {
-  let minD = Infinity;
-  for (const p of players) {
-    if (!trapped[players.indexOf(p)]) {
-      const d = Math.sqrt((x - p.x) ** 2 + (y - p.y) ** 2);
-      if (d < minD) minD = d;
-    }
-  }
-  return minD;
-}
-
-function wouldTrapPlayer(x, y) {
-  // Simplified: check if any active player would have no safe neighbors
-  for (let i = 0; i < 4; i++) {
-    if (trapped[i]) continue;
-    const p = players[i];
-    const pdist = Math.sqrt((x - p.x) ** 2 + (y - p.y) ** 2);
-    if (pdist > 8) continue;
-    // Count safe neighbors of player
-    const safeNeighbors = getNeighbors8(Math.round(p.x), Math.round(p.y))
-      .filter(n => grid[n.y][n.x] === WALKABLE || grid[n.y][n.x] === 6);
-    if (safeNeighbors.length <= 1) return true;
-  }
-  return false;
-}
-
-function calculateCandidateScore(x, y) {
-  let score = 0;
-  const layer = getLayer(x, y);
-
-  // LayerPriority
-  const layerScores = [
-    { outer: 60, middle: 15, inner: -40 },
-    { outer: 20, middle: 60, inner: 5 },
-    { outer: 10, middle: 35, inner: 60 },
-  ];
-  score += layerScores[currentPhase][layer] || 0;
-
-  // StickyNeighborScore
-  score += countStickyNeighbors(x, y) * 8;
-
-  // InwardPressureScore
-  const centerDist = distToCenter(x, y);
-  const maxDist = distToCenter(1, 1);
-  const inwardRatio = 1 - centerDist / maxDist;
-  const inwardScores = [
-    [0, 10], [5, 20], [10, 30]
-  ];
-  score += inwardScores[currentPhase][0] + (inwardScores[currentPhase][1] - inwardScores[currentPhase][0]) * inwardRatio;
-
-  // PlayerPressureScore
-  const playerDist = distToNearestPlayer(x, y);
-  if (playerDist >= 2 && playerDist <= 4) score += 20;
-  else if (playerDist < 1) score += elapsed > 150 ? 10 : -50;
-
-  // ClusterGrowthScore
-  if (connectsStickyClusters(x, y)) score += 25;
-  else if (expandsStickyCluster(x, y)) score += 15;
-
-  // RandomNoise
-  score += (Math.random() * 40 - 20);
-
-  // PathSafetyPenalty
-  if (wouldTrapPlayer(x, y) && elapsed < 150) score -= 100;
-
-  // RepetitionPenalty (simplified)
-  const neighbors = getNeighbors8(x, y);
-  const recentTargets = neighbors.filter(n => grid[n.y][n.x] === TELEGRAPH);
-  if (recentTargets.length > 0) score -= 30;
-
-  return score;
-}
-
-// ── Growth Tick ──
-function processGrowthTick() {
-  const config = PHASE_GROWTH[currentPhase];
-  const cellCount = config.min + Math.floor(Math.random() * (config.max - config.min + 1));
-
-  // Generate candidates
-  const candidates = [];
-  for (let y = 1; y < ARENA - 1; y++) {
-    for (let x = 1; x < ARENA - 1; x++) {
-      if (!isCellValidForGrowth(x, y)) continue;
-      const score = calculateCandidateScore(x, y);
-      cellScores[y][x] = score;
-      candidates.push({ x, y, score: score + 100 }); // offset for positive weights
-    }
-  }
-
-  if (candidates.length === 0) return;
-
-  // Weighted random selection
-  candidates.sort((a, b) => b.score - a.score);
-  let totalWeight = candidates.reduce((s, c) => s + c.score, 0);
-  const selected = [];
-  const used = new Set();
-
-  for (let i = 0; i < Math.min(cellCount, candidates.length); i++) {
-    let roll = Math.random() * totalWeight;
-    let cumulative = 0;
-    for (const c of candidates) {
-      if (used.has(`${c.x},${c.y}`)) continue;
-      cumulative += c.score;
-      if (roll <= cumulative) {
-        selected.push(c);
-        used.add(`${c.x},${c.y}`);
-        totalWeight -= c.score;
-        break;
-      }
-    }
-  }
-
-  // Telegraph phase
-  for (const c of selected) {
-    grid[c.y][c.x] = TELEGRAPH;
-  }
-
-  totalTicks++;
-
-  // After telegraph delay, apply sticky
-  setTimeout(() => {
-    for (const c of selected) {
-      if (grid[c.y][c.x] === TELEGRAPH) {
-        grid[c.y][c.x] = STICKY;
-        // Check players on this cell
-        for (let i = 0; i < 4; i++) {
-          if (!trapped[i] && Math.round(players[i].x) === c.x && Math.round(players[i].y) === c.y) {
-            if (cleanserActive[i]) {
-              grid[c.y][c.x] = 6; // cleansed
-              cleanserCellsLeft[i]--;
-              if (cleanserCellsLeft[i] <= 0) {
-                cleanserActive[i] = false;
-                addLog(`${PLAYER_NAMES[i]}'s Cleanser wore off.`, 'cleanse');
-              }
-              addLog(`${PLAYER_NAMES[i]} cleansed a sticky cell!`, 'cleanse');
-            } else {
-              trapPlayer(i);
-            }
-          }
-        }
-      }
-    }
-    // Clear telegraph visuals after impact
-    setTimeout(() => {
-      for (const c of selected) {
-        if (grid[c.y][c.x] === TELEGRAPH) grid[c.y][c.x] = STICKY;
-      }
-      // Invalidate bot paths — grid changed
-      botPaths = [[], [], [], []];
-    }, 200);
-  }, 800);
-}
-
-// ── Candy Bubble System ──
-function trySpawnBubble() {
-  const config = PHASE_GROWTH[currentPhase];
-  if (bubblesSpawned >= config.bubbles) return;
-  if (Math.random() > 0.3) return; // chance per tick
-
-  // Find valid bubble candidates
-  const candidates = [];
-  for (let y = 3; y < ARENA - 3; y++) {
-    for (let x = 3; x < ARENA - 3; x++) {
-      if (!isCellValidForGrowth(x, y)) continue;
-      // Check 3x3 area is mostly clear
-      let clear = true;
-      for (let dy = -1; dy <= 1; dy++) {
-        for (let dx = -1; dx <= 1; dx++) {
-          if (!isCellValidForGrowth(x + dx, y + dy)) { clear = false; break; }
-        }
-        if (!clear) break;
-      }
-      if (!clear) continue;
-
-      // Camping bonus
-      let score = 30;
-      for (let i = 0; i < 4; i++) {
-        const pdist = Math.sqrt((x - players[i].x) ** 2 + (y - players[i].y) ** 2);
-        if (pdist < 1.5) score -= 60; // don't spawn on player
-        else if (pdist <= 4) score += 20;
-      }
-
-      // Recent bubble penalty
-      for (const rb of recentBubbles) {
-        if (Math.sqrt((x - rb.x) ** 2 + (y - rb.y) ** 2) < 5) {
-          score -= 50;
-          break;
-        }
-      }
-
-      // Untouched area bonus
-      const clusterSize = floodFillCount(x, y, new Set());
-      if (clusterSize > 10) score += 30;
-
-      score += Math.random() * 40 - 20;
-      candidates.push({ x, y, score });
-    }
-  }
-
-  if (candidates.length === 0) return;
-
-  candidates.sort((a, b) => b.score - a.score);
-  const target = candidates[0];
-
-  activeBubbles.push({
-    x: target.x, y: target.y,
-    growTimer: 2.5 + Math.random() * 0.5,
-    maxGrow: 2.5 + Math.random() * 0.5
-  });
-  bubblesSpawned++;
-  recentBubbles.push({ x: target.x, y: target.y });
-  if (recentBubbles.length > 8) recentBubbles.shift();
-  addLog(`Candy bubble appeared near (${target.x},${target.y})!`, 'bubble');
-}
-
-function floodFillCount(x, y, visited) {
-  const key = `${x},${y}`;
-  if (visited.has(key)) return 0;
-  if (!isCellValidForGrowth(x, y)) return 0;
-  visited.add(key);
-  let count = 1;
-  for (const n of getNeighbors8(x, y)) {
-    count += floodFillCount(n.x, n.y, visited);
-  }
-  return count;
-}
-
-function processBubbles(dt) {
-  for (let i = activeBubbles.length - 1; i >= 0; i--) {
-    const b = activeBubbles[i];
-    b.growTimer -= dt;
-    if (b.growTimer <= 0) {
-      // Explode into 3x3
-      for (let dy = -1; dy <= 1; dy++) {
-        for (let dx = -1; dx <= 1; dx++) {
-          const nx = b.x + dx, ny = b.y + dy;
-          if (isCellValidForGrowth(nx, ny)) {
-            grid[ny][nx] = STICKY;
-            // Check players
-            for (let j = 0; j < 4; j++) {
-              if (!trapped[j] && Math.round(players[j].x) === nx && Math.round(players[j].y) === ny) {
-                if (cleanserActive[j]) {
-                  grid[ny][nx] = 6;
-                  cleanserCellsLeft[j]--;
-                  if (cleanserCellsLeft[j] <= 0) {
-                    cleanserActive[j] = false;
-                    addLog(`${PLAYER_NAMES[j]}'s Cleanser wore off.`, 'cleanse');
-                  }
-                } else {
-                  trapPlayer(j);
-                }
-              }
-            }
-          }
-        }
-      }
-      addLog(`Bubble exploded at (${b.x},${b.y})!`, 'trap');
-      activeBubbles.splice(i, 1);
-      botPaths = [[], [], [], []];
-    }
-  }
-}
-
-// ── Player Actions ──
-function trapPlayer(idx) {
-  // Auto-use cleanser if available
-  if (cleanserCount[idx] > 0 && !cleanserActive[idx]) {
-    cleanserCount[idx]--;
-    cleanserActive[idx] = true;
-    cleanserCellsLeft[idx] = 5;
-    trapped[idx] = false;
-    addLog(`${PLAYER_NAMES[idx]} auto-activated Cleanser to escape!`, 'cleanse');
-    return;
-  }
-  trapped[idx] = true;
-  botPaths[idx] = [];
-  addLog(`${PLAYER_NAMES[idx]} is TRAPPED in sticky candy!`, 'trap');
-  scores[idx] = Math.max(0, scores[idx] - 50);
-}
-
-// ── Movement ──
-function canMoveTo(idx, x, y) {
-  if (x < 1 || y < 1 || x >= ARENA - 1 || y >= ARENA - 1) return false;
-  const cell = grid[y][x];
-  if (cell === WALL || cell === NPC_BLOCK) return false;
-  if (cell === STICKY && !cleanserActive[idx]) return false;
-  return true;
-}
-
-function movePlayerStep(idx, dx, dy) {
-  if (trapped[idx]) return;
-  const p = players[idx];
-  if (p.moving) return; // already moving
-  const nx = Math.round(p.x) + dx;
-  const ny = Math.round(p.y) + dy;
-  if (!canMoveTo(idx, nx, ny)) return;
-  p.startX = Math.round(p.x);
-  p.startY = Math.round(p.y);
-  p.targetX = nx;
-  p.targetY = ny;
-  p.moveProgress = 0;
-  p.moving = true;
-  p.moveDir = { dx, dy };
-}
-
-function updatePlayerMovement(dt) {
-  const speed = 10; // cells per second — fast and responsive
-  for (let i = 0; i < 4; i++) {
-    const p = players[i];
-    if (!p.moving) continue;
-    p.moveProgress += dt * speed;
-    if (p.moveProgress >= 1) {
-      p.x = p.targetX;
-      p.y = p.targetY;
-      p.moving = false;
-      p.moveProgress = 0;
-
-      // Collect mission tile
-      const key = `${Math.round(p.x)},${Math.round(p.y)}`;
-      if (missionTiles[key]) {
-        delete missionTiles[key];
-        missions[i]++;
-        scores[i] += 1000;
-        addLog(`${PLAYER_NAMES[i]} collected a mission tile! (${missions[i]} total)`, 'score');
-        if (missions[i] % 2 === 0 && cleanserCount[i] < 1) {
-          cleanserCount[i]++;
-          addLog(`${PLAYER_NAMES[i]} earned a Cleanser!`, 'cleanse');
-        }
-      }
-
-      // Check if landed on sticky
-      const gx = Math.round(p.x), gy = Math.round(p.y);
-      if (grid[gy][gx] === STICKY) {
-        if (cleanserActive[i]) {
-          grid[gy][gx] = 6; // cleansed
-          cleanserCellsLeft[i]--;
-          if (cleanserCellsLeft[i] <= 0) {
-            cleanserActive[i] = false;
-            addLog(`${PLAYER_NAMES[i]}'s Cleanser wore off.`, 'cleanse');
-          } else {
-            addLog(`${PLAYER_NAMES[i]} cleansed a cell (${cleanserCellsLeft[i]} left)`, 'cleanse');
-          }
-        } else {
-          trapPlayer(i);
-        }
-      }
-    } else {
-      p.x = p.startX + (p.targetX - p.startX) * p.moveProgress;
-      p.y = p.startY + (p.targetY - p.startY) * p.moveProgress;
-    }
-  }
-}
-
-// ── Phase Management ──
-function updatePhase() {
-  let newPhase = 0;
-  if (elapsed >= 120) newPhase = 2;
-  else if (elapsed >= 60) newPhase = 1;
-
-  if (newPhase !== currentPhase) {
-    currentPhase = newPhase;
-    addLog(`Phase changed: ${PHASE_NAMES[currentPhase]}`, 'phase');
-  }
-}
-
-// ── Cooldowns ──
-function updateCooldowns(_dt) {
-}
-
-// ── Bot AI ──
-let botTimers = [0, 0, 0, 0];
-let botPaths = [[], [], [], []];
-
-function isWalkable(x, y) {
-  if (x < 0 || y < 0 || x >= ARENA || y >= ARENA) return false;
-  const c = grid[y][x];
-  return c === WALKABLE || c === 6;
-}
-
-function astar(sx, sy, tx, ty) {
-  if (sx === tx && sy === ty) return [];
-  const k = (x, y) => `${x},${y}`;
-  const open = new Map();
-  const closed = new Set();
-  const h = (x, y) => Math.abs(x - tx) + Math.abs(y - ty);
-  open.set(k(sx, sy), { x: sx, y: sy, g: 0, f: h(sx, sy), p: null });
-
-  while (open.size > 0) {
-    let best = null;
-    for (const n of open.values()) {
-      if (!best || n.f < best.f || (n.f === best.f && n.g > best.g)) best = n;
-    }
-    if (best.x === tx && best.y === ty) {
-      const path = [];
-      let c = best;
-      while (c.p) { path.unshift({ x: c.x, y: c.y }); c = c.p; }
-      return path;
-    }
-    open.delete(k(best.x, best.y));
-    closed.add(k(best.x, best.y));
-
-    for (const [dx, dy] of [[0,-1],[0,1],[-1,0],[1,0]]) {
-      const nx = best.x + dx, ny = best.y + dy;
-      const nk = k(nx, ny);
-      if (closed.has(nk)) continue;
-      if (!(nx === tx && ny === ty) && !isWalkable(nx, ny)) continue;
-      const g = best.g + 1;
-      const ex = open.get(nk);
-      if (ex && g >= ex.g) continue;
-      open.set(nk, { x: nx, y: ny, g, f: g + h(nx, ny), p: best });
-    }
-  }
-  return [];
-}
-
-function findNearestMission(idx) {
-  const p = players[idx];
-  const cx = Math.round(p.x), cy = Math.round(p.y);
-  let best = null, bestDist = Infinity;
-  for (const key in missionTiles) {
-    const [mx, my] = key.split(',').map(Number);
-    const d = Math.abs(mx - cx) + Math.abs(my - cy);
-    if (d < bestDist) { bestDist = d; best = { x: mx, y: my }; }
-  }
-  return best;
-}
-
-function botStep(idx) {
-  if (trapped[idx]) return;
-  const p = players[idx];
-  if (p.moving) return;
-
-  const path = botPaths[idx];
-  if (path.length > 0) {
-    const next = path[0];
-    if (isWalkable(next.x, next.y)) {
-      movePlayerStep(idx, next.x - Math.round(p.x), next.y - Math.round(p.y));
-      if (!p.moving) {
-        path.shift();
-        // Stuck: couldn't move to next path node, invalidate
-        if (path.length > 0) botPaths[idx] = [];
-      }
-    } else {
-      path.shift();
-      botPaths[idx] = [];
-    }
-    return;
-  }
-
-  // Try A* to nearest mission
-  const target = findNearestMission(idx);
-  if (target) {
-    botPaths[idx] = astar(Math.round(p.x), Math.round(p.y), target.x, target.y);
-    if (botPaths[idx].length > 0) {
-      const next = botPaths[idx].shift();
-      movePlayerStep(idx, next.x - Math.round(p.x), next.y - Math.round(p.y));
-      return;
-    }
-  }
-
-  // FALLBACK: no path to any mission — move away from nearest sticky (survival)
-  escapeSticky(idx);
-}
-
-function escapeSticky(idx) {
-  const p = players[idx];
-  const cx = Math.round(p.x), cy = Math.round(p.y);
-  // Find nearest sticky cell
-  let nearestSticky = null, nearDist = Infinity;
-  for (let y = 0; y < ARENA; y++) {
-    for (let x = 0; x < ARENA; x++) {
-      if (grid[y][x] === STICKY) {
-        const d = Math.abs(x - cx) + Math.abs(y - cy);
-        if (d < nearDist) { nearDist = d; nearestSticky = { x, y }; }
-      }
-    }
-  }
-  if (!nearestSticky) return;
-  // Move away from sticky: try the direction opposite to it
-  const dx = Math.sign(cx - nearestSticky.x);
-  const dy = Math.sign(cy - nearestSticky.y);
-  const dirs = [[dx, 0], [0, dy], [-dx, 0], [0, -dy], [1, 0], [-1, 0], [0, 1], [0, -1]];
-  for (const [mx, my] of dirs) {
-    if (mx === 0 && my === 0) continue;
-    if (canMoveTo(idx, cx + mx, cy + my)) {
-      movePlayerStep(idx, mx, my);
-      return;
-    }
-  }
-}
-
-function updateBots(dt) {
-  for (let i = 0; i < 4; i++) {
-    botTimers[i] -= dt;
-    if (botTimers[i] <= 0) {
-      botStep(i);
-      botTimers[i] = 0.12;
-    }
-  }
-}
-
-// ── Scoring ──
-function updateScoring() {
-  // Survival bonus at end
-}
-
-// ── Rendering ──
-function draw() {
-  ctx.clearRect(0, 0, canvas.width, canvas.height);
-
-  for (let y = 0; y < ARENA; y++) {
-    for (let x = 0; x < ARENA; x++) {
-      const px = x * CELL_PX;
-      const py = y * CELL_PX;
-      const cell = grid[y][x];
-
-      // Base cell color
-      let color;
-      switch (cell) {
-        case WALKABLE: color = '#4f4f4f'; break;
-        case WALL: color = '#d10000'; break;
-        case NPC_BLOCK: color = '#cc3380'; break;
-        case STICKY: color = '#d6268a'; break;     // deep magenta — set candy
-        case TELEGRAPH: color = '#e8a020'; break;   // amber/syrup — warning glow
-        case 6: color = '#66e6ff'; break;           // cleansed
-        default: color = '#4f4f4f';
-      }
-
-      // Layer highlight based on current pressure
-      if (cell === WALKABLE || cell === 6) {
-        const layer = getLayer(x, y);
-        const targetLayer = currentPhase === 0 ? 'outer' : currentPhase === 1 ? 'middle' : 'inner';
-        if (layer === targetLayer) {
-          // Subtle highlight for current pressure layer
-          const r = parseInt(color.slice(1, 3), 16);
-          const g = parseInt(color.slice(3, 5), 16);
-          const b = parseInt(color.slice(5, 7), 16);
-          color = `rgb(${Math.min(255, r + 12)},${Math.min(255, g + 8)},${Math.min(255, b + 5)})`;
-        }
-      }
-
-      ctx.fillStyle = color;
-      ctx.fillRect(px, py, CELL_PX - 1, CELL_PX - 1);
-
-      // Draw grid lines
-      ctx.strokeStyle = '#222';
-      ctx.lineWidth = 0.5;
-      ctx.strokeRect(px, py, CELL_PX, CELL_PX);
-
-      // Mission tiles (fully fill cell)
-      if (missionTiles[`${x},${y}`] && (cell === WALKABLE || cell === 6)) {
-        ctx.fillStyle = '#e8ba38';
-        ctx.fillRect(px + 1, py + 1, CELL_PX - 2, CELL_PX - 2);
-        ctx.strokeStyle = '#b8901a';
-        ctx.lineWidth = 1;
-        ctx.strokeRect(px + 1, py + 1, CELL_PX - 2, CELL_PX - 2);
-        // Shine highlight
-        ctx.fillStyle = 'rgba(255,255,255,0.2)';
-        ctx.fillRect(px + 3, py + 3, (CELL_PX - 6) * 0.4, (CELL_PX - 6) * 0.35);
-      }
-
-      // Telegraph pulsing effect (amber/syrup glow)
-      if (cell === TELEGRAPH) {
-        const pulse = 0.35 + Math.sin(Date.now() / 120) * 0.3;
-        ctx.fillStyle = `rgba(232,160,32,${pulse})`;
-        ctx.fillRect(px, py, CELL_PX - 1, CELL_PX - 1);
-      }
-    }
-  }
-
-  // Draw layer borders (subtle)
-  for (let y = 1; y < ARENA - 1; y++) {
-    for (let x = 1; x < ARENA - 1; x++) {
-      if (getEdgeDistance(x, y) === 4 || getEdgeDistance(x, y) === 8) {
-        const px = x * CELL_PX;
-        const py = y * CELL_PX;
-        ctx.strokeStyle = 'rgba(255,255,255,0.08)';
-        ctx.lineWidth = 1;
-        ctx.beginPath();
-        ctx.moveTo(px, py);
-        ctx.lineTo(px, py + CELL_PX);
-        ctx.stroke();
-      }
-    }
-  }
-
-  // Draw active bubbles (hot orange-red)
-  for (const b of activeBubbles) {
-    const px = b.x * CELL_PX;
-    const py = b.y * CELL_PX;
-    const progress = 1 - b.growTimer / b.maxGrow;
-    const size = CELL_PX * (0.3 + progress * 0.7);
-
-    // Warning 3x3 area
-    if (progress > 0.5) {
-      ctx.fillStyle = `rgba(255,87,34,${(progress - 0.5) * 0.25})`;
-      for (let dy = -1; dy <= 1; dy++) {
-        for (let dx = -1; dx <= 1; dx++) {
-          ctx.fillRect((b.x + dx) * CELL_PX, (b.y + dy) * CELL_PX, CELL_PX - 1, CELL_PX - 1);
-        }
-      }
-    }
-
-    // Bubble itself
-    ctx.fillStyle = `rgba(255,87,34,${0.6 + progress * 0.4})`;
-    ctx.beginPath();
-    ctx.arc(px + CELL_PX / 2, py + CELL_PX / 2, size / 2, 0, Math.PI * 2);
-    ctx.fill();
-    ctx.strokeStyle = '#ff8a50';
-    ctx.lineWidth = 2;
-    ctx.stroke();
-
-    // Pulse ring
-    if (progress > 0.7) {
-      const pulseSize = size * (1 + Math.sin(Date.now() / 80) * 0.2);
-      ctx.strokeStyle = `rgba(255,138,80,${0.5})`;
-      ctx.lineWidth = 1;
-      ctx.beginPath();
-      ctx.arc(px + CELL_PX / 2, py + CELL_PX / 2, pulseSize / 2 + 4, 0, Math.PI * 2);
-      ctx.stroke();
-    }
-  }
-
-  // Draw players
-  for (let i = 0; i < 4; i++) {
-    const p = players[i];
-    const px = p.x * CELL_PX + CELL_PX / 2;
-    const py = p.y * CELL_PX + CELL_PX / 2;
-    const radius = CELL_PX / 2.5;
-
-    // Player body
-    ctx.fillStyle = trapped[i] ? '#666' : PLAYER_COLORS[i];
-    ctx.beginPath();
-    ctx.arc(px, py, radius, 0, Math.PI * 2);
-    ctx.fill();
-
-    // Trapped overlay
-    if (trapped[i]) {
-      ctx.strokeStyle = '#ff4d4d';
-      ctx.lineWidth = 2;
-      ctx.setLineDash([3, 3]);
-      ctx.beginPath();
-      ctx.arc(px, py, radius + 2, 0, Math.PI * 2);
-      ctx.stroke();
-      ctx.setLineDash([]);
-      // Trapped X
-      ctx.strokeStyle = '#ff4d4d';
-      ctx.lineWidth = 2;
-      ctx.beginPath();
-      ctx.moveTo(px - 4, py - 4);
-      ctx.lineTo(px + 4, py + 4);
-      ctx.moveTo(px + 4, py - 4);
-      ctx.lineTo(px - 4, py + 4);
-      ctx.stroke();
-    }
-
-    // Cleanser active indicator
-    if (cleanserActive[i]) {
-      ctx.strokeStyle = '#66e6ff';
-      ctx.lineWidth = 2;
-      ctx.setLineDash([4, 2]);
-      ctx.beginPath();
-      ctx.arc(px, py, radius + 8, 0, Math.PI * 2);
-      ctx.stroke();
-      ctx.setLineDash([]);
-    }
-
-    // Player name
-    ctx.fillStyle = '#fff';
-    ctx.font = 'bold 9px sans-serif';
-    ctx.textAlign = 'center';
-    ctx.fillText(PLAYER_NAMES[i], px, py - radius - 6);
-
-    // Score
-    ctx.fillStyle = '#61ff54';
-    ctx.font = '8px sans-serif';
-    ctx.fillText(Math.round(scores[i]), px, py + radius + 10);
-  }
-
-  // Draw bot paths (debug toggle with D)
-  if (showPaths) {
-    const pathColors = ['#33cc3355', '#4d80ff55', '#ff993355', '#cc66ff55'];
-    for (let i = 0; i < 4; i++) {
-      const path = botPaths[i];
-      if (path.length === 0) continue;
-      ctx.strokeStyle = pathColors[i];
-      ctx.lineWidth = 3;
-      ctx.setLineDash([4, 4]);
-      ctx.beginPath();
-      const sx = players[i].x * CELL_PX + CELL_PX / 2;
-      const sy = players[i].y * CELL_PX + CELL_PX / 2;
-      ctx.moveTo(sx, sy);
-      for (const node of path) {
-        ctx.lineTo(node.x * CELL_PX + CELL_PX / 2, node.y * CELL_PX + CELL_PX / 2);
-      }
-      ctx.stroke();
-      ctx.setLineDash([]);
-    }
-  }
-
-  // Draw NPC center marker
-  const npcPx = NPC_CENTER.x * CELL_PX + CELL_PX / 2;
-  const npcPy = NPC_CENTER.y * CELL_PX + CELL_PX / 2;
-  ctx.fillStyle = '#cc3380';
-  ctx.font = 'bold 14px sans-serif';
-  ctx.textAlign = 'center';
-  ctx.textBaseline = 'middle';
-  ctx.fillText('PUMP', npcPx, npcPy - 6);
-  ctx.font = '10px sans-serif';
-  ctx.fillText('NPC', npcPx, npcPy + 8);
-}
-
-// ── UI Updates ──
-function formatTime(t) {
-  const m = Math.floor(t / 60);
-  const s = Math.floor(t % 60);
-  return `${m}:${s.toString().padStart(2, '0')}`;
-}
-
-function updateUI() {
-  document.getElementById('timer').textContent = formatTime(180 - elapsed);
-
-  const phaseEl = document.getElementById('phase-label');
-  phaseEl.textContent = PHASE_NAMES[currentPhase];
-  phaseEl.className = 'value ' + PHASE_CLASSES[currentPhase];
-
-  const stickyCount = grid.flat().filter(c => c === STICKY).length;
-  const coverage = Math.round((stickyCount / TOTAL_PLAYABLE) * 100);
-  document.getElementById('coverage').textContent = coverage + '%';
-  document.getElementById('tick-count').textContent = totalTicks;
-  document.getElementById('bubble-count').textContent = bubblesSpawned;
-
-  // Player list
-  const listEl = document.getElementById('player-list');
-  listEl.innerHTML = players.map((p, i) => `
-    <div class="player-entry" style="opacity:${trapped[i] ? 0.5 : 1}">
-      <div class="player-dot" style="background:${PLAYER_COLORS[i]}"></div>
-      <span class="player-name">${PLAYER_NAMES[i]}</span>
-      <span class="player-score">${Math.round(scores[i])}</span>
-      <span class="player-missions">×${missions[i]}</span>
-    </div>
-  `).join('');
-}
-
-// ── Input ──
-document.addEventListener('keydown', (e) => {
-  switch (e.key) {
-    case 'r': case 'R': resetGame(); break;
-    case 'p': case 'P': paused = !paused; break;
-    case 'd': case 'D': showPaths = !showPaths; break;
-  }
-});
-
-// ── Game Loop ──
-let lastTime = 0;
-
-function gameLoop(timestamp) {
-  const dt = Math.min((timestamp - lastTime) / 1000, 0.1);
-  lastTime = timestamp;
-
-  if (!paused && elapsed < 180) {
-    elapsed += dt;
-
-    // Growth tick
-    growthTimer += dt;
-    if (growthTimer >= 3.0) {
-      growthTimer -= 3.0;
-      processGrowthTick();
-      trySpawnBubble();
-    }
-
-    // Bubbles
-    processBubbles(dt);
-
-    // Player movement
-    updatePlayerMovement(dt);
-
-    // Phase
-    updatePhase();
-
-    // Cooldowns
-    updateCooldowns(dt);
-
-    // Bot AI — all non-selected players auto-pathfind
-    updateBots(dt);
-
-    // Score decay for trapped players
-    for (let i = 0; i < 4; i++) {
-      if (trapped[i]) {
-        scores[i] = Math.max(0, scores[i] - dt * 2);
-      }
-    }
-
-    // Passive score for surviving
-    for (let i = 0; i < 4; i++) {
-      if (!trapped[i]) {
-        scores[i] += dt * 1;
-      }
-    }
-  }
-
-  draw();
-  if (Math.floor(elapsed * 4) % 2 === 0) updateUI(); // throttle UI updates
-  requestAnimationFrame(gameLoop);
-}
-
-// ── Start ──
-resetGame();
-requestAnimationFrame(gameLoop);
-</script>
-</body>
-</html>

docs/rpc_migration_audit.md

@@ -1,89 +0,0 @@
-# Nakama JS → Lua Migration Audit
-
-## JS RPC Registration (core.js.bak lines 12-72)
-
-| # | JS RPC Name | JS Function | Lua Module | Lua RPC Name | Status |
-|---|---|---|---|---|---|
-| 1 | `admin_kick_player` | `rpcAdminKickPlayer` | admin.lua | `lua_admin_kick_player` | ✅ |
-| 2 | `admin_ban_player` | `rpcAdminBanPlayer` | admin.lua | `lua_admin_ban_player` | ✅ |
-| 3 | `admin_unban_player` | `rpcAdminUnbanPlayer` | admin.lua | `lua_admin_unban_player` | ✅ |
-| 4 | `admin_get_ban_list` | `rpcAdminGetBanList` | admin.lua | `lua_admin_get_ban_list` | ✅ |
-| 5 | `admin_get_server_stats` | `rpcAdminGetServerStats` | admin.lua | `lua_admin_get_server_stats` | ✅ |
-| 6 | `admin_get_player_list` | `rpcAdminGetPlayerList` | admin.lua | `lua_admin_get_player_list` | ✅ Fixed |
-| 7 | `admin_end_match` | `rpcAdminEndMatch` | admin.lua | `lua_admin_end_match` | ✅ |
-| 8 | `admin_set_user_role` | `rpcAdminSetUserRole` | admin.lua | `lua_admin_set_user_role` | ✅ |
-| 9 | `admin_list_users` | `rpcAdminListUsers` | admin.lua | `lua_admin_list_users` | ✅ |
-| 10 | `admin_delete_users` | `rpcAdminDeleteUsers` | admin.lua | `lua_admin_delete_users` | ✅ Bug fixed |
-| 11 | `admin_topup_gold` | `rpcAdminTopupGold` | admin.lua | `lua_admin_topup_gold` | ✅ |
-| 12 | `admin_clear_global_chat` | `rpcAdminClearGlobalChat` | admin.lua | `lua_admin_clear_global_chat` | ✅ |
-| 13 | `get_user_profile` | `rpcGetUserProfile` | user.lua | `lua_get_user_profile` | ✅ |
-| 14 | `update_user_profile` | `rpcUpdateUserProfile` | user.lua | `lua_update_user_profile` | ✅ |
-| 15 | `search_users` | `rpcSearchUsers` | user.lua | `lua_search_users` | ✅ |
-| 16 | `get_leaderboard_stats` | `rpcGetLeaderboardStats` | leaderboard.lua | `lua_get_leaderboard_stats` | ✅ |
-| 17 | `admin_update_stats` | `rpcAdminUpdateStats` | leaderboard.lua | `lua_admin_update_stats` | ✅ |
-| 18 | `admin_delete_stats` | `rpcAdminDeleteStats` | leaderboard.lua | `lua_admin_delete_stats` | ✅ |
-| 19 | `admin_sync_leaderboard` | `rpcAdminSyncLeaderboard` | leaderboard.lua | `lua_admin_sync_leaderboard` | ✅ |
-| 20 | `submit_score` | `rpcSubmitScore` | leaderboard.lua | `lua_submit_score` | ✅ |
-| 21 | `sync_leaderboard` | `rpcSyncLeaderboard` | leaderboard.lua | `lua_sync_leaderboard` | ✅ |
-| 22 | `change_credentials` | `rpcChangeCredentials` | user.lua | `lua_change_credentials` | ✅ |
-| 23 | `reset_stats` | `rpcResetStats` | leaderboard.lua | `lua_reset_stats` | ✅ |
-| 24 | `send_lobby_invite` | `rpcSendLobbyInvite` | user.lua | `lua_send_lobby_invite` | ✅ |
-| 25 | `send_friend_request` | `rpcSendFriendRequest` | user.lua | `lua_send_friend_request` | ✅ |
-| 26 | `claim_daily_reward` | `rpcClaimDailyReward` | daily_rewards.lua | `lua_claim_daily_reward` | ✅ |
-| 27 | `get_daily_reward_state` | `rpcGetDailyRewardState` | daily_rewards.lua | `lua_get_daily_reward_state` | ✅ |
-| 28 | `set_daily_reward_config` | `rpcSetDailyRewardConfig` | daily_rewards.lua | `lua_set_daily_reward_config` | ✅ |
-| 29 | `get_daily_reward_config_admin` | `rpcGetDailyRewardConfigAdmin` | daily_rewards.lua | `lua_get_daily_reward_config_admin` | ✅ |
-| 30 | `admin_send_mail` | `rpcAdminSendMail` | inbox.lua | `lua_admin_send_mail` | ✅ |
-| 31 | `admin_list_mail` | `rpcAdminListMail` | inbox.lua | `lua_admin_list_mail` | ✅ |
-| 32 | `admin_update_mail` | `rpcAdminUpdateMail` | inbox.lua | `lua_admin_update_mail` | ✅ |
-| 33 | `admin_delete_mail_server` | `rpcAdminDeleteMailServer` | inbox.lua | `lua_admin_delete_mail_server` | ✅ |
-| 34 | `get_mail` | `rpcGetMail` | inbox.lua | `lua_get_mail` | ✅ |
-| 35 | `claim_mail_reward` | `rpcClaimMailReward` | inbox.lua | `lua_claim_mail_reward` | ✅ |
-| 36 | `delete_mail` | `rpcDeleteMail` | inbox.lua | `lua_delete_mail` | ✅ |
-| 37 | `save_mail_state` | `rpcSaveMailState` | inbox.lua | `lua_save_mail_state` | ✅ |
-| 38 | `purchase_item` | `rpcPurchaseItem` | economy.lua | `lua_purchase_item` | ✅ |
-| 39 | `get_shop_catalog` | `rpcGetShopCatalog` | economy.lua | `lua_get_shop_catalog` | ✅ |
-| 40 | `buy_currency` | `rpcBuyCurrency` | economy.lua | `lua_buy_currency` | ✅ |
-| 41 | `admin_set_featured_banners` | `rpcAdminSetFeaturedBanners` | economy.lua | `lua_admin_set_featured_banners` | ✅ |
-| 42 | `admin_get_featured_banners` | `rpcAdminGetFeaturedBanners` | economy.lua | `lua_admin_get_featured_banners` | ✅ |
-
-## Hooks
-
-| JS Hook | JS Function | Lua Module | Status |
-|---|---|---|---|
-| `registerAfterAuthenticateSteam` | `afterAuthenticateSteam` | core.lua | ✅ Fixed |
-
-## Non-RPC Items
-
-| Item | Lua Module | Status |
-|---|---|---|
-| `leaderboardCreate("global_high_score")` | core.lua | ✅ |
-| `ADMIN_ROLES` definition | utils.lua | ✅ |
-| `isAdmin` / `isMatchHost` helpers | utils.lua | ✅ |
-| `requireAdmin` | utils.lua | ✅ |
-| `requireAdminOrHost` | utils.lua | ✅ |
-
-## Bugs Fixed This Session
-
-1. **`admin_get_player_list` RPC was missing** — Added to admin.lua
-2. **`afterAuthenticateSteam` hook was missing** — Added to core.lua via `nk.register_req_after`
-3. **`admin_delete_users` metadata bug** — `pcall(nk.json_decode, ...)` result was discarded, so the admin-role guard never worked. Fixed to assign decoded result.
-4. **`core.lua` had stale duplicate stubs** — Duplicate `rpc_get_user_profile` and `rpc_admin_kick_player` registrations conflicted with user.lua and admin.lua. Removed.
-
-## Final Module Map
-
-```
-server/nakama/
-├── main.lua              # Entrypoint - requires all modules
-├── lua/
-│   ├── utils.lua         # Shared helpers (is_admin, require_admin, etc.)
-│   ├── core.lua          # Steam auth hook + leaderboard creation
-│   ├── admin.lua         # 12 admin RPCs
-│   ├── user.lua          # 6 user RPCs
-│   ├── daily_rewards.lua # 4 daily reward RPCs
-│   ├── leaderboard.lua   # 7 leaderboard RPCs
-│   ├── inbox.lua         # 8 inbox/mail RPCs
-│   └── economy.lua       # 5 economy/shop RPCs
-```
-
-**Total: 42 RPCs + 1 auth hook = full 1:1 parity with core.js.bak** ✅

docs/tekton-dash-knowledge-base.html

@@ -1,2191 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-	<meta charset="UTF-8">
-	<meta name="viewport" content="width=device-width, initial-scale=1.0">
-	<title>Knowledge Base: Multi-Platform & Regional Production Deployment Blueprint</title>
-	<!-- Tailwind CSS CDN -->
-	<script src="https://cdn.tailwindcss.com"></script>
-	<script>tailwind.config = { darkMode: "class" }</script>
-	<!-- Lucide Icons -->
-	<script src="https://unpkg.com/lucide@latest"></script>
-	<!-- Flag Icons CSS CDN (Free Country Flags in SVG) -->
-	<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/flag-icons/7.2.3/css/flag-icons.min.css" />
-	<style>
-		@import url('https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght=300;400;500;600;700;800&family=JetBrains+Mono:wght=400;500;600&display=swap');
-
-		body {
-			font-family: 'JetBrains Mono', monospace;
-		}
-
-		.code-font {
-			font-family: 'JetBrains Mono', monospace;
-		}
-
-		/* Custom styles to refine the flag layout */
-		.fi {
-			border-radius: 2px;
-			box-shadow: 0 1px 2px rgba(0, 0, 0, 0.2);
-			vertical-align: middle;
-		}
-	</style>
-</head>
-
-<body class="bg-slate-50 dark:bg-slate-900 text-slate-800 dark:text-slate-100 min-h-screen antialiased selection:bg-sky-500 selection:text-slate-900 dark:text-white">
-
-	<!-- Header Navigation Bar -->
-	<header class="border-b border-slate-200 dark:border-slate-800 bg-white dark:bg-white/80 dark:bg-slate-950/80 backdrop-blur-md sticky top-0 z-50">
-		<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 h-16 flex items-center justify-between">
-			<div class="flex items-center space-x-3">
-				<div class="bg-sky-500 p-2 rounded-lg text-slate-950">
-					<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/godot/default.svg" alt="Godot" class="w-6 h-6">
-				</div>
-				<div>
-					<span
-						class="font-bold text-lg tracking-tight bg-gradient-to-r from-sky-400 to-indigo-400 bg-clip-text text-transparent">Nakama
-						x Godot 4</span>
-					<span class="text-xs block text-slate-500 dark:text-slate-400 font-mono">Production Blueprint</span>
-				</div>
-			</div>
-			<div class="flex items-center space-x-4">
-				<span
-					class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
-					<span class="w-1.5 h-1.5 mr-1.5 rounded-full bg-emerald-400 animate-pulse"></span>
-					Production Ready
-				</span>
-				
-				<button id="theme-toggle" class="flex items-center justify-center p-2 rounded-lg text-slate-500 dark:text-slate-400 hover:bg-slate-100 dark:text-slate-600 dark:text-slate-400 dark:hover:bg-slate-200 dark:bg-slate-800 transition">
-					<i data-lucide="moon" class="w-5 h-5 hidden dark:block"></i>
-					<i data-lucide="sun" class="w-5 h-5 block dark:hidden"></i>
-				</button>
-<button onclick="window.print()"
-					class="flex items-center space-x-2 bg-slate-200 dark:bg-slate-800 hover:bg-slate-300 dark:hover:bg-slate-700 text-slate-800 dark:text-slate-200 px-3.5 py-1.5 rounded-lg text-sm font-semibold transition border border-slate-700">
-					<i data-lucide="printer" class="w-4 h-4"></i>
-					<span>Export / Print</span>
-				</button>
-			</div>
-		</div>
-		
-		<!-- Secondary Navigation Bar -->
-		<div class="border-t border-slate-200 dark:border-slate-800 bg-slate-50/50 dark:bg-slate-900/50 hidden md:block">
-			<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-				<nav class="flex space-x-8 overflow-x-auto py-3 text-xs font-medium text-slate-600 dark:text-slate-400">
-					<a href="#infrastructure" class="hover:text-sky-500 dark:hover:text-sky-400 whitespace-nowrap transition">1. Regional Infrastructure</a>
-					<a href="#storefront" class="hover:text-sky-500 dark:hover:text-sky-400 whitespace-nowrap transition">2. Storefront Commissions</a>
-					<a href="#monetization" class="hover:text-sky-500 dark:hover:text-sky-400 whitespace-nowrap transition">3. Monetization Architecture</a>
-					<a href="#architecture" class="hover:text-sky-500 dark:hover:text-sky-400 whitespace-nowrap transition">4. Core Architecture</a>
-					<a href="#priority-board" class="hover:text-sky-500 dark:hover:text-sky-400 whitespace-nowrap transition">5. Priority Board</a>
-				</nav>
-			</div>
-		</div>
-	</header>
-
-	<main class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-10">
-
-		<!-- Hero Section / Title -->
-		<div class="mb-12 border-b border-slate-200 dark:border-slate-800 pb-8">
-			<h1 class="text-3xl sm:text-4xl lg:text-5xl font-extrabold text-slate-900 dark:text-white tracking-tight leading-none mb-4">
-				Knowledge Base & Production Deployment Blueprint
-			</h1>
-			<p class="text-slate-600 dark:text-slate-400 text-lg max-w-4xl">
-				A highly descriptive, production-centric strategy for engineering global, multi-store authentication,
-				transaction validation, and regulatory compliance networks utilizing Godot 4 and Heroic Labs Nakama.
-			</p>
-
-			<div class="grid grid-cols-1 md:grid-cols-3 gap-4 mt-8">
-				<div class="bg-white dark:bg-slate-950 p-4 rounded-xl border border-slate-800 flex items-start space-x-3">
-					<div class="text-sky-400 p-2 bg-sky-500/5 rounded-lg"><i data-lucide="globe" class="w-5 h-5"></i>
-					</div>
-					<div>
-						<h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400">Core Jurisdictions
-						</h4>
-						<div class="flex items-center space-x-1.5 mt-1">
-							<span class="fi fi-eu" title="European Union"></span>
-							<span class="fi fi-cn" title="China"></span>
-							<span class="fi fi-hk" title="Hong Kong"></span>
-							<span class="fi fi-sg" title="Singapore"></span>
-							<span class="fi fi-jp" title="Japan"></span>
-							<span class="text-sm font-medium text-slate-700 dark:text-slate-300 ml-1">Europe, Mainland China Transit & APAC
-								Networks</span>
-						</div>
-					</div>
-				</div>
-				<div class="bg-white dark:bg-slate-950 p-4 rounded-xl border border-slate-800 flex items-start space-x-3">
-					<div class="text-emerald-400 p-2 bg-emerald-500/5 rounded-lg"><i data-lucide="credit-card"
-							class="w-5 h-5"></i></div>
-					<div>
-						<h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400">IAP Validation</h4>
-						<p class="text-sm font-medium text-slate-700 dark:text-slate-300">Asynchronous, Server-to-Server, Ledger-Signed
-							Receipt Verification</p>
-					</div>
-				</div>
-				<div class="bg-white dark:bg-slate-950 p-4 rounded-xl border border-slate-800 flex items-start space-x-3">
-					<div class="text-indigo-400 p-2 bg-indigo-500/5 rounded-lg"><i data-lucide="shield-check"
-							class="w-5 h-5"></i></div>
-					<div>
-						<h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400">Store Integration</h4>
-						<p class="text-sm font-medium text-slate-700 dark:text-slate-300">Steamworks, Google Play, Apple App Store, TapSDK
-							(Zero-Commission)</p>
-					</div>
-				</div>
-			</div>
-		</div>
-
-		<!-- Section 1: Regional Infrastructures & Compliance Mapping -->
-		<section id="infrastructure" class="mb-16 scroll-mt-28">
-			<div class="flex items-center space-x-2 mb-6">
-				<i data-lucide="map" class="text-sky-500 w-6 h-6"></i>
-				<h2 class="text-2xl font-bold text-slate-900 dark:text-white">1. Regional Infrastructure & Regulatory Compliance</h2>
-			</div>
-			<p class="text-slate-600 dark:text-slate-400 mb-6">
-				Deploying cross-border games requires careful partitioning of databases and game nodes to satisfy
-				extreme technical boundaries (e.g., latency issues caused by the Great Firewall) and data protection
-				statutes (e.g., GDPR, local municipal privacy mandates).
-			</p>
-
-			<div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
-				<!-- Europe card -->
-				<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6 hover:border-slate-300 dark:hover:border-slate-700 transition">
-					<div class="flex justify-between items-start mb-4">
-						<div class="flex items-center space-x-2">
-							<span class="fi fi-eu w-5 h-5 rounded-sm"></span>
-							<span
-								class="text-xs font-mono px-2.5 py-1 rounded bg-sky-500/10 text-sky-400 border border-sky-500/20 font-semibold uppercase">Europe
-								(EU) - Webdock</span>
-						</div>
-						<i data-lucide="shield" class="text-sky-400 w-5 h-5"></i>
-					</div>
-					<h3 class="text-lg font-bold text-slate-800 dark:text-slate-200 mb-3">GDPR & DMA Pipeline</h3>
-					<ul class="space-y-2.5 text-sm text-slate-600 dark:text-slate-400">
-						<li class="flex items-start"><i data-lucide="check-circle-2"
-								class="text-emerald-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>Central
-									Cluster:</strong> Host on high-density <strong>Webdock.io</strong> Ryzen-powered VPS
-								profiles located in Frankfurt or Vienna.</span></li>
-						<li class="flex items-start"><i data-lucide="check-circle-2"
-								class="text-emerald-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i>
-							<span><strong>Sovereignty:</strong> Webdock offers EU-owned infrastructure with strict
-								hardware insulation and zero overseas sub-processor data leaks.</span></li>
-						<li class="flex items-start"><i data-lucide="check-circle-2"
-								class="text-emerald-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>User
-									Control:</strong> Integrate explicit game-level telemetry opt-out flags which halt
-								outgoing Nakama analytics scripts instantly.</span></li>
-					</ul>
-				</div>
-
-				<!-- China card (Repositioned to reflect China Transit priority routing) -->
-				<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6 hover:border-slate-300 dark:hover:border-slate-700 transition">
-					<div class="flex justify-between items-start mb-4">
-						<div class="flex items-center space-x-2">
-							<span class="fi fi-cn w-5 h-5 rounded-sm"></span>
-							<span class="fi fi-hk w-5 h-5 rounded-sm"></span>
-							<span
-								class="text-xs font-mono px-2.5 py-1 rounded bg-rose-500/10 text-rose-400 border border-rose-500/20 font-semibold uppercase">China
-								Transit - HostHatch</span>
-						</div>
-						<i data-lucide="lock" class="text-rose-400 w-5 h-5"></i>
-					</div>
-					<h3 class="text-lg font-bold text-slate-800 dark:text-slate-200 mb-3">HostHatch HK Edge Gateway</h3>
-					<ul class="space-y-2.5 text-sm text-slate-600 dark:text-slate-400">
-						<li class="flex items-start"><i data-lucide="alert-triangle"
-								class="text-amber-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>GFW
-									Proximity:</strong> Deploy regional proxy logic to <strong>HostHatch.com</strong>
-								Hong Kong nodes, featuring direct low-latency peering tunnels.</span></li>
-						<li class="flex items-start"><i data-lucide="alert-triangle"
-								class="text-amber-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>Regulatory
-									Separation:</strong> Standalone DB instances keep Mainland China data segregated
-								from Western clusters while resolving network hops near the target audience.</span></li>
-						<li class="flex items-start"><i data-lucide="alert-triangle"
-								class="text-amber-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>NPPA
-									Integrations:</strong> Route localized traffic from HK edge to Chinese validation
-								and anti-addiction registry backends efficiently.</span></li>
-					</ul>
-				</div>
-
-				<!-- Asia Ex-CN card (Now following CN, handling overflow and APAC routing) -->
-				<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6 hover:border-slate-300 dark:hover:border-slate-700 transition">
-					<div class="flex justify-between items-start mb-4">
-						<div class="flex items-center space-x-2">
-							<span class="fi fi-sg w-5 h-5 rounded-sm"></span>
-							<span class="fi fi-jp w-5 h-5 rounded-sm"></span>
-							<span class="fi fi-kr w-5 h-5 rounded-sm"></span>
-							<span
-								class="text-xs font-mono px-2.5 py-1 rounded bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 font-semibold uppercase">Asia
-								(Ex-CN) - Following CN</span>
-						</div>
-						<i data-lucide="zap" class="text-emerald-400 w-5 h-5"></i>
-					</div>
-					<h3 class="text-lg font-bold text-slate-800 dark:text-slate-200 mb-3">APAC Edge Arrays</h3>
-					<ul class="space-y-2.5 text-sm text-slate-600 dark:text-slate-400">
-						<li class="flex items-start"><i data-lucide="check-circle-2"
-								class="text-emerald-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>Transit
-									Integration:</strong> Set up edge nodes in Tokyo, Seoul, and Singapore configured to
-								capture traffic spills when cross-border HK connections are saturated.</span></li>
-						<li class="flex items-start"><i data-lucide="check-circle-2"
-								class="text-emerald-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>Latency
-									Optimization:</strong> Run high-performance CockroachDB clusters to maintain global
-								synchronization while serving nearby regional users under 45ms.</span></li>
-						<li class="flex items-start"><i data-lucide="check-circle-2"
-								class="text-emerald-500 w-4 h-4 mr-2 mt-0.5 shrink-0"></i> <span><strong>Data
-									Privacy:</strong> Satisfy local guidelines (Japan's APPI, South Korea's PIPA) using
-								explicit user data deletion interfaces inside Nakama profile routes.</span></li>
-					</ul>
-				</div>
-			</div>
-
-			<!-- Warning Callout on China Firewall -->
-			<div class="mt-6 bg-amber-500/5 border border-amber-500/20 rounded-xl p-4 flex items-start space-x-3">
-				<i data-lucide="alert-circle" class="text-amber-500 w-5 h-5 shrink-0 mt-0.5"></i>
-				<div class="text-sm text-amber-300">
-					<strong class="font-semibold block">Critical GFW Operational Warning:</strong>
-					Real-time WebSocket and UDP connection signals across the Great Firewall suffer massive packet
-					losses (&ge; 25%). Incorporating HostHatch's Hong Kong node acts as an indispensable entry buffer;
-					however, complete logical segregation of the Chinese client backend instance is still mandatory.
-				</div>
-			</div>
-		</section>
-
-		<!-- Section 2: Financial Strategy, Licenses, & Commissions -->
-		<section id="storefront" class="mb-16 scroll-mt-28">
-			<div class="flex items-center justify-between mb-6">
-				<div class="flex items-center space-x-2">
-					<i data-lucide="dollar-sign" class="text-emerald-500 w-6 h-6"></i>
-					<h2 class="text-2xl font-bold text-slate-900 dark:text-white">2. Storefront Commissions & Licensing Pipeline</h2>
-				</div>
-			</div>
-			<p class="text-slate-600 dark:text-slate-400 mb-6">
-				Operating margins rely on optimizing each storefront's fee parameters. Before collecting gross revenue,
-				publishers must clear the initial platform entry fees.
-			</p>
-
-			<!-- Upfront Fee Settlement Grid -->
-			<div class="mb-8 bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6">
-				<h3 class="text-lg font-bold text-slate-800 dark:text-slate-200 mb-4 flex items-center">
-					<i data-lucide="wallet" class="text-sky-400 w-5 h-5 mr-2"></i>
-					Initial Publishing Costs & First Fee Settlement Grid
-				</h3>
-				<p class="text-slate-600 dark:text-slate-400 text-sm mb-6">
-					Below is the required capital breakdown needed to register your identity and prepare storefront
-					slots before pushing your initial Godot client build to production channels.
-				</p>
-				<div class="overflow-x-auto">
-					<table class="w-full text-left text-sm text-slate-700 dark:text-slate-300">
-						<thead class="bg-slate-50 dark:bg-slate-900 text-slate-600 dark:text-slate-400 text-xs font-mono uppercase tracking-wider">
-							<tr>
-								<th class="p-4 border-b border-slate-200 dark:border-slate-800">Platform</th>
-								<th class="p-4 border-b border-slate-200 dark:border-slate-800">First Fee Amount</th>
-								<th class="p-4 border-b border-slate-200 dark:border-slate-800 font-semibold text-center">Market Flag</th>
-								<th class="p-4 border-b border-slate-200 dark:border-slate-800">Fee Recurrence Type</th>
-								<th class="p-4 border-b border-slate-200 dark:border-slate-800">Refundability Status</th>
-								<th class="p-4 border-b border-slate-200 dark:border-slate-800">Settlement Methods</th>
-							</tr>
-						</thead>
-						<tbody class="divide-y divide-slate-200 dark:divide-slate-800">
-							<!-- Steam Row -->
-							<tr class="hover:bg-slate-50 dark:bg-slate-900/40">
-								<td class="p-4 font-semibold text-slate-900 dark:text-white">Steamworks (PC)</td>
-								<td class="p-4 font-mono text-emerald-400">$100.00 USD <span
-										class="text-slate-500 dark:text-slate-400 text-xs">(per product)</span></td>
-								<td class="p-4 text-center">
-									<span class="fi fi-us" title="United States / Global"></span>
-								</td>
-								<td class="p-4">One-time per App Slot</td>
-								<td class="p-4"><span class="text-emerald-400 font-semibold">Yes</span> <span
-										class="text-xs text-slate-500 dark:text-slate-400">(Refunded after $1,000 in gross sales)</span>
-								</td>
-								<td class="p-4 text-xs">Credit Card, PayPal, Steam Wallet, Wire Transfer</td>
-							</tr>
-							<!-- Itch Row -->
-							<tr class="hover:bg-slate-50 dark:bg-slate-900/40">
-								<td class="p-4 font-semibold text-slate-900 dark:text-white">Itch.io (PC)</td>
-								<td class="p-4 font-mono text-slate-600 dark:text-slate-400">$0.00 USD <span
-										class="text-slate-500 dark:text-slate-400 text-xs">(Zero entry fee)</span></td>
-								<td class="p-4 text-center">
-									<span class="fi fi-un" title="International / Open"></span>
-								</td>
-								<td class="p-4">None</td>
-								<td class="p-4 text-slate-500 dark:text-slate-400">Not Applicable</td>
-								<td class="p-4 text-xs">None (Optional tax documentation verification)</td>
-							</tr>
-							<!-- Google Row -->
-							<tr class="hover:bg-slate-50 dark:bg-slate-900/40">
-								<td class="p-4 font-semibold text-slate-900 dark:text-white">Google Play</td>
-								<td class="p-4 font-mono text-emerald-400">$25.00 USD</td>
-								<td class="p-4 text-center">
-									<span class="fi fi-us" title="United States / Global"></span>
-								</td>
-								<td class="p-4">One-time per Developer Identity</td>
-								<td class="p-4 text-rose-400 font-semibold">No</td>
-								<td class="p-4 text-xs">Credit/Debit Card (requires Google Pay Profile)</td>
-							</tr>
-							<!-- Apple Row -->
-							<tr class="hover:bg-slate-50 dark:bg-slate-900/40">
-								<td class="p-4 font-semibold text-slate-900 dark:text-white">Apple App Store</td>
-								<td class="p-4 font-mono text-emerald-400">$99.00 USD</td>
-								<td class="p-4 text-center">
-									<span class="fi fi-us" title="United States / Global"></span>
-								</td>
-								<td class="p-4">Annual Subscription Renewal</td>
-								<td class="p-4 text-rose-400 font-semibold">No</td>
-								<td class="p-4 text-xs">Credit Card (linked to Apple ID Developer Account)</td>
-							</tr>
-							<!-- TapTap Row -->
-							<tr class="hover:bg-slate-50 dark:bg-slate-900/40">
-								<td class="p-4 font-semibold text-slate-900 dark:text-white">TapTap Developer</td>
-								<td class="p-4 font-mono text-slate-600 dark:text-slate-400">$0.00 USD <span
-										class="text-slate-500 dark:text-slate-400 text-xs">(Corporate validation)</span></td>
-								<td class="p-4 text-center">
-									<span class="fi fi-cn mr-0.5" title="China"></span>
-									<span class="fi fi-sg" title="Singapore / APAC"></span>
-								</td>
-								<td class="p-4">None</td>
-								<td class="p-4 text-slate-500 dark:text-slate-400">Not Applicable</td>
-								<td class="p-4 text-xs">Requires legal corporate identity / ICP verification</td>
-							</tr>
-						</tbody>
-					</table>
-				</div>
-			</div>
-
-			<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6 mb-8 text-center">
-				<span class="text-xs text-slate-500 dark:text-slate-400 uppercase tracking-widest font-mono">Net Yield Production
-					Formula</span>
-				<div class="text-2xl sm:text-3xl font-mono text-sky-400 my-3 select-all">
-					R_net = R_gross &times; (1 - C_store - T_tax) - F_fees
-				</div>
-				<p class="text-xs text-slate-500 dark:text-slate-400 max-w-xl mx-auto">
-					Where <span class="text-sky-400">C_store</span> matches the target store platform commission, <span
-						class="text-sky-400">T_tax</span> matches regional withholding taxes, and <span
-						class="text-sky-400">F_fees</span> encapsulates external server transaction margins and API
-					query operations.
-				</p>
-			</div>
-
-			<!-- Platform Detail Tabs -->
-			<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl overflow-hidden">
-				<div class="border-b border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-slate-900/40 p-1 flex overflow-x-auto scrollbar-none"
-					id="store-tabs">
-					<button onclick="switchTab('steam')"
-						class="tab-btn active px-4 py-2 text-sm font-semibold rounded-lg text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white transition whitespace-nowrap bg-slate-200 dark:bg-slate-800 text-slate-900 dark:text-white flex items-center"
-						id="tab-steam">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/steam/default.svg" class="w-4 h-4 mr-1.5" alt="Steam">Steam (PC)
-					</button>
-					<button onclick="switchTab('itch')"
-						class="tab-btn px-4 py-2 text-sm font-semibold rounded-lg text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white transition whitespace-nowrap flex items-center"
-						id="tab-itch">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/itchdotio/default.svg" class="w-4 h-4 mr-1.5 invert" alt="Itch.io">Itch.io (PC)
-					</button>
-					<button onclick="switchTab('google')"
-						class="tab-btn px-4 py-2 text-sm font-semibold rounded-lg text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white transition whitespace-nowrap flex items-center"
-						id="tab-google">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google-play/default.svg" class="w-4 h-4 mr-1.5" alt="Google Play">Google Play
-					</button>
-					<button onclick="switchTab('apple')"
-						class="tab-btn px-4 py-2 text-sm font-semibold rounded-lg text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white transition whitespace-nowrap flex items-center"
-						id="tab-apple">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/apple/default.svg" class="w-4 h-4 mr-1.5 invert opacity-70" alt="Apple">App Store (iOS)
-					</button>
-					<button onclick="switchTab('taptap')"
-						class="tab-btn px-4 py-2 text-sm font-semibold rounded-lg text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white transition whitespace-nowrap flex items-center"
-						id="tab-taptap">
-						<span class="fi fi-cn mr-1"></span><span class="fi fi-sg mr-1.5"></span>TapTap (Mobile)
-					</button>
-				</div>
-
-				<div class="p-6">
-					<!-- Steam Tab Content -->
-					<div id="content-steam" class="tab-content">
-						<div class="grid grid-cols-1 md:grid-cols-2 gap-8">
-							<div>
-								<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-4">Steamworks Implementation Matrix</h3>
-								<table class="w-full text-sm">
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Commission Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">30% (Default)</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Volume Scaling</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">25% at $10M | 20% at $50M</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">First Fee</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">$100 USD (Steam Direct
-											App Deposit)</td>
-									</tr>
-									<tr>
-										<td class="py-2 text-slate-500 dark:text-slate-400">Nakama Verification</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">Server Authenticated
-											Session Ticket</td>
-									</tr>
-								</table>
-							</div>
-							<div class="bg-slate-50 dark:bg-slate-900/40 p-5 rounded-lg border border-slate-800">
-								<h4 class="text-xs font-semibold tracking-wider text-slate-500 dark:text-slate-400 uppercase mb-2">Technical
-									Execution</h4>
-								<p class="text-sm text-slate-700 dark:text-slate-300 leading-relaxed mb-3">
-									Initialize <code class="text-sky-400 font-mono text-xs">GodotSteam</code>
-									dynamically inside your client. The user retrieves their secure hex session ticket
-									locally, passing it down to Nakama using the native client driver hook to eliminate
-									credential spoofing risks.
-								</p>
-								<span class="text-xs font-mono text-slate-500 dark:text-slate-400 block">Endpoint:
-									client.authenticate_steam_async(ticket)</span>
-							</div>
-						</div>
-					</div>
-
-					<!-- Itch Tab Content -->
-					<div id="content-itch" class="tab-content hidden">
-						<div class="grid grid-cols-1 md:grid-cols-2 gap-8">
-							<div>
-								<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-4">Itch.io Standalone Blueprint</h3>
-								<table class="w-full text-sm">
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Commission Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">10% (Open Slider to 0%)</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">First Fee</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">$0.00 USD (Completely Open
-											Portal)</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Target Core Assets</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">No External Platform Hooks</td>
-									</tr>
-									<tr>
-										<td class="py-2 text-slate-500 dark:text-slate-400">Nakama Verification</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">Device Unique ID /
-											Hardware Hash</td>
-									</tr>
-								</table>
-							</div>
-							<div class="bg-slate-50 dark:bg-slate-900/40 p-5 rounded-lg border border-slate-800">
-								<h4 class="text-xs font-semibold tracking-wider text-slate-500 dark:text-slate-400 uppercase mb-2">Technical
-									Execution</h4>
-								<p class="text-sm text-slate-700 dark:text-slate-300 leading-relaxed mb-3">
-									Itch standalone builds must bypass Steam libraries completely. Query the hardware
-									hash utilizing Godot's <code
-										class="text-sky-400 font-mono text-xs">OS.get_unique_id()</code> call. Combine
-									with custom email authentication options inside your client UI for stable user
-									recovery.
-								</p>
-								<span class="text-xs font-mono text-slate-500 dark:text-slate-400 block">Endpoint:
-									client.authenticate_device_async(id)</span>
-							</div>
-						</div>
-					</div>
-
-					<!-- Google Play Tab Content -->
-					<div id="content-google" class="tab-content hidden">
-						<div class="grid grid-cols-1 md:grid-cols-2 gap-8">
-							<div>
-								<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-4">Google Play Commerce Setup</h3>
-								<table class="w-full text-sm">
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Commission Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">15% on first $1M USD annually
-										</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Standard Tier Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">30% (If annual earnings exceed
-											$1M)</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">First Fee</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">$25 USD (One-time Console
-											Setup)</td>
-									</tr>
-									<tr>
-										<td class="py-2 text-slate-500 dark:text-slate-400">Nakama Verification</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">Google Play Games Server
-											Auth Code</td>
-									</tr>
-								</table>
-							</div>
-							<div class="bg-slate-50 dark:bg-slate-900/40 p-5 rounded-lg border border-slate-800">
-								<h4 class="text-xs font-semibold tracking-wider text-slate-500 dark:text-slate-400 uppercase mb-2">Technical
-									Execution</h4>
-								<p class="text-sm text-slate-700 dark:text-slate-300 leading-relaxed mb-3">
-									Integrate the Google Play Games GDExtension inside Godot. Retrieve the user's secure
-									authentication code on startup and transfer it to the Nakama server backend to
-									provision accounts asynchronously.
-								</p>
-								<span class="text-xs font-mono text-slate-500 dark:text-slate-400 block">Endpoint:
-									client.authenticate_google_async(token)</span>
-							</div>
-						</div>
-					</div>
-
-					<!-- Apple Tab Content -->
-					<div id="content-apple" class="tab-content hidden">
-						<div class="grid grid-cols-1 md:grid-cols-2 gap-8">
-							<div>
-								<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-4">Apple App Store Integration</h3>
-								<table class="w-full text-sm">
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Commission Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">15% via Small Business Program
-										</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Standard Tier Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">30% (Standard Portfolio
-											Account)</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">First Fee</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">$99 USD (Annual
-											Registration Program)</td>
-									</tr>
-									<tr>
-										<td class="py-2 text-slate-500 dark:text-slate-400">Nakama Verification</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">Apple Identity Token or
-											Game Center</td>
-									</tr>
-								</table>
-							</div>
-							<div class="bg-slate-50 dark:bg-slate-900/40 p-5 rounded-lg border border-slate-800">
-								<h4 class="text-xs font-semibold tracking-wider text-slate-500 dark:text-slate-400 uppercase mb-2">Technical
-									Execution</h4>
-								<p class="text-sm text-slate-700 dark:text-slate-300 leading-relaxed mb-3">
-									Process authentication loops using Apple ID identity payloads via Sign In with
-									Apple. For Game Center, extract authentication signatures, timestamps, and salt
-									packets to execute secure matching processes.
-								</p>
-								<span class="text-xs font-mono text-slate-500 dark:text-slate-400 block">Endpoint:
-									client.authenticate_apple_async(token)</span>
-							</div>
-						</div>
-					</div>
-
-					<!-- TapTap Tab Content -->
-					<div id="content-taptap" class="tab-content hidden">
-						<div class="grid grid-cols-1 md:grid-cols-2 gap-8">
-							<div>
-								<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-4">TapTap Developer Services Strategy</h3>
-								<table class="w-full text-sm">
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Commission Rate</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">0% (Completely Commission-Free)
-										</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">Target Core Markets</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">Mainland China & SEA Mobile
-											Communities</td>
-									</tr>
-									<tr class="border-b border-slate-200 dark:border-slate-800">
-										<td class="py-2 text-slate-500 dark:text-slate-400">First Fee</td>
-										<td class="py-2 text-slate-900 dark:text-white font-mono text-right">$0.00 USD (Entity verification
-											required)</td>
-									</tr>
-									<tr>
-										<td class="py-2 text-slate-500 dark:text-slate-400">Nakama Verification</td>
-										<td class="py-2 text-emerald-400 font-mono text-right">Custom Auth (via TapTap
-											OAuth Token)</td>
-									</tr>
-								</table>
-							</div>
-							<div class="bg-slate-50 dark:bg-slate-900/40 p-5 rounded-lg border border-slate-800">
-								<h4 class="text-xs font-semibold tracking-wider text-slate-500 dark:text-slate-400 uppercase mb-2">Technical
-									Execution</h4>
-								<p class="text-sm text-slate-700 dark:text-slate-300 leading-relaxed mb-3">
-									TapTap operates without a direct native Nakama SDK connector. Retrieve the user's
-									OAuth access token using the TapSDK inside Godot. Execute authentication by passing
-									the token directly to Nakama's custom endpoint, routing background network
-									validations securely.
-								</p>
-								<span class="text-xs font-mono text-slate-500 dark:text-slate-400 block">Endpoint:
-									client.authenticate_custom_async(tap_token)</span>
-							</div>
-						</div>
-					</div>
-				</div>
-			</div>
-		</section>
-
-		<!-- Section 3: Secure Server-to-Server Purchase Validation -->
-		<section id="monetization" class="mb-16 scroll-mt-28">
-			<div class="flex items-center space-x-2 mb-6">
-				<i data-lucide="shield-alert" class="text-sky-500 w-6 h-6"></i>
-				<h2 class="text-2xl font-bold text-slate-900 dark:text-white">3. Monetization Architecture & Secure IAP Loop</h2>
-			</div>
-			<p class="text-slate-600 dark:text-slate-400 mb-6">
-				Client-side reporting is inherently untrustworthy. Memory injectors (e.g., Lucky Patcher on Android,
-				memory editing tools on PC) can manipulate the client runtime to simulate successful purchases.
-				Implementing a robust, asynchronous verification cycle ensures validation is handled strictly by the
-				server.
-			</p>
-
-			<!-- Sequence Layout -->
-			<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6 lg:p-8">
-				<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-6 flex items-center"><i data-lucide="git-branch"
-						class="text-sky-400 w-5 h-5 mr-2"></i> Asynchronous Verification Topology</h3>
-
-				<div class="grid grid-cols-1 md:grid-cols-4 gap-4 relative">
-					<!-- Step 1 -->
-					<div class="bg-slate-50 dark:bg-slate-900/50 p-5 rounded-lg border border-slate-800 relative">
-						<div
-							class="absolute -top-3 -left-3 w-8 h-8 rounded-full bg-sky-500 text-slate-950 flex items-center justify-center font-bold text-sm">
-							1</div>
-						<h4 class="text-sm font-semibold text-slate-800 dark:text-slate-200 mt-2 mb-2">Purchase & Tokenization</h4>
-						<p class="text-xs text-slate-600 dark:text-slate-400">The Godot client requests checkout. The player submits payment
-							to the store network, which issues an encrypted, signed platform transaction token.</p>
-					</div>
-					<!-- Step 2 -->
-					<div class="bg-slate-50 dark:bg-slate-900/50 p-5 rounded-lg border border-slate-800 relative">
-						<div
-							class="absolute -top-3 -left-3 w-8 h-8 rounded-full bg-sky-500 text-slate-950 flex items-center justify-center font-bold text-sm">
-							2</div>
-						<h4 class="text-sm font-semibold text-slate-800 dark:text-slate-200 mt-2 mb-2">Nakama RPC Ingestion</h4>
-						<p class="text-xs text-slate-600 dark:text-slate-400">The client forwards the raw transaction token securely to
-							Nakama via an RPC function call: <code class="text-sky-400">verify_purchase</code>.</p>
-					</div>
-					<!-- Step 3 -->
-					<div class="bg-slate-50 dark:bg-slate-900/50 p-5 rounded-lg border border-slate-800 relative">
-						<div
-							class="absolute -top-3 -left-3 w-8 h-8 rounded-full bg-sky-500 text-slate-950 flex items-center justify-center font-bold text-sm">
-							3</div>
-						<h4 class="text-sm font-semibold text-slate-800 dark:text-slate-200 mt-2 mb-2">Server Validation Check</h4>
-						<p class="text-xs text-slate-600 dark:text-slate-400">Nakama blocks immediate user manipulation. It connects
-							server-to-server with Google, Apple, or Steam APIs to verify status and signatures.</p>
-					</div>
-					<!-- Step 4 -->
-					<div class="bg-slate-50 dark:bg-slate-900/50 p-5 rounded-lg border border-slate-800 relative">
-						<div
-							class="absolute -top-3 -left-3 w-8 h-8 rounded-full bg-emerald-500 text-slate-950 flex items-center justify-center font-bold text-sm">
-							4</div>
-						<h4 class="text-sm font-semibold text-slate-800 dark:text-slate-200 mt-2 mb-2">Ledger Provisioning</h4>
-						<p class="text-xs text-slate-600 dark:text-slate-400">Upon verification, Nakama updates the persistent storage
-							wallet data and broadcasts confirmation back to the Godot client.</p>
-					</div>
-				</div>
-			</div>
-		</section>
-
-		<!-- Section 4: Architecture Autoload Script Blueprint -->
-		<section id="architecture" class="mb-16 scroll-mt-28">
-			<div class="flex items-center space-x-2 mb-6">
-				<i data-lucide="network" class="text-sky-500 w-6 h-6"></i>
-				<h2 class="text-2xl font-bold text-slate-900 dark:text-white">4. Core Architecture: Unified Identity Manager Decision Flow
-					Chart</h2>
-			</div>
-			<p class="text-slate-600 dark:text-slate-400 mb-6">
-				The Unified Identity Manager dynamically discovers platforms at runtime, resolving features and
-				singletons without breaking compilations on platforms lacking those SDK wrappers. Click the platform
-				modes below to preview the path execution, safety hooks, and token routing.
-			</p>
-
-			<!-- Dynamic Decision Flowchart Container -->
-			<div class="bg-white dark:bg-slate-950 border border-slate-800 rounded-xl p-6 lg:p-8">
-				<!-- Interactive Controls -->
-				<div
-					class="flex flex-wrap gap-2 mb-8 bg-slate-50 dark:bg-slate-900 p-1.5 rounded-xl border border-slate-800 max-w-2xl mx-auto justify-center">
-					<button onclick="highlightPath('all')"
-						class="path-ctrl-btn active px-4 py-2 text-xs font-semibold rounded-lg transition-all duration-300 bg-sky-500 text-slate-950 shadow-md flex items-center justify-center"
-						id="btn-path-all">
-						Show Full Tree
-					</button>
-					<button onclick="highlightPath('steam')"
-						class="path-ctrl-btn px-4 py-2 text-xs font-semibold rounded-lg transition-all duration-300 text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white flex items-center justify-center"
-						id="btn-path-steam">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/steam/default.svg" class="w-3.5 h-3.5 mr-1.5" alt="Steam">PC (Steam)
-					</button>
-					<button onclick="highlightPath('android')"
-						class="path-ctrl-btn px-4 py-2 text-xs font-semibold rounded-lg transition-all duration-300 text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white flex items-center justify-center"
-						id="btn-path-android">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google-play/default.svg" class="w-3.5 h-3.5 mr-1.5" alt="Google Play">Android (Google/TapTap)
-					</button>
-					<button onclick="highlightPath('ios')"
-						class="path-ctrl-btn px-4 py-2 text-xs font-semibold rounded-lg transition-all duration-300 text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white flex items-center justify-center"
-						id="btn-path-ios">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/apple/default.svg" class="w-3.5 h-3.5 mr-1.5 invert opacity-70" alt="Apple">iOS (Apple/TapTap)
-					</button>
-					<button onclick="highlightPath('fallback')"
-						class="path-ctrl-btn px-4 py-2 text-xs font-semibold rounded-lg transition-all duration-300 text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:text-white flex items-center justify-center"
-						id="btn-path-fallback">
-						<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/itchdotio/default.svg" class="w-3.5 h-3.5 mr-1.5 invert" alt="Itch.io">Itch.io / Standalone PC
-					</button>
-				</div>
-
-				<!-- Flowchart Graph Layout -->
-				<div class="flex flex-col space-y-8 relative">
-
-					<!-- Root Entry Point -->
-					<div class="flex justify-center transition-all duration-300" id="node-root">
-						<div
-							class="bg-slate-50 dark:bg-slate-900 border-2 border-slate-700 hover:border-sky-500 rounded-xl p-4 text-center max-w-xs shadow-lg transition-all duration-300">
-							<div class="text-xs font-mono font-bold text-sky-400 uppercase tracking-widest mb-1">Game
-								Initialization</div>
-							<h4 class="text-sm font-extrabold text-slate-900 dark:text-white">_ready() / dispatch_platform_auth()</h4>
-							<p class="text-xxs text-slate-500 dark:text-slate-400 mt-1">Queries environment architecture and singletons</p>
-						</div>
-					</div>
-
-					<!-- Connective Vertical Line from Root -->
-					<div class="flex justify-center h-6 -my-4 relative z-0">
-						<div class="w-0.5 bg-slate-200 dark:bg-slate-800 transition-all duration-300" id="line-root"></div>
-					</div>
-
-					<!-- Platform Routing Split Container -->
-					<div class="grid grid-cols-1 md:grid-cols-4 gap-6 relative z-10">
-
-						<!-- Steam Branch -->
-						<div class="flex flex-col items-center bg-slate-50 dark:bg-slate-900/40 border border-slate-800 rounded-xl p-4 transition-all duration-300"
-							id="branch-steam">
-							<div class="flex items-center space-x-1.5 mb-3">
-								<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/steam/default.svg" class="w-4 h-4" alt="Steam">
-								<span
-									class="text-xxs font-mono font-semibold px-2 py-0.5 rounded bg-sky-500/10 text-sky-400 border border-sky-500/10">PC
-									Steam Target</span>
-							</div>
-							<div class="w-full text-center space-y-3">
-								<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-slate-800 dark:text-slate-200">Class Check</div>
-									<code class="text-xxs text-amber-400">ClassDB.has_singleton("Steam")</code>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center"><i data-lucide="arrow-down"
-										class="w-4 h-4"></i></div>
-								<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-slate-800 dark:text-slate-200">Ticket Retrieval</div>
-									<p class="text-xxs text-slate-600 dark:text-slate-400 mt-0.5">Grabs session hex ticket asynchronously
-									</p>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center"><i data-lucide="arrow-down"
-										class="w-4 h-4"></i></div>
-								<div class="bg-white dark:bg-slate-950 border border-sky-500/30 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-sky-400">Nakama Endpoint</div>
-									<code class="text-xxs text-slate-600 dark:text-slate-400">authenticate_steam_async()</code>
-								</div>
-							</div>
-						</div>
-
-						<!-- Android Branch -->
-						<div class="flex flex-col items-center bg-slate-50 dark:bg-slate-900/40 border border-slate-800 rounded-xl p-4 transition-all duration-300"
-							id="branch-android">
-							<div class="flex items-center space-x-1.5 mb-3">
-								<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google-play/default.svg" class="w-4 h-4" alt="Google Play">
-								<span
-									class="text-xxs font-mono font-semibold px-2 py-0.5 rounded bg-emerald-500/10 text-emerald-400 border border-emerald-500/10">Android
-									OS Target</span>
-							</div>
-							<div class="w-full text-center space-y-3">
-								<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-slate-800 dark:text-slate-200">Feature Gating</div>
-									<code class="text-xxs text-emerald-400">OS.has_feature("taptap")</code>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center flex-row justify-around">
-									<span class="text-xxs text-emerald-500">Yes</span><span
-										class="text-xxs text-sky-500">No</span></div>
-								<div class="grid grid-cols-2 gap-2">
-									<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-1.5 shadow text-xxs">
-										<div class="font-bold text-emerald-400">TapSDK</div>
-										<p class="text-[9px] text-slate-500 dark:text-slate-400 mt-0.5">Fetch OAuth Token</p>
-									</div>
-									<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-1.5 shadow text-xxs">
-										<div class="font-bold text-sky-400">Google Play</div>
-										<p class="text-[9px] text-slate-500 dark:text-slate-400 mt-0.5">Fetch Auth Code</p>
-									</div>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center"><i data-lucide="arrow-down"
-										class="w-4 h-4"></i></div>
-								<div class="bg-white dark:bg-slate-950 border border-sky-500/30 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-sky-400">Nakama Endpoint</div>
-									<code
-										class="text-xxs text-slate-600 dark:text-slate-400">authenticate_custom_async()<br>OR<br>authenticate_google_async()</code>
-								</div>
-							</div>
-						</div>
-
-						<!-- iOS Branch -->
-						<div class="flex flex-col items-center bg-slate-50 dark:bg-slate-900/40 border border-slate-800 rounded-xl p-4 transition-all duration-300"
-							id="branch-ios">
-							<div class="flex items-center space-x-1.5 mb-3">
-								<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/apple/default.svg" class="w-4 h-4 invert opacity-70" alt="Apple">
-								<span
-									class="text-xxs font-mono font-semibold px-2 py-0.5 rounded bg-violet-500/10 text-violet-400 border border-violet-500/10">iOS
-									OS Target</span>
-							</div>
-							<div class="w-full text-center space-y-3">
-								<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-slate-800 dark:text-slate-200">Feature Gating</div>
-									<code class="text-xxs text-violet-400">OS.has_feature("taptap")</code>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center flex-row justify-around">
-									<span class="text-xxs text-violet-500">Yes</span><span
-										class="text-xxs text-sky-500">No</span></div>
-								<div class="grid grid-cols-2 gap-2">
-									<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-1.5 shadow text-xxs">
-										<div class="font-bold text-violet-400">TapSDK</div>
-										<p class="text-[9px] text-slate-500 dark:text-slate-400 mt-0.5">Fetch OAuth Token</p>
-									</div>
-									<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-1.5 shadow text-xxs">
-										<div class="font-bold text-sky-400">Apple Auth</div>
-										<p class="text-[9px] text-slate-500 dark:text-slate-400 mt-0.5">Fetch Identity Token</p>
-									</div>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center"><i data-lucide="arrow-down"
-										class="w-4 h-4"></i></div>
-								<div class="bg-white dark:bg-slate-950 border border-sky-500/30 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-sky-400">Nakama Endpoint</div>
-									<code
-										class="text-xxs text-slate-600 dark:text-slate-400">authenticate_custom_async()<br>OR<br>authenticate_apple_async()</code>
-								</div>
-							</div>
-						</div>
-
-						<!-- Fallback / Itch.io Standalone Branch -->
-						<div class="flex flex-col items-center bg-slate-50 dark:bg-slate-900/40 border border-slate-800 rounded-xl p-4 transition-all duration-300"
-							id="branch-fallback">
-							<div class="flex items-center space-x-1.5 mb-3">
-								<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/itchdotio/default.svg" class="w-4 h-4 invert" alt="Itch.io">
-								<span
-									class="text-xxs font-mono font-semibold px-2 py-0.5 rounded bg-rose-500/10 text-rose-400 border border-rose-500/10">PC/Itch.io
-									Standalone</span>
-							</div>
-							<div class="w-full text-center space-y-3">
-								<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-slate-800 dark:text-slate-200">Device Hardware ID</div>
-									<code class="text-xxs text-rose-400">OS.get_unique_id()</code>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center"><i data-lucide="arrow-down"
-										class="w-4 h-4"></i></div>
-								<div class="bg-slate-50 dark:bg-slate-900 border border-slate-800 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-slate-800 dark:text-slate-200">Hardware Hashing</div>
-									<p class="text-xxs text-slate-600 dark:text-slate-400 mt-0.5">Generate hardware fingerprint</p>
-								</div>
-								<div class="text-slate-600 text-center flex justify-center"><i data-lucide="arrow-down"
-										class="w-4 h-4"></i></div>
-								<div class="bg-white dark:bg-slate-950 border border-sky-500/30 rounded-lg p-2.5 shadow text-xs">
-									<div class="font-bold text-sky-400">Nakama Endpoint</div>
-									<code class="text-xxs text-slate-600 dark:text-slate-400">authenticate_device_async()</code>
-								</div>
-							</div>
-						</div>
-
-					</div>
-
-					<!-- Connective Vertical Line to Target Server -->
-					<div class="flex justify-center h-6 -my-4 relative z-0">
-						<div class="w-0.5 bg-slate-200 dark:bg-slate-800 transition-all duration-300" id="line-terminal"></div>
-					</div>
-
-					<!-- Unified Target Server Block -->
-					<div class="flex justify-center transition-all duration-300" id="node-terminal">
-						<div
-							class="bg-slate-50 dark:bg-slate-900 border-2 border-emerald-500/60 rounded-xl p-5 text-center max-w-sm shadow-xl transition-all duration-300">
-							<div
-								class="flex items-center justify-center space-x-2 text-emerald-400 text-xs font-mono font-bold uppercase tracking-wider mb-2">
-								<span class="relative flex h-2 w-2">
-									<span
-										class="animate-ping absolute inline-flex h-full w-full rounded-full bg-emerald-400 opacity-75"></span>
-									<span class="relative inline-flex rounded-full h-2 w-2 bg-emerald-500"></span>
-								</span>
-								<span>Nakama Server Response Node</span>
-							</div>
-							<h4 class="text-sm font-extrabold text-slate-900 dark:text-white">NakamaSession Established</h4>
-							<p class="text-xxs text-slate-600 dark:text-slate-400 mt-1.5 leading-relaxed">
-								Session token decoded & validated, persistent profiles resolved, and socket pipelines
-								opened. Global matching/telemetry gates unlocked.
-							</p>
-						</div>
-					</div>
-
-				</div>
-			</div>
-		</section>
-
-		
-        
-        <!-- Section 5: Project Management (PR) Board -->
-		
-        <!-- Section 5: Project Management (PR) Board -->
-		<section id="priority-board" class="mb-16 scroll-mt-28">
-			<div class="flex items-center justify-between mb-6">
-				<div class="flex items-center space-x-2">
-					<i data-lucide="kanban-square" class="text-sky-500 w-6 h-6"></i>
-					<h2 class="text-2xl font-bold text-slate-900 dark:text-white">5. Project Management (PR) Board & AI Checklist</h2>
-				</div>
-			</div>
-			<p class="text-slate-600 dark:text-slate-400 mb-8">
-				This section serves as a fully detailed tracking board. It merges production readiness, backend reconstruction, gameflow audit, and Steam depot release tasks. 
-				<strong>Every task is fully expanded with checklists and automated testing criteria so you can track AI execution seamlessly.</strong>
-			</p>
-
-			<div class="bg-rose-50 dark:bg-rose-500/5 border border-rose-200 dark:border-rose-500/25 rounded-xl p-5 mb-8">
-				<h3 class="text-md font-bold text-rose-700 dark:text-rose-200 mb-3 flex items-center"><i data-lucide="flame" class="w-4 h-4 mr-2"></i>Priority Rule</h3>
-				<p class="text-sm text-slate-700 dark:text-slate-300 leading-relaxed">
-					Do not spend release time on Steam depot upload, signing polish, or branch promotion until P0 backend authority
-					is fixed. Current audit found client-authoritative economy, gacha paths, and sync loopholes. 
-					Those are launch blockers because they can corrupt wallet, inventory, match state, and account identity before first public build.
-				</p>
-			</div>
-
-            <!-- Detailed Task List (Expandable Accordions) -->
-            <div class="space-y-4">
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P0-1</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Economy Authority</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    server/nakama/tekton_admin.js, user_profile_manager.gd
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Stop trusting client prices, categories, package IDs. Reconstruct server-authoritative economy.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Create server catalog mapping item IDs to category, price, currency type, stack rules.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Change purchase request so client sends only item ID, quantity, and optional idempotency key.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Validate balance and inventory capacity server-side before mutation.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Replace fake currency purchase with receipt verification placeholder interface per platform.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Write wallet/inventory mutation audit entry with user ID, request ID, before/after values.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P0-1">Analyze current Tekton economy flow in server/nakama/tekton_admin.js and Godot callers. Reconstruct shop purchase authority so the client no longer sends trusted price_gold, price_star, category, or reward data. Add a server-side item catalog and update rpcPurchaseItem to accept only item_id, quantity, and idempotency_key. Replace rpcBuyCurrency behavior with a receipt-verification-safe interface that records pending/verified transactions and never grants premium currency from package ID alone. Preserve existing profile/wallet behavior where possible. Add validation, normalized errors, and audit ledger writes. Update Godot callers to match new payload shape. Acceptance: no wallet or inventory mutation depends on client-submitted price/category/package intent; duplicate idempotency key does not duplicate grant; existing shop UI can still request purchases.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P0-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Call `rpcPurchaseItem` with modified price/category from client. Assert server rejects or ignores client price and uses catalog price. Assert duplicate idempotency keys return the exact same transaction result without deducting twice.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P0-1">**Completed [PRD-P0-1]: Economy Authority**
-- **Goal:** Stop trusting client prices, categories, package IDs. Reconstruct server-authoritative economy.
-- **Status:** Integrated & verified. Code changes applied to: server/nakama/tekton_admin.js, user_profile_manager.gd</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P0-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P0-2</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Gacha Authority</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    gacha_manager.gd, Nakama economy RPCs
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Move RNG, pity, cost consume, and rewards server-side.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add server RPC for gacha pull with banner ID, pull count, and idempotency key.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Store pity and banner state server-side.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Server consumes cost, rolls reward, writes item/fragment result, and returns canonical result.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Client only animates returned result; no local grant or deduction.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add migration note for existing local pity/fragment data.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P0-2">Refactor Tekton gacha so authority lives in Nakama. Read scripts/managers/gacha_manager.gd, user_profile_manager.gd, and server/nakama/tekton_admin.js before editing. Add server-side RPCs for gacha_pull and any needed banner/profile state. Server must own RNG, pity counter, cost deduction, reward choice, inventory/fragment writes, and audit/idempotency. Client must become presentation-only: it sends banner_id, pull_count, and idempotency_key, then animates the canonical server response. Remove local reward grant and local currency deduction from gacha_manager.gd. Acceptance: editing client RNG/pity code cannot change real rewards; duplicate pull request cannot duplicate rewards; profile refresh after pull shows server state.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P0-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Trigger `rpcGachaPull`. Assert client currency deduction happens only upon server response. Assert client cannot specify reward or manipulate RNG seed.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P0-2">**Completed [PRD-P0-2]: Gacha Authority**
-- **Goal:** Move RNG, pity, cost consume, and rewards server-side.
-- **Status:** Integrated & verified. Code changes applied to: gacha_manager.gd, Nakama economy RPCs</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P0-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P0-3</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Auth & Secrets Lock</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    auth_manager.gd, nakama_manager.gd, project.godot
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Remove insecure Steam fallback, default App ID 480, hardcoded release secrets.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Replace production Steam App ID placeholder only when real ID exists.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Fail hard in Steam build if Steam ticket cannot be acquired.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Remove fallback email/custom auth from Steam release path.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Externalize server host, scheme, key, encryption key, and secrets.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Delete or environment-gate admin topup RPC and admin UI entry points.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P0-3">Audit and harden Tekton authentication and admin mutation paths. Read project.godot, scripts/services/steamworks_manager.gd, scripts/managers/auth_manager.gd, scripts/nakama_manager.gd, scripts/ui/admin_panel.gd, and server/nakama/tekton_admin.js. Remove insecure Steam release fallback behavior so Steam builds authenticate only with valid Steam tickets. Add clear release guards for Steam App ID 480 so production export fails or warns loudly if still using test ID. Externalize backend config and local encryption material away from hardcoded production defaults. Remove or environment-gate rpcAdminTopupGold and ensure admin panel scenes/scripts are not included in player exports unless explicitly feature-flagged. Acceptance: Steam build cannot silently fall back to insecure auth; test App ID 480 is blocked for production; admin mint path is unavailable in production runtime.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P0-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Export project with Steam features. Disconnect Steam client. Assert game fails to authenticate and does NOT fallback to custom/device auth. Assert admin UI is entirely hidden in release builds.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P0-3">**Completed [PRD-P0-3]: Auth & Secrets Lock**
-- **Goal:** Remove insecure Steam fallback, default App ID 480, hardcoded release secrets.
-- **Status:** Integrated & verified. Code changes applied to: auth_manager.gd, nakama_manager.gd, project.godot</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P0-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P0-4</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Backend Deploy Safety</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    server/, Nakama runtime module
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Replace manual module copy/restart with staging/prod deploy, health check, rollback.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Separate dev/staging/prod Nakama config and secrets.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Script module package/copy/restart with version label.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add health check RPC after deploy.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Keep previous module artifact for rollback.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add smoke checklist: auth, profile, shop, mail, gacha, friends, leaderboard.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P0-4">Create a production-safe Nakama deployment workflow for Tekton. Review server/docker-compose.yaml, server/nakama/README.md, and current runtime module layout. Replace manual docker cp guidance with scripts or documented commands for staging and production deploys. Include environment-specific config/secrets, module version labeling, restart procedure, health check, smoke test commands, and rollback to previous module. Do not commit real secrets. Acceptance: a developer can deploy to staging, verify health, promote to production, and rollback using documented repeatable steps without manually editing containers.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P0-4').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Run deploy script. Assert Nakama server restarts without losing data. Trigger health check RPC to verify new module loaded successfully.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P0-4">**Completed [PRD-P0-4]: Backend Deploy Safety**
-- **Goal:** Replace manual module copy/restart with staging/prod deploy, health check, rollback.
-- **Status:** Integrated & verified. Code changes applied to: server/, Nakama runtime module</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P0-4').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P0-1</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Spawn/Sync Authority Lock</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    main.gd, player.gd
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Retain: deterministic pre-spawn sync. Remove: client-trusted teleport/update paths.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Keep deterministic pre-spawn strategy (client pre-creates lobby roster).</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Remove client-trusted position mutation path that can move authoritative state without server validation.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Introduce server-owned spawn_revision and state_revision integers.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Reject stale updates on client and server.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Ensure reconnect flow requests full player sync, then grid sync, then mode-specific sync.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P0-1">Audit and harden player spawn/sync authority in scenes/main.gd and scenes/player.gd. Keep deterministic pre-spawn strategy and existing server-authoritative item randomization pattern, but remove any client-trusted position mutation path that can move authoritative state without server validation. Introduce server-owned spawn_revision and state_revision integers sent with spawn and full-sync payloads. Reject stale updates on client and server. Ensure reconnect flow requests full player sync first, then full grid sync, then mode-specific sync (Stop n Go / Tekton Doors) with explicit ack step. Acceptance: client cannot force authoritative teleport; reconnecting client converges to identical player positions/goals/playerboards after one sync cycle; stale packets no longer overwrite newer state.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P0-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Simulate client sending stale spawn_revision. Assert server rejects. Reconnect mid-match, assert player converges to exact same grid position as before.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P0-1">**Completed [PRD-GF-P0-1]: Spawn/Sync Authority Lock**
-- **Goal:** Retain: deterministic pre-spawn sync. Remove: client-trusted teleport/update paths.
-- **Status:** Integrated & verified. Code changes applied to: main.gd, player.gd</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P0-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P0-2</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Lobby Start Gate Hardening</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    lobby.gd, lobby_manager.gd
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Add preflight checklist RPC, check ready-state and host authority.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Preserve LAN/Nakama dual-mode behavior and tutorial fast path.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add preflight readiness checks before _on_game_starting transition.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Verify session valid, host authority true, all player records present, mode config validated.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add one typed preflight result object and render actionable errors.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P0-2">Rework lobby game-start gating in scenes/lobby.gd and scripts/managers/lobby_manager.gd. Preserve LAN/Nakama dual-mode behavior and tutorial fast path, but add preflight readiness checks before _on_game_starting transition: session valid (or explicit guest/LAN mode), host authority true, all required player records present, mode config validated, and scene dependencies reachable. Add one typed preflight result object and render actionable errors in connection_status/status_label. Acceptance: start button cannot trigger broken scene load with partial state; host and clients see same preflight result; loading screen transition only occurs after preflight pass.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P0-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Attempt to start match without full player records. Assert UI blocks start and shows specific error string from preflight check.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P0-2">**Completed [PRD-GF-P0-2]: Lobby Start Gate Hardening**
-- **Goal:** Add preflight checklist RPC, check ready-state and host authority.
-- **Status:** Integrated & verified. Code changes applied to: lobby.gd, lobby_manager.gd</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P0-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P0-3</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">RPC Sender Identity & Contract Clamp</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    main.gd, player.gd, lobby_manager.gd
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Remove payload fields that claim identity. Validate sender natively.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Read all any_peer RPC entry points.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Remove payload fields that pretend to identify requester/authority (use get_remote_sender_id).</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Verify sender identity and authority explicitly for state-mutation RPCs.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Normalize RPC contracts to carry stable error codes.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P0-3">Clamp multiplayer RPC trust boundaries across scenes/main.gd, scenes/player.gd, and scripts/managers/lobby_manager.gd. Read all any_peer RPC entry points before editing. Keep fast RPC update flow, but remove payload fields that pretend to identify requester/authority when sender can be derived from multiplayer.get_remote_sender_id(). For room info, start flow, rematch, and state-mutation RPCs, verify sender identity and authority explicitly. Normalize RPC contracts so request payloads contain only data the caller is allowed to propose, and response payloads carry canonical server state plus stable error codes. Acceptance: spoofed requester IDs are ignored; unauthorized peers cannot mutate host/server-owned state; RPC errors are debuggable and consistent.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P0-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Call state-mutation RPC pretending to be another peer ID in payload. Assert server overrides payload with actual `get_remote_sender_id()` and blocks if unauthorized.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P0-3">**Completed [PRD-GF-P0-3]: RPC Sender Identity & Contract Clamp**
-- **Goal:** Remove payload fields that claim identity. Validate sender natively.
-- **Status:** Integrated & verified. Code changes applied to: main.gd, player.gd, lobby_manager.gd</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P0-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-rose-500/30 bg-rose-50 dark:bg-rose-500/10 text-rose-600 dark:text-rose-300 text-xs font-bold">P0</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P0-4</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Chat/DM Abuse Control</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    lobby.gd, Nakama chat
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Add moderation, throttling, sanitation, flood guard, and permission matrix.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Keep current channel UX, DM tabs, and history pull.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add per-user send cooldown and max payload length limits.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add command permission matrix (/clear admin only, all other slash commands explicit).</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Mark unsent/failed messages in UI with retry policy.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P0-4">Harden global chat and DM flow in scenes/lobby.gd and related Nakama chat policy. Keep current channel UX, DM tabs, and history pull, but add abuse controls: per-user send cooldown, max payload length, profanity/moderation hook placeholder, and command permission matrix (/clear admin only, all other slash commands explicit). Fix any DM append/state bug found during read-through. Prevent silent local-only divergence by marking unsent/failed messages in UI and retry policy. Acceptance: flood attempts are throttled; unauthorized command execution blocked server-side; message rendering sanitized and bounded; chat remains responsive under burst traffic.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P0-4').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Send 50 chat messages in 1 second. Assert Nakama throttles request and UI shows 'failed to send/cooldown' UI marker. Attempt `/clear` as non-admin, assert blocked.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P0-4">**Completed [PRD-GF-P0-4]: Chat/DM Abuse Control**
-- **Goal:** Add moderation, throttling, sanitation, flood guard, and permission matrix.
-- **Status:** Integrated & verified. Code changes applied to: lobby.gd, Nakama chat</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P0-4').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P1-1</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Module Split & RPC Validation</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    tekton_admin.js
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Split monolith into auth, economy, admin, mail, social, leaderboard, validation helpers.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Refactor tekton_admin.js into domain modules without changing external RPC names.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Create modules for auth, economy, admin, mail, social, leaderboard, storage, validation.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add central validators for payload shape, types, limits.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add normalized error responses with stable error codes.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P1-1">Refactor server/nakama/tekton_admin.js into maintainable domain modules without changing external RPC names unless necessary. Create or plan modules for auth, economy, admin, mail, social, leaderboard, storage, and validation helpers. Add central validators for payload shape, types, limits, and allowed enum values. Add normalized error responses with stable error codes. Keep behavior compatible while moving code in small steps. Acceptance: RPC registration remains clear; each RPC validates payload before mutation; error responses are consistent; module split does not break existing smoke tests.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P1-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Call split RPC with missing payload fields. Assert central validator catches it and returns `INVALID_ARGUMENT` standard error code.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P1-1">**Completed [PRD-P1-1]: Module Split & RPC Validation**
-- **Goal:** Split monolith into auth, economy, admin, mail, social, leaderboard, validation helpers.
-- **Status:** Integrated & verified. Code changes applied to: tekton_admin.js</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P1-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P1-2</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Ledger, Idempotency & Storage Model</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    Wallet, inventory, fragments, mail rewards
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Add mutation audit ledger, idempotency keys, and canonical fragment storage path.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Define one canonical fragment storage location and migration path.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add idempotency keys for mail claim, daily reward, purchase, gacha, and admin adjustments.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add audit records with source, user_id, mutation type, request_id.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Make mail claim transactional (claim, mark, return canonical state).</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P1-2">Implement a canonical mutation ledger and idempotency policy for Tekton live-service rewards. Read server/nakama/tekton_admin.js, scripts/managers/user_profile_manager.gd, scripts/managers/mail_manager.gd, and gacha/profile storage code. Define one canonical fragment storage location and migration path. Add idempotency keys for mail claim, daily reward, purchase, gacha, and admin adjustments. Add audit records with source, user_id, mutation type, request_id, before/after summary, and timestamp. Make mail claim transactional: claim rewards, mark claimed, and return canonical updated state in one server response. Acceptance: repeated claim/purchase/reward requests do not duplicate grants; fragments read/write from one canonical path; mail UI refreshes from server-returned state.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P1-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Send identical mail claim RPC twice simultaneously. Assert only one processes successfully and the second returns 'already claimed'.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P1-2">**Completed [PRD-P1-2]: Ledger, Idempotency & Storage Model**
-- **Goal:** Add mutation audit ledger, idempotency keys, and canonical fragment storage path.
-- **Status:** Integrated & verified. Code changes applied to: Wallet, inventory, fragments, mail rewards</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P1-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P1-3</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Client Backend Facade</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    nakama_manager.gd, auth_manager.gd, backend_service.gd
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Make one typed backend owner for session, socket, RPC calls, and central errors.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Decide whether BackendService becomes the sole typed backend facade or is deleted.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Implement one owner for client/session/socket.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add typed methods for RPCs, central error handling.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Remove direct UI RPC scatter for economy/auth/mail/gacha/social flows.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P1-3">Clean up Tekton client backend ownership. Read scripts/nakama_manager.gd, scripts/managers/auth_manager.gd, scripts/services/backend_service.gd, and UI/manager scripts that call NakamaManager.client.rpc_async directly. Decide whether BackendService becomes the sole typed backend facade or is deleted. Implement chosen direction in small steps: one owner for client/session/socket, typed methods for RPCs, central error handling, and no direct UI RPC scatter for economy/auth/mail/gacha/social flows. Acceptance: UI calls typed service/manager methods, not raw client.rpc_async; session/socket ownership is clear; duplicate auth/bootstrap code is removed or delegated.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P1-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Global search for `client.rpc_async` in `scripts/ui/`. Assert 0 results found (all go through facade).</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P1-3">**Completed [PRD-P1-3]: Client Backend Facade**
-- **Goal:** Make one typed backend owner for session, socket, RPC calls, and central errors.
-- **Status:** Integrated & verified. Code changes applied to: nakama_manager.gd, auth_manager.gd, backend_service.gd</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P1-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P1-1</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Tutorial Isolation Contract</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    tutorial_manager.gd
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Remove multiplayer-side effects during pause/freeze phases. Isolate tutorial boundaries.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Keep onboarding sequence and camera storytelling.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Enforce contract: no persistent wallet/profile mutation during tutorial.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Ensure no shared lobby state leakage.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Ensure clean bot/timer restore on exit, deterministic return-to-lobby handshake.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Replace broad pause/freeze side effects with scoped tutorial-state toggles.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P1-1">Isolate tutorial runtime from multiplayer/session side effects. Review scripts/managers/tutorial_manager.gd and match lifecycle hooks. Keep onboarding sequence and camera storytelling, but enforce tutorial contract: no persistent wallet/profile mutation, no shared lobby state leakage, clean bot/timer restore on exit, deterministic return-to-lobby handshake. Replace broad pause/freeze side effects with scoped tutorial-state toggles where possible. Acceptance: exiting tutorial leaves no stale bot freeze, no leaked paused systems, and no corrupted room/session flags.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P1-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Abort tutorial midway. Assert main game tree is fully unpaused, bots are reset, and no 'tutorial_active' flags leak into lobby.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P1-1">**Completed [PRD-GF-P1-1]: Tutorial Isolation Contract**
-- **Goal:** Remove multiplayer-side effects during pause/freeze phases. Isolate tutorial boundaries.
-- **Status:** Integrated & verified. Code changes applied to: tutorial_manager.gd</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P1-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P1-2</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Mode Config Completeness</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    main.gd, lobby mode configs
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Remove duplicated/inconsistent option toggles. Add schema-driven validation.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Keep existing Stop n Go custom UI.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Remove duplicated/fragile control toggles.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Implement Tekton Doors options with same host-authoritative lock and sync callbacks.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Introduce schema-driven config validation shared by host, client, and bootstrap.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P1-2">Complete mode-configuration parity between Stop n Go and Tekton Doors in lobby and match bootstrap flow. Keep existing Stop n Go custom UI, but remove duplicated/fragile control toggles and implement Tekton Doors options with same host-authoritative lock and sync callbacks. Introduce schema-driven config validation shared by host, client display logic, and match bootstrap. Acceptance: both modes expose full validated config; non-host clients always mirror host values; invalid config rejected before match start.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P1-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Join as client, attempt to spoof mode config RPC. Assert host rejects invalid mode config changes and overrides client.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P1-2">**Completed [PRD-GF-P1-2]: Mode Config Completeness**
-- **Goal:** Remove duplicated/inconsistent option toggles. Add schema-driven validation.
-- **Status:** Integrated & verified. Code changes applied to: main.gd, lobby mode configs</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P1-2').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P1-3</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Backend Facade & Flow Decoupling</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    backend_service.gd, UI panels
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Improve service ownership and typed errors. Add one backend facade.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Identify remaining UI/manager scripts calling client.rpc_async.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Migrate calls to the central BackendService or unified manager.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Implement central error mapping and retry policy.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Verify all gameflow-adjacent UI uses new typed methods.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P1-3">Finish client backend decoupling for gameflow-adjacent live-service features. Read scripts/services/backend_service.gd plus UI/manager scripts that still call NakamaManager.client.rpc_async directly (profile, social, leaderboard, daily reward, mail, admin, friend flows). Decide whether BackendService becomes real facade or is removed. Implement one typed backend owner for auth/session/socket/RPC calls, central error mapping, and retry policy. Acceptance: gameflow-adjacent UI does not call raw client.rpc_async directly for production paths; backend ownership is obvious; future auth/RPC changes touch one service layer first, not many UI panels.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P1-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Trigger network failure during profile fetch. Assert BackendService retry policy handles it gracefully without UI hard-crashing.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P1-3">**Completed [PRD-GF-P1-3]: Backend Facade & Flow Decoupling**
-- **Goal:** Improve service ownership and typed errors. Add one backend facade.
-- **Status:** Integrated & verified. Code changes applied to: backend_service.gd, UI panels</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P1-3').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-amber-500/30 bg-amber-50 dark:bg-amber-500/10 text-amber-600 dark:text-amber-300 text-xs font-bold">P1</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P1-4</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Versioning & Patch Integrity</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    tools/, export_presets.cfg, version.json
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Single release version source, checksums, compatibility rules, changelog archive.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Create one release version source (version.json or python script).</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Update project version, export versions, Android version deterministically.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Update patch manifest and changelog archive.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add patch integrity fields: checksum, size, minimum compatible app version.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P1-4">Rebuild Tekton versioning workflow. Review tools/generate_version_json.py, tools/build_patch.gd, export_presets.cfg, project.godot, assets/data/version.json, README.md, and CHANGELOG_DRAFT.md. Create one release version source and update all platform metadata deterministically: project version, export versions, Android version/code, patch manifest, changelog archive, and Git tag instructions. Add patch integrity fields such as checksum, size, minimum compatible app version, and signature placeholder if signing is not available yet. Acceptance: one command or documented flow bumps release version; generated metadata matches across files; patch manifest can reject incompatible or corrupted patch.pck.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P1-4').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Run version bump script. Assert export_presets.cfg Android version code increments correctly and patch manifest checksum is updated.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P1-4">**Completed [PRD-P1-4]: Versioning & Patch Integrity**
-- **Goal:** Single release version source, checksums, compatibility rules, changelog archive.
-- **Status:** Integrated & verified. Code changes applied to: tools/, export_presets.cfg, version.json</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P1-4').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-violet-500/30 bg-violet-50 dark:bg-violet-500/10 text-violet-600 dark:text-violet-300 text-xs font-bold">P2</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-P2-1</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Steam Depot & Store Packaging</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    tools/steam/, export presets
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Create SteamPipe VDFs, branch SOP, signing/notarization, platform filters.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Create tools/steam/app_build_<STEAM_APP_ID>.vdf and per-platform depot templates.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Document steamcmd upload command, branch promotion path.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Add guidance for Windows signing, macOS notarization, Android package name.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Configure store-specific export filters.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-P2-1">Add Steam and storefront release packaging workflow for Tekton after P0/P1 backend gates are complete. Review export_presets.cfg, docs/STEAMWORKS_SETUP.md, README.md, and current build output conventions. Create tools/steam/app_build_<STEAM_APP_ID>.vdf and per-platform depot VDF templates using placeholders only. Document steamcmd upload command, branch promotion path internal -> beta -> default, and smoke tests required before promotion. Add guidance for Windows signing, macOS bundle/team/notarization, Android final package name/version code, and store-specific export filters so Steam libraries are not shipped in non-Steam builds. Acceptance: no real IDs/secrets committed; SteamPipe templates exist; release checklist blocks default branch promotion until smoke tests pass.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-P2-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Trigger dry-run of SteamPipe VDF. Assert paths resolve to output directory without committing real credentials.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-P2-1">**Completed [PRD-P2-1]: Steam Depot & Store Packaging**
-- **Goal:** Create SteamPipe VDFs, branch SOP, signing/notarization, platform filters.
-- **Status:** Integrated & verified. Code changes applied to: tools/steam/, export presets</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-P2-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-                <details class="group bg-white dark:bg-slate-950 border border-slate-200 dark:border-slate-800 rounded-xl shadow-sm overflow-hidden" open>
-                    <summary class="flex items-center justify-between p-4 cursor-pointer bg-slate-50 dark:bg-slate-900/50 hover:bg-slate-100 dark:hover:bg-slate-900 transition list-none outline-none">
-                        <div class="flex items-center space-x-4">
-                            <span class="px-2 py-1 rounded border border-violet-500/30 bg-violet-50 dark:bg-violet-500/10 text-violet-600 dark:text-violet-300 text-xs font-bold">P2</span>
-                            <span class="font-mono text-xs text-slate-500 dark:text-slate-400">PRD-GF-P2-1</span>
-                            <h3 class="text-md font-bold text-slate-900 dark:text-white">Dead Path, Debug Gate & Telemetry Cleanup</h3>
-                        </div>
-                        <div class="flex items-center space-x-3 text-slate-400">
-                            <span class="text-xs font-semibold uppercase tracking-wider hidden md:inline-block border border-slate-200 dark:border-slate-700 px-2 py-1 rounded">TODO</span>
-                            <i data-lucide="chevron-down" class="w-5 h-5 transition-transform group-open:rotate-180"></i>
-                        </div>
-                    </summary>
-                    <div class="p-5 border-t border-slate-200 dark:border-slate-800 grid grid-cols-1 lg:grid-cols-2 gap-6">
-                        <!-- Left Column: Details & Checklists -->
-                        <div>
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Files / Areas</h4>
-                                <div class="text-xs font-mono text-sky-600 dark:text-sky-400 bg-sky-50 dark:bg-sky-500/10 border border-sky-200 dark:border-sky-500/20 px-2 py-1 rounded-md inline-block">
-                                    main.gd, player.gd, placeholders
-                                </div>
-                            </div>
-                            
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Goal / Risk</h4>
-                                <p class="text-sm text-slate-700 dark:text-slate-300">Remove release-noisy debug hooks. Add safe-remove candidate matrix + SLO dashboard.</p>
-                            </div>
-
-                            <div class="mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-2">Execution Checklist</h4>
-                                <ul class="space-y-2 text-sm text-slate-700 dark:text-slate-300">
-                                    <li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Build matrix: keep, safe-remove, needs-runtime-proof, feature-flag.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Remove or feature-gate release-only noise (e.g., debug key hooks, excessive prints).</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Instrument events: room_joined, preflight_pass, loading_screen, match_sync.</span></li><li class="flex items-start"><i data-lucide="square" class="w-4 h-4 mr-2 mt-0.5 text-slate-400 shrink-0"></i> <span>Do not delete autoload/runtime-loaded scripts without proof.</span></li>
-                                </ul>
-                            </div>
-                        </div>
-
-                        <!-- Right Column: AI Prompt & Testing -->
-                        <div class="flex flex-col space-y-4">
-                            <div class="bg-indigo-50 dark:bg-indigo-500/5 border border-indigo-200 dark:border-indigo-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-indigo-600 dark:text-indigo-400 mb-2 flex items-center"><i data-lucide="bot" class="w-4 h-4 mr-2"></i> AI Execution Prompt</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-mono h-32 overflow-y-auto" id="prompt-PRD-GF-P2-1">Create dead-path/debug-path cleanup and telemetry gates for lobby-to-match lifecycle. Review main.gd, player.gd, login_screen.gd, backend_service.gd, and other placeholders/debug hooks. Build matrix with columns: keep, safe-remove, needs-runtime-proof, feature-flag. Remove or feature-gate release-only noise such as debug key hooks and excessive prints, but do not delete autoload/runtime-loaded scripts without proof. Instrument events: room_joined, preflight_pass/fail, loading_screen_start/finish, match_sync_complete, reconnect_success/fail, match_end_summary. Acceptance: safe-remove candidates are evidence-backed; release export excludes debug-only hooks; branch promotion can check match-start and reconnect SLO metrics.</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('prompt-PRD-GF-P2-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Prompt">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-
-                            <div class="bg-emerald-50 dark:bg-emerald-500/5 border border-emerald-200 dark:border-emerald-500/20 rounded-lg p-4 mb-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-emerald-600 dark:text-emerald-400 mb-2 flex items-center"><i data-lucide="test-tube" class="w-4 h-4 mr-2"></i> Testing / Auto-Check</h4>
-                                <p class="text-xs text-slate-700 dark:text-slate-300 font-mono leading-relaxed">AI AUTO-CHECK: Search codebase for `Input.is_key_pressed(KEY_F9)`. Assert wrapped in `OS.has_feature("debug")` or completely removed.</p>
-                            </div>
-
-                            <div class="bg-sky-50 dark:bg-sky-500/5 border border-sky-200 dark:border-sky-500/20 rounded-lg p-4">
-                                <h4 class="text-xs font-semibold uppercase tracking-wider text-sky-600 dark:text-sky-400 mb-2 flex items-center"><i data-lucide="message-square" class="w-4 h-4 mr-2"></i> MS Teams Daily Report</h4>
-                                <div class="relative group">
-                                    <pre class="text-xs text-slate-700 dark:text-slate-300 whitespace-pre-wrap font-sans" id="teams-PRD-GF-P2-1">**Completed [PRD-GF-P2-1]: Dead Path, Debug Gate & Telemetry Cleanup**
-- **Goal:** Remove release-noisy debug hooks. Add safe-remove candidate matrix + SLO dashboard.
-- **Status:** Integrated & verified. Code changes applied to: main.gd, player.gd, placeholders</pre>
-                                    <button onclick="navigator.clipboard.writeText(document.getElementById('teams-PRD-GF-P2-1').textContent)" class="absolute top-0 right-0 p-1.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-md shadow-sm text-slate-500 hover:text-sky-500 opacity-0 group-hover:opacity-100 transition" title="Copy Teams Report">
-                                        <i data-lucide="copy" class="w-4 h-4"></i>
-                                    </button>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </details>
-
-            </div>
-		</section>
-</main>
-
-	<!-- Footer -->
-	<footer class="border-t border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-950 py-10 mt-20 text-center">
-		<p class="text-xs text-slate-500 dark:text-slate-400 font-mono">
-			Blueprint released under MIT authorization. Secure server implementations are responsibility of the
-			deployment architecture team.
-		</p>
-	</footer>
-
-	<!-- Interactive Script Operations -->
-	<script>
-		// Init Lucide Icons
-		lucide.createIcons();
-
-		// Highlight flowchart pipelines
-		function highlightPath(target) {
-			// Remove selection formatting from all controls
-			document.querySelectorAll('.path-ctrl-btn').forEach(btn => {
-				btn.classList.remove('bg-sky-500', 'text-slate-950', 'shadow-md');
-				btn.classList.add('text-slate-600 dark:text-slate-400', 'hover:text-slate-900 dark:text-white');
-			});
-			// Assign selection styles to current target control
-			const activeBtn = document.getElementById('btn-path-' + target);
-			if (activeBtn) {
-				activeBtn.classList.add('bg-sky-500', 'text-slate-950', 'shadow-md');
-				activeBtn.classList.remove('text-slate-600 dark:text-slate-400', 'hover:text-slate-900 dark:text-white');
-			}
-
-			// Target elements to manipulate
-			const branches = {
-				steam: document.getElementById('branch-steam'),
-				android: document.getElementById('branch-android'),
-				ios: document.getElementById('branch-ios'),
-				fallback: document.getElementById('branch-fallback')
-			};
-
-			const root = document.getElementById('node-root');
-			const terminal = document.getElementById('node-terminal');
-			const lineRoot = document.getElementById('line-root');
-			const lineTerminal = document.getElementById('line-terminal');
-
-			// Apply opacity filters based on selection
-			if (target === 'all') {
-				Object.values(branches).forEach(b => {
-					b.classList.remove('opacity-25', 'border-sky-500/50');
-					b.classList.add('opacity-100');
-				});
-				root.classList.remove('opacity-50');
-				terminal.classList.remove('opacity-50');
-				lineRoot.classList.remove('bg-slate-200 dark:bg-slate-800/20');
-				lineTerminal.classList.remove('bg-slate-200 dark:bg-slate-800/20');
-			} else {
-				root.classList.remove('opacity-50');
-				terminal.classList.remove('opacity-50');
-				lineRoot.classList.remove('bg-slate-200 dark:bg-slate-800/20');
-				lineTerminal.classList.remove('bg-slate-200 dark:bg-slate-800/20');
-
-				Object.keys(branches).forEach(key => {
-					if (key === target) {
-						branches[key].classList.remove('opacity-25');
-						branches[key].classList.add('opacity-100', 'border-sky-500/50');
-					} else {
-						branches[key].classList.add('opacity-25');
-						branches[key].classList.remove('opacity-100', 'border-sky-500/50');
-					}
-				});
-			}
-		}
-
-		// Switch Store Tabs UI
-		function switchTab(platform) {
-			// Hide all contents
-			document.querySelectorAll('.tab-content').forEach(content => {
-				content.classList.add('hidden');
-			});
-			// Show target
-			document.getElementById('content-' + platform).classList.remove('hidden');
-
-			// Deactivate all buttons
-			document.querySelectorAll('#store-tabs button').forEach(btn => {
-				btn.classList.remove('bg-slate-200 dark:bg-slate-800', 'text-slate-900 dark:text-white');
-				btn.classList.add('text-slate-600 dark:text-slate-400');
-			});
-			// Activate target button
-			const activeBtn = document.getElementById('tab-' + platform);
-			activeBtn.classList.remove('text-slate-600 dark:text-slate-400');
-			activeBtn.classList.add('bg-slate-200 dark:bg-slate-800', 'text-slate-900 dark:text-white');
-		}
-	</script>
-
-    
-    <script>
-        // Init Lucide Icons
-        lucide.createIcons();
-
-        // Theme logic
-        function toggleTheme() {
-            if (document.documentElement.classList.contains('dark')) {
-                document.documentElement.classList.remove('dark');
-                localStorage.setItem('theme', 'light');
-            } else {
-                document.documentElement.classList.add('dark');
-                localStorage.setItem('theme', 'dark');
-            }
-        }
-
-        // Init theme
-        if (localStorage.theme === 'dark' || (!('theme' in localStorage) && window.matchMedia('(prefers-color-scheme: dark)').matches)) {
-            if (localStorage.theme === 'dark') {
-                document.documentElement.classList.add('dark');
-            } else {
-                document.documentElement.classList.remove('dark');
-            }
-        } else {
-            document.documentElement.classList.remove('dark');
-        }
-        document.getElementById('theme-toggle').addEventListener('click', toggleTheme);
-    </script>
-</body>
-
-</html>

export_presets.cfg

@@ -1,14 +1,20 @@
+[runnable_presets]
+
+"Windows Desktop"="Windows Desktop"
+Android="Android"
+macOS="macOS"
+Linux="Linux/X11"
+
 [preset.0]
 
 name="Windows Desktop"
 platform="Windows Desktop"
-runnable=true
 dedicated_server=false
 custom_features=""
 export_filter="all_resources"
 include_filter=""
 exclude_filter=""
-export_path="build/tekton_armageddon_v2.4.1.exe"
+export_path="build/windows/tekton_armageddon_v2.4.3.exe"
 patches=PackedStringArray()
 patch_delta_encoding=false
 patch_delta_compression_level_zstd=19
@@ -42,8 +48,8 @@ application/modify_resources=false
 application/icon=""
 application/console_wrapper_icon=""
 application/icon_interpolation=4
-application/file_version="2.4.1"
+application/file_version="2.4.2"
-application/product_version="2.4.1"
+application/product_version="2.4.2"
 application/company_name="DanchieGo"
 application/product_name="Tekton Armageddon"
 application/file_description=""
@@ -74,13 +80,12 @@ Remove-Item -Recurse -Force '{temp_dir}'"
 
 name="Android"
 platform="Android"
-runnable=true
 dedicated_server=false
 custom_features=""
 export_filter="all_resources"
 include_filter=""
 exclude_filter=""
-export_path="build/tekton-dash-armageddon-v.2.4.1.apk"
+export_path="build/tekton-dash-armageddon-v.2.4.3.apk"
 patches=PackedStringArray()
 patch_delta_encoding=false
 patch_delta_compression_level_zstd=19
@@ -111,7 +116,7 @@ architectures/arm64-v8a=true
 architectures/x86=false
 architectures/x86_64=false
 version/code=3
-version/name="2.4.1"
+version/name="2.4.2"
 package/unique_name="com.danchiego.$genname"
 package/name="Tekton Dash Armageddon"
 package/signed=true
@@ -136,11 +141,12 @@ screen/support_normal=true
 screen/support_large=true
 screen/support_xlarge=true
 screen/background_color=Color(0, 0, 0, 1)
+splash_screen/disable_godot_boot_splash=false
+splash_screen/icon=""
+splash_screen/branding_image=""
+splash_screen/background_color=Color(0, 0, 0, 1)
 user_data_backup/allow=false
 command_line/extra_args=""
-apk_expansion/enable=false
-apk_expansion/SALT=""
-apk_expansion/public_key=""
 permissions/custom_permissions=PackedStringArray()
 permissions/access_checkin_properties=false
 permissions/access_coarse_location=false
@@ -295,18 +301,20 @@ permissions/write_sms=false
 permissions/write_social_stream=false
 permissions/write_sync_settings=false
 permissions/write_user_dictionary=false
+apk_expansion/enable=false
+apk_expansion/SALT=""
+apk_expansion/public_key=""
 
 [preset.2]
 
 name="macOS"
 platform="macOS"
-runnable=true
 dedicated_server=false
 custom_features=""
 export_filter="all_resources"
 include_filter=""
 exclude_filter=""
-export_path="build/tekton_armageddon_v2.4.1.zip"
+export_path="build/tekton_armageddon_v2.4.3.zip"
 patches=PackedStringArray()
 patch_delta_encoding=false
 patch_delta_compression_level_zstd=19
@@ -330,7 +338,7 @@ debug/export_console_wrapper=0
 application/liquid_glass_icon=""
 application/icon=""
 application/icon_interpolation=4
-application/bundle_identifier=""
+application/bundle_identifier="com.danchiego.tektonarmageddon"
 application/signature=""
 application/app_category="Games"
 application/short_version=""
@@ -565,8 +573,8 @@ codesign/digest_algorithm=1
 codesign/identity_type=0
 application/modify_resources=false
 application/console_wrapper_icon=""
-application/file_version="2.4.1"
+application/file_version="2.4.2"
-application/product_version="2.4.1"
+application/product_version="2.4.2"
 application/company_name="DanchieGo"
 application/product_name="Tekton Armageddon"
 application/file_description=""
@@ -576,13 +584,12 @@ application/trademarks=""
 
 name="Linux/X11"
 platform="Linux"
-runnable=true
 dedicated_server=false
 custom_features=""
 export_filter="all_resources"
 include_filter=""
 exclude_filter=""
-export_path="build/tekton_armageddon_v2.4.1.x86_64"
+export_path="build/linux/tekton_armageddon_v2.4.3.x86_64"
 patches=PackedStringArray()
 patch_delta_encoding=false
 patch_delta_compression_level_zstd=19

godot-ai-LICENSE.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Godot AI contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

patch_version.py

@@ -1,37 +0,0 @@
-import json
-from datetime import date
-
-with open("assets/data/version.json", "r", encoding="utf-8") as f:
-    data = json.load(f)
-
-# Find the 2.4.0 entry or just add 2.4.1 at the top
-changelog = [
-    "Fixed Gauntlet map layout to remove red unpassable barrier blocks and center blocks.",
-    "Fixed Gauntlet mode to prevent powerups or sticky bubbles from spawning on boundary tiles or under the central cannon.",
-    "Center Candy Cannon now shoots actual projectiles that fly towards sticky cells and leave a VFX trail.",
-    "Added new VFX to the Center Candy Cannon. It now has a glowing pink tank and spinning metallic rings.",
-    "Fixed Gauntlet Cleanser to stack charges instead of capping at 1.",
-    "Cleanser instantly clears a 3x3 AoE of sticky cells and frees any players inside immediately upon activation.",
-    "Added VFX and SFX when purifying cells with the Cleanser (cyan burst particles).",
-    "Added instant visual feedback indicator for Gauntlet Cleanser using popup text when consumed.",
-    "Fixed Gauntlet Cleanser UI phase label layout to ensure it does not overlap with other UI elements."
-]
-
-new_release = {
-    "version": "2.4.1",
-    "date": "2026-06-28",
-    "pck_url": "https://raw.githubusercontent.com/adtpdn/tekton-updates/main/latest/patch.pck",
-    "pck_size": 0,
-    "changelog": changelog
-}
-
-# Remove existing 2.4.1 if any
-data["releases"] = [r for r in data["releases"] if r.get("version") != "2.4.1"]
-
-# Insert at top
-data["releases"].insert(0, new_release)
-data["latest_version"] = "2.4.1"
-
-with open("assets/data/version.json", "w", encoding="utf-8") as f:
-    json.dump(data, f, indent="\t")
-    f.write("\n")

project.godot

@@ -15,9 +15,9 @@ compatibility/default_parent_skeleton_in_mesh_instance_3d=true
 [application]
 
 config/name="Tekton Dash Armageddon"
-config/version="2.4.1"
+config/version="2.4.3"
 run/main_scene="res://scenes/ui/boot_screen.tscn"
-config/features=PackedStringArray("4.6", "Forward Plus")
+config/features=PackedStringArray("4.7", "Forward Plus")
 boot_splash/bg_color=Color(0.16470589, 0.6745098, 0.9372549, 1)
 boot_splash/stretch_mode=0
 boot_splash/image="uid://b10e6kr508642"
@@ -38,7 +38,7 @@ GoalManager="*res://scripts/managers/goal_manager.gd"
 PlayerManager="*res://scripts/managers/player_manager.gd"
 GoalsCycleManager="*res://scripts/managers/goals_cycle_manager.gd"
 Satori="*uid://b8vev00s34b7"
-SettingsManager="*uid://c1ouaaqnn0lrc"
+SettingsManager="*res://scripts/managers/settings_manager.gd"
 SfxManager="*res://scripts/managers/sfx_manager.gd"
 NameGenerator="*res://scripts/generators/name_generator.gd"
 MusicManager="*res://scripts/managers/music_manager.gd"
@@ -67,8 +67,11 @@ enabled=PackedStringArray("res://addons/com.heroiclabs.nakama/plugin.cfg", "res:
 [file_customization]
 
 folder_colors={
+"res://addons/": "pink",
 "res://assets/": "purple",
-"res://scenes/": "green"
+"res://scenes/": "green",
+"res://scripts/": "green",
+"res://server/": "blue"
 }
 
 [input]
@@ -140,12 +143,6 @@ use_powerup={
 , Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":3,"pressure":0.0,"pressed":false,"script":null)
 ]
 }
-use_cleanser={
-"deadzone": 0.2,
-"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":69,"key_label":0,"unicode":101,"location":0,"echo":false,"script":null)
-, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":2,"pressure":0.0,"pressed":false,"script":null)
-]
-}
 action_grab_tekton={
 "deadzone": 0.5,
 "events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":71,"physical_keycode":0,"key_label":0,"unicode":103,"location":0,"echo":false,"script":null)

scenes/arena/mekton_bulls_arena.tscn

@@ -1,7 +0,0 @@
-[gd_scene load_steps=2 format=3 uid="uid://c5xk3jdg2s11m"]
-
-[node name="MektonBullsArena" type="Node3D"]
-
-[node name="GridMap" type="GridMap" parent="."]
-
-[node name="Area3D" type="Area3D" parent="."]

scenes/gauntlet_hud.tscn

@@ -47,22 +47,3 @@ theme_override_constants/outline_size = 6
 theme_override_fonts/font = ExtResource("1_font")
 text = "🍬 OPEN ARENA"
 horizontal_alignment = 1
-
-[node name="CleanserHBox" type="HBoxContainer" parent="BottomContainer/VBoxContainer"]
-layout_mode = 2
-theme_override_constants/separation = 6
-alignment = 1
-
-[node name="CleanserIcon" type="TextureRect" parent="BottomContainer/VBoxContainer/CleanserHBox"]
-layout_mode = 2
-custom_minimum_size = Vector2(20, 20)
-stretch_mode = 5
-
-[node name="CleanserLabel" type="Label" parent="BottomContainer/VBoxContainer/CleanserHBox"]
-layout_mode = 2
-theme_override_font_sizes/font_size = 20
-theme_override_colors/font_outline_color = Color(0, 0, 0, 1)
-theme_override_constants/outline_size = 6
-theme_override_fonts/font = ExtResource("1_font")
-text = "[E] Cleanser (0)"
-horizontal_alignment = 1

scenes/main.gd

@@ -17,7 +17,6 @@ var is_match_ended: bool = false
 var obstacle_manager
 var portal_mode_manager
 var gauntlet_manager
-var mekton_bulls_manager
 var vfx_manager
 
 # Minimal local state
@@ -259,14 +258,7 @@ func _init_managers():
 		gauntlet_manager.name = "GauntletManager"
 		add_child(gauntlet_manager)
 		gauntlet_manager.initialize(self, $EnhancedGridMap)
-
+	
-	# Mekton Bulls manager
-	if LobbyManager.game_mode == "Mekton Bulls":
-		mekton_bulls_manager = load("res://scripts/managers/mekton_bulls_manager.gd").new()
-		mekton_bulls_manager.name = "MektonBullsManager"
-		add_child(mekton_bulls_manager)
-		mekton_bulls_manager.initialize(self, $EnhancedGridMap)
-
 	# Screen shake manager for impact feedback
 	screen_shake_manager = load("res://scripts/managers/screen_shake.gd").new()
 	screen_shake_manager.name = "ScreenShakeManager"
@@ -631,8 +623,6 @@ func _setup_host_game():
 		portal_mode_manager.setup_arena_locally()
 	elif LobbyManager.game_mode == "Candy Pump Survival" and gauntlet_manager:
 		gauntlet_manager._setup_arena()
-	elif LobbyManager.game_mode == "Mekton Bulls" and mekton_bulls_manager:
-		mekton_bulls_manager._setup_arena()
 	else:
 		# Randomize grid first to ensure Floor 0 is walkable for pre-calculation
 		randomize_game_grid()
@@ -738,20 +728,10 @@ func _setup_client_game():
 	# Initialize arena locally for Tekton Doors
 	if LobbyManager.game_mode == "Tekton Doors" and portal_mode_manager:
 		portal_mode_manager.setup_arena_locally()
-
+	
-	# Special initialization for Gauntlet mode
+	# Initialize arena locally for Candy Pump Survival
 	if LobbyManager.game_mode == "Candy Pump Survival" and gauntlet_manager:
 		gauntlet_manager._apply_arena_setup()
-
-	if LobbyManager.game_mode == "Mekton Bulls" and mekton_bulls_manager:
-		mekton_bulls_manager.hud_node = load("res://scenes/ui/mekton_bulls_hud.tscn").instantiate()
-		mekton_bulls_manager.hud_node.name = "MektonBullsHUD"
-		add_child(mekton_bulls_manager.hud_node)
-		if mekton_bulls_manager.hud_node.has_method("initialize"):
-			mekton_bulls_manager.hud_node.initialize(mekton_bulls_manager)
-		if mekton_bulls_manager.hud_node.has_method("set_local_player"):
-			mekton_bulls_manager.hud_node.set_local_player(multiplayer.get_unique_id())
-		mekton_bulls_manager._apply_arena_setup()
 	
 	# Ensure local player setup (UI, controls) is verified
 	var player_character = get_node_or_null(str(my_id))
@@ -896,15 +876,10 @@ func _start_game():
 		elif LobbyManager.game_mode == "Candy Pump Survival":
 			if gauntlet_manager:
 				gauntlet_manager.start_game_mode()
+			
 			if goals_cycle_manager:
 				var match_duration = LobbyManager.get_match_duration()
 				goals_cycle_manager.start_match(float(match_duration), true) # Enable cycles for 3x3 pattern missions
-		elif LobbyManager.game_mode == "Mekton Bulls":
-			if mekton_bulls_manager:
-				mekton_bulls_manager.start_game_mode()
-			if goals_cycle_manager:
-				var match_duration = LobbyManager.get_match_duration()
-				goals_cycle_manager.start_match(float(match_duration))
 		elif goals_cycle_manager:
 			var match_duration = LobbyManager.get_match_duration()
 			goals_cycle_manager.start_match(float(match_duration))
@@ -1711,12 +1686,23 @@ func _deferred_set_player_goals(player_id: int, goals: Array):
 			ui_manager.update_playerboard_ui()
 
 
+func _wait_for_playerboard(player_id: int) -> Node:
+	var player = get_node_or_null(str(player_id))
+	var waited := 0.0
+	while (not player or player.playerboard.size() < 25) and waited < 2.0:
+		await get_tree().create_timer(0.1).timeout
+		waited += 0.1
+		player = get_node_or_null(str(player_id))
+	return player if player and player.playerboard.size() >= 25 else null
+
 @rpc("any_peer", "call_local", "reliable")
 func sync_playerboard(player_id: int, new_playerboard: Array):
-	# Find the player and update their playerboard
+	var player = await _wait_for_playerboard(player_id)
-	var player = get_node_or_null(str(player_id))
+	if not player:
-	if player:
+		push_warning("[sync_playerboard] Dropped update: player %s not ready" % player_id)
-		player.playerboard = new_playerboard.duplicate()
+		return
+
+	player.playerboard = new_playerboard.duplicate()
 	
 	# Update UI for local player
 	if player_id == multiplayer.get_unique_id() and GameStateManager.local_player_character:
@@ -1727,9 +1713,16 @@ func sync_playerboard_slot(player_id: int, slot_index: int, item_id: int):
 	"""Patch a single playerboard slot without touching other slots.
 	Used by _execute_grab on grab confirmation to avoid overwriting concurrent
 	in-flight optimistic grab updates on high-latency clients."""
-	var player = get_node_or_null(str(player_id))
+	var player = await _wait_for_playerboard(player_id)
-	if player and slot_index >= 0 and slot_index < player.playerboard.size():
+	if not player:
+		push_warning("[sync_playerboard_slot] Dropped update: player %s not ready" % player_id)
+		return
+
+	if slot_index >= 0 and slot_index < player.playerboard.size():
 		player.playerboard[slot_index] = item_id
+	else:
+		push_warning("[sync_playerboard_slot] Ignored invalid slot %s for player %s" % [slot_index, player_id])
+		return
 	
 	# Update UI for local player only
 	if player_id == multiplayer.get_unique_id() and GameStateManager.local_player_character:

scenes/npcs/mekton_bull.tscn

@@ -1,21 +0,0 @@
-[gd_scene load_steps=5 format=3 uid="uid://bull1234abcd"]
-
-[ext_resource type="Script" uid="uid://bullscript1" path="res://scripts/npcs/mekton_bull.gd" id="1_bull"]
-[ext_resource type="PackedScene" uid="uid://df7h7y7y7y7y7" path="res://scenes/static_tekton_mesh.tscn" id="2_mesh"]
-
-[sub_resource type="BoxShape3D" id="BoxShape3D_bull"]
-size = Vector3(1.5, 2.0, 1.5)
-
-[node name="MektonBull" type="Area3D" groups=["MektonBulls"]]
-collision_layer = 4
-collision_mask = 2
-script = ExtResource("1_bull")
-
-[node name="CollisionShape3D" type="CollisionShape3D" parent="."]
-transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1.0, 0)
-shape = SubResource("BoxShape3D_bull")
-
-[node name="Visuals" type="Node3D" parent="."]
-
-[node name="Mesh" parent="Visuals" instance=ExtResource("2_mesh")]
-transform = Transform3D(0.4, 0, 0, 0, 0.4, 0, 0, 0, 0.4, 0, 0, 0)

scenes/ui/mekton_bulls_hud.tscn

@@ -1,91 +0,0 @@
-[gd_scene format=3 uid="uid://bullhud"]
-
-[ext_resource type="Script" uid="uid://bullhudscript" path="res://scripts/ui/mekton_bulls_hud.gd" id="1_hud"]
-
-[node name="MektonBullsHUD" type="Control"]
-layout_mode = 3
-anchors_preset = 15
-anchor_right = 1.0
-anchor_bottom = 1.0
-grow_horizontal = 2
-grow_vertical = 2
-script = ExtResource("1_hud")
-
-[node name="BullTracker" type="Control" parent="."]
-anchors_preset = 0
-
-[node name="PowerCounters" type="Control" parent="."]
-anchors_preset = 0
-layout_mode = 1
-anchors_preset = 2
-anchor_top = 1.0
-anchor_bottom = 1.0
-offset_top = -60.0
-offset_right = 300.0
-grow_vertical = 0
-
-[node name="Label" type="Label" parent="PowerCounters"]
-layout_mode = 1
-anchors_preset = 15
-anchor_right = 1.0
-anchor_bottom = 1.0
-text = "Freeze: 0 | Knock: 0"
-vertical_alignment = 1
-
-[node name="PowerPicker" type="PanelContainer" parent="."]
-visible = false
-layout_mode = 1
-anchors_preset = 8
-anchor_left = 0.5
-anchor_top = 0.5
-anchor_right = 0.5
-anchor_bottom = 0.5
-offset_left = -100.0
-offset_top = -50.0
-offset_right = 100.0
-offset_bottom = 50.0
-grow_horizontal = 2
-grow_vertical = 2
-
-[node name="HBoxContainer" type="HBoxContainer" parent="PowerPicker"]
-layout_mode = 2
-
-[node name="FreezeBtn" type="Button" parent="PowerPicker/HBoxContainer"]
-layout_mode = 2
-size_flags_horizontal = 3
-text = "Freeze"
-
-[node name="KnockBtn" type="Button" parent="PowerPicker/HBoxContainer"]
-layout_mode = 2
-size_flags_horizontal = 3
-text = "Knock"
-
-[node name="PlacementPanel" type="PanelContainer" parent="."]
-visible = false
-layout_mode = 1
-anchors_preset = 8
-anchor_left = 0.5
-anchor_top = 0.5
-anchor_right = 0.5
-anchor_bottom = 0.5
-offset_left = -200.0
-offset_top = -150.0
-offset_right = 200.0
-offset_bottom = 150.0
-grow_horizontal = 2
-grow_vertical = 2
-
-[node name="VBoxContainer" type="VBoxContainer" parent="PlacementPanel"]
-layout_mode = 2
-
-[node name="Label" type="Label" parent="PlacementPanel/VBoxContainer"]
-layout_mode = 2
-text = "Match Placements"
-horizontal_alignment = 1
-
-[node name="List" type="VBoxContainer" parent="PlacementPanel/VBoxContainer"]
-layout_mode = 2
-size_flags_vertical = 3
-
-[connection signal="pressed" from="PowerPicker/HBoxContainer/FreezeBtn" to="." method="_on_freeze_btn_pressed"]
-[connection signal="pressed" from="PowerPicker/HBoxContainer/KnockBtn" to="." method="_on_knock_btn_pressed"]

scripts/bot_controller.gd

@@ -210,9 +210,9 @@ func _run_ai_tick():
 			print("[BotController] Action Taken: Attack Pursuit")
 			return
 			
-	# Priority 0.5: Gauntlet (#075) — burn Cleanser if boxed in
+	# Priority 0.5: Gauntlet (#075) — use Ghost powerup if boxed in
-	if await _try_activate_cleanser():
+	if await _try_activate_ghost():
-		print("[BotController] Action Taken: Cleanser (trapped)")
+		print("[BotController] Action Taken: Ghost (trapped)")
 		return
 
 	# Priority 1: Tekton Management (Grab Tekton if full boost, or spawn if carrying)
@@ -260,27 +260,24 @@ func _run_ai_tick():
 			return
 
 # =============================================================================
-# Gauntlet (#075) — Cleanser + Sticky Avoidance wiring
+# Gauntlet (#075) — Ghost Powerup + Sticky Avoidance wiring
 # =============================================================================
 
-func _try_activate_cleanser() -> bool:
+func _try_activate_ghost() -> bool:
-	"""Activate Cleanser when the planner reports imminent danger.
+	"""Activate Ghost powerup when the planner reports imminent danger.
 
-	Server-authoritative RPC; we only request it. Returns true if the request
+	Uses the existing SpecialTilesManager to activate the held ghost powerup.
-	was sent successfully (not a guarantee it landed on a sticky cell)."""
+	Returns true if activation was triggered."""
 	if not strategic_planner or not strategic_planner.is_gauntlet_mode():
 		return false
-	if not strategic_planner.should_activate_cleanser_now():
+	if not strategic_planner.should_activate_ghost_now():
 		return false
-	var gm = strategic_planner._get_gauntlet_manager()
+	var stm = actor.get_node_or_null("SpecialTilesManager")
-	if not gm:
+	if not stm:
 		return false
-	var pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
+	if stm.has_method("activate_effect"):
-	if pid == null or pid < 0:
+		stm.activate_effect(stm.SpecialEffect.INVISIBLE_MODE)
-		return false
+		print("[BotController] %s activated Ghost powerup (trapped)" % actor.name)
-	if gm.has_method("rpc_activate_cleanser"):
-		gm.rpc_activate_cleanser(pid)
-		print("[BotController] %s requested Cleanser activation (trapped)" % actor.name)
 		return true
 	return false
 
@@ -292,14 +289,14 @@ func _on_step_onto_unsafe() -> bool:
 	var here = actor.current_position if "current_position" in actor else Vector2i(-1, -1)
 	if here == Vector2i(-1, -1):
 		return false
-	# Post-move guard: if we somehow landed on a sticky without cleanser active,
+	# Post-move guard: if we somehow landed on a sticky without ghost active,
-	# burn Cleanser to clear ourselves out next tick.
+	# burn Ghost powerup to phase through next tick.
 	if strategic_planner.is_gauntlet_mode() and strategic_planner._is_overlay_unsafe(here):
-		if not strategic_planner._is_bot_cleanser_active():
+		if not strategic_planner._is_bot_ghost_active():
 			var gm = strategic_planner._get_gauntlet_manager()
 			if gm and gm.has_method("is_sticky_cell") and gm.is_sticky_cell(here):
-				print("[BotController] %s stepped onto sticky at %s — burning Cleanser" % [actor.name, here])
+				print("[BotController] %s stepped onto sticky at %s — activating Ghost" % [actor.name, here])
-				return _try_activate_cleanser()
+				return _try_activate_ghost()
 	return false
 
 # =============================================================================

scripts/bot_strategic_planner.gd

@@ -17,7 +17,7 @@ const GOAL_TILES = [7, 8, 9, 10] # Heart, Diamond, Star, Coin
 const HOLO_TILES = [11, 12, 13, 14] # Power-up holo tiles
 
 # Gauntlet overlay layer (v2 ground-growth model — sticky/telegraph on layer 2).
-# Bots must avoid these cells or burn a Cleanser charge to cross.
+# Bots must avoid these cells or use Ghost mode to cross.
 const GAUNTLET_OVERLAY_LAYER: int = 2
 const TILE_STICKY: int = 17
 const TILE_TELEGRAPH: int = 18
@@ -61,23 +61,16 @@ func _get_gauntlet_manager() -> Node:
 				return gm2
 	return null
 
-func _bot_has_cleanser_charge() -> bool:
+func _bot_has_ghost_powerup() -> bool:
-	var gm = _get_gauntlet_manager()
+	"""Check if the bot has a ghost powerup in its SpecialTilesManager inventory."""
-	if not gm or not "player_cleansers" in gm:
+	var stm = actor.get_node_or_null("SpecialTilesManager")
+	if not stm:
 		return false
-	var pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
+	return stm.inventory.get(stm.SpecialEffect.INVISIBLE_MODE, false)
-	if pid == null or pid < 0:
-		return false
-	return gm.player_cleansers.get(pid, 0) > 0
 
-func _is_bot_cleanser_active() -> bool:
+func _is_bot_ghost_active() -> bool:
-	var gm = _get_gauntlet_manager()
+	"""Check if the bot is currently in ghost (invisible) mode."""
-	if not gm:
+	return actor.get("is_invisible") == true
-		return false
-	var pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
-	if pid == null or pid < 0:
-		return false
-	return gm.is_cleanser_active(pid)
 
 func _is_overlay_unsafe(pos: Vector2i) -> bool:
 	"""True if the cell carries a sticky or telegraphed overlay on layer 2."""
@@ -88,10 +81,10 @@ func _is_overlay_unsafe(pos: Vector2i) -> bool:
 
 func _is_cell_unsafe_in_gauntlet(pos: Vector2i) -> bool:
 	"""Cell is unsafe in Gauntlet if it's sticky/telegraphed — unless the bot's
-	Cleanser is active (grants temporary immunity)."""
+	Ghost mode is active (grants sticky bypass)."""
 	if not is_gauntlet_mode():
 		return false
-	if _is_bot_cleanser_active():
+	if _is_bot_ghost_active():
 		return false
 	var gm = _get_gauntlet_manager()
 	if gm and gm.has_method("is_sticky_cell") and gm.is_sticky_cell(pos):
@@ -106,13 +99,13 @@ func _count_unsafe_neighbors(pos: Vector2i) -> int:
 			count += 1
 	return count
 
-func should_activate_cleanser_now() -> bool:
+func should_activate_ghost_now() -> bool:
-	"""True if the bot is boxed in / about to be sealed and should burn Cleanser."""
+	"""True if the bot is boxed in / about to be sealed and should use Ghost powerup."""
 	if not is_gauntlet_mode():
 		return false
-	if not _bot_has_cleanser_charge():
+	if not _bot_has_ghost_powerup():
 		return false
-	if _is_bot_cleanser_active():
+	if _is_bot_ghost_active():
 		return false
 	var here = actor.current_position if actor and "current_position" in actor else Vector2i(-1, -1)
 	if here == Vector2i(-1, -1):
@@ -134,56 +127,6 @@ func _normalize_tile(tile: int) -> int:
 		return tile - 4 # 11->7, 12->8, etc.
 	return tile
 
-# =============================================================================
-# Mekton Bulls mode helpers
-# =============================================================================
-
-func is_mekton_bulls_mode() -> bool:
-	return LobbyManager and LobbyManager.is_game_mode(GameMode.Mode.MEKTON_BULLS)
-
-func _get_mekton_bulls_manager() -> Node:
-	if gauntlet_manager_override and is_instance_valid(gauntlet_manager_override):
-		return gauntlet_manager_override
-	
-	var current = actor
-	while current != null:
-		var bm = current.get_node_or_null("MektonBullsManager")
-		if bm: return bm
-		current = current.get_parent()
-		
-	var root = actor.get_tree().root
-	var main = root.get_node_or_null("Main")
-	if main:
-		return main.get_node_or_null("MektonBullsManager")
-	return null
-
-func _get_active_bulls() -> Array:
-	return actor.get_tree().get_nodes_in_group("MektonBulls")
-
-func _is_cell_unsafe_in_mekton_bulls(pos: Vector2i) -> bool:
-	"""Cell is unsafe if it's WATER, or if it's on the boundary (soon to be flooded)."""
-	if not is_mekton_bulls_mode(): return false
-	var bm = _get_mekton_bulls_manager()
-	if not bm: return false
-	
-	# Check if water
-	var tile = enhanced_gridmap.get_cell_item(Vector3i(pos.x, 0, pos.y))
-	if tile == 24: # TILE_WATER
-		return true
-		
-	if bm.has_method("_is_boundary") and bm._is_boundary(pos):
-		return true
-		
-	# Bull proximity
-	var bulls = _get_active_bulls()
-	for b in bulls:
-		var b_pos = enhanced_gridmap.local_to_map(b.position)
-		# If cell is adjacent to the bull, it's unsafe.
-		if abs(b_pos.x - pos.x) <= 1 and abs(b_pos.z - pos.y) <= 1:
-			return true
-			
-	return false
-
 # =============================================================================
 # Goal Analysis
 # =============================================================================
@@ -395,28 +338,14 @@ func find_best_tile_to_grab() -> Dictionary:
 
 func find_nearest_tile_of_type(tile_types: Array) -> Vector2i:
 	"""Find nearest tile matching any type in array using optimized spiral search."""
+	var current_pos = actor.current_position
+	
 	if not enhanced_gridmap:
 		return Vector2i(-1, -1)
-		
+	
-	if is_mekton_bulls_mode():
-		# Return the nearest uncollected tile from our blueprint
-		var bm = _get_mekton_bulls_manager()
-		var pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
-		if bm and pid != null and bm.player_blueprints.has(pid):
-			var bp = bm.player_blueprints[pid]
-			var best_tile = Vector2i(-1, -1)
-			var best_dist = INF
-			for c in bp.cells:
-				if enhanced_gridmap.get_cell_item(Vector3i(c.x, 0, c.y)) == bp.color:
-					var dist = actor.current_position.distance_to(c)
-					if dist < best_dist and _is_valid_move_target(c, true):
-						best_dist = dist
-						best_tile = c
-			if best_tile != Vector2i(-1, -1):
-				return best_tile
-
-	var current_pos = actor.current_position
 	# Optimization: Start check at simple radius
+	# If we find something in the spiral, it is guaranteed to be one of the nearest (by Chebyshev distance logic broadly, or just good enough)
+	
 	var max_radius = 25 # Limit search range to prevent full map scans on huge maps
 	if OS.has_feature("mobile"):
 		max_radius = 15 # Stricter limit on mobile
@@ -502,43 +431,10 @@ func find_nearest_roaming_tekton() -> Node3D:
 # Movement Strategy
 # =============================================================================
 
-func _should_use_freeze() -> bool:
-	if not is_mekton_bulls_mode(): return false
-	var bm = _get_mekton_bulls_manager()
-	if not bm: return false
-	var pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
-	if not bm.player_powers.has(pid) or bm.player_powers[pid]["FREEZE"] <= 0: return false
-	
-	var bulls = _get_active_bulls()
-	var bot_pos = enhanced_gridmap.local_to_map(actor.position)
-	for b in bulls:
-		var b_pos = enhanced_gridmap.local_to_map(b.position)
-		if abs(bot_pos.x - b_pos.x) <= 3 and abs(bot_pos.z - b_pos.y) <= 3:
-			return true
-	return false
-
 func find_optimal_move_target() -> Vector2i:
-	"""Core decision logic. Evaluates sabotaging vs making progress."""
+	"""Calculate the best position to move towards."""
 	var main = actor.get_tree().get_root().get_node_or_null("Main")
-	if is_mekton_bulls_mode():
+	var is_sng = LobbyManager.is_game_mode(GameMode.Mode.STOP_N_GO)
-		# In Mekton Bulls, use powers if viable.
-		if _should_use_freeze():
-			var bm = _get_mekton_bulls_manager()
-			var pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
-			bm.try_use_freeze.rpc_id(1) # Try emitting to server
-
-		# Knock another nearby player
-		var mb_pid = actor.get("peer_id") if "peer_id" in actor else actor.name.to_int()
-		var mb_bm = _get_mekton_bulls_manager()
-		if mb_bm and mb_bm.player_powers.has(mb_pid) and mb_bm.player_powers[mb_pid]["KNOCK"] > 0:
-			var opps = _get_opponents()
-			for op in opps:
-				var dist = actor.position.distance_to(op.position)
-				if dist < enhanced_gridmap.cell_size.x * 2.0:
-					mb_bm.try_use_knock.rpc_id(1, op.name.to_int(), actor.position.direction_to(op.position).normalized())
-					break
-	
-	var is_sng = LobbyManager and LobbyManager.is_game_mode(GameMode.Mode.STOP_N_GO)
 	var gc_manager = main.get_node_or_null("GoalsCycleManager") if main else null
 	var time_left = gc_manager.get_global_time_remaining() if gc_manager else 999.0
 	var is_match_running = gc_manager.is_match_running() if gc_manager else false
@@ -699,11 +595,6 @@ func _is_valid_move_target(pos: Vector2i, ignore_players: bool = false) -> bool:
 	if not enhanced_gridmap or not enhanced_gridmap.is_position_valid(pos):
 		return false
 	
-	if is_mekton_bulls_mode():
-		# Do not move into WATER or the boundary
-		if _is_cell_unsafe_in_mekton_bulls(pos):
-			return false
-	
 	# Check Floor 0 (Ground/Walls)
 	var floor_item = enhanced_gridmap.get_cell_item(Vector3i(pos.x, 0, pos.y))
 	if floor_item == -1 or floor_item in enhanced_gridmap.non_walkable_items:
@@ -725,7 +616,7 @@ func _is_valid_move_target(pos: Vector2i, ignore_players: bool = false) -> bool:
 	# Gauntlet mode (#075): reject cells that are sticky or telegraphed —
 	# stepping onto them either traps the bot or strands it within 1s.
 	# Safety applies even when ignore_players is true (a sticky cell is unsafe
-	# regardless of whether another player is on it). Cleanser-active bots are
+	# regardless of whether another player is on it). Ghost-active bots are
 	# exempt via the helper.
 	if _is_cell_unsafe_in_gauntlet(pos):
 		return false

scripts/game_mode.gd

@@ -5,8 +5,7 @@ enum Mode {
 	FREEMODE = 0,
 	STOP_N_GO = 1,
 	TEKTON_DOORS = 2,
-	GAUNTLET = 3,
+	GAUNTLET = 3
-	MEKTON_BULLS = 4
 }
 
 static func from_string(mode: String) -> Mode:
@@ -19,8 +18,6 @@ static func from_string(mode: String) -> Mode:
 			return Mode.TEKTON_DOORS
 		"Candy Pump Survival":
 			return Mode.GAUNTLET
-		"Mekton Bulls":
-			return Mode.MEKTON_BULLS
 		_:
 			return Mode.FREEMODE
 
@@ -34,13 +31,11 @@ static func mode_to_string(mode: Mode) -> String:
 			return "Tekton Doors"
 		Mode.GAUNTLET:
 			return "Candy Pump Survival"
-		Mode.MEKTON_BULLS:
-			return "Mekton Bulls"
 		_:
 			return "Freemode"
 
 static func is_restricted(mode: Mode) -> bool:
-	return mode == Mode.STOP_N_GO or mode == Mode.TEKTON_DOORS or mode == Mode.GAUNTLET or mode == Mode.MEKTON_BULLS
+	return mode == Mode.STOP_N_GO or mode == Mode.TEKTON_DOORS or mode == Mode.GAUNTLET
 
 static func get_all_modes() -> Array[String]:
-	return ["Freemode", "Stop n Go", "Tekton Doors", "Candy Pump Survival", "Mekton Bulls"]
+	return ["Freemode", "Stop n Go", "Tekton Doors", "Candy Pump Survival"]

scripts/lint.gd

@@ -0,0 +1,36 @@
+extends SceneTree
+
+const SKIP_DIRS := [".git", ".godot", "addons"]
+
+func _initialize() -> void:
+	var errors: Array[String] = []
+	_scan_dir("res://", errors)
+	if errors.is_empty():
+		print("Lint passed: no GDScript syntax errors found")
+		quit(0)
+	else:
+		for e in errors:
+			printerr(e)
+		printerr("Lint failed: %d file(s) with syntax errors" % errors.size())
+		quit(1)
+
+func _scan_dir(path: String, errors: Array[String]) -> void:
+	var dir := DirAccess.open(path)
+	if dir == null:
+		return
+	dir.list_dir_begin()
+	var entry := dir.get_next()
+	while entry != "":
+		if entry == "." or entry == "..":
+			entry = dir.get_next()
+			continue
+		var full_path := path.path_join(entry)
+		if dir.current_is_dir():
+			if not SKIP_DIRS.has(entry):
+				_scan_dir(full_path, errors)
+		elif entry.ends_with(".gd"):
+			var script := GDScript.new()
+			script.source_code = FileAccess.get_file_as_string(full_path)
+			if script.reload() != OK:
+				errors.append("%s: syntax error" % full_path)
+		entry = dir.get_next()

scripts/managers/game_update_manager.gd

@@ -14,7 +14,7 @@ signal patch_applied
 signal store_update_required(store_url: String)
 
 # Configuration - Update these URLs for your game
-const VERSION_MANIFEST_URL := "https://raw.githubusercontent.com/adtpdn/tekton-updates/main/latest/version.json"
+const VERSION_MANIFEST_URL := "https://git.klud.top/danchie/tekton/raw/branch/patches/version.json"
 const ANDROID_STORE_URL := "https://play.google.com/store/apps/details?id=com.yourcompany.tekton"
 const IOS_STORE_URL := "https://apps.apple.com/app/tekton/id123456789"
 

scripts/managers/gauntlet_manager.gd

@@ -7,7 +7,7 @@ class_name GauntletManager
 signal phase_changed(phase_index: int, phase_name: String)
 signal growth_tick(cells: Array)
 signal player_trapped(player_id: int)
-signal cleanser_granted(player_id: int)
+signal ghost_granted(player_id: int)
 
 # =============================================================================
 # Constants
@@ -31,10 +31,9 @@ enum CellState {
 	STICKY,          # Covered in sticky candy, blocks + traps
 	BUBBLE_GROWING,  # Candy bubble growing, not yet exploded
 	BLOCKED,         # NPC zone or permanent obstacle
-	CLEANSED,        # Recently cleaned by Cleanser (temp protection)
 }
 
-# Cells temporarily protected after a Cleanser pass (Vector2i -> time remaining).
+# Cells temporarily protected after Ghost-clearing (not used — kept for compat).
 var cleansed_cells: Dictionary = {}
 const CLEANSED_PROTECTION_TIME: float = 5.0
 
@@ -146,15 +145,10 @@ const SMACK_COOLDOWN: float = 8.0
 const SMACK_CHARGE_WINDOW: float = 3.0
 
 # =============================================================================
-# Cleanser Tracking
+# Ghost Reward Tracking (replaces Cleanser)
 # =============================================================================
 
 var player_mission_completions: Dictionary = {} # player_id → int
-var player_cleansers: Dictionary = {}           # player_id → int (0 or 1)
-var cleanser_active: Dictionary = {}            # player_id → true when immunity active
-var cleanser_cells_left: Dictionary = {}        # player_id → int (cells remaining)
-const CLEANSER_MAX_CELLS: int = 5
-const CLEANSER_ACTIVATION_DELAY: float = 0.3
 
 # =============================================================================
 # Trapped Players
@@ -189,9 +183,6 @@ var pump_instance: Node3D = null
 # HUD
 var hud_layer: CanvasLayer
 var phase_label: Label
-var cleanser_label: Label
-var cleanser_icon: TextureRect
-var cleanser_count: int = 0
 var slowmo_label: Label
 var _gauntlet_hud_scene: PackedScene = preload("res://scenes/gauntlet_hud.tscn")
 
@@ -281,12 +272,8 @@ func _process(delta: float) -> void:
 				if player.has_method("sync_modulate"):
 					if multiplayer.is_server() and _can_rpc():
 						player.rpc("sync_modulate", Color.WHITE)
-				elif not multiplayer.is_server():
+					elif not multiplayer.is_server():
-					player.sync_modulate(Color.WHITE)
+						player.sync_modulate(Color.WHITE)
-	
-	# Cleanser input (local player only)
-	if Input.is_action_just_pressed("use_cleanser"):
-		_try_use_cleanser()
 	
 	# Slow-mo timer (all peers for visual consistency)
 	if slowmo_active:
@@ -340,9 +327,12 @@ func _start_phase(phase: Phase) -> void:
 	var phase_name = _phase_to_string(phase)
 	print("[Gauntlet] Phase changed to: ", phase_name)
 	
-	if _can_rpc():
+	if _can_rpc() and multiplayer.is_server():
 		rpc("sync_phase", int(phase), phase_name)
 	
+	# Update phase explicitly with setup_arena
+	_shrink_arena()
+	
 	emit_signal("phase_changed", int(phase), phase_name)
 
 func _phase_to_string(phase: Phase) -> String:
@@ -361,6 +351,14 @@ func sync_phase(phase_index: int, phase_name: String) -> void:
 	if not is_active:
 		activate_client_side()
 	current_phase = phase_index as Phase
+	if not multiplayer.is_server():
+		var bounds = get_arena_bounds()
+		for x in range(ARENA_COLUMNS):
+			for z in range(ARENA_ROWS):
+				var pos = Vector2i(x, z)
+				if pos.x <= bounds.min or pos.x >= bounds.max or pos.y <= bounds.min or pos.y >= bounds.max:
+					if not sticky_cells.has(pos):
+						sticky_cells[pos] = true
 	_update_hud_phase(phase_name)
 
 # =============================================================================
@@ -419,11 +417,12 @@ func _apply_arena_setup() -> void:
 				continue
 			
 			# Boundary walls: perimeter (row 0, row 19, col 0, col 19)
-			if x == 0 or x == ARENA_COLUMNS - 1 or z == 0 or z == ARENA_ROWS - 1:
+			if pos.x <= 0 or pos.x >= 19 or pos.y <= 0 or pos.y >= 19:
 				# Also make border walls visually walkable floors instead of red blocks
 				gridmap.set_cell_item(Vector3i(x, 0, z), TILE_WALKABLE)
 				gridmap.set_cell_item(Vector3i(x, 1, z), -1)
-				gridmap.set_cell_item(Vector3i(x, 2, z), -1)
+				gridmap.set_cell_item(Vector3i(x, 2, z), TILE_STICKY)
+				sticky_cells[pos] = true
 				continue
 			
 			# Interior: walkable floor
@@ -503,39 +502,39 @@ func _spawn_mission_tiles() -> void:
 	# Goal items: Heart(7), Diamond(8), Star(9), Coin(10)
 	var goal_items = [7, 8, 9, 10]
 	var tiles_spawned: int = 0
+	var main = get_node_or_null("/root/Main")
 	
-		for x in range(ARENA_COLUMNS):
+	for x in range(ARENA_COLUMNS):
-			for z in range(ARENA_ROWS):
+		for z in range(ARENA_ROWS):
-				var pos = Vector2i(x, z)
+			var pos = Vector2i(x, z)
-				
+			
-				# Skip NPC pump zone (center 3x3)
+			# Skip NPC pump zone (center 3x3)
-				if x >= 8 and x <= 10 and z >= 8 and z <= 10:
+			if x >= 8 and x <= 10 and z >= 8 and z <= 10:
-					continue
+				continue
-				
+			
-				# Check base floor — don't spawn on void (or walls if they were still obstacles)
+			# Check base floor — don't spawn on void (or walls if they were still obstacles)
-				var base_tile = gridmap.get_cell_item(Vector3i(x, 0, z))
+			var base_tile = gridmap.get_cell_item(Vector3i(x, 0, z))
-				if base_tile == -1:
+			if base_tile == -1:
-					continue
+				continue
-				
+			
-				# Ensure we don't spawn powerups on the perimeter walls even though they look like floors
+			# Ensure we don't spawn powerups on the perimeter walls even though they look like floors
-				if x == 0 or x == ARENA_COLUMNS - 1 or z == 0 or z == ARENA_ROWS - 1:
+			if x == 0 or x == ARENA_COLUMNS - 1 or z == 0 or z == ARENA_ROWS - 1:
-					continue
+				continue
-				
+			
-				# Skip if something already exists on Layer 1
+			# Skip if something already exists on Layer 1
-				var current_item = gridmap.get_cell_item(Vector3i(x, 1, z))
+			var current_item = gridmap.get_cell_item(Vector3i(x, 1, z))
-				if current_item != -1:
+			if current_item != -1:
-					continue
+				continue
-				
+			
-				# Spawn tiles with 60% density (40% chance to skip)
+			# Spawn tiles with 60% density (40% chance to skip)
-				if randf() > 0.6:
+			if randf() > 0.6:
-					continue
+				continue
-				
+			
-				var tile_type = goal_items[randi() % goal_items.size()]
+			var tile_type = goal_items[randi() % goal_items.size()]
-				gridmap.set_cell_item(Vector3i(x, 1, z), tile_type)
+			gridmap.set_cell_item(Vector3i(x, 1, z), tile_type)
-				tiles_spawned += 1
+			tiles_spawned += 1
 			
 			# Sync to clients
-			var main = get_node("/root/Main")
 			if main:
 				main.rpc("sync_grid_item", x, 1, z, tile_type)
 	
@@ -1004,56 +1003,6 @@ func _spawn_impact_particles(targets: Array) -> void:
 		if particles and is_instance_valid(particles):
 			particles.queue_free()
 
-# =============================================================================
-func _spawn_cleanser_particles(pos: Vector2i) -> void:
-	"""Spawn bright cleansing particles when sticky is cleared."""
-	if not main_scene or not gridmap:
-		return
-	
-	var world_pos = Vector3(
-		pos.x * gridmap.cell_size.x + gridmap.cell_size.x / 2.0,
-		0.5,
-		pos.y * gridmap.cell_size.z + gridmap.cell_size.z / 2.0
-	)
-	
-	var particles = GPUParticles3D.new()
-	particles.emitting = true
-	particles.one_shot = true
-	particles.amount = 12
-	particles.lifetime = 0.6
-	particles.explosiveness = 0.9
-	
-	var material = ParticleProcessMaterial.new()
-	material.emission_shape = ParticleProcessMaterial.EMISSION_SHAPE_SPHERE
-	material.emission_sphere_radius = 0.3
-	material.direction = Vector3(0, 1, 0)
-	material.spread = 180.0
-	material.initial_velocity_min = 3.0
-	material.initial_velocity_max = 5.0
-	material.gravity = Vector3(0, -5.0, 0)
-	material.scale_min = 0.05
-	material.scale_max = 0.15
-	
-	var mesh = SphereMesh.new()
-	mesh.radius = 0.2
-	mesh.height = 0.4
-	var spatial_mat = StandardMaterial3D.new()
-	spatial_mat.albedo_color = Color(0.2, 1.0, 1.0) # Cyan/Blue for cleanser
-	spatial_mat.emission_enabled = true
-	spatial_mat.emission = Color(0.2, 1.0, 1.0)
-	spatial_mat.emission_energy_multiplier = 3.0
-	mesh.material = spatial_mat
-	particles.draw_pass_1 = mesh
-	
-	particles.process_material = material
-	particles.position = world_pos
-	
-	main_scene.add_child(particles)
-	
-	await get_tree().create_timer(1.2).timeout
-	if particles and is_instance_valid(particles):
-		particles.queue_free()
-
 # =============================================================================
 # Sticky / Trap System
 
@@ -1065,12 +1014,15 @@ func is_cleansed_cell(pos: Vector2i) -> bool:
 
 func cell_state(pos: Vector2i) -> CellState:
 	"""Logical state of a playable cell (v2 ground-growth model)."""
+	var b = get_arena_bounds()
+	if pos.x <= b.min or pos.x >= b.max or pos.y <= b.min or pos.y >= b.max:
+		return CellState.STICKY
 	if _is_npc_zone(pos) or _is_boundary(pos):
 		return CellState.BLOCKED
-	if sticky_cells.has(pos):
+	if is_sticky_cell(pos):
 		return CellState.STICKY
 	if cleansed_cells.has(pos):
-		return CellState.CLEANSED
+		return CellState.BLOCKED # Protected from regrowth temporarily
 	if telegraphed_cells.has(pos):
 		return CellState.TELEGRAPHED
 	if bubble_cells.has(pos):
@@ -1091,8 +1043,37 @@ func _tick_cleansed_cells(delta: float) -> void:
 	for pos in expired:
 		cleansed_cells.erase(pos)
 
+func get_arena_bounds() -> Dictionary:
+	match current_phase:
+		Phase.OPEN_ARENA:
+			return {"min": 0, "max": 19} # 20x20
+		Phase.ROUTE_PRESSURE:
+			return {"min": 1, "max": 18} # 18x18
+		Phase.SURVIVAL_ENDGAME:
+			return {"min": 6, "max": 12} # 7x7
+	return {"min": 0, "max": 19}
+
+func _shrink_arena() -> void:
+	if not multiplayer.is_server(): return
+	var b = get_arena_bounds()
+	var new_sticky = []
+	for x in range(ARENA_COLUMNS):
+		for z in range(ARENA_ROWS):
+			var pos = Vector2i(x, z)
+			if _is_npc_zone(pos) or _is_boundary(pos):
+				continue
+			if pos.x <= b.min or pos.x >= b.max or pos.y <= b.min or pos.y >= b.max:
+				if not sticky_cells.has(pos):
+					new_sticky.append(pos)
+	
+	if new_sticky.size() > 0:
+		if _can_rpc() and multiplayer.is_server():
+			rpc("sync_growth_apply", new_sticky)
+		else:
+			sync_growth_apply(new_sticky)
+
 func _is_boundary(pos: Vector2i) -> bool:
-	return pos.x == 0 or pos.x == ARENA_COLUMNS - 1 or pos.y == 0 or pos.y == ARENA_ROWS - 1
+	return pos.x <= 0 or pos.x >= ARENA_COLUMNS - 1 or pos.y <= 0 or pos.y >= ARENA_ROWS - 1
 
 # =============================================================================
 # Coverage tracking (v2 target: 70-75%, down from v1's 80%)
@@ -1103,12 +1084,15 @@ const COVERAGE_TARGET_MAX: float = 0.75
 
 func playable_cell_count() -> int:
 	"""Number of cells that can ever become sticky (interior, minus NPC zone)."""
+	var b = get_arena_bounds()
 	var count := 0
 	for x in range(ARENA_COLUMNS):
 		for z in range(ARENA_ROWS):
 			var pos := Vector2i(x, z)
 			if _is_boundary(pos) or _is_npc_zone(pos):
 				continue
+			if pos.x <= b.min or pos.x >= b.max or pos.y <= b.min or pos.y >= b.max:
+				continue
 			count += 1
 	return count
 
@@ -1132,6 +1116,9 @@ const FORCED_TRAP_WINDOW: float = 30.0 # final seconds where trapping is allowed
 
 func _is_cell_passable(pos: Vector2i, extra_sticky: Dictionary = {}) -> bool:
 	"""Can a player stand on / move through this cell, given a hypothetical sticky set?"""
+	var b = get_arena_bounds()
+	if pos.x <= b.min or pos.x >= b.max or pos.y <= b.min or pos.y >= b.max:
+		return false
 	if _is_boundary(pos) or _is_npc_zone(pos):
 		return false
 	if sticky_cells.has(pos) or extra_sticky.has(pos):
@@ -1333,11 +1320,11 @@ func _calculate_bubble_score(pos: Vector2i, player_cells: Array = []) -> float:
 	return score
 
 func _bubble_score_camping(pos: Vector2i) -> float:
-	"""Reward targeting campers. +40 >5s, +60 >8s, +80 >10s-with-cleanser."""
+	"""Reward targeting campers. +40 >5s, +60 >8s, +80 >10s-with-ghost."""
 	var t := _camp_time_for_region(_region_of(pos))
 	if t > 10.0:
-		# Stronger only if a nearby player actually holds a cleanser.
+		# Stronger only if a nearby player is in ghost mode.
-		if _any_cleanser_holder_near(pos):
+		if _any_ghost_player_near(pos):
 			return 80.0
 		return 60.0
 	elif t > 8.0:
@@ -1390,22 +1377,25 @@ func _bubble_score_unfair_trap(pos: Vector2i) -> float:
 func _bubble_blast_cells(center: Vector2i) -> Array:
 	"""The 3x3 (radius 1) sticky cells a bubble at `center` would create,
 	clipped to passable/playable cells."""
+	var b = get_arena_bounds()
 	var cells: Array = []
 	for dx in range(-BUBBLE_EXPLOSION_RADIUS, BUBBLE_EXPLOSION_RADIUS + 1):
 		for dz in range(-BUBBLE_EXPLOSION_RADIUS, BUBBLE_EXPLOSION_RADIUS + 1):
 			var c := center + Vector2i(dx, dz)
 			if _is_boundary(c) or _is_npc_zone(c):
 				continue
+			if c.x <= b.min or c.x >= b.max or c.y <= b.min or c.y >= b.max:
+				continue
 			cells.append(c)
 	return cells
 
-func _any_cleanser_holder_near(pos: Vector2i) -> bool:
+func _bubble_footprint(center: Vector2i) -> Array:
-	"""True if a player holding a Cleanser charge is within the camping region."""
+	return _bubble_blast_cells(center)
+	
+func _any_ghost_player_near(pos: Vector2i) -> bool:
+	"""True if a player in ghost mode is within the camping region."""
 	for player in get_tree().get_nodes_in_group("Players"):
-		var pid = player.get("peer_id") if "peer_id" in player else -1
+		if not player.get("is_invisible"):
-		if pid == -1:
-			continue
-		if player_cleansers.get(pid, 0) <= 0:
 			continue
 		if "current_position" in player and player.current_position != null:
 			if _region_of(player.current_position) == _region_of(pos):
@@ -1501,7 +1491,7 @@ func _explode_bubble(center: Vector2i, cells: Array) -> void:
 		if "current_position" in player and player.current_position != null:
 			if blast.has(player.current_position):
 				var pid = player.get("peer_id") if "peer_id" in player else -1
-				if pid != -1 and is_cleanser_active(pid):
+				if pid != -1 and player.get("is_invisible"):
 					continue
 				apply_sticky_slow(player)
 
@@ -1608,8 +1598,8 @@ func _check_all_players_trapped() -> void:
 		var pos = player.current_position if player.get("current_position") else Vector2i(-1, -1)
 		if is_sticky_cell(pos):
 			var pid = player.get("peer_id") if "peer_id" in player else -1
-			if pid != -1 and is_cleanser_active(pid):
+			if pid != -1 and player.get("is_invisible"):
-				continue # cleansing players are immune to the slow
+				continue # ghost players are immune to the slow
 			apply_sticky_slow(player)
 
 func apply_sticky_slow(player: Node) -> void:
@@ -1641,25 +1631,22 @@ func _trap_player(player: Node) -> void:
 	NotificationManager.send_message(player, "Stuck in Candy!", NotificationManager.MessageType.WARNING)
 
 func clear_sticky_cell(pos: Vector2i) -> void:
-	"""Used by Cleanser power-up to remove a sticky cell."""
+	"""Remove a sticky cell (used when ghost player walks through)."""
 	if _can_rpc():
 		if multiplayer.is_server():
 			rpc("sync_clear_sticky_cell", pos)
 		else:
 			sync_clear_sticky_cell(pos) # Predictive local clear
-			rpc("rpc_use_cleanser", pos)
 	else:
 		sync_clear_sticky_cell(pos)
 
 @rpc("authority", "call_local", "reliable")
 func sync_clear_sticky_cell(pos: Vector2i) -> void:
 	sticky_cells.erase(pos)
-	mark_cleansed(pos) # temporary regrowth protection (v2)
+	mark_cleansed(pos) # temporary regrowth protection
 	if gridmap:
 		gridmap.set_cell_item(Vector3i(pos.x, 2, pos.y), -1)
 	
-	# Play VFX and SFX
-	_spawn_cleanser_particles(pos)
 	if SfxManager:
 		SfxManager.play("pick_up_power_tile")
 	
@@ -1667,142 +1654,6 @@ func sync_clear_sticky_cell(pos: Vector2i) -> void:
 	if main_scene and main_scene.has_method("sync_grid_item"):
 		main_scene.sync_grid_item(pos.x, 2, pos.y, -1)
 
-func _try_use_cleanser() -> void:
-	"""Local player attempts to activate Cleanser for 5-cell sticky immunity."""
-	var local_pid = multiplayer.get_unique_id()
-	var count = player_cleansers.get(local_pid, 0)
-	if count <= 0:
-		return
-	
-	# Block activation during stun
-	var all_players = get_tree().get_nodes_in_group("Players")
-	var local_player = null
-	for p in all_players:
-		var pid = p.get("peer_id") if "peer_id" in p else p.name.to_int()
-		if pid == local_pid:
-			local_player = p
-			break
-	if not local_player:
-		return
-	if local_player.get("is_frozen") or local_player.get("is_stop_frozen"):
-		return
-	# 0.3s activation delay
-	await get_tree().create_timer(CLEANSER_ACTIVATION_DELAY).timeout
-	
-	# Re-validate after delay
-	if not is_instance_valid(local_player):
-		return
-	if local_player.get("is_frozen") or local_player.get("is_stop_frozen"):
-		return
-	
-	# Consume cleanser from inventory (only if client, host relies on rpc)
-	if not multiplayer.is_server():
-		cleanser_active[local_pid] = true
-		cleanser_cells_left[local_pid] = CLEANSER_MAX_CELLS
-		player_cleansers[local_pid] = max(0, player_cleansers[local_pid] - 1)
-		update_cleanser_ui(player_cleansers[local_pid])
-	
-	NotificationManager.send_message(local_player, "Cleanser Used! (5 charges)", NotificationManager.MessageType.POWERUP)
-	
-	# Sync to server/clients
-	if not multiplayer.is_server() and _can_rpc():
-		rpc("rpc_activate_cleanser", local_pid)
-	elif multiplayer.is_server():
-		# Call RPC logic directly for host (it will set active/cells_left/consume)
-		rpc_activate_cleanser(local_pid)
-
-@rpc("any_peer", "call_local", "reliable")
-func deactivate_cleanser(player_id: int) -> void:
-	"""Deactivate cleanser immunity for a player."""
-	cleanser_active.erase(player_id)
-	cleanser_cells_left.erase(player_id)
-
-func is_cleanser_active(player_id: int) -> bool:
-	"""Check if a player has active cleanser immunity."""
-	return cleanser_active.has(player_id)
-
-func use_cleanser_cell(player_id: int) -> bool:
-	"""Use one cleanser cell. Returns true if still active, false if exhausted."""
-	if not cleanser_active.has(player_id):
-		return false
-	cleanser_cells_left[player_id] -= 1
-	if cleanser_cells_left[player_id] <= 0:
-		if _can_rpc():
-			rpc("deactivate_cleanser", player_id)
-		else:
-			deactivate_cleanser(player_id)
-		return false
-	return true
-
-func notify_movement_stopped(player_id: int, pos: Vector2i) -> void:
-	"""Called from PlayerMovementManager when a move chain settles. 
-	Previously deactivated cleanser here, but now immunity persists 
-	until charges run out to allow repeated use across safe gaps."""
-	pass
-
-@rpc("any_peer", "call_local", "reliable")
-func rpc_activate_cleanser(pid: int) -> void:
-	"""RPC for clients to activate cleanser on server."""
-	if multiplayer.is_server():
-		# Verify they actually have a cleanser charge (prevents spam/cheats)
-		if player_cleansers.get(pid, 0) <= 0:
-			return
-			
-		# Always apply the state and AoE, since this is the server authority
-		cleanser_active[pid] = true
-		cleanser_cells_left[pid] = CLEANSER_MAX_CELLS
-		player_cleansers[pid] = max(0, player_cleansers[pid] - 1)
-		if _can_rpc():
-			rpc("sync_cleanser_count", pid, player_cleansers[pid])
-		
-		# NEW: Clear 3x3 area around player
-		var all_players = get_tree().get_nodes_in_group("Players")
-		var target_player = null
-		for p in all_players:
-			var target_pid = p.get("peer_id") if "peer_id" in p else p.name.to_int()
-			if target_pid == pid:
-				target_player = p
-				break
-		
-		if gridmap and is_instance_valid(target_player):
-			var map_pos = gridmap.local_to_map(target_player.global_position)
-			var center_pos = Vector2i(map_pos.x, map_pos.z)
-			
-			# 3x3 neighborhood
-			for dx in range(-1, 2):
-				for dz in range(-1, 2):
-					var check_pos = center_pos + Vector2i(dx, dz)
-					if is_sticky_cell(check_pos):
-						clear_sticky_cell(check_pos)
-						
-			# Remove slow effect for any player in the cleansed area
-			for p in all_players:
-				if is_instance_valid(p) and p.has_method("remove_slow_effect"):
-					if gridmap:
-						var p_map_pos = gridmap.local_to_map(p.global_position)
-						var p_cell_pos = Vector2i(p_map_pos.x, p_map_pos.z)
-						if abs(p_cell_pos.x - center_pos.x) <= 1 and abs(p_cell_pos.y - center_pos.y) <= 1:
-							if _can_rpc():
-								p.rpc("remove_slow_effect")
-							else:
-								p.remove_slow_effect()
-			
-			print("[Cleanser] Server cleared 3x3 area around %s for player %d" % [center_pos, pid])
-
-@rpc("any_peer", "call_local", "reliable")
-func rpc_use_cleanser(pos: Vector2i) -> void:
-	"""RPC for clients to clear a sticky cell via Cleanser."""
-	if multiplayer.is_server():
-		clear_sticky_cell(pos)
-
-@rpc("any_peer", "call_local", "reliable")
-func rpc_consume_cleanser(pid: int) -> void:
-	"""RPC for clients to report Cleanser consumption to server."""
-	if multiplayer.is_server():
-		player_cleansers[pid] = 0
-		if _can_rpc():
-			rpc("sync_cleanser_count", pid, 0)
-
 @rpc("any_peer", "reliable")
 func rpc_trigger_slowmo() -> void:
 	"""RPC for clients to request slow-mo from server."""
@@ -1889,25 +1740,7 @@ func _setup_hud() -> void:
 	hud_layer.visible = false
 	add_child(hud_layer)
 	phase_label = hud_layer.get_node("BottomContainer/VBoxContainer/PhaseLabel")
-	cleanser_icon = hud_layer.get_node("BottomContainer/VBoxContainer/CleanserHBox/CleanserIcon")
-	cleanser_label = hud_layer.get_node("BottomContainer/VBoxContainer/CleanserHBox/CleanserLabel")
 	slowmo_label = hud_layer.get_node_or_null("TopContainer/SlowMoLabel")
-	_generate_cleanser_icon()
-
-func _generate_cleanser_icon() -> void:
-	var icon_img = Image.create(16, 16, false, Image.FORMAT_RGBA8)
-	icon_img.fill(Color(0.4, 0.9, 1.0))
-	icon_img.blend_rect(icon_img, Rect2i(2, 2, 12, 12), Vector2i(1, 1))
-	for x in range(16):
-		icon_img.set_pixel(x, 0, Color(0.2, 0.6, 0.7))
-		icon_img.set_pixel(x, 15, Color(0.2, 0.6, 0.7))
-	for y in range(16):
-		icon_img.set_pixel(0, y, Color(0.2, 0.6, 0.7))
-		icon_img.set_pixel(15, y, Color(0.2, 0.6, 0.7))
-	for i in range(4, 12):
-		icon_img.set_pixel(i, 7, Color(1.0, 1.0, 1.0, 0.8))
-		icon_img.set_pixel(7, i, Color(1.0, 1.0, 1.0, 0.8))
-	cleanser_icon.texture = ImageTexture.create_from_image(icon_img)
 
 func _update_hud_phase(phase_name: String) -> void:
 	if phase_label:
@@ -1926,20 +1759,6 @@ func _update_hud_phase(phase_name: String) -> void:
 		# Animate phase label with bounce effect
 		_animate_phase_label()
 
-func update_cleanser_ui(count: int) -> void:
-	cleanser_count = count
-	if cleanser_label:
-		cleanser_label.text = "[E] Cleanser (%d)" % count
-	# Show/hide icon based on availability
-	if cleanser_icon:
-		cleanser_icon.visible = count > 0
-		if count > 0:
-			# Pulse animation when cleanser is available
-			var tween = create_tween()
-			tween.set_loops(2)
-			tween.tween_property(cleanser_icon, "modulate", Color(1.5, 1.5, 1.5, 1), 0.3)
-			tween.tween_property(cleanser_icon, "modulate", Color.WHITE, 0.3)
-
 func _animate_phase_label() -> void:
 	"""Animate phase label with bounce effect."""
 	if not phase_label:
@@ -1964,7 +1783,7 @@ func _animate_phase_label() -> void:
 # =============================================================================
 
 func _on_goal_count_updated(peer_id: int, count: int) -> void:
-	"""Called when a player completes a goal cycle. Grant cleanser every 2 missions."""
+	"""Called when a player completes a goal cycle. Grant ghost powerup every 2 missions."""
 	if not multiplayer.is_server():
 		return
 	
@@ -1973,34 +1792,29 @@ func _on_goal_count_updated(peer_id: int, count: int) -> void:
 		player_mission_completions[peer_id] = 0
 	player_mission_completions[peer_id] += 1
 	
-	# Grant cleanser every 2 missions
+	# Grant ghost powerup every 2 missions
 	var completions = player_mission_completions[peer_id]
 	if completions % 2 == 0:
-		if not player_cleansers.has(peer_id):
+		_grant_ghost_powerup(peer_id)
-			player_cleansers[peer_id] = 0
+
-		
+func _grant_ghost_powerup(peer_id: int) -> void:
-		# Allow stacking cleanser charges instead of capping at 1
+	"""Grant the ghost (invisible mode) powerup to a player."""
-		player_cleansers[peer_id] += 1
+	var all_players = get_tree().get_nodes_in_group("Players")
-		emit_signal("cleanser_granted", peer_id)
+	for p in all_players:
-		print("[Gauntlet] Player %d granted Cleanser (Total: %d) (mission %d)" % [peer_id, player_cleansers[peer_id], completions])
+		var pid = p.get("peer_id") if "peer_id" in p else p.name.to_int()
-	
+		if pid == peer_id:
-	# Sync cleanser count to HUD
+			var stm = p.get_node_or_null("SpecialTilesManager")
-	rpc("sync_cleanser_count", peer_id, player_cleansers.get(peer_id, 0))
+			if stm and stm.has_method("add_powerup_from_item"):
+				stm.add_powerup_from_item(14) # 14 = Ghost / INVISIBLE_MODE
+				emit_signal("ghost_granted", peer_id)
+				print("[Gauntlet] Player %d granted Ghost powerup (mission %d)" % [peer_id, player_mission_completions[peer_id]])
+				NotificationManager.send_message(p, "Ghost Power Earned!", NotificationManager.MessageType.POWERUP)
+			break
 
 func _on_score_updated(peer_id: int, new_score: int) -> void:
 	"""Called when a player's score is updated."""
 	pass  # Score sync handled by GoalsCycleManager
 
-
-
-@rpc("authority", "call_local", "reliable")
-func sync_cleanser_count(peer_id: int, count: int) -> void:
-	"""Sync cleanser count to HUD for specific player."""
-	# Update local player's cleanser UI
-	var local_pid = multiplayer.get_unique_id()
-	if peer_id == local_pid:
-		update_cleanser_ui(count)
-
 # =============================================================================
 # Utility
 # =============================================================================

scripts/managers/lobby_manager.gd

@@ -36,11 +36,6 @@ signal gauntlet_round_duration_changed(duration: int)
 signal gauntlet_growth_interval_changed(interval: float)
 signal gauntlet_cells_per_tick_changed(cells: Dictionary)
 
-# Mekton Bulls settings signals
-signal mekton_bulls_round_duration_changed(duration: int)
-signal mekton_bulls_phase_interval_changed(interval: int)
-signal mekton_bulls_points_changed(min_pts: int, max_pts: int)
-
 # Room data structure
 var current_room: Dictionary = {}
 var players_in_room: Array = [] # [{id, name, is_ready}]
@@ -93,19 +88,13 @@ var gauntlet_cells_per_tick: Dictionary = {
 	"phase3": [8, 10],
 }
 
-# Mekton Bulls settings
-var mekton_bulls_round_duration: int = 120
-var mekton_bulls_phase_interval: int = 30
-var mekton_bulls_min_points: int = 100
-var mekton_bulls_max_points: int = 1000
-
 # Rematch tracking
 var rematch_votes: Array = [] # [player_id, ...]
 
 # Character and area selection
 var available_characters: Array[String] = ["Copper", "Dabro", "Gatot", "Pip", "Random"]
 var available_areas: Array[String] = []
-var available_game_modes: Array[String] = ["Freemode", "Stop n Go", "Tekton Doors", "Candy Pump Survival", "Mekton Bulls"]
+var available_game_modes: Array[String] = ["Freemode", "Stop n Go", "Candy Pump Survival"]
 var selected_area: String = "Freemode Arena" # Host-controlled
 var game_mode: String = "Freemode" # Host-controlled
 var local_character_index: int = 0 # Local player's character index
@@ -160,12 +149,8 @@ func _update_available_areas(mode: String) -> void:
 			available_areas = ["Freemode Arena", "Classic", "Colloseum"]
 		"Stop n Go":
 			available_areas = ["Stop N Go Arena"]
-		"Tekton Doors":
-			available_areas = ["Tekton Doors Area"]
 		"Candy Pump Survival":
 			available_areas = ["Gauntlet Arena"]
-		"Mekton Bulls":
-			available_areas = ["Mekton Bulls Arena"]
 		_:
 			available_areas = ["Classic"]
 
@@ -599,39 +584,6 @@ func sync_gauntlet_cells_per_tick(cells: Dictionary) -> void:
 	gauntlet_cells_per_tick = cells
 	emit_signal("gauntlet_cells_per_tick_changed", cells)
 
-# =============================================================================
-# Mekton Bulls Settings
-# =============================================================================
-
-func set_mekton_bulls_round_duration(duration: int) -> void:
-	mekton_bulls_round_duration = duration
-	if is_host: rpc("sync_mekton_bulls_round_duration", duration)
-
-@rpc("authority", "call_local", "reliable")
-func sync_mekton_bulls_round_duration(duration: int) -> void:
-	mekton_bulls_round_duration = duration
-	emit_signal("mekton_bulls_round_duration_changed", duration)
-
-func set_mekton_bulls_phase_interval(interval: int) -> void:
-	mekton_bulls_phase_interval = interval
-	if is_host: rpc("sync_mekton_bulls_phase_interval", interval)
-
-@rpc("authority", "call_local", "reliable")
-func sync_mekton_bulls_phase_interval(interval: int) -> void:
-	mekton_bulls_phase_interval = interval
-	emit_signal("mekton_bulls_phase_interval_changed", interval)
-
-func set_mekton_bulls_points(min_pts: int, max_pts: int) -> void:
-	mekton_bulls_min_points = min_pts
-	mekton_bulls_max_points = max_pts
-	if is_host: rpc("sync_mekton_bulls_points", min_pts, max_pts)
-
-@rpc("authority", "call_local", "reliable")
-func sync_mekton_bulls_points(min_pts: int, max_pts: int) -> void:
-	mekton_bulls_min_points = min_pts
-	mekton_bulls_max_points = max_pts
-	emit_signal("mekton_bulls_points_changed", min_pts, max_pts)
-
 # =============================================================================
 # Character Selection
 # =============================================================================
@@ -840,10 +792,6 @@ func start_game(force: bool = false) -> void:
 	rpc("sync_gauntlet_round_duration", gauntlet_round_duration)
 	rpc("sync_gauntlet_growth_interval", gauntlet_growth_interval)
 	rpc("sync_gauntlet_cells_per_tick", gauntlet_cells_per_tick)
-	# Sync mekton bulls
-	rpc("sync_mekton_bulls_round_duration", mekton_bulls_round_duration)
-	rpc("sync_mekton_bulls_phase_interval", mekton_bulls_phase_interval)
-	rpc("sync_mekton_bulls_points", mekton_bulls_min_points, mekton_bulls_max_points)
 	# Sync game mode
 	rpc("sync_game_mode", game_mode)
 	
@@ -922,9 +870,6 @@ func request_room_info(requester_id: int, requester_name: String, requester_char
 	rpc_id(requester_id, "sync_gauntlet_round_duration", gauntlet_round_duration)
 	rpc_id(requester_id, "sync_gauntlet_growth_interval", gauntlet_growth_interval)
 	rpc_id(requester_id, "sync_gauntlet_cells_per_tick", gauntlet_cells_per_tick)
-	rpc_id(requester_id, "sync_mekton_bulls_round_duration", mekton_bulls_round_duration)
-	rpc_id(requester_id, "sync_mekton_bulls_phase_interval", mekton_bulls_phase_interval)
-	rpc_id(requester_id, "sync_mekton_bulls_points", mekton_bulls_min_points, mekton_bulls_max_points)
 	rpc_id(requester_id, "sync_game_mode", game_mode)
 	rpc_id(requester_id, "sync_area", selected_area)
 	
@@ -1076,7 +1021,3 @@ func reset() -> void:
 	doors_swap_time = 15
 	doors_refresh_time = 25
 	doors_required_goals = 8
-	mekton_bulls_round_duration = 120
-	mekton_bulls_phase_interval = 30
-	mekton_bulls_min_points = 100
-	mekton_bulls_max_points = 1000

scripts/managers/mekton_bulls_manager.gd

@@ -1,593 +0,0 @@
-extends Node
-class_name MektonBullsManager
-
-class Blueprint3x3 extends RefCounted:
-	var anchor: Vector2i
-	var color: int
-	var cells: Array[Vector2i] = []
-	var progress: int = 0
-
-signal phase_changed(phase_index: int)
-signal player_eliminated(player_id: int)
-
-# Nodes
-var main_scene: Node
-var gridmap: Node
-
-# Phase State
-var current_phase: int = 1
-var arena_size: Vector2i = Vector2i(20, 20)
-
-var round_duration: float = 120.0
-var phase_interval: float = 30.0
-var round_timer: float = 120.0
-var phase_timer: float = 30.0
-
-signal time_remaining_changed(remaining: float)
-
-var bull_node: Node3D = null
-const BULL_SCENE = preload("res://scenes/npcs/mekton_bull.tscn")
-
-enum CellState {
-	SAFE,
-	WATER,
-	BLOCKED
-}
-var arena_cells: Dictionary = {}
-
-var is_active: bool = false
-var flood_cooldown: float = 0.0
-
-
-var player_blueprints: Dictionary = {} # { player_id: Blueprint3x3 }
-var player_powers: Dictionary = {} # { player_id: { "FREEZE": 0, "KNOCK": 0 } }
-
-var player_cooldowns: Dictionary = {} # { player_id: float }
-enum PowerType { FREEZE, KNOCK }
-
-# Placement Tracking
-var player_placement: Dictionary = {} # { pid: placement_rank } 1=first out
-var elimination_order: Array = [] # List of pids
-
-var candy_tick_timer: float = 0.0
-const GOAL_COLORS = [7, 8, 9, 10]
-
-
-const TILE_WALKABLE: int = 0
-const TILE_WATER: int = 24    # Water tile
-const TILE_OBSTACLE: int = 4  # Wall/obstacle
-
-func initialize(main: Node, grid: Node) -> void:
-	main_scene = main
-	gridmap = grid
-
-
-func start_game_mode() -> void:
-	print("[MektonBulls] Starting Mekton Bulls game mode...")
-	
-	round_duration = float(LobbyManager.mekton_bulls_round_duration)
-	phase_interval = float(LobbyManager.mekton_bulls_phase_interval)
-	round_timer = round_duration
-	phase_timer = phase_interval
-	
-	is_active = true
-	_setup_arena()
-
-	if multiplayer.has_multiplayer_peer() and multiplayer.is_server():
-		_spawn_bull()
-		_assign_initial_blueprints()
-
-
-func _ready():
-	player_eliminated.connect(_on_player_eliminated)
-
-func _setup_arena() -> void:
-	if not gridmap:
-		gridmap = get_parent().get_node_or_null("EnhancedGridMap")
-	if not gridmap:
-		gridmap = get_node_or_null("/root/Main/EnhancedGridMap")
-	if not gridmap:
-		push_error("[MektonBulls] No EnhancedGridMap found!")
-		return
-		
-	print("[MektonBulls] Setting up Phase 1 Arena...")
-	
-	if multiplayer.has_multiplayer_peer() and multiplayer.is_server():
-		rpc("sync_arena_setup")
-	_apply_arena_setup()
-
-@rpc("authority", "call_remote", "reliable")
-func sync_arena_setup() -> void:
-	_apply_arena_setup()
-
-func _apply_arena_setup() -> void:
-	if not gridmap:
-		gridmap = get_parent().get_node_or_null("EnhancedGridMap")
-	if not gridmap: return
-	
-	current_phase = 1
-	arena_size = arena_size_for_phase(current_phase)
-	
-	gridmap.set("columns", 20)
-	gridmap.set("rows", 20)
-	gridmap.clear()
-	
-	# Initial build 20x20
-	for x in range(20):
-		for z in range(20):
-			var pos = Vector2i(x, z)
-			
-			if _is_boundary(pos):
-				# Perimeter
-				gridmap.set_cell_item(Vector3i(x, 0, z), TILE_WALKABLE)
-				gridmap.set_cell_item(Vector3i(x, 1, z), -1)
-				arena_cells[pos] = CellState.SAFE
-			else:
-				# Walkable floor
-				gridmap.set_cell_item(Vector3i(x, 0, z), TILE_WALKABLE)
-				gridmap.set_cell_item(Vector3i(x, 1, z), -1)
-				arena_cells[pos] = CellState.SAFE
-			
-			gridmap.set_cell_item(Vector3i(x, 2, z), -1)
-
-	gridmap.diagonal_movement = true
-	gridmap.update_grid_data()
-	gridmap.initialize_astar()
-	
-	_reposition_npc()
-	_validate_blueprint_after_shrink()
-
-
-func arena_size_for_phase(phase: int) -> Vector2i:
-	match phase:
-		1: return Vector2i(20, 20)
-		2: return Vector2i(19, 19)
-		3: return Vector2i(18, 18)
-		4: return Vector2i(17, 17)
-		_: return Vector2i(17, 17) # Final phase
-
-func _is_boundary(pos: Vector2i) -> bool:
-	var bounds = arena_size_for_phase(current_phase)
-	# Grid shrinks symmetrically towards (0,0) by bounds.
-	return pos.x == 0 or pos.x == bounds.x - 1 or pos.y == 0 or pos.y == bounds.y - 1
-
-func _shrink_arena() -> void:
-	if current_phase >= 4:
-		return
-		
-	current_phase += 1
-	var new_bounds = arena_size_for_phase(current_phase)
-	var old_bounds = arena_size_for_phase(current_phase - 1)
-	
-	print("[MektonBulls] Shrinking arena to Phase %d (%dx%d)" % [current_phase, new_bounds.x, new_bounds.y])
-	
-	# Apply locally first
-	_apply_ring_shrink(old_bounds, new_bounds)
-	
-	if multiplayer.has_multiplayer_peer() and multiplayer.is_server():
-		rpc("sync_shrink_arena", current_phase)
-		
-	emit_signal("phase_changed", current_phase)
-
-@rpc("authority", "call_remote", "reliable")
-func sync_shrink_arena(new_phase: int) -> void:
-	var old_bounds = arena_size_for_phase(current_phase)
-	current_phase = new_phase
-	var new_bounds = arena_size_for_phase(current_phase)
-	_apply_ring_shrink(old_bounds, new_bounds)
-	emit_signal("phase_changed", current_phase)
-
-func _apply_ring_shrink(old_bounds: Vector2i, new_bounds: Vector2i) -> void:
-	for x in range(20):
-		for z in range(20):
-			var pos = Vector2i(x, z)
-			
-			if x >= new_bounds.x or z >= new_bounds.y:
-				# It is now outside the new bounds -> WATER
-				gridmap.set_cell_item(Vector3i(x, 0, z), TILE_WATER)
-				gridmap.set_cell_item(Vector3i(x, 1, z), -1) 
-				arena_cells[pos] = CellState.WATER
-			elif _is_boundary(pos):
-				# New boundary -> No wall, just the edge of SAFE
-				gridmap.set_cell_item(Vector3i(x, 1, z), -1)
-				arena_cells[pos] = CellState.SAFE
-	
-	gridmap.update_grid_data()
-	gridmap.initialize_astar()
-	
-	_reposition_npc()
-	_validate_blueprint_after_shrink()
-
-
-func _reposition_npc() -> void:
-	# Reposition Mekton Bull to the center of the current bounds
-	if not bull_node:
-		return
-		
-	var bounds = arena_size_for_phase(current_phase)
-	# Center in world units
-	var cx = (bounds.x / 2.0) * gridmap.cell_size.x
-	var cz = (bounds.y / 2.0) * gridmap.cell_size.z
-	
-	bull_node.position = Vector3(cx, 0, cz)
-
-func get_spawn_points(player_count: int) -> Array[Vector2i]:
-	var spawns: Array[Vector2i] = []
-	var bounds = arena_size_for_phase(current_phase)
-	# 4 players: inner corners
-	spawns.append(Vector2i(1, 1))
-	if bounds.x > 2: spawns.append(Vector2i(bounds.x - 2, 1))
-	if bounds.y > 2: spawns.append(Vector2i(1, bounds.y - 2))
-	if bounds.x > 2 and bounds.y > 2: spawns.append(Vector2i(bounds.x - 2, bounds.y - 2))
-	
-	if player_count > 4:
-		if bounds.x > 4: spawns.append(Vector2i(bounds.x / 2, 1))
-		if bounds.x > 4 and bounds.y > 2: spawns.append(Vector2i(bounds.x / 2, bounds.y - 2))
-	if player_count > 6:
-		if bounds.y > 4: spawns.append(Vector2i(1, bounds.y / 2))
-		if bounds.x > 2 and bounds.y > 4: spawns.append(Vector2i(bounds.x - 2, bounds.y / 2))
-		
-	return spawns.slice(0, player_count)
-
-func _spawn_bull() -> void:
-	if bull_node == null:
-		bull_node = BULL_SCENE.instantiate()
-		bull_node.name = "MektonBull"
-		# Use multiplayer spawner if appropriate, else just add child
-		main_scene.add_child(bull_node)
-		
-	var bounds = arena_size_for_phase(current_phase)
-	var cx = (bounds.x / 2.0) * gridmap.cell_size.x
-	var cz = (bounds.y / 2.0) * gridmap.cell_size.z
-	var start_pos = Vector3(cx, 0, cz)
-	
-	if bull_node.has_method("initialize"):
-		bull_node.initialize(self, gridmap, start_pos)
-
-
-func _process(delta: float) -> void:
-	if not multiplayer.has_multiplayer_peer() or multiplayer.multiplayer_peer == null: return
-	if not is_active: return
-	
-	if multiplayer.is_server():
-		round_timer -= delta
-		time_remaining_changed.emit(round_timer)
-		rpc("sync_time_remaining", round_timer)
-		
-		if round_timer <= 0:
-			_on_round_time_expired()
-			
-		phase_timer -= delta
-		if phase_timer <= 0:
-			phase_timer = phase_interval
-			_shrink_arena()
-			
-	if flood_cooldown > 0:
-
-		flood_cooldown -= delta
-		
-	if multiplayer.is_server():
-		if flood_cooldown <= 0 and bull_node:
-			var bull_pos_3d = gridmap.local_to_map(bull_node.position)
-			var bull_pos_2d = Vector2i(bull_pos_3d.x, bull_pos_3d.z)
-			if _is_boundary(bull_pos_2d):
-				_trigger_water_flood()
-		
-
-		candy_tick_timer -= delta
-		if candy_tick_timer <= 0:
-			candy_tick_timer = 0.1
-			_process_candy_tick()
-			
-		for pid in player_cooldowns.keys():
-			if player_cooldowns[pid] > 0:
-				player_cooldowns[pid] -= delta
-
-
-
-
-@rpc("authority", "call_local", "reliable")
-func sync_time_remaining(time: float) -> void:
-	round_timer = time
-	time_remaining_changed.emit(round_timer)
-
-func _on_round_time_expired() -> void:
-	is_active = false
-	var players = get_tree().get_nodes_in_group("Players")
-	for p in players:
-		if p.is_in_group("Players"):
-			var pid = p.name.to_int()
-			if not elimination_order.has(pid):
-				elimination_order.append(pid)
-				player_placement[pid] = elimination_order.size()
-	
-	_end_round()
-
-func _trigger_water_flood() -> void:
-	flood_cooldown = 3.0
-	print("[MektonBulls] Bull is on boundary! Flooding outer ring!")
-	
-	# Network sync
-	rpc("sync_water_flood")
-	_apply_water_flood()
-	
-@rpc("authority", "call_local", "reliable")
-func sync_water_flood() -> void:
-	_apply_water_flood()
-
-func _apply_water_flood() -> void:
-	# 1. Eliminate any player whose cell is currently _is_boundary
-	# (which is the outermost ring of the current arena_size)
-	var players = get_tree().get_nodes_in_group("Players")
-	var bounds = arena_size_for_phase(current_phase)
-	
-	for p in players:
-		if p.is_in_group("Players") and p.has_method("is_eliminated") and not p.is_eliminated():
-			var p_cell_3d = gridmap.local_to_map(p.position)
-			var p_cell_2d = Vector2i(p_cell_3d.x, p_cell_3d.z)
-			if _is_boundary(p_cell_2d):
-				if multiplayer.is_server():
-					if p.has_method("eliminate"):
-						p.eliminate()
-					else:
-						player_eliminated.emit(p.name.to_int())
-	
-	# 2. Play VFX / SFX (placeholder print if no actual scene yet)
-	if main_scene and main_scene.get("vfx_manager") and main_scene.vfx_manager.has_method("play_splash"):
-		var cx = (bounds.x / 2.0) * gridmap.cell_size.x
-		var cz = (bounds.y / 2.0) * gridmap.cell_size.z
-		main_scene.vfx_manager.play_splash(Vector3(cx, 0, cz))
-		
-	if has_node("/root/SfxManager"):
-		get_node("/root/SfxManager").play_rpc("water_flood")
-	else:
-		print("[MektonBulls] WHOOSH! Water flood VFX played.")
-	
-	# 3. Set those cells to TILE_WATER
-	for x in range(20):
-		for z in range(20):
-			var pos = Vector2i(x, z)
-			if _is_boundary(pos):
-				gridmap.set_cell_item(Vector3i(x, 0, z), TILE_WATER)
-				gridmap.set_cell_item(Vector3i(x, 1, z), -1) 
-				arena_cells[pos] = CellState.WATER
-				
-	gridmap.update_grid_data()
-
-func _assign_initial_blueprints() -> void:
-	var players = get_tree().get_nodes_in_group("Players")
-	for p in players:
-		if p.is_in_group("Players"):
-			_reroll_blueprint(p.name.to_int())
-
-func _reroll_blueprint(player_id: int) -> void:
-	var bp = Blueprint3x3.new()
-	bp.color = GOAL_COLORS[randi() % GOAL_COLORS.size()]
-	bp.anchor = _get_valid_3x3_anchor()
-	
-	# Generate 3x3 cells
-	for dx in range(3):
-		for dz in range(3):
-			var cpos = Vector2i(bp.anchor.x + dx, bp.anchor.y + dz)
-			bp.cells.append(cpos)
-			# Paint it
-			gridmap.set_cell_item(Vector3i(cpos.x, 0, cpos.y), bp.color)
-	
-	player_blueprints[player_id] = bp
-	gridmap.update_grid_data()
-	rpc("sync_painted_cells", bp.cells, bp.color)
-
-@rpc("authority", "call_local", "reliable")
-func sync_painted_cells(cells: Array, color: int) -> void:
-	for c in cells:
-		gridmap.set_cell_item(Vector3i(c.x, 0, c.y), color)
-
-func _get_valid_3x3_anchor() -> Vector2i:
-	var bounds = arena_size_for_phase(current_phase)
-	# boundary is 0 and bounds-1
-	# inner is 1 to bounds-2
-	# 3x3 needs x to x+2 -> x+2 <= bounds-2 -> x <= bounds-4
-	var max_x = bounds.x - 4
-	var max_y = bounds.y - 4
-	
-	if max_x < 1: max_x = 1
-	if max_y < 1: max_y = 1
-	
-	return Vector2i(randi_range(1, max_x), randi_range(1, max_y))
-
-func _process_candy_tick() -> void:
-	var players = get_tree().get_nodes_in_group("Players")
-	for p in players:
-		if not p.is_in_group("Players") or (p.has_method("is_eliminated") and p.is_eliminated()):
-			continue
-			
-		var pid = p.name.to_int()
-		if not player_blueprints.has(pid):
-			continue
-			
-		var bp: Blueprint3x3 = player_blueprints[pid]
-		var pos_3d = gridmap.local_to_map(p.position)
-		var pos = Vector2i(pos_3d.x, pos_3d.z)
-		
-		if pos in bp.cells:
-			var item = gridmap.get_cell_item(Vector3i(pos.x, 0, pos.y))
-			if item == bp.color:
-				# Pickup!
-				bp.progress += 1
-				# Remove color local
-				gridmap.set_cell_item(Vector3i(pos.x, 0, pos.y), TILE_WALKABLE)
-				rpc("sync_painted_cells", [pos], TILE_WALKABLE)
-				
-				if bp.progress >= 9:
-					_grant_power(pid)
-					_reroll_blueprint(pid)
-
-
-func _grant_power(player_id: int) -> void:
-	print("[MektonBulls] Blueprint complete! Prompting power picker for ", player_id)
-	# Safely call rpc_id
-	if multiplayer.has_multiplayer_peer() and multiplayer.get_peers().has(player_id) or player_id == multiplayer.get_unique_id():
-		rpc_id(player_id, "prompt_power_picker")
-
-@rpc("authority", "call_remote", "reliable")
-func prompt_power_picker() -> void:
-	if hud_node and hud_node.has_method("show_power_picker"):
-		hud_node.show_power_picker()
-
-var hud_node: Node = null
-
-@rpc("authority", "call_local", "reliable")
-func sync_score_completed(placements: Dictionary) -> void:
-	if hud_node and hud_node.has_method("show_placement"):
-		hud_node.show_placement(placements)
-
-@rpc("any_peer", "call_local", "reliable")
-func try_pick_power(power_type_str: String) -> void:
-	var sender = multiplayer.get_remote_sender_id()
-	if not multiplayer.is_server(): return
-	
-	if not player_powers.has(sender):
-		player_powers[sender] = { "FREEZE": 0, "KNOCK": 0 }
-		
-	if power_type_str == "FREEZE" or power_type_str == "KNOCK":
-		player_powers[sender][power_type_str] += 1
-		rpc("sync_player_powers", sender, player_powers[sender])
-
-@rpc("authority", "call_local", "reliable")
-func sync_player_powers(pid: int, powers: Dictionary) -> void:
-	player_powers[pid] = powers
-
-@rpc("any_peer", "call_local", "reliable")
-func try_use_freeze() -> void:
-	var sender = multiplayer.get_remote_sender_id()
-	if not multiplayer.is_server(): return
-	
-	if player_cooldowns.get(sender, 0.0) > 0: return
-	if not player_powers.has(sender) or player_powers[sender]["FREEZE"] <= 0: return
-	
-	player_powers[sender]["FREEZE"] -= 1
-	player_cooldowns[sender] = 1.0
-	rpc("sync_player_powers", sender, player_powers[sender])
-	
-	if bull_node and bull_node.has_method("apply_slow"):
-		bull_node.apply_slow(3.0)
-		if has_node("/root/SfxManager"):
-			get_node("/root/SfxManager").play_rpc("freeze_burst")
-	
-@rpc("any_peer", "call_local", "reliable")
-func try_use_knock(target_id: int, dir: Vector3) -> void:
-	var sender = multiplayer.get_remote_sender_id()
-	if not multiplayer.is_server(): return
-	
-	if player_cooldowns.get(sender, 0.0) > 0: return
-	if not player_powers.has(sender) or player_powers[sender]["KNOCK"] <= 0: return
-	
-	player_powers[sender]["KNOCK"] -= 1
-	player_cooldowns[sender] = 1.0
-	rpc("sync_player_powers", sender, player_powers[sender])
-	
-	rpc("sync_apply_knock", target_id, dir)
-
-
-@rpc("authority", "call_local", "reliable")
-func sync_apply_knock(target_id: int, dir: Vector3) -> void:
-	var players = get_tree().get_nodes_in_group("Players")
-	for p in players:
-		if p.name == str(target_id):
-			# Translate position 1 cell in dir
-			var move_dist = gridmap.cell_size.x
-			# Normalize to 4 directions
-			var dx = 0
-			var dz = 0
-			if abs(dir.x) > abs(dir.z):
-				dx = sign(dir.x)
-			else:
-				dz = sign(dir.z)
-				
-			p.position += Vector3(dx * move_dist, 0, dz * move_dist)
-			
-			# Play a smack sound if available
-			if has_node("/root/SfxManager"):
-				get_node("/root/SfxManager").play_rpc("knock_burst")
-			elif main_scene and main_scene.get("audio_manager") and main_scene.audio_manager.has_method("play_sfx"):
-				main_scene.audio_manager.play_sfx("smack")
-
-
-func _validate_blueprint_after_shrink() -> void:
-	if not multiplayer.is_server(): return
-	var bounds = arena_size_for_phase(current_phase)
-	
-	for pid in player_blueprints.keys():
-		var bp: Blueprint3x3 = player_blueprints[pid]
-		var outside = false
-		for c in bp.cells:
-			if c.x <= 0 or c.x >= bounds.x - 1 or c.y <= 0 or c.y >= bounds.y - 1:
-				outside = true
-				break
-				
-		if outside:
-			# Clear old ones
-			rpc("sync_painted_cells", bp.cells, TILE_WALKABLE)
-			_reroll_blueprint(pid)
-
-func _on_player_eliminated(player_id: int) -> void:
-	if not elimination_order.has(player_id):
-		elimination_order.append(player_id)
-		print("[MektonBulls] Player %d eliminated. Rank: %d" % [player_id, elimination_order.size()])
-		# Placement rank: 1 is first out
-		player_placement[player_id] = elimination_order.size()
-		
-		if multiplayer.is_server():
-			# Check if only 1 player remains
-			var players = get_tree().get_nodes_in_group("Players")
-			var alive_count = 0
-			var last_alive: int = -1
-			for p in players:
-				if p.is_in_group("Players"):
-					var pid = p.name.to_int()
-					if not elimination_order.has(pid):
-						alive_count += 1
-						last_alive = pid
-						
-			if alive_count <= 1:
-				if last_alive != -1 and not elimination_order.has(last_alive):
-					elimination_order.append(last_alive)
-					player_placement[last_alive] = elimination_order.size()
-				is_active = false
-				_end_round()
-
-func _end_round() -> void:
-	if not multiplayer.is_server(): return
-	print("[MektonBulls] Round ended. Computing placement scores...")
-	
-	var total_players = elimination_order.size()
-	if total_players == 0: return
-
-	var min_pts = LobbyManager.mekton_bulls_min_points
-	var max_pts = LobbyManager.mekton_bulls_max_points
-	
-	var scores = {}
-	for i in range(total_players):
-		var pid = elimination_order[i]
-		var rank = i + 1 # 1 = first out
-		
-		var pts = min_pts
-		if total_players > 1:
-			var t = float(rank - 1) / float(total_players - 1)
-			pts = int(lerp(float(min_pts), float(max_pts), t))
-			
-		scores[pid] = pts
-		print("[MektonBulls] Player %d finished rank %d -> %d pts" % [pid, rank, pts])
-		
-	# In the real game, we'd sync this to the scores manager
-	# main_scene.rpc("sync_score_updated", scores) - wait, is there a direct scoreboard in Mekton Bulls?
-	# Typically GoalsCycleManager tracks scores, or main.gd
-	if main_scene and main_scene.get("goals_cycle_manager"):
-		for pid in scores.keys():
-			main_scene.goals_cycle_manager.add_score(pid, scores[pid])
-	
-	rpc("sync_score_completed", player_placement)
-	
-	# End the goal cycle match if it hasn't already
-	if main_scene and main_scene.get("goals_cycle_manager") and main_scene.goals_cycle_manager.is_active:
-		main_scene.goals_cycle_manager.end_match()

scripts/managers/mekton_bulls_manager.gd.uid

@@ -1 +0,0 @@
-uid://bnsxsqvj2ea7f

scripts/managers/player_movement_manager.gd

@@ -155,19 +155,15 @@ func simple_move_to(grid_position: Vector2i) -> bool:
 				player.knock_tekton()
 				return false # Don't move into the tile, just knock
 
-	# If moving into a sticky cell: slow the player (unless cleanser active,
+	# If moving into a sticky cell: block movement unless player is in ghost
-	# which clears the cell instead). Sticky no longer hard-traps.
+	# mode (is_invisible), which lets them bypass sticky tiles in gauntlet.
 	if gm and gm.is_active and gm.is_sticky_cell(grid_position):
-		var pid = player.get("peer_id") if "peer_id" in player else -1
+		if player.get("is_invisible"):
-		if pid != -1 and gm.is_cleanser_active(pid):
+			# Ghost mode: walk through sticky tile freely
-			# Cleanser immunity: clear sticky cell, use one cell, don't slow
+			print("[Move] Ghost mode bypassed sticky cell at %s" % grid_position)
-			gm.clear_sticky_cell(grid_position)
-			gm.use_cleanser_cell(pid)
-			print("[Move] Cleanser cleared sticky cell at %s (%d cells left)" % [grid_position, gm.cleanser_cells_left.get(pid, 0)])
 		else:
-			print("[Move] Player stepping into sticky cell at %s — slowed" % grid_position)
+			print("[Move] Failed: Blocked by Gauntlet Sticky cell at %s" % grid_position)
-			if player.is_multiplayer_authority() or multiplayer.is_server():
+			return false
-				gm.apply_sticky_slow(player)
 
 	rotate_towards_target(grid_position)
 	
@@ -342,12 +338,9 @@ func try_push(target_pos: Vector2i, direction: Vector2i) -> bool:
 		if main_sticky and main_sticky.get("gauntlet_manager"):
 			var gm_sticky = main_sticky.gauntlet_manager
 			if gm_sticky.is_active and gm_sticky.is_sticky_cell(pushed_to_pos):
-				var push_pid = other_player.get("peer_id") if "peer_id" in other_player else -1
+				if other_player.get("is_invisible"):
-				if push_pid != -1 and gm_sticky.is_cleanser_active(push_pid):
+					# Ghost mode: pushed player bypasses sticky
-					# Cleanser immunity: clear sticky cell, use one cell
+					print("[Move] Ghost mode bypassed push-into-sticky at %s" % pushed_to_pos)
-					gm_sticky.clear_sticky_cell(pushed_to_pos)
-					gm_sticky.use_cleanser_cell(push_pid)
-					print("[Move] Cleanser cleared push-into-sticky at %s" % pushed_to_pos)
 				else:
 					print("[Move] Player pushed into sticky cell at %s — slowed" % pushed_to_pos)
 					if multiplayer.is_server() or other_player.is_multiplayer_authority():
@@ -365,23 +358,27 @@ func try_push(target_pos: Vector2i, direction: Vector2i) -> bool:
 		# Consume all available boost to force a full recharge cycle
 		player.powerup_manager.consume_boost(100.0)
 		
-		# SCORING: 200 Points for successful attack (ONLY in Free Mode)
+	# NEW: Always clear charged strike state to prevent multi-hit spam
-		if player.is_multiplayer_authority():
+	if player.get("is_charged_strike"):
-			var is_sng = LobbyManager.is_game_mode(GameMode.Mode.STOP_N_GO)
+		player.set("is_charged_strike", false)
-			if not is_sng:
+		
-				var main_score = player.get_tree().get_root().get_node_or_null("Main")
+	# SCORING: 200 Points for successful attack (ONLY in Free Mode)
-				if main_score:
+	if player.is_multiplayer_authority():
-					var gcm = main_score.get_node_or_null("GoalsCycleManager")
+		var is_sng = LobbyManager.is_game_mode(GameMode.Mode.STOP_N_GO)
-					if gcm:
+		if not is_sng:
-						if multiplayer.is_server():
+			var main_score = player.get_tree().get_root().get_node_or_null("Main")
-							# Server/Bot: Directly add score to specific player ID
+			if main_score:
-							gcm.add_score(player.name.to_int(), 200)
+				var gcm = main_score.get_node_or_null("GoalsCycleManager")
-						else:
+				if gcm:
-							# Client: Request score add (sender ID used)
+					if multiplayer.is_server():
-							gcm.rpc("request_add_score", 200)
+						# Server/Bot: Directly add score to specific player ID
-				NotificationManager.send_message(player, "Successful Attack! +200 Pts", NotificationManager.MessageType.GOAL)
+						gcm.add_score(player.name.to_int(), 200)
-			else:
+					else:
-				NotificationManager.send_message(player, "Successful Attack!", NotificationManager.MessageType.GOAL)
+						# Client: Request score add (sender ID used)
+						gcm.rpc("request_add_score", 200)
+			NotificationManager.send_message(player, "Successful Attack! +200 Pts", NotificationManager.MessageType.GOAL)
+		else:
+			NotificationManager.send_message(player, "Successful Attack!", NotificationManager.MessageType.GOAL)
 
 	# 5. Block the attacker from moving into the victim's space to prevent overlapping
 	return false
@@ -407,17 +404,6 @@ func _on_movement_finished():
 			emit_signal("movement_finished")
 	else:
 		current_move_direction = Vector2i.ZERO
-		# Gauntlet (#072): a Cleanser ends early once the player rests on a safe
-		# cell. Gated on gm.is_active so other game modes are never affected.
-		var gm = null
-		var main_node = player.get_tree().root.get_node_or_null("Main")
-		if main_node and main_node.get("gauntlet_manager"):
-			gm = main_node.gauntlet_manager
-		if gm and gm.is_active and player.get("current_position") != null:
-			var mpid = player.get("peer_id") if "peer_id" in player else -1
-			if mpid != -1 and gm.is_cleanser_active(mpid):
-				if multiplayer.is_server() or player.is_multiplayer_authority():
-					gm.notify_movement_stopped(mpid, player.current_position)
 		emit_signal("movement_finished")
 
 func move_to_clicked_position(grid_position: Vector2i) -> bool:

scripts/managers/special_tiles_manager.gd

@@ -547,9 +547,11 @@ func spawn_powerups_around(center: Vector2i, force_powerups: bool = true, only_c
 					# Spawn ONLY common tiles (7-10) in Stop n Go mode (User Request)
 					item_id = rng.randi_range(7, 10)
 				elif LobbyManager.is_game_mode(GameMode.Mode.GAUNTLET):
-					# Gauntlet mode: No power-up tile spawns from world.
+					# Gauntlet mode: mostly common tiles, but ghost (14) can spawn too.
-					# Only common tiles (7-10) spawn; Smack/Cleanser are handled separately.
+					if rng.randf() < 0.85:
-					item_id = rng.randi_range(7, 10)
+						item_id = rng.randi_range(7, 10)
+					else:
+						item_id = 14 # Ghost powerup only
 				else:
 					# Other modes: 80% Chance for Common Tile (7-10), 20% for PowerUp
 					if rng.randf() < 0.8:

scripts/npcs/mekton_bull.gd

@@ -1,162 +0,0 @@
-extends Area3D
-
-enum State {
-	ROAM,
-	CHARGE,
-	COOLDOWN
-}
-
-var current_state: State = State.ROAM
-var gridmap: Node
-var arena_manager: Node
-
-var move_speed: float = 3.0
-var charge_speed: float = 12.0
-var target_pos: Vector3
-var state_timer: float = 0.0
-var slow_timer: float = 0.0
-
-func _ready():
-	add_to_group("MektonBulls")
-	body_entered.connect(_on_body_entered)
-
-func initialize(manager: Node, grid: Node, start_pos: Vector3):
-	arena_manager = manager
-	gridmap = grid
-	position = start_pos
-	_pick_roam_target()
-
-func apply_slow(duration: float) -> void:
-	slow_timer = duration
-
-func _physics_process(delta: float):
-	if not multiplayer.is_server():
-		return
-		
-	state_timer -= delta
-	if slow_timer > 0:
-		slow_timer -= delta
-	
-	match current_state:
-		State.ROAM:
-			_process_roam(delta)
-			if state_timer <= 0:
-				_try_start_charge()
-		State.CHARGE:
-			_process_charge(delta)
-		State.COOLDOWN:
-			if state_timer <= 0:
-				current_state = State.ROAM
-				_pick_roam_target()
-
-func _process_roam(delta: float):
-	var dist = position.distance_to(target_pos)
-	if dist < 0.1:
-		_pick_roam_target()
-	else:
-		var dir = (target_pos - position).normalized()
-		dir.y = 0 
-		if dir.length_squared() > 0:
-			var actual_speed = move_speed
-			if slow_timer > 0: actual_speed *= 0.5
-			position += dir * actual_speed * delta
-			# Face direction implicitly
-			var look_target = position + dir
-			look_target.y = position.y
-			if position.distance_squared_to(look_target) > 0.01:
-				look_at(look_target, Vector3.UP)
-
-func _pick_roam_target():
-	if not arena_manager: return
-	
-	var bounds = arena_manager.arena_size_for_phase(arena_manager.current_phase)
-	# Random walkable position within bounds
-	# We know 0,0 is boundary, bounds.x-1 is boundary
-	var min_x = 1
-	var max_x = bounds.x - 2
-	var min_z = 1
-	var max_z = bounds.y - 2
-	
-	if min_x > max_x: max_x = min_x
-	if min_z > max_z: max_z = min_z
-	
-	# Avoid exact center (where the static delivery target presumably sits)
-	var cx = int(bounds.x / 2.0)
-	var cz = int(bounds.y / 2.0)
-	
-	var rx = cx
-	var rz = cz
-	while rx == cx and rz == cz:
-		rx = randi_range(min_x, max_x)
-		rz = randi_range(min_z, max_z)
-	
-	var world_x = rx * gridmap.cell_size.x + gridmap.cell_size.x / 2.0
-	var world_z = rz * gridmap.cell_size.z + gridmap.cell_size.z / 2.0
-	
-	target_pos = Vector3(world_x, position.y, world_z)
-	state_timer = randf_range(2.0, 4.0)
-
-func _try_start_charge():
-	# Find closest player
-	var players = get_tree().get_nodes_in_group("Players")
-	var closest_player = null
-	var min_dist = INF
-	
-	for p in players:
-		if p.is_in_group("Players") and p.has_method("is_eliminated") and not p.is_eliminated():
-			var d = position.distance_to(p.position)
-			if d < min_dist and d < 15.0: # Range check
-				min_dist = d
-				closest_player = p
-				
-	if closest_player:
-		current_state = State.CHARGE
-		target_pos = closest_player.position
-		target_pos.y = position.y
-		state_timer = 2.0 # Max charge duration
-		if has_node("/root/SfxManager"):
-			get_node("/root/SfxManager").play_rpc("bull_charge")
-	else:
-		_pick_roam_target()
-
-func _process_charge(delta: float):
-	var dir = (target_pos - position).normalized()
-	dir.y = 0
-	var actual_speed = charge_speed
-	if slow_timer > 0: actual_speed *= 0.5
-	position += dir * actual_speed * delta
-	
-	var look_target = position + dir
-	look_target.y = position.y
-	if position.distance_squared_to(look_target) > 0.01:
-		look_at(look_target, Vector3.UP)
-		
-	var dist = position.distance_to(target_pos)
-	if dist < 0.5 or state_timer <= 0:
-		# Hit destination or timeout
-		current_state = State.COOLDOWN
-		state_timer = 1.5
-
-func _on_body_entered(body: Node3D):
-	if body.is_in_group("Players") and multiplayer.is_server():
-		# Knock them out
-		if body.has_method("eliminate"):
-			body.eliminate()
-		else:
-			print("[MektonBull] Knocked out player", body.name)
-			# Dispatch via manager
-			if arena_manager and arena_manager.has_signal("player_eliminated"):
-				arena_manager.player_eliminated.emit(body.name.to_int())
-		
-		# Polish: SFX + Camera Shake
-		rpc("sync_bull_impact")
-
-@rpc("authority", "call_local", "unreliable")
-func sync_bull_impact() -> void:
-	if has_node("/root/SfxManager"):
-		get_node("/root/SfxManager").play("bull_impact")
-	
-	var root = get_tree().root
-	var main = root.get_node_or_null("Main")
-	if main and main.get("screen_shake_manager"):
-		main.screen_shake_manager.shake(0.2, 0.5)

scripts/npcs/mekton_bull.gd.uid

@@ -1 +0,0 @@
-uid://ciytpot4av5gw

scripts/ui/gacha_panel.gd

@@ -70,6 +70,10 @@ func _ready() -> void:
 	pull_10_btn.pressed.connect(func(): _do_pull(10))
 	close_result_btn.pressed.connect(func(): result_panel.hide())
 	craft_btn.pressed.connect(_on_open_craft)
+	
+	if UserProfileManager.profile_updated.connect(_refresh_ui) != OK:
+		pass
+		
 	result_panel.hide()
 	_switch_banner("star")
 

scripts/ui/mekton_bulls_hud.gd

@@ -1,57 +0,0 @@
-extends Control
-
-@onready var bull_tracker = $BullTracker
-@onready var power_picker = $PowerPicker
-@onready var placement_panel = $PlacementPanel
-@onready var placement_list = $PlacementPanel/VBoxContainer/List
-@onready var counters_lbl = $PowerCounters/Label
-
-var local_pid: int = -1
-var arena_manager: Node
-
-func _ready():
-    power_picker.hide()
-    placement_panel.hide()
-
-func set_local_player(pid: int):
-    local_pid = pid
-
-func initialize(manager: Node):
-    arena_manager = manager
-
-func _process(delta: float):
-    # Hide tracker if bull is close/visible, else point to it
-    if not arena_manager: return
-    
-    var local_powers = arena_manager.player_powers.get(local_pid, {"FREEZE": 0, "KNOCK": 0})
-    counters_lbl.text = "Freeze: %d | Knock: %d" % [local_powers.get("FREEZE", 0), local_powers.get("KNOCK", 0)]
-
-func show_power_picker():
-    power_picker.show()
-
-func _on_freeze_btn_pressed():
-    if arena_manager:
-        arena_manager.rpc_id(1, "try_pick_power", "FREEZE")
-    power_picker.hide()
-
-func _on_knock_btn_pressed():
-    if arena_manager:
-        arena_manager.rpc_id(1, "try_pick_power", "KNOCK")
-    power_picker.hide()
-
-func show_placement(scores: Dictionary):
-    placement_panel.show()
-    for child in placement_list.get_children():
-        child.queue_free()
-    
-    var items = []
-    for pid in scores.keys():
-        items.append({"pid": pid, "rank": scores[pid]})
-    
-    items.sort_custom(func(a, b): return a.rank < b.rank)
-    
-    for item in items:
-        var lbl = Label.new()
-        lbl.text = "Player %s - Rank %s" % [str(item.pid), str(item.rank)]
-        placement_list.add_child(lbl)
-

scripts/ui/mekton_bulls_hud.gd.uid

@@ -1 +0,0 @@
-uid://h2uragoekxs1

server/nakama/lua/README.md

@@ -0,0 +1,1963 @@
+# Tekton Nakama Lua Server API Reference
+<a id="top"></a>
+
+
+
+> Auto-generated from source code. For AI agents -- call these RPCs without reading Lua.
+
+## Table of Contents
+
+[↑ Back to top](#top)
+
+
+1. [Authentication & Core (core.lua)](#1-authentication--core-coreluau)
+2. [Utilities (utils.lua)](#2-utilities-utilsluau)
+3. [User Module (user.lua)](#3-user-module-userluau)
+4. [Economy Module (economy.lua)](#4-economy-module-economyluau)
+5. [Gacha Module (gacha.lua)](#5-gacha-module-gachaluau)
+6. [Leaderboard Module (leaderboard.lua)](#6-leaderboard-module-leaderboardluau)
+7. [Inbox/Mail Module (inbox.lua)](#7-inboxmail-module-inboxluau)
+8. [Daily Rewards Module (daily_rewards.lua)](#8-daily-rewards-module-daily_rewardsluau)
+9. [Admin Module (admin.lua)](#9-admin-module-adminluau)
+10. [Storage Collections Reference](#10-storage-collections-reference)
+11. [Leaderboard Config](#11-leaderboard-config)
+12. [Error Strings Reference](#12-error-strings-reference)
+13. [Permission Levels](#13-permission-levels)
+
+---
+
+## 1. Authentication & Core (`core.lua`)
+
+[↑ Back to top](#top)
+
+
+### After-Hook: `after_authenticate_steam`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Trigger** | `AuthenticateSteam` |
+| **Purpose** | On first Steam login: sets display_name from Steam username, default role to `"player"` |
+| **Auth** | None (internal hook) |
+
+**Behavior:**
+- If user has no `display_name`, sets it from `input.username` (fallback: `"SteamPlayer"`)
+- If user metadata has no `role`, sets `metadata.role = "player"`
+
+### Startup (not an RPC)
+
+[↑ Back to top](#top)
+
+
+```
+nk.leaderboard_create("global_high_score", true, "desc", "best", nil, {})
+```
+
+Creates native leaderboard `"global_high_score"` on module load (also created in `leaderboard.lua` -- pcall wraps both so duplicate is safe).
+
+---
+
+## 2. Utilities (`utils.lua`)
+
+[↑ Back to top](#top)
+
+
+Shared helpers used by other modules.
+
+### Constants
+
+[↑ Back to top](#top)
+
+
+| Constant | Value | Purpose |
+|---|---|---|
+| `ADMIN_ROLES` | `{admin=true, moderator=true, owner=true}` | Roles with admin privileges |
+| `SYSTEM_USER_ID` | `"00000000-0000-0000-0000-000000000000"` | System/nil user for global storage |
+| `CHANNEL_TYPE_ROOM` | `1` | Nakama channel type for rooms |
+| `CHANNEL_TYPE_DIRECT` | `2` | Nakama channel type for DMs |
+| `CHANNEL_TYPE_GROUP` | `3` | Nakama channel type for groups |
+
+### `utils.is_admin(context)`
+
+[↑ Back to top](#top)
+
+
+Checks if caller has admin/moderator/owner role.
+
+| Param | Type | Description |
+|---|---|---|
+| `context` | table | Nakama RPC context |
+
+**Returns:** `boolean`
+
+### `utils.is_match_host(context, match_id)`
+
+[↑ Back to top](#top)
+
+
+Checks if caller is the host of a match.
+
+| Param | Type | Description |
+|---|---|---|
+| `context` | table | Nakama RPC context |
+| `match_id` | string | Match ID to check |
+
+**Returns:** `boolean`
+**Note:** Reads `match.state` and checks `state.hostUserId` against `context.user_id`.
+
+### `utils.require_admin(context)`
+
+[↑ Back to top](#top)
+
+
+Errors with `"Admin privileges required"` if caller is not admin/moderator/owner.
+
+### `utils.require_admin_or_host(context, match_id)`
+
+[↑ Back to top](#top)
+
+
+Errors with `"Admin or host privileges required"` if caller is neither admin nor match host.
+
+### `utils.resolve_channel_id(channel_id)`
+
+[↑ Back to top](#top)
+
+
+Resolves a friendly room name (e.g. `"social_global"`) to a hashed Nakama channel ID.
+
+| Param | Type | Description |
+|---|---|---|
+| `channel_id` | string | Raw channel ID or friendly room name |
+
+**Returns:** `string` -- resolved channel ID (passes through if already hashed, i.e. contains `"."`)
+**Logic:** If no `"."` in value, calls `nk.channel_id_build("", name, CHANNEL_TYPE_ROOM)`.
+
+---
+
+## 3. User Module (`user.lua`)
+
+[↑ Back to top](#top)
+
+
+### RPC: `get_user_profile`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_get_user_profile` |
+| **Auth** | None required (can view any profile) |
+| **Purpose** | Get a user's public profile |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `user_id` | string | No | `context.user_id` | Target user ID |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `user_id` | string | User ID |
+| `username` | string | Username |
+| `display_name` | string | Display name |
+| `avatar_url` | string | Avatar URL |
+| `create_time` | string | Account creation time |
+| `role` | string | Role from metadata (`"player"` default) |
+
+**Errors:**
+- `"Account not found"` -- user doesn't exist
+- `"Account banned until <time>. Reason: <reason>"` -- temporary ban still active
+- `"Account permanently banned. Reason: <reason>"` -- permanent ban
+
+**Ban logic:** Reads `metadata.banned`, `metadata.ban_expires` (Unix timestamp), `metadata.ban_reason`. If `ban_expires <= os.time()`, auto-clears the ban on read.
+
+### RPC: `update_user_profile`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_update_user_profile` |
+| **Auth** | Required |
+| **Purpose** | Update own display name and/or avatar |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `display_name` | string | No | New display name |
+| `avatar_url` | string | No | New avatar URL |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | Always true |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Failed to update profile"`
+
+### RPC: `search_users`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_search_users` |
+| **Auth** | Required |
+| **Purpose** | Search users by username or display name |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `query` | string | No | `""` | Search term (ILike match on username/display_name). Empty = list all (limit 100). |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `users` | array | Array of user objects |
+
+**User object:**
+
+| Field | Type | Description |
+|---|---|---|
+| `user_id` | string | User ID |
+| `username` | string | Username |
+| `display_name` | string | Display name |
+| `avatar_url` | string | Avatar URL from metadata |
+
+**SQL:** Queries `users` table with `ILIKE`. Excludes system user `00000000-0000-0000-0000-000000000000`. Limit 100.
+
+### RPC: `change_credentials`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_change_credentials` |
+| **Auth** | Required |
+| **Purpose** | Change email + password credentials |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `new_email` | string | No | New email |
+| `new_password` | string | No | New password |
+| `current_password` | string | If email set | Current password (required to unlink old email) |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | Always true |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Current password required"` -- account has email but no `current_password` provided
+- `"Incorrect current password."` -- email auth re-verify failed
+- `"Failed to set new credentials: <err>"` -- link_email failed (rolls back old link)
+
+**Logic:** Verifies current password via `nk.authenticate_email`, unlinks old email, links new email+password. On failure, re-links old credentials.
+
+### RPC: `send_lobby_invite`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_send_lobby_invite` |
+| **Auth** | Required |
+| **Purpose** | Send a lobby invitation notification |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `to_user_id` | string | Yes | Recipient user ID |
+| `match_id` | string | Yes | Match/lobby ID to invite to |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | Always true |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Missing to_user_id or match_id"`
+
+**Notification:** Code `1001`, persistent (`true`). Content: `{match_id, from_name}`.
+
+### RPC: `send_friend_request`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_send_friend_request` |
+| **Auth** | Required |
+| **Purpose** | Send a friend request notification |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_id` | string | Yes | Target user ID |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | Always true |
+
+**Errors:**
+- `"Not authenticated"`
+- `"user_id is required"`
+- `"Cannot add yourself"`
+
+**Notification:** Code `1002`, persistent (`true`). Content: `{from_user_id, from_name}`.
+
+### RPC: `admin_get_user_history`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `user.rpc_admin_get_user_history` |
+| **Auth** | Admin required |
+| **Purpose** | Get wallet ledger, login history, and match history for a user |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_id` | string | Yes | Target user ID |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `history.wallet_ledger` | array | Last 50 wallet ledger entries |
+| `history.logins` | array | Login history (up to 20) |
+| `history.matches` | array | Match history from storage collection `"matches"` |
+
+**Errors:**
+- `"Admin privileges required"` (via `utils.require_admin`)
+- `"user_id is required"`
+
+### After-Hook: `after_authenticate`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Trigger** | `AuthenticateDevice`, `AuthenticateEmail`, `AuthenticateCustom` |
+| **Purpose** | Record login timestamp + IP to user storage |
+
+**Storage write:** Collection `"history"`, key `"logins"`, permission_read=`0`, permission_write=`0`. Keeps last 20 entries. Each entry: `{time, ip}`.
+
+---
+
+## 4. Economy Module (`economy.lua`)
+
+[↑ Back to top](#top)
+
+
+### Shop Catalog
+
+[↑ Back to top](#top)
+
+
+Hardcoded items available for purchase:
+
+| ID | Name | Category | Gold | Star | Rarity | Character |
+|---|---|---|---|---|---|---|
+| `oldpop-blue-hat` | Oldpop Blue Hat | head | 100 | 0 | Common | Oldpop |
+| `oldpop-green-hat` | Oldpop Green Hat | head | 100 | 0 | Common | Oldpop |
+| `oldpop-red-hat` | Oldpop Red Hat | head | 100 | 0 | Common | Oldpop |
+| `oldpop-yellow-hat` | Oldpop Yellow Hat | head | 100 | 0 | Common | Oldpop |
+| `oldpop-og-pant` | Copper OG Pant | costume | 0 | 0 | Common | Oldpop |
+| `oldpop-grey-pant` | Copper Grey Pant | costume | 150 | 0 | Common | Oldpop |
+| `oldpop-red-pant` | Copper Red Pant | costume | 150 | 0 | Common | Oldpop |
+| `oldpop-yellow-pant` | Copper Yellow Pant | costume | 150 | 0 | Common | Oldpop |
+| `oldpop-blue-gloves` | Oldpop Blue Gloves | glove | 75 | 0 | Common | Oldpop |
+| `oldpop-green-gloves` | Oldpop Green Gloves | glove | 75 | 0 | Common | Oldpop |
+| `oldpop-red-gloves` | Oldpop Red Gloves | glove | 75 | 0 | Common | Oldpop |
+| `oldpop-yellow-gloves` | Oldpop Yellow Gloves | glove | 75 | 0 | Common | Oldpop |
+
+### RPC: `get_shop_catalog`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `economy.rpc_get_shop_catalog` |
+| **Auth** | Required |
+| **Purpose** | Get the shop catalog grouped by category, plus featured banners |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `catalog` | object | Grouped by category (`head`, `costume`, `glove`). Each entry: `{id, name, gold, star, rarity, character}` |
+| `featured_banners` | array | Banners from `shop_config`/`featured_banners` (max 3 items, each: `{item_id, ...}`) |
+
+**Errors:** `"Not authenticated"`
+
+### RPC: `buy_currency`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `economy.rpc_buy_currency` |
+| **Auth** | Required |
+| **Purpose** | Purchase a currency package (IAP) |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `package_id` | string | Yes | One of: `gold_100`, `gold_500`, `gold_1000`, `gold_2000`, `gold_5000`, `gold_10000`, `star_100`, `star_250`, `star_600` |
+| `receipt` | string | For gold packages | Store receipt for validation |
+| `idempotency_key` | string | Yes | Idempotency key (prevents double-claim) |
+| `store_type` | string | No | `"google"`, `"apple"`, or `"test"` (default: `"test"`) |
+
+**Package table:**
+
+| Package ID | Gold Change | Star Change | Requires Verification |
+|---|---|---|---|
+| `gold_100` | +100 | 0 | Yes |
+| `gold_500` | +550 | 0 | Yes |
+| `gold_1000` | +1150 | 0 | Yes |
+| `gold_2000` | +2400 | 0 | Yes |
+| `gold_5000` | +6250 | 0 | Yes |
+| `gold_10000` | +13000 | 0 | Yes |
+| `star_100` | -500 | +100 | No |
+| `star_250` | -1100 | +250 | No |
+| `star_600` | -2500 | +600 | No |
+
+**Returns (JSON) -- success:**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+| `status` | string | `"verified"` (receipt validated) or `"pending"` (no receipt, awaiting verification) |
+| `package_id` | string | Package ID |
+| `duplicate` | bool | (optional) `true` if idempotency key already used |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Package ID required"`
+- `"Idempotency key required"`
+- `"Invalid package ID"`
+- `"InvalidReceipt"` -- IAP validation failed
+- `"NotEnoughFunds"` -- wallet update failed (e.g. insufficient gold for star packages)
+
+**Idempotency:** Checks `receipts` collection with idempotency_key. Returns existing result on duplicate.
+
+**Receipt validation:** For `store_type="test"`, accepts `receipt == "mock_receipt_for_now"`.
+
+### RPC: `purchase_item`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `economy.rpc_purchase_item` |
+| **Auth** | Required |
+| **Purpose** | Purchase an item from the shop catalog |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `item_id` | string | Yes | -- | Item ID from catalog |
+| `quantity` | number | No | 1 | Quantity (min 1) |
+| `idempotency_key` | string | Yes | -- | Idempotency key |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+| `item` | string | Item ID purchased |
+| `duplicate` | bool | (optional) `true` if idempotency key already used |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Item ID required"`
+- `"Invalid quantity"`
+- `"Idempotency key required"`
+- `"ItemNotFound"`
+- `"NotEnoughFunds"` -- insufficient gold/star balance
+- `"PurchaseFailed"` -- storage write failed
+
+**Storage writes:**
+- Collection `"inventory"`, key `item_id`: `{category, purchased_at, quantity}`
+- Collection `"receipts"`, key `idempotencyKey`: `{type="item", item_id, quantity, cost, processed_at}`
+
+### RPC: `admin_set_featured_banners`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `economy.rpc_admin_set_featured_banners` |
+| **Auth** | Admin required |
+| **Purpose** | Set up to 3 featured banner items for the shop |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `banners` | array | No | `[]` | Array of banner objects, each with `{item_id, ...}` (max 3) |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+| `banners` | array | Final banners array (max 3) |
+
+**Errors:**
+- `"Admin privileges required"`
+- `"Item not found in catalog: <itemId>"` -- banner references a non-catalog item
+
+**Storage:** Collection `"shop_config"`, key `"featured_banners"`, user `SYSTEM_USER_ID`, permission_read=`2`, permission_write=`0`.
+
+### RPC: `admin_get_featured_banners`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `economy.rpc_admin_get_featured_banners` |
+| **Auth** | Admin required |
+| **Purpose** | Get current featured banners config |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `banners` | array | Current banners (may be empty) |
+
+---
+
+## 5. Gacha Module (`gacha.lua`)
+
+[↑ Back to top](#top)
+
+
+### Gacha Banners
+
+[↑ Back to top](#top)
+
+
+| Banner ID | Name | Currency | Pull 1 Cost | Pull 10 Cost | Pity At |
+|---|---|---|---|---|---|
+| `star` | Star Banner | star | 160 | 1440 | 90 |
+| `gold` | Gold Banner | gold | 50 | 450 | 90 |
+
+### Drop Rates
+
+[↑ Back to top](#top)
+
+
+| Rarity | Probability | Pool Items |
+|---|---|---|
+| `real_prize` | 1.0% | `skin_gacha_rainbow_suit`, `skin_gacha_dragon_hat`, `skin_gacha_phantom_gloves`, `skin_gacha_neon_acc` |
+| `rare` | 14.0% | `frag_rare` |
+| `uncommon` | 25.0% | `frag_uncommon` |
+| `common` | 60.0% | `frag_common` |
+
+### Real Prize Catalog
+
+[↑ Back to top](#top)
+
+
+| Item ID | Name | Category |
+|---|---|---|
+| `skin_gacha_rainbow_suit` | Rainbow Suit | costume |
+| `skin_gacha_dragon_hat` | Dragon Hat | head |
+| `skin_gacha_phantom_gloves` | Phantom Gloves | glove |
+| `skin_gacha_neon_acc` | Neon Accessory | accessory |
+
+### Fragment Items
+
+[↑ Back to top](#top)
+
+
+| ID | Name | Rarity |
+|---|---|---|
+| `frag_common` | Common Fragment | common |
+| `frag_uncommon` | Uncommon Fragment | uncommon |
+| `frag_rare` | Rare Fragment | rare |
+
+### RPC: `perform_gacha_pull`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `gacha.rpc_perform_gacha_pull` |
+| **Auth** | Required |
+| **Purpose** | Perform 1 or 10 gacha pulls on a banner |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `banner_id` | string | Yes | -- | `"star"` or `"gold"` |
+| `count` | number | No | 1 | Number of pulls (1 or 10) |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | Always true |
+| `results` | array | Array of pull results: `{id, rarity, name}` |
+| `new_pity` | number | Updated pity counter for this banner |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Banner ID required"`
+- `"Invalid count"`
+- `"Unknown banner: <banner_id>"`
+- `"Could not read account"`
+- `"Insufficient currency"`
+- `"Failed to update wallet"`
+- `"Failed to write storage: <err>"`
+
+**Pity system:** After `pity_at` (90) pulls without a `real_prize`, the next pull is guaranteed `real_prize`. Pity counter resets on `real_prize` drop. Pity counter persists per banner in storage.
+
+**Storage reads/writes:**
+- Collection `"profiles"`, key `"pity_counters"`: per-banner pity counts
+- Collection `"profiles"`, key `"fragments"`: fragment inventory
+- Collection `"inventory"`, key = item_id: real prize items
+
+**Wallet:** Deducts currency cost. For `count=10`, uses `pull_10_cost` if available, otherwise `pull_1_cost * count`.
+
+---
+
+## 6. Leaderboard Module (`leaderboard.lua`)
+
+[↑ Back to top](#top)
+
+
+### Leaderboard Config
+
+[↑ Back to top](#top)
+
+
+| Property | Value |
+|---|---|
+| **ID** | `"global_high_score"` |
+| **Authoritative** | `true` |
+| **Sort Order** | `"desc"` (highest first) |
+| **Operator** | `"best"` (best score kept) |
+| **Reset Schedule** | `nil` (never resets) |
+
+### RPC: `get_leaderboard_stats`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_get_leaderboard_stats` |
+| **Auth** | None |
+| **Purpose** | Get top 50 leaderboard entries |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `leaderboard` | array | Top 50 leaderboard entries |
+
+**Leaderboard entry object:**
+
+| Field | Type | Description |
+|---|---|---|
+| `user_id` | string | Owner user ID |
+| `username` | string | Username |
+| `display_name` | string | Username (fallback -- actually `record.username`) |
+| `avatar_url` | string | Avatar URL from metadata |
+| `loadout_character` | string | Character from metadata (default `"Copper"`) |
+| `high_score` | number | Score |
+| `games_played` | number | From metadata |
+| `games_won` | number | From metadata |
+
+### RPC: `submit_score`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_submit_score` |
+| **Auth** | Required |
+| **Purpose** | Submit/update own score on the leaderboard |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `score` | number | No | 0 | Score to submit |
+| `games_played` | number | No | 0 | Games played count |
+| `games_won` | number | No | 0 | Games won count |
+| `avatar_url` | string | No | From account | Avatar URL |
+| `loadout_character` | string | No | `"Copper"` | Character selection |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Failed to submit score"`
+
+### RPC: `sync_leaderboard`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_sync_leaderboard` |
+| **Auth** | Required |
+| **Purpose** | Bulk-sync all users' stats from `"stats"` and `"profiles"` collections to the native leaderboard |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | Always true |
+| `synced` | number | Number of records written |
+| `objects_found` | number | Stats objects found |
+| `debug` | array | Error messages per user |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Sync failed: <err>"`
+
+**Storage reads:** Collection `"stats"` (all users, limit 100), Collection `"profiles"` (all users, limit 100), key `"profile"`.
+
+### RPC: `reset_stats`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_reset_stats` |
+| **Auth** | Required |
+| **Purpose** | Delete own leaderboard record and reset stats to zero |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+
+**Storage write:** Collection `"stats"`, key `"game_stats"` -- zeros out `games_played`, `games_won`, `high_score`, `total_kills`, `total_deaths`. permission_read=`2`, permission_write=`1`.
+
+### RPC: `admin_update_stats`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_admin_update_stats` |
+| **Auth** | Admin required |
+| **Purpose** | Force-overwrite a user's stats and leaderboard record |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_id` | string | Yes | Target user ID |
+| `stats` | object | Yes | Stats object: `{high_score, games_played, games_won, loadout_character, ...}` |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+
+**Errors:**
+- `"Admin privileges required"`
+- `"User ID and stats are required"`
+
+**Storage write:** Collection `"stats"`, key `"game_stats"`, permission_read=`1`, permission_write=`0`.
+
+### RPC: `admin_delete_stats`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_admin_delete_stats` |
+| **Auth** | Admin required |
+| **Purpose** | Delete a user's stats storage and leaderboard record |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_id` | string | Yes | Target user ID |
+
+**Storage deletes:** `{collection="stats", key="stats"}`, `{collection="stats", key="game_stats"}`, plus leaderboard record.
+
+### RPC: `admin_sync_leaderboard`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `leaderboard.rpc_admin_sync_leaderboard` |
+| **Auth** | Admin required |
+| **Purpose** | Same as `sync_leaderboard` but requires admin |
+
+**Delegates to:** `leaderboard.rpc_sync_leaderboard` (same params, same returns).
+
+---
+
+## 7. Inbox/Mail Module (`inbox.lua`)
+
+[↑ Back to top](#top)
+
+
+### RPC: `admin_send_mail`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_admin_send_mail` |
+| **Auth** | Admin required |
+| **Purpose** | Send a personal (targeted) or global mail |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `title` | string | No | `"Announcement"` | Mail title |
+| `content` | string | No | `""` | Mail body |
+| `start_date` | string | No | Current UTC | ISO8601 start date |
+| `end_date` | string | No | `""` | ISO8601 end date (global only) |
+| `rewards` | array/object | No | `{}` | Attached rewards (see claim_mail_reward for format) |
+| `target_user_id` | string | No | `""` | If set -> personal mail to this user. Omit -> global mail |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+| `mail` | object | The created mail object |
+
+**Mail object fields:** `id` (UUIDv4), `title`, `content`, `sender` (`"TEKTON DEV TEAM"`), `date`, `start_date`, `end_date`, `expiry_date` (30 days from now), `rewards`, `type` (`"personal"` or `"global"`).
+
+**Personal storage:** Collection `"inbox"`, key `"personal"`, permission_read=`1`, permission_write=`0`.
+**Global storage:** Collection `"config"`, key `"global_mail"`, user `SYSTEM_USER_ID`, permission_read=`2`, permission_write=`0`.
+
+### RPC: `get_mail`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_get_mail` |
+| **Auth** | Required |
+| **Purpose** | Get all non-deleted, non-expired personal + global mail for the user |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `mails` | array | Filtered mail objects (excludes deleted, expired, not-yet-started, ended global) |
+| `state` | object | `{claimed_ids, deleted_ids, read_ids}` |
+
+**Filtering logic:** Excludes mail where:
+- ID is in `state.deleted_ids`
+- `expiry_date` is in the past
+- `start_date` is in the future
+- Global mail with `end_date` in the past
+
+**Storage reads:**
+- Collection `"inbox"`, key `"personal"`, user = caller
+- Collection `"config"`, key `"global_mail"`, user = `SYSTEM_USER_ID`
+- Collection `"inbox"`, key `"state"`, user = caller
+
+### RPC: `claim_mail_reward`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_claim_mail_reward` |
+| **Auth** | Required |
+| **Purpose** | Claim rewards attached to a mail |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `mail_id` | string | Yes | Mail ID to claim rewards from |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+| `claimed_ids` | array | Updated list of claimed mail IDs |
+
+**Reward format (in the mail object):**
+
+Legacy dict format: `{star=100, gold=50}`
+Array format: `[{type="star", amount=100}, {type="gold", amount=50}, {type="frag_rare", id="frag_rare", amount=1}, {type="skin", id="skin_gacha_rainbow_suit"}]`
+
+| Reward `type` | Behavior |
+|---|---|
+| `"star"` | Added to wallet |
+| `"gold"` | Added to wallet |
+| `"frag_"` prefix | Added to inventory fragments (key: `"fragments"`) |
+| `"item"` | Added to inventory fragments |
+| `"skin"` | Added to inventory (key = skin item ID) |
+
+**Errors:**
+- `"Not authenticated"`
+- `"mail_id required"`
+- `"Reward already claimed"`
+- `"Mail not found"`
+
+**Storage writes:** Wallet update, then collection `"inventory"` (fragments or skins), then `"inbox"`/`"state"`.
+
+### RPC: `delete_mail`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_delete_mail` |
+| **Auth** | Required |
+| **Purpose** | Soft-delete a mail (adds ID to state.deleted_ids) |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `mail_id` | string | Yes | Mail ID to delete |
+
+### RPC: `save_mail_state`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_save_mail_state` |
+| **Auth** | Required |
+| **Purpose** | Mark mails as read |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `read_ids` | array | No | Array of mail IDs to mark as read |
+
+### RPC: `admin_list_mail`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_admin_list_mail` |
+| **Auth** | Admin required |
+| **Purpose** | List all mail (global + personal) across all users |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `mails` | array | All mails sorted by date descending. Personal mails have extra fields: `type="personal"`, `target_user_id` |
+
+### RPC: `admin_update_mail`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_admin_update_mail` |
+| **Auth** | Admin required |
+| **Purpose** | Edit or move a mail between users |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `mail_id` | string | Yes | Mail ID to update |
+| `type` | string | No | `"global"` or `"personal"` |
+| `target_user_id` | string | If personal | Current owner (for lookup) |
+| `new_target_user_id` | string | No | Transfer to a different user |
+| `title` | string | No | New title |
+| `content` | string | No | New content |
+| `end_date` | string | No | New end date |
+| `expiry_date` | string | No | New expiry date |
+
+### RPC: `admin_delete_mail_server`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `inbox.rpc_admin_delete_mail_server` |
+| **Auth** | Admin required |
+| **Purpose** | Permanently delete mail from server storage |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `mail_id` | string | Yes | Mail ID to delete |
+| `type` | string | No | `"global"` or `"personal"` |
+| `target_user_id` | string | If personal | Owner user ID |
+
+---
+
+## 8. Daily Rewards Module (`daily_rewards.lua`)
+
+[↑ Back to top](#top)
+
+
+### Default Reward Schedule
+
+[↑ Back to top](#top)
+
+
+Days 1-31, each day gives `star` currency: `min(10 + (day-1)*5, 100)`.
+
+| Day | Reward |
+|---|---|
+| 1 | 10 star |
+| 2 | 15 star |
+| ... | ... |
+| 19 | 100 star (capped) |
+| 20-31 | 100 star each |
+
+### RPC: `claim_daily_reward`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `daily_rewards.rpc_claim_daily_reward` |
+| **Auth** | Required |
+| **Purpose** | Claim today's daily reward |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | bool | `true` |
+| `reward_type` | string | `"star"`, `"gold"`, or a fragment ID (starts with `"frag_"`) |
+| `reward_amount` | number | Amount rewarded |
+| `day` | number | Day number (1-indexed) |
+
+**Errors:**
+- `"Not authenticated"`
+- `"Already claimed today"` -- `last_claim_date == today`
+- `"Already claimed all rewards for this month"` -- day index >= rewards array length
+- `"Already claimed today's reward"` -- day index already in `claimed_days`
+
+**Storage reads/writes:**
+- Read: Collection `"daily_rewards"`, key `"state"` (per-user)
+- Read: Collection `"config"`, key `"daily_rewards"`, user `SYSTEM_USER_ID` (config)
+- Write: Collection `"daily_rewards"`, key `"state"` (updates claimed days)
+- Write (if fragment): Collection `"inventory"`, key `"fragments"`
+- Wallet update for star/gold rewards
+
+**Reward types:** `"star"` or `"gold"` -> wallet update. `"frag_"` prefix -> inventory fragments.
+
+### RPC: `get_daily_reward_state`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `daily_rewards.rpc_get_daily_reward_state` |
+| **Auth** | Required |
+| **Purpose** | Get current daily reward state and month config |
+
+**Params:** None (ignore payload)
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `state` | object | `{claimed_days, last_claim_date, month}` |
+| `month_rewards` | array | Reward config for current month (array of `{type, amount}`) |
+| `can_claim_today` | bool | Whether user can claim today |
+| `today_date` | string | Today's UTC date (YYYY-MM-DD) |
+| `today_index` | number | Today's 0-based index |
+| `server_month` | number | Current month number |
+
+### RPC: `set_daily_reward_config` [Admin]
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `daily_rewards.rpc_set_daily_reward_config` |
+| **Auth** | Admin required |
+| **Purpose** | Set monthly daily reward configuration |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `config` | object | Yes | Map of month -> array of `{type, amount}` rewards. E.g. `{"01": [{type="star", amount=50}, ...]}` |
+
+### RPC: `get_daily_reward_config_admin` [Admin]
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `daily_rewards.rpc_get_daily_reward_config_admin` |
+| **Auth** | Admin required |
+| **Purpose** | Get the current daily reward config |
+
+---
+
+## 9. Admin Module (`admin.lua`)
+
+[↑ Back to top](#top)
+
+
+### RPC: `admin_kick_player`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_kick_player` |
+| **Auth** | Admin **or** match host |
+| **Purpose** | Kick a player from a match |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `match_id` | string | Yes | Match ID |
+| `user_id` | string | Yes | Player to kick |
+| `reason` | string | No | `"Kicked by admin"` |
+
+**Errors:**
+- `"Admin or host privileges required"`
+- `"Cannot kick yourself"`
+- `"Failed to kick player"`
+
+**Mechanism:** Sends `nk.match_signal` with `{action="kick", user_id, reason}`.
+
+### RPC: `admin_ban_player`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_ban_player` |
+| **Auth** | Admin required |
+| **Purpose** | Ban a player (sets metadata.banned, kicks from match) |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_id` | string | Yes | User to ban |
+| `reason` | string | No | `"Banned by admin"` |
+| `duration_hours` | number | No | Hours until ban expires (omitted = permanent) |
+| `match_id` | string | No | Also kick from this match |
+
+**Errors:**
+- `"Admin privileges required"`
+- `"Cannot ban yourself"`
+- `"Target account not found"`
+- `"Cannot ban an admin"`
+
+**Storage:** Writes ban record to collection `"bans"`, key = `user_id`, user = `SYSTEM_USER_ID`, permission_read=`2`, permission_write=`0`.
+
+### RPC: `admin_unban_player`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_unban_player` |
+| **Auth** | Admin required |
+| **Purpose** | Remove ban from a player |
+
+**Params (JSON):**
+
+| Field | Type | Required |
+|---|---|---|
+| `user_id` | string | Yes |
+
+### RPC: `admin_get_ban_list`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_get_ban_list` |
+| **Auth** | Admin required |
+| **Purpose** | List all ban records |
+
+### RPC: `admin_get_server_stats`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_get_server_stats` |
+| **Auth** | Admin (or host if `match_id` provided) |
+| **Purpose** | Get server stats (active matches, players) |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `match_id` | string | No | If set, includes match-specific stats |
+
+**Returns (JSON):**
+
+| Field | Type | Description |
+|---|---|---|
+| `active_matches` | number | Count of active matches |
+| `total_players` | number | Total players in matches |
+| `server_time` | number | `os.time()` |
+| `match` | object | (optional) `{id, size, tick_rate, authoritative}` |
+
+### RPC: `admin_end_match`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_end_match` |
+| **Auth** | Admin **or** match host |
+| **Purpose** | Signal a match to end |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `match_id` | string | Yes | Match ID |
+| `reason` | string | No | `"Ended by admin"` |
+
+### RPC: `admin_set_user_role`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_set_user_role` |
+| **Auth** | **Owner only** (role must be `"owner"`) |
+| **Purpose** | Set a user's role |
+
+**Params (JSON):**
+
+| Field | Type | Required | Valid Values |
+|---|---|---|---|
+| `user_id` | string | Yes | Target user |
+| `role` | string | Yes | `"player"`, `"moderator"`, `"admin"` |
+
+**Errors:**
+- `"Only owners can modify user roles"`
+- `"Invalid role"`
+
+### RPC: `admin_topup_gold`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_topup_gold` |
+| **Auth** | Admin required |
+| **Purpose** | Add 999,999 gold to own wallet (dev quick-fill) |
+
+**Wallet update:** `{gold = 999999}`
+
+### RPC: `admin_clear_global_chat`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_clear_global_chat` |
+| **Auth** | Admin required |
+| **Purpose** | Delete all messages from a chat channel |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `channel_id` | string | Yes | Channel ID or room name |
+
+**Returns (JSON):** `{success, deleted}`
+
+### RPC: `admin_list_users`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_list_users` |
+| **Auth** | Admin required |
+| **Purpose** | List all users (limit 500) with role and ban info |
+
+**Returns (JSON):** `{users: [{user_id, username, display_name, create_time, role, banned, ban_reason}], count}`
+
+### RPC: `admin_delete_users`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_delete_users` |
+| **Auth** | Admin required |
+| **Purpose** | Permanently delete user accounts |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_ids` | array | Yes | Array of user IDs to delete |
+
+**Errors:**
+- `"Cannot delete your own account"`
+- `"Cannot delete admin account"` (prevents deleting admin/moderator/owner)
+
+**Returns (JSON):** `{success, deleted: [user_ids], failed: [{user_id, reason}]}`
+
+### RPC: `admin_get_user_detail`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_get_user_detail` |
+| **Auth** | Admin required |
+| **Purpose** | Get comprehensive user details (profile, friends, purchases, storage, wallet ledger) |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `user_id` | string | Yes | -- | Target user ID |
+| `collections` | array | No | `["profiles","stats","inventory","receipts","history","matches","inbox"]` | Storage collections to include |
+
+**Returns (JSON):** Rich object with `{user, friends, purchases, wallet_ledger, storage, subscription}`.
+
+### RPC: `admin_update_user_identity`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_update_user_identity` |
+| **Auth** | Admin required |
+| **Purpose** | Update a user's identity fields (username, display_name, timezone, location, lang_tag, avatar_url, metadata) |
+
+**Params (JSON):**
+
+| Field | Type | Required |
+|---|---|---|
+| `user_id` | string | Yes |
+| `username` | string | No |
+| `display_name` | string | No |
+| `timezone` | string | No |
+| `location` | string | No |
+| `lang_tag` | string | No |
+| `avatar_url` | string | No |
+| `metadata` | object | No (merged into existing metadata) |
+
+### RPC: `admin_set_user_password`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_set_user_password` |
+| **Auth** | Admin required |
+| **Purpose** | Force-set a user's password (user must have email credential) |
+
+**Params (JSON):**
+
+| Field | Type | Required |
+|---|---|---|
+| `user_id` | string | Yes |
+| `password` | string | Yes |
+
+**Errors:**
+- `"User has no email credential"`
+- `"user_id and password are required"`
+
+### RPC: `admin_get_player_list`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_get_player_list` |
+| **Auth** | Admin **or** match host |
+| **Purpose** | Get player list for a match (stub -- returns empty) |
+
+### RPC: `admin_get_chat_config`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_get_chat_config` |
+| **Auth** | Admin required |
+| **Purpose** | Get lobby chat configuration |
+
+**Returns (JSON):** `{config: {prefix, max_messages, max_age_days}}`
+
+### RPC: `admin_set_chat_config`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_set_chat_config` |
+| **Auth** | Admin required |
+| **Purpose** | Set lobby chat configuration |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `prefix` | string | No | `""` | Chat prefix |
+| `max_messages` | number | No | 50 | Max messages |
+| `max_age_days` | number | No | 0 | Max message age |
+
+**Storage:** Collection `"config"`, key `"lobby_chat"`, user `SYSTEM_USER_ID`.
+
+### RPC: `admin_purge_old_messages`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_purge_old_messages` |
+| **Auth** | Admin required |
+| **Purpose** | Delete chat messages older than specified days |
+
+**Params (JSON):**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `channel_id` | string | Yes | Channel ID or room name |
+| `max_age_days` | number | Yes | Delete messages older than this |
+
+### RPC: `admin_list_channel_messages`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_list_channel_messages` |
+| **Auth** | Admin required |
+| **Purpose** | List messages in a chat channel |
+
+**Params (JSON):**
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `channel_id` | string | Yes | -- | Channel ID or room name |
+| `limit` | number | No | 50 | Messages per page |
+| `cursor` | string | No | `""` | Pagination cursor |
+| `forward` | bool | No | `true` | Direction |
+
+### RPC: `admin_delete_channel_message`
+
+[↑ Back to top](#top)
+
+
+| Field | Value |
+|---|---|
+| **Function** | `admin.rpc_admin_delete_channel_message` |
+| **Auth** | Admin required |
+| **Purpose** | Delete a specific chat message |
+
+**Params (JSON):**
+
+| Field | Type | Required |
+|---|---|---|
+| `channel_id` | string | Yes |
+| `message_id` | string | Yes |
+
+---
+
+## 10. Storage Collections Reference
+
+[↑ Back to top](#top)
+
+
+### Collection: `"shop_config"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `featured_banners` | SYSTEM | 2 (public) | 0 (owner) | `{banners: [{item_id, ...}]}` |
+
+### Collection: `"receipts"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `<idempotency_key>` | Owner | 1 (owner-read) | 0 (owner) | `{type, package_id/ item_id, status, changeset, receipt, processed_at, ...}` |
+
+### Collection: `"inventory"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `<item_id>` | Owner | 1 (owner-read) | 0 (owner) | `{category, purchased_at, quantity}` (or `{acquired_via, purchased_at}` for skins) |
+| `"fragments"` | Owner | 1 (owner-read) | 0 (owner) | `{frag_common: N, frag_uncommon: N, frag_rare: N, ...}` |
+
+### Collection: `"profiles"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `"pity_counters"` | Owner | 1 (owner-read) | 0 (owner) | `{star: N, gold: N}` (per-banner pity) |
+| `"fragments"` | Owner | 1 (owner-read) | 0 (owner) | Fragment counts (same as inventory fragments) |
+| `"profile"` | Owner | 2 (public) | 0 (owner) | Profile data (avatar_url, loadout_character, etc.) |
+
+### Collection: `"history"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `"logins"` | Owner | 0 (no-read) | 0 (owner) | `{logins: [{time, ip}, ...]}` (max 20) |
+
+### Collection: `"stats"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `"game_stats"` | Owner | 1 (owner-read) or 2 (public) | 1 (owner-write) or 0 (owner) | `{games_played, games_won, high_score, total_kills, total_deaths, avatar_url, loadout_character}` |
+| `"stats"` | Owner | Varies | 0 (owner) | Legacy/user-level stats |
+
+### Collection: `"inbox"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `"personal"` | Owner | 1 (owner-read) | 0 (owner) | `{mails: [{id, title, content, sender, date, start_date, end_date, expiry_date, rewards, type}]}` |
+| `"state"` | Owner | 1 (owner-read) | 0 (owner) | `{claimed_ids: [string], deleted_ids: [string], read_ids: [string]}` |
+
+### Collection: `"daily_rewards"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `"state"` | Owner | 1 (owner-read) | 0 (owner) | `{claimed_days: [number], last_claim_date: "YYYY-MM-DD", month: "MM"}` |
+
+### Collection: `"config"` (system-level)
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `"daily_rewards"` | SYSTEM | 2 (public) | 0 (owner) | `{"MM": [{type, amount}, ...]}` (month->rewards map) |
+| `"global_mail"` | SYSTEM | 2 (public) | 0 (owner) | `{mails: [{id, title, content, ...}]}` |
+| `"lobby_chat"` | SYSTEM | 2 (public) | 0 (owner) | `{prefix, max_messages, max_age_days}` |
+
+### Collection: `"bans"`
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission Read | Permission Write | Schema |
+|---|---|---|---|---|
+| `<user_id>` | SYSTEM | 2 (public) | 0 (owner) | `{user_id, username, banned_by, banned_at, reason, expires}` |
+
+### Collection: `"matches"` (per-user)
+
+[↑ Back to top](#top)
+
+
+| Key | User | Permission | Schema |
+|---|---|---|---|
+| `<match_id>` | Owner | 0 (owner) | Match result data (keyed by match ID, varies) |
+
+---
+
+## 11. Leaderboard Config
+
+[↑ Back to top](#top)
+
+
+| Property | Value |
+|---|---|
+| **ID** | `"global_high_score"` |
+| **Authoritative** | `true` (can only be written server-side) |
+| **Sort Order** | `"desc"` (highest -> lowest) |
+| **Operator** | `"best"` (keep best score per user) |
+| **Reset** | `nil` (never auto-resets) |
+| **Created By** | Both `core.lua` and `leaderboard.lua` on module load |
+
+---
+
+## 12. Error Strings Reference
+
+[↑ Back to top](#top)
+
+
+### Auth errors (raised by utils)
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Admin privileges required"` | Non-admin calls admin RPC |
+| `"Admin or host privileges required"` | Non-admin, non-host calls admin/host RPC |
+| `"Not authenticated"` | `context.user_id` is nil |
+
+### Economy errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Package ID required"` | `buy_currency` called without `package_id` |
+| `"Idempotency key required"` | Missing `idempotency_key` |
+| `"Invalid package ID"` | Unknown `package_id` |
+| `"InvalidReceipt"` | IAP receipt validation failed |
+| `"NotEnoughFunds"` | Insufficient wallet balance for purchase |
+| `"ItemNotFound"` | Item ID not in shop catalog |
+| `"Invalid quantity"` | Quantity < 1 |
+| `"PurchaseFailed"` | Storage write failed during item purchase |
+| `"Item not found in catalog: <id>"` | Admin tried to banner a non-catalog item |
+
+### User errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Account not found"` | User ID doesn't exist |
+| `"Account banned until <time>. Reason: <reason>"` | Temporary ban |
+| `"Account permanently banned. Reason: <reason>"` | Permanent ban |
+| `"Failed to update profile"` | `nk.account_update_id` failed |
+| `"Current password required"` | Email change without current password |
+| `"Incorrect current password."` | Email re-auth failed |
+| `"Failed to set new credentials: <err>"` | Link email failed |
+| `"Missing to_user_id or match_id"` | Lobby invite missing fields |
+| `"Cannot add yourself"` | Friend request to self |
+| `"user_id is required"` | Missing target in friend request |
+
+### Gacha errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Banner ID required"` | Missing `banner_id` |
+| `"Invalid count"` | Count < 1 |
+| `"Unknown banner: <id>"` | Invalid banner |
+| `"Could not read account"` | Account lookup failed |
+| `"Insufficient currency"` | Not enough star/gold |
+| `"Failed to update wallet"` | Wallet update failed |
+| `"Failed to write storage: <err>"` | Storage write failed |
+
+### Leaderboard errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Failed to submit score"` | Leaderboard write failed |
+| `"Sync failed: <err>"` | Storage list failed |
+| `"User ID and stats are required"` | Missing params in admin_update_stats |
+
+### Inbox errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"mail_id required"` | Missing mail ID |
+| `"Reward already claimed"` | Mail already in claimed_ids |
+| `"Mail not found"` | Mail ID not in any mailbox |
+| `"Mail not found in global"` | Update/delete: mail not in global |
+| `"Mail not found in personal inbox"` | Update/delete: mail not in personal |
+| `"target_user_id required for personal mail"` | Missing owner for personal mail operations |
+
+### Daily reward errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Already claimed today"` | `last_claim_date == today` |
+| `"Already claimed all rewards for this month"` | Day index >= reward array length |
+| `"Already claimed today's reward"` | Day index already in `claimed_days` |
+
+### Admin errors
+
+[↑ Back to top](#top)
+
+
+| Error String | Trigger |
+|---|---|
+| `"Cannot kick yourself"` | Self-kick attempt |
+| `"Failed to kick player"` | Match signal failed |
+| `"Cannot ban yourself"` | Self-ban attempt |
+| `"Target account not found"` | Account lookup failed |
+| `"Cannot ban an admin"` | Target is admin/moderator/owner |
+| `"Only owners can modify user roles"` | Non-owner tries role change |
+| `"Invalid role"` | Role not in `{player, moderator, admin}` |
+| `"channel_id is required"` | Missing channel ID for chat operations |
+| `"channel_id and message_id are required"` | Missing chat message params |
+| `"Failed to delete message: <err>"` | Channel message remove failed |
+| `"Failed to list messages: <err>"` | Channel list failed |
+| `"max_age_days must be > 0"` | Invalid purge param |
+| `"Match not found"` | Match lookup failed |
+| `"User has no email credential"` | Cannot set password for non-email user |
+| `"Cannot delete your own account"` | Self-deletion attempt |
+| `"Cannot delete admin account"` | Deleting admin/moderator/owner |
+| `"No user IDs provided"` | Empty `user_ids` array |
+
+---
+
+## 13. Permission Levels
+
+[↑ Back to top](#top)
+
+
+### Role Hierarchy
+
+[↑ Back to top](#top)
+
+
+| Role | Can Call Admin RPCs | Can Modify Roles | Notes |
+|---|---|---|---|
+| `"player"` | No | No | Default role |
+| `"moderator"` | Yes | No | Same as admin for auth checks |
+| `"admin"` | Yes | No | Standard admin |
+| `"owner"` | Yes | Yes (only owner) | Can set `player`, `moderator`, `admin` roles |
+
+### Auth Check Functions Summary
+
+[↑ Back to top](#top)
+
+
+| Check | What It Allows |
+|---|---|
+| `utils.require_admin` | Any RPC gated by this. Roles: admin, moderator, owner |
+| `utils.require_admin_or_host` | Admin/moderator/owner, OR match host (state.hostUserId) |
+| `metadata.role == "owner"` | Only `admin_set_user_role` |
+
+### Storage Permission Bits
+
+[↑ Back to top](#top)
+
+
+| Value | Meaning |
+|---|---|
+| `0` | Owner only (no one can read/write except server) |
+| `1` | Owner read, server write |
+| `2` | Public read, server write |
+
+### System User ID
+
+[↑ Back to top](#top)
+
+
+```
+00000000-0000-0000-0000-000000000000
+```
+
+Used for global/shared storage collections (bans, config, global_mail, shop_config).
+
+---
+
+## RPC Summary Table
+
+[↑ Back to top](#top)
+
+
+| RPC Name | Module | Auth | Admin? |
+|---|---|---|---|
+| `get_user_profile` | user | None | No |
+| `update_user_profile` | user | Required | No |
+| `search_users` | user | Required | No |
+| `change_credentials` | user | Required | No |
+| `send_lobby_invite` | user | Required | No |
+| `send_friend_request` | user | Required | No |
+| `admin_get_user_history` | user | Required | Yes |
+| `get_shop_catalog` | economy | Required | No |
+| `buy_currency` | economy | Required | No |
+| `purchase_item` | economy | Required | No |
+| `admin_set_featured_banners` | economy | Required | Yes |
+| `admin_get_featured_banners` | economy | Required | Yes |
+| `perform_gacha_pull` | gacha | Required | No |
+| `get_leaderboard_stats` | leaderboard | None | No |
+| `submit_score` | leaderboard | Required | No |
+| `sync_leaderboard` | leaderboard | Required | No |
+| `reset_stats` | leaderboard | Required | No |
+| `admin_update_stats` | leaderboard | Required | Yes |
+| `admin_delete_stats` | leaderboard | Required | Yes |
+| `admin_sync_leaderboard` | leaderboard | Required | Yes |
+| `admin_send_mail` | inbox | Required | Yes |
+| `get_mail` | inbox | Required | No |
+| `claim_mail_reward` | inbox | Required | No |
+| `delete_mail` | inbox | Required | No |
+| `save_mail_state` | inbox | Required | No |
+| `admin_list_mail` | inbox | Required | Yes |
+| `admin_update_mail` | inbox | Required | Yes |
+| `admin_delete_mail_server` | inbox | Required | Yes |
+| `claim_daily_reward` | daily_rewards | Required | No |
+| `get_daily_reward_state` | daily_rewards | Required | No |
+| `set_daily_reward_config` | daily_rewards | Required | Yes |
+| `get_daily_reward_config_admin` | daily_rewards | Required | Yes |
+| `admin_kick_player` | admin | Required | Admin or host |
+| `admin_ban_player` | admin | Required | Yes |
+| `admin_unban_player` | admin | Required | Yes |
+| `admin_get_ban_list` | admin | Required | Yes |
+| `admin_get_server_stats` | admin | Required | Admin or host |
+| `admin_end_match` | admin | Required | Admin or host |
+| `admin_set_user_role` | admin | Required | Owner only |
+| `admin_topup_gold` | admin | Required | Yes |
+| `admin_clear_global_chat` | admin | Required | Yes |
+| `admin_list_users` | admin | Required | Yes |
+| `admin_delete_users` | admin | Required | Yes |
+| `admin_get_user_detail` | admin | Required | Yes |
+| `admin_update_user_identity` | admin | Required | Yes |
+| `admin_set_user_password` | admin | Required | Yes |
+| `admin_get_player_list` | admin | Required | Admin or host |
+| `admin_get_chat_config` | admin | Required | Yes |
+| `admin_set_chat_config` | admin | Required | Yes |
+| `admin_purge_old_messages` | admin | Required | Yes |
+| `admin_list_channel_messages` | admin | Required | Yes |
+| `admin_delete_channel_message` | admin | Required | Yes |
+
+## Wallet Update Summary
+
+[↑ Back to top](#top)
+
+
+| Operation | Changeset | Context |
+|---|---|---|
+| IAP: gold packages (verified) | `{gold: +N}` | `buy_currency` |
+| IAP: star packages | `{star: +N, gold: -N}` | `buy_currency` (costs gold) |
+| Purchase item | `{gold: -N}` or `{star: -N}` | `purchase_item` |
+| Gacha pull | `{<currency>: -cost}` | `perform_gacha_pull` |
+| Claim mail rewards | `{star: +N}` and/or `{gold: +N}` | `claim_mail_reward` |
+| Daily reward | `{star: +N}` or `{gold: +N}` | `claim_daily_reward` |
+| Admin gold top-up | `{gold: 999999}` | `admin_topup_gold` |
+
+All wallet updates use `nk.wallet_update(user_id, changeset, {}, true)` (third arg `true` = update only, no metadata).

tools/generate_version_json.py

@@ -26,7 +26,7 @@ PROJECT_GODOT   = "project.godot"
 CHANGELOG_DRAFT = "CHANGELOG_DRAFT.md"
 VERSION_JSON    = "assets/data/version.json"
 EXPORT_PRESETS  = "export_presets.cfg"
-MANIFEST_URL    = "https://raw.githubusercontent.com/adtpdn/tekton-updates/main/latest/patch.pck"
+MANIFEST_URL    = "https://git.klud.top/danchie/tekton/raw/branch/patches/patch.pck"
 
 # ─── Parse command line arguments ─────────────────────────────────────────────
 parser = argparse.ArgumentParser(description="Generate version.json and update version numbers")