Refresh main branch documentation

docs: update FAQ with details on Quest standalone support and patching process
Ignore local tool settings
2026-10-25 23:18:44 -07:00 · 2026-06-15 23:58:36 +03:00 · 2026-06-09 00:16:32 +03:00 · 2026-06-01 20:55:36 +03:00 · 2026-05-31 12:32:29 +03:00 · 2026-05-30 02:13:35 +03:00
606 changed files with 10364 additions and 293550 deletions
@@ -1,72 +0,0 @@
 # Keep the build context small + reproducible. Anything not strictly
 # needed for `dotnet restore && dotnet publish` is excluded.
 # Build artefacts
 **/bin/
 **/obj/
 **/*.user
 **/*.suo
 # Dev-only configs (Local layer must NEVER ship into a container —
 # secrets are passed by env vars on Coolify).
 **/appsettings.Local.json
 **/appsettings.Development.json
 # Local runtime data
 **/data/
 **/server.log
 **/*.log
 # IDE noise
 .vs/
 .vscode/
 .idea/
 # Git
 .git/
 .gitignore
 .gitattributes
 # Reverse-engineering scratch (not needed for production server)
 Cpp2ILOutput/
 Cpp2IL_CS/
 Cpp2IL_ISIL/
 Il2CppDump/
 RR_protos/
 RR_ProtobufDefinitions.zip
 GameAssembly.dll
 global-metadata.dat
 il2cpp.h
 dump.cs
 script.json
 RoomPersistenceManager_decompiled.txt
 # Local TLS certs (mkcert) — never copy into the image
 *.pem
 hosts.dorknet.txt
 # Tools that aren't part of the server runtime
 tools/
 Tools/
 # Vite SPA build leftovers — node_modules is huge and the dist is
 # rebuilt fresh by the npm-build stage in the Dockerfile, so neither
 # should ship into the docker context. The source under admin-ui/src
 # and admin-ui/{package.json,vite.config.ts,...} is what we copy in.
 DorkNet.Server/admin-ui/node_modules/
 DorkNet.Server/admin-ui/dist/
 DorkNet.Server/admin-ui/.vite/
 DorkNet.Server/wwwroot/admin/assets/
 DorkNet.Server/wwwroot/admin/index.html
 DorkNet.Server/wwwroot/admin/*.map
 # Top-level docs / planning
 README.md
 LICENSE
 NOTICE
 BUILD_PROPER_PLAN.md
 nginx.conf
 # Other stages of the workflow
 *.md
 docs/
@@ -1,78 +0,0 @@
 # Disabled template. GitHub ignores files outside .github/workflows/.
 # Move this file to .github/workflows/endpoint-contract.yml when it should run.
 name: Endpoint Contract
 on:
  workflow_dispatch:
 jobs:
  endpoint-contract:
    runs-on: ubuntu-latest
    env:
      ASPNETCORE_ENVIRONMENT: Development
      ASPNETCORE_URLS: http://127.0.0.1:18080
      Database__Provider: sqlite
      Database__SqlitePath: ${{ runner.temp }}/dorknet-endpoint-contract.db
      DORKNET_JWT_SECRET: endpoint-contract-secret-000000000000000000000000000000000000000000
      S3__Endpoint: ""
      S3__AccessKey: ""
      S3__SecretKey: ""
      PROTOBUF_PROTOC: /usr/bin/protoc
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: 9.0.x
      - name: Install protobuf compiler
        run: |
          sudo apt-get update
          sudo apt-get install -y protobuf-compiler
      - name: Build server
        run: dotnet build DorkNet.Server/DorkNet.Server.csproj
      - name: Build endpoint contract runner
        run: dotnet build tools/DorkNet.EndpointContract/DorkNet.EndpointContract.csproj --no-restore
      - name: Start server
        run: |
          dotnet DorkNet.Server/bin/Debug/net9.0/DorkNet.Server.dll > "$RUNNER_TEMP/dorknet-server.log" 2>&1 &
          echo "$!" > "$RUNNER_TEMP/dorknet-server.pid"
      - name: Wait for server readiness
        run: |
          for attempt in {1..60}; do
            if curl --fail --silent http://127.0.0.1:18080/healthz; then
              exit 0
            fi
            sleep 2
          done
          cat "$RUNNER_TEMP/dorknet-server.log"
          exit 1
      - name: Run endpoint contract
        run: |
          dotnet run --project tools/DorkNet.EndpointContract/DorkNet.EndpointContract.csproj --no-build -- \
            --server-assembly DorkNet.Server/bin/Debug/net9.0/DorkNet.Server.dll \
            --base-url http://127.0.0.1:18080 \
            --report "$RUNNER_TEMP/endpoint-contract-report.json"
      - name: Upload endpoint contract artifacts
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: endpoint-contract
          path: |
            ${{ runner.temp }}/endpoint-contract-report.json
            ${{ runner.temp }}/dorknet-server.log
      - name: Stop server
        if: always()
        run: |
          if [ -f "$RUNNER_TEMP/dorknet-server.pid" ]; then
            kill "$(cat "$RUNNER_TEMP/dorknet-server.pid")" || true
          fi
@@ -0,0 +1,82 @@
 # Push / PR CI on `main` — fast feedback that the launcher + CLI
 # both still build, and that the CLI publishes for the cross-platform
 # RIDs the release workflow will package. Does not produce release
 # artifacts — only proves things compile.
 #
 # Runs on:
 #   - every push to main
 #   - every pull request targeting main
 #   - manual workflow_dispatch (so you can re-run after a flake without
 #     pushing an empty commit)
 name: ci
 on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:
 env:
  DOTNET_VERSION: "9.0.x"
  DOTNET_NOLOGO: "true"
  DOTNET_CLI_TELEMETRY_OPTOUT: "true"
 jobs:
  # ── Launcher needs Windows for the WPF target framework ────────────
  build-launcher:
    runs-on: windows-2022
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}
      - name: Restore
        run: dotnet restore launcher/DorkNet.Launcher.csproj
      - name: Build
        run: dotnet build launcher/DorkNet.Launcher.csproj -c Release --no-restore
      # A self-contained publish is the closest thing to "what we ship"
      # without invoking Inno Setup, which would require an extra
      # toolchain install for every CI run.
      - name: Publish (smoke)
        run: dotnet publish launcher/DorkNet.Launcher.csproj -c Release -r win-x64 --self-contained true --no-restore
  # ── CLI builds on Ubuntu — proves the shared Backend/*.cs files
  #    truly don't have Windows-only dependencies. The release pipeline
  #    later publishes the matrix; here we just confirm restore + build
  #    on the canonical Linux runner.
  build-cli:
    strategy:
      fail-fast: false
      matrix:
        rid: [win-x64, linux-x64, linux-arm64, osx-x64, osx-arm64]
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}
      - name: Restore
        run: dotnet restore cli/DorkNet.ServerCli/DorkNet.ServerCli.csproj
      - name: Publish ${{ matrix.rid }}
        run: |
          dotnet publish cli/DorkNet.ServerCli/DorkNet.ServerCli.csproj \
            -c Release \
            -r ${{ matrix.rid }} \
            --self-contained true \
            --no-restore
      - name: Smoke-test --help (host RID only)
        if: matrix.rid == 'linux-x64'
        run: |
          out=cli/DorkNet.ServerCli/bin/Release/net9.0/${{ matrix.rid }}/publish/dorknet-server
          chmod +x "$out"
          "$out" --help
@@ -0,0 +1,221 @@
 # Tagged release pipeline for the host-side tooling on `main` —
 # the Windows GUI launcher (installer + portable) and the
 # cross-platform dorknet-server CLI. Triggers on a SemVer tag like
 # v0.2.0 (or v0.2.0-rc1 for pre-releases).
 #
 # Produces, on each release:
 #   * dorknet-setup-<version>.exe       Inno Setup installer
 #   * dorknet.exe                       Portable single-file Windows build
 #   * dorknet-server-win-x64.zip        Cross-platform server CLI, per RID
 #   * dorknet-server-linux-x64.tar.gz
 #   * dorknet-server-linux-arm64.tar.gz
 #   * dorknet-server-osx-x64.tar.gz
 #   * dorknet-server-osx-arm64.tar.gz
 #   * SHA256SUMS                        Checksums of all of the above
 #
 # All of these get attached to the GitHub release the tag creates.
 name: release-launcher
 on:
  push:
    tags:
      - "v[0-9]+.[0-9]+.[0-9]+"
      - "v[0-9]+.[0-9]+.[0-9]+-*"
  workflow_dispatch:
    inputs:
      version:
        description: "Version to release (e.g. 0.2.0). Leave blank to use the workflow's git tag."
        required: false
 permissions:
  contents: write   # required to create / update GitHub releases
 env:
  DOTNET_VERSION: "9.0.x"
  DOTNET_NOLOGO: "true"
  DOTNET_CLI_TELEMETRY_OPTOUT: "true"
 jobs:
  # ── Resolve the version once and pass it to all downstream jobs ─────
  resolve-version:
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.v.outputs.version }}
    steps:
      - id: v
        shell: bash
        run: |
          if [[ -n "${{ inputs.version }}" ]]; then
            v="${{ inputs.version }}"
          else
            v="${GITHUB_REF_NAME#v}"
          fi
          echo "version=$v" >> "$GITHUB_OUTPUT"
          echo "Releasing version: $v"
  # ── Windows: GUI launcher (installer + portable) ─────────────────────
  build-launcher-windows:
    needs: resolve-version
    runs-on: windows-2022
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}
      - name: Install Inno Setup
        run: choco install innosetup --no-progress -y
      - name: Build installer + portable exe
        shell: pwsh
        run: |
          ./installer/build-installer.ps1 -Version "${{ needs.resolve-version.outputs.version }}"
      - name: Stage Windows artifacts
        shell: pwsh
        run: |
          $stage = "artifacts"
          New-Item -ItemType Directory -Force -Path $stage | Out-Null
          # Installer
          Copy-Item "installer/out/dorknet-setup-${{ needs.resolve-version.outputs.version }}.exe" $stage
          # Portable single-file build (same publish output the installer wraps)
          Copy-Item "launcher/bin/Release/net9.0-windows/win-x64/publish/dorknet.exe" $stage
      - uses: actions/upload-artifact@v4
        with:
          name: launcher-windows
          path: artifacts/*
  # ── Cross-platform server CLI, one RID per matrix entry ─────────────
  build-server-cli:
    needs: resolve-version
    strategy:
      fail-fast: false
      matrix:
        include:
          - rid: win-x64
            os: windows-2022
            ext: zip
          - rid: linux-x64
            os: ubuntu-latest
            ext: tar.gz
          - rid: linux-arm64
            os: ubuntu-latest
            ext: tar.gz
          - rid: osx-x64
            os: macos-latest
            ext: tar.gz
          - rid: osx-arm64
            os: macos-latest
            ext: tar.gz
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}
      - name: Publish dorknet-server for ${{ matrix.rid }}
        shell: bash
        run: |
          v="${{ needs.resolve-version.outputs.version }}"
          dotnet publish cli/DorkNet.ServerCli \
            -c Release \
            -r "${{ matrix.rid }}" \
            --self-contained true \
            /p:Version="$v" \
            /p:AssemblyVersion="${v}.0" \
            /p:FileVersion="${v}.0" \
            /p:InformationalVersion="$v"
      - name: Package
        shell: bash
        run: |
          src="cli/DorkNet.ServerCli/bin/Release/net9.0/${{ matrix.rid }}/publish"
          out="artifacts"
          mkdir -p "$out"
          case "${{ matrix.ext }}" in
            zip)
              # Use PowerShell on Windows so the archive is consumable
              # by Windows Explorer + curl without weird zip flags.
              pwsh -Command "Compress-Archive -Path '$src/*' -DestinationPath '$out/dorknet-server-${{ matrix.rid }}.zip' -Force"
              ;;
            tar.gz)
              # chmod +x first — single-file publish drops a binary
              # without the executable bit on macOS in some scenarios.
              chmod +x "$src"/dorknet-server || true
              tar -czf "$out/dorknet-server-${{ matrix.rid }}.tar.gz" -C "$src" .
              ;;
          esac
      - uses: actions/upload-artifact@v4
        with:
          name: server-cli-${{ matrix.rid }}
          path: artifacts/*
  # ── Aggregate, checksum, attach to the release ──────────────────────
  release:
    needs: [resolve-version, build-launcher-windows, build-server-cli]
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/download-artifact@v4
        with:
          path: dist
          merge-multiple: true
      - name: List artifacts + compute SHA256SUMS
        run: |
          cd dist
          ls -la
          sha256sum * > SHA256SUMS
          cat SHA256SUMS
      - name: Build release notes
        id: notes
        run: |
          v="${{ needs.resolve-version.outputs.version }}"
          {
            echo "## DorkNet launcher \`v$v\`"
            echo ""
            echo "Host-side release. For the matching server + client patcher per Rec Room build, see the per-version branch tags."
            echo ""
            echo "### Downloads"
            echo ""
            echo "| Platform | Use                                            | Asset |"
            echo "| --- | --- | --- |"
            echo "| Windows | One-click installer (Start menu + auto-updates) | \`dorknet-setup-$v.exe\` |"
            echo "| Windows | Portable single-file launcher                   | \`dorknet.exe\` |"
            echo "| Linux x64 | Headless host CLI                             | \`dorknet-server-linux-x64.tar.gz\` |"
            echo "| Linux arm64 | Headless host CLI                           | \`dorknet-server-linux-arm64.tar.gz\` |"
            echo "| macOS Intel | Headless host CLI                           | \`dorknet-server-osx-x64.tar.gz\` |"
            echo "| macOS Apple Silicon | Headless host CLI                   | \`dorknet-server-osx-arm64.tar.gz\` |"
            echo "| Windows | Headless host CLI (same as GUI)                 | \`dorknet-server-win-x64.zip\` |"
            echo ""
            echo "Checksums in \`SHA256SUMS\`."
            echo ""
            echo "### Setup"
            echo ""
            echo "- Windows GUI: [easy-setup.md](https://github.com/DorkSquadRR/DorkNet/blob/main/docs/easy-setup.md)"
            echo "- Linux / macOS: [server-cli.md](https://github.com/DorkSquadRR/DorkNet/blob/main/docs/server-cli.md)"
            echo "- Photon setup: [photon-setup.md](https://github.com/DorkSquadRR/DorkNet/blob/main/docs/photon-setup.md)"
          } > notes.md
      - name: Create / update GitHub release
        uses: softprops/action-gh-release@v2
        with:
          # Prerelease if the tag has a -suffix (e.g. v0.2.0-rc1).
          prerelease: ${{ contains(github.ref_name, '-') }}
          body_path: notes.md
          generate_release_notes: false
          files: |
            dist/*
          # The installer registers HKCU\Software\DorkNet\Version on
          # install — that means the auto-updater sees this version
          # only after the tag actually exists on GitHub, so we let
          # the action create the release on first push of the tag.
          fail_on_unmatched_files: true
@@ -1,58 +0,0 @@
 name: Release (december-2020-12-18)
 # Auto-publishes dorknet-server + dorknet-clientpatch zips to a
 # GitHub Release on tag push. The launcher (on the public main
 # branch) fetches the most-recent tag matching its prefix and
 # downloads these assets, so the tag format MUST start with the
 # branch's release_tag_prefix declared in versions.json.
 on:
  push:
    tags:
      - 'v1-december-*'
 permissions:
  contents: write   # create the GitHub release + upload assets
 jobs:
  release:
    runs-on: windows-latest
    env:
      VERSION_KEY: december_2020_12_18
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: '9.0.x'
      # ── Server self-contained publish ────────────────────────────────
      - name: Publish DorkNet.Server (win-x64, self-contained)
        run: |
          dotnet publish DorkNet.Server/DorkNet.Server.csproj `
            -c Release -r win-x64 --self-contained `
            -p:PublishSingleFile=true `
            -p:IncludeNativeLibrariesForSelfExtract=true `
            -p:EnableCompressionInSingleFile=true `
            -o publish/server
      - name: Zip server publish
        run: |
          Compress-Archive -Path publish/server/* `
            -DestinationPath dorknet-server-${{ env.VERSION_KEY }}-win-x64.zip
      # ── Client patcher zip (built via tools/build-patcher-zip.ps1) ───
      - name: Build client patcher zip
        run: |
          .\tools\build-patcher-zip.ps1 -VersionKey ${{ env.VERSION_KEY }}
      # ── Publish both as Release assets ───────────────────────────────
      - name: Upload Release assets
        uses: softprops/action-gh-release@v2
        with:
          files: |
            dorknet-server-${{ env.VERSION_KEY }}-win-x64.zip
            dist/dorknet-clientpatch-${{ env.VERSION_KEY }}.zip
          fail_on_unmatched_files: true
@@ -1,91 +1,71 @@
-## .NET
+# Build outputs
-bin/
+**/bin/
-obj/
+**/obj/
-build/
+**/node_modules/
-*.user
+**/dist/
-*.suo
+**/.vite/
 **/build/
 local-releases/
 **/installer/out/
 # IDE
 .vs/
 .vscode/
-*.csproj.bak
+*.user
-dist/
+*.suo
-## Data / secrets
+*.csproj.user
-# Local SQLite + uploaded blobs only — DON'T match the source-tree
+
-# DorkNet.Server/Data/ folder (which holds DbContext + Entities/) on
+# Local config (NEVER commit)
-# case-insensitive filesystems. Use the precise runtime data dirs.
+.claude/
-DorkNet.Server/bin/Debug/net9.0/data/
+appsettings.json
-DorkNet.Server/bin/Release/net9.0/data/
+appsettings.Local.json
-# appsettings.Production.json is intentionally versioned — contains
+appsettings.Development.json
-# only the Postgres provider switch + Kestrel bind address. All real
+.env
-# secrets come from Coolify env vars at runtime.
+.env.local
-tmp/
+.env.*.local
-## OS
+
 # Runtime data
 data/*.db
 data/*.db-shm
 data/*.db-wal
 data/*.db.bak.*
 data/images/
 keys/
 **/MelonLoader/UserData/dorknet-clientmod.json
 **/MelonLoader/Latest.log
 **/MelonLoader/Logs/
 **/output_log.txt
 **/crash_reports/
 # Decompilation dumps — never ship Rec Room IP derivative works
 Cpp2IL_ISIL/
 Cpp2IL_CS/
 **/Recroom_Release_Data/
 **/Recroom_Release.exe
 **/GameAssembly.dll
 **/global-metadata.dat
 **/version.dll
 # TLS certs / private keys — never ship under any name
 *.pem
 *.key
 *.crt
 *.cer
 *.pfx
 *.p12
 *.jks
 *.asc
 *.gpg
 *.kdbx
 # Maintainer-side scrub tool — operates ON this repo, must not be IN it
 tools/scrub-for-public.ps1
 # OS
 .DS_Store
 Thumbs.db
 .backups
 ## Reverse-engineered artifacts (Il2CppDumper / Cpp2IL output, not for commit)
 dump.cs
 il2cpp.h
 script.json
 stringliteral.json
 Il2CppDump/
 Cpp2ILOutput/
 Cpp2IL_CS/
 Cpp2IL_ISIL/
 RoomPersistenceManager_decompiled.txt
-## Per-machine editor / agent settings
+# Test outputs
-.claude/
+TestResults/
-global-metadata.dat
+*.coverage
 GameAssembly.dll
 _wildcard.rec.net+1.pem
 _wildcard.rec.net+1-key.pem
 dist$ZIPNAME.zip
 ## Vite admin SPA build output — derived from DorkNet.Server/admin-ui/
 ## via `npm run build` (local) or the admin-ui Dockerfile stage (deploy).
 ## Each build emits a new hash (assets/index-<hash>.js) so committing
 ## these files leaves a stale index.html → JS hash mismatch the next
 ## time someone rebuilds. Keep the source committed, regenerate output.
 DorkNet.Server/wwwroot/admin/index.html
 DorkNet.Server/wwwroot/admin/assets/
 DorkNet.Server/wwwroot/admin/brand/
 DorkNet.Server/wwwroot/admin/*.map
 DorkNet.Server/admin-ui/node_modules/
 DorkNet.Server/admin-ui/dist/
 DorkNet.Server/admin-ui/.vite/
 DorkNet.Server/admin-ui/tsconfig.tsbuildinfo
 ## Public-facing site (Vite + React, DorkNet.Server/site/)
 ## Same reasoning as admin-ui above: hashed output, regenerate per build.
 DorkNet.Server/wwwroot/site/index.html
 DorkNet.Server/wwwroot/site/assets/
 DorkNet.Server/wwwroot/site/brand/
 DorkNet.Server/wwwroot/site/*.map
 DorkNet.Server/site/node_modules/
 DorkNet.Server/site/dist/
 DorkNet.Server/site/.vite/
 DorkNet.Server/site/tsconfig.tsbuildinfo
 steamless/
 ## Local recovery / cache-mining artifacts produced by tools/recover-inventions.ps1
 ## and friends. These can run hundreds of MB to multi-GB (HTTPCache snapshots,
 ## raw .inv bytes staged for re-import, ready-to-import zip bundles). Per-room,
 ## per-run, regeneratable from the source room zip + a live walkthrough — never
 ## belongs in source control.
 *-cache-snapshot/
 *-cache-snapshot-*/
 *-recovered-inv/
 *-recovered.zip
 DorkSquad-recovered/
 ProficioVII-recovered/
 Recovered.zip
 Recovered/
 Recovered(*)/
 local-releases/**
 DorkNet.Models/bin-verify/**
 DorkNet.Models/bin-verify2/**
 identityserver-signing.pfx
@@ -0,0 +1,63 @@
 # Branches
 DorkNet keeps one long-lived branch for each supported Rec Room client
 build. Each branch carries the server and client patcher for that
 build's wire protocol. Pick the branch that matches your install.
 ## Active branches
 ### `december-2020-12-18`
 - **Client build:** Rec Room 2020.12.18
 - **Status:** active
 - **Notes:**
  - Single EF Initial migration; SQLite + Postgres both work out of the
    box.
  - Includes the chat-threads, clubs, playlists, weekly-challenge, and
    room-keys subsystems added late-2020.
  - Server's `Versions/Late2020VersionPlugin` is the active version
    plugin; client header `X-DorkNet-Version: december_2020_12_18`.
 ### `march-2020-03-10`
 - **Client build:** Rec Room 2020.03.10 (also serves 2020.03.06)
 - **Status:** active
 - **Notes:**
  - Earlier wire shape — no clubs, no playlists, simpler store catalog.
  - Diverges from `december-2020-12-18` by ~170 files; cannot be
    unified with the plugin abstraction alone.
 Setup starts the same way for both branches: pick the branch, then
 follow that branch's own deploy notes. See
 [docs/advanced-setup.md](docs/advanced-setup.md).
 ## How to pick
 If you don't know which Rec Room build you have, check:
 - **Steam**: right-click *Rec Room* → Properties → Local files →
  Browse → look at the `Recroom_Release_Data/StreamingAssets/version.txt`
  if present, or note the install timestamp.
 - **Manual install** (the typical DorkNet setup path): the build is in
  the folder name (`RecRoom-2020.12.18`, `RecRoom-2020.03.10`, etc.).
 - **Easy launcher**: auto-detects the build and picks the branch.
 ## Machine-readable manifest
 [`versions.json`](versions.json) carries the same information in a
 format the Easy launcher and install scripts can read directly. When a
 new version branch lands, add it there too.
 ## Adding a new version branch
 1. Land the server code on a new orphan branch named `<month>-<build>`
   (e.g. `august-2021-08-04`).
 2. Add a row to the active-branches list above.
 3. Add the matching entry to `versions.json`.
 4. Add a `docs/<month>-setup.md` setup guide.
 5. Tag a release on the new branch so the Easy launcher's
   release-fetcher picks it up.
 Branches are intentionally long-lived — once a build is supported, its
 branch keeps getting patches against the same wire protocol. Don't
 rebase across branches; cherry-pick when a fix applies to multiple.
@@ -0,0 +1,57 @@
 # Contributing to DorkNet
 Thanks for your interest. A few ground rules before you open a PR.
 ## Code style
 - **C#**: nullable enabled. Match the file you're editing. No regions, no
  multi-paragraph XML docs, no async-without-await.
 - **TypeScript / React**: existing patterns — function components, named
  exports, tailwind classes, no CSS modules. On a version branch, lint
  with `npm run lint` from `DorkNet.Server/admin-ui/`.
 - **No AI-co-author trailers in commit messages.** Use a real attribution
  line or none at all.
 ## Branches and commits
 - `main` is protected; PR from a feature branch.
 - Conventional commits welcome but not required. One-line summary should
  describe the *why*, not the *what* — the diff already shows what.
 ## Scope of contributions we welcome
 - Bug fixes against documented behavior
 - Feature parity with the 2020 client (anything reverse-engineered cleanly)
 - Performance work
 - Better docs, screenshots, video walkthroughs
 - New translations of the admin UI
 ## Scope of contributions we don't accept
 - **Rec Room game assets, decompiled source, or modified game binaries.**
  We never ship Rec Room IP. See [DISCLAIMER.md](DISCLAIMER.md). PRs that
  add these files will be closed.
 - **Cheats, exploits, or features that would harm other public Rec Room
  servers.** This project exists to let people self-host the 2020 backend
  for themselves; it isn't a vehicle for griefing live games.
 - **Crypto / NFT / monetization plugins.** Hard no.
 ## Reporting security issues
 Don't open a public issue. Email the maintainer at the address in the repo
 metadata, or use GitHub's private vulnerability reporting.
 ## Setting up a dev environment
 See [docs/advanced-setup.md](docs/advanced-setup.md) for the full server
 stack. The server and admin UI live on the version branches, not on
 `main`. For just hacking on the admin UI after you check out a version
 branch:
 ```bash
 cd DorkNet.Server/admin-ui
 npm install
 npm run dev
 ```
 Points at `http://localhost:5000` by default — start the server first.
@@ -0,0 +1,51 @@
 # Disclaimer
 DorkNet is an independent, fan-made, clean-room reimplementation of
 backend protocols used by old **2020 Rec Room** builds. The supported
 client builds live on separate branches, currently March 2020 and
 December 2020.
 It is **not** affiliated with, endorsed by, or sponsored by:
 - Rec Room Inc.
 - Against Gravity (the original developer)
 - Photon (Exit Games GmbH)
 - Steam / Valve Corporation
 - Meta / Oculus
 **Rec Room™**, the Rec Room logo, and all in-game art, audio, models,
 locations, characters, and brand assets are the intellectual property of
 Rec Room Inc. and are used here only for descriptive interoperability.
 ## What DorkNet does and doesn't ship
 DorkNet's repository contains:
 - Original server code (ASP.NET Core)
 - Original admin tooling (React)
 - Original MelonLoader mod (C#)
 - Patcher scripts that operate on the user's own local Rec Room install
 DorkNet's repository **does not** contain:
 - The Rec Room game executable, assets, or any redistributable Rec Room IP
 - Decompiled Rec Room source or IL2CPP dumps
 - Patched copies of `Recroom_Release.exe`, `global-metadata.dat`, or any
  Rec Room game file
 You must acquire the matching 2020 Rec Room client yourself through
 whatever means are legal in your jurisdiction, for example SteamDB depot
 tools against an account that owns Rec Room. The patcher runs on your
 machine, modifies files locally, and never uploads the game anywhere.
 ## Use at your own risk
 This is hobby software. There are no warranties of any kind. If running
 DorkNet violates a license you agreed to (e.g. Steam Subscriber Agreement,
 Rec Room Terms of Service), that's between you and the rights holder.
 DorkNet's authors take no responsibility for consequences arising from
 your use of the software.
 ## Takedown requests
 If you represent Rec Room Inc. or another rights holder and wish to discuss
 this project, please open an issue on the public repository and we will
 respond promptly.
@@ -1,108 +0,0 @@
 # DorkNet.Server container image — Coolify deploy target.
 # ────────────────────────────────────────────────────────────────────
 # Multi-stage: SDK image builds + publishes, runtime image is the
 # slimmer aspnet:9.0 with only the published output.
 #
 # Build context: repo root (so Tools/ and DorkNet.Models/ are visible
 # to ProjectReference + dotnet restore). The .dockerignore at the
 # repo root keeps the bin/, obj/, and other dev junk out of the
 # context.
 ARG DOTNET_VERSION=9.0
 ARG NODE_VERSION=20
 # ── admin SPA build stage ──────────────────────────────────────────
 # The Vite + React admin UI under DorkNet.Server/admin-ui builds in a
 # dedicated node image because the .NET SDK image doesn't ship npm.
 # Output is dropped into /wwwroot/admin and copied into the .NET build
 # stage just before `dotnet publish`, which is configured to skip its
 # own inline npm step via -p:SkipAdminUIBuild=true.
 FROM node:${NODE_VERSION}-alpine AS admin-ui
 WORKDIR /ui
 # Lockfile first for layer caching: when only application source
 # changes, the npm install step stays cached.
 COPY DorkNet.Server/admin-ui/package.json DorkNet.Server/admin-ui/package-lock.json* ./
 RUN npm install --no-fund --no-audit --loglevel=error
 # Now the source. vite.config.ts writes to ../wwwroot/admin/, which
 # from /ui is /wwwroot/admin/ — pre-create the parent so Vite's
 # emptyOutDir won't refuse to create above its cwd.
 COPY DorkNet.Server/admin-ui/ ./
 RUN mkdir -p /wwwroot/admin \
 && npm run build \
 && ls -la /wwwroot/admin \
 && ls -la /wwwroot/admin/assets
 # ── public-facing site build stage ─────────────────────────────────
 # Mirrors the admin-ui stage. Source under DorkNet.Server/site,
 # output emitted to /wwwroot/site for the .NET stage to copy.
 FROM node:${NODE_VERSION}-alpine AS site
 WORKDIR /ui
 COPY DorkNet.Server/site/package.json DorkNet.Server/site/package-lock.json* ./
 RUN npm install --no-fund --no-audit --loglevel=error
 COPY DorkNet.Server/site/ ./
 RUN mkdir -p /wwwroot/site \
 && npm run build \
 && ls -la /wwwroot/site
 # ── build stage ────────────────────────────────────────────────────
 FROM mcr.microsoft.com/dotnet/sdk:${DOTNET_VERSION} AS build
 WORKDIR /src
 # Copy csproj files first so `dotnet restore` is cached when only
 # source files change. Web SDK pulls in transitive packages from the
 # DorkNet.Models project ref, so its csproj needs to be present too.
 COPY DorkNet.Server/DorkNet.Server.csproj DorkNet.Server/
 COPY DorkNet.Models/DorkNet.Models.csproj DorkNet.Models/
 RUN dotnet restore DorkNet.Server/DorkNet.Server.csproj
 # Now copy the rest of the .NET source, then drop the prebuilt admin
 # SPA into wwwroot/admin so the publish step ships it as static content.
 COPY DorkNet.Server/ DorkNet.Server/
 COPY DorkNet.Models/ DorkNet.Models/
 COPY --from=admin-ui /wwwroot/admin/ DorkNet.Server/wwwroot/admin/
 COPY --from=site      /wwwroot/site/  DorkNet.Server/wwwroot/site/
 # Publish. SkipAdminUIBuild=true bypasses the csproj target that would
 # otherwise try to invoke npm (which this image doesn't have).
 RUN dotnet publish DorkNet.Server/DorkNet.Server.csproj \
    -c Release \
    --no-restore \
    -p:SkipAdminUIBuild=true \
    -o /app/publish
 # ── runtime stage ──────────────────────────────────────────────────
 FROM mcr.microsoft.com/dotnet/aspnet:${DOTNET_VERSION} AS runtime
 WORKDIR /app
 # curl + wget for healthcheck probes — Coolify v4 defaults to wget for
 # its own probe regardless of what the image's HEALTHCHECK uses, so
 # both have to be present. The aspnet:9.0 base image strips both by
 # default to keep the surface area small.
 RUN apt-get update \
    && apt-get install -y --no-install-recommends curl wget \
    && rm -rf /var/lib/apt/lists/*
 # Run as a non-root user — aspnet:9.0 ships with the `app` UID 1654.
 # Coolify mounts persistent volumes with write permission for this UID.
 USER app
 COPY --from=build --chown=app:app /app/publish .
 # Postgres provider is selected by appsettings.Production.json.
 # ASPNETCORE_ENVIRONMENT defaults to Production in the aspnet image
 # but we set it explicitly for clarity.
 ENV ASPNETCORE_ENVIRONMENT=Production \
    ASPNETCORE_URLS=http://0.0.0.0:8080 \
    DOTNET_RUNNING_IN_CONTAINER=true \
    DOTNET_PRINT_TELEMETRY_MESSAGE=false
 EXPOSE 8080
 # /healthz returns 503 until the migration + seed pass complete on
 # the singleton holding the pg_advisory_xact_lock; other replicas
 # block on the lock during the same window. Coolify's default 30s
 # probe interval is fine.
 HEALTHCHECK --interval=15s --timeout=5s --start-period=60s --retries=3 \
    CMD curl --fail --silent http://localhost:8080/healthz || exit 1
 ENTRYPOINT ["dotnet", "DorkNet.Server.dll"]
@@ -1,55 +0,0 @@
 ARG DOTNET_VERSION=9.0
 ARG NODE_VERSION=20
 FROM node:${NODE_VERSION}-alpine AS admin-ui
 WORKDIR /ui
 COPY DorkNet.Server/admin-ui/package.json DorkNet.Server/admin-ui/package-lock.json* ./
 RUN npm install --no-fund --no-audit --loglevel=error
 COPY DorkNet.Server/admin-ui/ ./
 RUN mkdir -p /wwwroot/admin \
    && npm run build
 FROM node:${NODE_VERSION}-alpine AS site
 WORKDIR /ui
 COPY DorkNet.Server/site/package.json DorkNet.Server/site/package-lock.json* ./
 RUN npm install --no-fund --no-audit --loglevel=error
 COPY DorkNet.Server/site/ ./
 RUN mkdir -p /wwwroot/site \
    && npm run build
 FROM mcr.microsoft.com/dotnet/sdk:${DOTNET_VERSION} AS build
 ARG PROJECT_PATH
 WORKDIR /src
 COPY . .
 COPY --from=admin-ui /wwwroot/admin/ DorkNet.Server/wwwroot/admin/
 COPY --from=site /wwwroot/site/ DorkNet.Server/wwwroot/site/
 RUN dotnet publish "${PROJECT_PATH}" -c Release \
    -p:SkipAdminUIBuild=true \
    -p:DorkNetServiceContainerPublish=true \
    -o /app/publish
 FROM mcr.microsoft.com/dotnet/aspnet:${DOTNET_VERSION} AS runtime
 ARG APP_DLL
 WORKDIR /app
 RUN apt-get update \
    && apt-get install -y --no-install-recommends curl \
    && rm -rf /var/lib/apt/lists/*
 USER app
 COPY --from=build --chown=app:app /app/publish .
 ENV ASPNETCORE_ENVIRONMENT=Production \
    ASPNETCORE_URLS=http://0.0.0.0:8080 \
    DOTNET_RUNNING_IN_CONTAINER=true \
    DOTNET_PRINT_TELEMETRY_MESSAGE=false \
    APP_DLL=${APP_DLL}
 EXPOSE 8080
 HEALTHCHECK --interval=15s --timeout=5s --start-period=30s --retries=3 \
    CMD curl --fail --silent http://localhost:8080/healthz || exit 1
 ENTRYPOINT ["sh", "-c", "dotnet \"$APP_DLL\""]
@@ -1,39 +0,0 @@
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 using DorkNet.AdminMobile.Pages;
 namespace DorkNet.AdminMobile;
 public class App : Application
 {
    public App(LoginPage loginPage)
    {
        UserAppTheme = AppTheme.Dark;
        MainPage = new NavigationPage(loginPage)
        {
            BarBackgroundColor = AppDesign.Canvas,
            BarTextColor = AppDesign.Text,
        };
    }
    public static void ShowAdmin()
    {
        Current!.MainPage = new NavigationPage(
            AppServices.Services.GetRequiredService<AdminTabbedPage>())
        {
            BarBackgroundColor = AppDesign.Canvas,
            BarTextColor = AppDesign.Text,
        };
    }
    public static void ShowLogin()
    {
        Current!.MainPage = new NavigationPage(
            AppServices.Services.GetRequiredService<LoginPage>())
        {
            BarBackgroundColor = AppDesign.Canvas,
            BarTextColor = AppDesign.Text,
        };
    }
 }
@@ -1,120 +0,0 @@
 using Microsoft.Maui.Controls;
 using Microsoft.Maui.Controls.Shapes;
 namespace DorkNet.AdminMobile.Design;
 public static class AppDesign
 {
    public static readonly Color Canvas = Color.FromArgb("#0f1115");
    public static readonly Color Surface = Color.FromArgb("#171a20");
    public static readonly Color SurfaceLifted = Color.FromArgb("#20252d");
    public static readonly Color RowSurface = Color.FromArgb("#14171d");
    public static readonly Color Stroke = Color.FromArgb("#2a3039");
    public static readonly Color Text = Color.FromArgb("#f4f6fa");
    public static readonly Color Muted = Color.FromArgb("#aeb7c6");
    public static readonly Color Subtle = Color.FromArgb("#778294");
    public static readonly Color Accent = Color.FromArgb("#64b5ff");
    public static readonly Color AndroidAccent = Color.FromArgb("#b7dd72");
    public static readonly Color Danger = Color.FromArgb("#ff6f82");
    public static Brush PageBackground => new SolidColorBrush(Canvas);
    public static Color PlatformAccent =>
 #if ANDROID
        AndroidAccent;
 #else
        Accent;
 #endif
    public static Label Title(string text) => new()
    {
        Text = text,
        TextColor = Text,
        FontSize = 22,
        FontAttributes = FontAttributes.Bold,
        LineBreakMode = LineBreakMode.TailTruncation,
    };
    public static Label Section(string text) => new()
    {
        Text = text.ToUpperInvariant(),
        TextColor = Subtle,
        FontSize = 12,
        FontAttributes = FontAttributes.Bold,
        Margin = new Thickness(0, 12, 0, 0),
    };
    public static Border GlassCard(View content, Thickness? padding = null) => new()
    {
        Padding = padding ?? new Thickness(14),
        Stroke = Stroke,
        StrokeThickness = 1,
        BackgroundColor = Surface,
        StrokeShape = new RoundRectangle { CornerRadius = 10 },
        Content = content,
    };
    public static Button PrimaryButton(string text) => new()
    {
        Text = text,
        BackgroundColor = PlatformAccent,
        TextColor = Colors.Black,
        CornerRadius = 10,
        HeightRequest = 44,
        FontAttributes = FontAttributes.Bold,
        Padding = new Thickness(14, 0),
    };
    public static Button SecondaryButton(string text) => new()
    {
        Text = text,
        BackgroundColor = SurfaceLifted,
        TextColor = Text,
        CornerRadius = 10,
        HeightRequest = 42,
        Padding = new Thickness(14, 0),
    };
    public static Button DangerButton(string text) => new()
    {
        Text = text,
        BackgroundColor = Color.FromArgb("#4c1d28"),
        TextColor = Color.FromArgb("#ffd5dc"),
        CornerRadius = 10,
        HeightRequest = 42,
        Padding = new Thickness(12, 0),
    };
    public static Entry Entry(string placeholder, Keyboard? keyboard = null, bool secret = false) => new()
    {
        Placeholder = placeholder,
        IsPassword = secret,
        TextColor = Text,
        PlaceholderColor = Subtle,
        BackgroundColor = Color.FromArgb("#19202b"),
        ClearButtonVisibility = ClearButtonVisibility.WhileEditing,
        Keyboard = keyboard ?? Keyboard.Text,
        HeightRequest = 44,
    };
    public static Label Caption(string text) => new()
    {
        Text = text,
        TextColor = Muted,
        FontSize = 13,
        LineBreakMode = LineBreakMode.WordWrap,
    };
    public static BoxView Divider() => new()
    {
        HeightRequest = 1,
        Color = Stroke,
        Opacity = 0.7,
    };
    public static Label StatusLabel() => new()
    {
        TextColor = Muted,
        FontSize = 13,
    };
 }
@@ -1,32 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net9.0-android36.0;net9.0-ios26.0</TargetFrameworks>
    <OutputType>Exe</OutputType>
    <RootNamespace>DorkNet.AdminMobile</RootNamespace>
    <UseMaui>true</UseMaui>
    <SingleProject>true</SingleProject>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <ApplicationTitle>DorkNet Admin</ApplicationTitle>
    <ApplicationId>net.dorknet.adminmobile</ApplicationId>
    <ApplicationDisplayVersion>1.0</ApplicationDisplayVersion>
    <ApplicationVersion>3</ApplicationVersion>
    <AndroidTargetSdkVersion>36</AndroidTargetSdkVersion>
    <RuntimeIdentifiers>android-arm;android-arm64;android-x86;android-x64</RuntimeIdentifiers>
    <PublishTrimmed Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">false</PublishTrimmed>
    <RunAOTCompilation Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">false</RunAOTCompilation>
    <AndroidLinkMode Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">None</AndroidLinkMode>
    <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">23.0</SupportedOSPlatformVersion>
    <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">14.2</SupportedOSPlatformVersion>
  </PropertyGroup>
  <ItemGroup>
    <MauiIcon Include="Resources\AppIcon\appicon.svg" ForegroundFile="Resources\AppIcon\appiconfg.svg" Color="#0B0F14" />
    <MauiSplashScreen Include="Resources\Splash\splash.svg" Color="#0B0F14" BaseSize="256,256" />
    <MauiImage Include="Resources\Brand\dorknet.svg" BaseSize="256,256" />
  </ItemGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Maui.Controls" Version="9.0.120" />
  </ItemGroup>
 </Project>
@@ -1,34 +0,0 @@
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Maui.Controls.Hosting;
 using Microsoft.Maui.Hosting;
 using DorkNet.AdminMobile.Pages;
 using DorkNet.AdminMobile.Services;
 namespace DorkNet.AdminMobile;
 public static class MauiProgram
 {
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder.UseMauiApp<App>();
        builder.Services.AddSingleton<SecureAdminSettings>();
        builder.Services.AddSingleton<AdminApiClient>();
        builder.Services.AddTransient<LoginPage>();
        builder.Services.AddTransient<AdminTabbedPage>();
        builder.Services.AddTransient<DashboardPage>();
        builder.Services.AddTransient<PlayersPage>();
        builder.Services.AddTransient<RoomsPage>();
        builder.Services.AddTransient<SettingsPage>();
        var app = builder.Build();
        AppServices.Services = app.Services;
        return app;
    }
 }
 public static class AppServices
 {
    public static IServiceProvider Services { get; set; } = default!;
 }
@@ -1,114 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.AdminMobile.Models;
 public sealed class AdminLoginResponse
 {
    [JsonPropertyName("access_token")]
    public string AccessToken { get; set; } = string.Empty;
    [JsonPropertyName("refresh_token")]
    public string RefreshToken { get; set; } = string.Empty;
    [JsonPropertyName("account_id")]
    public long AccountId { get; set; }
    [JsonPropertyName("username")]
    public string Username { get; set; } = string.Empty;
    [JsonPropertyName("display_name")]
    public string DisplayName { get; set; } = string.Empty;
 }
 public sealed class PlayerSummary
 {
    public long Id { get; set; }
    public string Username { get; set; } = string.Empty;
    public string DisplayName { get; set; } = string.Empty;
    public string? Email { get; set; }
    public bool IsAdmin { get; set; }
    public bool IsDeveloper { get; set; }
    public bool IsVerified { get; set; }
    public bool IsJunior { get; set; }
    public bool Online { get; set; }
    public int Level { get; set; }
    public int XP { get; set; }
    public DateTime? LastSeenAt { get; set; }
    public DateTime? BannedUntil { get; set; }
 }
 public sealed class RoomSummary
 {
    public long Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public long CreatorPlayerId { get; set; }
    public int BlobCount { get; set; }
    public bool IsAGRoom { get; set; }
    public bool IsDormRoom { get; set; }
 }
 public sealed class InstanceSummary
 {
    public long RoomInstanceId { get; set; }
    public long RoomId { get; set; }
    public string RoomName { get; set; } = string.Empty;
    public string PhotonRoomId { get; set; } = string.Empty;
    public string PhotonRegionId { get; set; } = string.Empty;
    public int MaxCapacity { get; set; }
    public bool IsPrivate { get; set; }
    public List<InstanceParticipant> Participants { get; set; } = [];
 }
 public sealed class InstanceParticipant
 {
    public long Id { get; set; }
    public string Username { get; set; } = string.Empty;
    public string DisplayName { get; set; } = string.Empty;
    public bool IsMaster { get; set; }
 }
 public sealed class ServerSettingsDto
 {
    public bool SignupsDisabled { get; set; }
    public bool GlobalFriendsEnabled { get; set; }
    public bool WeeklyChallengesCompletedRequired { get; set; }
    public DateTime UpdatedAt { get; set; }
 }
 public sealed class AdminStats
 {
    public PlayerStats Players { get; set; } = new();
    public RoomStats Rooms { get; set; } = new();
    public int Inventions { get; set; }
    public PhotoStats Photos { get; set; } = new();
    public ModerationStats Moderation { get; set; } = new();
    public DateTime ServerTime { get; set; }
 }
 public sealed class PlayerStats
 {
    public int Total { get; set; }
    public int OnlineNow { get; set; }
    public int BannedNow { get; set; }
    public int NewToday { get; set; }
 }
 public sealed class RoomStats
 {
    public int Total { get; set; }
    public long TotalVisits { get; set; }
    public long TotalCheers { get; set; }
    public int ActiveSessionCount { get; set; }
    public int InGamePlayerCount { get; set; }
 }
 public sealed class PhotoStats
 {
    public int Today { get; set; }
 }
 public sealed class ModerationStats
 {
    public int OpenReports { get; set; }
    public int ActiveIpBans { get; set; }
 }
@@ -1,23 +0,0 @@
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 namespace DorkNet.AdminMobile.Pages;
 public sealed class AdminTabbedPage : TabbedPage
 {
    public AdminTabbedPage(
        DashboardPage dashboard,
        PlayersPage players,
        RoomsPage rooms,
        SettingsPage settings)
    {
        BarBackgroundColor = AppDesign.Canvas;
        BarTextColor = AppDesign.Text;
        SelectedTabColor = AppDesign.PlatformAccent;
        UnselectedTabColor = AppDesign.Subtle;
        Children.Add(dashboard);
        Children.Add(players);
        Children.Add(rooms);
        Children.Add(settings);
    }
 }
@@ -1,91 +0,0 @@
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 using DorkNet.AdminMobile.Models;
 using DorkNet.AdminMobile.Services;
 namespace DorkNet.AdminMobile.Pages;
 public sealed class DashboardPage : ContentPage
 {
    private readonly AdminApiClient api;
    private readonly Label status = AppDesign.StatusLabel();
    private readonly Grid metrics = new() { ColumnSpacing = 10, RowSpacing = 10 };
    public DashboardPage(AdminApiClient api)
    {
        this.api = api;
        Title = "Dashboard";
        Background = AppDesign.PageBackground;
        var refresh = AppDesign.SecondaryButton("Refresh");
        refresh.Clicked += async (_, _) => await LoadAsync();
        Content = new ScrollView
        {
            Content = new VerticalStackLayout
            {
                Padding = 16,
                Spacing = 14,
                Children =
                {
                    AppDesign.Title("Operations"),
                    refresh,
                    metrics,
                    status,
                },
            },
        };
    }
    protected override async void OnAppearing()
    {
        base.OnAppearing();
        if (metrics.Children.Count == 0) await LoadAsync();
    }
    private async Task LoadAsync()
    {
        try
        {
            status.Text = "Loading...";
            var s = await api.GetStatsAsync();
            DrawMetrics(s);
            status.Text = $"Server time {s.ServerTime:g}";
        }
        catch (Exception ex)
        {
            status.Text = ex.Message;
        }
    }
    private void DrawMetrics(AdminStats s)
    {
        metrics.Children.Clear();
        metrics.RowDefinitions.Clear();
        metrics.ColumnDefinitions.Clear();
        metrics.ColumnDefinitions.Add(new ColumnDefinition());
        metrics.ColumnDefinitions.Add(new ColumnDefinition());
        AddMetric(0, 0, "Players", $"{s.Players.Total}", $"{s.Players.OnlineNow} online");
        AddMetric(0, 1, "Rooms", $"{s.Rooms.Total}", $"{s.Rooms.ActiveSessionCount} active sessions");
        AddMetric(1, 0, "Moderation", $"{s.Moderation.OpenReports}", "open reports");
        AddMetric(1, 1, "Traffic", $"{s.Rooms.InGamePlayerCount}", $"{s.Rooms.TotalVisits:n0} visits");
        AddMetric(2, 0, "New today", $"{s.Players.NewToday}", "players");
        AddMetric(2, 1, "Photos", $"{s.Photos.Today}", "last 24h");
    }
    private void AddMetric(int row, int col, string label, string value, string caption)
    {
        while (metrics.RowDefinitions.Count <= row) metrics.RowDefinitions.Add(new RowDefinition());
        var tile = AppDesign.GlassCard(new VerticalStackLayout
        {
            Spacing = 4,
            Children =
            {
                new Label { Text = label, TextColor = AppDesign.Subtle, FontSize = 12 },
                new Label { Text = value, TextColor = AppDesign.Text, FontSize = 28, FontAttributes = FontAttributes.Bold },
                new Label { Text = caption, TextColor = AppDesign.Muted, FontSize = 12 },
            },
        }, new Thickness(14));
        metrics.Add(tile, col, row);
    }
 }
@@ -1,137 +0,0 @@
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 using DorkNet.AdminMobile.Services;
 namespace DorkNet.AdminMobile.Pages;
 public sealed class LoginPage : ContentPage
 {
    private readonly AdminApiClient api;
    private readonly SecureAdminSettings settings;
    private readonly Entry baseUrl = AppDesign.Entry("https://admin.example.com", Keyboard.Url);
    private readonly Entry cfClientId = AppDesign.Entry("Cloudflare Access Client ID");
    private readonly Entry cfClientSecret = AppDesign.Entry("Cloudflare Access Client Secret", secret: true);
    private readonly Entry cfJwt = AppDesign.Entry("Cloudflare Access JWT assertion", secret: true);
    private readonly Entry username = AppDesign.Entry("Admin username");
    private readonly Entry password = AppDesign.Entry("Password", secret: true);
    private readonly Label status = AppDesign.StatusLabel();
    private readonly ActivityIndicator busy = new() { IsVisible = false };
    private bool loaded;
    public LoginPage(AdminApiClient api, SecureAdminSettings settings)
    {
        this.api = api;
        this.settings = settings;
        Title = "DorkNet Admin";
        Background = AppDesign.PageBackground;
        var login = AppDesign.PrimaryButton("Sign in");
        login.Clicked += OnLogin;
        var continueSaved = AppDesign.SecondaryButton("Continue saved session");
        continueSaved.Clicked += async (_, _) =>
        {
            if (await settings.GetJwtAsync() is { Length: > 0 }) App.ShowAdmin();
            else status.Text = "No saved DorkNet admin session is stored.";
        };
        Content = new ScrollView
        {
            Content = new VerticalStackLayout
            {
                Padding = new Thickness(20, 28),
                Spacing = 14,
                Children =
                {
                    new Image
                    {
                        Source = "dorknet.svg",
                        WidthRequest = 96,
                        HeightRequest = 96,
                        HorizontalOptions = LayoutOptions.Start,
                    },
                    AppDesign.Title("Admin mobile"),
                    new Label
                    {
                        Text = "Connect to a DorkNet admin host. Cloudflare Access service tokens are sent with every request when configured.",
                        TextColor = AppDesign.Muted,
                        FontSize = 14,
                    },
                    AppDesign.GlassCard(new VerticalStackLayout
                    {
                        Spacing = 10,
                        Children =
                        {
                            AppDesign.Section("Connection"),
                            baseUrl,
                            cfClientId,
                            cfClientSecret,
                            cfJwt,
                        },
                    }),
                    AppDesign.GlassCard(new VerticalStackLayout
                    {
                        Spacing = 10,
                        Children =
                        {
                            AppDesign.Section("DorkNet admin login"),
                            username,
                            password,
                            login,
                            continueSaved,
                        },
                    }),
                    busy,
                    status,
                },
            },
        };
    }
    protected override async void OnAppearing()
    {
        base.OnAppearing();
        if (loaded) return;
        loaded = true;
        try
        {
            var saved = await settings.LoadConnectionAsync();
            baseUrl.Text = saved.BaseUrl;
            cfClientId.Text = saved.CloudflareAccessClientId;
            cfClientSecret.Text = saved.CloudflareAccessClientSecret;
            cfJwt.Text = saved.CloudflareAccessJwt;
        }
        catch (Exception ex)
        {
            baseUrl.Text = "https://admin.rec.net";
            status.Text = $"Secure storage was reset: {ex.Message}";
        }
    }
    private async void OnLogin(object? sender, EventArgs e)
    {
        busy.IsVisible = true;
        busy.IsRunning = true;
        status.Text = string.Empty;
        try
        {
            await settings.SaveConnectionAsync(new AdminConnectionSettings(
                baseUrl.Text ?? string.Empty,
                cfClientId.Text ?? string.Empty,
                cfClientSecret.Text ?? string.Empty,
                cfJwt.Text ?? string.Empty));
            await api.LoginAsync(username.Text ?? string.Empty, password.Text ?? string.Empty);
            App.ShowAdmin();
        }
        catch (Exception ex)
        {
            status.Text = ex.Message;
        }
        finally
        {
            busy.IsRunning = false;
            busy.IsVisible = false;
        }
    }
 }
@@ -1,222 +0,0 @@
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 using DorkNet.AdminMobile.Models;
 using DorkNet.AdminMobile.Services;
 namespace DorkNet.AdminMobile.Pages;
 public sealed class PlayersPage : ContentPage
 {
    private readonly AdminApiClient api;
    private readonly Entry search = AppDesign.Entry("Search players");
    private readonly CollectionView list = new();
    private readonly Label status = AppDesign.StatusLabel();
    private readonly Button refresh = AppDesign.SecondaryButton("Refresh");
    private List<PlayerSummary> players = [];
    public PlayersPage(AdminApiClient api)
    {
        this.api = api;
        Title = "Players";
        Background = AppDesign.PageBackground;
        refresh.Clicked += async (_, _) => await LoadAsync();
        search.Completed += async (_, _) => await LoadAsync();
        list.SelectionMode = SelectionMode.Single;
        list.ItemSizingStrategy = ItemSizingStrategy.MeasureFirstItem;
        list.SelectionChanged += async (_, e) =>
        {
            if (e.CurrentSelection.FirstOrDefault() is PlayerSummary player)
            {
                list.SelectedItem = null;
                await PlayerActionsAsync(player);
            }
        };
        list.EmptyView = new Label
        {
            Text = "No players loaded",
            TextColor = AppDesign.Subtle,
            HorizontalTextAlignment = TextAlignment.Center,
            VerticalTextAlignment = TextAlignment.Center,
        };
        list.ItemTemplate = new DataTemplate(() =>
        {
            var name = new Label { TextColor = AppDesign.Text, FontAttributes = FontAttributes.Bold, FontSize = 16 };
            name.SetBinding(Label.TextProperty, nameof(PlayerSummary.DisplayName));
            var handle = new Label { TextColor = AppDesign.Muted, FontSize = 13 };
            handle.SetBinding(Label.TextProperty, new Binding(nameof(PlayerSummary.Username), stringFormat: "@{0}"));
            var detail = new Label { TextColor = AppDesign.Subtle, FontSize = 12 };
            detail.SetBinding(Label.TextProperty, new Binding(nameof(PlayerSummary.Level), stringFormat: "Level {0}"));
            var online = new Label { TextColor = AppDesign.AndroidAccent, FontSize = 12, FontAttributes = FontAttributes.Bold };
            online.SetBinding(Label.IsVisibleProperty, nameof(PlayerSummary.Online));
            online.Text = "ONLINE";
            var chevron = new Label
            {
                Text = ">",
                TextColor = AppDesign.Subtle,
                FontSize = 18,
                VerticalTextAlignment = TextAlignment.Center,
            };
            var row = new Grid
            {
                RowDefinitions =
                {
                    new RowDefinition { Height = GridLength.Auto },
                    new RowDefinition { Height = GridLength.Auto },
                    new RowDefinition { Height = GridLength.Auto },
                },
                ColumnDefinitions =
                {
                    new ColumnDefinition(),
                    new ColumnDefinition { Width = GridLength.Auto },
                    new ColumnDefinition { Width = GridLength.Auto },
                },
                Padding = new Thickness(12, 10),
                RowSpacing = 2,
                ColumnSpacing = 10,
                BackgroundColor = AppDesign.RowSurface,
            };
            row.Add(name, 0, 0);
            row.Add(online, 1, 0);
            row.Add(handle, 0, 1);
            row.Add(detail, 0, 2);
            row.Add(chevron, 2, 0);
            Grid.SetRowSpan(chevron, 3);
            return new VerticalStackLayout
            {
                Spacing = 0,
                Children = { row, AppDesign.Divider() },
            };
        });
        var searchRow = new Grid
        {
            ColumnSpacing = 8,
            ColumnDefinitions =
            {
                new ColumnDefinition(),
                new ColumnDefinition { Width = GridLength.Auto },
            },
        };
        searchRow.Add(search, 0, 0);
        searchRow.Add(refresh, 1, 0);
        var grid = new Grid
        {
            Padding = 16,
            RowSpacing = 12,
            RowDefinitions =
            {
                new RowDefinition { Height = GridLength.Auto },
                new RowDefinition { Height = GridLength.Auto },
                new RowDefinition(),
                new RowDefinition { Height = GridLength.Auto },
            },
        };
        grid.Add(AppDesign.Title("Players"), 0, 0);
        grid.Add(searchRow, 0, 1);
        grid.Add(list, 0, 2);
        grid.Add(status, 0, 3);
        Content = grid;
    }
    protected override async void OnAppearing()
    {
        base.OnAppearing();
        if (players.Count == 0) await LoadAsync();
    }
    private async Task LoadAsync()
    {
        try
        {
            refresh.IsEnabled = false;
            status.Text = "Loading...";
            players = await api.GetPlayersAsync(search.Text);
            list.ItemsSource = players;
            status.Text = $"{players.Count} players loaded";
        }
        catch (Exception ex)
        {
            status.Text = ex.Message;
        }
        finally
        {
            refresh.IsEnabled = true;
        }
    }
    private async Task PlayerActionsAsync(PlayerSummary player)
    {
        var action = await DisplayActionSheet(
            $"@{player.Username}",
            "Cancel",
            "Remove account",
            "Kick",
            "Reset avatar");
        switch (action)
        {
            case "Kick":
                await ConfirmAction($"Kick @{player.Username}?", () => api.KickPlayerAsync(player.Id, "Kicked from mobile admin."));
                break;
            case "Reset avatar":
                await ConfirmAction($"Reset @{player.Username}'s avatar?", () => api.ResetAvatarAsync(player.Id));
                break;
            case "Remove account":
                await RemoveAccountAsync(player);
                break;
        }
    }
    private async Task ConfirmAction(string message, Func<Task> action)
    {
        if (!await DisplayAlert("Confirm", message, "Run", "Cancel")) return;
        try
        {
            await action();
            await LoadAsync();
        }
        catch (Exception ex)
        {
            await DisplayAlert("Request failed", ex.Message, "OK");
        }
    }
    private async Task RemoveAccountAsync(PlayerSummary player)
    {
        var username = await DisplayPromptAsync(
            "Verify username",
            $"Type {player.Username} exactly to remove @{player.Username}.",
            "Next",
            "Cancel",
            maxLength: Math.Max(32, player.Username.Length),
            keyboard: Keyboard.Text);
        if (!string.Equals(username?.Trim(), player.Username, StringComparison.Ordinal)) return;
        var phrase = $"DELETE {player.Id}";
        var typedPhrase = await DisplayPromptAsync(
            "Verify removal",
            $"Type {phrase} exactly. This cannot be undone.",
            "Remove",
            "Cancel",
            maxLength: phrase.Length,
            keyboard: Keyboard.Text);
        if (!string.Equals(typedPhrase?.Trim(), phrase, StringComparison.Ordinal)) return;
        if (!await DisplayAlert("Remove account", $"Permanently remove @{player.Username}?", "Remove", "Cancel")) return;
        try
        {
            status.Text = $"Removing @{player.Username}...";
            await api.DeletePlayerAsync(player.Id, player.Username, phrase, "Removed from mobile admin.");
            await LoadAsync();
        }
        catch (Exception ex)
        {
            await DisplayAlert("Removal failed", ex.Message, "OK");
        }
    }
 }
@@ -1,129 +0,0 @@
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 using DorkNet.AdminMobile.Models;
 using DorkNet.AdminMobile.Services;
 namespace DorkNet.AdminMobile.Pages;
 public sealed class RoomsPage : ContentPage
 {
    private readonly AdminApiClient api;
    private readonly CollectionView rooms = new();
    private readonly CollectionView instances = new();
    private readonly Label status = AppDesign.StatusLabel();
    private readonly Button refresh = AppDesign.SecondaryButton("Refresh");
    private bool loaded;
    public RoomsPage(AdminApiClient api)
    {
        this.api = api;
        Title = "Rooms";
        Background = AppDesign.PageBackground;
        rooms.SelectionMode = SelectionMode.None;
        rooms.ItemSizingStrategy = ItemSizingStrategy.MeasureFirstItem;
        rooms.EmptyView = EmptyList("No recent rooms");
        rooms.ItemTemplate = new DataTemplate(() =>
        {
            var name = new Label { TextColor = AppDesign.Text, FontAttributes = FontAttributes.Bold, FontSize = 15 };
            name.SetBinding(Label.TextProperty, nameof(RoomSummary.Name));
            var meta = new Label { TextColor = AppDesign.Muted, FontSize = 12 };
            meta.SetBinding(Label.TextProperty, new Binding(nameof(RoomSummary.Id), stringFormat: "Room #{0}"));
            var row = new VerticalStackLayout
            {
                Padding = new Thickness(12, 9),
                Spacing = 2,
                BackgroundColor = AppDesign.RowSurface,
                Children = { name, meta },
            };
            return new VerticalStackLayout { Spacing = 0, Children = { row, AppDesign.Divider() } };
        });
        instances.SelectionMode = SelectionMode.None;
        instances.ItemSizingStrategy = ItemSizingStrategy.MeasureFirstItem;
        instances.EmptyView = EmptyList("No active instances");
        instances.ItemTemplate = new DataTemplate(() =>
        {
            var name = new Label { TextColor = AppDesign.Text, FontAttributes = FontAttributes.Bold, FontSize = 15 };
            name.SetBinding(Label.TextProperty, nameof(InstanceSummary.RoomName));
            var meta = new Label { TextColor = AppDesign.Muted, FontSize = 12 };
            meta.SetBinding(Label.TextProperty, new Binding(nameof(InstanceSummary.PhotonRegionId), stringFormat: "Region {0}"));
            var count = new Label { TextColor = AppDesign.Subtle, FontSize = 12 };
            count.SetBinding(Label.TextProperty, new Binding("Participants.Count", stringFormat: "{0} participants"));
            var row = new VerticalStackLayout
            {
                Padding = new Thickness(12, 9),
                Spacing = 2,
                BackgroundColor = AppDesign.RowSurface,
                Children = { name, meta, count },
            };
            return new VerticalStackLayout { Spacing = 0, Children = { row, AppDesign.Divider() } };
        });
        refresh.Clicked += async (_, _) => await LoadAsync();
        var grid = new Grid
        {
            Padding = 16,
            RowSpacing = 10,
            RowDefinitions =
            {
                new RowDefinition { Height = GridLength.Auto },
                new RowDefinition { Height = GridLength.Auto },
                new RowDefinition { Height = GridLength.Auto },
                new RowDefinition { Height = new GridLength(1, GridUnitType.Star) },
                new RowDefinition { Height = GridLength.Auto },
                new RowDefinition { Height = new GridLength(2, GridUnitType.Star) },
                new RowDefinition { Height = GridLength.Auto },
            },
        };
        grid.Add(AppDesign.Title("Rooms"), 0, 0);
        grid.Add(refresh, 0, 1);
        grid.Add(new Label { Text = "Live instances", TextColor = AppDesign.Muted, FontAttributes = FontAttributes.Bold }, 0, 2);
        grid.Add(instances, 0, 3);
        grid.Add(new Label { Text = "Recent rooms", TextColor = AppDesign.Muted, FontAttributes = FontAttributes.Bold }, 0, 4);
        grid.Add(rooms, 0, 5);
        grid.Add(status, 0, 6);
        Content = grid;
    }
    private static Label EmptyList(string text) => new()
    {
        Text = text,
        TextColor = AppDesign.Subtle,
        HorizontalTextAlignment = TextAlignment.Center,
        VerticalTextAlignment = TextAlignment.Center,
    };
    protected override async void OnAppearing()
    {
        base.OnAppearing();
        if (!loaded)
        {
            loaded = true;
            await LoadAsync();
        }
    }
    private async Task LoadAsync()
    {
        try
        {
            refresh.IsEnabled = false;
            status.Text = "Loading...";
            var instanceRows = await api.GetInstancesAsync();
            var roomRows = await api.GetRoomsAsync();
            instances.ItemsSource = instanceRows;
            rooms.ItemsSource = roomRows;
            status.Text = $"{instanceRows.Count} active instances, {roomRows.Count} rooms loaded";
        }
        catch (Exception ex)
        {
            status.Text = ex.Message;
        }
        finally
        {
            refresh.IsEnabled = true;
        }
    }
 }
@@ -1,119 +0,0 @@
 using Microsoft.Maui.Controls;
 using DorkNet.AdminMobile.Design;
 using DorkNet.AdminMobile.Services;
 namespace DorkNet.AdminMobile.Pages;
 public sealed class SettingsPage : ContentPage
 {
    private readonly AdminApiClient api;
    private readonly SecureAdminSettings settings;
    private readonly Switch signupsDisabled = new();
    private readonly Switch globalFriends = new();
    private readonly Label status = AppDesign.StatusLabel();
    private bool loading;
    public SettingsPage(AdminApiClient api, SecureAdminSettings settings)
    {
        this.api = api;
        this.settings = settings;
        Title = "Settings";
        Background = AppDesign.PageBackground;
        signupsDisabled.Toggled += async (_, e) =>
        {
            if (!loading) await SaveToggleAsync(() => api.SetSignupsDisabledAsync(e.Value));
        };
        globalFriends.Toggled += async (_, e) =>
        {
            if (!loading) await SaveToggleAsync(() => api.SetGlobalFriendsAsync(e.Value));
        };
        var refresh = AppDesign.SecondaryButton("Refresh");
        refresh.Clicked += async (_, _) => await LoadAsync();
        var logout = AppDesign.DangerButton("Clear saved session");
        logout.Clicked += (_, _) =>
        {
            settings.ClearSession();
            App.ShowLogin();
        };
        Content = new VerticalStackLayout
        {
            Padding = 16,
            Spacing = 14,
            Children =
            {
                AppDesign.Title("Settings"),
                refresh,
                Row("Disable new account creation", signupsDisabled),
                Row("Global friends mode", globalFriends),
                logout,
                status,
            },
        };
    }
    protected override async void OnAppearing()
    {
        base.OnAppearing();
        await LoadAsync();
    }
    private async Task LoadAsync()
    {
        try
        {
            loading = true;
            status.Text = "Loading...";
            var s = await api.GetSettingsAsync();
            signupsDisabled.IsToggled = s.SignupsDisabled;
            globalFriends.IsToggled = s.GlobalFriendsEnabled;
            status.Text = $"Updated {s.UpdatedAt:g}";
        }
        catch (Exception ex)
        {
            status.Text = ex.Message;
        }
        finally
        {
            loading = false;
        }
    }
    private async Task SaveToggleAsync(Func<Task> save)
    {
        try
        {
            status.Text = "Saving...";
            await save();
            status.Text = "Saved";
        }
        catch (Exception ex)
        {
            status.Text = ex.Message;
            await LoadAsync();
        }
    }
    private static View Row(string label, View control)
    {
        var grid = new Grid
        {
            ColumnDefinitions =
            {
                new ColumnDefinition(),
                new ColumnDefinition { Width = GridLength.Auto },
            },
            Padding = new Thickness(12, 10),
        };
        grid.Add(new Label
        {
            Text = label,
            TextColor = AppDesign.Text,
            VerticalTextAlignment = TextAlignment.Center,
        }, 0, 0);
        grid.Add(control, 1, 0);
        return AppDesign.GlassCard(grid, new Thickness(0));
    }
 }
@@ -1,11 +0,0 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <application
    android:allowBackup="false"
    android:icon="@mipmap/appicon"
    android:roundIcon="@mipmap/appicon_round"
    android:label="DorkNet Admin"
    android:supportsRtl="true" />
 </manifest>
@@ -1,23 +0,0 @@
 using Android.App;
 using Android.Content.PM;
 using Microsoft.Maui;
 namespace DorkNet.AdminMobile;
 [Activity(
    Label = "DorkNet Admin",
    Icon = "@mipmap/appicon",
    RoundIcon = "@mipmap/appicon_round",
    MainLauncher = true,
    Exported = true,
    Theme = "@style/Maui.SplashTheme",
    ConfigurationChanges =
        ConfigChanges.ScreenSize |
        ConfigChanges.Orientation |
        ConfigChanges.UiMode |
        ConfigChanges.ScreenLayout |
        ConfigChanges.SmallestScreenSize |
        ConfigChanges.Density)]
 public class MainActivity : MauiAppCompatActivity
 {
 }
@@ -1,13 +0,0 @@
 using Android.App;
 using Android.Runtime;
 using Microsoft.Maui;
 using Microsoft.Maui.Hosting;
 namespace DorkNet.AdminMobile;
 [Application]
 public class MainApplication(nint handle, JniHandleOwnership ownership)
    : MauiApplication(handle, ownership)
 {
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
 }
@@ -1,11 +0,0 @@
 using Foundation;
 using Microsoft.Maui;
 using Microsoft.Maui.Hosting;
 namespace DorkNet.AdminMobile;
 [Register("AppDelegate")]
 public class AppDelegate : MauiUIApplicationDelegate
 {
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
 }
@@ -1,37 +0,0 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
  <key>CFBundleDisplayName</key>
  <string>DorkNet Admin</string>
  <key>CFBundleIdentifier</key>
  <string>net.dorknet.adminmobile</string>
  <key>CFBundleVersion</key>
  <string>1</string>
  <key>CFBundleShortVersionString</key>
  <string>1.0</string>
  <key>LSRequiresIPhoneOS</key>
  <true/>
  <key>MinimumOSVersion</key>
  <string>14.2</string>
  <key>UIDeviceFamily</key>
  <array>
    <integer>1</integer>
    <integer>2</integer>
  </array>
  <key>UISupportedInterfaceOrientations</key>
  <array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
  </array>
  <key>UISupportedInterfaceOrientations~ipad</key>
  <array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationPortraitUpsideDown</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
  </array>
 </dict>
 </plist>
@@ -1,11 +0,0 @@
 using UIKit;
 namespace DorkNet.AdminMobile;
 public static class Program
 {
    public static void Main(string[] args)
    {
        UIApplication.Main(args, null, typeof(AppDelegate));
    }
 }
@@ -1,45 +0,0 @@
 # DorkNet Admin Mobile
 Native Android/iOS admin app for DorkNet, built with .NET MAUI.
 In the microservices deployment, point the app at the public admin host
 for the stack, usually `https://admin.<domain>`. Cloudflare and
 `DorkNet.Gateway` keep the public URL stable. Requests made through the
 admin host are handled by the `web` service's same-origin admin route;
 the `/api/admin/*` path family is also exposed by the moderation slice
 for non-admin-host routing.
 The browser admin page, route map, and troubleshooting flow are
 documented in [`../docs/admin.md`](../docs/admin.md).
 ## Authentication
 The app stores sensitive values in platform secure storage:
 - DorkNet admin JWT from `POST /api/admin/v1/login`
 - Cloudflare Access service-token client id
 - Cloudflare Access service-token client secret
 - Optional Cloudflare Access JWT assertion
 Every API request includes:
 ```http
 Authorization: Bearer <dorknet-admin-jwt>
 CF-Access-Client-Id: <service-token-client-id>
 CF-Access-Client-Secret: <service-token-client-secret>
 CF-Access-Jwt-Assertion: <optional-jwt>
 ```
 The Cloudflare headers are optional, but required when the admin host is behind Cloudflare Access.
 ## Build
 Install the .NET MAUI workloads, then build per platform:
 ```powershell
 dotnet workload install maui
 dotnet build DorkNet.AdminMobile\DorkNet.AdminMobile.csproj -f net9.0-android36.0
 dotnet build DorkNet.AdminMobile\DorkNet.AdminMobile.csproj -f net9.0-ios26.0
 ```
 The project targets Android 16 / API 36 and iOS 26 SDK. iOS device/archive builds still require Xcode 26 on macOS.
@@ -1,71 +0,0 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 <svg width="100%" height="100%" viewBox="0 0 1080 1080" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-miterlimit:10;">
    <rect id="Tavola-da-disegno1" serif:id="Tavola da disegno1" x="0" y="0" width="1080" height="1080" style="fill:none;"/>
    <g id="Tavola-da-disegno11" serif:id="Tavola da disegno1">
        <g transform="matrix(0.966367,-1.703882,1.703882,0.966367,-124.38412,723.826641)">
            <ellipse cx="249.71" cy="250.06" rx="121.23" ry="247.82" style="fill:rgb(200,243,255);"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/>
            <clipPath id="_clip2">
                <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip2)">
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M383.298,380.419C359.792,373.449 334.386,368.102 300.108,372.736C272.966,376.405 245.845,385.565 231.091,390.596L225.318,373.463C259.192,362.43 295.348,352.411 333.238,354.558C351.669,355.602 369.398,359.365 388.465,365.398C417.174,374.482 403.887,387.691 418.365,412.449C434.713,420.625 486.506,448.447 514.251,516.006C528.415,550.494 533.264,588.31 529.151,624.638C522.661,681.958 496.254,716.526 489.48,725.417L481.335,719.228C486.524,712.173 516.533,673.169 518.45,608.869C520.6,536.765 485.888,461.595 411.148,425.724C385.618,413.471 396.109,403.478 383.298,380.419Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M516.389,742.353L510.331,737.233C517.614,728.283 552.833,686.488 553.815,611.549C554.808,535.791 519.635,452.341 449.375,402.174C448.959,401.877 448.998,401.831 444.275,398.327L452.449,386.395C457.784,389.848 457.811,389.811 462.829,393.709C572.192,478.66 597.626,646.024 517.567,740.97L516.389,742.353Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-23.866246,-81.382925)">
                    <path d="M533.438,757.673L526.891,753.57C536.596,737.676 570.912,680.138 559.158,593.709C541.725,465.513 432.263,349.713 295.811,357.465L294.658,357.532L293.758,339.475C314.259,338.685 385.515,336.865 457.769,392.943C564.058,475.436 610.007,636.274 534.39,756.175C533.916,756.927 533.915,756.923 533.438,757.673Z" style="fill:rgb(11,149,199);"/>
                </g>
            </g>
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:url(#_Linear3);fill-rule:nonzero;"/>
            <clipPath id="_clip4">
                <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip4)">
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M719.298,286.117L719.472,302.116C714.034,302.198 680.645,301.87 647.172,333.748C618.509,361.044 599.916,402.886 602.893,445.447C605.339,480.414 612.06,542.816 672.087,560.368C704.064,569.718 738.525,562.673 746.775,561.646C798.125,555.255 863.977,582.481 844.976,672.066C826.557,758.904 708.786,793.434 604.896,734.778C603.991,734.267 603.996,734.265 603.094,733.751L611.06,719.875C619.352,724.604 666.616,752.472 726.054,747.259C776.183,742.862 819.57,715.532 829.427,668.257C846.074,588.41 787.093,574.077 752.204,577.157C744.709,577.819 735.843,579.959 719.66,580.846C610.634,586.829 593.432,503.624 588.863,467.303C588.402,463.633 586.629,448.059 586.581,437.107C586.387,392.666 606.6,349.614 637.435,320.939C674.957,286.046 712.599,286.218 719.298,286.117Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M889.582,670.145C886.387,692.654 874.229,756.889 799.538,791.868C768.431,806.436 738.412,810.153 727.3,811.484C726.145,801.395 716.291,796.674 726.378,795.483C798.043,787.023 862.555,749.781 873.868,667.055C880.827,616.172 906.947,635.6 944.161,600.212L954.792,612.169L889.582,670.145Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.48417,0,0,0.48417,290.849928,159.731518)">
                    <path d="M-30.174,347.361C-30.091,347.362 -16.814,346.654 -7.19,358.034C5.418,372.943 0.646,395.741 -16.795,404.414C-33.634,412.787 -53.997,403.726 -59.125,385.688C-64.446,366.968 -50.777,348.122 -31.331,347.382C-31.239,347.379 -31.239,347.381 -30.174,347.361ZM-30.173,366.335C-30.269,366.339 -30.366,366.341 -30.465,366.344C-38.677,366.537 -44.049,375.524 -39.822,382.976C-35.513,390.572 -24.064,390.508 -20.093,382.142C-16.849,375.307 -21.5,366.447 -30.173,366.34C-30.173,366.338 -30.173,366.337 -30.173,366.335ZM-30.173,366.34C-30.173,366.36 -30.254,366.339 -30.234,366.34C-30.214,366.34 -30.193,366.34 -30.173,366.34Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.409654,0,0,0.409654,348.629981,229.899333)">
                    <path d="M-30.174,346.881C-30.091,346.882 -16.6,346.163 -6.823,357.724C6.389,373.348 0.742,397.3 -17.929,405.473C-36.437,413.575 -57.656,401.68 -60.452,381.718C-61.661,373.092 -59.166,364.231 -53.287,357.446C-43.552,346.209 -30.382,346.885 -30.174,346.881ZM-30.179,348.606C-30.272,365.541 -31.682,366.793 -30.237,366.819C-30.24,366.819 -30.241,366.82 -30.239,366.821C-40.09,366.999 -44.296,378.834 -37.414,385.24C-30.923,391.283 -20.188,387.144 -19.561,378.146C-19.192,372.846 -23.119,366.95 -30.173,366.82C-30.144,357.461 -30.198,356.892 -30.179,348.606ZM-30.173,366.82C-30.173,366.837 -30.23,366.826 -30.239,366.821C-30.218,366.821 -30.197,366.82 -30.176,366.82C-30.175,366.82 -30.174,366.82 -30.173,366.82Z" style="fill:rgb(51,235,255);"/>
                </g>
            </g>
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M125.81,223.01L161.59,281.96L234.69,250.76L228.53,178.91" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M250.31,171.25L297.85,221.85L363.95,190.85L351.12,130.21" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M76.64,234.99L78.95,211.91L122.32,223.62L133.9,209.26L204.54,179.63L228.56,179.91L250.31,171.25L264.34,155.33L331.44,124.3L347.49,125.82L335.99,92.65" style="fill:none;fill-rule:nonzero;stroke:rgb(26,26,26);stroke-width:13px;"/>
        </g>
        <g transform="matrix(1,0,0,1,237.128515,-26.039343)">
            <path d="M-30.174,346.85C-30.091,346.852 -16.587,346.132 -6.8,357.704C5.921,372.747 1.262,395.736 -16.236,404.704C-32.978,413.284 -53.484,404.767 -59.286,386.911C-65.4,368.095 -52.217,348.44 -32.518,346.939C-31.347,346.85 -31.349,346.872 -30.174,346.85ZM-30.174,366.848C-30.745,366.832 -35.068,366.825 -38.277,370.619C-43.539,376.841 -40.028,386.366 -32.189,387.87C-23.778,389.483 -17.066,380.949 -20.45,373.218C-21.243,371.406 -22.544,369.843 -24.151,368.729C-26.865,366.847 -29.534,366.855 -30.174,366.85L-30.112,366.85C-30.116,366.85 -30.137,366.849 -30.174,366.848Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.868104,0,0,0.868104,340.346177,-48.424243)">
            <path d="M-30.174,346.515C-30.091,346.517 -16.438,345.789 -6.544,357.488C6.621,373.056 1.318,396.894 -17.096,405.497C-35.045,413.883 -56.201,403.351 -60.405,384.057C-64.507,365.238 -50.552,347.268 -31.363,346.538C-31.268,346.534 -31.269,346.536 -30.174,346.515ZM-30.175,356.504L-30.176,367.186C-30.197,367.185 -30.218,367.185 -30.239,367.185C-30.243,367.185 -30.243,367.186 -30.241,367.187C-39.761,367.366 -43.804,378.792 -37.165,384.972C-30.855,390.847 -20.418,386.751 -19.918,377.991C-19.631,372.952 -23.381,367.313 -30.173,367.186C-30.156,361.786 -30.166,359.208 -30.175,356.504ZM-30.173,367.186C-30.173,367.204 -30.232,367.191 -30.241,367.187C-30.219,367.186 -30.198,367.186 -30.176,367.186C-30.175,367.186 -30.174,367.186 -30.173,367.186Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.736248,0,0,0.736248,483.945338,73.515167)">
            <path d="M-30.174,345.984C-30.091,345.986 -16.202,345.245 -6.139,357.145C7.565,373.35 1.541,398.208 -17.922,406.446C-37.518,414.741 -59.637,401.448 -61.521,380.263C-62.303,371.462 -59.382,362.805 -53.465,356.295C-43.544,345.381 -30.619,345.993 -30.174,345.984ZM-30.175,356.435L-30.176,367.717C-30.198,367.716 -30.22,367.716 -30.242,367.716C-30.246,367.716 -30.247,367.717 -30.245,367.718C-39.336,367.901 -43.117,378.846 -36.717,384.664C-30.745,390.092 -21.176,386.235 -20.475,378.338C-20.018,373.2 -23.745,367.842 -30.173,367.717C-30.155,362.006 -30.166,359.296 -30.175,356.435ZM-30.173,367.717C-30.173,367.735 -30.235,367.723 -30.245,367.718C-30.222,367.717 -30.199,367.717 -30.176,367.717C-30.175,367.717 -30.173,367.717 -30.173,367.717Z" style="fill:rgb(11,149,199);"/>
        </g>
    </g>
    <defs>
        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(97.382232,67.814092,-67.814092,97.382232,151.218217,203.626226)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
        <linearGradient id="_Linear3" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-3.53364,107.893491,-162.475262,-5.321257,318.003313,232.433991)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
    </defs>
 </svg>
@@ -1,71 +0,0 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 <svg width="100%" height="100%" viewBox="0 0 1080 1080" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-miterlimit:10;">
    <rect id="Tavola-da-disegno1" serif:id="Tavola da disegno1" x="0" y="0" width="1080" height="1080" style="fill:none;"/>
    <g id="Tavola-da-disegno11" serif:id="Tavola da disegno1">
        <g transform="matrix(0.966367,-1.703882,1.703882,0.966367,-124.38412,723.826641)">
            <ellipse cx="249.71" cy="250.06" rx="121.23" ry="247.82" style="fill:rgb(200,243,255);"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/>
            <clipPath id="_clip2">
                <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip2)">
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M383.298,380.419C359.792,373.449 334.386,368.102 300.108,372.736C272.966,376.405 245.845,385.565 231.091,390.596L225.318,373.463C259.192,362.43 295.348,352.411 333.238,354.558C351.669,355.602 369.398,359.365 388.465,365.398C417.174,374.482 403.887,387.691 418.365,412.449C434.713,420.625 486.506,448.447 514.251,516.006C528.415,550.494 533.264,588.31 529.151,624.638C522.661,681.958 496.254,716.526 489.48,725.417L481.335,719.228C486.524,712.173 516.533,673.169 518.45,608.869C520.6,536.765 485.888,461.595 411.148,425.724C385.618,413.471 396.109,403.478 383.298,380.419Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M516.389,742.353L510.331,737.233C517.614,728.283 552.833,686.488 553.815,611.549C554.808,535.791 519.635,452.341 449.375,402.174C448.959,401.877 448.998,401.831 444.275,398.327L452.449,386.395C457.784,389.848 457.811,389.811 462.829,393.709C572.192,478.66 597.626,646.024 517.567,740.97L516.389,742.353Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-23.866246,-81.382925)">
                    <path d="M533.438,757.673L526.891,753.57C536.596,737.676 570.912,680.138 559.158,593.709C541.725,465.513 432.263,349.713 295.811,357.465L294.658,357.532L293.758,339.475C314.259,338.685 385.515,336.865 457.769,392.943C564.058,475.436 610.007,636.274 534.39,756.175C533.916,756.927 533.915,756.923 533.438,757.673Z" style="fill:rgb(11,149,199);"/>
                </g>
            </g>
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:url(#_Linear3);fill-rule:nonzero;"/>
            <clipPath id="_clip4">
                <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip4)">
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M719.298,286.117L719.472,302.116C714.034,302.198 680.645,301.87 647.172,333.748C618.509,361.044 599.916,402.886 602.893,445.447C605.339,480.414 612.06,542.816 672.087,560.368C704.064,569.718 738.525,562.673 746.775,561.646C798.125,555.255 863.977,582.481 844.976,672.066C826.557,758.904 708.786,793.434 604.896,734.778C603.991,734.267 603.996,734.265 603.094,733.751L611.06,719.875C619.352,724.604 666.616,752.472 726.054,747.259C776.183,742.862 819.57,715.532 829.427,668.257C846.074,588.41 787.093,574.077 752.204,577.157C744.709,577.819 735.843,579.959 719.66,580.846C610.634,586.829 593.432,503.624 588.863,467.303C588.402,463.633 586.629,448.059 586.581,437.107C586.387,392.666 606.6,349.614 637.435,320.939C674.957,286.046 712.599,286.218 719.298,286.117Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M889.582,670.145C886.387,692.654 874.229,756.889 799.538,791.868C768.431,806.436 738.412,810.153 727.3,811.484C726.145,801.395 716.291,796.674 726.378,795.483C798.043,787.023 862.555,749.781 873.868,667.055C880.827,616.172 906.947,635.6 944.161,600.212L954.792,612.169L889.582,670.145Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.48417,0,0,0.48417,290.849928,159.731518)">
                    <path d="M-30.174,347.361C-30.091,347.362 -16.814,346.654 -7.19,358.034C5.418,372.943 0.646,395.741 -16.795,404.414C-33.634,412.787 -53.997,403.726 -59.125,385.688C-64.446,366.968 -50.777,348.122 -31.331,347.382C-31.239,347.379 -31.239,347.381 -30.174,347.361ZM-30.173,366.335C-30.269,366.339 -30.366,366.341 -30.465,366.344C-38.677,366.537 -44.049,375.524 -39.822,382.976C-35.513,390.572 -24.064,390.508 -20.093,382.142C-16.849,375.307 -21.5,366.447 -30.173,366.34C-30.173,366.338 -30.173,366.337 -30.173,366.335ZM-30.173,366.34C-30.173,366.36 -30.254,366.339 -30.234,366.34C-30.214,366.34 -30.193,366.34 -30.173,366.34Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.409654,0,0,0.409654,348.629981,229.899333)">
                    <path d="M-30.174,346.881C-30.091,346.882 -16.6,346.163 -6.823,357.724C6.389,373.348 0.742,397.3 -17.929,405.473C-36.437,413.575 -57.656,401.68 -60.452,381.718C-61.661,373.092 -59.166,364.231 -53.287,357.446C-43.552,346.209 -30.382,346.885 -30.174,346.881ZM-30.179,348.606C-30.272,365.541 -31.682,366.793 -30.237,366.819C-30.24,366.819 -30.241,366.82 -30.239,366.821C-40.09,366.999 -44.296,378.834 -37.414,385.24C-30.923,391.283 -20.188,387.144 -19.561,378.146C-19.192,372.846 -23.119,366.95 -30.173,366.82C-30.144,357.461 -30.198,356.892 -30.179,348.606ZM-30.173,366.82C-30.173,366.837 -30.23,366.826 -30.239,366.821C-30.218,366.821 -30.197,366.82 -30.176,366.82C-30.175,366.82 -30.174,366.82 -30.173,366.82Z" style="fill:rgb(51,235,255);"/>
                </g>
            </g>
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M125.81,223.01L161.59,281.96L234.69,250.76L228.53,178.91" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M250.31,171.25L297.85,221.85L363.95,190.85L351.12,130.21" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M76.64,234.99L78.95,211.91L122.32,223.62L133.9,209.26L204.54,179.63L228.56,179.91L250.31,171.25L264.34,155.33L331.44,124.3L347.49,125.82L335.99,92.65" style="fill:none;fill-rule:nonzero;stroke:rgb(26,26,26);stroke-width:13px;"/>
        </g>
        <g transform="matrix(1,0,0,1,237.128515,-26.039343)">
            <path d="M-30.174,346.85C-30.091,346.852 -16.587,346.132 -6.8,357.704C5.921,372.747 1.262,395.736 -16.236,404.704C-32.978,413.284 -53.484,404.767 -59.286,386.911C-65.4,368.095 -52.217,348.44 -32.518,346.939C-31.347,346.85 -31.349,346.872 -30.174,346.85ZM-30.174,366.848C-30.745,366.832 -35.068,366.825 -38.277,370.619C-43.539,376.841 -40.028,386.366 -32.189,387.87C-23.778,389.483 -17.066,380.949 -20.45,373.218C-21.243,371.406 -22.544,369.843 -24.151,368.729C-26.865,366.847 -29.534,366.855 -30.174,366.85L-30.112,366.85C-30.116,366.85 -30.137,366.849 -30.174,366.848Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.868104,0,0,0.868104,340.346177,-48.424243)">
            <path d="M-30.174,346.515C-30.091,346.517 -16.438,345.789 -6.544,357.488C6.621,373.056 1.318,396.894 -17.096,405.497C-35.045,413.883 -56.201,403.351 -60.405,384.057C-64.507,365.238 -50.552,347.268 -31.363,346.538C-31.268,346.534 -31.269,346.536 -30.174,346.515ZM-30.175,356.504L-30.176,367.186C-30.197,367.185 -30.218,367.185 -30.239,367.185C-30.243,367.185 -30.243,367.186 -30.241,367.187C-39.761,367.366 -43.804,378.792 -37.165,384.972C-30.855,390.847 -20.418,386.751 -19.918,377.991C-19.631,372.952 -23.381,367.313 -30.173,367.186C-30.156,361.786 -30.166,359.208 -30.175,356.504ZM-30.173,367.186C-30.173,367.204 -30.232,367.191 -30.241,367.187C-30.219,367.186 -30.198,367.186 -30.176,367.186C-30.175,367.186 -30.174,367.186 -30.173,367.186Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.736248,0,0,0.736248,483.945338,73.515167)">
            <path d="M-30.174,345.984C-30.091,345.986 -16.202,345.245 -6.139,357.145C7.565,373.35 1.541,398.208 -17.922,406.446C-37.518,414.741 -59.637,401.448 -61.521,380.263C-62.303,371.462 -59.382,362.805 -53.465,356.295C-43.544,345.381 -30.619,345.993 -30.174,345.984ZM-30.175,356.435L-30.176,367.717C-30.198,367.716 -30.22,367.716 -30.242,367.716C-30.246,367.716 -30.247,367.717 -30.245,367.718C-39.336,367.901 -43.117,378.846 -36.717,384.664C-30.745,390.092 -21.176,386.235 -20.475,378.338C-20.018,373.2 -23.745,367.842 -30.173,367.717C-30.155,362.006 -30.166,359.296 -30.175,356.435ZM-30.173,367.717C-30.173,367.735 -30.235,367.723 -30.245,367.718C-30.222,367.717 -30.199,367.717 -30.176,367.717C-30.175,367.717 -30.173,367.717 -30.173,367.717Z" style="fill:rgb(11,149,199);"/>
        </g>
    </g>
    <defs>
        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(97.382232,67.814092,-67.814092,97.382232,151.218217,203.626226)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
        <linearGradient id="_Linear3" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-3.53364,107.893491,-162.475262,-5.321257,318.003313,232.433991)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
    </defs>
 </svg>
@@ -1,71 +0,0 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 <svg width="100%" height="100%" viewBox="0 0 1080 1080" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-miterlimit:10;">
    <rect id="Tavola-da-disegno1" serif:id="Tavola da disegno1" x="0" y="0" width="1080" height="1080" style="fill:none;"/>
    <g id="Tavola-da-disegno11" serif:id="Tavola da disegno1">
        <g transform="matrix(0.966367,-1.703882,1.703882,0.966367,-124.38412,723.826641)">
            <ellipse cx="249.71" cy="250.06" rx="121.23" ry="247.82" style="fill:rgb(200,243,255);"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/>
            <clipPath id="_clip2">
                <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip2)">
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M383.298,380.419C359.792,373.449 334.386,368.102 300.108,372.736C272.966,376.405 245.845,385.565 231.091,390.596L225.318,373.463C259.192,362.43 295.348,352.411 333.238,354.558C351.669,355.602 369.398,359.365 388.465,365.398C417.174,374.482 403.887,387.691 418.365,412.449C434.713,420.625 486.506,448.447 514.251,516.006C528.415,550.494 533.264,588.31 529.151,624.638C522.661,681.958 496.254,716.526 489.48,725.417L481.335,719.228C486.524,712.173 516.533,673.169 518.45,608.869C520.6,536.765 485.888,461.595 411.148,425.724C385.618,413.471 396.109,403.478 383.298,380.419Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M516.389,742.353L510.331,737.233C517.614,728.283 552.833,686.488 553.815,611.549C554.808,535.791 519.635,452.341 449.375,402.174C448.959,401.877 448.998,401.831 444.275,398.327L452.449,386.395C457.784,389.848 457.811,389.811 462.829,393.709C572.192,478.66 597.626,646.024 517.567,740.97L516.389,742.353Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-23.866246,-81.382925)">
                    <path d="M533.438,757.673L526.891,753.57C536.596,737.676 570.912,680.138 559.158,593.709C541.725,465.513 432.263,349.713 295.811,357.465L294.658,357.532L293.758,339.475C314.259,338.685 385.515,336.865 457.769,392.943C564.058,475.436 610.007,636.274 534.39,756.175C533.916,756.927 533.915,756.923 533.438,757.673Z" style="fill:rgb(11,149,199);"/>
                </g>
            </g>
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:url(#_Linear3);fill-rule:nonzero;"/>
            <clipPath id="_clip4">
                <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip4)">
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M719.298,286.117L719.472,302.116C714.034,302.198 680.645,301.87 647.172,333.748C618.509,361.044 599.916,402.886 602.893,445.447C605.339,480.414 612.06,542.816 672.087,560.368C704.064,569.718 738.525,562.673 746.775,561.646C798.125,555.255 863.977,582.481 844.976,672.066C826.557,758.904 708.786,793.434 604.896,734.778C603.991,734.267 603.996,734.265 603.094,733.751L611.06,719.875C619.352,724.604 666.616,752.472 726.054,747.259C776.183,742.862 819.57,715.532 829.427,668.257C846.074,588.41 787.093,574.077 752.204,577.157C744.709,577.819 735.843,579.959 719.66,580.846C610.634,586.829 593.432,503.624 588.863,467.303C588.402,463.633 586.629,448.059 586.581,437.107C586.387,392.666 606.6,349.614 637.435,320.939C674.957,286.046 712.599,286.218 719.298,286.117Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M889.582,670.145C886.387,692.654 874.229,756.889 799.538,791.868C768.431,806.436 738.412,810.153 727.3,811.484C726.145,801.395 716.291,796.674 726.378,795.483C798.043,787.023 862.555,749.781 873.868,667.055C880.827,616.172 906.947,635.6 944.161,600.212L954.792,612.169L889.582,670.145Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.48417,0,0,0.48417,290.849928,159.731518)">
                    <path d="M-30.174,347.361C-30.091,347.362 -16.814,346.654 -7.19,358.034C5.418,372.943 0.646,395.741 -16.795,404.414C-33.634,412.787 -53.997,403.726 -59.125,385.688C-64.446,366.968 -50.777,348.122 -31.331,347.382C-31.239,347.379 -31.239,347.381 -30.174,347.361ZM-30.173,366.335C-30.269,366.339 -30.366,366.341 -30.465,366.344C-38.677,366.537 -44.049,375.524 -39.822,382.976C-35.513,390.572 -24.064,390.508 -20.093,382.142C-16.849,375.307 -21.5,366.447 -30.173,366.34C-30.173,366.338 -30.173,366.337 -30.173,366.335ZM-30.173,366.34C-30.173,366.36 -30.254,366.339 -30.234,366.34C-30.214,366.34 -30.193,366.34 -30.173,366.34Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.409654,0,0,0.409654,348.629981,229.899333)">
                    <path d="M-30.174,346.881C-30.091,346.882 -16.6,346.163 -6.823,357.724C6.389,373.348 0.742,397.3 -17.929,405.473C-36.437,413.575 -57.656,401.68 -60.452,381.718C-61.661,373.092 -59.166,364.231 -53.287,357.446C-43.552,346.209 -30.382,346.885 -30.174,346.881ZM-30.179,348.606C-30.272,365.541 -31.682,366.793 -30.237,366.819C-30.24,366.819 -30.241,366.82 -30.239,366.821C-40.09,366.999 -44.296,378.834 -37.414,385.24C-30.923,391.283 -20.188,387.144 -19.561,378.146C-19.192,372.846 -23.119,366.95 -30.173,366.82C-30.144,357.461 -30.198,356.892 -30.179,348.606ZM-30.173,366.82C-30.173,366.837 -30.23,366.826 -30.239,366.821C-30.218,366.821 -30.197,366.82 -30.176,366.82C-30.175,366.82 -30.174,366.82 -30.173,366.82Z" style="fill:rgb(51,235,255);"/>
                </g>
            </g>
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M125.81,223.01L161.59,281.96L234.69,250.76L228.53,178.91" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M250.31,171.25L297.85,221.85L363.95,190.85L351.12,130.21" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M76.64,234.99L78.95,211.91L122.32,223.62L133.9,209.26L204.54,179.63L228.56,179.91L250.31,171.25L264.34,155.33L331.44,124.3L347.49,125.82L335.99,92.65" style="fill:none;fill-rule:nonzero;stroke:rgb(26,26,26);stroke-width:13px;"/>
        </g>
        <g transform="matrix(1,0,0,1,237.128515,-26.039343)">
            <path d="M-30.174,346.85C-30.091,346.852 -16.587,346.132 -6.8,357.704C5.921,372.747 1.262,395.736 -16.236,404.704C-32.978,413.284 -53.484,404.767 -59.286,386.911C-65.4,368.095 -52.217,348.44 -32.518,346.939C-31.347,346.85 -31.349,346.872 -30.174,346.85ZM-30.174,366.848C-30.745,366.832 -35.068,366.825 -38.277,370.619C-43.539,376.841 -40.028,386.366 -32.189,387.87C-23.778,389.483 -17.066,380.949 -20.45,373.218C-21.243,371.406 -22.544,369.843 -24.151,368.729C-26.865,366.847 -29.534,366.855 -30.174,366.85L-30.112,366.85C-30.116,366.85 -30.137,366.849 -30.174,366.848Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.868104,0,0,0.868104,340.346177,-48.424243)">
            <path d="M-30.174,346.515C-30.091,346.517 -16.438,345.789 -6.544,357.488C6.621,373.056 1.318,396.894 -17.096,405.497C-35.045,413.883 -56.201,403.351 -60.405,384.057C-64.507,365.238 -50.552,347.268 -31.363,346.538C-31.268,346.534 -31.269,346.536 -30.174,346.515ZM-30.175,356.504L-30.176,367.186C-30.197,367.185 -30.218,367.185 -30.239,367.185C-30.243,367.185 -30.243,367.186 -30.241,367.187C-39.761,367.366 -43.804,378.792 -37.165,384.972C-30.855,390.847 -20.418,386.751 -19.918,377.991C-19.631,372.952 -23.381,367.313 -30.173,367.186C-30.156,361.786 -30.166,359.208 -30.175,356.504ZM-30.173,367.186C-30.173,367.204 -30.232,367.191 -30.241,367.187C-30.219,367.186 -30.198,367.186 -30.176,367.186C-30.175,367.186 -30.174,367.186 -30.173,367.186Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.736248,0,0,0.736248,483.945338,73.515167)">
            <path d="M-30.174,345.984C-30.091,345.986 -16.202,345.245 -6.139,357.145C7.565,373.35 1.541,398.208 -17.922,406.446C-37.518,414.741 -59.637,401.448 -61.521,380.263C-62.303,371.462 -59.382,362.805 -53.465,356.295C-43.544,345.381 -30.619,345.993 -30.174,345.984ZM-30.175,356.435L-30.176,367.717C-30.198,367.716 -30.22,367.716 -30.242,367.716C-30.246,367.716 -30.247,367.717 -30.245,367.718C-39.336,367.901 -43.117,378.846 -36.717,384.664C-30.745,390.092 -21.176,386.235 -20.475,378.338C-20.018,373.2 -23.745,367.842 -30.173,367.717C-30.155,362.006 -30.166,359.296 -30.175,356.435ZM-30.173,367.717C-30.173,367.735 -30.235,367.723 -30.245,367.718C-30.222,367.717 -30.199,367.717 -30.176,367.717C-30.175,367.717 -30.173,367.717 -30.173,367.717Z" style="fill:rgb(11,149,199);"/>
        </g>
    </g>
    <defs>
        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(97.382232,67.814092,-67.814092,97.382232,151.218217,203.626226)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
        <linearGradient id="_Linear3" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-3.53364,107.893491,-162.475262,-5.321257,318.003313,232.433991)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
    </defs>
 </svg>
@@ -1,71 +0,0 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 <svg width="100%" height="100%" viewBox="0 0 1080 1080" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-miterlimit:10;">
    <rect id="Tavola-da-disegno1" serif:id="Tavola da disegno1" x="0" y="0" width="1080" height="1080" style="fill:none;"/>
    <g id="Tavola-da-disegno11" serif:id="Tavola da disegno1">
        <g transform="matrix(0.966367,-1.703882,1.703882,0.966367,-124.38412,723.826641)">
            <ellipse cx="249.71" cy="250.06" rx="121.23" ry="247.82" style="fill:rgb(200,243,255);"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/>
            <clipPath id="_clip2">
                <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip2)">
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M383.298,380.419C359.792,373.449 334.386,368.102 300.108,372.736C272.966,376.405 245.845,385.565 231.091,390.596L225.318,373.463C259.192,362.43 295.348,352.411 333.238,354.558C351.669,355.602 369.398,359.365 388.465,365.398C417.174,374.482 403.887,387.691 418.365,412.449C434.713,420.625 486.506,448.447 514.251,516.006C528.415,550.494 533.264,588.31 529.151,624.638C522.661,681.958 496.254,716.526 489.48,725.417L481.335,719.228C486.524,712.173 516.533,673.169 518.45,608.869C520.6,536.765 485.888,461.595 411.148,425.724C385.618,413.471 396.109,403.478 383.298,380.419Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-40.206636,-65.042535)">
                    <path d="M516.389,742.353L510.331,737.233C517.614,728.283 552.833,686.488 553.815,611.549C554.808,535.791 519.635,452.341 449.375,402.174C448.959,401.877 448.998,401.831 444.275,398.327L452.449,386.395C457.784,389.848 457.811,389.811 462.829,393.709C572.192,478.66 597.626,646.024 517.567,740.97L516.389,742.353Z" style="fill:rgb(11,149,199);"/>
                </g>
                <g transform="matrix(0.564731,0,0,0.564731,-23.866246,-81.382925)">
                    <path d="M533.438,757.673L526.891,753.57C536.596,737.676 570.912,680.138 559.158,593.709C541.725,465.513 432.263,349.713 295.811,357.465L294.658,357.532L293.758,339.475C314.259,338.685 385.515,336.865 457.769,392.943C564.058,475.436 610.007,636.274 534.39,756.175C533.916,756.927 533.915,756.923 533.438,757.673Z" style="fill:rgb(11,149,199);"/>
                </g>
            </g>
            <path d="M308.29,210.37C279.19,136 183.21,43 29.77,130.68L55.77,195.93C63.327,191.377 71.22,187.406 79.38,184.05L140.38,362.51C128.31,362.68 100.64,360.65 90.49,351.96C79.2,342.3 114.81,394.52 200.79,393.67C299.75,392.7 340.79,293.43 308.29,210.37ZM197.28,345.34L149.71,171.16C179.29,173.83 209.71,189.16 230.89,231.7C259.4,289 231.81,325.79 197.28,345.34Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,53.870869,50.218665)">
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:url(#_Linear3);fill-rule:nonzero;"/>
            <clipPath id="_clip4">
                <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" clip-rule="nonzero"/>
            </clipPath>
            <g clip-path="url(#_clip4)">
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M719.298,286.117L719.472,302.116C714.034,302.198 680.645,301.87 647.172,333.748C618.509,361.044 599.916,402.886 602.893,445.447C605.339,480.414 612.06,542.816 672.087,560.368C704.064,569.718 738.525,562.673 746.775,561.646C798.125,555.255 863.977,582.481 844.976,672.066C826.557,758.904 708.786,793.434 604.896,734.778C603.991,734.267 603.996,734.265 603.094,733.751L611.06,719.875C619.352,724.604 666.616,752.472 726.054,747.259C776.183,742.862 819.57,715.532 829.427,668.257C846.074,588.41 787.093,574.077 752.204,577.157C744.709,577.819 735.843,579.959 719.66,580.846C610.634,586.829 593.432,503.624 588.863,467.303C588.402,463.633 586.629,448.059 586.581,437.107C586.387,392.666 606.6,349.614 637.435,320.939C674.957,286.046 712.599,286.218 719.298,286.117Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.510505,0,0,0.510505,-25.969815,-25.636862)">
                    <path d="M889.582,670.145C886.387,692.654 874.229,756.889 799.538,791.868C768.431,806.436 738.412,810.153 727.3,811.484C726.145,801.395 716.291,796.674 726.378,795.483C798.043,787.023 862.555,749.781 873.868,667.055C880.827,616.172 906.947,635.6 944.161,600.212L954.792,612.169L889.582,670.145Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.48417,0,0,0.48417,290.849928,159.731518)">
                    <path d="M-30.174,347.361C-30.091,347.362 -16.814,346.654 -7.19,358.034C5.418,372.943 0.646,395.741 -16.795,404.414C-33.634,412.787 -53.997,403.726 -59.125,385.688C-64.446,366.968 -50.777,348.122 -31.331,347.382C-31.239,347.379 -31.239,347.381 -30.174,347.361ZM-30.173,366.335C-30.269,366.339 -30.366,366.341 -30.465,366.344C-38.677,366.537 -44.049,375.524 -39.822,382.976C-35.513,390.572 -24.064,390.508 -20.093,382.142C-16.849,375.307 -21.5,366.447 -30.173,366.34C-30.173,366.338 -30.173,366.337 -30.173,366.335ZM-30.173,366.34C-30.173,366.36 -30.254,366.339 -30.234,366.34C-30.214,366.34 -30.193,366.34 -30.173,366.34Z" style="fill:rgb(51,235,255);"/>
                </g>
                <g transform="matrix(0.409654,0,0,0.409654,348.629981,229.899333)">
                    <path d="M-30.174,346.881C-30.091,346.882 -16.6,346.163 -6.823,357.724C6.389,373.348 0.742,397.3 -17.929,405.473C-36.437,413.575 -57.656,401.68 -60.452,381.718C-61.661,373.092 -59.166,364.231 -53.287,357.446C-43.552,346.209 -30.382,346.885 -30.174,346.881ZM-30.179,348.606C-30.272,365.541 -31.682,366.793 -30.237,366.819C-30.24,366.819 -30.241,366.82 -30.239,366.821C-40.09,366.999 -44.296,378.834 -37.414,385.24C-30.923,391.283 -20.188,387.144 -19.561,378.146C-19.192,372.846 -23.119,366.95 -30.173,366.82C-30.144,357.461 -30.198,356.892 -30.179,348.606ZM-30.173,366.82C-30.173,366.837 -30.23,366.826 -30.239,366.821C-30.218,366.821 -30.197,366.82 -30.176,366.82C-30.175,366.82 -30.174,366.82 -30.173,366.82Z" style="fill:rgb(51,235,255);"/>
                </g>
            </g>
            <path d="M392.19,205.85L452.51,182C452.51,182 439.38,111.36 360.12,103.73C280.86,96.1 255,167.94 254.8,195C254.6,222.06 267.09,299.93 339.53,284.5C372.33,277.5 385.19,290.19 383.29,309.2C380.98,332.28 336.11,370.64 268.29,309.65L237,336.56C237,336.56 262,403.62 334.06,403.68C399.06,403.73 457.8,364.68 446.68,289.25C441.03,250.9 407.51,217.39 357.62,221.89C300.62,227.03 323.13,172.89 355.12,171.94C394.19,170.77 392.19,205.85 392.19,205.85Z" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:5px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M125.81,223.01L161.59,281.96L234.69,250.76L228.53,178.91" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M250.31,171.25L297.85,221.85L363.95,190.85L351.12,130.21" style="fill:none;fill-rule:nonzero;stroke:rgb(125,132,143);stroke-width:9px;"/>
        </g>
        <g transform="matrix(1.958846,0,0,1.958846,104.702924,223.752836)">
            <path d="M76.64,234.99L78.95,211.91L122.32,223.62L133.9,209.26L204.54,179.63L228.56,179.91L250.31,171.25L264.34,155.33L331.44,124.3L347.49,125.82L335.99,92.65" style="fill:none;fill-rule:nonzero;stroke:rgb(26,26,26);stroke-width:13px;"/>
        </g>
        <g transform="matrix(1,0,0,1,237.128515,-26.039343)">
            <path d="M-30.174,346.85C-30.091,346.852 -16.587,346.132 -6.8,357.704C5.921,372.747 1.262,395.736 -16.236,404.704C-32.978,413.284 -53.484,404.767 -59.286,386.911C-65.4,368.095 -52.217,348.44 -32.518,346.939C-31.347,346.85 -31.349,346.872 -30.174,346.85ZM-30.174,366.848C-30.745,366.832 -35.068,366.825 -38.277,370.619C-43.539,376.841 -40.028,386.366 -32.189,387.87C-23.778,389.483 -17.066,380.949 -20.45,373.218C-21.243,371.406 -22.544,369.843 -24.151,368.729C-26.865,366.847 -29.534,366.855 -30.174,366.85L-30.112,366.85C-30.116,366.85 -30.137,366.849 -30.174,366.848Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.868104,0,0,0.868104,340.346177,-48.424243)">
            <path d="M-30.174,346.515C-30.091,346.517 -16.438,345.789 -6.544,357.488C6.621,373.056 1.318,396.894 -17.096,405.497C-35.045,413.883 -56.201,403.351 -60.405,384.057C-64.507,365.238 -50.552,347.268 -31.363,346.538C-31.268,346.534 -31.269,346.536 -30.174,346.515ZM-30.175,356.504L-30.176,367.186C-30.197,367.185 -30.218,367.185 -30.239,367.185C-30.243,367.185 -30.243,367.186 -30.241,367.187C-39.761,367.366 -43.804,378.792 -37.165,384.972C-30.855,390.847 -20.418,386.751 -19.918,377.991C-19.631,372.952 -23.381,367.313 -30.173,367.186C-30.156,361.786 -30.166,359.208 -30.175,356.504ZM-30.173,367.186C-30.173,367.204 -30.232,367.191 -30.241,367.187C-30.219,367.186 -30.198,367.186 -30.176,367.186C-30.175,367.186 -30.174,367.186 -30.173,367.186Z" style="fill:rgb(11,149,199);"/>
        </g>
        <g transform="matrix(0.736248,0,0,0.736248,483.945338,73.515167)">
            <path d="M-30.174,345.984C-30.091,345.986 -16.202,345.245 -6.139,357.145C7.565,373.35 1.541,398.208 -17.922,406.446C-37.518,414.741 -59.637,401.448 -61.521,380.263C-62.303,371.462 -59.382,362.805 -53.465,356.295C-43.544,345.381 -30.619,345.993 -30.174,345.984ZM-30.175,356.435L-30.176,367.717C-30.198,367.716 -30.22,367.716 -30.242,367.716C-30.246,367.716 -30.247,367.717 -30.245,367.718C-39.336,367.901 -43.117,378.846 -36.717,384.664C-30.745,390.092 -21.176,386.235 -20.475,378.338C-20.018,373.2 -23.745,367.842 -30.173,367.717C-30.155,362.006 -30.166,359.296 -30.175,356.435ZM-30.173,367.717C-30.173,367.735 -30.235,367.723 -30.245,367.718C-30.222,367.717 -30.199,367.717 -30.176,367.717C-30.175,367.717 -30.173,367.717 -30.173,367.717Z" style="fill:rgb(11,149,199);"/>
        </g>
    </g>
    <defs>
        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(97.382232,67.814092,-67.814092,97.382232,151.218217,203.626226)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
        <linearGradient id="_Linear3" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-3.53364,107.893491,-162.475262,-5.321257,318.003313,232.433991)"><stop offset="0" style="stop-color:rgb(51,235,255);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(11,149,199);stop-opacity:1"/></linearGradient>
    </defs>
 </svg>
@@ -1,147 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 using DorkNet.AdminMobile.Models;
 namespace DorkNet.AdminMobile.Services;
 public sealed class AdminApiClient(SecureAdminSettings settings)
 {
    private static readonly JsonSerializerOptions Json = new()
    {
        PropertyNameCaseInsensitive = true,
    };
    private readonly HttpClient http = new()
    {
        Timeout = TimeSpan.FromSeconds(20),
    };
    public async Task<AdminLoginResponse> LoginAsync(string username, string password)
    {
        var result = await SendAsync<AdminLoginResponse>(
            HttpMethod.Post,
            "login",
            new { Username = username, Password = password },
            includeJwt: false);
        await settings.SaveSessionAsync(result.AccessToken, result.RefreshToken);
        return result;
    }
    public Task<AdminStats> GetStatsAsync() =>
        SendAsync<AdminStats>(HttpMethod.Get, "stats");
    public Task<List<PlayerSummary>> GetPlayersAsync(string? query = null)
    {
        var suffix = string.IsNullOrWhiteSpace(query)
            ? "players?take=100"
            : $"players?take=100&query={Uri.EscapeDataString(query)}";
        return SendAsync<List<PlayerSummary>>(HttpMethod.Get, suffix);
    }
    public Task<List<RoomSummary>> GetRoomsAsync() =>
        SendAsync<List<RoomSummary>>(HttpMethod.Get, "rooms?take=100");
    public Task<List<InstanceSummary>> GetInstancesAsync() =>
        SendAsync<List<InstanceSummary>>(HttpMethod.Get, "instances");
    public Task<ServerSettingsDto> GetSettingsAsync() =>
        SendAsync<ServerSettingsDto>(HttpMethod.Get, "settings");
    public Task<ServerSettingsDto> SetSignupsDisabledAsync(bool disabled) =>
        SendAsync<ServerSettingsDto>(HttpMethod.Post, "settings/signups", new { Disabled = disabled });
    public Task<ServerSettingsDto> SetGlobalFriendsAsync(bool enabled) =>
        SendAsync<ServerSettingsDto>(HttpMethod.Post, "settings/global-friends", new { Enabled = enabled });
    public Task KickPlayerAsync(long playerId, string reason) =>
        SendAsync<object>(HttpMethod.Post, $"players/{playerId}/kick", new { Reason = reason });
    public Task ResetAvatarAsync(long playerId) =>
        SendAsync<object>(HttpMethod.Post, $"players/{playerId}/avatar/reset");
    public Task DeletePlayerAsync(long playerId, string username, string phrase, string? reason) =>
        SendAsync<object>(
            HttpMethod.Delete,
            $"players/{playerId}",
            new { ConfirmUsername = username, ConfirmPhrase = phrase, Reason = reason });
    private async Task<T> SendAsync<T>(
        HttpMethod method,
        string path,
        object? body = null,
        bool includeJwt = true)
    {
        var connection = await settings.LoadConnectionAsync();
        var url = $"{connection.BaseUrl.TrimEnd('/')}/api/admin/v1/{path.TrimStart('/')}";
        using var request = new HttpRequestMessage(method, url);
        AddCloudflareAccessHeaders(request, connection);
        if (includeJwt)
        {
            var jwt = await settings.GetJwtAsync();
            if (!string.IsNullOrWhiteSpace(jwt))
                request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", jwt);
        }
        if (body is not null)
        {
            var json = JsonSerializer.Serialize(body, Json);
            request.Content = new StringContent(json, Encoding.UTF8, "application/json");
        }
        using var response = await http.SendAsync(request);
        var text = await response.Content.ReadAsStringAsync();
        if (!response.IsSuccessStatusCode)
            throw new AdminApiException((int)response.StatusCode, ExtractError(text, response.ReasonPhrase));
        if (typeof(T) == typeof(object) || string.IsNullOrWhiteSpace(text))
            return default!;
        return JsonSerializer.Deserialize<T>(text, Json)
            ?? throw new AdminApiException(0, "Server returned an empty response.");
    }
    private static void AddCloudflareAccessHeaders(HttpRequestMessage request, AdminConnectionSettings connection)
    {
        if (!string.IsNullOrWhiteSpace(connection.CloudflareAccessClientId) &&
            !string.IsNullOrWhiteSpace(connection.CloudflareAccessClientSecret))
        {
            request.Headers.SetOrReplace("CF-Access-Client-Id", connection.CloudflareAccessClientId);
            request.Headers.SetOrReplace("CF-Access-Client-Secret", connection.CloudflareAccessClientSecret);
        }
        if (!string.IsNullOrWhiteSpace(connection.CloudflareAccessJwt))
            request.Headers.SetOrReplace("CF-Access-Jwt-Assertion", connection.CloudflareAccessJwt);
    }
    private static string ExtractError(string text, string? fallback)
    {
        if (string.IsNullOrWhiteSpace(text)) return fallback ?? "Request failed.";
        try
        {
            using var doc = JsonDocument.Parse(text);
            if (doc.RootElement.TryGetProperty("error", out var error))
                return error.GetString() ?? fallback ?? "Request failed.";
            if (doc.RootElement.TryGetProperty("message", out var message))
                return message.GetString() ?? fallback ?? "Request failed.";
        }
        catch { }
        return text.Length > 300 ? text[..300] : text;
    }
 }
 public sealed class AdminApiException(int statusCode, string message) : Exception(message)
 {
    public int StatusCode { get; } = statusCode;
 }
 internal static class HeaderExtensions
 {
    public static void SetOrReplace(this HttpRequestHeaders headers, string name, string value)
    {
        headers.Remove(name);
        headers.Add(name, value);
    }
 }
@@ -1,61 +0,0 @@
 using Microsoft.Maui.Storage;
 namespace DorkNet.AdminMobile.Services;
 public sealed record AdminConnectionSettings(
    string BaseUrl,
    string CloudflareAccessClientId,
    string CloudflareAccessClientSecret,
    string CloudflareAccessJwt);
 public sealed class SecureAdminSettings
 {
    private const string BaseUrlKey = "admin.baseUrl";
    private const string JwtKey = "admin.jwt";
    private const string RefreshKey = "admin.refresh";
    private const string CfClientIdKey = "cf.access.clientId";
    private const string CfClientSecretKey = "cf.access.clientSecret";
    private const string CfJwtKey = "cf.access.jwt";
    public async Task<AdminConnectionSettings> LoadConnectionAsync()
    {
        try
        {
            var baseUrl = await SecureStorage.GetAsync(BaseUrlKey) ?? "https://admin.rec.net";
            var cfId = await SecureStorage.GetAsync(CfClientIdKey) ?? string.Empty;
            var cfSecret = await SecureStorage.GetAsync(CfClientSecretKey) ?? string.Empty;
            var cfJwt = await SecureStorage.GetAsync(CfJwtKey) ?? string.Empty;
            return new AdminConnectionSettings(baseUrl, cfId, cfSecret, cfJwt);
        }
        catch
        {
            SecureStorage.Remove(BaseUrlKey);
            SecureStorage.Remove(CfClientIdKey);
            SecureStorage.Remove(CfClientSecretKey);
            SecureStorage.Remove(CfJwtKey);
            return new AdminConnectionSettings("https://admin.rec.net", string.Empty, string.Empty, string.Empty);
        }
    }
    public async Task SaveConnectionAsync(AdminConnectionSettings settings)
    {
        await SecureStorage.SetAsync(BaseUrlKey, settings.BaseUrl.TrimEnd('/'));
        await SecureStorage.SetAsync(CfClientIdKey, settings.CloudflareAccessClientId.Trim());
        await SecureStorage.SetAsync(CfClientSecretKey, settings.CloudflareAccessClientSecret.Trim());
        await SecureStorage.SetAsync(CfJwtKey, settings.CloudflareAccessJwt.Trim());
    }
    public Task<string?> GetJwtAsync() => SecureStorage.GetAsync(JwtKey);
    public async Task SaveSessionAsync(string accessToken, string refreshToken)
    {
        await SecureStorage.SetAsync(JwtKey, accessToken);
        await SecureStorage.SetAsync(RefreshKey, refreshToken);
    }
    public void ClearSession()
    {
        SecureStorage.Remove(JwtKey);
        SecureStorage.Remove(RefreshKey);
    }
 }
@@ -1,75 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework Condition="'$(TargetFramework)' == '' and '$(TargetFrameworks)' == ''">net6.0</TargetFramework>
    <LangVersion>latest</LangVersion>
    <Nullable>enable</Nullable>
    <RootNamespace>DorkNet.ClientMod</RootNamespace>
    <AssemblyName>DorkNet.ClientMod</AssemblyName>
    <AppendTargetFrameworkToOutputPath Condition="'$(TargetFrameworks)' == ''">false</AppendTargetFrameworkToOutputPath>
    <AppendTargetFrameworkToOutputPath Condition="'$(TargetFrameworks)' != ''">true</AppendTargetFrameworkToOutputPath>
    <CopyLocalLockFileAssemblies>false</CopyLocalLockFileAssemblies>
    <NoWarn>$(NoWarn);CS8602;CS8604;CS0436</NoWarn>
  </PropertyGroup>
  <!--
    MelonLoader 0.6.x build of the DorkNet client patches. Resolves
    every game-side type at runtime via AccessTools.TypeByName, so
    Rec Room's IL2CPP-derived interop assemblies (Assembly-CSharp,
    Photon3Unity3D, UnityEngine.*) are NOT needed at compile time —
    they would be derivative works of the game anyway, so we never
    reference them. Only MelonLoader's own DLLs are needed.
    By default the project downloads the pinned desktop MelonLoader release
    into DorkNet.ClientMod/build/ and references its net6 DLLs. For Quest /
    LemonLoader builds, pass:
      -p:TargetFrameworks=net8.0
      -p:MelonLoaderDir=<path-to-LemonLoader-melon_data/MelonLoader>
    The reference folder follows the target framework unless explicitly
    overridden with -p:MelonLoaderReferenceTfm=...
  -->
  <PropertyGroup>
    <MelonLoaderVersion Condition="'$(MelonLoaderVersion)' == ''">v0.6.6</MelonLoaderVersion>
    <MelonLoaderCacheRoot>$(MSBuildThisFileDirectory)build\melonloader</MelonLoaderCacheRoot>
    <MelonLoaderZip>$(MelonLoaderCacheRoot)\MelonLoader.x64.$(MelonLoaderVersion).zip</MelonLoaderZip>
    <MelonLoaderDir Condition="'$(MelonLoaderDir)' == ''">$(MelonLoaderCacheRoot)\MelonLoader</MelonLoaderDir>
    <MelonLoaderReferenceTfm Condition="'$(MelonLoaderReferenceTfm)' == '' and '$(TargetFramework)' == 'net8.0'">net8</MelonLoaderReferenceTfm>
    <MelonLoaderReferenceTfm Condition="'$(MelonLoaderReferenceTfm)' == ''">net6</MelonLoaderReferenceTfm>
  </PropertyGroup>
  <Target Name="EnsureMelonLoaderReferences"
          BeforeTargets="ResolveAssemblyReferences"
          Condition="'$(MelonLoaderReferenceTfm)' == 'net6' and !Exists('$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\MelonLoader.dll')">
    <MakeDir Directories="$(MelonLoaderCacheRoot)" />
    <DownloadFile
      SourceUrl="https://github.com/LavaGang/MelonLoader/releases/download/$(MelonLoaderVersion)/MelonLoader.x64.zip"
      DestinationFolder="$(MelonLoaderCacheRoot)"
      DestinationFileName="MelonLoader.x64.$(MelonLoaderVersion).zip"
      SkipUnchangedFiles="true" />
    <Unzip SourceFiles="$(MelonLoaderZip)"
           DestinationFolder="$(MelonLoaderCacheRoot)"
           OverwriteReadOnlyFiles="true" />
  </Target>
  <ItemGroup>
    <Reference Include="MelonLoader">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\MelonLoader.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="0Harmony">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\0Harmony.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="Il2CppInterop.Runtime">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\Il2CppInterop.Runtime.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="Il2CppInterop.Common">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\Il2CppInterop.Common.dll</HintPath>
      <Private>false</Private>
    </Reference>
  </ItemGroup>
 </Project>
@@ -1,926 +0,0 @@
 // DorkNet client mod (MelonLoader IL2CPP). Applies the minimum set of
 // Harmony patches needed for the 2020 watch to connect to a DorkNet
 // server:
 //
 //   1. URI rewrite      — `.rec.net` → user-configured host
 //   2. TLS trust bypass — make BouncyCastle never reject server certs
 //
 // Plus the anti-cheat BYPASS patches (anti-tamper / ToxMod / file-hash)
 // needed so a modded client isn't kicked, and three opt-in features that
 // are OFF by default (Desktop Screen-Share FPS, RRO quest party size,
 // Rec Royale night mode).
 //
 // This is the STABLE, shipping mod: it carries no diagnostic/tracing
 // code. All of that lives in the separate DorkNet.DebugMod (drop it in
 // the Mods folder to debug); the dev-menu / dev-debug-tools tooling
 // lives outside the public repo entirely.
 //
 // Config lives in <MelonLoader>\UserData\dorknet-clientmod.json. The
 // install-melon.ps1 wrapper writes that file on install; you can also
 // edit it by hand and relaunch the client.
 //
 // Why string-based AccessTools lookups instead of typeof(Il2Cpp...):
 // MelonLoader's Il2CppInterop adds an `Il2Cpp` prefix to game-side
 // namespaces (so `RecNet.Core` becomes `Il2CppRecNet.Core`) but the
 // exact policy for globally-namespaced types like `PhotonNetwork` and
 // for nested types varies across MelonLoader minor versions. Looking
 // types up by their original game-side name via AccessTools.TypeByName
 // (which searches every loaded assembly) keeps this file working
 // regardless of the prefix scheme, and avoids needing a verified
 // Il2CppAssemblies directory just to write the source.
 using HarmonyLib;
 using Il2CppInterop.Runtime;
 using Il2CppInterop.Runtime.InteropTypes;
 using Il2CppInterop.Runtime.InteropTypes.Arrays;
 using MelonLoader;
 using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Globalization;
 using System.IO;
 using System.Reflection;
 using System.Runtime.InteropServices;
 using System.Text;
 using System.Text.Json;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
 [assembly: MelonInfo(typeof(DorkNet.ClientMod.Mod), "DorkNet ClientMod", "1.0.0", "Dork Squad")]
 [assembly: MelonGame(null, null)]
 namespace DorkNet.ClientMod;
 public class Mod : MelonMod
 {
    internal static MelonLogger.Instance Log => Instance!.LoggerInstance;
    internal static Mod? Instance;
    private static readonly Dictionary<string, Type> ResolvedTypeCache = new();
    private readonly HashSet<string> _diagnosticPatchLabels = new();
    private bool _networkPatchesRegistered;
    private bool _antiTamperCallbackPatchesComplete;
    private int _antiTamperCallbackRetryFrame;
    private bool _toxModPatchesComplete;
    private int _toxModRetryFrame;
    // Config backed by a plain JSON file under MelonLoader/UserData.
    // The defaults below match the recommended install, so dropping this
    // mod in without writing a config file still gives working behaviour.
    public static class Cfg
    {
        public static string ServerHost          = "localhost";
        public static bool   EnableTlsTrustBypass = true;
        // ── Desktop Screen Sharing gadget FPS ──
        // RecRoom.Tools.Productivity.DesktopScreenSharingDisplay broadcasts
        // the shared desktop image. Its cadence is a baked [SerializeField]
        // float screenShareImageRefreshFrequency — the broadcast tick gates
        // on (Time.time - lastSend >= 1f / frequency), verified at
        // DesktopScreenSharingDisplay.txt:697-703, so the field IS the FPS
        // and its editor-only [Range] is NOT enforced at runtime. Set a
        // target here to override it (default prefab value is low, ~5).
        // 0 = leave the prefab value alone (patch not even registered).
        public static float  DesktopScreenShareFps = 0f;
        // The captured frame ships via the gadget's IPunObservable
        // OnPhotonSerializeView, which only fires at
        // PhotonNetwork.SerializationRate (default 10 Hz) — so 30 fps capture
        // still delivers ~10 unless we raise it. This lifts SendRate +
        // SerializationRate to >= the FPS target. GLOBAL: affects every
        // PhotonView's sync traffic, so turn off if it lags a busy room.
        public static bool   DesktopScreenShareRaisePhotonRate = true;
        // Optional per-frame size knobs (0 = leave the prefab value). Higher
        // FPS needs smaller frames to fit the Photon serialization budget;
        // lower these if 30 fps saturates bandwidth (chunked frames stall).
        public static int    DesktopScreenShareResolution = 0; // horizontal px
        public static int    DesktopScreenShareQuality = 0;    // JPEG quality
        // Raise RRO quest party size past the baked 4. The cap lives in each
        // quest GameConfigurationAsset.TeamConfigurations[].MaxTeamSize
        // ScriptableObject (baked in the client bundle; no server lever). The
        // quest scoreboard + party HUD build rows dynamically, so they
        // auto-scale once the team cap is raised. 0 = off (leave at 4).
        // Only single-team, quest-named configs are touched, so PvP team
        // sizes (paintball/laser tag) are never changed. See QuestTeamSize.
        public static int    QuestMaxTeamSize = 0;
        // Only these RRO quest GameConfigurationAssets get their team size
        // bumped (matched loosely: case/space-insensitive, filler words like
        // "the/of/for/quest" ignored, so "IsleOfLostSkulls" matches the
        // in-game "Isle of the Lost Skulls"). Empty = bump nothing. The
        // generic "Quest" config is intentionally NOT in the default list.
        public static string[] QuestMaxTeamSizeRooms =
            { "CrimsonCauldron", "Crescendo", "GoldenTrophy", "IsleOfLostSkulls", "TheRiseofJumbotron" };
        // ── Rec Royale night mode (client-side visual) ──
        // Re-skins Rec Royale with one of the game's own shipped night
        // MoodSetting assets (sky dome, sun, fog, bloom, colour grading)
        // through SceneMoodSettings' apply path, and unlocks the weapon
        // flashlight prefab while it is on. Purely local: the networked room
        // mood index is never touched. See RecRoyaleNight.
        public static bool   RecRoyaleNightMode = false;
        // Resources asset name of the MoodSetting to apply. Shipped options:
        // Night_Calm_Outdoor_Mood, Night_Spooky_Outdoor_Mood,
        // Night_Wild_Outdoor_Mood, Night_StuntRunner_Outdoor_Mood, OuterSpace_Mood.
        public static string RecRoyaleNightMood = "Night_Calm_Outdoor_Mood";
        // Unity scene names (substring, case-insensitive) that count as Rec
        // Royale. 2023-03-21 has a single map: RecRoyale_Frontier.
        public static string[] RecRoyaleNightScenes = { "RecRoyale" };
        // Force WeaponFlashlightController.FlashlightAllowed while night is on.
        public static bool   RecRoyaleNightFlashlights = true;
        // Apply the mood's fog block too. Off = the mood's FogSettings are
        // swapped for a block captured from the scene, so fog stays as-is.
        public static bool   RecRoyaleNightFog = false;
        // Darkening knobs applied to the mood data before it is used. Baked
        // lightmaps can't be dimmed, so post-exposure (EV, added to the mood's
        // ColorGradingSettings.exposure) is what actually darkens the whole
        // frame; the sun/ambient multipliers tone down realtime lighting.
        public static float  RecRoyaleNightExposure = -3.5f;    // EV offset (0 = mood default)
        public static float  RecRoyaleNightSunScale = 0.15f;    // × SunSettings.sunIntensity (1 = unchanged)
        public static float  RecRoyaleNightAmbientScale = 0.2f; // × SkyBoxSettings.ambientLightIntensity (1 = unchanged)
        // Post-exposure only renders if the scene Volume is on and the camera
        // renders post-processing; force both while night mode is active.
        public static bool   RecRoyaleNightForcePostProcessing = true;
        // The engine only drives RenderSettings.sun (Frontier: the sun-disc
        // light). Copy its rotation/colour onto every other directional light
        // and scale their intensity by RecRoyaleNightSunScale.
        public static bool   RecRoyaleNightMatchSunLights = true;
        // Turn fog off entirely while night is on (RenderSettings.fog=false and
        // the mood's fog block pushed out of range). Ignored when
        // RecRoyaleNightFog is true.
        public static bool   RecRoyaleNightDisableFog = false;
        // Renderers whose GameObject or material name contains any of these
        // (case-insensitive) are hidden while night is on. Frontier's daytime
        // cloud meshes are CloudPlane/Clouds/…_Cloud_RecRoyale_Frontier_Mat.
        public static string[] RecRoyaleNightHideObjects = { "Cloud" };
        // Optional UnityEngine.KeyCode name to toggle night at runtime (e.g.
        // "N"). Empty = no hotkey. A hotkey also arms the feature when
        // RecRoyaleNightMode is false, so it can be switched on in-game.
        public static string RecRoyaleNightToggleKey = "";
    }
    public override void OnInitializeMelon()
    {
        Instance = this;
        LoadConfig();
        Log.Msg($"DorkNet ClientMod loaded — host={Cfg.ServerHost}, tlsBypass={Cfg.EnableTlsTrustBypass}");
        RegisterNetworkPatches();
    }
    public override void OnLateInitializeMelon()
    {
        RegisterNetworkPatches();
        TryPatchByName("RecRoom.AntiCheat.EACManager",
                       "GenerateChallengeResponse",
                       args: new[] { typeof(string) },
                       prefix: nameof(AntiCheatPatches.GenerateChallengeResponse_Prefix));
        // TLS cert-validation bypass — gated behind Cfg.EnableTlsTrustBypass.
        // Even when the prefix's return value is "let original run", the
        // detour itself still has to be JIT-installed when BouncyCastle
        // does its first handshake, and MonoMod's CompileMethodHook
        // fatal-CLRs (0x80131506) installing trampolines into these
        // third-party interface implementations. Only register the
        // detours if the bypass is actually wanted; on a setup with
        // valid certs (the default) skip the patch entirely.
        if (Cfg.EnableTlsTrustBypass)
        {
            TryPatchByName("BestHTTP.SecureProtocol.Org.BouncyCastle.Crypto.Tls.ServerOnlyTlsAuthentication",
                           "NotifyServerCertificate",
                           prefix: nameof(TlsPatches.NotifyServerCertificate_Prefix));
            TryPatchByName("Org.BouncyCastle.Crypto.Tls.LegacyTlsAuthentication",
                           "NotifyServerCertificate",
                           prefix: nameof(TlsPatches.NotifyServerCertificate_Prefix));
        }
        // Anti-tamper / ToxMod / file-hash-checker are anti-cheat BYPASS
        // patches — core, always on, or the modded client gets kicked.
        RegisterAntiTamperCallbackPatches(logMisses: true);
        RegisterToxModPatches(logMisses: true);
        PatchFileHashCheckerCallback();
        // Desktop Screen Sharing FPS override. Only register when a target
        // is set; the postfix on the gadget's Awake rewrites the baked
        // refresh-frequency field (and, if enabled, raises the Photon
        // serialization rate so the higher capture rate actually transmits).
        if (Cfg.DesktopScreenShareFps > 0f)
        {
            TryPatchByName("RecRoom.Tools.Productivity.DesktopScreenSharingDisplay",
                           "Awake", args: Type.EmptyTypes,
                           postfix: nameof(ScreenSharePatches.DisplayAwake_Postfix));
        }
        // RRO quest party-size bump. Prefix the runtime config-apply path so
        // we can read the config's Name (scope to the allowlisted quests) and
        // bump GameConfigurationData.TeamConfigurations[].TeamSize before the
        // team manager / pre-game roster reads it. Only when a target is set.
        if (Cfg.QuestMaxTeamSize > 0)
        {
            // The runtime team cap is built from the baked GameConfigurationAsset
            // (a readable ScriptableObject) by GameConfigurationAsset.FIFOMGAOOHH()
            // — it reads asset.TeamConfigurations[i].MaxTeamSize (a typed int
            // struct-array) into the protobuf TeamSize. Prefix that builder and
            // bump the source array IN PLACE before it converts, scoped by
            // asset.Name. This avoids the obfuscated protobuf entirely (its
            // generic RepeatedField getter isn't emitted by Il2CppInterop).
            // Host-authoritative: the quest host must run the mod. See QuestTeamSize.
            TryPatchByName("RecRoom.Core.GameManagement.GameConfigurationAsset", "FIFOMGAOOHH",
                           prefix: nameof(QuestTeamSize.Build_Prefix));
            QuestTeamSize.TryPatchSpawnIndexNormalizers(HarmonyInstance);
            TryPatchByName("GameSpawnManager", "KMPAOJGOOCH",
                           postfix: nameof(QuestTeamSize.RelaxEmptySpawnFilter_Postfix));
        }
        // Rec Royale night mode: armed when enabled OR when a hotkey is set
        // (so it can be switched on in-game). Scene detection + mood apply
        // run from OnSceneWasLoaded / OnUpdate below.
        if (Cfg.RecRoyaleNightMode || !string.IsNullOrWhiteSpace(Cfg.RecRoyaleNightToggleKey))
        {
            _recRoyaleNightArmed = true;
            RecRoyaleNight.Register(HarmonyInstance);
        }
    }
    private bool _recRoyaleNightArmed;
    public override void OnSceneWasLoaded(int buildIndex, string sceneName)
    {
        if (_recRoyaleNightArmed) RecRoyaleNight.OnSceneLoaded(sceneName);
    }
    private bool PatchFileHashCheckerCallback()
    {
        var prefixMethod = GetPatchMethod(nameof(FileHashCheckerPatches.InitializeCallback_Prefix));
        var patched = 0;
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            foreach (var type in GetLoadableTypes(asm))
            {
                if (!MatchesFileHashCheckerCallbackType(type)) continue;
                foreach (var method in AccessTools.GetDeclaredMethods(type))
                {
                    if (method.IsAbstract || method.ContainsGenericParameters) continue;
                    if (!MatchesFileHashCheckerCallbackMethod(method)) continue;
                    try
                    {
                        HarmonyInstance.Patch(method, prefix: new HarmonyMethod(prefixMethod));
                        patched++;
                    }
                    catch (Exception ex)
                    {
                        Log.Warning($"[patch-fail] file hash checker callback {type.FullName}.{method.Name}: {ex.Message}");
                    }
                }
            }
        }
        if (patched == 0)
        {
            Log.Warning("[patch-miss] file hash checker callback");
            return false;
        }
        return true;
    }
    private void RegisterAntiTamperCallbackPatches(bool logMisses)
    {
        var complete = true;
        complete &= PatchCallbackMethod(
            "hile warning callback",
            type => TypeNameContains(type, "FPIBGPIAOBI") && TypeNameContains(type, "KHIIHOIFDMP"),
            method => MethodNameContains(method, "CreateHileWarning") && MethodNameContains(method, "b__0"),
            nameof(AntiTamperPatches.CreateHileWarningCallback_Prefix),
            logMisses);
        complete &= PatchCallbackMethod(
            "unknown DLL callback",
            type => TypeNameContains(type, "CheatManager") && TypeNameContains(type, "PNHDGEKCJCH"),
            method => MethodNameContains(method, "OnUnknownDLLDetected") && MethodNameContains(method, "b__0"),
            nameof(AntiTamperPatches.UnknownDllDetectedCallback_Prefix),
            logMisses);
        _antiTamperCallbackPatchesComplete = complete;
    }
    private void RegisterToxModPatches(bool logMisses)
    {
        var complete = true;
        complete &= TryPatchDiagnosticByName("ToxMod.ToxModVoiceComponent",
                                             "CanInitializeToxMod",
                                             args: Type.EmptyTypes,
                                             prefix: nameof(ToxModPatches.CanInitializeToxMod_Prefix),
                                             logMiss: logMisses);
        _toxModPatchesComplete = complete;
    }
    private bool PatchCallbackMethod(string label,
                                     Func<Type, bool> typePredicate,
                                     Func<MethodInfo, bool> methodPredicate,
                                     string prefix,
                                     bool logMiss)
    {
        if (_diagnosticPatchLabels.Contains(label))
            return true;
        var prefixMethod = GetPatchMethod(prefix);
        var patched = 0;
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            foreach (var type in GetLoadableTypes(asm))
            {
                if (!typePredicate(type)) continue;
                foreach (var method in AccessTools.GetDeclaredMethods(type))
                {
                    if (method.IsAbstract || method.ContainsGenericParameters) continue;
                    if (!methodPredicate(method)) continue;
                    try
                    {
                        HarmonyInstance.Patch(method, prefix: new HarmonyMethod(prefixMethod));
                        patched++;
                    }
                    catch (Exception ex)
                    {
                        Log.Warning($"[patch-fail] {label} {type.FullName}.{method.Name}: {ex.Message}");
                    }
                }
            }
        }
        if (patched == 0)
        {
            if (logMiss) Log.Warning($"[patch-miss] {label}");
            return false;
        }
        _diagnosticPatchLabels.Add(label);
        return true;
    }
    private static bool TypeNameContains(Type type, string value)
    {
        var fullName = type.FullName ?? type.Name;
        return fullName.Contains(value, StringComparison.Ordinal);
    }
    private static bool MethodNameContains(MethodInfo method, string value)
        => method.Name.Contains(value, StringComparison.Ordinal);
    private static bool MatchesFileHashCheckerCallbackType(Type type)
    {
        var fullName = type.FullName ?? type.Name;
        return fullName.Contains("BEPEAHOOLDB", StringComparison.Ordinal)
            && fullName.Contains("PBENKLNHBHL", StringComparison.Ordinal);
    }
    private static bool MatchesFileHashCheckerCallbackMethod(MethodInfo method)
    {
        if (method.ReturnType != typeof(void)) return false;
        var parameters = method.GetParameters();
        if (parameters.Length != 1) return false;
        var name = method.Name;
        if (name == "<InitializeFileHashChecker>b__0") return true;
        if (name == "_InitializeFileHashChecker_b__0") return true;
        return name.Contains("InitializeFileHashChecker", StringComparison.Ordinal)
            && name.Contains("b__0", StringComparison.Ordinal);
    }
    private void RegisterNetworkPatches()
    {
        if (_networkPatchesRegistered) return;
        var complete = true;
        complete &= TryPatch("Uri ctor (string)", typeof(Uri), "ctor",
                 new[] { typeof(string) },
                 prefix: nameof(UriPatches.UriStringCtor_Prefix));
        complete &= TryPatch("Uri ctor (string, UriKind)", typeof(Uri), "ctor",
                 new[] { typeof(string), typeof(UriKind) },
                 prefix: nameof(UriPatches.UriStringCtor_Prefix));
        complete &= TryPatchByName("BestHTTP.HTTPRequest", "Send",
                 prefix: nameof(UriPatches.HttpRequestSend_Prefix));
        complete &= TryPatchHttpManagerStringSendRequestOverloads();
        complete &= TryPatchByName("BestHTTP.HTTPManager", "SendRequest",
                 args: new[] { ResolveType("BestHTTP.HTTPRequest") ?? typeof(object) },
                 prefix: nameof(UriPatches.HttpManagerSendRequestObject_Prefix));
        _networkPatchesRegistered = complete;
    }
    private bool TryPatchHttpManagerStringSendRequestOverloads()
    {
        var type = ResolveType("BestHTTP.HTTPManager");
        if (type is null)
        {
            Log.Warning("[patch-miss] BestHTTP.HTTPManager.SendRequest(string): type not found");
            return false;
        }
        var prefix = GetPatchMethod(nameof(UriPatches.HttpManagerSendRequestString_Prefix));
        var patched = 0;
        foreach (var method in AccessTools.GetDeclaredMethods(type))
        {
            if (method.Name != "SendRequest") continue;
            var parameters = method.GetParameters();
            if (parameters.Length == 0 || parameters[0].ParameterType != typeof(string)) continue;
            HarmonyInstance.Patch(method, prefix: new HarmonyMethod(prefix));
            patched++;
        }
        if (patched == 0)
        {
            Log.Warning("[patch-miss] BestHTTP.HTTPManager.SendRequest(string)");
            return false;
        }
        return true;
    }
    public override void OnUpdate()
    {
        if (_recRoyaleNightArmed) RecRoyaleNight.Tick();
        if (!_antiTamperCallbackPatchesComplete && ++_antiTamperCallbackRetryFrame >= 300)
        {
            _antiTamperCallbackRetryFrame = 0;
            RegisterAntiTamperCallbackPatches(logMisses: false);
        }
        if (!_toxModPatchesComplete && ++_toxModRetryFrame >= 300)
        {
            _toxModRetryFrame = 0;
            RegisterToxModPatches(logMisses: false);
        }
    }
    public override void OnApplicationQuit()
    {
    }
    // ── Config ────────────────────────────────────────────────────────
    private static void LoadConfig()
    {
        try
        {
            var userData = ResolveUserDataDirectory();
            Directory.CreateDirectory(userData);
            var path = Path.Combine(userData, "dorknet-clientmod.json");
            if (!File.Exists(path))
            {
                return;
            }
            var doc = JsonDocument.Parse(File.ReadAllText(path));
            var r = doc.RootElement;
            if (TryGetConfigValue(r, "ServerHost", out var v))           Cfg.ServerHost = v.GetString() ?? Cfg.ServerHost;
            if (TryGetConfigValue(r, "EnableTlsTrustBypass", out v))     Cfg.EnableTlsTrustBypass = v.GetBoolean();
            if (TryGetConfigValue(r, "DesktopScreenShareFps", out v))             Cfg.DesktopScreenShareFps = (float)v.GetDouble();
            if (TryGetConfigValue(r, "DesktopScreenShareRaisePhotonRate", out v)) Cfg.DesktopScreenShareRaisePhotonRate = v.GetBoolean();
            if (TryGetConfigValue(r, "DesktopScreenShareResolution", out v))      Cfg.DesktopScreenShareResolution = v.GetInt32();
            if (TryGetConfigValue(r, "DesktopScreenShareQuality", out v))         Cfg.DesktopScreenShareQuality = v.GetInt32();
            if (TryGetConfigValue(r, "QuestMaxTeamSize", out v))                  Cfg.QuestMaxTeamSize = v.GetInt32();
            if (TryGetConfigValue(r, "QuestMaxTeamSizeRooms", out v) && v.ValueKind == JsonValueKind.Array)
            {
                var rooms = new List<string>();
                foreach (var e in v.EnumerateArray())
                    if (e.ValueKind == JsonValueKind.String && !string.IsNullOrWhiteSpace(e.GetString()))
                        rooms.Add(e.GetString()!);
                Cfg.QuestMaxTeamSizeRooms = rooms.ToArray(); // explicit (incl. empty = none)
            }
            if (TryGetConfigValue(r, "RecRoyaleNightMode", out v))        Cfg.RecRoyaleNightMode = v.GetBoolean();
            if (TryGetConfigValue(r, "RecRoyaleNightMood", out v))        Cfg.RecRoyaleNightMood = v.GetString() ?? Cfg.RecRoyaleNightMood;
            if (TryGetConfigValue(r, "RecRoyaleNightFlashlights", out v)) Cfg.RecRoyaleNightFlashlights = v.GetBoolean();
            if (TryGetConfigValue(r, "RecRoyaleNightFog", out v))         Cfg.RecRoyaleNightFog = v.GetBoolean();
            if (TryGetConfigValue(r, "RecRoyaleNightExposure", out v))     Cfg.RecRoyaleNightExposure = (float)v.GetDouble();
            if (TryGetConfigValue(r, "RecRoyaleNightSunScale", out v))     Cfg.RecRoyaleNightSunScale = (float)v.GetDouble();
            if (TryGetConfigValue(r, "RecRoyaleNightAmbientScale", out v)) Cfg.RecRoyaleNightAmbientScale = (float)v.GetDouble();
            if (TryGetConfigValue(r, "RecRoyaleNightForcePostProcessing", out v)) Cfg.RecRoyaleNightForcePostProcessing = v.GetBoolean();
            if (TryGetConfigValue(r, "RecRoyaleNightMatchSunLights", out v))     Cfg.RecRoyaleNightMatchSunLights = v.GetBoolean();
            if (TryGetConfigValue(r, "RecRoyaleNightDisableFog", out v))         Cfg.RecRoyaleNightDisableFog = v.GetBoolean();
            if (TryGetConfigValue(r, "RecRoyaleNightHideObjects", out v) && v.ValueKind == JsonValueKind.Array)
            {
                var names = new List<string>();
                foreach (var e in v.EnumerateArray())
                    if (e.ValueKind == JsonValueKind.String && !string.IsNullOrWhiteSpace(e.GetString()))
                        names.Add(e.GetString()!);
                Cfg.RecRoyaleNightHideObjects = names.ToArray(); // explicit (incl. empty = hide nothing)
            }
            if (TryGetConfigValue(r, "RecRoyaleNightToggleKey", out v))   Cfg.RecRoyaleNightToggleKey = v.GetString() ?? "";
            if (TryGetConfigValue(r, "RecRoyaleNightScenes", out v) && v.ValueKind == JsonValueKind.Array)
            {
                var scenes = new List<string>();
                foreach (var e in v.EnumerateArray())
                    if (e.ValueKind == JsonValueKind.String && !string.IsNullOrWhiteSpace(e.GetString()))
                        scenes.Add(e.GetString()!);
                if (scenes.Count > 0) Cfg.RecRoyaleNightScenes = scenes.ToArray();
            }
        }
        catch (Exception ex)
        {
            Log.Warning($"[config] load failed, using defaults: {ex.Message}");
        }
    }
    private static string ResolveUserDataDirectory()
    {
        foreach (var typeName in new[]
        {
            "MelonLoader.MelonEnvironment, MelonLoader",
            "MelonLoader.MelonUtils, MelonLoader",
        })
        {
            var type = Type.GetType(typeName);
            var prop = type?.GetProperty("UserDataDirectory", BindingFlags.Public | BindingFlags.Static);
            if (prop?.GetValue(null) is string value && !string.IsNullOrWhiteSpace(value))
                return value;
        }
        var modDll = Assembly.GetExecutingAssembly().Location;
        var modsDir = Path.GetDirectoryName(modDll) ?? string.Empty;
        var gameDir = Path.GetDirectoryName(modsDir) ?? AppContext.BaseDirectory;
        return Path.Combine(gameDir, "MelonLoader", "UserData");
    }
    private static bool TryGetConfigValue(JsonElement root, string name, out JsonElement value)
    {
        if (root.ValueKind == JsonValueKind.Object)
        {
            foreach (var prop in root.EnumerateObject())
            {
                if (string.Equals(prop.Name, name, StringComparison.OrdinalIgnoreCase))
                {
                    value = prop.Value;
                    return true;
                }
            }
        }
        value = default;
        return false;
    }
    private bool TryPatch(string label, Type target, string methodName,
                          Type[]? args, string? prefix = null, string? postfix = null,
                          bool logMiss = true)
    {
        try
        {
            var method = methodName == "ctor"
                ? (MethodBase)target.GetConstructor(args ?? Type.EmptyTypes)!
                : (args is null ? AccessTools.Method(target, methodName)
                                : AccessTools.Method(target, methodName, args));
            if (method is null)
            {
                // `logMiss` is throttled by the retry-loop caller — once per
                // 5 seconds in OnUpdate, every time in the one-shot initial
                // RegisterDiagnostics. Without the gate the per-second retry
                // loop would spam `[patch-miss]` lines forever for any method
                // whose name drifted in a newer game build.
                if (logMiss) Log.Warning($"[patch-miss] {label}");
                return false;
            }
            HarmonyInstance.Patch(method,
                prefix:  prefix  is null ? null : new HarmonyMethod(GetPatchMethod(prefix)),
                postfix: postfix is null ? null : new HarmonyMethod(GetPatchMethod(postfix)));
            return true;
        }
        catch (Exception ex)
        {
            Log.Error($"[patch-fail] {label}: {ex.Message}");
            return false;
        }
    }
    private bool TryPatchByName(string typeName, string methodName,
                                Type[]? args = null, string? prefix = null, string? postfix = null,
                                bool logMiss = true)
    {
        var label = FormatPatchLabel(typeName, methodName, args);
        var type = ResolveType(typeName);
        if (type is null)
        {
            if (logMiss) Log.Warning($"[patch-miss] {label}: type not found");
            return false;
        }
        return TryPatch(label, type, methodName, args, prefix, postfix, logMiss);
    }
    internal static Type? ResolveType(string name)
    {
        if (ResolvedTypeCache.TryGetValue(name, out var cached))
            return cached;
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            try
            {
                var t = asm.GetType(name, throwOnError: false);
                if (t is not null) return CacheResolvedType(name, t);
                var dottedPrefixed = asm.GetType("Il2Cpp." + name, throwOnError: false);
                if (dottedPrefixed is not null) return CacheResolvedType(name, dottedPrefixed);
                var prefixed = asm.GetType("Il2Cpp" + name, throwOnError: false);
                if (prefixed is not null) return CacheResolvedType(name, prefixed);
                // For namespaced types like "RecNet.Core", also try with
                // the Il2Cpp prefix on the namespace (i.e. "Il2CppRecNet.Core").
                var dot = name.IndexOf('.');
                if (dot > 0)
                {
                    var nsPrefixed = asm.GetType("Il2Cpp" + name.Substring(0, dot) + name.Substring(dot), throwOnError: false);
                    if (nsPrefixed is not null) return CacheResolvedType(name, nsPrefixed);
                }
            }
            catch { /* unloaded / dynamic asm — skip */ }
        }
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            foreach (var t in GetLoadableTypes(asm))
            {
                if (MatchesRequestedType(t, name))
                    return CacheResolvedType(name, t);
            }
        }
        return null;
    }
    private static Type CacheResolvedType(string name, Type type)
    {
        ResolvedTypeCache[name] = type;
        return type;
    }
    private static IEnumerable<Type> GetLoadableTypes(Assembly asm)
    {
        try
        {
            return asm.GetTypes();
        }
        catch (ReflectionTypeLoadException ex)
        {
            var types = new List<Type>();
            foreach (var t in ex.Types)
            {
                if (t is not null) types.Add(t);
            }
            return types;
        }
        catch
        {
            return Array.Empty<Type>();
        }
    }
    private static bool MatchesRequestedType(Type type, string requested)
    {
        var prefixed = "Il2Cpp" + requested;
        var dottedPrefixed = "Il2Cpp." + requested;
        if (type.FullName == requested || type.FullName == prefixed || type.FullName == dottedPrefixed) return true;
        if (type.Name == requested || type.Name == prefixed) return true;
        return type.FullName?.EndsWith("." + requested, StringComparison.Ordinal) == true ||
               type.FullName?.EndsWith(".Il2Cpp." + requested, StringComparison.Ordinal) == true ||
               type.FullName?.EndsWith(".Il2Cpp" + requested, StringComparison.Ordinal) == true;
    }
    private static string FormatPatchLabel(string typeName, string methodName, Type[]? args)
    {
        if (args is null) return $"{typeName}.{methodName}";
        var names = new List<string>();
        foreach (var arg in args)
            names.Add(arg.Name);
        return $"{typeName}.{methodName}({string.Join(",", names)})";
    }
    private MethodInfo GetPatchMethod(string name)
    {
        // Look in the core + feature patch holder classes.
        foreach (var holder in new[] { typeof(UriPatches), typeof(AntiCheatPatches), typeof(AntiTamperPatches), typeof(FileHashCheckerPatches), typeof(ToxModPatches), typeof(TlsPatches), typeof(ScreenSharePatches), typeof(QuestTeamSize), typeof(RecRoyaleNight) })
        {
            var m = holder.GetMethod(name, BindingFlags.Public | BindingFlags.Static);
            if (m is not null) return m;
        }
        throw new MissingMethodException($"patch method '{name}' not found on any holder");
    }
    private bool TryPatchDiagnosticByName(string typeName, string methodName,
                                          Type[]? args = null, string? prefix = null, string? postfix = null,
                                          bool logMiss = true)
    {
        var label = FormatPatchLabel(typeName, methodName, args);
        if (_diagnosticPatchLabels.Contains(label))
            return true;
        if (!TryPatchByName(typeName, methodName, args, prefix, postfix, logMiss))
            return false;
        _diagnosticPatchLabels.Add(label);
        return true;
    }
 }
 internal static class ScreenSharePatches
 {
    private static bool _photonRateApplied;
    public static void DisplayAwake_Postfix(object __instance)
    {
        try
        {
            var fps = Mod.Cfg.DesktopScreenShareFps;
            if (fps <= 0f || __instance is null) return;
            var t = __instance.GetType();
            SetField(t, __instance, "screenShareImageRefreshFrequency", fps);
            if (Mod.Cfg.DesktopScreenShareResolution > 0)
                SetField(t, __instance, "screenShareImageHorizontalResolution", Mod.Cfg.DesktopScreenShareResolution);
            if (Mod.Cfg.DesktopScreenShareQuality > 0)
                SetField(t, __instance, "screenShareImageCompressionQuality", Mod.Cfg.DesktopScreenShareQuality);
            if (Mod.Cfg.DesktopScreenShareRaisePhotonRate && !_photonRateApplied)
                RaisePhotonRates((int)Math.Ceiling(fps));
        }
        catch (Exception ex) { Mod.Log.Warning($"[screenshare] Awake postfix failed: {ex.Message}"); }
    }
    private static void SetField(Type t, object inst, string name, object value)
    {
        var f = AccessTools.Field(t, name);
        if (f is null) { Mod.Log.Warning($"[screenshare] field '{name}' not found on {t.Name}"); return; }
        f.SetValue(inst, value);
    }
    // Lift PhotonNetwork.SendRate + SerializationRate to >= hz. PUN requires
    // SerializationRate <= SendRate, so SendRate is kept at the max of the
    // two. Both are public static int members (property on some PUN builds,
    // field on others) — handle either. GLOBAL: every PhotonView's
    // OnPhotonSerializeView now fires at this rate.
    private static void RaisePhotonRates(int hz)
    {
        var pn = Mod.ResolveType("PhotonNetwork");
        if (pn is null) { Mod.Log.Warning("[screenshare] PhotonNetwork not found; can't raise serialization rate (delivered FPS will stay ~10)"); return; }
        var send = ReadInt(pn, "SendRate");
        var ser  = ReadInt(pn, "SerializationRate");
        var target = Math.Max(hz, 1);
        var newSend = Math.Max(target, Math.Max(send, ser));
        WriteInt(pn, "SendRate", newSend);
        WriteInt(pn, "SerializationRate", target);
        _photonRateApplied = true;
    }
    private static int ReadInt(Type t, string name)
    {
        var p = t.GetProperty(name, BindingFlags.Public | BindingFlags.Static);
        if (p is not null && p.CanRead && p.GetValue(null) is int pv) return pv;
        var f = t.GetField(name, BindingFlags.Public | BindingFlags.Static);
        if (f is not null && f.GetValue(null) is int fv) return fv;
        return 0;
    }
    private static void WriteInt(Type t, string name, int value)
    {
        var p = t.GetProperty(name, BindingFlags.Public | BindingFlags.Static);
        if (p is not null && p.CanWrite) { p.SetValue(null, value); return; }
        var f = t.GetField(name, BindingFlags.Public | BindingFlags.Static);
        if (f is not null) f.SetValue(null, value);
    }
 }
 internal static class UriPatches
 {
    public static void HttpRequestSetUri_Prefix(ref Uri __0)
    {
        RewriteUriArg(ref __0, "httprequest-seturi-rewrite");
    }
    public static void HttpRequestPrepareUri_Prefix(ref Uri __0)
    {
        RewriteUriArg(ref __0, "httprequest-prepareuri-rewrite");
    }
    public static void HttpManagerSendRequestString_Prefix(ref string url)
    {
        RewriteString(ref url, "httpmanager-rewrite");
    }
    public static void HttpManagerSendRequestObject_Prefix(object request)
    {
        RewriteRequestUri(request, "httpmanager-request-rewrite");
    }
    public static void UriStringCtor_Prefix(ref string uriString)
    {
        RewriteString(ref uriString, "uri-rewrite");
    }
    public static void HttpRequestSend_Prefix(object __instance)
    {
        RewriteRequestUri(__instance, "http-rewrite");
    }
    private static void RewriteRequestUri(object request, string label)
    {
        try
        {
            if (request is null) return;
            var type = request.GetType();
            const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
            if (TryRewriteUriProperty(request, type.GetProperty("Uri", flags), label)) return;
            if (TryRewriteUriField(request, type.GetField("<Uri>k__BackingField", flags), label)) return;
            foreach (var prop in type.GetProperties(flags))
            {
                if (prop.Name.IndexOf("Uri", StringComparison.OrdinalIgnoreCase) < 0) continue;
                if (TryRewriteUriProperty(request, prop, label)) return;
            }
            foreach (var field in type.GetFields(flags))
            {
                if (field.Name.IndexOf("Uri", StringComparison.OrdinalIgnoreCase) < 0) continue;
                if (TryRewriteUriField(request, field, label)) return;
            }
        }
        catch (Exception ex)
        {
            Mod.Log.Warning($"[{label}] failed: {ex.Message}");
        }
    }
    private static void RewriteUriArg(ref Uri uri, string label)
    {
        if (uri is null) return;
        var rewritten = RewriteUri(uri);
        if (rewritten is null) return;
        uri = rewritten;
    }
    private static bool TryRewriteUriProperty(object request, PropertyInfo? prop, string label)
    {
        if (prop is null || !prop.CanRead || !prop.CanWrite) return false;
        if (prop.GetIndexParameters().Length != 0) return false;
        if (prop.GetValue(request) is not Uri uri) return false;
        var rewritten = RewriteUri(uri);
        if (rewritten is null) return false;
        prop.SetValue(request, rewritten);
        return true;
    }
    private static bool TryRewriteUriField(object request, FieldInfo? field, string label)
    {
        if (field is null || field.IsInitOnly) return false;
        if (field.GetValue(request) is not Uri uri) return false;
        var rewritten = RewriteUri(uri);
        if (rewritten is null) return false;
        field.SetValue(request, rewritten);
        return true;
    }
    private static void RewriteString(ref string uriString, string label)
    {
        if (string.IsNullOrEmpty(uriString)) return;
        if (uriString.IndexOf(".rec.net", StringComparison.OrdinalIgnoreCase) < 0) return;
        if (!Uri.TryCreate(uriString, UriKind.Absolute, out var uri)) return;
        var rewrittenUri = RewriteUri(uri);
        if (rewrittenUri is null) return;
        var rewritten = rewrittenUri.ToString();
        if (rewritten == uriString) return;
        uriString = rewritten;
    }
    private static Uri? RewriteUri(Uri uri)
    {
        var host = Mod.Cfg.ServerHost;
        if (string.IsNullOrEmpty(host)) return null;
        if (!uri.Host.EndsWith(".rec.net", StringComparison.OrdinalIgnoreCase)) return null;
        var service = uri.Host[..^".rec.net".Length];
        if (string.IsNullOrWhiteSpace(service)) return null;
        return new UriBuilder(uri)
        {
            Host = service + "." + host,
        }.Uri;
    }
 }
 internal static class AntiCheatPatches
 {
    public static bool GenerateChallengeResponse_Prefix(string FIMBPCACMKJ, ref string __result)
    {
        __result = "AAAAAAAAAAAAAAAAAAAAAAAA";
        return false;
    }
 }
 internal static class AntiTamperPatches
 {
    public static bool CreateHileWarningCallback_Prefix(bool shouldQuit)
    {
        return false;
    }
    public static bool UnknownDllDetectedCallback_Prefix()
    {
        return false;
    }
 }
 internal static class FileHashCheckerPatches
 {
    public static bool InitializeCallback_Prefix(object? result)
    {
        return false;
    }
 }
 internal static class ToxModPatches
 {
    public static bool CanInitializeToxMod_Prefix(ref bool __result)
    {
        __result = false;
        return false;
    }
 }
 internal static class TlsPatches
 {
    // Both BouncyCastle TLS authenticators have the same `void
    // NotifyServerCertificate(...)` signature whose body throws when the
    // chain doesn't validate. Returning false from a Harmony prefix on a
    // void method skips the original — the certificate is accepted by
    // virtue of NotifyServerCertificate never throwing.
    public static bool NotifyServerCertificate_Prefix()
    {
        return !Mod.Cfg.EnableTlsTrustBypass; // false skips original; true (bypass off) lets it run
    }
 }
@@ -1,319 +0,0 @@
 // Raise RRO quest party size past the baked 4 — precisely, only for the
 // allowlisted quests (Cfg.QuestMaxTeamSizeRooms).
 //
 // HOW THE CAP IS REALLY BUILT (cracked from the December dump/ISIL; names
 // re-verified against the March-2023 dump — 2023 obfuscated names below):
 //   GameConfigurationTool.Awake()
 //     → reads its baked `defaultGameConfiguration` (GameConfigurationAsset,
 //       a Unity ScriptableObject)
 //     → calls GameConfigurationAsset.FIFOMGAOOHH()  ← builds the runtime
 //       protobuf GameConfigurationData (GPIGCAJICEF) FROM the asset
 //     → stores and applies it to the team manager.
 //   Inside FIFOMGAOOHH the build loop reads asset.TeamConfigurations[i]
 //   .MaxTeamSize (a typed int struct-array) and writes each straight into a
 //   new GameTeamConfigurationData.TeamSize.
 //
 // So the runtime cap originates from the asset's `TeamConfiguration[]` — a
 // READABLE, typed struct array — NOT from anything that needs the obfuscated
 // protobuf. Earlier attempts failed because:
 //   • bumping the asset on a 2s poll happened AFTER the builder already built &
 //     cached the protobuf (timing, not the wrong field);
 //   • patching the protobuf getters is impossible — Il2CppInterop doesn't emit
 //     the generic RepeatedField<T> getter, and the simple int getter wasn't
 //     emitted either.
 //
 // THE FIX: Harmony-PREFIX GameConfigurationAsset.FIFOMGAOOHH() and bump the
 // asset's TeamConfigurations[i].MaxTeamSize to the target IN PLACE, right
 // before it builds the protobuf. The built config then carries the new cap and
 // the team manager / pre-game roster / open-slots all honour it. Scoped by
 // asset.Name to the allowlist (PvP/sandbox configs are left alone).
 //
 // HOST-AUTHORITATIVE: the quest host builds the config it networks to joiners
 // (RpcDeserializeConfig), so the host must run this mod for everyone to see the
 // raised cap. (A joiner can't override — that would need the unreachable
 // protobuf path.)
 using System;
 using System.Collections.Generic;
 using System.Reflection;
 using HarmonyLib;
 namespace DorkNet.ClientMod;
 internal static class QuestTeamSize
 {
    private const BindingFlags BF = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
    // 2023 spawn path (verified in the March-2023 ISIL): the spawn driver
    // HCPLAILIHEL reads the team-player index from the roster entry
    // (GameTeamManager/BNBIBPFPJPJ.JPIHHGBLLNG()) and passes it straight into
    // the KMPAOJGOOCH spawn-point filter. December's intermediate helpers are
    // gone from this path — the out-param resolver is inlined (zero call
    // sites), and GetTeamPlayerIndex is only called by Charades/RecRally, so
    // normalizing it would touch non-quest games. The KMPAOJGOOCH index
    // argument is the single choke point: normalize it in a prefix and keep
    // the empty-filter relax postfix as the backstop.
    public static bool TryPatchSpawnIndexNormalizers(HarmonyLib.Harmony harmony)
    {
        return TryPatchRequiredSpawnIndexNormalizer(harmony);
    }
    private static bool TryPatchRequiredSpawnIndexNormalizer(HarmonyLib.Harmony harmony)
    {
        try
        {
            var spawnType = Mod.ResolveType("GameSpawnManager");
            var indexType = Mod.ResolveType("NBCOFGIKKHM");
            if (spawnType is null || indexType is null)
            {
                Mod.Log.Warning("[patch-miss] GameSpawnManager.KMPAOJGOOCH index normalizer: type not found");
                return false;
            }
            var target = AccessTools.Method(spawnType, "KMPAOJGOOCH");
            if (target is null)
            {
                Mod.Log.Warning("[patch-miss] GameSpawnManager.KMPAOJGOOCH index normalizer");
                return false;
            }
            var patch = typeof(QuestTeamSize)
                .GetMethod(nameof(NormalizeRequiredSpawnIndex_Prefix), BindingFlags.Public | BindingFlags.Static)!
                .MakeGenericMethod(indexType);
            harmony.Patch(target, prefix: new HarmonyMethod(patch));
            return true;
        }
        catch (Exception ex)
        {
            Mod.Log.Error($"[patch-fail] GameSpawnManager.KMPAOJGOOCH index normalizer: {ex.Message}");
            return false;
        }
    }
    // PREFIX on GameSpawnManager.KMPAOJGOOCH(..., NBCOFGIKKHM index, ...).
    // The RRO quest scenes only have spawn points for indexes 0-3. After
    // raising the quest team cap, players 5+ legitimately receive INDEX_4+,
    // but those values cannot match any baked quest spawn point. Normalize
    // just the index the spawn-point filter compares against; the actual team
    // roster/cap remains raised.
    public static void NormalizeRequiredSpawnIndex_Prefix<T>(ref T __2) where T : struct
    {
        try
        {
            if (Mod.Cfg.QuestMaxTeamSize <= 4) return;
            var value = Convert.ToInt32(__2);
            if (!TryNormalizeIndex(value, out var normalized)) return;
            __2 = (T)Enum.ToObject(typeof(T), normalized);
        }
        catch (Exception ex)
        {
            Mod.Log.Warning($"[questsize] required spawn index normalize failed: {ex.Message}");
        }
    }
    private static bool TryNormalizeIndex(int value, out int normalized)
    {
        normalized = value % 4;
        return value >= 4;
    }
    // PREFIX on GameConfigurationAsset.FIFOMGAOOHH()  (asset → protobuf builder).
    public static void Build_Prefix(object __instance)
    {
        try
        {
            var target = Mod.Cfg.QuestMaxTeamSize;
            if (target <= 0 || __instance is null) return;
            var name = GetMember(__instance, "Name") as string ?? "";
            if (!IsAllowed(name)) return;
            var arr = GetMember(__instance, "TeamConfigurations");
            int len = ArrLen(arr);
            if (len <= 0) return;
            int bumped = 0;
            for (int i = 0; i < len; i++)
            {
                var elem = ArrItem(arr, i);     // boxed TeamConfiguration struct (copy)
                if (elem is null) continue;
                int cur = ReadInt(elem, "MaxTeamSize");
                if (cur > 0 && cur < target &&
                    WriteInt(elem, "MaxTeamSize", target) &&
                    SetArrItem(arr!, i, elem))   // write the mutated struct back
                    bumped++;
            }
        }
        catch (Exception ex) { Mod.Log.Warning($"[questsize] build prefix failed: {ex.Message}"); }
    }
    // POSTFIX on GameSpawnManager.KMPAOJGOOCH(..., outputList). That method
    // filters spawn points by state/game-mode/spectator/team/team-player-index/
    // custom-tag before the spawn selector runs. The RRO quest prefabs only
    // have indexed start points for players 0-3; once we raise the team size,
    // player index 4+ can filter every point out before the built-in overlap
    // fallback has a chance to help.
    //
    // The caller (2023: HCPLAILIHEL) runs this filter, then if output.Count
    // is still 0 it logs "due to spawn point requirement tests" and falls back
    // to the unfiltered source list as an arbitrary spawn set. Filling the
    // output list here keeps the normal overlap pass and spawn-selection mode
    // alive instead of taking that bad arbitrary fallback.
    //
    // Harmony binds __0 and __7 by argument position: source list and output
    // list. The obfuscated parameter names are not reliable in MelonLoader's
    // generated IL2CPP metadata, which is why this intentionally avoids them.
    // If the filtered output is empty, copy the already-selected candidate
    // scene spawn list back into the output so extra players reuse baked quest
    // spawn points instead of being left out in the void.
    public static void RelaxEmptySpawnFilter_Postfix(object __0, object __7)
    {
        try
        {
            if (Mod.Cfg.QuestMaxTeamSize <= 4) return;
            if (Count(__7) > 0) return;
            var sourceCount = Count(__0);
            if (sourceCount <= 0) return;
            CopyListItems(__0, __7);
        }
        catch (Exception ex)
        {
            Mod.Log.Warning($"[questsize] spawn filter relax failed: {ex.Message}");
        }
    }
    // ── allowlist matching (normalize: lowercase-alnum, strip filler) ──────
    private static List<string>? _wanted;
    private static bool IsAllowed(string configName)
    {
        _wanted ??= BuildWanted();
        if (_wanted.Count == 0) return false;
        var have = Norm(configName);
        foreach (var w in _wanted)
            if (have.Contains(w)) return true;
        return false;
    }
    private static List<string> BuildWanted()
    {
        var list = new List<string>();
        foreach (var entry in Mod.Cfg.QuestMaxTeamSizeRooms)
        {
            var nrm = Norm(entry);
            if (nrm.Length > 0) list.Add(nrm);
        }
        return list;
    }
    private static string Norm(string s)
    {
        if (string.IsNullOrEmpty(s)) return "";
        var sb = new System.Text.StringBuilder(s.Length);
        foreach (var c in s)
            if (char.IsLetterOrDigit(c)) sb.Append(char.ToLowerInvariant(c));
        return sb.ToString().Replace("the", "").Replace("for", "").Replace("of", "");
    }
    // ── reflection helpers (Il2CppInterop exposes il2cpp members as either a
    //    property or a field depending on version — try both) ────────────────
    private static object? GetMember(object o, string name)
    {
        var t = o.GetType();
        var p = t.GetProperty(name, BF);
        if (p != null && p.CanRead && p.GetIndexParameters().Length == 0)
            { try { return p.GetValue(o); } catch { } }
        var f = t.GetField(name, BF);
        if (f != null) { try { return f.GetValue(o); } catch { } }
        return null;
    }
    private static int ReadInt(object? o, string name)
    {
        if (o is null) return 0;
        var v = GetMember(o, name);
        if (v is int n) return n;
        return v != null && int.TryParse(v.ToString(), out var p) ? p : 0;
    }
    private static bool WriteInt(object o, string name, int val)
    {
        var t = o.GetType();
        var p = t.GetProperty(name, BF);
        if (p != null && p.CanWrite) { try { p.SetValue(o, val); return true; } catch { } }
        var f = t.GetField(name, BF);
        if (f != null) { try { f.SetValue(o, val); return true; } catch { } }
        return false;
    }
    private static int ArrLen(object? arr)
    {
        if (arr is null) return 0;
        if (arr is Array a) return a.Length;
        var lp = arr.GetType().GetProperty("Length") ?? arr.GetType().GetProperty("Count");
        return (lp?.GetValue(arr) as int?) ?? 0;
    }
    private static int Count(object? collection) => ArrLen(collection);
    private static object? ArrItem(object? arr, int i)
    {
        if (arr is null) return null;
        if (arr is Array a) return a.GetValue(i);
        var gi = arr.GetType().GetMethod("get_Item", new[] { typeof(int) });
        return gi?.Invoke(arr, new object[] { i });
    }
    // Write a (boxed) struct element back into an Il2CppStructArray via its
    // set_Item(int, T) indexer. Reflection unboxes to T on invoke.
    private static bool SetArrItem(object arr, int i, object val)
    {
        if (arr is Array a) { try { a.SetValue(val, i); return true; } catch { return false; } }
        foreach (var m in arr.GetType().GetMethods())
        {
            if (m.Name != "set_Item") continue;
            var ps = m.GetParameters();
            if (ps.Length == 2 && ps[0].ParameterType == typeof(int))
            {
                try { m.Invoke(arr, new[] { i, val }); return true; } catch { }
            }
        }
        return false;
    }
    private static int CopyListItems(object? src, object? dst)
    {
        if (src is null || dst is null) return 0;
        MethodInfo? add = null;
        foreach (var method in dst.GetType().GetMethods())
        {
            if (method.Name != "Add") continue;
            if (method.GetParameters().Length != 1) continue;
            add = method;
            break;
        }
        if (add is null) return 0;
        var n = ArrLen(src);
        var copied = 0;
        for (var i = 0; i < n; i++)
        {
            var item = ArrItem(src, i);
            if (item is null) continue;
            try
            {
                add.Invoke(dst, new[] { item });
                copied++;
            }
            catch { }
        }
        return copied;
    }
    private static string TypeName(object? value) =>
        value?.GetType().FullName ?? "<null>";
 }
@@ -1,1401 +0,0 @@
 // Rec Royale night mode — client-side, opt-in.
 //
 // Rec Royale never shipped a night variant, but the March-2023 client
 // carries everything needed to build one from the game's own tooling:
 //
 //   • Every room scene owns a RecRoomSceneManager (name-preserved field
 //     `sceneMoodSettings` → RecRoom.Core.Scene.SceneMoodSettings). That
 //     object is the room "mood" engine behind the Maker Pen sky/sun/fog
 //     settings: it holds `availableMoods` (MoodSetting[]), `defaultMood`
 //     and `CurrentMood`, plus blenders for skybox, sun, fog, bloom and
 //     colour grading.
 //   • SceneMoodSettings.MLLBALMKEGJ(MoodSetting) is the apply step
 //     (ISIL: SceneMoodSettings.txt:3025-3581). It pushes the mood's six
 //     settings blocks into the blenders (ALCMNGKOEBK), swaps the URP
 //     VolumeProfile (OEKNGEMDMDB), sets RenderSettings.skybox to the
 //     global MoodConfig skybox material (LNMDIIFOFPD.NHAEHKJINFH, shader
 //     "Custom/SkyBox"), re-aims RenderSettings.sun, sets every
 //     ReflectionProbe.customBakedTexture to the mood's baked cubemap and
 //     force-updates the blenders. It does NOT touch the networked mood
 //     index, so calling it is purely local.
 //   • The build ships ready-made night moods as Resources assets
 //     (resources.assets; ResourceManager table in globalgamemanagers):
 //     Night_Calm_Outdoor_Mood ("Calm Night"), Night_Spooky_Outdoor_Mood
 //     ("Spooky Night"), Night_Wild_Outdoor_Mood ("Wild Night"),
 //     Night_StuntRunner_Outdoor_Mood and OuterSpace_Mood ("Outer Space").
 //   • The only Rec Royale map in this build is
 //     Assets/Activities/RecRoyale/Maps/RecRoyale_Frontier/RecRoyale_Frontier.unity.
 //
 // RRO SCENES HAVE NO ROOM DATA BLOB. The mood engine's `isEnabled` flag
 // (SceneMoodSettings+0x38) is only switched on by the room-data loader
 // (EIMFCPIHEPF.JPKEMACDNCF, ISIL :2136-2310), which runs for custom rooms
 // only. While it is off, get_CurrentMood returns null and nothing ticks.
 // The loader's bring-up sequence is:
 //     LKIKMLNPCFK(false)   // SetEnabled(false): applies a null mood
 //     LIEDFOLBGHL()        // capture the scene's own skybox/sun/fog as the
 //                          // blenders' "previous" data (checks shader name
 //                          // "Custom/SkyBox" → HasRecRoomSkyboxShader)
 //     LKIKMLNPCFK(true)    // SetEnabled(true)
 // This mod replays exactly that before applying the night mood.
 //
 // Deliberately NOT used: SceneMoodSettings.IPAMPMBDPNB(Guid) /
 // set_CurrentRoomMoodIndex. `_currentRoomMoodIndex` is a
 // RecRoom.Networking.SynchronizedFields DFAOKLDJPEL<int>, i.e. it
 // replicates to every player in the instance. Applying the mood directly
 // keeps night mode a per-client visual choice.
 //
 // Weapon flashlights: WeaponFlashlightController.get_FlashlightAllowed
 // (ISIL: WeaponFlashlightController.txt:3-75) is
 // `Matchmaking.FBELDNLEKAC() != null && [+0x28] == 15` — a game-mode
 // gate for an activity that isn't Rec Royale. A Harmony postfix forces it
 // true while night mode is active, so weapons picked up in the dark get
 // the game's own flashlight prefab.
 using System;
 using System.Collections.Generic;
 using System.Reflection;
 using HarmonyLib;
 using Il2CppInterop.Runtime;
 using Il2CppInterop.Runtime.InteropTypes;
 namespace DorkNet.ClientMod;
 internal static class RecRoyaleNight
 {
    private const BindingFlags Any = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static;
    // Runtime state. `Active` starts from Cfg.RecRoyaleNightMode and flips
    // with the hotkey; `_inRoyale` tracks whether the current scene is one
    // of Cfg.RecRoyaleNightScenes.
    public static bool Active { get; private set; }
    private static bool _inRoyale;
    private static string _sceneName = "";
    private static bool _appliedThisScene;
    private static int _frame;
    private static int _sceneFrames;         // frames since the Royale scene loaded
    private static int _reassertFrames;      // frames since the last re-apply
    // Per-scene bring-up bookkeeping so toggling off can put things back.
    private static bool _engineWasDisabled;  // we enabled the mood engine ourselves
    private static object? _originalSkybox;  // RenderSettings.skybox before we touched it
    private static bool _sunWasNull;         // we assigned RenderSettings.sun ourselves
    private static object? _originalFog;     // MoodSetting.FogSettings before we swapped it
    private static object? _fogPatchedMood;  // the mood asset whose FogSettings we replaced
    private static object? _darkPatchedMood; // the mood asset whose exposure/sun/ambient we changed
    private static float? _origExposure, _origSunIntensity, _origAmbient;
    private static bool _diagLogged;
    private const int PollEveryFrames = 30;          // ~0.5 s @ 60 fps
    private const int SettleFrames = 90;             // let the scene's own lighting settle first
    private const int PollGiveUpFrames = 60 * 120;   // stop polling after ~2 min
    private const int ReassertEveryFrames = 60 * 10; // re-apply every ~10 s
    // Resolved reflection handles (lazy, cached).
    private static bool _resolved;
    private static Type? _sceneManagerType;
    private static PropertyInfo? _sceneManagerInstance;
    private static FieldInfo? _sceneMoodSettingsField;
    private static PropertyInfo? _sceneMoodSettingsProp;
    private static Type? _moodSettingType;
    private static MethodInfo? _applyMood;       // MLLBALMKEGJ(MoodSetting)
    private static MethodInfo? _setEnabled;      // LKIKMLNPCFK(bool)
    private static MethodInfo? _capture;         // LIEDFOLBGHL()
    private static FieldInfo? _isEnabled;        // isEnabled
    private static PropertyInfo? _roomMoodsEnabled;
    private static PropertyInfo? _hasSkyShader;
    private static PropertyInfo? _hasSunSource;
    private static PropertyInfo? _volume;
    private static FieldInfo? _availableMoods;
    private static PropertyInfo? _currentMood;
    private static PropertyInfo? _friendlyName;
    private static PropertyInfo? _renderSkybox;  // UnityEngine.RenderSettings.skybox
    private static PropertyInfo? _renderSun;     // UnityEngine.RenderSettings.sun
    private static Type? _lightType;             // UnityEngine.Light
    private static Type? _fogSettingsType;       // FogMoodSettings
    private static MethodInfo? _fogCapture;      // FogMoodSettings.NLDDIDEIEFH() — read RenderSettings fog
    private static PropertyInfo? _moodFog;       // MoodSetting.FogSettings
    private static Type? _materialType;          // UnityEngine.Material
    private static Type? _shaderType;            // UnityEngine.Shader
    private static Type? _moodConfigHolder;      // LNMDIIFOFPD (static MoodConfig holder)
    private static Type? _cameraDataType;        // UnityEngine.Rendering.Universal.UniversalAdditionalCameraData
    private static object? _ourSkybox;           // Material we created for the mood skybox
    private static object? _nightMood;           // MoodSetting interop wrapper
    private static string _nightMoodLoadedName = "";
    // Hotkey
    private static bool _inputResolved;
    private static MethodInfo? _getKeyDown;
    private static object? _toggleKey;
    // ── registration ──────────────────────────────────────────────────
    public static void Register(HarmonyLib.Harmony harmony)
    {
        Active = Mod.Cfg.RecRoyaleNightMode;
        Mod.Log.Msg($"[royale-night] enabled={Active} mood={Mod.Cfg.RecRoyaleNightMood} " +
                    $"scenes=[{string.Join(",", Mod.Cfg.RecRoyaleNightScenes)}] " +
                    $"flashlights={Mod.Cfg.RecRoyaleNightFlashlights} " +
                    $"hotkey={(string.IsNullOrWhiteSpace(Mod.Cfg.RecRoyaleNightToggleKey) ? "<none>" : Mod.Cfg.RecRoyaleNightToggleKey)}");
        if (Mod.Cfg.RecRoyaleNightFlashlights)
            TryPatchFlashlightGate(harmony);
    }
    // POSTFIX on WeaponFlashlightController.get_FlashlightAllowed. The
    // interop property carries the obfuscated name (KIMMMCCKMJL in the
    // 2023-03-21 build) while the il2cpp method keeps `get_FlashlightAllowed`,
    // so resolve by name first and fall back to "the only read-only bool
    // property declared on the type".
    private static void TryPatchFlashlightGate(HarmonyLib.Harmony harmony)
    {
        try
        {
            var type = Mod.ResolveType("WeaponFlashlightController");
            if (type is null)
            {
                Mod.Log.Warning("[patch-miss] WeaponFlashlightController: type not found");
                return;
            }
            MethodInfo? getter = AccessTools.PropertyGetter(type, "FlashlightAllowed")
                              ?? AccessTools.PropertyGetter(type, "KIMMMCCKMJL");
            if (getter is null)
            {
                PropertyInfo? only = null;
                int count = 0;
                foreach (var p in type.GetProperties(BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly))
                {
                    if (p.PropertyType != typeof(bool) || !p.CanRead || p.CanWrite || p.GetIndexParameters().Length != 0) continue;
                    only = p; count++;
                }
                if (count == 1) getter = only!.GetGetMethod(true);
            }
            if (getter is null)
            {
                Mod.Log.Warning("[patch-miss] WeaponFlashlightController.get_FlashlightAllowed");
                return;
            }
            var postfix = typeof(RecRoyaleNight).GetMethod(nameof(FlashlightAllowed_Postfix), BindingFlags.Public | BindingFlags.Static)!;
            harmony.Patch(getter, postfix: new HarmonyMethod(postfix));
        }
        catch (Exception ex)
        {
            Mod.Log.Error($"[patch-fail] WeaponFlashlightController.get_FlashlightAllowed: {ex.Message}");
        }
    }
    public static void FlashlightAllowed_Postfix(ref bool __result)
    {
        if (Active && _inRoyale) __result = true;
    }
    // ── lifecycle (called from Mod) ───────────────────────────────────
    public static void OnSceneLoaded(string sceneName)
    {
        _sceneName = sceneName ?? "";
        var was = _inRoyale;
        _inRoyale = MatchesScene(_sceneName);
        if (_inRoyale)
        {
            _appliedThisScene = false;
            _sceneFrames = 0;
            _reassertFrames = 0;
            _engineWasDisabled = false;
            _originalSkybox = null;
            _sunWasNull = false;
            _diagLogged = false;
            RestoreMoodPatches();
            Mod.Log.Msg($"[royale-night] scene '{_sceneName}' loaded — night mode {(Active ? "will apply" : "is off (hotkey to enable)")}");
        }
        else if (was)
        {
            _appliedThisScene = false;
            _engineWasDisabled = false;
            _originalSkybox = null;
            _sunWasNull = false;
            RestoreMoodPatches();
        }
    }
    public static void Tick()
    {
        _frame++;
        PollHotkey();
        if (!_inRoyale || !Active) return;
        _sceneFrames++;
        if (_frame % PollEveryFrames != 0) return;
        if (!_appliedThisScene)
        {
            if (_sceneFrames < SettleFrames || _sceneFrames > PollGiveUpFrames) return;
            if (TryApply(true)) _appliedThisScene = true;
            return;
        }
        // Cheap safeguard: the game re-applies its own mood on quality
        // changes / studio events. Re-assert every ~10 s; when the blenders
        // are already at target this is visually a no-op.
        _reassertFrames += PollEveryFrames;
        if (_reassertFrames >= ReassertEveryFrames)
        {
            _reassertFrames = 0;
            TryApply(true);
        }
    }
    public static void Toggle()
    {
        Active = !Active;
        Mod.Log.Msg($"[royale-night] toggled {(Active ? "ON" : "OFF")}");
        if (!_inRoyale) return;
        if (TryApply(Active)) _appliedThisScene = Active;
        else if (!Active) _appliedThisScene = false;
    }
    // ── the actual apply ──────────────────────────────────────────────
    // night=true  → bring the mood engine up if needed, apply the night mood
    // night=false → restore: scene mood if the engine was already running,
    //               otherwise disable the engine again + put the skybox back
    private static bool TryApply(bool night)
    {
        try
        {
            if (!_resolved && !Resolve()) return false;
            if (_applyMood is null) return false;
            var manager = GetSceneManager();
            if (manager is null) { Diag("scene manager instance is null"); return false; }
            var moods = _sceneMoodSettingsField?.GetValue(manager) ?? _sceneMoodSettingsProp?.GetValue(manager);
            if (moods is null) { Diag("sceneMoodSettings is null"); return false; }
            // `isEnabled` reads differently through the interop property vs the
            // field (seen True/False for the same state), so don't gate on it.
            // RoomMoodsEnabled (= isEnabled && defaultMood != null) is computed
            // game-side and is false for every RRO scene; bring the engine up
            // exactly once per Royale scene whenever it is not true.
            var enabled = GetMember(moods, "isEnabled") is true;
            var roomMoodsEnabled = Read(_roomMoodsEnabled, moods) is true;
            LogState(moods, enabled);
            if (night)
            {
                var target = GetNightMood();
                if (target is null) return false;
                if (!roomMoodsEnabled && !_engineWasDisabled)
                {
                    // Replay the room-data loader's bring-up. Remember the
                    // scene's own skybox so toggle-off can restore it.
                    if (_originalSkybox is null && _renderSkybox is not null)
                        _originalSkybox = _renderSkybox.GetValue(null);
                    if (_setEnabled is null || _capture is null)
                    {
                        Mod.Log.Warning("[royale-night] mood engine is disabled in this scene and SetEnabled/Capture are unresolved — cannot bring it up");
                        return false;
                    }
                    // RRO scenes leave RenderSettings.sun unset, and the engine
                    // skips every sun change (direction, colour, intensity) when
                    // HasSunSource is false. Point it at the scene's directional
                    // light BEFORE capture so the flag comes out true.
                    EnsureSun();
                    // Keep the scene's own fog unless asked otherwise: replace
                    // the mood's FogSettings with a block captured from the
                    // current RenderSettings before anything changes them.
                    if (!Mod.Cfg.RecRoyaleNightFog) PreserveFog(target);
                    // Baked lightmaps can't be dimmed, so darken the frame via
                    // the mood's own post-exposure and tone down sun/ambient.
                    PatchDarkness(target);
                    _setEnabled.Invoke(moods, new object[] { false });
                    _capture.Invoke(moods, null);
                    // The per-frame update (CEKLEBHDAHA, ISIL :3895-4031) returns
                    // at once while get_CurrentMood() is null, and the one-shot
                    // apply only sets blend TARGETS — the update is what writes
                    // sky colours, rotates the sun and pushes exposure. In RRO
                    // scenes CurrentMood is null because defaultMood is unset.
                    // Register the night mood as this scene's defaultMood and
                    // sole availableMoods entry so the engine runs like a
                    // one-mood custom room.
                    InstallSceneMood(moods, target);
                    _setEnabled.Invoke(moods, new object[] { true });
                    _engineWasDisabled = true;
                    ProbeCircuitsSupport();
                    var cm = _currentMood?.GetValue(moods);
                    Mod.Log.Msg($"[royale-night] mood engine brought up (skyShader={Read(_hasSkyShader, moods)} sun={Read(_hasSunSource, moods)} volume={!(Read(_volume, moods) is null)} " +
                                $"roomMoodsEnabled={Read(_roomMoodsEnabled, moods)} currentMood={(cm is null || IsUnityNull(cm) ? "<null>" : Describe(cm))})");
                    // First apply swaps RenderSettings.skybox to
                    // MoodConfig.SkyBoxMaterial. In RRO scenes that material is
                    // not loaded (it lives in the custom-room scene's shared
                    // assets), so the skybox ends up null → black sky and the
                    // engine's HasRecRoomSkyboxShader / HasSunSource stay false
                    // (both need shader "Custom/SkyBox" on RenderSettings.skybox).
                    // Supply a material built from that shader, re-capture so
                    // the flags flip, then fall through to the real apply.
                    _applyMood.Invoke(moods, new[] { target });
                    EnsureMoodSkybox();
                    _capture.Invoke(moods, null);
                    Mod.Log.Msg($"[royale-night] re-captured (skyShader={Read(_hasSkyShader, moods)} sun={Read(_hasSunSource, moods)} skybox={DescribeSkybox()})");
                    EnsurePostProcessing(moods);
                }
                _applyMood.Invoke(moods, new[] { target });
                if (Mod.Cfg.RecRoyaleNightMatchSunLights) MatchOtherSunLights();
                if (Mod.Cfg.RecRoyaleNightDisableFog && !Mod.Cfg.RecRoyaleNightFog) ForceFogOff();
                HideObjects();
                Mod.Log.Msg($"[royale-night] applied mood '{Describe(target)}' in '{_sceneName}'");
                return true;
            }
            // restore
            if (_engineWasDisabled)
            {
                RestoreOtherSunLights();
                ShowObjects();
                RestoreFogState();
                _setEnabled?.Invoke(moods, new object[] { false }); // applies the captured "previous" data
                UninstallSceneMood(moods);
                if (_originalSkybox is not null && _renderSkybox is not null)
                    _renderSkybox.SetValue(null, _originalSkybox);
                if (_sunWasNull && _renderSun is not null)
                    _renderSun.SetValue(null, null);
                RestoreMoodPatches();
                _engineWasDisabled = false;
                _originalSkybox = null;
                _sunWasNull = false;
                Mod.Log.Msg($"[royale-night] mood engine disabled again, scene skybox/sun restored in '{_sceneName}'");
                return true;
            }
            var current = _currentMood?.GetValue(moods);
            if (current is null || IsUnityNull(current)) { Diag("no CurrentMood to restore"); return false; }
            _applyMood.Invoke(moods, new[] { current });
            Mod.Log.Msg($"[royale-night] restored scene mood '{Describe(current)}' in '{_sceneName}'");
            return true;
        }
        catch (Exception ex)
        {
            Mod.Log.Warning($"[royale-night] apply failed: {(ex.InnerException ?? ex).Message}");
            return false;
        }
    }
    private static void LogState(object moods, bool enabled)
    {
        if (_diagLogged) return;
        _diagLogged = true;
        try
        {
            var arr = GetMember(moods, "availableMoods");
            var cur = _currentMood?.GetValue(moods);
            Mod.Log.Msg($"[royale-night] engine state: isEnabled={enabled} roomMoodsEnabled={Read(_roomMoodsEnabled, moods)} " +
                        $"availableMoods={Count(arr)} currentMood={(cur is null || IsUnityNull(cur) ? "<null>" : Describe(cur))} " +
                        $"skyShader={Read(_hasSkyShader, moods)} sun={Read(_hasSunSource, moods)} volume={!(Read(_volume, moods) is null)}");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] state log failed: {ex.Message}"); }
    }
    private static object? Read(PropertyInfo? p, object o)
    {
        try { return p?.GetValue(o); } catch { return null; }
    }
    private static void Diag(string why)
    {
        if (_frame % (PollEveryFrames * 20) == 0) Mod.Log.Msg($"[royale-night] waiting: {why}");
    }
    private static bool Resolve()
    {
        _resolved = true;
        _sceneManagerType = Mod.ResolveType("RecRoomSceneManager");
        var moodSettingsType = Mod.ResolveType("RecRoom.Core.Scene.SceneMoodSettings");
        _moodSettingType = Mod.ResolveType("RecRoom.Core.Creation.SceneMoods.MoodSetting");
        if (_sceneManagerType is null || moodSettingsType is null || _moodSettingType is null)
        {
            Mod.Log.Warning($"[royale-night] types missing — sceneManager={_sceneManagerType is not null} " +
                            $"sceneMoodSettings={moodSettingsType is not null} moodSetting={_moodSettingType is not null}");
            return false;
        }
        // RecRoomSceneManager.Instance: the il2cpp getter is get_Instance but
        // the interop property name is obfuscated (PDCOCJBICGC in 2023-03-21).
        // Pick the static property whose type is RecRoomSceneManager.
        _sceneManagerInstance = AccessTools.Property(_sceneManagerType, "Instance");
        if (_sceneManagerInstance is null)
        {
            foreach (var p in _sceneManagerType.GetProperties(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static))
            {
                if (p.PropertyType == _sceneManagerType && p.CanRead && p.GetIndexParameters().Length == 0)
                { _sceneManagerInstance = p; break; }
            }
        }
        _sceneMoodSettingsField = AccessTools.Field(_sceneManagerType, "sceneMoodSettings");
        if (_sceneMoodSettingsField is null)
        {
            foreach (var p in _sceneManagerType.GetProperties(BindingFlags.Public | BindingFlags.Instance))
                if (p.PropertyType == moodSettingsType && p.CanRead) { _sceneMoodSettingsProp = p; break; }
        }
        _currentMood      = AccessTools.Property(moodSettingsType, "CurrentMood");
        _roomMoodsEnabled = AccessTools.Property(moodSettingsType, "RoomMoodsEnabled");
        _hasSkyShader     = AccessTools.Property(moodSettingsType, "HasRecRoomSkyboxShader");
        _hasSunSource     = AccessTools.Property(moodSettingsType, "HasSunSource");
        _volume           = AccessTools.Property(moodSettingsType, "Volume");
        _availableMoods   = AccessTools.Field(moodSettingsType, "availableMoods");
        _isEnabled        = AccessTools.Field(moodSettingsType, "isEnabled");
        _friendlyName     = AccessTools.Property(_moodSettingType, "FriendlyName");
        // Apply step: MLLBALMKEGJ(MoodSetting) in 2023-03-21. Fallback: the
        // only non-setter void method taking exactly one MoodSetting.
        _applyMood = AccessTools.Method(moodSettingsType, "MLLBALMKEGJ", new[] { _moodSettingType });
        if (_applyMood is null)
        {
            foreach (var m in moodSettingsType.GetMethods(BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly))
            {
                if (m.ReturnType != typeof(void) || m.Name.StartsWith("set_", StringComparison.Ordinal)) continue;
                var ps = m.GetParameters();
                if (ps.Length == 1 && ps[0].ParameterType == _moodSettingType) { _applyMood = m; break; }
            }
        }
        // SetEnabled(bool): LKIKMLNPCFK in 2023-03-21. Fallback: the only
        // public non-setter void(bool) declared on the type.
        _setEnabled = AccessTools.Method(moodSettingsType, "LKIKMLNPCFK", new[] { typeof(bool) });
        if (_setEnabled is null)
        {
            MethodInfo? only = null; int n = 0;
            foreach (var m in moodSettingsType.GetMethods(BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly))
            {
                if (m.ReturnType != typeof(void) || m.Name.StartsWith("set_", StringComparison.Ordinal)) continue;
                var ps = m.GetParameters();
                if (ps.Length == 1 && ps[0].ParameterType == typeof(bool)) { only = m; n++; }
            }
            if (n == 1) _setEnabled = only;
        }
        // Capture current scene lighting: LIEDFOLBGHL() in 2023-03-21. Too
        // many void() methods on the type to pick by shape — name only.
        _capture = AccessTools.Method(moodSettingsType, "LIEDFOLBGHL", Type.EmptyTypes);
        var renderSettings = Mod.ResolveType("UnityEngine.RenderSettings");
        _renderSkybox = renderSettings is null ? null : AccessTools.Property(renderSettings, "skybox");
        _renderSun    = renderSettings is null ? null : AccessTools.Property(renderSettings, "sun");
        _lightType    = Mod.ResolveType("UnityEngine.Light");
        // Fog preservation: FogMoodSettings() + NLDDIDEIEFH() reads
        // RenderSettings.fog/fogStartDistance/fogEndDistance/fogColor into the
        // block (ISIL FogMoodSettings.txt, called right after the ctor in
        // LIEDFOLBGHL). MoodSetting.FogSettings is the serialized reference
        // the apply step hands to the fog blender.
        _fogSettingsType = Mod.ResolveType("RecRoom.Core.Creation.SceneMoods.MoodBlendData.FogMoodSettings");
        _fogCapture = _fogSettingsType is null ? null : AccessTools.Method(_fogSettingsType, "NLDDIDEIEFH", Type.EmptyTypes);
        _moodFog    = AccessTools.Property(_moodSettingType, "FogSettings");
        _materialType     = Mod.ResolveType("UnityEngine.Material");
        _shaderType       = Mod.ResolveType("UnityEngine.Shader");
        _moodConfigHolder = Mod.ResolveType("LNMDIIFOFPD");
        _cameraDataType   = Mod.ResolveType("UnityEngine.Rendering.Universal.UniversalAdditionalCameraData");
        var ok = _sceneManagerInstance is not null
              && (_sceneMoodSettingsField is not null || _sceneMoodSettingsProp is not null)
              && _applyMood is not null;
        Mod.Log.Msg($"[royale-night] resolved: instance={_sceneManagerInstance is not null} " +
                    $"moodSettings={_sceneMoodSettingsField is not null || _sceneMoodSettingsProp is not null} " +
                    $"apply={_applyMood is not null} setEnabled={_setEnabled is not null} capture={_capture is not null} " +
                    $"isEnabled={_isEnabled is not null} currentMood={_currentMood is not null} skybox={_renderSkybox is not null} " +
                    $"sun={_renderSun is not null} light={_lightType is not null} fogCapture={_fogCapture is not null} moodFog={_moodFog is not null}");
        return ok;
    }
    // RenderSettings.sun ← the scene's directional Light when unset. Frontier
    // ships without the reference ("Sun Source reference has not been set in
    // Lighting settings" is the engine's own warning), so nothing sun-related
    // from the mood would otherwise apply.
    private static void EnsureSun()
    {
        try
        {
            if (_renderSun is null || _lightType is null) return;
            var current = _renderSun.GetValue(null);
            if (current is not null && !IsUnityNull(current))
            {
                Mod.Log.Msg($"[royale-night] RenderSettings.sun already set: '{ObjectName(current)}'");
                return;
            }
            var unityObject = Mod.ResolveType("UnityEngine.Object");
            var il2cppLight = Il2CppTypeOf(_lightType);
            if (unityObject is null || il2cppLight is null) return;
            object? directional = null;
            foreach (var m in unityObject.GetMethods(BindingFlags.Public | BindingFlags.Static))
            {
                if (m.Name != "FindObjectsOfType" || m.IsGenericMethodDefinition) continue;
                var ps = m.GetParameters();
                if (ps.Length != 1) continue;
                var arr = m.Invoke(null, new object[] { il2cppLight });
                var n = Count(arr);
                float best = -1f;
                for (int i = 0; i < n; i++)
                {
                    var item = Item(arr, i);
                    if (item is null) continue;
                    var light = AsType(item, _lightType);
                    if (light is null) continue;
                    // LightType.Directional == 1
                    var kind = GetMember(light, "type");
                    if (kind is null || Convert.ToInt32(kind) != 1) continue;
                    var intensity = GetMember(light, "intensity") is float f ? f : 0f;
                    if (intensity > best) { best = intensity; directional = light; }
                }
                break;
            }
            if (directional is null)
            {
                Mod.Log.Warning("[royale-night] no directional Light found in scene — sun direction/colour will not change");
                return;
            }
            _renderSun.SetValue(null, directional);
            _sunWasNull = true;
            Mod.Log.Msg($"[royale-night] RenderSettings.sun ← '{ObjectName(directional)}'");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] EnsureSun failed: {(ex.InnerException ?? ex).Message}"); }
    }
    // Swap the mood asset's FogSettings for a block captured from the
    // scene's current RenderSettings so applying the mood leaves fog as-is.
    // The asset is shared for the session, so RestoreFog puts the original
    // block back when we leave or toggle off.
    private static void PreserveFog(object mood)
    {
        try
        {
            if (_fogSettingsType is null || _fogCapture is null || _moodFog is null || !_moodFog.CanWrite)
            {
                Mod.Log.Warning("[royale-night] fog preservation unavailable (FogMoodSettings/NLDDIDEIEFH/FogSettings unresolved) — mood fog will apply");
                return;
            }
            if (ReferenceEquals(_fogPatchedMood, mood) && _originalFog is not null) return;
            var captured = Activator.CreateInstance(_fogSettingsType);
            if (captured is null) return;
            _fogCapture.Invoke(captured, null);
            if (Mod.Cfg.RecRoyaleNightDisableFog)
            {
                // The block has no exposed enabled flag; push it out of range so
                // even if the blender re-enables fog each frame it is invisible.
                SetMember(captured, "startDistance", 1_000_000f);
                SetMember(captured, "fadeDistance", 1_000_000f);
            }
            _originalFog = _moodFog.GetValue(mood);
            _fogPatchedMood = mood;
            _moodFog.SetValue(mood, captured);
            Mod.Log.Msg("[royale-night] mood fog replaced with the scene's own fog settings");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] PreserveFog failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static void RestoreFog()
    {
        try
        {
            if (_fogPatchedMood is not null && _originalFog is not null && _moodFog is not null && _moodFog.CanWrite)
                _moodFog.SetValue(_fogPatchedMood, _originalFog);
        }
        catch { }
        _fogPatchedMood = null;
        _originalFog = null;
    }
    private static void RestoreMoodPatches()
    {
        RestoreFog();
        RestoreDarkness();
        RestoreOtherSunLights();
        // Scene objects die with the scene; just forget them.
        _probed = false;
        _hidden.Clear();
        _hideScanned = false;
        _fogStateSaved = false;
        _origFogEnabled = null;
        // The scene's SceneMoodSettings dies with the scene; just forget it.
        _sceneMoodInstalled = false;
        _sceneMoodsObj = null;
        _origDefaultMood = _origAvailableMoods = null;
    }
    // The engine drives exactly one light: RenderSettings.sun (Frontier:
    // "SkyboxLight", the sun-disc light). The map's actual key light is a
    // separate directional Light it never touches, so daylight keeps
    // casting. Copy the engine-driven sun's rotation and colour onto every
    // other directional light and scale their intensity down. Originals are
    // kept per light and restored on toggle-off / scene change.
    private sealed class LightState
    {
        public object Light = null!;
        public object? Intensity, Color, Rotation, ShadowStrength;
    }
    private static readonly List<LightState> _otherSuns = new();
    private static void MatchOtherSunLights()
    {
        try
        {
            if (_renderSun is null || _lightType is null) return;
            var sun = _renderSun.GetValue(null);
            if (sun is null || IsUnityNull(sun)) return;
            var sunPtr = (sun as Il2CppObjectBase)?.Pointer ?? IntPtr.Zero;
            var sunTransform = GetMember(sun, "transform");
            var sunRotation = sunTransform is null ? null : GetMember(sunTransform, "rotation");
            var sunColor = GetMember(sun, "color");
            var unityObject = Mod.ResolveType("UnityEngine.Object");
            var il2cppLight = Il2CppTypeOf(_lightType);
            if (unityObject is null || il2cppLight is null) return;
            MethodInfo? findAll = null;
            foreach (var m in unityObject.GetMethods(BindingFlags.Public | BindingFlags.Static))
                if (m.Name == "FindObjectsOfType" && !m.IsGenericMethodDefinition && m.GetParameters().Length == 1) { findAll = m; break; }
            if (findAll is null) return;
            var arr = findAll.Invoke(null, new object[] { il2cppLight });
            var n = Count(arr);
            var touched = new List<string>();
            for (int i = 0; i < n; i++)
            {
                var item = Item(arr, i);
                if (item is null) continue;
                var light = AsType(item, _lightType);
                if (light is null) continue;
                var kind = GetMember(light, "type");
                if (kind is null || Convert.ToInt32(kind) != 1) continue; // Directional only
                var ptr = (light as Il2CppObjectBase)?.Pointer ?? IntPtr.Zero;
                if (ptr != IntPtr.Zero && ptr == sunPtr) continue;      // engine already drives this one
                var state = _otherSuns.Find(s => (s.Light as Il2CppObjectBase)?.Pointer == ptr);
                if (state is null)
                {
                    state = new LightState
                    {
                        Light = light,
                        Intensity = GetMember(light, "intensity"),
                        Color = GetMember(light, "color"),
                        ShadowStrength = GetMember(light, "shadowStrength"),
                        Rotation = GetMember(light, "transform") is object tr ? GetMember(tr, "rotation") : null,
                    };
                    _otherSuns.Add(state);
                }
                if (state.Intensity is float orig)
                    SetMember(light, "intensity", orig * Mod.Cfg.RecRoyaleNightSunScale);
                if (sunColor is not null) SetMember(light, "color", sunColor);
                if (sunRotation is not null && GetMember(light, "transform") is object t)
                    SetMember(t, "rotation", sunRotation);
                touched.Add(ObjectName(light));
            }
            if (touched.Count > 0 && !_otherSunsLogged)
            {
                _otherSunsLogged = true;
                Mod.Log.Msg($"[royale-night] matched {touched.Count} other directional light(s) to the mood sun: {string.Join(", ", touched)}");
            }
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] MatchOtherSunLights failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static bool _otherSunsLogged;
    // Register the mood as the scene's defaultMood + sole availableMoods entry
    // (get_CurrentMood returns availableMoods[index] when the synced index is
    // set, else defaultMood — either way our mood). Originals are kept so
    // UninstallSceneMood can put the scene back to "no room moods".
    private static object? _sceneMoodsObj;
    private static object? _origDefaultMood, _origAvailableMoods;
    private static bool _sceneMoodInstalled;
    private static void InstallSceneMood(object moods, object mood)
    {
        try
        {
            if (_sceneMoodInstalled && ReferenceEquals(_sceneMoodsObj, moods)) return;
            _sceneMoodsObj = moods;
            _origDefaultMood = GetMember(moods, "defaultMood");
            _origAvailableMoods = GetMember(moods, "availableMoods");
            var okDefault = SetMember(moods, "defaultMood", mood);
            // availableMoods is an Il2CppReferenceArray<MoodSetting>; build a
            // one-element array of the same interop type and fill slot 0.
            var okArray = false;
            var arrProp = moods.GetType().GetProperty("availableMoods", Any);
            var arrType = arrProp?.PropertyType ?? _origAvailableMoods?.GetType();
            if (arrType is not null)
            {
                object? arr = null;
                foreach (var sig in new[] { new[] { typeof(long) }, new[] { typeof(int) } })
                {
                    var ctor = arrType.GetConstructor(sig);
                    if (ctor is null) continue;
                    try { arr = ctor.Invoke(new object[] { sig[0] == typeof(long) ? 1L : 1 }); break; } catch { }
                }
                if (arr is not null)
                {
                    var set = arrType.GetMethod("set_Item", new[] { typeof(int), _moodSettingType! });
                    if (set is null)
                    {
                        foreach (var m in arrType.GetMethods())
                            if (m.Name == "set_Item" && m.GetParameters().Length == 2 && m.GetParameters()[0].ParameterType == typeof(int)) { set = m; break; }
                    }
                    try { set?.Invoke(arr, new[] { 0, mood }); okArray = set is not null && SetMember(moods, "availableMoods", arr); } catch { }
                }
            }
            _sceneMoodInstalled = okDefault || okArray;
            Mod.Log.Msg($"[royale-night] installed mood as scene default (defaultMood={okDefault} availableMoods={okArray})");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] InstallSceneMood failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static void UninstallSceneMood(object moods)
    {
        try
        {
            if (!_sceneMoodInstalled) return;
            if (_origDefaultMood is not null) SetMember(moods, "defaultMood", _origDefaultMood);
            else SetMember(moods, "defaultMood", null!);
            if (_origAvailableMoods is not null) SetMember(moods, "availableMoods", _origAvailableMoods);
        }
        catch { }
        _sceneMoodInstalled = false;
        _sceneMoodsObj = null;
        _origDefaultMood = _origAvailableMoods = null;
    }
    // ── fog off / hide objects ────────────────────────────────────────
    private static bool _fogStateSaved;
    private static object? _origFogEnabled;
    private static Type? _renderSettingsType;
    private static void ForceFogOff()
    {
        try
        {
            _renderSettingsType ??= Mod.ResolveType("UnityEngine.RenderSettings");
            if (_renderSettingsType is null) return;
            var p = _renderSettingsType.GetProperty("fog", BindingFlags.Public | BindingFlags.Static);
            if (p is null) return;
            if (!_fogStateSaved) { _origFogEnabled = p.GetValue(null); _fogStateSaved = true; }
            if (p.GetValue(null) is true) p.SetValue(null, false);
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] ForceFogOff failed: {ex.Message}"); }
    }
    private static void RestoreFogState()
    {
        try
        {
            if (_fogStateSaved && _renderSettingsType is not null && _origFogEnabled is bool b)
                _renderSettingsType.GetProperty("fog", BindingFlags.Public | BindingFlags.Static)?.SetValue(null, b);
        }
        catch { }
        _fogStateSaved = false;
        _origFogEnabled = null;
    }
    // Disable every Renderer whose GameObject or material name contains one
    // of Cfg.RecRoyaleNightHideObjects. Runs each apply cycle but only scans
    // once per scene (the matches are static scenery); ShowObjects re-enables.
    private static readonly List<object> _hidden = new();
    private static bool _hideScanned;
    private static void HideObjects()
    {
        if (_hideScanned) return;
        _hideScanned = true;
        try
        {
            var patterns = new List<string>();
            foreach (var s in Mod.Cfg.RecRoyaleNightHideObjects)
                if (!string.IsNullOrWhiteSpace(s)) patterns.Add(s.Trim());
            if (patterns.Count == 0) return;
            var rendererType = Mod.ResolveType("UnityEngine.Renderer");
            var unityObject = Mod.ResolveType("UnityEngine.Object");
            var il2cppRenderer = rendererType is null ? null : Il2CppTypeOf(rendererType);
            if (rendererType is null || unityObject is null || il2cppRenderer is null) return;
            MethodInfo? findAll = null;
            foreach (var m in unityObject.GetMethods(BindingFlags.Public | BindingFlags.Static))
                if (m.Name == "FindObjectsOfType" && !m.IsGenericMethodDefinition && m.GetParameters().Length == 1) { findAll = m; break; }
            if (findAll is null) return;
            var arr = findAll.Invoke(null, new object[] { il2cppRenderer });
            var n = Count(arr);
            var names = new HashSet<string>();
            for (int i = 0; i < n; i++)
            {
                var item = Item(arr, i);
                if (item is null) continue;
                var r = AsType(item, rendererType);
                if (r is null) continue;
                var name = ObjectName(r);
                var matName = "";
                try { var mat = GetMember(r, "sharedMaterial"); if (mat is not null && !IsUnityNull(mat)) matName = ObjectName(mat); } catch { }
                var hit = false;
                foreach (var p in patterns)
                    if (name.Contains(p, StringComparison.OrdinalIgnoreCase) || matName.Contains(p, StringComparison.OrdinalIgnoreCase)) { hit = true; break; }
                if (!hit) continue;
                if (GetMember(r, "enabled") is true && SetMember(r, "enabled", false))
                {
                    _hidden.Add(r);
                    names.Add(name);
                }
            }
            Mod.Log.Msg($"[royale-night] hid {_hidden.Count} renderer(s) matching [{string.Join(",", patterns)}]: {string.Join(", ", names)}");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] HideObjects failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static void ShowObjects()
    {
        foreach (var r in _hidden)
        {
            try { if (!IsUnityNull(r)) SetMember(r, "enabled", true); } catch { }
        }
        _hidden.Clear();
        _hideScanned = false;
    }
    // ── CV2 room-settings probe ───────────────────────────────────────
    // The Maker Pen mood chips ("Skydome Constant", "Room Skydome Modify",
    // Sun/Fog/Background Objects equivalents) drive RoomSkydome / RoomSun /
    // RoomFog components that hang off RoomElementSettingsManager, which
    // CircuitsV2Manager brings up. Log whether any of that exists in this
    // scene so we know what a chips-in-Rec-Royale build would have to add.
    private static bool _probed;
    private static void ProbeCircuitsSupport()
    {
        if (_probed) return;
        _probed = true;
        try
        {
            var unityObject = Mod.ResolveType("UnityEngine.Object");
            if (unityObject is null) return;
            MethodInfo? findAll = null;
            foreach (var m in unityObject.GetMethods(BindingFlags.Public | BindingFlags.Static))
                if (m.Name == "FindObjectsOfType" && !m.IsGenericMethodDefinition && m.GetParameters().Length == 1) { findAll = m; break; }
            if (findAll is null) return;
            var parts = new List<string>();
            foreach (var name in new[]
            {
                "RecRoom.CircuitsV2.CircuitsV2Manager",
                "RecRoom.CircuitsV2.RoomSettings.RoomElementSettingsManager",
                "RecRoom.CircuitsV2.RoomSettings.RoomSkydome",
                "RecRoom.CircuitsV2.RoomSettings.RoomSun",
                "RecRoom.CircuitsV2.RoomSettings.RoomFog",
                "RecRoom.CircuitsV2.RoomSettings.RoomBackgroundObjects",
                "MakerPen",
            })
            {
                var t = Mod.ResolveType(name);
                if (t is null) { parts.Add($"{name.Substring(name.LastIndexOf('.') + 1)}=<type missing>"); continue; }
                var il2 = Il2CppTypeOf(t);
                if (il2 is null) { parts.Add($"{t.Name}=?"); continue; }
                int n = 0;
                try { n = Count(findAll.Invoke(null, new object[] { il2 })); } catch (Exception ex) { parts.Add($"{t.Name}=err:{(ex.InnerException ?? ex).Message}"); continue; }
                parts.Add($"{t.Name}={n}");
            }
            Mod.Log.Msg($"[royale-night] CV2 probe in '{_sceneName}': {string.Join(" ", parts)}");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] CV2 probe failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static void RestoreOtherSunLights()
    {
        foreach (var s in _otherSuns)
        {
            try
            {
                if (IsUnityNull(s.Light)) continue;
                if (s.Intensity is not null) SetMember(s.Light, "intensity", s.Intensity);
                if (s.Color is not null) SetMember(s.Light, "color", s.Color);
                if (s.ShadowStrength is not null) SetMember(s.Light, "shadowStrength", s.ShadowStrength);
                if (s.Rotation is not null && GetMember(s.Light, "transform") is object t) SetMember(t, "rotation", s.Rotation);
            }
            catch { }
        }
        _otherSuns.Clear();
        _otherSunsLogged = false;
    }
    // Make sure RenderSettings.skybox is a material on the "Custom/SkyBox"
    // shader. The apply step assigns MoodConfig.SkyBoxMaterial
    // (LNMDIIFOFPD.NHAEHKJINFH → SkyBoxMaterial); in RRO scenes that
    // reference resolves to nothing, leaving the skybox null. Prefer any
    // already-loaded material on that shader, else create one, and also
    // write it into MoodConfig so later applies keep using it.
    private static void EnsureMoodSkybox()
    {
        try
        {
            if (_renderSkybox is null || _materialType is null || _shaderType is null) return;
            var current = _renderSkybox.GetValue(null);
            var currentShader = current is null || IsUnityNull(current) ? "" : ShaderNameOf(current);
            if (currentShader == "Custom/SkyBox") return;
            object? mat = _ourSkybox is not null && !IsUnityNull(_ourSkybox) ? _ourSkybox : null;
            // 1. Any loaded material already on the shader (e.g. the real
            //    Skybox_Moods_Sunny_Default_Mat if some scene brought it in).
            if (mat is null)
            {
                var resources = Mod.ResolveType("UnityEngine.Resources");
                var il2cppMat = Il2CppTypeOf(_materialType);
                if (resources is not null && il2cppMat is not null)
                {
                    foreach (var m in resources.GetMethods(BindingFlags.Public | BindingFlags.Static))
                    {
                        if (m.Name != "FindObjectsOfTypeAll" || m.IsGenericMethodDefinition || m.GetParameters().Length != 1) continue;
                        var arr = m.Invoke(null, new object[] { il2cppMat });
                        var n = Count(arr);
                        for (int i = 0; i < n; i++)
                        {
                            var item = Item(arr, i);
                            if (item is null) continue;
                            var wrapped = AsType(item, _materialType);
                            if (wrapped is not null && ShaderNameOf(wrapped) == "Custom/SkyBox") { mat = wrapped; break; }
                        }
                        break;
                    }
                }
                if (mat is not null) Mod.Log.Msg($"[royale-night] using loaded skybox material '{ObjectName(mat)}'");
            }
            // 2. Build one: new Material(Shader.Find("Custom/SkyBox")).
            if (mat is null)
            {
                var find = AccessTools.Method(_shaderType, "Find", new[] { typeof(string) });
                var shader = find?.Invoke(null, new object[] { "Custom/SkyBox" });
                if (shader is null || IsUnityNull(shader))
                {
                    Mod.Log.Warning("[royale-night] Shader.Find(\"Custom/SkyBox\") returned nothing — sky colours will not apply");
                    return;
                }
                var ctor = _materialType.GetConstructor(new[] { _shaderType }) ?? _materialType.GetConstructor(new[] { shader.GetType() });
                if (ctor is null)
                {
                    Mod.Log.Warning("[royale-night] Material(Shader) constructor not found");
                    return;
                }
                mat = ctor.Invoke(new[] { shader });
                SetMember(mat, "name", "DorkNet_RecRoyaleNight_Skybox");
                Mod.Log.Msg("[royale-night] created skybox material on Custom/SkyBox");
            }
            _ourSkybox = mat;
            _renderSkybox.SetValue(null, mat);
            // Keep the engine's own apply path pointing at it too.
            if (_moodConfigHolder is not null)
            {
                foreach (var p in _moodConfigHolder.GetProperties(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static))
                {
                    if (!p.CanRead || p.GetIndexParameters().Length != 0) continue;
                    var cfg = p.GetValue(null);
                    if (cfg is null || IsUnityNull(cfg)) continue;
                    if (SetMember(cfg, "SkyBoxMaterial", mat)) Mod.Log.Msg("[royale-night] MoodConfig.SkyBoxMaterial ← our material");
                    break;
                }
            }
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] EnsureMoodSkybox failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static string ShaderNameOf(object material)
    {
        try
        {
            var shader = GetMember(material, "shader");
            return shader is null || IsUnityNull(shader) ? "" : ObjectName(shader);
        }
        catch { return ""; }
    }
    private static string DescribeSkybox()
    {
        try
        {
            var sky = _renderSkybox?.GetValue(null);
            if (sky is null || IsUnityNull(sky)) return "<null>";
            return $"'{ObjectName(sky)}' [{ShaderNameOf(sky)}]";
        }
        catch { return "?"; }
    }
    // Post-exposure lives in the URP Volume the mood engine drives. It only
    // shows if the Volume is enabled with weight and the camera renders
    // post-processing (Rec Room's graphics settings can turn that off).
    private static void EnsurePostProcessing(object moods)
    {
        try
        {
            var volume = Read(_volume, moods);
            if (volume is not null && !IsUnityNull(volume))
            {
                var enabled = GetMember(volume, "enabled");
                var weight = GetMember(volume, "weight");
                var isGlobal = GetMember(volume, "isGlobal");
                var profile = GetMember(volume, "profile");
                Mod.Log.Msg($"[royale-night] volume: enabled={enabled} weight={weight} global={isGlobal} profile={(profile is null ? "<null>" : ObjectName(profile))}");
                if (Mod.Cfg.RecRoyaleNightForcePostProcessing)
                {
                    if (enabled is false) SetMember(volume, "enabled", true);
                    if (weight is float w && w < 1f) SetMember(volume, "weight", 1f);
                }
            }
            else Mod.Log.Warning("[royale-night] scene mood Volume is null — post-exposure darkening unavailable");
            if (_cameraDataType is null) { Mod.Log.Warning("[royale-night] UniversalAdditionalCameraData type not found"); return; }
            var unityObject = Mod.ResolveType("UnityEngine.Object");
            var il2cppCam = Il2CppTypeOf(_cameraDataType);
            if (unityObject is null || il2cppCam is null) return;
            foreach (var m in unityObject.GetMethods(BindingFlags.Public | BindingFlags.Static))
            {
                if (m.Name != "FindObjectsOfType" || m.IsGenericMethodDefinition || m.GetParameters().Length != 1) continue;
                var arr = m.Invoke(null, new object[] { il2cppCam });
                var n = Count(arr);
                int forced = 0;
                var states = new List<string>();
                for (int i = 0; i < n; i++)
                {
                    var item = Item(arr, i);
                    if (item is null) continue;
                    var cam = AsType(item, _cameraDataType);
                    if (cam is null) continue;
                    var pp = GetMember(cam, "renderPostProcessing");
                    states.Add($"{ObjectName(cam)}={pp}");
                    if (pp is false && Mod.Cfg.RecRoyaleNightForcePostProcessing && SetMember(cam, "renderPostProcessing", true)) forced++;
                }
                Mod.Log.Msg($"[royale-night] camera post-processing: {string.Join(", ", states)}{(forced > 0 ? $" → forced on ({forced})" : "")}");
                break;
            }
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] EnsurePostProcessing failed: {(ex.InnerException ?? ex).Message}"); }
    }
    // Darken the mood data in place before it is applied:
    //   ColorGradingSettings.exposure   += RecRoyaleNightExposure  (EV; the
    //       ColorGrading blender writes it into ColorAdjustments.postExposure
    //       via VolumeParameter.Override — the only knob that also dims baked
    //       lightmaps, since it's a full-frame post effect)
    //   SunSettings.sunIntensity        *= RecRoyaleNightSunScale
    //   SkyBoxSettings.ambientLightIntensity *= RecRoyaleNightAmbientScale
    // Originals are kept and restored by RestoreDarkness so the shared asset
    // is clean again for any custom room that uses the same mood.
    private static void PatchDarkness(object mood)
    {
        try
        {
            if (ReferenceEquals(_darkPatchedMood, mood)) return;
            RestoreDarkness();
            var grading = GetMember(mood, "ColorGradingSettings");
            var sun     = GetMember(mood, "SunSettings");
            var sky     = GetMember(mood, "SkyBoxSettings");
            if (grading is not null && Mod.Cfg.RecRoyaleNightExposure != 0f && GetMember(grading, "exposure") is float ev)
            {
                _origExposure = ev;
                SetMember(grading, "exposure", ev + Mod.Cfg.RecRoyaleNightExposure);
            }
            if (sun is not null && Mod.Cfg.RecRoyaleNightSunScale != 1f && GetMember(sun, "sunIntensity") is float si)
            {
                _origSunIntensity = si;
                SetMember(sun, "sunIntensity", si * Mod.Cfg.RecRoyaleNightSunScale);
            }
            if (sky is not null && Mod.Cfg.RecRoyaleNightAmbientScale != 1f && GetMember(sky, "ambientLightIntensity") is float ai)
            {
                _origAmbient = ai;
                SetMember(sky, "ambientLightIntensity", ai * Mod.Cfg.RecRoyaleNightAmbientScale);
            }
            _darkPatchedMood = mood;
            Mod.Log.Msg($"[royale-night] darkened mood: exposure {_origExposure?.ToString("0.##") ?? "?"}→{(_origExposure + Mod.Cfg.RecRoyaleNightExposure)?.ToString("0.##") ?? "?"} EV, " +
                        $"sun ×{Mod.Cfg.RecRoyaleNightSunScale} ({_origSunIntensity?.ToString("0.##") ?? "?"}), ambient ×{Mod.Cfg.RecRoyaleNightAmbientScale} ({_origAmbient?.ToString("0.##") ?? "?"})");
        }
        catch (Exception ex) { Mod.Log.Warning($"[royale-night] PatchDarkness failed: {(ex.InnerException ?? ex).Message}"); }
    }
    private static void RestoreDarkness()
    {
        try
        {
            if (_darkPatchedMood is not null)
            {
                var grading = GetMember(_darkPatchedMood, "ColorGradingSettings");
                var sun     = GetMember(_darkPatchedMood, "SunSettings");
                var sky     = GetMember(_darkPatchedMood, "SkyBoxSettings");
                if (grading is not null && _origExposure is float e) SetMember(grading, "exposure", e);
                if (sun is not null && _origSunIntensity is float s) SetMember(sun, "sunIntensity", s);
                if (sky is not null && _origAmbient is float a) SetMember(sky, "ambientLightIntensity", a);
            }
        }
        catch { }
        _darkPatchedMood = null;
        _origExposure = _origSunIntensity = _origAmbient = null;
    }
    private static bool SetMember(object o, string name, object value)
    {
        var t = o.GetType();
        var p = t.GetProperty(name, Any);
        if (p is not null && p.CanWrite) { try { p.SetValue(o, value); return true; } catch { } }
        var f = t.GetField(name, Any);
        if (f is not null) { try { f.SetValue(o, value); return true; } catch { } }
        return false;
    }
    // Il2CppInterop exposes il2cpp fields as properties (and, on some
    // versions, as fields). Read either.
    private static object? GetMember(object o, string name)
    {
        var t = o.GetType();
        var p = t.GetProperty(name, Any);
        if (p is not null && p.CanRead && p.GetIndexParameters().Length == 0)
        { try { return p.GetValue(o); } catch { } }
        var f = t.GetField(name, Any);
        if (f is not null) { try { return f.GetValue(o); } catch { } }
        return null;
    }
    // Il2CppType.From(Type) → Il2CppSystem.Type, via reflection so this
    // project keeps not referencing Il2Cppmscorlib at compile time.
    private static object? Il2CppTypeOf(Type type)
    {
        foreach (var m in typeof(Il2CppType).GetMethods(BindingFlags.Public | BindingFlags.Static))
        {
            if (m.Name != "From" || m.IsGenericMethodDefinition) continue;
            var ps = m.GetParameters();
            if (ps.Length >= 1 && ps[0].ParameterType == typeof(Type))
            {
                var args = new object?[ps.Length];
                args[0] = type;
                for (int i = 1; i < ps.Length; i++) args[i] = ps[i].HasDefaultValue ? ps[i].DefaultValue : (ps[i].ParameterType.IsValueType ? Activator.CreateInstance(ps[i].ParameterType) : null);
                var r = m.Invoke(null, args);
                if (r is not null) return r;
            }
        }
        return null;
    }
    private static object? GetSceneManager()
    {
        var inst = _sceneManagerInstance?.GetValue(null);
        if (inst is null || IsUnityNull(inst)) return null;
        return inst;
    }
    // Loads the configured MoodSetting asset. Resources.Load(path, Type)
    // pulls it out of resources.assets by name (the ResourceManager table
    // keys are the lower-cased asset names, no folder). Fallback:
    // Resources.FindObjectsOfTypeAll(MoodSetting) by name, which only sees
    // assets already in memory.
    private static object? GetNightMood()
    {
        var wanted = (Mod.Cfg.RecRoyaleNightMood ?? "").Trim();
        if (wanted.Length == 0) wanted = "Night_Calm_Outdoor_Mood";
        if (_nightMood is not null && _nightMoodLoadedName == wanted && !IsUnityNull(_nightMood))
            return _nightMood;
        _nightMood = null;
        var resources = Mod.ResolveType("UnityEngine.Resources");
        if (resources is null || _moodSettingType is null)
        {
            Mod.Log.Warning("[royale-night] UnityEngine.Resources not found");
            return null;
        }
        var il2cppType = Il2CppTypeOf(_moodSettingType);
        if (il2cppType is null)
        {
            Mod.Log.Warning("[royale-night] Il2CppType.From(Type) not found");
            return null;
        }
        object? found = null;
        foreach (var m in resources.GetMethods(BindingFlags.Public | BindingFlags.Static))
        {
            if (m.Name != "Load" || m.IsGenericMethodDefinition) continue;
            var ps = m.GetParameters();
            if (ps.Length != 2 || ps[0].ParameterType != typeof(string)) continue;
            try
            {
                found = m.Invoke(null, new object[] { wanted, il2cppType });
                if (found is not null && !IsUnityNull(found)) break;
                found = null;
            }
            catch (Exception ex) { Mod.Log.Warning($"[royale-night] Resources.Load failed: {(ex.InnerException ?? ex).Message}"); }
        }
        if (found is null)
        {
            foreach (var m in resources.GetMethods(BindingFlags.Public | BindingFlags.Static))
            {
                if (m.Name != "FindObjectsOfTypeAll" || m.IsGenericMethodDefinition) continue;
                var ps = m.GetParameters();
                if (ps.Length != 1) continue;
                try
                {
                    var arr = m.Invoke(null, new object[] { il2cppType });
                    var n = Count(arr);
                    var names = new List<string>();
                    for (int i = 0; i < n; i++)
                    {
                        var item = Item(arr, i);
                        if (item is null) continue;
                        var name = ObjectName(item);
                        names.Add(name);
                        if (string.Equals(name, wanted, StringComparison.OrdinalIgnoreCase)) { found = item; break; }
                    }
                    if (found is null)
                        Mod.Log.Warning($"[royale-night] mood '{wanted}' not in memory; loaded moods: {string.Join(", ", names)}");
                }
                catch (Exception ex) { Mod.Log.Warning($"[royale-night] FindObjectsOfTypeAll failed: {(ex.InnerException ?? ex).Message}"); }
                break;
            }
        }
        if (found is null)
        {
            Mod.Log.Warning($"[royale-night] could not load MoodSetting '{wanted}'");
            return null;
        }
        // Resources.Load hands back a UnityEngine.Object wrapper; re-wrap the
        // same il2cpp pointer as MoodSetting so the apply method accepts it.
        _nightMood = AsType(found, _moodSettingType);
        _nightMoodLoadedName = wanted;
        return _nightMood;
    }
    private static object? AsType(object obj, Type target)
    {
        if (target.IsInstanceOfType(obj)) return obj;
        if (obj is Il2CppObjectBase il2cpp)
        {
            var ctor = target.GetConstructor(new[] { typeof(IntPtr) });
            if (ctor is not null) return ctor.Invoke(new object[] { il2cpp.Pointer });
        }
        return obj;
    }
    // ── hotkey ────────────────────────────────────────────────────────
    private static void PollHotkey()
    {
        var key = Mod.Cfg.RecRoyaleNightToggleKey;
        if (string.IsNullOrWhiteSpace(key)) return;
        try
        {
            if (!_inputResolved) ResolveInput(key);
            if (_getKeyDown is null || _toggleKey is null) return;
            if (_getKeyDown.Invoke(null, new[] { _toggleKey }) is true) Toggle();
        }
        catch (Exception ex)
        {
            Mod.Log.Warning($"[royale-night] hotkey poll failed: {ex.Message}");
            _getKeyDown = null; // stop spamming
        }
    }
    private static void ResolveInput(string key)
    {
        _inputResolved = true;
        var keyCodeType = Mod.ResolveType("UnityEngine.KeyCode");
        var inputType = Mod.ResolveType("UnityEngine.Input");
        if (keyCodeType is null || inputType is null)
        {
            Mod.Log.Warning("[royale-night] UnityEngine.Input/KeyCode not found — hotkey disabled");
            return;
        }
        try { _toggleKey = Enum.Parse(keyCodeType, key, ignoreCase: true); }
        catch
        {
            Mod.Log.Warning($"[royale-night] '{key}' is not a UnityEngine.KeyCode — hotkey disabled");
            return;
        }
        _getKeyDown = AccessTools.Method(inputType, "GetKeyDown", new[] { keyCodeType });
        if (_getKeyDown is null) Mod.Log.Warning("[royale-night] Input.GetKeyDown(KeyCode) not found — hotkey disabled");
    }
    // ── helpers ───────────────────────────────────────────────────────
    private static bool MatchesScene(string sceneName)
    {
        if (string.IsNullOrEmpty(sceneName)) return false;
        foreach (var s in Mod.Cfg.RecRoyaleNightScenes)
        {
            if (string.IsNullOrWhiteSpace(s)) continue;
            if (sceneName.Contains(s.Trim(), StringComparison.OrdinalIgnoreCase)) return true;
        }
        return false;
    }
    // UnityEngine.Object wrappers are non-null C# objects even when the
    // native object is destroyed/missing; `== null` is overloaded in the
    // interop, so route through the static op_Equality when present.
    private static bool IsUnityNull(object obj)
    {
        try
        {
            var t = obj.GetType();
            var eq = t.GetMethod("op_Equality", BindingFlags.Public | BindingFlags.Static | BindingFlags.FlattenHierarchy);
            if (eq is not null && eq.GetParameters().Length == 2)
                return eq.Invoke(null, new[] { obj, null }) is true;
        }
        catch { }
        return false;
    }
    private static string ObjectName(object obj)
    {
        try
        {
            var p = obj.GetType().GetProperty("name", Any);
            return p?.GetValue(obj) as string ?? "";
        }
        catch { return ""; }
    }
    private static string Describe(object mood)
    {
        var friendly = "";
        try { friendly = _friendlyName?.GetValue(mood) as string ?? ""; } catch { }
        var name = ObjectName(mood);
        return friendly.Length > 0 ? $"{friendly} ({name})" : name;
    }
    private static int Count(object? arr)
    {
        if (arr is null) return 0;
        if (arr is Array a) return a.Length;
        var p = arr.GetType().GetProperty("Length") ?? arr.GetType().GetProperty("Count");
        return (p?.GetValue(arr) as int?) ?? 0;
    }
    private static object? Item(object? arr, int i)
    {
        if (arr is null) return null;
        if (arr is Array a) return a.GetValue(i);
        var gi = arr.GetType().GetMethod("get_Item", new[] { typeof(int) });
        return gi?.Invoke(arr, new object[] { i });
    }
 }
@@ -1,28 +0,0 @@
 {
  "ServerHost": "{HOST}",
  "EnableTlsTrustBypass": {ENABLE_TLS_TRUST_BYPASS},
  "EnableDebugConsole": false,
  "DebugConsoleToggleKey": "BackQuote",
  "DevCommands": [],
  "QuestMaxTeamSize": 0,
  "QuestMaxTeamSizeRooms": [
    "CrimsonCauldron",
    "Crescendo",
    "GoldenTrophy",
    "IsleOfLostSkulls",
    "TheRiseofJumbotron"
  ],
  "RecRoyaleNightMode": false,
  "RecRoyaleNightMood": "Night_Calm_Outdoor_Mood",
  "RecRoyaleNightScenes": ["RecRoyale"],
  "RecRoyaleNightFlashlights": true,
  "RecRoyaleNightFog": false,
  "RecRoyaleNightExposure": -3.5,
  "RecRoyaleNightSunScale": 0.15,
  "RecRoyaleNightAmbientScale": 0.2,
  "RecRoyaleNightForcePostProcessing": true,
  "RecRoyaleNightMatchSunLights": true,
  "RecRoyaleNightDisableFog": false,
  "RecRoyaleNightHideObjects": ["Cloud"],
  "RecRoyaleNightToggleKey": ""
 }
@@ -1 +0,0 @@
 471710
@@ -1,9 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
 </Project>
@@ -1,309 +0,0 @@
 namespace DorkNet.Contracts;
 public static class DorkNetRouteOwnership
 {
    private const string AdminHost = "admin";
    private static readonly DorkNetRouteGroup[] ServiceRouteGroups =
    [
        new(
            ServiceNames.Identity,
            ["auth", "accounts"],
            [
                "/.well-known",
                "/account",
                "/api/account",
                "/api/auth",
                "/api/createaccount",
                "/api/platformlogin",
                "/api/playerreputation",
                "/api/players",
                "/api/relationships",
                "/api/settings",
                "/cachedlogin",
                "/connect",
                "/eac",
                "/parentalcontrol",
                "/photon",
                "/profileimage",
                "/settings",
            ]),
        new(
            ServiceNames.Rooms,
            ["rooms", "match", "discovery", "lists", "roomcomments", "roomieintegrations", "studio"],
            [
                "/api/activities",
                "/api/curatedroomplaylists",
                "/api/gameconfigs",
                "/api/gameconfigurations",
                "/api/gamesessions",
                "/api/leaderboard",
                "/api/playerelo",
                "/api/playlists",
                "/api/roomkeys",
                "/api/rooms",
                "/api/royale",
                "/discover",
                "/featuredrooms",
                "/goto",
                // 2023 clients renamed the whole goto/* matchmaking surface
                // to matchmake/* (matchmake/room, /instance, /invite,
                // /chatinvite, …). Same controller as /goto, so it belongs
                // to the match service; without this it fell through to the
                // Monolith default owner.
                "/matchmake",
                "/hot_rooms",
                "/hot_roomsandplaylists",
                "/invite",
                "/playlists",
                "/player",
                "/room",
                "/roominstance",
                "/rooms",
                "/roomsandplaylists",
                "/roomserver",
                "/search_rooms",
                "/search_roomsandplaylists",
                "/v1/find",
                "/v1/join",
                "/v1/leave",
                "/v1/session",
            ]),
        new(
            ServiceNames.Notify,
            ["notify", "chat", "platformnotifications"],
            [
                "/api/messages",
                "/api/notification",
                "/api/offlineinvite",
                "/hub",
                "/notify",
                "/thread",
            ]),
        new(
            ServiceNames.Content,
            ["cdn", "data", "img", "storage", "strings-cdn", "videos"],
            [
                "/api/images",
                "/api/photos",
                "/config",
                "/data",
                "/img",
                "/invention",
                "/upload",
                "/video",
            ]),
        new(
            ServiceNames.Social,
            ["clubs"],
            [
                "/announcements",
                "/api/announcement",
                "/api/clubreporting",
                "/api/communityboard",
                "/api/groups",
                "/api/playercheer",
                "/api/playerevents",
                "/api/playersubscriptions",
                "/club",
                "/members",
                "/subscription",
            ]),
        new(
            ServiceNames.Commerce,
            ["commerce", "econ"],
            [
                "/api/avatar",
                "/api/catalog",
                "/api/compatibility",
                "/api/consumables",
                "/api/equipment",
                "/api/gamerewards",
                "/api/inventions",
                "/api/purchase",
                "/api/roomconsumables",
                "/api/roomcurrencies",
                "/api/storefronts",
                "/commerce",
                "/econ",
                "/purchase",
                "/purchasecampaign",
                "/reminder",
            ]),
        new(
            ServiceNames.Platform,
            ["cards", "cms", "datacollection", "gamelogs", "geo", "leaderboard", "link", "ns", "playersettings", "strings", "thorn"],
            [
                "/api/cards",
                "/api/config",
                "/api/events",
                "/api/quickplay",
                "/api/role",
                "/api/version",
                "/api/versioncheck",
                "/motd",
                "/pageview",
                "/ping",
                "/role",
                "/strings",
                "/v1/ping",
                "/v1/player",
                "/v1/regions",
                "/v1/services",
            ]),
        new(
            ServiceNames.Moderation,
            ["bugreporting", "moderation"],
            [
                "/api/admin",
                "/api/banappeal",
                "/api/bugreporting",
                "/api/moderation",
                "/api/playerreporting",
                "/api/playersbanned",
                "/api/sanitize",
                "/api/testcasemanagement",
            ]),
        new(
            ServiceNames.Web,
            ["www", AdminHost, "feed"],
            [
                "/api/site",
            ],
            IncludesApexHost: true),
    ];
    public static IReadOnlyList<DorkNetRouteGroup> RouteGroups => ServiceRouteGroups;
    public static bool IsInfrastructurePath(string path)
    {
        return path.Equals("/healthz", StringComparison.OrdinalIgnoreCase)
            || path.StartsWith("/internal/", StringComparison.OrdinalIgnoreCase);
    }
    public static string ResolvePublicService(string? host, string path, string apexDomain)
    {
        var normalizedPath = NormalizePath(path);
        var subdomain = Subdomain(host, apexDomain);
        if (string.Equals(subdomain, AdminHost, StringComparison.OrdinalIgnoreCase))
        {
            return ServiceNames.Web;
        }
        foreach (var group in ServiceRouteGroups.Where(group => group.ServiceName != ServiceNames.Web))
        {
            if (MatchesHost(subdomain, group.HostSubdomains))
            {
                return group.ServiceName;
            }
        }
        foreach (var group in ServiceRouteGroups)
        {
            if (StartsWithAny(normalizedPath, group.PathPrefixes))
            {
                return group.ServiceName;
            }
        }
        var web = ServiceRouteGroups.First(group => group.ServiceName == ServiceNames.Web);
        if ((subdomain is null && web.IncludesApexHost) || MatchesHost(subdomain, web.HostSubdomains))
        {
            return ServiceNames.Web;
        }
        return ServiceNames.Monolith;
    }
    public static bool IsOwnedBy(string serviceName, string? host, string path, string apexDomain)
    {
        if (IsInfrastructurePath(path))
        {
            return true;
        }
        return string.Equals(
            ResolvePublicService(host, path, apexDomain),
            serviceName,
            StringComparison.OrdinalIgnoreCase);
    }
    public static string? Subdomain(string? host, string apexDomain)
    {
        if (string.IsNullOrWhiteSpace(host))
        {
            return null;
        }
        var normalizedHost = host.Split(':', 2)[0].Trim().ToLowerInvariant();
        var normalizedApex = apexDomain.Split(':', 2)[0].Trim().ToLowerInvariant();
        if (string.IsNullOrWhiteSpace(normalizedHost)
            || string.IsNullOrWhiteSpace(normalizedApex)
            || string.Equals(normalizedHost, normalizedApex, StringComparison.OrdinalIgnoreCase))
        {
            return null;
        }
        var suffix = "." + normalizedApex;
        if (normalizedHost.EndsWith(suffix, StringComparison.OrdinalIgnoreCase))
        {
            return normalizedHost[..^suffix.Length];
        }
        var dot = normalizedHost.IndexOf('.');
        return dot > 0 ? normalizedHost[..dot] : null;
    }
    private static bool StartsWithAny(string path, IEnumerable<string> prefixes)
    {
        foreach (var prefix in prefixes)
        {
            if (StartsWithPathSegment(path, prefix))
            {
                return true;
            }
        }
        return false;
    }
    private static bool StartsWithPathSegment(string path, string prefix)
    {
        var normalizedPath = NormalizePath(path);
        var normalizedPrefix = NormalizePath(prefix).TrimEnd('/');
        if (string.IsNullOrWhiteSpace(normalizedPrefix))
        {
            normalizedPrefix = "/";
        }
        return normalizedPath.Equals(normalizedPrefix, StringComparison.OrdinalIgnoreCase)
            || normalizedPath.StartsWith(normalizedPrefix + "/", StringComparison.OrdinalIgnoreCase);
    }
    private static bool MatchesHost(string? subdomain, IEnumerable<string> candidates)
    {
        if (string.IsNullOrWhiteSpace(subdomain))
        {
            return false;
        }
        return candidates.Contains(subdomain, StringComparer.OrdinalIgnoreCase);
    }
    private static string NormalizePath(string path)
    {
        if (string.IsNullOrWhiteSpace(path))
        {
            return "/";
        }
        return path[0] == '/' ? path : "/" + path;
    }
 }
 public sealed record DorkNetRouteGroup(
    string ServiceName,
    string[] HostSubdomains,
    string[] PathPrefixes,
    bool IncludesApexHost = false);
@@ -1,38 +0,0 @@
 namespace DorkNet.Contracts;
 public sealed class DorkNetServiceMapOptions
 {
    public string Identity { get; set; } = "http://localhost:8081";
    public string Rooms { get; set; } = "http://localhost:8082";
    public string Notify { get; set; } = "http://localhost:8083";
    public string Content { get; set; } = "http://localhost:8084";
    public string Social { get; set; } = "http://localhost:8085";
    public string Commerce { get; set; } = "http://localhost:8086";
    public string Platform { get; set; } = "http://localhost:8087";
    public string Moderation { get; set; } = "http://localhost:8088";
    public string Web { get; set; } = "http://localhost:8089";
    public string Monolith { get; set; } = "http://localhost:8090";
    public IReadOnlyList<DorkNetServiceEndpoint> Endpoints()
    {
        DorkNetServiceEndpoint[] endpoints =
        [
            new(ServiceNames.Identity, Identity),
            new(ServiceNames.Rooms, Rooms),
            new(ServiceNames.Notify, Notify),
            new(ServiceNames.Content, Content),
            new(ServiceNames.Social, Social),
            new(ServiceNames.Commerce, Commerce),
            new(ServiceNames.Platform, Platform),
            new(ServiceNames.Moderation, Moderation),
            new(ServiceNames.Web, Web),
            new(ServiceNames.Monolith, Monolith),
        ];
        return endpoints
            .Where(endpoint => !string.IsNullOrWhiteSpace(endpoint.BaseUrl))
            .ToArray();
    }
 }
 public sealed record DorkNetServiceEndpoint(string Name, string BaseUrl);
@@ -1,19 +0,0 @@
 namespace DorkNet.Contracts;
 public sealed record ServiceHealthResponse(
    string Service,
    string Status,
    DateTimeOffset CheckedAtUtc);
 public sealed record ServiceCapabilityResponse(
    string Service,
    string[] Owns,
    string[] PlannedPublicRoutes);
 public sealed record ServiceProbeResponse(
    string Service,
    string BaseUrl,
    string Status,
    int? StatusCode,
    string? Error,
    DateTimeOffset CheckedAtUtc);
@@ -1,16 +0,0 @@
 namespace DorkNet.Contracts;
 public static class ServiceNames
 {
    public const string Gateway = "gateway";
    public const string Identity = "identity";
    public const string Rooms = "rooms";
    public const string Notify = "notify";
    public const string Content = "content";
    public const string Social = "social";
    public const string Commerce = "commerce";
    public const string Platform = "platform";
    public const string Moderation = "moderation";
    public const string Web = "web";
    public const string Monolith = "monolith";
 }
@@ -1,3751 +0,0 @@
 // DorkNet.DebugMod — the opt-in debugging companion to DorkNet.ClientMod.
 //
 // The shipping ClientMod carries ONLY the patches needed to connect and
 // survive anti-cheat. All of the verbose diagnostic/tracing code lives
 // here: HTTP header/request tracing, join/quit/studio/room-load traces,
 // the process-level exception sink, auth-token tracing, the registration
 // dialog trace, and the in-game DebugConsole enable/toggle path. Drop
 // DorkNet.DebugMod.dll into the Mods folder next to DorkNet.ClientMod.dll
 // to turn all of it on; remove it to ship a quiet, minimal client.
 //
 // It is a fully self-contained MelonMod (its own Harmony instance + its
 // own copy of the reflection/patch helpers) so it neither needs nor
 // couples to ClientMod at load time. Debug knobs are read from the same
 // <MelonLoader>\UserData\dorknet-clientmod.json the ClientMod uses.
 using HarmonyLib;
 using Il2CppInterop.Runtime;
 using Il2CppInterop.Runtime.InteropTypes;
 using Il2CppInterop.Runtime.InteropTypes.Arrays;
 using MelonLoader;
 using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Globalization;
 using System.IO;
 using System.Reflection;
 using System.Runtime.InteropServices;
 using System.Text;
 using System.Text.Json;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
 [assembly: MelonInfo(typeof(DorkNet.DebugMod.DebugMod), "DorkNet DebugMod", "1.0.0", "Dork Squad")]
 [assembly: MelonGame(null, null)]
 namespace DorkNet.DebugMod;
 public class DebugMod : MelonMod
 {
    internal static MelonLogger.Instance Log => Instance!.LoggerInstance;
    internal static DebugMod? Instance;
    internal static string? DiagnosticsLogPath;
    private static readonly Dictionary<string, Type> ResolvedTypeCache = new();
    private readonly HashSet<string> _diagnosticPatchLabels = new();
    private bool _httpDiagnosticsRegistered;
    private bool _joinTracePatchesRegistered;
    private bool _quitTraceCoreRegistered;
    private bool _quitTraceGameComplete;
    private int _quitTraceRetryFrame;
    private bool _debugConsolePatchesComplete;
    private int _debugConsoleRetryFrame;
    private bool _diagnosticCoreRegistered;
    private bool _diagnosticGameComplete;
    private bool _processExceptionHandlersRegistered;
    private bool _firstUpdateLogged;
    private bool _devCommandsDumped;
    private int  _devCommandsDumpFrame;
    private int  _devCommandsDumpTries;
    public static class Cfg
    {
        // Log-only trace for the stuck first-dorm "Change Username?" dialog.
        public static bool   TraceRegistrationDialog = true;
        // Force-enable the client's built-in RecRoom.Debugging.DebugConsole
        // (normally dev-gated) and silence CheatManager's tamper detectors so
        // movement/time commands don't drop you to the dorm. Default OFF. The
        // toggle key is a UnityEngine.KeyCode name; BackQuote is the `~` key.
        public static bool   EnableDebugConsole = false;
        public static string DebugConsoleToggleKey = "BackQuote";
        public static string[] DevCommands = Array.Empty<string>();
        // Read-only one-shot: dump the full runtime command table to
        // UserData/dorknet-devcommands.txt. Default OFF.
        public static bool   DumpDevCommands = false;
    }
    public override void OnInitializeMelon()
    {
        Instance = this;
        Log.Msg("=== DorkNet DebugMod loading ===");
        LoadConfig();
    }
    public override void OnLateInitializeMelon()
    {
        Log.Msg("=== Registering diagnostic patches ===");
        RegisterProcessExceptionHandlers();
        RegisterHttpDiagnostics();
        RegisterQuitTracePatches(logMisses: true);
        RegisterStudioTracePatches();
        RegisterJoinTracePatches();
        // Auth-token setter trace (LBNJFPOLCDL.JHLKGBGJKKK(access, refresh, key)).
        // The shipping ClientMod used to register this unconditionally; it now
        // lives here with the rest of the diagnostics.
        TryPatchByName("LBNJFPOLCDL", "JHLKGBGJKKK",
                       args: new[] { typeof(string), typeof(string), typeof(string) },
                       prefix: nameof(AuthPatches.CaptureTokenArgs_Prefix));
        // Deep game-side diagnostics: CheatManager tamper-detection logging,
        // the Unity Debug.LogError/LogException sink, Photon connect/join
        // tracing, and the room-load MoveNext state dumps. Unwired in the
        // shipping client (kept out of the minimal footprint); this is their
        // home now that diagnostics are opt-in.
        RegisterDiagnostics();
        if (Cfg.EnableDebugConsole)
            RegisterDebugConsolePatches(logMisses: true);
        Log.Msg("=== Diagnostic patches registered ===");
    }
    public override void OnUpdate()
    {
        if (!_firstUpdateLogged)
        {
            _firstUpdateLogged = true;
            Log.Msg("[lifecycle] first OnUpdate tick (Unity frame loop is live)");
        }
        if (!_quitTraceGameComplete && ++_quitTraceRetryFrame >= 300)
        {
            _quitTraceRetryFrame = 0;
            RegisterQuitTracePatches(logMisses: false);
        }
        if (Cfg.EnableDebugConsole && !_debugConsolePatchesComplete && ++_debugConsoleRetryFrame >= 300)
        {
            _debugConsoleRetryFrame = 0;
            RegisterDebugConsolePatches(logMisses: false);
        }
        if (Cfg.EnableDebugConsole)
            DebugConsolePatches.PollToggleKey();
        // Retry the read-only command dump every ~5s (the config singleton only
        // exists after the ~26s load + dorm entry). Stops as soon as it finds a
        // populated runtime table, or after ~2.5 min of attempts.
        if (Cfg.DumpDevCommands && !_devCommandsDumped && ++_devCommandsDumpFrame >= 300)
        {
            _devCommandsDumpFrame = 0;
            if (DebugConsolePatches.DumpCommandDiagnostics() || ++_devCommandsDumpTries >= 30)
                _devCommandsDumped = true;
        }
    }
    // ── Config ────────────────────────────────────────────────────────
    private static void LoadConfig()
    {
        try
        {
            var userData = ResolveUserDataDirectory();
            Directory.CreateDirectory(userData);
            DiagnosticsLogPath = Path.Combine(userData, "dorknet-diagnostics.log");
            var path = Path.Combine(userData, "dorknet-clientmod.json");
            if (!File.Exists(path))
            {
                Log.Msg($"[config] no file at {path}; using debug defaults");
                return;
            }
            var doc = JsonDocument.Parse(File.ReadAllText(path));
            var r = doc.RootElement;
            if (TryGetConfigValue(r, "TraceRegistrationDialog", out var v))  Cfg.TraceRegistrationDialog = v.GetBoolean();
            if (TryGetConfigValue(r, "EnableDebugConsole", out v))            Cfg.EnableDebugConsole = v.GetBoolean();
            if (TryGetConfigValue(r, "DebugConsoleToggleKey", out v))         Cfg.DebugConsoleToggleKey = v.GetString() ?? Cfg.DebugConsoleToggleKey;
            if (TryGetConfigValue(r, "DumpDevCommands", out v))               Cfg.DumpDevCommands = v.GetBoolean();
            if (TryGetConfigValue(r, "DevCommands", out v) && v.ValueKind == JsonValueKind.Array)
            {
                var commands = new List<string>();
                foreach (var e in v.EnumerateArray())
                    if (e.ValueKind == JsonValueKind.String && !string.IsNullOrWhiteSpace(e.GetString()))
                        commands.Add(e.GetString()!);
                Cfg.DevCommands = commands.ToArray();
            }
            Log.Msg($"[config] debug: debugConsole={Cfg.EnableDebugConsole}, " +
                    $"dumpDevCommands={Cfg.DumpDevCommands}, devCommands={Cfg.DevCommands.Length}");
        }
        catch (Exception ex)
        {
            Log.Warning($"[config] load failed, using defaults: {ex.Message}");
        }
    }
    private MethodInfo GetPatchMethod(string name)
    {
        foreach (var holder in new[] { typeof(HttpTracePatches), typeof(AuthPatches), typeof(QuitTracePatches), typeof(DiagnosticPatches), typeof(RoomLoadDiagnostics), typeof(SavePatches), typeof(ChatPatches), typeof(JoinPatches), typeof(RegistrationPatches), typeof(DebugConsolePatches), typeof(MakerPenGiftPreviewPatches) })
        {
            var m = holder.GetMethod(name, BindingFlags.Public | BindingFlags.Static);
            if (m is not null) return m;
        }
        throw new MissingMethodException($"patch method '{name}' not found on any holder");
    }
    private bool TryPatch(string label, Type target, string methodName,
                          Type[]? args, string? prefix = null, string? postfix = null,
                          bool logMiss = true)
    {
        try
        {
            var method = methodName == "ctor"
                ? (MethodBase)target.GetConstructor(args ?? Type.EmptyTypes)!
                : (args is null ? AccessTools.Method(target, methodName)
                                : AccessTools.Method(target, methodName, args));
            if (method is null)
            {
                // `logMiss` is throttled by the retry-loop caller — once per
                // 5 seconds in OnUpdate, every time in the one-shot initial
                // RegisterDiagnostics. Without the gate the per-second retry
                // loop would spam `[patch-miss]` lines forever for any method
                // whose name drifted in a newer game build.
                if (logMiss) Log.Warning($"[patch-miss] {label}");
                return false;
            }
            HarmonyInstance.Patch(method,
                prefix:  prefix  is null ? null : new HarmonyMethod(GetPatchMethod(prefix)),
                postfix: postfix is null ? null : new HarmonyMethod(GetPatchMethod(postfix)));
            Log.Msg($"[patch-ok] {label}");
            return true;
        }
        catch (Exception ex)
        {
            Log.Error($"[patch-fail] {label}: {ex.Message}");
            return false;
        }
    }
    private bool TryPatchByName(string typeName, string methodName,
                                Type[]? args = null, string? prefix = null, string? postfix = null,
                                bool logMiss = true)
    {
        var label = FormatPatchLabel(typeName, methodName, args);
        var type = ResolveType(typeName);
        if (type is null)
        {
            if (logMiss) Log.Warning($"[patch-miss] {label}: type not found");
            return false;
        }
        return TryPatch(label, type, methodName, args, prefix, postfix, logMiss);
    }
    private bool TryPatchDiagnosticByName(string typeName, string methodName,
                                          Type[]? args = null, string? prefix = null, string? postfix = null,
                                          bool logMiss = true)
    {
        var label = FormatPatchLabel(typeName, methodName, args);
        if (_diagnosticPatchLabels.Contains(label))
            return true;
        if (!TryPatchByName(typeName, methodName, args, prefix, postfix, logMiss))
            return false;
        _diagnosticPatchLabels.Add(label);
        return true;
    }
    internal static Type? ResolveType(string name)
    {
        if (ResolvedTypeCache.TryGetValue(name, out var cached))
            return cached;
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            try
            {
                var t = asm.GetType(name, throwOnError: false);
                if (t is not null) return CacheResolvedType(name, t);
                var dottedPrefixed = asm.GetType("Il2Cpp." + name, throwOnError: false);
                if (dottedPrefixed is not null) return CacheResolvedType(name, dottedPrefixed);
                var prefixed = asm.GetType("Il2Cpp" + name, throwOnError: false);
                if (prefixed is not null) return CacheResolvedType(name, prefixed);
                // For namespaced types like "RecNet.Core", also try with
                // the Il2Cpp prefix on the namespace (i.e. "Il2CppRecNet.Core").
                var dot = name.IndexOf('.');
                if (dot > 0)
                {
                    var nsPrefixed = asm.GetType("Il2Cpp" + name.Substring(0, dot) + name.Substring(dot), throwOnError: false);
                    if (nsPrefixed is not null) return CacheResolvedType(name, nsPrefixed);
                }
            }
            catch { /* unloaded / dynamic asm — skip */ }
        }
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            foreach (var t in GetLoadableTypes(asm))
            {
                if (MatchesRequestedType(t, name))
                    return CacheResolvedType(name, t);
            }
        }
        return null;
    }
    private static Type CacheResolvedType(string name, Type type)
    {
        ResolvedTypeCache[name] = type;
        return type;
    }
    private static IEnumerable<Type> GetLoadableTypes(Assembly asm)
    {
        try
        {
            return asm.GetTypes();
        }
        catch (ReflectionTypeLoadException ex)
        {
            var types = new List<Type>();
            foreach (var t in ex.Types)
            {
                if (t is not null) types.Add(t);
            }
            return types;
        }
        catch
        {
            return Array.Empty<Type>();
        }
    }
    private static bool MatchesRequestedType(Type type, string requested)
    {
        var prefixed = "Il2Cpp" + requested;
        var dottedPrefixed = "Il2Cpp." + requested;
        if (type.FullName == requested || type.FullName == prefixed || type.FullName == dottedPrefixed) return true;
        if (type.Name == requested || type.Name == prefixed) return true;
        return type.FullName?.EndsWith("." + requested, StringComparison.Ordinal) == true ||
               type.FullName?.EndsWith(".Il2Cpp." + requested, StringComparison.Ordinal) == true ||
               type.FullName?.EndsWith(".Il2Cpp" + requested, StringComparison.Ordinal) == true;
    }
    private static string FormatPatchLabel(string typeName, string methodName, Type[]? args)
    {
        if (args is null) return $"{typeName}.{methodName}";
        var names = new List<string>();
        foreach (var arg in args)
            names.Add(arg.Name);
        return $"{typeName}.{methodName}({string.Join(",", names)})";
    }
    private static string FormatParameterTypes(ParameterInfo[] parameters)
    {
        var names = new List<string>();
        foreach (var parameter in parameters)
            names.Add(parameter.ParameterType.Name);
        return string.Join(",", names);
    }
    private static bool TypeNameContains(Type type, string value)
    {
        var fullName = type.FullName ?? type.Name;
        return fullName.Contains(value, StringComparison.Ordinal);
    }
    private static bool MethodNameContains(MethodInfo method, string value)
        => method.Name.Contains(value, StringComparison.Ordinal);
    private static string ResolveUserDataDirectory()
    {
        foreach (var typeName in new[]
        {
            "MelonLoader.MelonEnvironment, MelonLoader",
            "MelonLoader.MelonUtils, MelonLoader",
        })
        {
            var type = Type.GetType(typeName);
            var prop = type?.GetProperty("UserDataDirectory", BindingFlags.Public | BindingFlags.Static);
            if (prop?.GetValue(null) is string value && !string.IsNullOrWhiteSpace(value))
                return value;
        }
        var modDll = Assembly.GetExecutingAssembly().Location;
        var modsDir = Path.GetDirectoryName(modDll) ?? string.Empty;
        var gameDir = Path.GetDirectoryName(modsDir) ?? AppContext.BaseDirectory;
        return Path.Combine(gameDir, "MelonLoader", "UserData");
    }
    private static bool TryGetConfigValue(JsonElement root, string name, out JsonElement value)
    {
        if (root.ValueKind == JsonValueKind.Object)
        {
            foreach (var prop in root.EnumerateObject())
            {
                if (string.Equals(prop.Name, name, StringComparison.OrdinalIgnoreCase))
                {
                    value = prop.Value;
                    return true;
                }
            }
        }
        value = default;
        return false;
    }
    private void RegisterJoinTracePatches()
    {
        if (_joinTracePatchesRegistered) return;
        Log.Msg("=== Registering room-join trace ===");
        // Watch "Dorm Room" button. Void, no params, unique name —
        // HomeScreenFlow.txt:4791, calls RunJoinRoom("DormRoom",…) at :4848.
        TryPatchByName("AGUI.StackedUI.HomeScreenFlow", "Button_DormRoom",
                       args: Type.EmptyTypes,
                       prefix: nameof(JoinPatches.ButtonDormRoom_Prefix));
        // Every SessionManager.RunJoinRoom overload (string-name entry +
        // the RoomInstance inner legs). Logs the method + its arguments.
        PatchAllOverloads("SessionManager", "RunJoinRoom",
                          nameof(JoinPatches.RunJoinRoom_Prefix));
        // The /goto/room/{name|id} promise builders — both the string
        // (room-name) and Int64 (room-id) overloads of NHBPIIGDAJP.
        PatchAllOverloads("OJMCBOKJFOF", "NHBPIIGDAJP",
                          nameof(JoinPatches.Goto_Prefix));
        // The RunJoinRoom promise-chain callbacks compiled onto the
        // SessionManager <>c display class — most importantly the reject
        // handler b__165_1(string error) that raises the happyfox toast.
        // Match by the (de-mangled) substring "RunJoinRoom" + the lambda
        // marker "b__" so we hit the callbacks but not the RunJoinRoom
        // state-machine MoveNext.
        PatchNestedLambdas("SessionManager", "RunJoinRoom",
                           nameof(JoinPatches.JoinCallback_Prefix));
        // Additionally capture the REJECT REASON string on b__165_1 (the
        // happyfox-toast handler). Matches only that one lambda; it ends
        // up with two prefixes (flow + error string), which is harmless.
        PatchNestedLambdas("SessionManager", "RunJoinRoom_b__165_1",
                           nameof(JoinPatches.JoinError_Prefix));
        _joinTracePatchesRegistered = true;
        Log.Msg("=== Room-join trace registered ===");
    }
    private bool PatchAllOverloads(string typeName, string methodName, string prefix, bool logMiss = true)
    {
        var type = ResolveType(typeName);
        if (type is null)
        {
            if (logMiss) Log.Warning($"[patch-miss] {typeName}.{methodName}(*): type not found");
            return false;
        }
        var prefixMethod = GetPatchMethod(prefix);
        var patched = 0;
        foreach (var method in AccessTools.GetDeclaredMethods(type))
        {
            if (method.Name != methodName) continue;
            if (method.IsAbstract || method.ContainsGenericParameters) continue;
            try
            {
                HarmonyInstance.Patch(method, prefix: new HarmonyMethod(prefixMethod));
                patched++;
            }
            catch (Exception ex)
            {
                Log.Warning($"[patch-fail] {typeName}.{methodName} overload: {ex.Message}");
            }
        }
        if (patched == 0)
        {
            if (logMiss) Log.Warning($"[patch-miss] {typeName}.{methodName}(*): no overloads matched");
            return false;
        }
        Log.Msg($"[patch-ok] {typeName}.{methodName}(*) x{patched}");
        return true;
    }
    private bool PatchNestedLambdas(string typeName, string nameContains, string prefix, bool logMiss = true)
    {
        var type = ResolveType(typeName);
        if (type is null)
        {
            if (logMiss) Log.Warning($"[patch-miss] {typeName}+<lambdas>({nameContains}): type not found");
            return false;
        }
        var prefixMethod = GetPatchMethod(prefix);
        var patched = 0;
        foreach (var nested in type.GetNestedTypes(BindingFlags.Public | BindingFlags.NonPublic))
        {
            foreach (var method in AccessTools.GetDeclaredMethods(nested))
            {
                if (method.IsAbstract || method.ContainsGenericParameters) continue;
                if (method.Name.IndexOf("b__", StringComparison.Ordinal) < 0) continue;
                if (method.Name.IndexOf(nameContains, StringComparison.Ordinal) < 0) continue;
                try
                {
                    HarmonyInstance.Patch(method, prefix: new HarmonyMethod(prefixMethod));
                    patched++;
                    Log.Msg($"[patch-ok] {typeName}+{nested.Name}.{method.Name}");
                }
                catch (Exception ex)
                {
                    Log.Warning($"[patch-fail] {typeName}+{nested.Name}.{method.Name}: {ex.Message}");
                }
            }
        }
        if (patched == 0 && logMiss)
            Log.Warning($"[patch-miss] {typeName}+<lambdas>({nameContains}): none matched");
        return patched > 0;
    }
    private void RegisterHttpDiagnostics()
    {
        if (_httpDiagnosticsRegistered) return;
        var complete = true;
        complete &= TryPatchBndRequestBuilderDiagnostics();
        complete &= TryPatchDiagnosticAllOverloads("BestHTTP.HTTPRequest", "CallCallback",
            postfix: nameof(HttpTracePatches.CallCallback_Postfix),
            finalizer: nameof(HttpTracePatches.CallCallback_Finalizer));
        complete &= TryPatchByName("BestHTTP.HTTPRequest", "AddHeader",
            args: new[] { typeof(string), typeof(string) },
            prefix: nameof(HttpTracePatches.HeaderSet_Prefix));
        complete &= TryPatchByName("BestHTTP.HTTPRequest", "SetHeader",
            args: new[] { typeof(string), typeof(string) },
            prefix: nameof(HttpTracePatches.HeaderSet_Prefix));
        _httpDiagnosticsRegistered = complete;
    }
    private bool TryPatchBndRequestBuilderDiagnostics()
    {
        const string label = "BNDIAONDFFF.request-builder";
        if (_diagnosticPatchLabels.Contains(label))
            return true;
        var type = ResolveType("BNDIAONDFFF");
        if (type is null)
        {
            Log.Warning("[patch-miss] BNDIAONDFFF request-builder: type not found");
            return false;
        }
        var prefix = new HarmonyMethod(GetPatchMethod(nameof(HttpTracePatches.RecNetRequestBuilderCtor_Prefix)));
        var postfix = new HarmonyMethod(GetPatchMethod(nameof(HttpTracePatches.RecNetRequestBuilderCtor_Postfix)));
        var patched = 0;
        foreach (var ctor in type.GetConstructors(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance))
        {
            var parameters = ctor.GetParameters();
            if (parameters.Length != 3 || parameters[2].ParameterType != typeof(string)) continue;
            try
            {
                HarmonyInstance.Patch(ctor, prefix: prefix, postfix: postfix);
                patched++;
            }
            catch (Exception ex)
            {
                Log.Warning($"[patch-fail] BNDIAONDFFF..ctor({FormatParameterTypes(parameters)}): {ex.Message}");
            }
        }
        foreach (var method in AccessTools.GetDeclaredMethods(type))
        {
            if (method.Name != "FILJELOLBKK") continue;
            var parameters = method.GetParameters();
            if (parameters.Length != 3 || parameters[2].ParameterType != typeof(string)) continue;
            try
            {
                HarmonyInstance.Patch(method, prefix: prefix, postfix: postfix);
                patched++;
            }
            catch (Exception ex)
            {
                Log.Warning($"[patch-fail] BNDIAONDFFF.FILJELOLBKK({FormatParameterTypes(parameters)}): {ex.Message}");
            }
        }
        if (patched == 0)
        {
            Log.Warning("[patch-miss] BNDIAONDFFF request-builder overloads");
            return false;
        }
        _diagnosticPatchLabels.Add(label);
        Log.Msg($"[patch-ok] BNDIAONDFFF request-builder x{patched}");
        return true;
    }
    private void RegisterQuitTracePatches(bool logMisses)
    {
        if (!_quitTraceCoreRegistered)
        {
            TryPatchByName("UnityEngine.Application", "Quit", Type.EmptyTypes,
                           prefix: nameof(QuitTracePatches.ApplicationQuit_Prefix),
                           logMiss: logMisses);
            TryPatchByName("UnityEngine.Application", "Quit", new[] { typeof(int) },
                           prefix: nameof(QuitTracePatches.ApplicationQuitInt_Prefix),
                           logMiss: logMisses);
            _quitTraceCoreRegistered = true;
        }
        var complete = true;
        complete &= TryPatchDiagnosticByName("OPEOLPDLEBO", "GDNAOLMIDLM",
                                             prefix: nameof(QuitTracePatches.ApplicationWantsToQuit_Prefix),
                                             logMiss: logMisses);
        complete &= TryPatchDiagnosticByName("OPEOLPDLEBO", "DGHJGMBNHCL",
                                             prefix: nameof(QuitTracePatches.CreateExitTask_Prefix),
                                             logMiss: logMisses);
        _quitTraceGameComplete = complete;
    }
    private void RegisterDiagnostics()
    {
        Log.Msg("=== Registering diagnostics ===");
        if (!_diagnosticCoreRegistered)
        {
            TryPatchByName("UnityEngine.Application", "Quit", Type.EmptyTypes,
                           prefix: nameof(DiagnosticPatches.ApplicationQuit_Prefix));
            TryPatchByName("UnityEngine.Application", "Quit", new[] { typeof(int) },
                           prefix: nameof(DiagnosticPatches.ApplicationQuitInt_Prefix));
            _diagnosticCoreRegistered = true;
        }
        _diagnosticGameComplete = RegisterGameDiagnostics(logMisses: true);
        Log.Msg("=== Diagnostics registered ===");
    }
    private bool RegisterGameDiagnostics(bool logMisses)
    {
        // CheatManager fires these when its anti-cheat heuristics trip —
        // logging them surfaces "client thinks it's been tampered with",
        // a common cause of silent dorm-drops / kicks on a modded client.
        // Names verified in CheatManager.txt for 2020.12.18; the older
        // build's "AnalyticsHelper.<X>Cheat" names don't exist here, and
        // there's no DeveloperFlag/StreamingAsset callback nor a
        // BootSequence.RegisterError sink in this build — those legacy
        // hooks were removed (they only ever logged [patch-miss] forever).
        foreach (var method in new[]
        {
            "OnTimeCheatDetected",
            "OnObscuredTypeCheatDetected",
            "OnHeightCheatDetected",
            "OnAdvancedMovementCheatDetected",
        })
        {
            TryPatchDiagnosticByName("CheatManager", method,
                                      prefix: nameof(DiagnosticPatches.AnalyticsCheat_Prefix),
                                      logMiss: logMisses);
        }
        RegisterDeepRoomDiagnostics(logMisses);
        // SteamManager.Awake + SteamPlatformManager.*LoginInitialize were
        // pure-logging diagnostics that fired during Unity's very first
        // wake-up tick. On december (EAC build, IL2CPP wrapped Steam
        // methods) MonoMod's lazy CompileMethodHook on the trampoline
        // crashes the CLR with 0x80131506 the instant Awake JITs. The
        // hooks gave us no behavioral leverage — only a `[call] …` log
        // line — so they're disabled. If anyone needs Steam-side visibility
        // later, route it through the game's own log lines instead.
        return true;
    }
    private void RegisterDebugConsolePatches(bool logMisses)
    {
        var complete = true;
        complete &= TryPatchDiagnosticByName("RecRoom.Debugging.DebugConsole",
                                             "Awake",
                                             args: Type.EmptyTypes,
                                             prefix: nameof(DebugConsolePatches.Awake_Prefix),
                                             logMiss: logMisses);
        complete &= TryPatchDiagnosticByName("RecRoom.Debugging.DebugConsole",
                                             "InputField_OnEndEdit",
                                             args: Type.EmptyTypes,
                                             prefix: nameof(DebugConsolePatches.InputFieldOnEndEdit_Prefix),
                                             logMiss: logMisses);
        // Dev commands that change movement/time trip retail anti-cheat
        // callbacks. Suppress the three callbacks present in the 2023.03.21
        // dump; keep the legacy height detector as a best-effort optional
        // patch for adjacent builds without keeping this retry loop alive.
        complete &= TryPatchDiagnosticByName("CheatManager",
                                             "OnTimeCheatDetected",
                                             args: Type.EmptyTypes,
                                             prefix: nameof(DebugConsolePatches.SuppressCheatDetected_Prefix),
                                             logMiss: logMisses);
        complete &= TryPatchDiagnosticByName("CheatManager",
                                             "OnObscuredTypeCheatDetected",
                                             args: Type.EmptyTypes,
                                             prefix: nameof(DebugConsolePatches.SuppressCheatDetected_Prefix),
                                             logMiss: logMisses);
        complete &= TryPatchDiagnosticByName("CheatManager",
                                             "OnAdvancedMovementCheatDetected",
                                             args: Type.EmptyTypes,
                                             prefix: nameof(DebugConsolePatches.SuppressCheatDetected_Prefix),
                                             logMiss: logMisses);
        TryPatchDiagnosticByName("CheatManager",
                                 "OnHeightCheatDetected",
                                 args: Type.EmptyTypes,
                                 prefix: nameof(DebugConsolePatches.SuppressCheatDetected_Prefix),
                                 logMiss: false);
        _debugConsolePatchesComplete = complete;
        if (complete)
            Log.Msg("[debugconsole] restoration patches armed");
    }
    private bool TryPatchDiagnosticAllOverloads(string typeName, string methodName,
                                                string? prefix = null, string? postfix = null,
                                                string? finalizer = null, bool logMiss = true)
    {
        var label = $"{typeName}.{methodName}(*)";
        if (_diagnosticPatchLabels.Contains(label))
            return true;
        var type = ResolveType(typeName);
        if (type is null)
        {
            if (logMiss) Log.Warning($"[patch-miss] {label}: type not found");
            return false;
        }
        var patched = 0;
        foreach (var method in AccessTools.GetDeclaredMethods(type))
        {
            if (method.Name != methodName) continue;
            if (method.IsAbstract || method.ContainsGenericParameters) continue;
            try
            {
                HarmonyInstance.Patch(method,
                    prefix: prefix is null ? null : new HarmonyMethod(GetPatchMethod(prefix)),
                    postfix: postfix is null ? null : new HarmonyMethod(GetPatchMethod(postfix)),
                    finalizer: finalizer is null ? null : new HarmonyMethod(GetPatchMethod(finalizer)));
                patched++;
            }
            catch (Exception ex)
            {
                Log.Warning($"[patch-fail] {type.FullName}.{method.Name}: {ex.Message}");
            }
        }
        if (patched == 0)
        {
            if (logMiss) Log.Warning($"[patch-miss] {label}: no overloads matched");
            return false;
        }
        _diagnosticPatchLabels.Add(label);
        Log.Msg($"[patch-ok] {label} x{patched}");
        return true;
    }
    private bool RegisterDeepRoomDiagnostics(bool logMisses)
    {
        var complete = true;
        complete &= TryPatchDiagnosticByName("UnityEngine.Debug", "LogError",
                                             args: new[] { typeof(object) },
                                             prefix: nameof(RoomLoadDiagnostics.LogError_Prefix),
                                             logMiss: logMisses);
        complete &= TryPatchDiagnosticByName("UnityEngine.Debug", "LogException",
                                             args: new[] { typeof(Exception) },
                                             prefix: nameof(RoomLoadDiagnostics.LogException_Prefix),
                                             logMiss: logMisses);
        foreach (var method in new[]
        {
            "ConnectUsingSettings",
            "ConnectToRegion",
            "JoinRoom",
            "JoinOrCreateRoom",
            "CreateRoom",
            "LeaveRoom",
            "Disconnect",
        })
        {
            complete &= TryPatchDiagnosticAllOverloads("PhotonNetwork", method,
                                                       prefix: nameof(RoomLoadDiagnostics.NamedCall_Prefix),
                                                       finalizer: nameof(RoomLoadDiagnostics.NamedCall_Finalizer),
                                                       logMiss: logMisses);
        }
        foreach (var item in new (string Type, string Method)[]
        {
            ("CMMIJKCDKPL", "CDNPLAGEDBK"),
            ("KGHEDLNPANK", "CDNPLAGEDBK"),
            ("HMPNINFEDFB", "IJIOJAIBPKE"),
            ("PhotonNetwork", "Disconnect"),
        })
        {
            complete &= TryPatchDiagnosticAllOverloads(item.Type, item.Method,
                                                       prefix: nameof(RoomLoadDiagnostics.NamedCall_Prefix),
                                                       finalizer: nameof(RoomLoadDiagnostics.NamedCall_Finalizer),
                                                       logMiss: logMisses);
        }
        complete &= PatchKnownRoomLoadMoveNext(logMisses);
        return true;
    }
    private void RegisterStudioTracePatches()
    {
        TryPatchByName("RecRoom.Core.Studio.RecRoomObjectPrefabManager", "RegisterPrefabs",
                       postfix: nameof(RoomLoadDiagnostics.StudioRegisterPrefabs_Postfix));
        TryPatchByName("RecRoom.Core.Studio.RecRoomObjectPrefabManager", "TryGetPrefab",
                       postfix: nameof(RoomLoadDiagnostics.StudioTryGetPrefab_Postfix));
        TryPatchByName("RecRoom.Core.Studio.RecRoomObjectPrefabManager", "IsKnownPrefab",
                       postfix: nameof(RoomLoadDiagnostics.StudioIsKnownPrefab_Postfix));
        TryPatchByName("NLDBPDCNNCF", "FKLDMPMFLBD",
                       prefix: nameof(RoomLoadDiagnostics.StudioUnityAssetFetch_Prefix));
    }
    private bool PatchKnownRoomLoadMoveNext(bool logMiss)
    {
        const string label = "room-load-state-machines.MoveNext";
        if (_diagnosticPatchLabels.Contains(label))
            return true;
        var nameNeedles = new[]
        {
            "OMJKHJLFOCO", "AFMPFLKGABO",
            "AOEBBIFGIKI", "FINJCCNPHEP", "FDDFOKNJIFL", "GMNHJNAHAAI",
            "MHDOLJJPEAD", "LFGLDJCMJDN", "PFDIKJHMBDI", "ICAGCHKPIOM",
            "JEBACILNLJI", "DINBAFNHLPJ", "HLHPNABABME", "PAPLNIPKAMG",
            "IBEOONPEELF", "JHPHMNGOFLB", "NLDBPDCNNCF", "LONOBOBHMJL",
            "BNDIAONDFFF", "HOONLPFFADG", "PHODPEHLHGM",
        };
        var patched = 0;
        foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            foreach (var type in GetLoadableTypes(asm))
            {
                var fullName = type.FullName ?? type.Name;
                var match = false;
                foreach (var needle in nameNeedles)
                {
                    if (fullName.IndexOf(needle, StringComparison.Ordinal) >= 0)
                    {
                        match = true;
                        break;
                    }
                }
                if (!match) continue;
                IEnumerable<MethodInfo> methods;
                try { methods = AccessTools.GetDeclaredMethods(type); }
                catch { continue; }
                foreach (var method in methods)
                {
                    if (method.Name != "MoveNext") continue;
                    if (method.IsAbstract || method.ContainsGenericParameters) continue;
                    try
                    {
                        HarmonyInstance.Patch(method,
                            finalizer: new HarmonyMethod(GetPatchMethod(nameof(RoomLoadDiagnostics.MoveNext_Finalizer))));
                        patched++;
                        Log.Msg($"[patch-ok] room-load MoveNext {type.FullName}");
                    }
                    catch (Exception ex)
                    {
                        Log.Warning($"[patch-fail] room-load MoveNext {type.FullName}: {ex.Message}");
                    }
                }
            }
        }
        if (patched == 0)
        {
            if (logMiss) Log.Warning("[patch-miss] room-load state-machine MoveNext hooks");
            return false;
        }
        _diagnosticPatchLabels.Add(label);
        return true;
    }
    private void RegisterProcessExceptionHandlers()
    {
        if (_processExceptionHandlersRegistered) return;
        _processExceptionHandlersRegistered = true;
        AppDomain.CurrentDomain.UnhandledException += (_, e) =>
        {
            try
            {
                var ex = e.ExceptionObject as Exception;
                DiagnosticPatches.Write($"[process-exception] unhandled terminating={e.IsTerminating} {RoomLoadDiagnostics.FormatException(ex, e.ExceptionObject)}");
            }
            catch { }
        };
        TaskScheduler.UnobservedTaskException += (_, e) =>
        {
            try
            {
                DiagnosticPatches.Write($"[process-exception] unobserved-task {RoomLoadDiagnostics.FormatException(e.Exception, e.Exception)}");
            }
            catch { }
        };
    }
 }
 internal static class RoomLoadDiagnostics
 {
    private static readonly Dictionary<string, int> Counts = new();
    private static int _globalCount;
    public static void LogError_Prefix(object? message)
    {
        DiagnosticPatches.Write($"[unity-error] LogError {Sanitize(message?.ToString() ?? "<null>", 1600)}");
        WriteStack("unity-error");
    }
    public static void LogException_Prefix(Exception exception)
    {
        DiagnosticPatches.Write($"[unity-exception] {FormatException(exception, exception)}");
        WriteStack("unity-exception");
    }
    public static void NamedCall_Prefix(MethodBase __originalMethod)
    {
        var name = FullMethodName(__originalMethod);
        if (!ShouldLog("call:" + name, 80)) return;
        DiagnosticPatches.Write($"[runtime-call] ENTER {name} [{Signature(__originalMethod)}]");
        if (IsImportantCall(name))
            WriteStack("runtime-call");
    }
    public static Exception? NamedCall_Finalizer(Exception? __exception, MethodBase __originalMethod)
    {
        if (__exception is not null)
        {
            DiagnosticPatches.Write($"[runtime-call] EXCEPTION {FullMethodName(__originalMethod)} {FormatException(__exception, __exception)}");
            WriteStack("runtime-call-exception");
        }
        return __exception;
    }
    public static void MoveNext_Prefix(object __instance, MethodBase __originalMethod)
    {
        var name = FullMethodName(__originalMethod);
        if (!ShouldLog("enter:" + name, 120)) return;
        DiagnosticPatches.Write($"[room-load] ENTER {name} state={DumpInstanceFields(__instance, 28)}");
    }
    public static void MoveNext_Postfix(object __instance, MethodBase __originalMethod)
    {
        var name = FullMethodName(__originalMethod);
        if (!ShouldLog("exit:" + name, 120)) return;
        DiagnosticPatches.Write($"[room-load] EXIT {name} state={DumpInstanceFields(__instance, 28)}");
    }
    public static Exception? MoveNext_Finalizer(Exception? __exception, object __instance, MethodBase __originalMethod)
    {
        if (__exception is not null)
        {
            DiagnosticPatches.Write(
                $"[room-load] EXCEPTION {FullMethodName(__originalMethod)} " +
                $"{FormatException(__exception, __exception)} state={DumpInstanceFields(__instance, 40)}");
            WriteStack("room-load-exception");
        }
        return __exception;
    }
    // ── Studio baked-asset load trace ──────────────────────────────────
    // Pinpoints where the baked-Studio-scene load chain breaks. The room
    // joins but renders no custom geometry and logs "Expected a prefab,
    // but found none"; the server serves everything but the client never
    // requests a bundle. These probes answer: (1) does the client ever
    // call the RecNet "get unity asset" API (FKLDMPMFLBD); (2) does it
    // ever register baked prefabs; (3) which prefab GUIDs does it look up
    // and miss.
    /// <summary>RecNet unity-asset getter
    /// <c>NLDBPDCNNCF.FKLDMPMFLBD(string unityAssetId, byte target, int version, CancellationToken)</c>
    /// — the call that builds <c>unity_assets/{id}/{target}/{version}</c>. If
    /// this never fires, the client decided not to fetch the bundle at all
    /// (trigger missing upstream); if it fires, the URL/host/response is the
    /// problem.</summary>
    public static void StudioUnityAssetFetch_Prefix(object? __0, object? __1, object? __2)
    {
        DiagnosticPatches.Write(
            $"[studio] UNITY-ASSET FETCH id={__0?.ToString() ?? "<null>"} " +
            $"target={__1?.ToString() ?? "?"} version={__2?.ToString() ?? "?"}");
        WriteStack("studio-assetfetch");
    }
    /// <summary><c>RecRoomObjectPrefabManager.RegisterPrefabs</c> — baked
    /// prefabs being registered after a bundle loads. If this never fires,
    /// no bundle was loaded.</summary>
    public static void StudioRegisterPrefabs_Postfix(object? __0)
    {
        int count = -1;
        try
        {
            if (__0 is not null)
            {
                var p = __0.GetType().GetProperty("Count");
                if (p?.GetValue(__0) is int c) count = c;
            }
        }
        catch { /* best-effort count */ }
        DiagnosticPatches.Write($"[studio] RegisterPrefabs count={count}");
        WriteStack("studio-registerprefabs");
    }
    /// <summary><c>RecRoomObjectPrefabManager.TryGetPrefab(Guid, out GameObject)</c>
    /// — the lookup that fails with "Expected a prefab, but found none".
    /// Logs the GUID + whether it resolved.</summary>
    public static void StudioTryGetPrefab_Postfix(object? __0, bool __result)
    {
        if (!ShouldLog("studio-trygetprefab", 200)) return;
        DiagnosticPatches.Write(
            $"[studio] TryGetPrefab guid={__0?.ToString() ?? "<null>"} found={__result}");
    }
    /// <summary><c>RecRoomObjectPrefabManager.IsKnownPrefab(Guid)</c>.</summary>
    public static void StudioIsKnownPrefab_Postfix(object? __0, bool __result)
    {
        if (!ShouldLog("studio-isknownprefab", 200)) return;
        DiagnosticPatches.Write(
            $"[studio] IsKnownPrefab guid={__0?.ToString() ?? "<null>"} known={__result}");
    }
    public static string FormatException(Exception? ex, object? fallback)
    {
        if (ex is null) return fallback?.ToString() ?? "<null>";
        var builder = new StringBuilder();
        AppendException(builder, ex, 0);
        return Sanitize(builder.ToString(), 5000);
    }
    private static void AppendException(StringBuilder builder, Exception ex, int depth)
    {
        if (depth > 4) return;
        if (builder.Length > 0) builder.Append(" | ");
        builder.Append(ex.GetType().FullName).Append(": ").Append(ex.Message);
        if (!string.IsNullOrWhiteSpace(ex.StackTrace))
            builder.Append(" stack=").Append(ex.StackTrace);
        if (ex is AggregateException aggregate)
        {
            foreach (var inner in aggregate.InnerExceptions)
                AppendException(builder, inner, depth + 1);
        }
        else if (ex.InnerException is not null)
        {
            AppendException(builder, ex.InnerException, depth + 1);
        }
    }
    private static bool ShouldLog(string key, int perKeyLimit)
    {
        lock (Counts)
        {
            _globalCount++;
            if (_globalCount > 12000)
                return false;
            Counts.TryGetValue(key, out var count);
            if (count >= perKeyLimit)
                return false;
            Counts[key] = count + 1;
            return true;
        }
    }
    private static string DumpInstanceFields(object? instance, int maxFields)
    {
        if (instance is null) return "<null>";
        try
        {
            var type = instance.GetType();
            var parts = new List<string>();
            const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
            foreach (var field in type.GetFields(flags))
            {
                if (parts.Count >= maxFields)
                {
                    parts.Add("...");
                    break;
                }
                object? value;
                try { value = field.GetValue(instance); }
                catch (Exception ex)
                {
                    parts.Add($"{field.Name}=<read failed {ex.GetType().Name}>");
                    continue;
                }
                var described = DescribeValue(value, 400);
                if (ShouldExpandField(field, value))
                    described += " " + DumpNestedFields(value, 16);
                parts.Add($"{field.Name}={described}");
            }
            return $"{type.FullName} {{{string.Join("; ", parts)}}}";
        }
        catch (Exception ex)
        {
            return $"<dump failed {ex.GetType().Name}: {Sanitize(ex.Message, 400)}>";
        }
    }
    private static bool ShouldExpandField(FieldInfo field, object? value)
    {
        if (value is null) return false;
        if (value is string) return false;
        var valueType = value.GetType();
        if (valueType.IsPrimitive || valueType.IsEnum || value is decimal)
            return false;
        if (value is IEnumerable)
            return false;
        var fieldName = field.Name ?? string.Empty;
        var typeName = valueType.FullName ?? valueType.Name;
        return fieldName.IndexOf("this", StringComparison.OrdinalIgnoreCase) >= 0 ||
               typeName.IndexOf("OMJKHJLFOCO", StringComparison.Ordinal) >= 0 ||
               typeName.IndexOf("RoomPermissions", StringComparison.OrdinalIgnoreCase) >= 0;
    }
    private static string DumpNestedFields(object value, int maxFields)
    {
        try
        {
            var type = value.GetType();
            var parts = new List<string>();
            const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
            foreach (var field in type.GetFields(flags))
            {
                if (parts.Count >= maxFields)
                {
                    parts.Add("...");
                    break;
                }
                object? nested;
                try { nested = field.GetValue(value); }
                catch (Exception ex)
                {
                    parts.Add($"{field.Name}=<read failed {ex.GetType().Name}>");
                    continue;
                }
                parts.Add($"{field.Name}={DescribeValue(nested, 220)}");
            }
            return "{nested " + string.Join("; ", parts) + "}";
        }
        catch (Exception ex)
        {
            return $"{{nested dump failed {ex.GetType().Name}: {Sanitize(ex.Message, 220)}}}";
        }
    }
    private static string DescribeValue(object? value, int limit)
    {
        if (value is null) return "null";
        var type = value.GetType();
        if (value is string text) return "\"" + Sanitize(text, limit) + "\"";
        if (value is Exception ex) return FormatException(ex, ex);
        if (type.IsPrimitive || type.IsEnum || value is decimal)
            return Sanitize(value.ToString() ?? "<null>", limit);
        if (value is IEnumerable enumerable && value is not string)
            return DescribeEnumerable(enumerable, type, limit);
        var rendered = value.ToString();
        if (string.IsNullOrWhiteSpace(rendered) || rendered == type.FullName)
            return "<" + type.FullName + ">";
        return "<" + type.FullName + " " + Sanitize(rendered, limit) + ">";
    }
    private static string DescribeEnumerable(IEnumerable enumerable, Type type, int limit)
    {
        var parts = new List<string>();
        var count = 0;
        foreach (var item in enumerable)
        {
            if (count++ >= 6)
            {
                parts.Add("...");
                break;
            }
            parts.Add(DescribeValue(item, 120));
        }
        return "<" + type.FullName + " [" + Sanitize(string.Join(", ", parts), limit) + "]>";
    }
    private static string Signature(MethodBase method)
    {
        try
        {
            var parameters = method.GetParameters();
            var parts = new List<string>(parameters.Length);
            foreach (var parameter in parameters)
                parts.Add(parameter.ParameterType.FullName ?? parameter.ParameterType.Name);
            return string.Join(", ", parts);
        }
        catch
        {
            return "<signature unread>";
        }
    }
    private static string FullMethodName(MethodBase method) =>
        $"{method.DeclaringType?.FullName ?? "<null>"}.{method.Name}";
    private static bool IsImportantCall(string name) =>
        name.IndexOf("Disconnect", StringComparison.OrdinalIgnoreCase) >= 0 ||
        name.IndexOf("Join", StringComparison.OrdinalIgnoreCase) >= 0 ||
        name.IndexOf("Photon", StringComparison.OrdinalIgnoreCase) >= 0 ||
        name.IndexOf("CDNPLAGEDBK", StringComparison.Ordinal) >= 0 ||
        name.IndexOf("IJIOJAIBPKE", StringComparison.Ordinal) >= 0;
    private static void WriteStack(string tag)
    {
        try
        {
            DiagnosticPatches.Write($"[{tag}-stack] " + new StackTrace(skipFrames: 2, fNeedFileInfo: false));
        }
        catch (Exception ex)
        {
            DiagnosticPatches.Write($"[{tag}-stack] failed: {ex.Message}");
        }
    }
    private static string Sanitize(string value, int limit)
    {
        var redacted = Regex.Replace(value, @"(?i)(Bearer\s+)[-._~+/=A-Za-z0-9]+", "$1<redacted>");
        redacted = Regex.Replace(redacted, @"(?i)(access_token|accessToken|refresh_token|refreshToken|authorization|token|key)=([^&\s]+)", "$1=<redacted>");
        redacted = redacted.Replace("\r", "\\r").Replace("\n", "\\n").Replace("\t", "\\t");
        return redacted.Length <= limit ? redacted : redacted[..limit] + "...<truncated>";
    }
 }
 internal static class DebugConsolePatches
 {
    private static bool _consoleVisible;
    private static bool _pollErrorLogged;
    private static int _probeFrame;
    private static bool _probeDone;
    private static bool _inputResolved;
    private static MethodInfo? _getKeyDown;     // UnityEngine.Input.GetKeyDown(KeyCode)
    private static object? _toggleKeyValue;     // boxed KeyCode enum value
    private static bool _consoleResolved;
    private static Type? _consoleType;
    private static MethodInfo? _toggleMethod;     // ShowInputField(bool) / MCNBJFECHLJ(bool)
    private static MethodInfo? _setConsoleText;   // DebugConsole.SetConsoleText(string)
    private static List<ConfiguredCommand>? _commandCache;
    // Harmony prefix returning false → skips the original CheatManager
    // detector, so a tripped heuristic never runs its punish/drop path.
    public static bool SuppressCheatDetected_Prefix() => false;
    public static bool Awake_Prefix()
    {
        return false;
    }
    public static bool InputFieldOnEndEdit_Prefix(object __instance)
    {
        var command = ReadConsoleInput(__instance);
        if (string.IsNullOrWhiteSpace(command))
            return true;
        ExecuteCommand(command, __instance);
        return false;
    }
    public static string FormatConfiguredCommandsForLog()
    {
        var commands = GetAvailableCommands();
        if (commands.Count == 0) return "<none>";
        var parts = new List<string>();
        foreach (var command in commands)
            parts.Add($"{command.Label}={command.Command}");
        return string.Join(", ", parts);
    }
    // Polled every frame from DebugMod.OnUpdate while EnableDebugConsole is set.
    public static void PollToggleKey()
    {
        try
        {
            if (!_inputResolved) ResolveInput();
            // One-shot probe ~3s in (≈180 frames @60fps): log whether the
            // console object actually exists, so we learn that even if the
            // hotkey never fires.
            if (!_probeDone && _probeFrame++ > 180)
            {
                _probeDone = true;
                ProbeConsole();
            }
            if (_getKeyDown is null || _toggleKeyValue is null) return;
            if (_getKeyDown.Invoke(null, new[] { _toggleKeyValue }) is true)
            {
                DebugMod.Log.Msg($"[debugconsole] toggle key '{DebugMod.Cfg.DebugConsoleToggleKey}' detected");
                Toggle();
            }
        }
        catch (Exception ex)
        {
            if (!_pollErrorLogged) { _pollErrorLogged = true; DebugMod.Log.Warning($"[debugconsole] poll failed (logged once): {ex}"); }
        }
    }
    // Diagnostic: reports whether a live DebugConsole component exists and
    // whether the show/hide method resolved — without needing a keypress.
    private static void ProbeConsole()
    {
        if (!_consoleResolved) ResolveConsole();
        if (_consoleType is null) { DebugMod.Log.Warning("[debugconsole] probe: DebugConsole type NOT resolved"); return; }
        try
        {
            var active = FindConsoleInstance();
            DebugMod.Log.Msg($"[debugconsole] probe: type={_consoleType.FullName}, toggleMethod={(_toggleMethod?.Name ?? "<none>")}, activeInstance={(active is null ? "null" : "found")}");
        }
        catch (Exception ex) { DebugMod.Log.Warning($"[debugconsole] probe failed: {ex.Message}"); }
    }
    public static void ExecuteCommand(string command) => ExecuteCommand(command, consoleInstance: null);
    private static void ExecuteCommand(string command, object? consoleInstance)
    {
        if (string.IsNullOrWhiteSpace(command))
            return;
        var output = RunCommand(command);
        if (consoleInstance is null)
        {
            if (!_consoleResolved) ResolveConsole();
            consoleInstance = FindConsoleInstance();
        }
        if (consoleInstance is not null)
            WriteConsoleOutput(consoleInstance, output);
        var parts = SplitCommandLine(command);
        var verb = parts.Count > 0 ? parts[0] : "<empty>";
        DebugMod.Log.Msg($"[debugconsole] command '{CleanLabel(verb)}': {FirstLine(output)}");
    }
    private static string RunCommand(string commandLine)
    {
        var tokens = SplitCommandLine(commandLine);
        if (tokens.Count == 0)
            return string.Empty;
        var verb = tokens[0];
        if (IsHelpCommand(verb))
            return BuildCommandReferenceText("Debug Console Commands", maxCommands: 120);
        var args = tokens.GetRange(1, tokens.Count - 1);
        if (!TryFindCommand(verb, out var command))
            return $"Unknown debug command: {verb}\n\n{BuildCommandReferenceText("Available Debug Console Commands", maxCommands: 80)}";
        if (!command.HasRuntimeTarget)
        {
            var expanded = SplitCommandLine(command.Command);
            if (expanded.Count == 0)
                return $"Debug command '{verb}' has no backing command.";
            var expandedArgs = expanded.Count > 1 ? expanded.GetRange(1, expanded.Count - 1) : new List<string>();
            expandedArgs.AddRange(args);
            if (!TryFindCommand(expanded[0], out command) || !command.HasRuntimeTarget)
                return $"Debug command '{verb}' points at '{command.Command}', but no runtime command metadata was found.";
            args = expandedArgs;
        }
        if (!TryResolveCommandType(command, out var targetType, out var typeError))
            return typeError;
        if (!TryFindCallableMethod(targetType!, command.MethodName, args, out var method, out var converted, out var methodError))
            return methodError;
        object? target = null;
        if (!method!.IsStatic)
        {
            target = FindFirstInstance(targetType!);
            if (target is null)
                return $"Command '{command.MethodName}' needs a live {targetType!.Name} instance, but none was found.";
        }
        try
        {
            var result = method.Invoke(target, converted);
            var suffix = result is null ? string.Empty : $"\nResult: {FormatResult(result)}";
            return $"Executed: {command.Label}{suffix}";
        }
        catch (TargetInvocationException ex)
        {
            var inner = ex.InnerException ?? ex;
            return $"Command '{command.MethodName}' failed: {inner.GetType().Name}: {inner.Message}";
        }
        catch (Exception ex)
        {
            return $"Command '{command.MethodName}' failed: {ex.GetType().Name}: {ex.Message}";
        }
    }
    private static bool IsHelpCommand(string verb) =>
        string.Equals(verb, "help", StringComparison.OrdinalIgnoreCase) ||
        string.Equals(verb, "?", StringComparison.OrdinalIgnoreCase) ||
        string.Equals(verb, "ListRegisteredCommands", StringComparison.OrdinalIgnoreCase);
    private static bool TryResolveCommandType(ConfiguredCommand command, out Type? type, out string error)
    {
        foreach (var name in new[] { command.ObfuscatedDeclaringType, command.DeclaringType })
        {
            var normalized = NormalizeTypeName(name);
            if (string.IsNullOrWhiteSpace(normalized)) continue;
            type = DebugMod.ResolveType(normalized);
            if (type is not null)
            {
                error = string.Empty;
                return true;
            }
        }
        type = null;
        error = $"Command '{command.MethodName}' has no resolvable declaring type (declaring='{command.DeclaringType}', obfuscated='{command.ObfuscatedDeclaringType}').";
        return false;
    }
    private static string NormalizeTypeName(string value)
    {
        value = (value ?? string.Empty).Trim();
        var comma = value.IndexOf(',');
        return comma >= 0 ? value[..comma].Trim() : value;
    }
    private static bool TryFindCallableMethod(Type type, string methodName, List<string> args,
                                               out MethodInfo? method, out object?[] converted, out string error)
    {
        foreach (var candidate in type.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static | BindingFlags.Instance))
        {
            if (candidate.Name != methodName) continue;
            if (candidate.IsAbstract || candidate.ContainsGenericParameters) continue;
            if (TryConvertArguments(candidate.GetParameters(), args, out converted))
            {
                method = candidate;
                error = string.Empty;
                return true;
            }
        }
        method = null;
        converted = Array.Empty<object?>();
        error = $"No overload of {type.Name}.{methodName} accepts {args.Count} argument(s): {string.Join(" ", args)}";
        return false;
    }
    private static bool TryConvertArguments(ParameterInfo[] parameters, List<string> args, out object?[] converted)
    {
        converted = new object?[parameters.Length];
        var argIndex = 0;
        for (var i = 0; i < parameters.Length; i++)
        {
            var parameter = parameters[i];
            if (IsVector3(parameter.ParameterType) && args.Count - argIndex >= 3)
            {
                if (!TryParseFloat(args[argIndex], out var x) ||
                    !TryParseFloat(args[argIndex + 1], out var y) ||
                    !TryParseFloat(args[argIndex + 2], out var z) ||
                    !TryCreateVector3(parameter.ParameterType, x, y, z, out converted[i]))
                    return false;
                argIndex += 3;
                continue;
            }
            if (argIndex >= args.Count)
            {
                if (parameter.HasDefaultValue)
                {
                    converted[i] = parameter.DefaultValue;
                    continue;
                }
                return false;
            }
            if (!TryConvertArgument(args[argIndex], parameter.ParameterType, out converted[i]))
                return false;
            argIndex++;
        }
        return argIndex == args.Count;
    }
    private static bool TryConvertArgument(string value, Type targetType, out object? converted)
    {
        converted = null;
        if (targetType == typeof(string) || targetType.FullName == "System.String")
        {
            converted = value;
            return true;
        }
        var nullable = Nullable.GetUnderlyingType(targetType);
        if (nullable is not null)
            targetType = nullable;
        if (targetType == typeof(bool))
        {
            if (bool.TryParse(value, out var b))
            {
                converted = b;
                return true;
            }
            if (string.Equals(value, "on", StringComparison.OrdinalIgnoreCase) ||
                string.Equals(value, "yes", StringComparison.OrdinalIgnoreCase) ||
                value == "1")
            {
                converted = true;
                return true;
            }
            if (string.Equals(value, "off", StringComparison.OrdinalIgnoreCase) ||
                string.Equals(value, "no", StringComparison.OrdinalIgnoreCase) ||
                value == "0")
            {
                converted = false;
                return true;
            }
            return false;
        }
        if (targetType.IsEnum)
        {
            try
            {
                converted = Enum.Parse(targetType, value, ignoreCase: true);
                return true;
            }
            catch { return false; }
        }
        try
        {
            if (targetType == typeof(int))    { converted = int.Parse(value, CultureInfo.InvariantCulture); return true; }
            if (targetType == typeof(long))   { converted = long.Parse(value, CultureInfo.InvariantCulture); return true; }
            if (targetType == typeof(float))  { converted = float.Parse(value, CultureInfo.InvariantCulture); return true; }
            if (targetType == typeof(double)) { converted = double.Parse(value, CultureInfo.InvariantCulture); return true; }
            if (targetType == typeof(short))  { converted = short.Parse(value, CultureInfo.InvariantCulture); return true; }
            if (targetType == typeof(byte))   { converted = byte.Parse(value, CultureInfo.InvariantCulture); return true; }
        }
        catch { return false; }
        return false;
    }
    private static bool IsVector3(Type type) =>
        type.Name == "Vector3" && (type.Namespace == "UnityEngine" || type.FullName?.EndsWith(".Vector3", StringComparison.Ordinal) == true);
    private static bool TryParseFloat(string value, out float result) =>
        float.TryParse(value, NumberStyles.Float, CultureInfo.InvariantCulture, out result);
    private static bool TryCreateVector3(Type vectorType, float x, float y, float z, out object? vector)
    {
        vector = null;
        try
        {
            var ctor = vectorType.GetConstructor(new[] { typeof(float), typeof(float), typeof(float) });
            if (ctor is null) return false;
            vector = ctor.Invoke(new object[] { x, y, z });
            return true;
        }
        catch { return false; }
    }
    private static object? FindFirstInstance(Type type)
    {
        try
        {
            var il2cppType = ToIl2CppType(type);
            if (il2cppType is null) return null;
            var resources = DebugMod.ResolveType("UnityEngine.Resources");
            var all = OneArgMethod(resources, "FindObjectsOfTypeAll", il2cppType)?.Invoke(null, new[] { il2cppType });
            var count = ArrLen(all);
            for (var i = 0; i < count; i++)
            {
                var item = ArrItem(all, i);
                if (item is not null) return item;
            }
        }
        catch { }
        return null;
    }
    private static string FormatResult(object result)
    {
        var text = result.ToString() ?? result.GetType().Name;
        return text.Length <= 500 ? text : text[..500] + "...";
    }
    private static string FirstLine(string value)
    {
        value = value.Replace("\r", "");
        var idx = value.IndexOf('\n');
        return idx >= 0 ? value[..idx] : value;
    }
    private static List<string> SplitCommandLine(string value)
    {
        var result = new List<string>();
        if (string.IsNullOrWhiteSpace(value)) return result;
        var sb = new StringBuilder();
        var inQuotes = false;
        var quote = '\0';
        var escaping = false;
        foreach (var ch in value.Trim())
        {
            if (escaping)
            {
                sb.Append(ch);
                escaping = false;
                continue;
            }
            if (ch == '\\')
            {
                escaping = true;
                continue;
            }
            if (inQuotes)
            {
                if (ch == quote)
                {
                    inQuotes = false;
                    continue;
                }
                sb.Append(ch);
                continue;
            }
            if (ch is '"' or '\'')
            {
                inQuotes = true;
                quote = ch;
                continue;
            }
            if (char.IsWhiteSpace(ch))
            {
                if (sb.Length > 0)
                {
                    result.Add(sb.ToString());
                    sb.Clear();
                }
                continue;
            }
            sb.Append(ch);
        }
        if (escaping) sb.Append('\\');
        if (sb.Length > 0) result.Add(sb.ToString());
        return result;
    }
    private static void ResolveInput()
    {
        _inputResolved = true;
        var keyCodeType = DebugMod.ResolveType("UnityEngine.KeyCode");
        var inputType   = DebugMod.ResolveType("UnityEngine.Input");
        if (keyCodeType is null || inputType is null)
        {
            DebugMod.Log.Warning("[debugconsole] UnityEngine.Input/KeyCode not found — hotkey disabled");
            return;
        }
        try { _toggleKeyValue = Enum.Parse(keyCodeType, DebugMod.Cfg.DebugConsoleToggleKey, ignoreCase: true); }
        catch
        {
            DebugMod.Log.Warning($"[debugconsole] '{DebugMod.Cfg.DebugConsoleToggleKey}' is not a KeyCode; defaulting to BackQuote");
            _toggleKeyValue = Enum.Parse(keyCodeType, "BackQuote");
        }
        _getKeyDown = AccessTools.Method(inputType, "GetKeyDown", new[] { keyCodeType });
        if (_getKeyDown is null) DebugMod.Log.Warning("[debugconsole] Input.GetKeyDown(KeyCode) not found");
        else DebugMod.Log.Msg($"[debugconsole] hotkey armed: '{DebugMod.Cfg.DebugConsoleToggleKey}' (poll live)");
    }
    private static void ResolveConsole()
    {
        _consoleResolved = true;
        _consoleType = DebugMod.ResolveType("RecRoom.Debugging.DebugConsole");
        if (_consoleType is null) { DebugMod.Log.Warning("[debugconsole] DebugConsole type not found"); return; }
        // Prefer the readable 2020.03 name, then the 2020.12 obfuscated
        // name, then a structural fallback that fits both builds.
        _toggleMethod = AccessTools.Method(_consoleType, "ShowInputField", new[] { typeof(bool) })
                        ?? AccessTools.Method(_consoleType, "MCNBJFECHLJ", new[] { typeof(bool) })
                        ?? AccessTools.Method(_consoleType, "KIAMDEDKFBC", new[] { typeof(bool) })
                        ?? FindToggleByShape(_consoleType);
        if (_toggleMethod is null) DebugMod.Log.Warning("[debugconsole] show/hide method not found");
    }
    // The console's show/hide is the single private, instance, void method
    // taking exactly one bool, excluding compiler-generated members (the
    // property backing setter on 2020.12 is also void(bool) but is marked
    // [CompilerGenerated]).
    private static MethodInfo? FindToggleByShape(Type t)
    {
        MethodInfo? found = null;
        foreach (var m in t.GetMethods(BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.DeclaredOnly))
        {
            if (m.ReturnType != typeof(void)) continue;
            var ps = m.GetParameters();
            if (ps.Length != 1 || ps[0].ParameterType != typeof(bool)) continue;
            if (m.Name.StartsWith("set_", StringComparison.Ordinal)) continue;
            if (m.IsDefined(typeof(System.Runtime.CompilerServices.CompilerGeneratedAttribute), false)) continue;
            if (found is not null) return null; // ambiguous — don't guess
            found = m;
        }
        return found;
    }
    public static void Toggle()
    {
        if (!_consoleResolved) ResolveConsole();
        if (_consoleType is null || _toggleMethod is null) return;
        try
        {
            var instance = FindConsoleInstance();
            if (instance is null)
            {
                DebugMod.Log.Warning("[debugconsole] no live DebugConsole in scene — it may not be instantiated on this build");
                return;
            }
            // Best-effort: flip the static "show button" enable so the
            // game's own Update keeps the console available instead of
            // re-hiding it. Failures are ignored (obfuscated builds).
            EnableShowButton();
            _consoleVisible = !_consoleVisible;
            _toggleMethod.Invoke(instance, new object[] { _consoleVisible });
            if (_consoleVisible)
                ShowConfiguredCommands(instance);
            DebugMod.Log.Msg($"[debugconsole] {(_consoleVisible ? "opened" : "closed")}");
        }
        catch (Exception ex) { DebugMod.Log.Warning($"[debugconsole] toggle failed: {ex.Message}"); }
    }
    private static object? FindConsoleInstance()
    {
        if (_consoleType is null) return null;
        try
        {
            var il2cppType = ToIl2CppType(_consoleType);
            if (il2cppType is null) return null;
            var resources = DebugMod.ResolveType("UnityEngine.Resources");
            var all = OneArgMethod(resources, "FindObjectsOfTypeAll", il2cppType)?.Invoke(null, new[] { il2cppType });
            var count = ArrLen(all);
            for (var i = 0; i < count; i++)
            {
                var item = ArrItem(all, i);
                if (item is not null) return item;
            }
            var objType = DebugMod.ResolveType("UnityEngine.Object");
            var findOne = OneArgMethod(objType, "FindObjectOfType", il2cppType);
            return findOne?.Invoke(null, new[] { il2cppType });
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[debugconsole] FindConsoleInstance failed: {ex.Message}");
            return null;
        }
    }
    private static void ShowConfiguredCommands(object instance)
    {
        try
        {
            if (_consoleType is null) return;
            _setConsoleText ??= AccessTools.Method(_consoleType, "SetConsoleText", new[] { typeof(string) });
            if (_setConsoleText is null)
            {
                DebugMod.Log.Warning($"[debugconsole] SetConsoleText(string) not found; configured commands: {FormatConfiguredCommandsForLog()}");
                return;
            }
            _setConsoleText.Invoke(instance, new object[] { BuildConfiguredCommandText() });
            DebugMod.Log.Msg($"[debugconsole] displayed configured commands: {FormatConfiguredCommandsForLog()}");
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[debugconsole] failed to display configured commands: {ex.Message}");
        }
    }
    private static string BuildConfiguredCommandText()
    {
        return BuildCommandReferenceText("DorkNet debug commands", maxCommands: 80) + "\n\nType a command and press Enter.";
    }
    private static string ReadConsoleInput(object consoleInstance)
    {
        var input = FindConsoleInput(consoleInstance);
        return input is null ? string.Empty : ReadText(input);
    }
    private static void WriteConsoleOutput(object consoleInstance, string text)
    {
        try
        {
            if (_consoleType is not null)
            {
                _setConsoleText ??= AccessTools.Method(_consoleType, "SetConsoleText", new[] { typeof(string) });
                if (_setConsoleText is not null && _setConsoleText.DeclaringType?.IsInstanceOfType(consoleInstance) == true)
                {
                    try
                    {
                        _setConsoleText.Invoke(consoleInstance, new object[] { text });
                        return;
                    }
                    catch (TargetException)
                    {
                        // The live IL2CPP proxy can differ from the resolved wrapper type.
                    }
                }
            }
            var input = FindConsoleInput(consoleInstance);
            if (input is not null)
                SetText(input, text);
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[debugconsole] output write failed: {ex.Message}");
        }
    }
    private static object? FindConsoleInput(object consoleInstance)
    {
        foreach (var name in new[] { "KECJGKLKFGP", "inputField", "InputField" })
        {
            var value = GetMemberValue(consoleInstance, name);
            if (value is not null) return value;
        }
        var type = consoleInstance.GetType();
        foreach (var prop in type.GetProperties(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance))
        {
            if (!LooksLikeInputField(prop.PropertyType) || !prop.CanRead || prop.GetIndexParameters().Length != 0) continue;
            try { if (prop.GetValue(consoleInstance) is { } value) return value; } catch { }
        }
        foreach (var field in type.GetFields(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance))
        {
            if (!LooksLikeInputField(field.FieldType)) continue;
            try { if (field.GetValue(consoleInstance) is { } value) return value; } catch { }
        }
        return null;
    }
    private static bool LooksLikeInputField(Type type) =>
        type.Name.IndexOf("InputField", StringComparison.OrdinalIgnoreCase) >= 0 ||
        type.FullName?.IndexOf("InputField", StringComparison.OrdinalIgnoreCase) >= 0;
    private static string ReadText(object textObject)
    {
        try
        {
            var type = textObject.GetType();
            var prop = type.GetProperty("text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance)
                       ?? type.GetProperty("Text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
            if (prop is not null && prop.CanRead && prop.GetValue(textObject) is string s)
                return s;
            var getter = type.GetMethod("get_text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance, null, Type.EmptyTypes, null)
                         ?? type.GetMethod("get_Text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance, null, Type.EmptyTypes, null);
            return getter?.Invoke(textObject, Array.Empty<object>()) as string ?? string.Empty;
        }
        catch { return string.Empty; }
    }
    private static void SetText(object textObject, string text)
    {
        try
        {
            var type = textObject.GetType();
            var prop = type.GetProperty("text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance)
                       ?? type.GetProperty("Text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
            if (prop is not null && prop.CanWrite)
            {
                prop.SetValue(textObject, text);
                return;
            }
            var setter = type.GetMethod("set_text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance, null, new[] { typeof(string) }, null)
                         ?? type.GetMethod("set_Text", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance, null, new[] { typeof(string) }, null);
            setter?.Invoke(textObject, new object[] { text });
        }
        catch { }
    }
    public static string BuildCommandReferenceText(string header, int maxCommands = int.MaxValue)
    {
        var commands = GetAvailableCommands();
        var sb = new StringBuilder();
        sb.AppendLine(header);
        sb.AppendLine();
        if (commands.Count == 0)
        {
            sb.AppendLine("No DebugConsoleCommandConfig commands found.");
        }
        else
        {
            var visible = Math.Min(commands.Count, maxCommands);
            for (var i = 0; i < visible; i++)
                sb.AppendLine($"{i + 1}. {commands[i].Label}: {commands[i].Command}");
            if (visible < commands.Count)
            {
                sb.AppendLine();
                sb.AppendLine($"+ {commands.Count - visible} more commands available through the debug console.");
            }
        }
        return sb.ToString().TrimEnd();
    }
    internal static List<ConfiguredCommand> GetAvailableCommands()
    {
        if (_commandCache is not null) return _commandCache;
        var commands = new List<ConfiguredCommand>();
        var seen = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
        AddConfiguredCommands(commands, seen);
        AddRuntimeCommands(commands, seen);
        commands.Sort((a, b) => string.Compare(a.Label, b.Label, StringComparison.OrdinalIgnoreCase));
        _commandCache = commands;
        DebugMod.Log.Msg($"[debugconsole] command table loaded: {commands.Count} command(s)");
        return commands;
    }
    // Read-only one-shot diagnostic (Cfg.DumpDevCommands). Writes a full report
    // to UserData/dorknet-devcommands.txt: does a live DebugConsole exist, and
    // for every runtime command meta, does its declaring type resolve and does
    // a method with that name exist on it (i.e. is it actually callable on this
    // obfuscated build). Invokes NOTHING and touches no game UI — safe to run
    // in a live session. This is what turns the text-console path from guessing
    // into engineering: the resolvable/total tally says whether the feature is
    // buildable as-is or needs an obfuscation name map.
    // Returns true once it observes a populated runtime command table (so the
    // caller can stop retrying); false while the config singleton isn't up yet.
    public static bool DumpCommandDiagnostics()
    {
        var sb = new StringBuilder();
        int runtime = 0;
        void W(string s) { sb.Append(s).Append('\n'); DebugMod.Log.Msg("[devcmd] " + s); }
        try
        {
            // Force a fresh scan — an early call (before the config singleton
            // loads) must not poison the cache with an empty table.
            _commandCache = null;
            W("=== DorkNet dev-command diagnostic ===");
            if (!_consoleResolved) ResolveConsole();
            object? liveConsole = null;
            try { liveConsole = FindConsoleInstance(); } catch (Exception ex) { W($"FindConsoleInstance threw: {ex.Message}"); }
            W($"DebugConsole type resolved : {_consoleType?.FullName ?? "<none>"}");
            W($"DebugConsole live instance : {(liveConsole is null ? "NULL (UI shell not instantiated — text console can't be shown, would need our own UI)" : "FOUND (UI can be driven)")}");
            W($"toggle method             : {_toggleMethod?.Name ?? "<none>"}");
            W("");
            List<ConfiguredCommand> commands;
            try { commands = GetAvailableCommands(); }
            catch (Exception ex) { W($"GetAvailableCommands threw: {ex}"); commands = new List<ConfiguredCommand>(); }
            int typeOk = 0, methodOk = 0;
            var samplesOk = new List<string>();
            var samplesBad = new List<string>();
            foreach (var c in commands)
            {
                if (!c.HasRuntimeTarget) continue;
                runtime++;
                var resolvedType = TryResolveCommandType(c, out var t, out _) ? t : null;
                if (resolvedType is null)
                {
                    if (samplesBad.Count < 30)
                        samplesBad.Add($"  [no-type] {c.MethodName}  (declaring='{c.DeclaringType}' obf='{c.ObfuscatedDeclaringType}')");
                    continue;
                }
                typeOk++;
                var hasMethod = false;
                foreach (var m in resolvedType.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static | BindingFlags.Instance))
                    if (m.Name == c.MethodName) { hasMethod = true; break; }
                if (hasMethod)
                {
                    methodOk++;
                    if (samplesOk.Count < 40) samplesOk.Add($"  [OK] {resolvedType.Name}.{c.MethodName}");
                }
                else if (samplesBad.Count < 30)
                {
                    samplesBad.Add($"  [no-method] {resolvedType.Name}.{c.MethodName}  (type resolved, method name not present → obfuscated/stripped)");
                }
            }
            W($"total commands in table   : {commands.Count}");
            W($"runtime-target commands   : {runtime}");
            W($"  declaring type resolves : {typeOk}");
            W($"  method callable by name : {methodOk}   <-- this number decides feasibility");
            W("");
            W("--- sample CALLABLE commands ---");
            foreach (var s in samplesOk) W(s);
            W("");
            W("--- sample UNRESOLVED commands ---");
            foreach (var s in samplesBad) W(s);
            W("");
            W("--- FULL runtime command list (label | methodName | declaringType | obfuscatedDeclaringType) ---");
            foreach (var c in commands)
            {
                if (!c.HasRuntimeTarget) continue;
                sb.Append("  ").Append(c.Label).Append(" | ").Append(c.MethodName)
                  .Append(" | ").Append(c.DeclaringType).Append(" | ").Append(c.ObfuscatedDeclaringType).Append('\n');
            }
        }
        catch (Exception ex)
        {
            sb.Append("DIAGNOSTIC FAILED: ").Append(ex).Append('\n');
            DebugMod.Log.Warning($"[devcmd] diagnostic failed: {ex.Message}");
        }
        // Only persist the report once the table is actually populated, so an
        // early empty attempt doesn't overwrite a good report from a later try.
        if (runtime > 0)
        {
            try
            {
                var dir = Path.GetDirectoryName(DebugMod.DiagnosticsLogPath) ?? ".";
                var outPath = Path.Combine(dir, "dorknet-devcommands.txt");
                File.WriteAllText(outPath, sb.ToString());
                DebugMod.Log.Msg($"[devcmd] wrote {outPath} ({runtime} runtime commands)");
            }
            catch (Exception ex) { DebugMod.Log.Warning($"[devcmd] could not write report: {ex.Message}"); }
        }
        else
        {
            DebugMod.Log.Msg("[devcmd] command table not populated yet — will retry");
        }
        return runtime > 0;
    }
    private static bool TryFindCommand(string verb, out ConfiguredCommand command)
    {
        var commands = GetAvailableCommands();
        foreach (var candidate in commands)
        {
            if (!candidate.HasRuntimeTarget) continue;
            if (CommandMatches(candidate, verb))
            {
                command = candidate;
                return true;
            }
        }
        foreach (var candidate in commands)
        {
            if (CommandMatches(candidate, verb))
            {
                command = candidate;
                return true;
            }
        }
        command = default;
        return false;
    }
    private static bool CommandMatches(ConfiguredCommand command, string verb)
    {
        if (string.Equals(command.MethodName, verb, StringComparison.OrdinalIgnoreCase)) return true;
        if (string.Equals(command.Command, verb, StringComparison.OrdinalIgnoreCase)) return true;
        if (string.Equals(command.Label, verb, StringComparison.OrdinalIgnoreCase)) return true;
        var shortLabel = command.Label;
        var dot = shortLabel.LastIndexOf('.');
        if (dot >= 0 && dot < shortLabel.Length - 1)
            shortLabel = shortLabel[(dot + 1)..];
        if (string.Equals(shortLabel, verb, StringComparison.OrdinalIgnoreCase)) return true;
        var commandTokens = SplitCommandLine(command.Command);
        return commandTokens.Count > 0 && string.Equals(commandTokens[0], verb, StringComparison.OrdinalIgnoreCase);
    }
    private static void AddConfiguredCommands(List<ConfiguredCommand> commands, HashSet<string> seen)
    {
        foreach (var entry in DebugMod.Cfg.DevCommands)
        {
            if (string.IsNullOrWhiteSpace(entry)) continue;
            var split = entry.IndexOf('=');
            var label = split >= 0 ? entry[..split].Trim() : entry.Trim();
            var command = split >= 0 ? entry[(split + 1)..].Trim() : entry.Trim();
            if (string.IsNullOrWhiteSpace(command)) continue;
            if (string.IsNullOrWhiteSpace(label)) label = command;
            var parts = SplitCommandLine(command);
            var methodName = parts.Count > 0 ? parts[0] : command;
            AddCommand(commands, seen, label, command, declaringType: string.Empty, obfuscatedDeclaringType: string.Empty, methodName, isRuntime: false);
        }
    }
    private static void AddRuntimeCommands(List<ConfiguredCommand> commands, HashSet<string> seen)
    {
        try
        {
            var cfgType = DebugMod.ResolveType("RecRoom.Debugging.DebugConsoleCommandConfig");
            if (cfgType is null)
            {
                DebugMod.Log.Warning("[debugconsole] DebugConsoleCommandConfig type not found");
                return;
            }
            foreach (var method in cfgType.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static))
            {
                if (method.GetParameters().Length != 0) continue;
                if (!cfgType.IsAssignableFrom(method.ReturnType)) continue;
                try { AddCommandConfig(method.Invoke(null, Array.Empty<object>()), commands, seen); }
                catch { }
            }
            var il2cppType = ToIl2CppType(cfgType);
            var resources = DebugMod.ResolveType("UnityEngine.Resources");
            if (il2cppType is not null && resources is not null)
            {
                var all = OneArgMethod(resources, "FindObjectsOfTypeAll", il2cppType)?.Invoke(null, new[] { il2cppType });
                var count = ArrLen(all);
                for (var i = 0; i < count; i++)
                    AddCommandConfig(ArrItem(all, i), commands, seen);
            }
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[debugconsole] runtime command scan failed: {ex.Message}");
        }
    }
    private static void AddCommandConfig(object? config, List<ConfiguredCommand> commands, HashSet<string> seen)
    {
        if (config is null) return;
        var metas = GetMemberValue(config, "Metas");
        var count = ArrLen(metas);
        for (var i = 0; i < count; i++)
        {
            var meta = ArrItem(metas, i);
            if (meta is null) continue;
            var methodName = ReadStringMember(meta, "MethodName");
            if (string.IsNullOrWhiteSpace(methodName)) continue;
            var declaringType = ReadStringMember(meta, "DeclaringType");
            var obfuscatedDeclaringType = ReadStringMember(meta, "ObfuscatedDeclaringType");
            var label = string.IsNullOrWhiteSpace(declaringType)
                ? methodName
                : $"{ShortTypeName(declaringType)}.{methodName}";
            AddCommand(commands, seen, label, methodName, declaringType, obfuscatedDeclaringType, methodName, isRuntime: true);
        }
    }
    private static void AddCommand(List<ConfiguredCommand> commands, HashSet<string> seen, string label, string command,
                                   string declaringType, string obfuscatedDeclaringType, string methodName, bool isRuntime)
    {
        label = CleanLabel(label);
        command = (command ?? string.Empty).Trim();
        methodName = (methodName ?? string.Empty).Trim();
        if (command.Length == 0 || methodName.Length == 0) return;
        var key = isRuntime
            ? $"{NormalizeTypeName(obfuscatedDeclaringType)}|{NormalizeTypeName(declaringType)}|{methodName}"
            : $"configured|{label}|{command}";
        if (!seen.Add(key)) return;
        commands.Add(new ConfiguredCommand(label, command, declaringType, obfuscatedDeclaringType, methodName, isRuntime));
    }
    private static object? GetMemberValue(object instance, string name)
    {
        var type = instance.GetType();
        var prop = type.GetProperty(name, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
        if (prop is not null && prop.CanRead && prop.GetIndexParameters().Length == 0)
        {
            try { return prop.GetValue(instance); } catch { }
        }
        var field = type.GetField(name, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
        if (field is not null)
        {
            try { return field.GetValue(instance); } catch { }
        }
        return null;
    }
    private static string ReadStringMember(object instance, string name)
    {
        return GetMemberValue(instance, name)?.ToString() ?? string.Empty;
    }
    private static string CleanLabel(string label)
    {
        label = (label ?? string.Empty).Trim();
        if (label.Length == 0) return "Command";
        var cleaned = new char[label.Length];
        for (var i = 0; i < label.Length; i++)
        {
            var ch = label[i];
            cleaned[i] = char.IsLetterOrDigit(ch) || ch is '.' or '_' or '-' or ' ' ? ch : '_';
        }
        return new string(cleaned);
    }
    private static string ShortTypeName(string typeName)
    {
        var idx = typeName.LastIndexOf('.');
        return idx >= 0 && idx < typeName.Length - 1 ? typeName[(idx + 1)..] : typeName;
    }
    internal readonly struct ConfiguredCommand
    {
        public ConfiguredCommand(string label, string command, string declaringType,
                                 string obfuscatedDeclaringType, string methodName, bool hasRuntimeTarget)
        {
            Label = label;
            Command = command;
            DeclaringType = declaringType;
            ObfuscatedDeclaringType = obfuscatedDeclaringType;
            MethodName = methodName;
            HasRuntimeTarget = hasRuntimeTarget;
        }
        public string Label { get; }
        public string Command { get; }
        public string DeclaringType { get; }
        public string ObfuscatedDeclaringType { get; }
        public string MethodName { get; }
        public bool HasRuntimeTarget { get; }
    }
    private static void EnableShowButton()
    {
        if (_consoleType is null) return;
        try
        {
            var prop = _consoleType.GetProperty("ShowButton", BindingFlags.Public | BindingFlags.Static);
            if (prop is not null && prop.CanWrite) { prop.SetValue(null, true); return; }
            foreach (var name in new[] { "showButton", "IEGCNLHPKFH" })
            {
                var f = _consoleType.GetField(name, BindingFlags.NonPublic | BindingFlags.Static);
                if (f is not null && f.FieldType == typeof(bool)) { f.SetValue(null, true); return; }
            }
        }
        catch { /* best-effort — the toggle still works without it */ }
    }
    private static object? ToIl2CppType(Type managed)
    {
        try
        {
            var il2cppTypeType = DebugMod.ResolveType("Il2CppInterop.Runtime.Il2CppType");
            var from = il2cppTypeType?.GetMethod("From", new[] { typeof(Type), typeof(bool) })
                       ?? il2cppTypeType?.GetMethod("From", new[] { typeof(Type) });
            if (from is null) return null;
            var args = from.GetParameters().Length == 2
                ? new object[] { managed, true }
                : new object[] { managed };
            return from.Invoke(null, args);
        }
        catch { return null; }
    }
    private static MethodInfo? OneArgMethod(Type? type, string name, object arg)
    {
        if (type is null) return null;
        foreach (var method in type.GetMethods(BindingFlags.Public | BindingFlags.Static))
        {
            if (method.Name != name) continue;
            var parameters = method.GetParameters();
            if (parameters.Length == 1 && parameters[0].ParameterType.IsInstanceOfType(arg))
                return method;
        }
        return null;
    }
    private static int ArrLen(object? array)
    {
        if (array is null) return 0;
        if (array is Array managedArray) return managedArray.Length;
        var type = array.GetType();
        var length = type.GetProperty("Length") ?? type.GetProperty("Count");
        return (length?.GetValue(array) as int?) ?? 0;
    }
    private static object? ArrItem(object? array, int index)
    {
        if (array is null) return null;
        if (array is Array managedArray) return managedArray.GetValue(index);
        var getItem = array.GetType().GetMethod("get_Item", new[] { typeof(int) });
        return getItem?.Invoke(array, new object[] { index });
    }
 }
 internal static class MakerPenGiftPreviewPatches
 {
    private static bool _loggedMissingPointer;
    private static bool _loggedMissingRestrictionFlag;
    public static bool LaserPointerEnabled_Prefix(object __instance, bool ONGBFDACHHG)
    {
        try
        {
            if (__instance is null) return true;
            var t = __instance.GetType();
            if (ReadField(__instance, t, "pointerLineRenderer") is null)
            {
                if (!_loggedMissingPointer)
                {
                    _loggedMissingPointer = true;
                    DebugMod.Log.Msg("[makerpen-preview] skipped LaserPointerEnabled on MakerPenVisuals with no pointerLineRenderer");
                }
                return false;
            }
            if (ONGBFDACHHG && ReadField(__instance, t, "EANJBIDHAMN") is null)
            {
                if (!_loggedMissingRestrictionFlag)
                {
                    _loggedMissingRestrictionFlag = true;
                    DebugMod.Log.Msg("[makerpen-preview] skipped LaserPointerEnabled=true on MakerPenVisuals with no laser restriction flag");
                }
                return false;
            }
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[makerpen-preview] guard failed, letting original run: {ex.Message}");
        }
        return true;
    }
    private static object? ReadField(object instance, Type type, string name)
    {
        var field = AccessTools.Field(type, name) ?? AccessTools.Field(type.BaseType, name);
        return field?.GetValue(instance);
    }
 }
 internal static class AuthPatches
 {
    private static string? _latestAccessToken;
    private static int _tokenLogCount;
    public static void CaptureTokenArgs_Prefix(object? __0, object? __1, object? __2)
    {
        try
        {
            var accessToken = __0?.ToString();
            if (LooksLikeJwt(accessToken))
                _latestAccessToken = accessToken;
            if (_tokenLogCount++ < 3)
            {
                DiagnosticPatches.Write(
                    "[auth-trace] token setter " +
                    $"access={Presence(__0)} refresh={Presence(__1)} key={Presence(__2)}");
            }
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[auth-trace] token capture failed: {ex.Message}");
        }
    }
    private static bool LooksLikeJwt(string? value)
    {
        if (string.IsNullOrWhiteSpace(value)) return false;
        var dots = 0;
        foreach (var ch in value)
            if (ch == '.') dots++;
        return dots == 2;
    }
    private static string Presence(object? value) =>
        string.IsNullOrWhiteSpace(value?.ToString()) ? "missing" : "present";
 }
 internal static class HttpTracePatches
 {
    private const int BodyPreviewBytes = 700;
    private static readonly Regex SensitivePairRegex = new(
        @"(?i)(password|client_secret|access_token|accessToken|refresh_token|refreshToken|authorization|token|key)=([^&\s]+)",
        RegexOptions.Compiled);
    private static readonly Regex BearerRegex = new(
        @"(?i)Bearer\s+[-._~+/=A-Za-z0-9]+",
        RegexOptions.Compiled);
    private static readonly Regex SensitiveHeaderRegex = new(
        @"(?im)^(Authorization|Cookie|Set-Cookie|X-RNSIG):\s*[^\r\n]+",
        RegexOptions.Compiled);
    private static readonly Regex SensitiveJsonStringRegex = new(
        @"(?i)""([^""]*(?:access_token|accessToken|refresh_token|refreshToken|authorization|token|secret|client_secret|key)[^""]*)""\s*:\s*""[^""]*""",
        RegexOptions.Compiled);
    private static readonly Dictionary<IntPtr, string> RecNetRequestInfoByPtr = new();
    private static int _requestId;
    private static int _failureLogCount;
    private static int _responseTupleLogCount;
    private static int _builderSendLogCount;
    private static int _callbackLogCount;
    private static int _uriUnreadDumpCount;
    public static void RecNetRequestSend_Prefix(object __instance, MethodBase __originalMethod)
    {
        TraceRequestObject(__instance, $"{__originalMethod.DeclaringType?.Name}.{__originalMethod.Name}");
    }
    public static void RecNetRequestBuilderCtor_Prefix(object? __0, object? __1, object? __2)
    {
        var id = NextRequestId();
        DiagnosticPatches.Write(
            $"[http-trace] #{id} BNDIAONDFFF.ctor method={SanitizeInline(__0?.ToString() ?? "<null>")} " +
            $"service={SanitizeInline(__1?.ToString() ?? "<null>")} path={SanitizeInline(__2?.ToString() ?? "<null>")}");
    }
    public static void RecNetRequestBuilderCtor_Postfix(object __instance, object? __0, object? __1, object? __2)
    {
        try
        {
            var ptr = TryGetIl2CppPtr(__instance);
            if (ptr == IntPtr.Zero) return;
            var info =
                $"ptr=0x{ptr.ToInt64():X} method={SanitizeInline(__0?.ToString() ?? "<null>")} " +
                $"service={SanitizeInline(__1?.ToString() ?? "<null>")} path={SanitizeInline(__2?.ToString() ?? "<null>")}";
            lock (RecNetRequestInfoByPtr)
            {
                RecNetRequestInfoByPtr[ptr] = info;
                if (RecNetRequestInfoByPtr.Count > 256)
                    RecNetRequestInfoByPtr.Clear();
            }
            DiagnosticPatches.Write($"[recnet-request-map] {info}");
        }
        catch (Exception ex)
        {
            LogFailure("recnet-request-map", ex);
        }
    }
    public static void RecNetBuilderSend_Prefix(object __instance, MethodBase __originalMethod)
    {
        if (System.Threading.Interlocked.Increment(ref _builderSendLogCount) > 120) return;
        try
        {
            DiagnosticPatches.Write(
                $"[recnet-send] ENTER {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{LookupRecNetRequestInfo(__instance)} {DumpBndNativeFields(__instance)}");
        }
        catch (Exception ex)
        {
            LogFailure("recnet-send-enter", ex);
        }
    }
    public static void RecNetBuilderSend_Postfix(object __instance, MethodBase __originalMethod)
    {
        if (_builderSendLogCount > 120) return;
        try
        {
            DiagnosticPatches.Write(
                $"[recnet-send] EXIT {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{LookupRecNetRequestInfo(__instance)} {DumpBndNativeFields(__instance)}");
        }
        catch (Exception ex)
        {
            LogFailure("recnet-send-exit", ex);
        }
    }
    public static void RecNetResponseTuple_Prefix(object __instance, MethodBase __originalMethod)
    {
        if (System.Threading.Interlocked.Increment(ref _responseTupleLogCount) > 80) return;
        try
        {
            DiagnosticPatches.Write(
                $"[recnet-response-map] ENTER {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{LookupRecNetRequestInfo(__instance)} {DumpBndNativeFields(__instance)} {DumpObjectFields(__instance, 20, 600)}");
        }
        catch (Exception ex)
        {
            LogFailure("recnet-response-map-enter", ex);
        }
    }
    public static void RecNetResponseTuple_Postfix(object __instance, MethodBase __originalMethod)
    {
        if (_responseTupleLogCount > 80) return;
        try
        {
            DiagnosticPatches.Write(
                $"[recnet-response-map] EXIT {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{LookupRecNetRequestInfo(__instance)} {DumpBndNativeFields(__instance)} {DumpObjectFields(__instance, 20, 600)}");
        }
        catch (Exception ex)
        {
            LogFailure("recnet-response-map-exit", ex);
        }
    }
    public static Exception? RecNetResponseTuple_Finalizer(Exception? __exception, object __instance, MethodBase __originalMethod)
    {
        if (__exception is not null)
        {
            DiagnosticPatches.Write(
                $"[recnet-response-map] EXCEPTION {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{LookupRecNetRequestInfo(__instance)} {DumpBndNativeFields(__instance)} {RoomLoadDiagnostics.FormatException(__exception, __exception)} " +
                $"state={DumpObjectFields(__instance, 36, 1200)}");
        }
        return __exception;
    }
    public static void HeaderSet_Prefix(object __instance, object? __0, object? __1, MethodBase __originalMethod)
    {
        try
        {
            var name = __0?.ToString() ?? "<null>";
            var value = RedactHeaderValue(name, __1?.ToString());
            var uri = TryReadRequestUri(__instance)?.ToString() ?? "<uri unread>";
            DiagnosticPatches.Write(
                $"[http-header] {__originalMethod.DeclaringType?.Name}.{__originalMethod.Name} " +
                $"{SanitizeInline(uri)} {name}: {value}");
        }
        catch (Exception ex)
        {
            LogFailure("header", ex);
        }
    }
    public static void CallCallback_Prefix(object __instance, MethodBase __originalMethod)
    {
        try
        {
            DiagnosticPatches.Write(
                $"[http-callback] ENTER {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{DescribeRequestAndResponse(__instance)}");
        }
        catch (Exception ex)
        {
            LogFailure("callback-enter", ex);
        }
    }
    public static void CallCallback_Postfix(object __instance, MethodBase __originalMethod)
    {
        try
        {
            if (!ShouldLogCallback(__instance)) return;
            DiagnosticPatches.Write(
                $"[http-callback] EXIT {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                $"{DescribeRequestAndResponse(__instance)}");
        }
        catch (Exception ex)
        {
            LogFailure("callback-exit", ex);
        }
    }
    public static Exception? CallCallback_Finalizer(Exception? __exception, object __instance, MethodBase __originalMethod)
    {
        if (__exception is not null)
        {
            try
            {
                DiagnosticPatches.Write(
                    $"[http-callback] EXCEPTION {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name} " +
                    $"{DescribeRequestAndResponse(__instance)} " +
                    $"{RoomLoadDiagnostics.FormatException(__exception, __exception)} " +
                    $"state={DumpObjectFields(__instance, 32, 900)}");
            }
            catch (Exception ex)
            {
                LogFailure("callback-finalizer", ex);
            }
        }
        return __exception;
    }
    public static void TraceUrl(string? url, string source)
    {
        if (string.IsNullOrWhiteSpace(url)) return;
        if (!url.StartsWith("http://", StringComparison.OrdinalIgnoreCase) &&
            !url.StartsWith("https://", StringComparison.OrdinalIgnoreCase))
            return;
        var id = NextRequestId();
        DiagnosticPatches.Write($"[http-trace] #{id} {source} url={SanitizeInline(url)}");
    }
    public static void TraceRequestObject(object? request, string source)
    {
        if (request is null) return;
        try
        {
            var id = NextRequestId();
            var uriValue = TryReadRequestUri(request);
            var uri = uriValue?.ToString() ?? "<uri unread>";
            var method = TryReadHttpMethod(request);
            var headers = TryReadHeaders(request);
            var body = TryReadBodyPreview(request);
            var fallback = uriValue is null && System.Threading.Interlocked.Increment(ref _uriUnreadDumpCount) <= 40
                ? $" requestFields={DumpObjectFields(request, 24, 260)}"
                : "";
            DiagnosticPatches.Write(
                $"[http-trace] #{id} {source} method={method} uri={SanitizeInline(uri)} " +
                $"headers={headers} body={body}{fallback}");
        }
        catch (Exception ex)
        {
            LogFailure(source, ex);
        }
    }
    private static int NextRequestId() => System.Threading.Interlocked.Increment(ref _requestId);
    private static Uri? TryReadRequestUri(object request)
    {
        if (TryInvokeUriMethod(request, "KPKNHFBHPHO", out var uri)) return uri;
        if (TryInvokeUriMethod(request, "IBLHNHHBNNE", out uri)) return uri;
        const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
        var type = request.GetType();
        if (TryReadUriValue(type.GetProperty("Uri", flags)?.GetValue(request), out uri)) return uri;
        if (TryReadUriValue(type.GetProperty("CurrentUri", flags)?.GetValue(request), out uri)) return uri;
        if (TryReadUriValue(type.GetField("<Uri>k__BackingField", flags)?.GetValue(request), out uri)) return uri;
        foreach (var prop in type.GetProperties(flags))
        {
            if (prop.Name.IndexOf("Uri", StringComparison.OrdinalIgnoreCase) < 0) continue;
            if (!prop.CanRead || prop.GetIndexParameters().Length != 0) continue;
            try
            {
                if (TryReadUriValue(prop.GetValue(request), out uri)) return uri;
            }
            catch { }
        }
        foreach (var field in type.GetFields(flags))
        {
            if (field.Name.IndexOf("Uri", StringComparison.OrdinalIgnoreCase) < 0) continue;
            try
            {
                if (TryReadUriValue(field.GetValue(request), out uri)) return uri;
            }
            catch { }
        }
        return null;
    }
    private static bool TryInvokeUriMethod(object request, string methodName, out Uri? uri)
    {
        uri = null;
        try
        {
            var method = AccessTools.Method(request.GetType(), methodName, Type.EmptyTypes);
            if (method is null) return false;
            return TryReadUriValue(method.Invoke(request, Array.Empty<object>()), out uri);
        }
        catch
        {
            return false;
        }
    }
    private static bool TryReadUriValue(object? value, out Uri? uri)
    {
        uri = null;
        if (value is null) return false;
        if (value is Uri direct)
        {
            uri = direct;
            return true;
        }
        var text = value.ToString();
        if (Uri.TryCreate(text, UriKind.Absolute, out var parsed))
        {
            uri = parsed;
            return true;
        }
        return false;
    }
    private static string TryReadHttpMethod(object request)
    {
        foreach (var name in new[] { "MethodType", "Method", "LNJILMKOBIP" })
        {
            if (TryReadMemberValue(request, name, out var value))
                return SanitizeInline(value?.ToString() ?? "<null>");
        }
        return "<method unread>";
    }
    private static string TryReadHeaders(object request)
    {
        try
        {
            var dump = AccessTools.Method(request.GetType(), "DumpHeaders", Type.EmptyTypes);
            if (dump?.Invoke(request, Array.Empty<object>()) is object rawDump)
                return SanitizeInline(rawDump.ToString() ?? "<empty>");
        }
        catch { }
        var known = new List<string>();
        foreach (var name in new[]
        {
            "Authorization", "Cookie", "X-RNSIG", "Accept-Language",
            "Content-Type", "User-Agent"
        })
        {
            var value = TryReadHeaderValue(request, name);
            if (!string.IsNullOrWhiteSpace(value))
                known.Add($"{name}:{RedactHeaderValue(name, value)}");
        }
        return known.Count == 0 ? "<headers unread>" : string.Join("; ", known);
    }
    private static string? TryReadHeaderValue(object request, string name)
    {
        foreach (var methodName in new[] { "GetFirstHeaderValue", "FKHEHIMHHBP" })
        {
            try
            {
                var method = AccessTools.Method(request.GetType(), methodName, new[] { typeof(string) });
                var value = method?.Invoke(request, new object[] { name })?.ToString();
                if (!string.IsNullOrWhiteSpace(value)) return value;
            }
            catch { }
        }
        return null;
    }
    private static string TryReadBodyPreview(object request)
    {
        foreach (var methodName in new[] { "BGMFJOKNJAJ", "GetEntityBody" })
        {
            try
            {
                var method = AccessTools.Method(request.GetType(), methodName, Type.EmptyTypes);
                if (method is null) continue;
                var body = method.Invoke(request, Array.Empty<object>());
                var bytes = TryCopyBytes(body, BodyPreviewBytes + 1);
                if (bytes is null) continue;
                if (bytes.Length == 0) return "<empty>";
                var shown = Math.Min(bytes.Length, BodyPreviewBytes);
                var text = Encoding.UTF8.GetString(bytes, 0, shown);
                var suffix = bytes.Length > BodyPreviewBytes ? "...<truncated>" : "";
                return $"{bytes.Length} bytes \"{SanitizeInline(text)}{suffix}\"";
            }
            catch { }
        }
        return "<body unread>";
    }
    private static bool ShouldLogCallback(object request)
    {
        var response = TryReadResponseObject(request);
        var status = response is null ? null : TryReadStatusCode(response);
        if (status >= 400) return true;
        return System.Threading.Interlocked.Increment(ref _callbackLogCount) <= 80;
    }
    private static string DescribeRequestAndResponse(object request)
    {
        var uri = TryReadRequestUri(request)?.ToString() ?? "<uri unread>";
        var method = TryReadHttpMethod(request);
        var response = TryReadResponseObject(request);
        var responseText = response is null ? "<response unread>" : DescribeResponseObject(response);
        var requestState = DescribeKnownMembers(request, "State", "Exception", "Error", "IsCancellationRequested");
        return $"method={method} uri={SanitizeInline(uri)} request={requestState} response={responseText}";
    }
    private static object? TryReadResponseObject(object request)
    {
        foreach (var name in new[] { "Response", "response", "_response", "<Response>k__BackingField" })
        {
            if (TryReadMemberValue(request, name, out var value) && value is not null)
                return value;
        }
        const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
        foreach (var prop in request.GetType().GetProperties(flags))
        {
            if (prop.Name.IndexOf("Response", StringComparison.OrdinalIgnoreCase) < 0) continue;
            if (!prop.CanRead || prop.GetIndexParameters().Length != 0) continue;
            try
            {
                var value = prop.GetValue(request);
                if (value is not null) return value;
            }
            catch { }
        }
        foreach (var field in request.GetType().GetFields(flags))
        {
            if (field.Name.IndexOf("Response", StringComparison.OrdinalIgnoreCase) < 0) continue;
            try
            {
                var value = field.GetValue(request);
                if (value is not null) return value;
            }
            catch { }
        }
        return null;
    }
    private static int? TryReadStatusCode(object response)
    {
        if (TryReadMemberValue(response, "StatusCode", out var value))
        {
            try { return Convert.ToInt32(value); }
            catch { }
        }
        return null;
    }
    private static string DescribeResponseObject(object response)
    {
        var known = DescribeKnownMembers(response,
            "StatusCode", "Message", "IsSuccess", "DataAsText", "Data", "Exception", "Error");
        return $"{response.GetType().FullName} {{{known}}}";
    }
    private static string DescribeKnownMembers(object obj, params string[] names)
    {
        var parts = new List<string>();
        foreach (var name in names)
        {
            if (!TryReadMemberValue(obj, name, out var value)) continue;
            parts.Add($"{name}={FormatValue(value, 700)}");
        }
        return parts.Count == 0 ? "<no known members>" : string.Join("; ", parts);
    }
    private static string FormatValue(object? value, int limit)
    {
        if (value is null) return "null";
        if (value is byte[] bytes)
            return $"byte[{bytes.Length}]";
        if (value is IEnumerable enumerable && value is not string)
            return FormatEnumerable(enumerable, value.GetType(), limit);
        var text = value is Exception ex
            ? $"{ex.GetType().Name}: {ex.Message}"
            : value.ToString() ?? "<null>";
        text = SanitizeInline(text);
        return text.Length <= limit ? text : text[..limit] + "...<truncated>";
    }
    private static string FormatEnumerable(IEnumerable enumerable, Type type, int limit)
    {
        try
        {
            var parts = new List<string>();
            var countText = TryReadEnumerableCount(enumerable, out var count) ? count.ToString() : "?";
            var shown = 0;
            foreach (var item in enumerable)
            {
                if (shown++ >= 6)
                {
                    parts.Add("...");
                    break;
                }
                parts.Add(FormatValue(item, 180));
            }
            var rendered = $"{type.FullName} count={countText} [{string.Join(", ", parts)}]";
            return rendered.Length <= limit ? rendered : rendered[..limit] + "...<truncated>";
        }
        catch (Exception ex)
        {
            return $"{type.FullName} <enumeration failed {ex.GetType().Name}: {SanitizeInline(ex.Message)}>";
        }
    }
    private static bool TryReadEnumerableCount(IEnumerable enumerable, out int count)
    {
        count = 0;
        if (enumerable is ICollection collection)
        {
            count = collection.Count;
            return true;
        }
        try
        {
            var prop = enumerable.GetType().GetProperty("Count", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
            if (prop?.GetValue(enumerable) is int value)
            {
                count = value;
                return true;
            }
        }
        catch { }
        return false;
    }
    private static byte[]? TryCopyBytes(object? value, int limit)
    {
        if (value is null) return null;
        if (value is byte[] direct)
            return CopyLimited(direct, limit);
        if (value is IEnumerable enumerable)
        {
            var bytes = new List<byte>();
            foreach (var item in enumerable)
            {
                if (item is null) continue;
                try { bytes.Add(Convert.ToByte(item)); }
                catch { return null; }
                if (bytes.Count >= limit) break;
            }
            return bytes.ToArray();
        }
        return null;
    }
    private static byte[] CopyLimited(byte[] source, int limit)
    {
        var count = Math.Min(source.Length, limit);
        var copy = new byte[count];
        Array.Copy(source, copy, count);
        return copy;
    }
    private static bool TryReadMemberValue(object request, string name, out object? value)
    {
        value = null;
        const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
        var type = request.GetType();
        try
        {
            var prop = type.GetProperty(name, flags);
            if (prop is not null && prop.CanRead && prop.GetIndexParameters().Length == 0)
            {
                value = prop.GetValue(request);
                return true;
            }
        }
        catch { }
        try
        {
            var field = type.GetField(name, flags);
            if (field is not null)
            {
                value = field.GetValue(request);
                return true;
            }
        }
        catch { }
        try
        {
            var method = AccessTools.Method(type, name, Type.EmptyTypes);
            if (method is not null)
            {
                value = method.Invoke(request, Array.Empty<object>());
                return true;
            }
        }
        catch { }
        return false;
    }
    private static string DumpObjectFields(object? instance, int maxFields, int valueLimit)
    {
        if (instance is null) return "<null>";
        try
        {
            var type = instance.GetType();
            var parts = new List<string>();
            const BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
            foreach (var field in type.GetFields(flags))
            {
                if (parts.Count >= maxFields)
                {
                    parts.Add("...");
                    break;
                }
                object? value;
                try { value = field.GetValue(instance); }
                catch (Exception ex)
                {
                    parts.Add($"{field.Name}=<read failed {ex.GetType().Name}>");
                    continue;
                }
                parts.Add($"{field.Name}={FormatValue(value, valueLimit)}");
            }
            return $"{type.FullName} {{{string.Join("; ", parts)}}}";
        }
        catch (Exception ex)
        {
            return $"<field dump failed {ex.GetType().Name}: {SanitizeInline(ex.Message)}>";
        }
    }
    private static string LookupRecNetRequestInfo(object instance)
    {
        var ptr = TryGetIl2CppPtr(instance);
        if (ptr == IntPtr.Zero) return "ptr=<unread>";
        lock (RecNetRequestInfoByPtr)
        {
            return RecNetRequestInfoByPtr.TryGetValue(ptr, out var info)
                ? info
                : $"ptr=0x{ptr.ToInt64():X} request=<unmapped>";
        }
    }
    private static string DumpBndNativeFields(object? instance)
    {
        var ptr = TryGetIl2CppPtr(instance);
        if (ptr == IntPtr.Zero) return "native=<unread>";
        try
        {
            var method = Marshal.ReadByte(ptr, 16);
            var service = Marshal.ReadInt32(ptr, 20);
            var pathPtr = Marshal.ReadIntPtr(ptr, 24);
            var fieldsPtr = Marshal.ReadIntPtr(ptr, 32);
            var filesPtr = Marshal.ReadIntPtr(ptr, 40);
            var objectFieldsPtr = Marshal.ReadIntPtr(ptr, 48);
            var bodyKind = Marshal.ReadInt32(ptr, 56);
            var callbackPtr = Marshal.ReadIntPtr(ptr, 64);
            var path = ReadIl2CppString(pathPtr);
            return
                "native={" +
                $"method={method}; service={service}; path={SanitizeInline(path)}; " +
                $"pathPtr=0x{pathPtr.ToInt64():X}; fieldsPtr=0x{fieldsPtr.ToInt64():X}; " +
                $"filesPtr=0x{filesPtr.ToInt64():X}; objectFieldsPtr=0x{objectFieldsPtr.ToInt64():X}; " +
                $"bodyKind={bodyKind}; callbackPtr=0x{callbackPtr.ToInt64():X}" +
                "}";
        }
        catch (Exception ex)
        {
            return $"native=<dump failed {ex.GetType().Name}: {SanitizeInline(ex.Message)}>";
        }
    }
    private static string ReadIl2CppString(IntPtr ptr)
    {
        if (ptr == IntPtr.Zero) return "<null>";
        try
        {
            return IL2CPP.Il2CppStringToManaged(ptr) ?? "<null>";
        }
        catch (Exception ex)
        {
            return $"<string read failed 0x{ptr.ToInt64():X} {ex.GetType().Name}>";
        }
    }
    private static IntPtr TryGetIl2CppPtr(object? instance)
    {
        try
        {
            return instance is Il2CppObjectBase il2CppObject
                ? IL2CPP.Il2CppObjectBaseToPtrNotNull(il2CppObject)
                : IntPtr.Zero;
        }
        catch
        {
            return IntPtr.Zero;
        }
    }
    private static string RedactHeaderValue(string name, string? value)
    {
        if (string.IsNullOrWhiteSpace(value)) return "<empty>";
        if (name.Equals("Authorization", StringComparison.OrdinalIgnoreCase) ||
            name.Equals("Cookie", StringComparison.OrdinalIgnoreCase) ||
            name.Equals("Set-Cookie", StringComparison.OrdinalIgnoreCase) ||
            name.Equals("X-RNSIG", StringComparison.OrdinalIgnoreCase))
        {
            return "<redacted>";
        }
        return SanitizeInline(value);
    }
    private static string SanitizeInline(string value)
    {
        var redacted = SensitivePairRegex.Replace(value, "$1=<redacted>");
        redacted = BearerRegex.Replace(redacted, "Bearer <redacted>");
        redacted = SensitiveHeaderRegex.Replace(redacted, "$1: <redacted>");
        redacted = SensitiveJsonStringRegex.Replace(redacted, "\"$1\":\"<redacted>\"");
        redacted = redacted.Replace("\r", "\\r").Replace("\n", "\\n").Replace("\t", "\\t");
        return redacted.Length <= 1200 ? redacted : redacted[..1200] + "...<truncated>";
    }
    private static void LogFailure(string source, Exception ex)
    {
        if (_failureLogCount++ < 10)
            DebugMod.Log.Warning($"[http-trace] {source} failed: {ex.GetType().Name}: {ex.Message}");
    }
 }
 internal static class SavePatches
 {
    // Last DataBlobName parsed off a SubscriptionUpdateRoom push for
    // our currently-loaded room. Captured BEFORE the watch's caching
    // gate (Rooms.OnSubscriptionUpdateRoom early-outs on a repeat
    // (roomId, subRoomId) tuple — which is every post-save push for a
    // dorm). SetRoomDataBlobName_Prefix reads this to hijack the
    // would-be no-op setter call into a real transition.
    private static volatile string? s_lastPushedBlobName;
    private static long s_lastPushedRoomId;
    private static long s_lastPushedSubRoomId;
    // Hook on Notifications.OnNotificationReceived(string json). Fires for
    // every SignalR message before any handler dispatch. Parses the JSON
    // and, when the Id is SubscriptionUpdateRoom, stashes the new blob.
    public static void OnNotificationReceived_Prefix(string message)
    {
        try
        {
            if (string.IsNullOrEmpty(message)) return;
            // Fast reject: only parse JSON if it could plausibly be a
            // SubscriptionUpdateRoom payload. Saves cycles on the (very
            // frequent) RoomInstanceUpdate / PresenceUpdate / chat pushes.
            if (message.IndexOf("\"SubscriptionUpdateRoom\"", StringComparison.Ordinal) < 0)
                return;
            using var doc = System.Text.Json.JsonDocument.Parse(message);
            var root = doc.RootElement;
            if (root.ValueKind != System.Text.Json.JsonValueKind.Object) return;
            if (!root.TryGetProperty("Id", out var idEl) ||
                idEl.ValueKind != System.Text.Json.JsonValueKind.String ||
                !string.Equals(idEl.GetString(), "SubscriptionUpdateRoom", StringComparison.Ordinal))
                return;
            if (!root.TryGetProperty("Msg", out var msg) ||
                msg.ValueKind != System.Text.Json.JsonValueKind.Object) return;
            if (!msg.TryGetProperty("Room", out var room) ||
                room.ValueKind != System.Text.Json.JsonValueKind.Object) return;
            long roomId = 0;
            if (room.TryGetProperty("RoomId", out var ridEl) &&
                ridEl.ValueKind == System.Text.Json.JsonValueKind.Number)
                roomId = ridEl.GetInt64();
            if (!msg.TryGetProperty("Scenes", out var scenes) ||
                scenes.ValueKind != System.Text.Json.JsonValueKind.Array ||
                scenes.GetArrayLength() == 0) return;
            var first = scenes[0];
            long subRoomId = 0;
            if (first.TryGetProperty("RoomSceneId", out var sidEl) &&
                sidEl.ValueKind == System.Text.Json.JsonValueKind.Number)
                subRoomId = sidEl.GetInt64();
            if (!first.TryGetProperty("DataBlobName", out var blobEl) ||
                blobEl.ValueKind != System.Text.Json.JsonValueKind.String) return;
            var blob = blobEl.GetString();
            if (string.IsNullOrEmpty(blob)) return;
            s_lastPushedRoomId    = roomId;
            s_lastPushedSubRoomId = subRoomId;
            s_lastPushedBlobName  = blob;
            DebugMod.Log.Msg($"[save-reload-fix] captured push via OnNotificationReceived: roomId={roomId} subRoomId={subRoomId} blob={blob}");
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[save-reload-fix] OnNotificationReceived prefix failed: {ex.Message}");
        }
    }
    public static void OnSubscriptionUpdateRoom_Prefix(object message)
    {
        try
        {
            if (message is null) return;
            var dict = message;
            // The watch parses this dict as Dictionary<string, object>
            // via Util.GetKey. We need three keys: RoomId, SubRoomId,
            // and Scenes[0].DataBlobName. The Il2Cpp dict supports
            // get_Item(key) — call it via reflection.
            var getItem = dict.GetType().GetMethod("get_Item", new[] { typeof(string) });
            if (getItem is null) return;
            // The push wire shape from server (BuildRoomDetails) is
            // {"Room":{...}, "Scenes":[{...}], ...}. The Room id lives
            // on the Room sub-object; the scene's blob on Scenes[0].
            object? roomObj   = TryGet(dict, getItem, "Room");
            object? scenesObj = TryGet(dict, getItem, "Scenes");
            if (roomObj is null || scenesObj is null) return;
            long roomId    = 0;
            long subRoomId = 0;
            try
            {
                var roomItem = roomObj.GetType().GetMethod("get_Item", new[] { typeof(string) });
                if (roomItem is not null)
                {
                    var rid = roomItem.Invoke(roomObj, new object[] { "RoomId" });
                    if (rid is not null) roomId = Convert.ToInt64(rid.ToString());
                }
            }
            catch { /* roomId stays 0 — we'll log it and bail later */ }
            // Scenes is an IL2CPP List<RoomScene>. Take the first
            // (current dorm has one scene; multi-scene rooms target
            // Scenes[currentSubRoomId] specifically, but the post-save
            // push always carries the scene that was just saved).
            object? firstScene = null;
            try
            {
                var scenesIndexer = scenesObj.GetType().GetMethod("get_Item", new[] { typeof(int) });
                firstScene = scenesIndexer?.Invoke(scenesObj, new object[] { 0 });
            }
            catch { /* leave firstScene null */ }
            if (firstScene is null) return;
            string? newBlob = null;
            try
            {
                var sceneItem = firstScene.GetType().GetMethod("get_Item", new[] { typeof(string) });
                if (sceneItem is not null)
                {
                    var blob = sceneItem.Invoke(firstScene, new object[] { "DataBlobName" });
                    newBlob = blob?.ToString();
                    var sid = sceneItem.Invoke(firstScene, new object[] { "RoomSceneId" });
                    if (sid is not null) subRoomId = Convert.ToInt64(sid.ToString());
                }
            }
            catch { /* leave newBlob null */ }
            if (string.IsNullOrEmpty(newBlob)) return;
            s_lastPushedRoomId    = roomId;
            s_lastPushedSubRoomId = subRoomId;
            s_lastPushedBlobName  = newBlob;
            DebugMod.Log.Msg($"[save-reload-fix] captured SubscriptionUpdateRoom push: roomId={roomId} subRoomId={subRoomId} blob={newBlob}");
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[save-reload-fix] OnSubscriptionUpdateRoom prefix failed: {ex.Message}");
        }
    }
    private static object? TryGet(object dict, MethodInfo getItem, string key)
    {
        try { return getItem.Invoke(dict, new object[] { key }); }
        catch { return null; }
    }
    // RoomPersistenceManager.set_RoomDataBlobName runs the change-event
    // path only when the new value differs from the cached field. The
    // 2020 watch's post-save propagation reads from RoomInstance.DataBlob
    // (set by /goto, never updated by SubscriptionUpdateRoom), so on a
    // save it calls the setter with the OLD blob — a no-op that skips
    // OnRoomDataBlobNameChanged. The cached PersistedRoomData stays
    // pointed at the boot-time bytes, and PostSaveReloading deserializes
    // those over the live world — wiping any MakerPen object the user
    // just placed.
    //
    // Live trace evidence (Latest.log, dorm save at 17:14): the watch's
    // own set_RoomDataBlobName fires with old="v10" new="v10" ~900ms
    // after b__4 returns True, even though the SubscriptionUpdateRoom
    // push already carried Scenes[0].DataBlobName="v11".
    //
    // Strategy: intercept the setter. If the incoming value matches the
    // current value (no-op) AND Rooms.LocalRoomScene.DataBlobName has a
    // newer version (the freshly-pushed one), substitute that into the
    // value parameter so the real setter sees a transition and fires
    // OnRoomDataBlobNameChanged → DownloadRoomDataBlobAsync(newBlob).
    // Falls through silently when no override is needed.
    public static void SetRoomDataBlobName_Prefix(object __instance, ref string value)
    {
        string currentForLog = "<unread>";
        string sceneForLog   = "<unread>";
        string scenes0ForLog = "<unread>";
        try
        {
            if (__instance is null)
            {
                DebugMod.Log.Msg("[save-reload-fix] prefix: __instance null — skipping");
                return;
            }
            var rpmType = __instance.GetType();
            var blobNameProp = rpmType.GetProperty("RoomDataBlobName",
                BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
            if (blobNameProp is null)
            {
                DebugMod.Log.Msg($"[save-reload-fix] prefix: RoomDataBlobName property not found on {rpmType.FullName}");
                return;
            }
            currentForLog = (blobNameProp.GetValue(__instance) as string) ?? "<null>";
            var roomsType = FindGameType("RecNet.Rooms");
            if (roomsType is null)
            {
                DebugMod.Log.Msg("[save-reload-fix] prefix: RecNet.Rooms type not found");
                return;
            }
            var localScene = roomsType.GetProperty("LocalRoomScene",
                BindingFlags.Public | BindingFlags.Static)?.GetValue(null);
            if (localScene is not null)
                sceneForLog = (localScene.GetType().GetProperty("DataBlobName")?.GetValue(localScene) as string) ?? "<null>";
            var localDetails = roomsType.GetProperty("LocalRoomDetails",
                BindingFlags.Public | BindingFlags.Static)?.GetValue(null);
            if (localDetails is not null)
            {
                var scenes = localDetails.GetType().GetProperty("Scenes")?.GetValue(localDetails);
                if (scenes is not null)
                {
                    var indexer = scenes.GetType().GetMethod("get_Item", new[] { typeof(int) });
                    var first = indexer?.Invoke(scenes, new object[] { 0 });
                    if (first is not null)
                        scenes0ForLog = (first.GetType().GetProperty("DataBlobName")?.GetValue(first) as string) ?? "<null>";
                }
            }
            // Unconditional trace of EVERYTHING we read so we can see in
            // the log exactly why we did or didn't override.
            DebugMod.Log.Msg($"[save-reload-fix] prefix fired: value=\"{value}\" current=\"{currentForLog}\" " +
                        $"LocalRoomScene.DataBlobName=\"{sceneForLog}\" Scenes[0].DataBlobName=\"{scenes0ForLog}\" " +
                        $"lastPushedBlob=\"{s_lastPushedBlobName ?? "<unset>"}\"");
            // Pick a candidate "newer" blob name. Priority order:
            //   1. Last-pushed-from-SubscriptionUpdateRoom (captured by
            //      OnSubscriptionUpdateRoom_Prefix BEFORE the watch's
            //      cache gate drops the push).
            //   2. LocalRoomScene.DataBlobName.
            //   3. Scenes[0].DataBlobName.
            string? pushedBlob = s_lastPushedBlobName;
            if (string.IsNullOrEmpty(pushedBlob) || string.Equals(pushedBlob, currentForLog, StringComparison.Ordinal))
                pushedBlob = sceneForLog is "<unread>" or "<null>" ? null : sceneForLog;
            if (string.IsNullOrEmpty(pushedBlob) || string.Equals(pushedBlob, currentForLog, StringComparison.Ordinal))
                pushedBlob = scenes0ForLog is "<unread>" or "<null>" ? null : scenes0ForLog;
            if (string.IsNullOrEmpty(pushedBlob)) return;
            if (string.Equals(pushedBlob, value, StringComparison.Ordinal)) return;
            if (string.Equals(pushedBlob, currentForLog, StringComparison.Ordinal)) return;
            DebugMod.Log.Msg($"[save-reload-fix] hijacking set_RoomDataBlobName({value}); substituting newer blob {pushedBlob}");
            value = pushedBlob;
        }
        catch (Exception ex)
        {
            DebugMod.Log.Warning($"[save-reload-fix] set_RoomDataBlobName prefix failed: {ex.Message} " +
                            $"(value=\"{value}\" current=\"{currentForLog}\" scene=\"{sceneForLog}\" scenes0=\"{scenes0ForLog}\")");
        }
    }
    private static Type? FindGameType(string name) => DebugMod.ResolveType(name);
 }
 internal static class QuitTracePatches
 {
    public static bool ApplicationQuit_Prefix()
    {
        Write("[quit-trace] UnityEngine.Application.Quit()");
        WriteStack();
        return true;
    }
    public static bool ApplicationQuitInt_Prefix(int exitCode)
    {
        Write($"[quit-trace] UnityEngine.Application.Quit({exitCode})");
        WriteStack();
        if (exitCode == 1550502249 || exitCode == 533223478)
        {
            Write($"[quit-blocked] UnityEngine.Application.Quit fatal client exit {exitCode}");
            return false;
        }
        return true;
    }
    public static bool SessionManagerTryApplicationQuit_Prefix(MethodBase __originalMethod)
    {
        Write($"[quit-trace] {FormatOriginal(__originalMethod)}");
        WriteStack();
        return true;
    }
    public static bool SessionManagerTryApplicationQuitInt_Prefix(int DKOGJICFAEP, MethodBase __originalMethod)
    {
        Write($"[quit-trace] {FormatOriginal(__originalMethod)}({DKOGJICFAEP})");
        WriteStack();
        return true;
    }
    public static bool SessionManagerFatalApplicationQuit_Prefix(int DKOGJICFAEP, string EPAIMCEIMPA, MethodBase __originalMethod)
    {
        Write($"[quit-trace] {FormatOriginal(__originalMethod)}({DKOGJICFAEP}, {EPAIMCEIMPA})");
        WriteStack();
        return true;
    }
    public static void ApplicationWantsToQuit_Prefix(MethodBase __originalMethod)
    {
        Write($"[quit-trace] {FormatOriginal(__originalMethod)} wants-to-quit handler entered");
        WriteStack();
    }
    public static void CreateExitTask_Prefix(MethodBase __originalMethod)
    {
        Write($"[quit-trace] {FormatOriginal(__originalMethod)} creating exit task");
        WriteStack();
    }
    private static string FormatOriginal(MethodBase method)
    {
        return $"{method.DeclaringType?.FullName}.{method.Name}";
    }
    private static void Write(string message)
    {
        try { DebugMod.Log.Msg(message); } catch { }
    }
    private static void WriteStack()
    {
        try
        {
            Write("[quit-trace-stack] " + new StackTrace(skipFrames: 2, fNeedFileInfo: false));
        }
        catch (Exception ex)
        {
            Write("[quit-trace-stack] failed: " + ex.Message);
        }
    }
 }
 internal static class DiagnosticPatches
 {
    public static void Write(string message)
    {
        var line = $"[{DateTime.Now:HH:mm:ss.fff}] [diagnostic] {message}";
        try { DebugMod.Log.Msg(line); } catch { }
        try
        {
            if (!string.IsNullOrEmpty(DebugMod.DiagnosticsLogPath))
                File.AppendAllText(DebugMod.DiagnosticsLogPath, line + Environment.NewLine);
        }
        catch { }
    }
    public static bool ApplicationQuit_Prefix()
    {
        Write("[quit] UnityEngine.Application.Quit()");
        WriteStack();
        return true;
    }
    public static bool ApplicationQuitInt_Prefix(int exitCode)
    {
        Write($"[quit] UnityEngine.Application.Quit({exitCode})");
        WriteStack();
        return true;
    }
    public static void AnalyticsCheat_Prefix(MethodBase __originalMethod)
    {
        Write($"[cheat-analytics] {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name}");
        WriteStack();
    }
    public static void NamedMethod_Prefix(MethodBase __originalMethod)
    {
        Write($"[call] {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name}");
        WriteStack();
    }
    public static bool SessionManagerTryApplicationQuit_Prefix(MethodBase __originalMethod)
    {
        Write($"[quit-trace] {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name}");
        WriteStack();
        return true;
    }
    public static bool SessionManagerTryApplicationQuitInt_Prefix(int DKOGJICFAEP, MethodBase __originalMethod)
    {
        Write($"[quit-trace] {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name}({DKOGJICFAEP})");
        WriteStack();
        return true;
    }
    public static bool SessionManagerFatalApplicationQuit_Prefix(int DKOGJICFAEP, string EPAIMCEIMPA, MethodBase __originalMethod)
    {
        Write($"[quit-trace] {__originalMethod.DeclaringType?.FullName}.{__originalMethod.Name}({DKOGJICFAEP}, {EPAIMCEIMPA})");
        WriteStack();
        return true;
    }
    private static void WriteStack()
    {
        try
        {
            Write("[stack] " + new StackTrace(skipFrames: 2, fNeedFileInfo: false));
        }
        catch (Exception ex)
        {
            Write("[stack] failed: " + ex.Message);
        }
    }
 }
 internal static class ChatPatches
 {
    private static bool s_logged;
    // Force RecNet.AccountExtensions.CanLocalPlayerChat to return true.
    // PlayerEmotes.SendChatEmoteCoroutine d__53 offset 040 calls this
    // before raising the in-room Photon chat RPC; if it returns false
    // the coroutine bails silently and the sender doesn't even see
    // their own message echo.
    public static void CanLocalPlayerChat_Postfix(ref bool __result)
    {
        if (!__result && !s_logged)
        {
            s_logged = true;
            DebugMod.Log.Msg("[chat-fix] CanLocalPlayerChat returned false; forcing true to unblock room chat");
        }
        __result = true;
    }
    // Skip the original. Returning false from a Harmony prefix stops
    // the underlying call.
    public static bool RemoveInvalidCharactersFromMessage_Prefix()
    {
        DebugMod.Log.Msg("[chat-trace] RemoveInvalidCharactersFromMessage skipped");
        return false;
    }
    public static void SendChatEmote_Prefix(string message)
    {
        DebugMod.Log.Msg($"[chat-trace] SendChatEmote msg=\"{message}\"");
    }
    public static void ProcessNewChatMessageReceived_Prefix(string message, bool playAudioForLocalPlayer)
    {
        DebugMod.Log.Msg($"[chat-trace] ProcessNewChatMessageReceived msg=\"{message}\" audio={playAudioForLocalPlayer}");
    }
    public static void RpcChatEmote_Prefix(string message)
    {
        DebugMod.Log.Msg($"[chat-trace] RpcChatEmote (RPC RECEIVED) msg=\"{message}\"");
    }
 }
 internal static class RegistrationPatches
 {
    private static bool s_loggedFullyReg;
    // RRUI.Data.NUX.RegistrationModel.IsFullyRegistered() — postfix reads
    // (does NOT modify) the return value. False ⇒ the dorm raises the
    // "Change Username?" prompt; true ⇒ no prompt. Logged once so the file
    // stays readable (it's polled from several call sites every boot).
    public static void IsFullyRegistered_Postfix(bool __result)
    {
        if (!s_loggedFullyReg)
        {
            s_loggedFullyReg = true;
            DiagnosticPatches.Write($"[reg-trace] RegistrationModel.IsFullyRegistered() = {__result}  ({(__result ? "no prompt — fully registered" : "NOT registered → dorm will raise the Change Username? prompt")})");
        }
    }
    // DormroomSceneManager.<PromptForRegistration>b__6_* lambdas. b__6_1 is
    // the dialog-response handler (a dialog was shown). Names reach the
    // prefix via __originalMethod so we can tell which branch ran.
    public static void PromptLambda_Prefix(MethodBase __originalMethod)
    {
        DiagnosticPatches.Write($"[reg-trace] DormroomSceneManager prompt lambda fired: {__originalMethod.Name}");
    }
    // ConfirmUIDialog button handlers. If one of these fires when the user
    // taps a dialog button but the modal stays open, the break is in the
    // resolve/hide completer (UIDialog`1.Respond's close path) — not input
    // routing. "Okay" on the screenshot is Button_Affirmative.
    public static bool ButtonAffirmative_Prefix(object __instance)
    {
        DiagnosticPatches.Write("[reg-trace] >>> ConfirmUIDialog.Button_Affirmative pressed (this is 'Okay')");
        if (!IsRegistrationWarningDialog(__instance))
        {
            return true;
        }
        if (TryResolveAffirmativeWithoutClose(__instance))
        {
            DiagnosticPatches.Write("[registration-fix] resolved first-dorm registration warning without the broken close-before-resolve path");
            return false;
        }
        DiagnosticPatches.Write("[registration-fix] registration warning matched, but reflection resolve failed; falling back to original button handler");
        return true;
    }
    public static void ButtonNegative_Prefix() =>
        DiagnosticPatches.Write("[reg-trace] >>> ConfirmUIDialog.Button_Negative pressed");
    public static void ButtonNotNow_Prefix() =>
        DiagnosticPatches.Write("[reg-trace] >>> ConfirmUIDialog.Button_NotNow pressed");
    public static void ButtonCancel_Prefix() =>
        DiagnosticPatches.Write("[reg-trace] >>> ConfirmUIDialog.Button_Cancel pressed");
    private static bool IsRegistrationWarningDialog(object instance)
    {
        var title = ReadTextField(instance, "titleText");
        var body = ReadTextField(instance, "bodyText");
        return Contains(title, "Change Username")
            && Contains(body, "permanently lost")
            && Contains(body, "password");
    }
    private static bool TryResolveAffirmativeWithoutClose(object instance)
    {
        try
        {
            var respond = AccessTools.Method(instance.GetType(), "Respond");
            if (respond is null)
            {
                respond = AccessTools.Method(instance.GetType().BaseType, "Respond");
            }
            if (respond is null)
            {
                return false;
            }
            var parameters = respond.GetParameters();
            if (parameters.Length != 2)
            {
                return false;
            }
            var response = CreateAffirmativeResponse(parameters[0].ParameterType);
            respond.Invoke(instance, new[] { response, (object)false });
            return true;
        }
        catch (Exception ex)
        {
            DiagnosticPatches.Write($"[registration-fix] resolve failed: {ex.GetType().Name}: {ex.Message}");
            return false;
        }
    }
    private static object CreateAffirmativeResponse(Type responseType)
    {
        if (responseType.IsEnum)
        {
            return Enum.ToObject(responseType, 1);
        }
        return Convert.ChangeType(1, responseType);
    }
    private static string? ReadTextField(object instance, string fieldName)
    {
        try
        {
            var field = AccessTools.Field(instance.GetType(), fieldName);
            var textObject = field?.GetValue(instance);
            if (textObject is null)
            {
                return null;
            }
            var property = AccessTools.Property(textObject.GetType(), "text");
            if (property?.GetValue(textObject) is string text)
            {
                return text;
            }
            var getter = AccessTools.Method(textObject.GetType(), "get_text");
            return getter?.Invoke(textObject, Array.Empty<object>()) as string;
        }
        catch (Exception ex)
        {
            DiagnosticPatches.Write($"[registration-fix] could not read {fieldName}: {ex.GetType().Name}: {ex.Message}");
            return null;
        }
    }
    private static bool Contains(string? value, string fragment)
    {
        return value?.IndexOf(fragment, StringComparison.OrdinalIgnoreCase) >= 0;
    }
 }
 internal static class JoinPatches
 {
    // AGUI.StackedUI.HomeScreenFlow.Button_DormRoom() — the watch's
    // "Dorm Room" button. If this never fires, the button's UnityEvent
    // binding is the problem, not the join chain.
    public static void ButtonDormRoom_Prefix()
    {
        DiagnosticPatches.Write("[join-trace] >>> watch DORM ROOM button pressed (HomeScreenFlow.Button_DormRoom)");
    }
    // Any SessionManager.RunJoinRoom overload. We DON'T read argument
    // values here: Harmony's `object[] __args` forces a trampoline that
    // boxes the obfuscated IL2CPP reference-type params (KMKPEOGJDFK,
    // RoomInstance, …), and MonoMod fatal-CLRs (0x80131506) compiling it
    // when the boot-time dorm auto-join first calls this method. Logging
    // the overload's parameter *types* (pure reflection metadata, no value
    // boxing) is enough to tell which overload fired — the entry overload
    // (String,…) is the "DormRoom" press; the others are inner legs.
    public static void RunJoinRoom_Prefix(MethodBase __originalMethod)
    {
        DiagnosticPatches.Write($"[join-trace] SessionManager.RunJoinRoom  [{Sig(__originalMethod)}]");
    }
    // OJMCBOKJFOF.NHBPIIGDAJP(name|id) — the get-room-by-name / by-id
    // resolver that feeds the join. __0 is the single first param: a room
    // NAME string (String overload) or room ID (Int64 overload). Reading
    // it via `object __0` is safe — it's a string/long, not one of the
    // obfuscated ref-types that crashed `object[] __args`. This is the
    // value we need to compare boot (works) vs button (fails).
    public static void Goto_Prefix(MethodBase __originalMethod, object __0)
    {
        var arg = __0?.ToString() ?? "<null>";
        DiagnosticPatches.Write($"[join-trace] /goto resolve {__originalMethod.DeclaringType?.Name}.{__originalMethod.Name}(\"{arg}\")  [{Sig(__originalMethod)}]");
    }
    // RunJoinRoom promise-chain callbacks (SessionManager <>c lambdas).
    // b__165_1 is the reject handler that raises the "An error occured /
    // contact recroom.happyfox.com" toast — so if THIS name appears, the
    // join failed; the success legs (other b__*) firing means it advanced.
    // (Same __args/0x80131506 constraint as above — name only.)
    public static void JoinCallback_Prefix(MethodBase __originalMethod)
    {
        DiagnosticPatches.Write($"[join-trace] RunJoinRoom callback {__originalMethod.DeclaringType?.Name}.{__originalMethod.Name}");
    }
    // Dedicated capture for the reject handler b__165_1(string error) —
    // the answer to "why did the join fail". Single string param, so
    // `object __0` is safe (same as OnCustomAuthenticationFailed). This
    // is the string that becomes the happyfox toast.
    public static void JoinError_Prefix(object __0)
    {
        var err = __0?.ToString() ?? "<null>";
        DiagnosticPatches.Write($"[join-trace] !!! RunJoinRoom REJECTED — error=\"{err}\"  (raises the happyfox toast)");
    }
    // Parameter-type list from reflection metadata only — never reads
    // instance values, so it can't trigger the MonoMod trampoline crash.
    private static string Sig(MethodBase m)
    {
        var ps = m.GetParameters();
        var names = new List<string>(ps.Length);
        foreach (var p in ps) names.Add(p.ParameterType.Name);
        return $"{ps.Length} args: {string.Join(",", names)}";
    }
 }
@@ -1,56 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <!--
    DorkNet.DebugMod — the opt-in debugging companion to DorkNet.ClientMod.
    The shipping ClientMod carries ONLY the patches needed to connect and
    survive anti-cheat. ALL of the verbose diagnostic/tracing code (HTTP
    tracing, join/quit/studio/room-load traces, the process-exception sink,
    auth-token tracing, the registration-dialog trace, the in-game
    DebugConsole enable path) lives in THIS mod. Drop this dll into the
    Mods folder next to DorkNet.ClientMod.dll to debug; remove it to ship a
    quiet, minimal client.
    Fully self-contained: its own Harmony instance + its own copy of the
    reflection/patch helpers, so it never couples to ClientMod at load time.
    Debug knobs are read from the same UserData\dorknet-clientmod.json.
    Build:  dotnet build DorkNet.DebugMod/DorkNet.DebugMod.csproj -c Release
  -->
  <PropertyGroup>
    <TargetFramework Condition="'$(TargetFramework)' == ''">net6.0</TargetFramework>
    <LangVersion>latest</LangVersion>
    <Nullable>enable</Nullable>
    <RootNamespace>DorkNet.DebugMod</RootNamespace>
    <AssemblyName>DorkNet.DebugMod</AssemblyName>
    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
    <CopyLocalLockFileAssemblies>false</CopyLocalLockFileAssemblies>
    <NoWarn>$(NoWarn);CS8602;CS8604;CS0436</NoWarn>
  </PropertyGroup>
  <!-- Reuse the MelonLoader the ClientMod build already downloads. -->
  <PropertyGroup>
    <MelonLoaderDir Condition="'$(MelonLoaderDir)' == ''">$(MSBuildThisFileDirectory)..\DorkNet.ClientMod\build\melonloader\MelonLoader\net6</MelonLoaderDir>
  </PropertyGroup>
  <ItemGroup>
    <Reference Include="MelonLoader">
      <HintPath>$(MelonLoaderDir)\MelonLoader.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="0Harmony">
      <HintPath>$(MelonLoaderDir)\0Harmony.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="Il2CppInterop.Runtime">
      <HintPath>$(MelonLoaderDir)\Il2CppInterop.Runtime.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="Il2CppInterop.Common">
      <HintPath>$(MelonLoaderDir)\Il2CppInterop.Common.dll</HintPath>
      <Private>false</Private>
    </Reference>
  </ItemGroup>
 </Project>
@@ -1,18 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Yarp.ReverseProxy" Version="2.3.0" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\DorkNet.Contracts\DorkNet.Contracts.csproj" />
    <ProjectReference Include="..\DorkNet.ServiceDefaults\DorkNet.ServiceDefaults.csproj" />
  </ItemGroup>
 </Project>
@@ -1,351 +0,0 @@
 using DorkNet.Contracts;
 using DorkNet.ServiceDefaults;
 using Microsoft.Extensions.Options;
 using Yarp.ReverseProxy.Configuration;
 var builder = WebApplication.CreateBuilder(args);
 builder.Configuration.AddJsonFile("appsettings.Local.json",
    optional: true, reloadOnChange: true);
 builder.AddDorkNetServiceDefaults(ServiceNames.Gateway);
 builder.Services.Configure<DorkNetServiceMapOptions>(
    builder.Configuration.GetSection("DorkNet:Services"));
 var serviceMap = builder.Configuration
    .GetSection("DorkNet:Services")
    .Get<DorkNetServiceMapOptions>() ?? new DorkNetServiceMapOptions();
 var apexDomain = builder.Configuration["Domain:Apex"]
    ?? Environment.GetEnvironmentVariable("DORKNET_DOMAIN")
    ?? "localhost";
 builder.Services
    .AddReverseProxy()
    .LoadFromMemory(
        BuildRoutes(apexDomain, serviceMap),
        BuildClusters(serviceMap));
 var app = builder.Build();
 app.MapDorkNetServiceDefaults();
 app.MapGet("/internal/services", (IOptions<DorkNetServiceMapOptions> options) =>
    Results.Ok(options.Value.Endpoints()));
 app.MapGet("/internal/routes", () =>
    Results.Ok(new
    {
        ApexDomain = apexDomain,
        Routes = BuildRoutes(apexDomain, serviceMap).Select(r => new
        {
            r.RouteId,
            r.ClusterId,
            r.Match.Hosts,
            r.Match.Path,
            r.Order,
        }),
    }));
 app.MapGet("/internal/services/health", async (
    IOptions<DorkNetServiceMapOptions> options,
    IHttpClientFactory httpClientFactory,
    CancellationToken ct) =>
 {
    var client = httpClientFactory.CreateClient();
    var probes = new List<ServiceProbeResponse>();
    foreach (var endpoint in options.Value.Endpoints())
    {
        probes.Add(await ProbeServiceAsync(client, endpoint, ct));
    }
    return Results.Ok(probes);
 });
 app.MapReverseProxy();
 app.Run();
 static async Task<ServiceProbeResponse> ProbeServiceAsync(
    HttpClient client,
    DorkNetServiceEndpoint endpoint,
    CancellationToken ct)
 {
    var checkedAt = DateTimeOffset.UtcNow;
    var baseUrl = endpoint.BaseUrl.TrimEnd('/');
    try
    {
        using var response = await client.GetAsync($"{baseUrl}/internal/healthz", ct);
        return new ServiceProbeResponse(
            endpoint.Name,
            endpoint.BaseUrl,
            response.IsSuccessStatusCode ? "ok" : "unhealthy",
            (int)response.StatusCode,
            null,
            checkedAt);
    }
    catch (Exception ex) when (ex is HttpRequestException or TaskCanceledException)
    {
        return new ServiceProbeResponse(
            endpoint.Name,
            endpoint.BaseUrl,
            "unreachable",
            null,
            ex.Message,
            checkedAt);
    }
 }
 static IReadOnlyList<RouteConfig> BuildRoutes(
    string apexDomain,
    DorkNetServiceMapOptions services)
 {
    var routes = new List<RouteConfig>();
    var order = 0;
    var webGroup = DorkNetRouteOwnership.RouteGroups
        .First(group => group.ServiceName == ServiceNames.Web);
    AddHostRoute(
        routes,
        ref order,
        webGroup.ServiceName,
        BaseUrlFor(services, webGroup.ServiceName),
        "web-admin-host",
        [SubdomainHost("admin", apexDomain)]);
    AddHostRoute(
        routes,
        ref order,
        webGroup.ServiceName,
        BaseUrlFor(services, webGroup.ServiceName),
        "web-feed-host",
        [SubdomainHost("feed", apexDomain)]);
    AddHostPathRoutes(
        routes,
        ref order,
        webGroup.ServiceName,
        BaseUrlFor(services, webGroup.ServiceName),
        WebBrowserHosts(apexDomain),
        [
            "/admin",
            "/assets",
            "/brand",
            "/feed",
            "/join",
            "/p",
            "/photo",
            "/players",
            "/rooms",
            "/u",
        ]);
    foreach (var group in DorkNetRouteOwnership.RouteGroups.Where(group => group.ServiceName != ServiceNames.Web))
    {
        AddHostRoute(
            routes,
            ref order,
            group.ServiceName,
            BaseUrlFor(services, group.ServiceName),
            $"{group.ServiceName}-hosts",
            group.HostSubdomains.Select(subdomain => SubdomainHost(subdomain, apexDomain)).ToArray());
    }
    foreach (var group in DorkNetRouteOwnership.RouteGroups)
    {
        AddPathRoutes(
            routes,
            ref order,
            group.ServiceName,
            BaseUrlFor(services, group.ServiceName),
            group.PathPrefixes);
    }
    AddHostRoute(
        routes,
        ref order,
        webGroup.ServiceName,
        BaseUrlFor(services, webGroup.ServiceName),
        "web-hosts",
        BuildWebHosts(webGroup, apexDomain));
    if (!string.IsNullOrWhiteSpace(services.Monolith))
    {
        routes.Add(Route(ServiceNames.Monolith, "monolith-fallback", "/{**catch-all}", order++));
    }
    return routes;
 }
 static IReadOnlyList<ClusterConfig> BuildClusters(DorkNetServiceMapOptions services)
 {
    var clusters = new List<ClusterConfig>();
    foreach (var endpoint in services.Endpoints())
    {
        AddCluster(clusters, endpoint.Name, endpoint.BaseUrl);
    }
    return clusters;
 }
 static string[] WebBrowserHosts(string apexDomain)
 {
    return [apexDomain, SubdomainHost("www", apexDomain)];
 }
 static void AddHostRoute(
    List<RouteConfig> routes,
    ref int order,
    string serviceName,
    string baseUrl,
    string routeId,
    string[] hosts)
 {
    if (string.IsNullOrWhiteSpace(baseUrl) || hosts.Length == 0)
    {
        return;
    }
    routes.Add(Route(
        serviceName,
        routeId,
        "/{**catch-all}",
        order++,
        hosts));
 }
 static void AddPathRoutes(
    List<RouteConfig> routes,
    ref int order,
    string serviceName,
    string baseUrl,
    IEnumerable<string> paths)
 {
    if (string.IsNullOrWhiteSpace(baseUrl))
    {
        return;
    }
    foreach (var path in paths)
    {
        var routeId = $"{serviceName}-{path.Trim('/').Replace('/', '-').Replace("{**catch-all}", "all")}";
        var exactPath = NormalizeRoutePrefix(path);
        routes.Add(Route(serviceName, $"{routeId}-exact", exactPath, order++));
        routes.Add(Route(serviceName, routeId, $"{exactPath}/{{**catch-all}}", order++));
    }
 }
 static void AddHostPathRoutes(
    List<RouteConfig> routes,
    ref int order,
    string serviceName,
    string baseUrl,
    string[] hosts,
    IEnumerable<string> paths)
 {
    if (string.IsNullOrWhiteSpace(baseUrl) || hosts.Length == 0)
    {
        return;
    }
    foreach (var path in paths)
    {
        var routeId = $"{serviceName}-browser-{path.Trim('/').Replace('/', '-').Replace("{**catch-all}", "all")}";
        var exactPath = NormalizeRoutePrefix(path);
        routes.Add(Route(serviceName, $"{routeId}-exact", exactPath, order++, hosts));
        routes.Add(Route(serviceName, routeId, $"{exactPath}/{{**catch-all}}", order++, hosts));
    }
 }
 static string BaseUrlFor(DorkNetServiceMapOptions services, string serviceName)
 {
    return serviceName switch
    {
        ServiceNames.Identity => services.Identity,
        ServiceNames.Rooms => services.Rooms,
        ServiceNames.Notify => services.Notify,
        ServiceNames.Content => services.Content,
        ServiceNames.Social => services.Social,
        ServiceNames.Commerce => services.Commerce,
        ServiceNames.Platform => services.Platform,
        ServiceNames.Moderation => services.Moderation,
        ServiceNames.Web => services.Web,
        ServiceNames.Monolith => services.Monolith,
        _ => string.Empty,
    };
 }
 static string[] BuildWebHosts(DorkNetRouteGroup group, string apexDomain)
 {
    var hosts = new List<string>();
    if (group.IncludesApexHost)
    {
        hosts.Add(apexDomain);
    }
    hosts.AddRange(group.HostSubdomains
        .Where(subdomain => !string.Equals(subdomain, "admin", StringComparison.OrdinalIgnoreCase))
        .Select(subdomain => SubdomainHost(subdomain, apexDomain)));
    return hosts.ToArray();
 }
 static string SubdomainHost(string subdomain, string apexDomain)
 {
    return $"{subdomain}.{apexDomain}";
 }
 static string NormalizeRoutePrefix(string path)
 {
    if (string.IsNullOrWhiteSpace(path) || path == "/")
    {
        return "/";
    }
    return (path[0] == '/' ? path : "/" + path).TrimEnd('/');
 }
 static RouteConfig Route(
    string clusterId,
    string routeId,
    string path,
    int order,
    string[]? hosts = null)
 {
    return new RouteConfig
    {
        RouteId = routeId,
        ClusterId = clusterId,
        Order = order,
        Match = new RouteMatch
        {
            Hosts = hosts,
            Path = path,
        },
        Transforms =
        [
            new Dictionary<string, string>
            {
                ["RequestHeaderOriginalHost"] = "true",
            },
        ],
    };
 }
 static void AddCluster(
    List<ClusterConfig> clusters,
    string serviceName,
    string baseUrl)
 {
    if (string.IsNullOrWhiteSpace(baseUrl))
    {
        return;
    }
    var address = baseUrl.EndsWith('/') ? baseUrl : baseUrl + "/";
    clusters.Add(new ClusterConfig
    {
        ClusterId = serviceName,
        Destinations = new Dictionary<string, DestinationConfig>
        {
            ["primary"] = new() { Address = address },
        },
    });
 }
@@ -1,23 +0,0 @@
 {
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "System.Net.Http.HttpClient": "Warning"
    }
  },
  "DorkNet": {
    "Services": {
      "Identity": "http://localhost:8081",
      "Rooms": "http://localhost:8082",
      "Notify": "http://localhost:8083",
      "Content": "http://localhost:8084",
      "Social": "http://localhost:8085",
      "Commerce": "http://localhost:8086",
      "Platform": "http://localhost:8087",
      "Moderation": "http://localhost:8088",
      "Web": "http://localhost:8089",
      "Monolith": "http://localhost:8090"
    }
  }
 }
@@ -1,36 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Auth;
 /// <summary>
 /// Login.CachedLogin — dump.cs:578388, Deserialize at RVA 0x1447BD0.
 ///
 /// Verified by disassembly: reads platform, platformId, accountId,
 /// lastLoginTime (DateTime), requirePassword (default false). The Account
 /// field on the C# class is NOT read from the JSON dict — it is set via
 /// SetAccount(Account) after the fact, so the JSON shape doesn't need it.
 ///
 /// Returned by:
 ///   GET auth.rec.net/cachedlogin/forplatformid/{platform}/{platformId}
 ///   GET api.rec.net/api/platformlogin/cached
 ///   GET accounts.rec.net/account/v1/savedlogins
 /// as a List&lt;CachedLogin&gt;. Empty list = no remembered accounts.
 /// </summary>
 public class CachedLogin
 {
    // PlatformManager.PlatformType (int)
    [JsonPropertyName("platform")]
    public int Platform { get; set; }
    [JsonPropertyName("platformId")]
    public string PlatformId { get; set; } = string.Empty;
    [JsonPropertyName("accountId")]
    public int AccountId { get; set; }
    [JsonPropertyName("lastLoginTime")]
    public DateTime LastLoginTime { get; set; } = DateTime.UtcNow;
    [JsonPropertyName("requirePassword")]
    public bool RequirePassword { get; set; } = false;
 }
@@ -1,9 +0,0 @@
 namespace DorkNet.Models.Auth;
 public class LoginRequest
 {
    public string? Name { get; set; }
    public long BuildTimestamp { get; set; }
    public int Platform { get; set; }
    public string? DeviceId { get; set; }
 }
@@ -1,39 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Auth;
 /// <summary>
 /// Login.LoginResponse — dump.cs:578473 (private nested class),
 /// Deserialize at RVA 0x1447D10.
 ///
 /// Verified by disassembly: this is a standard OAuth 2.0 RFC 6749
 /// password-grant token response. The Deserialize body has two branches:
 ///
 ///   error = dict["error"];
 ///   if (string.IsNullOrEmpty(error)) {
 ///       this.AccessToken  = dict["access_token"];
 ///       this.RefreshToken = dict["refresh_token"];
 ///   } else {
 ///       this.ErrorDescription = dict["error_description"];
 ///   }
 ///
 /// Returned by api/platformlogin/v5 (the 2020 build's login endpoint)
 /// and api/platformlogin/refresh.
 ///
 /// All four keys are snake_case, NOT PascalCase. This is the standard
 /// OAuth response format — Rec Room conforms to RFC 6749 here.
 /// </summary>
 public class LoginResponse
 {
    [JsonPropertyName("error")]
    public string? Error { get; set; }
    [JsonPropertyName("error_description")]
    public string? ErrorDescription { get; set; }
    [JsonPropertyName("access_token")]
    public string AccessToken { get; set; } = string.Empty;
    [JsonPropertyName("refresh_token")]
    public string RefreshToken { get; set; } = string.Empty;
 }
@@ -1,129 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Auth;
 // =====================================================================
 // JSON keys verified by disassembling each .Deserialize method body
 // directly from GameAssembly.dll. Each key here is the literal string
 // passed to Util.GetKey / Util.GetKeyOrDefault inside the client. Util.GetKey
 // uses Dictionary<string,object>.TryGetValue, which is case-sensitive — so
 // the keys MUST match exactly.
 //
 // Convention summary (it's mixed):
 //   RecNetResult       lowercase           "success", "error"
 //   Account            camelCase           "accountId", "displayName", "isJunior"…
 //   SelfAccount        camelCase           "email", "birthday", "juniorState"…
 //   LoginResponse      snake_case (OAuth)  "access_token", "error_description"…
 //   RefreshLoginResp.  lowercase           "token"
 //   CachedLogin        camelCase           "platformId", "lastLoginTime"…
 //   CreateAccountResp  uses "value" as the wrapper key for the Account dict
 //
 // NOTE: TreatAsJunior on the C# side maps to JSON key "isJunior" — they
 // don't match. Account.Deserialize reads dict["isJunior"], not dict["treatAsJunior"].
 // =====================================================================
 /// <summary>
 /// RecNet.RecNetResult — dump.cs:584325, Deserialize at RVA 0x1146340.
 /// Reads "success" (required) and "error" (optional).
 /// </summary>
 public class RecNetResult
 {
    [JsonPropertyName("success")]
    public bool Success { get; set; } = true;
    [JsonPropertyName("error")]
    public string? Error { get; set; }
 }
 /// <summary>
 /// RecNet.Account — dump.cs:567684, Deserialize at RVA 0xF9DE50.
 /// JSON keys verified in the current 2020 IL2CPP build. Account.Deserialize
 /// reads profileImage.
 /// Other keys: accountId, username, displayName, isJunior, platforms. The C# Account class also has
 /// RawUsername and HasBirthday properties but Deserialize does not read
 /// them from JSON (they're set via MakeNameAdhereToPlatformRequirements
 /// or other flows). We expose them with reasonable camelCase keys for
 /// other endpoints that may consume them.
 /// </summary>
 public class RecNetAccount
 {
    private string profileImage = string.Empty;
    [JsonPropertyName("accountId")]
    public int AccountId { get; set; }
    [JsonPropertyName("username")]
    public string Username { get; set; } = string.Empty;
    [JsonPropertyName("displayName")]
    public string DisplayName { get; set; } = string.Empty;
    [JsonPropertyName("profileImage")]
    public string ProfileImage
    {
        get => profileImage;
        set => profileImage = value ?? string.Empty;
    }
    // Account.Deserialize reads "isJunior" — NOT "treatAsJunior".
    // The C# property name and the JSON key name differ.
    [JsonPropertyName("isJunior")]
    public bool TreatAsJunior { get; set; } = false;
    // PlatformManager.PlatformMask: Steam=1, Oculus=2, etc.
    [JsonPropertyName("platforms")]
    public int Platforms { get; set; } = 1;
    // Not in Account.Deserialize body but kept for forward-compat.
    [JsonPropertyName("rawUsername")]
    public string RawUsername { get; set; } = string.Empty;
    // Likewise.
    [JsonPropertyName("hasBirthday")]
    public bool HasBirthday { get; set; } = true;
    // 2020.12 Account.Deserialize reads this key (verified via Cpp2IL ISIL
    // dump of CCEOLAOLEKJ.PPGFHEDFBEA — the obfuscated Account class). The
    // 2020.03 client doesn't read it, but emitting it is harmless there.
    // Missing → LitJson throws and 2020.12 surfaces "Malformed Response".
    [JsonPropertyName("createdAt")]
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
 }
 /// <summary>
 /// RecNet.SelfAccount : Account — dump.cs:567797, Deserialize at RVA 0xAF4FB0.
 /// Calls base Account.Deserialize, then reads:
 /// email, phone, birthday, juniorState, parentAccountId.
 /// </summary>
 public class RecNetSelfAccount : RecNetAccount
 {
    [JsonPropertyName("email")]
    public string Email { get; set; } = string.Empty;
    [JsonPropertyName("phone")]
    public string Phone { get; set; } = string.Empty;
    [JsonPropertyName("birthday")]
    public DateTime? Birthday { get; set; } = new DateTime(2000, 1, 1);
    // RecNet.JuniorState enum (int)
    [JsonPropertyName("juniorState")]
    public int JuniorState { get; set; } = 0;
    [JsonPropertyName("parentAccountId")]
    public int? ParentAccountId { get; set; } = null;
 }
 /// <summary>
 /// Accounts.CreateAccountResponse : RecNetResult — dump.cs:568167,
 /// Deserialize at RVA 0xFAA200.
 /// Calls base RecNetResult.Deserialize (reads "success", "error"),
 /// then reads the Account from dict["value"] — NOT dict["account"].
 /// Verified by disassembly: the only string literal after the base
 /// call is "value", passed to Util.GetObjectKey&lt;object&gt;.
 /// </summary>
 public class CreateAccountResponse : RecNetResult
 {
    [JsonPropertyName("value")]
    public RecNetAccount Account { get; set; } = new();
 }
@@ -1,17 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Auth;
 /// <summary>
 /// Login.RefreshLoginResponse — dump.cs:578533 (private nested class),
 /// Deserialize at RVA 0x145B1E0.
 ///
 /// Verified by disassembly: reads exactly one key — lowercase "token" —
 /// via Util.GetKey&lt;string&gt;. Single-field response from
 /// POST api/platformlogin/refresh: the new (rotated) bearer access token.
 /// </summary>
 public class RefreshLoginResponse
 {
    [JsonPropertyName("token")]
    public string Token { get; set; } = string.Empty;
 }
@@ -1,24 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Avatar;
 public class AvatarData
 {
    [JsonPropertyName("AccountId")]
    public long AccountId { get; set; }
    [JsonPropertyName("AvatarItemInstances")]
    public List<AvatarItemInstance> AvatarItemInstances { get; set; } = [];
 }
 public class AvatarItemInstance
 {
    [JsonPropertyName("Id")]
    public long Id { get; set; }
    [JsonPropertyName("ItemId")]
    public long ItemId { get; set; }
    [JsonPropertyName("IsEquipped")]
    public bool IsEquipped { get; set; }
 }
@@ -1,15 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Avatar;
 public class AvatarItem
 {
    [JsonPropertyName("ItemId")]
    public long ItemId { get; set; }
    [JsonPropertyName("Name")]
    public string Name { get; set; } = string.Empty;
    [JsonPropertyName("Equipped")]
    public bool Equipped { get; set; }
 }
@@ -1,174 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Config;
 // Required keys per RecNet.RecRoomConfig.Deserialize disassembly (RVA 0x1146FA0).
 // Required-throw keys: ShareBaseUrl, LevelProgressionMaps[].Level, [].RequiredXp.
 // Required-object keys (GetObjectKey, accept null): ServerMaintenance,
 // AutoMicMutingConfig.
 //
 // NOTE: the level entry uses "RequiredXp" (lowercase 'p') per the IL string
 // literal — NOT "RequiredXP". A capital P here would throw KeyNotFoundException.
 public class RecRoomConfig
 {
    [JsonPropertyName("MessageOfTheDay")]
    public string MessageOfTheDay { get; set; } = "Welcome to the private server!";
    [JsonPropertyName("CdnBaseUri")]
    public string CdnBaseUri { get; set; } = string.Empty;
    // Required by client (string, GetKey). Used for share-link generation.
    [JsonPropertyName("ShareBaseUrl")]
    public string ShareBaseUrl { get; set; } = "https://rec.net/";
    // GetObjectKey<ServerMaintenanceDTO>. Required key. The deserializer
    // accepts null without throwing, but the C# property getter on the
    // client doesn't null-check before use during boot. Send a real DTO
    // with StartsInMinutes far in the future = "no upcoming maintenance".
    [JsonPropertyName("ServerMaintenance")]
    public ServerMaintenanceDTO? ServerMaintenance { get; set; } = new();
    // GetObjectKey<AutoMicMutingConfig>. Required by the client AND
    // dereferenced by AudioManager.Initialize during PostLogin boot —
    // null causes:
    //   NullReferenceException at RecNet.Config.get_AutoMicMutingConfig
    //   at AudioManager.Initialize
    // which kills the boot sequence with "Error initializing Core Systems".
    // Must be a real object with all 8 float fields populated.
    [JsonPropertyName("AutoMicMutingConfig")]
    public AutoMicMutingConfig AutoMicMutingConfig { get; set; } = new();
    [JsonPropertyName("PhotonConfig")]
    public PhotonConfig PhotonConfig { get; set; } = new();
    [JsonPropertyName("MatchmakingParams")]
    public MatchmakingParams MatchmakingParams { get; set; } = new();
    [JsonPropertyName("LevelProgressionMaps")]
    public List<LevelProgressionEntry> LevelProgressionMaps { get; set; } = LevelProgressionEntry.Default();
    [JsonPropertyName("DailyObjectives")]
    public List<List<DailyObjective>> DailyObjectives { get; set; } = DailyObjective.DefaultSets();
    [JsonPropertyName("ConfigTable")]
    public Dictionary<string, string> ConfigTable { get; set; } = [];
    [JsonPropertyName("ServiceUrls")]
    public Dictionary<string, string> ServiceUrls { get; set; } = [];
 }
 public class PhotonConfig
 {
    [JsonPropertyName("AppId")]
    public string AppId { get; set; } = string.Empty;
    [JsonPropertyName("VoiceAppId")]
    public string VoiceAppId { get; set; } = string.Empty;
    [JsonPropertyName("CloudRegion")]
    public string CloudRegion { get; set; } = "us";
    [JsonPropertyName("CrcCheckEnabled")]
    public bool CrcCheckEnabled { get; set; } = false;
    [JsonPropertyName("EnableServerTracingAfterDisconnect")]
    public bool EnableServerTracingAfterDisconnect { get; set; } = false;
 }
 public class MatchmakingParams
 {
    [JsonPropertyName("MaxPlayersPerRoom")]
    public int MaxPlayersPerRoom { get; set; } = 8;
    [JsonPropertyName("MinPlayersToStart")]
    public int MinPlayersToStart { get; set; } = 1;
 }
 public class LevelProgressionEntry
 {
    [JsonPropertyName("Level")]
    public int Level { get; set; }
    // Note the lowercase 'p' — the client's RecRoomConfig.Deserialize calls
    // Util.GetKey<int>("RequiredXp", ...). PascalCase XP would miss.
    [JsonPropertyName("RequiredXp")]
    public int RequiredXp { get; set; }
    public static List<LevelProgressionEntry> Default()
    {
        var entries = new List<LevelProgressionEntry>();
        for (int i = 0; i <= 30; i++)
            entries.Add(new LevelProgressionEntry { Level = i, RequiredXp = i * 500 });
        return entries;
    }
 }
 // Inner item shape for RecRoomConfig.DailyObjectives, verified by the
 // disassembled iteration body — only "type" and "score" are read. Other
 // fields the client doesn't read get ignored, so we only send these two.
 public class DailyObjective
 {
    [JsonPropertyName("type")]
    public int Type { get; set; }
    [JsonPropertyName("score")]
    public int Score { get; set; }
    public static List<List<DailyObjective>> DefaultSets()
    {
        var sets = new List<List<DailyObjective>>();
        for (int day = 0; day < 7; day++)
        {
            sets.Add(
            [
                new DailyObjective { Type = 1, Score = 50 },
                new DailyObjective { Type = 2, Score = 30 },
                new DailyObjective { Type = 3, Score = 20 },
            ]);
        }
        return sets;
    }
 }
 /// <summary>
 /// RecNet.AutoMicMutingConfig — dump.cs class, Deserialize at RVA 0xFA3AE0.
 /// All 8 float fields are required (Util.GetKey&lt;float&gt;). Defaults are
 /// "feature effectively disabled" — high thresholds, no force-mute.
 /// </summary>
 public class AutoMicMutingConfig
 {
    [JsonPropertyName("MicSpamVolumeThreshold")]
    public float MicSpamVolumeThreshold { get; set; } = 1.0f;
    [JsonPropertyName("MicVolumeSampleInterval")]
    public float MicVolumeSampleInterval { get; set; } = 0.1f;
    [JsonPropertyName("MicVolumeSampleRollingWindowLength")]
    public float MicVolumeSampleRollingWindowLength { get; set; } = 5.0f;
    [JsonPropertyName("MicSpamSamplePercentageForWarning")]
    public float MicSpamSamplePercentageForWarning { get; set; } = 1.0f;
    [JsonPropertyName("MicSpamSamplePercentageForWarningToEnd")]
    public float MicSpamSamplePercentageForWarningToEnd { get; set; } = 0.5f;
    [JsonPropertyName("MicSpamSamplePercentageForForceMute")]
    public float MicSpamSamplePercentageForForceMute { get; set; } = 1.0f;
    [JsonPropertyName("MicSpamSamplePercentageForForceMuteToEnd")]
    public float MicSpamSamplePercentageForForceMuteToEnd { get; set; } = 0.5f;
    [JsonPropertyName("MicSpamWarningStateVolumeMultiplier")]
    public float MicSpamWarningStateVolumeMultiplier { get; set; } = 1.0f;
 }
 /// <summary>
 /// RecNet.ServerMaintenanceDTO — dump.cs, Deserialize at RVA 0xAF5450.
 /// Single required key: StartsInMinutes (int). A large positive value
 /// means "maintenance window is far away" = effectively never.
 /// </summary>
 public class ServerMaintenanceDTO
 {
    [JsonPropertyName("StartsInMinutes")]
    public int StartsInMinutes { get; set; } = int.MaxValue;
 }
@@ -1,9 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
 </Project>
@@ -1,261 +0,0 @@
 version=1
 # This file caches language service data to improve the performance of C# Dev Kit.
 # It is not intended for manual editing. It can safely be deleted and will be
 # regenerated automatically. For more information, see https://aka.ms/lscache
 #
 # To control where cache files are stored, use the following VS Code setting:
 #   "dotnet.projectsystem.cacheInProjectFolder": true
 [project]
 language=C#
 primary
 lastDtbSucceeded
 [properties]
 AssemblyName=DorkNet.Models
 CommandLineArgsForDesignTimeEvaluation=-langversion:13.0 -define:TRACE
 CompilerGeneratedFilesOutputPath=
 MaxSupportedLangVersion=13.0
 ProjectAssetsFile=<PATH>obj/project.assets.json
 RootNamespace=DorkNet.Models
 RunAnalyzers=
 RunAnalyzersDuringLiveAnalysis=
 SolutionPath=<PATH>../DorkNet.sln
 TargetFrameworkIdentifier=.NETCoreApp
 TargetPath=<PATH>bin/Debug/net9.0/DorkNet.Models.dll
 TargetRefPath=<PATH>obj/Debug/net9.0/ref/DorkNet.Models.dll
 TemporaryDependencyNodeTargetIdentifier=net9.0
 [commandLineArguments]
 /noconfig
 /unsafe-
 /checked-
 /nowarn:1701,1702,1701,1702
 /fullpaths
 /nostdlib+
 /errorreport:prompt
 /warn:9
 /define:TRACE;DEBUG;NET;NET9_0;NETCOREAPP;NET5_0_OR_GREATER;NET6_0_OR_GREATER;NET7_0_OR_GREATER;NET8_0_OR_GREATER;NET9_0_OR_GREATER;NETCOREAPP1_0_OR_GREATER;NETCOREAPP1_1_OR_GREATER;NETCOREAPP2_0_OR_GREATER;NETCOREAPP2_1_OR_GREATER;NETCOREAPP2_2_OR_GREATER;NETCOREAPP3_0_OR_GREATER;NETCOREAPP3_1_OR_GREATER
 /highentropyva+
 /nullable:enable
 /debug+
 /debug:portable
 /filealign:512
 /optimize-
 /out:obj\Debug\net9.0\DorkNet.Models.dll
 /refout:obj\Debug\net9.0\refint\DorkNet.Models.dll
 /target:library
 /warnaserror-
 /utf8output
 /deterministic+
 /langversion:13.0
 /warnaserror+:NU1605,SYSLIB0011
 [sourceFiles]
 Auth/
 CachedLogin.cs
 LoginRequest.cs
 LoginResponse.cs
 RecNetResult.cs
 RefreshLoginResponse.cs
 Avatar/
 AvatarData.cs
 AvatarItem.cs
 Config/RecRoomConfig.cs
 GameSessions/GameSession.cs
 Notification/PushNotification.cs
 obj/Debug/net9.0/
 .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
 DorkNet.Models.AssemblyInfo.cs
 DorkNet.Models.GlobalUsings.g.cs
 Players/
 ModerationBlockDetail.cs
 PlayerProfile.cs
 Progression.cs
 Reputation.cs
 UpdateProfileRequest.cs
 Relationships/Relationship.cs
 [metadataReferences]
 <DOTNET>/packs/Microsoft.NETCore.App.Ref/9.0.16/ref/net9.0/
 Microsoft.CSharp.dll
 Microsoft.VisualBasic.Core.dll
 Microsoft.VisualBasic.dll
 Microsoft.Win32.Primitives.dll
 Microsoft.Win32.Registry.dll
 mscorlib.dll
 netstandard.dll
 System.AppContext.dll
 System.Buffers.dll
 System.Collections.Concurrent.dll
 System.Collections.dll
 System.Collections.Immutable.dll
 System.Collections.NonGeneric.dll
 System.Collections.Specialized.dll
 System.ComponentModel.Annotations.dll
 System.ComponentModel.DataAnnotations.dll
 System.ComponentModel.dll
 System.ComponentModel.EventBasedAsync.dll
 System.ComponentModel.Primitives.dll
 System.ComponentModel.TypeConverter.dll
 System.Configuration.dll
 System.Console.dll
 System.Core.dll
 System.Data.Common.dll
 System.Data.DataSetExtensions.dll
 System.Data.dll
 System.Diagnostics.Contracts.dll
 System.Diagnostics.Debug.dll
 System.Diagnostics.DiagnosticSource.dll
 System.Diagnostics.FileVersionInfo.dll
 System.Diagnostics.Process.dll
 System.Diagnostics.StackTrace.dll
 System.Diagnostics.TextWriterTraceListener.dll
 System.Diagnostics.Tools.dll
 System.Diagnostics.TraceSource.dll
 System.Diagnostics.Tracing.dll
 System.dll
 System.Drawing.dll
 System.Drawing.Primitives.dll
 System.Dynamic.Runtime.dll
 System.Formats.Asn1.dll
 System.Formats.Tar.dll
 System.Globalization.Calendars.dll
 System.Globalization.dll
 System.Globalization.Extensions.dll
 System.IO.Compression.Brotli.dll
 System.IO.Compression.dll
 System.IO.Compression.FileSystem.dll
 System.IO.Compression.ZipFile.dll
 System.IO.dll
 System.IO.FileSystem.AccessControl.dll
 System.IO.FileSystem.dll
 System.IO.FileSystem.DriveInfo.dll
 System.IO.FileSystem.Primitives.dll
 System.IO.FileSystem.Watcher.dll
 System.IO.IsolatedStorage.dll
 System.IO.MemoryMappedFiles.dll
 System.IO.Pipelines.dll
 System.IO.Pipes.AccessControl.dll
 System.IO.Pipes.dll
 System.IO.UnmanagedMemoryStream.dll
 System.Linq.dll
 System.Linq.Expressions.dll
 System.Linq.Parallel.dll
 System.Linq.Queryable.dll
 System.Memory.dll
 System.Net.dll
 System.Net.Http.dll
 System.Net.Http.Json.dll
 System.Net.HttpListener.dll
 System.Net.Mail.dll
 System.Net.NameResolution.dll
 System.Net.NetworkInformation.dll
 System.Net.Ping.dll
 System.Net.Primitives.dll
 System.Net.Quic.dll
 System.Net.Requests.dll
 System.Net.Security.dll
 System.Net.ServicePoint.dll
 System.Net.Sockets.dll
 System.Net.WebClient.dll
 System.Net.WebHeaderCollection.dll
 System.Net.WebProxy.dll
 System.Net.WebSockets.Client.dll
 System.Net.WebSockets.dll
 System.Numerics.dll
 System.Numerics.Vectors.dll
 System.ObjectModel.dll
 System.Reflection.DispatchProxy.dll
 System.Reflection.dll
 System.Reflection.Emit.dll
 System.Reflection.Emit.ILGeneration.dll
 System.Reflection.Emit.Lightweight.dll
 System.Reflection.Extensions.dll
 System.Reflection.Metadata.dll
 System.Reflection.Primitives.dll
 System.Reflection.TypeExtensions.dll
 System.Resources.Reader.dll
 System.Resources.ResourceManager.dll
 System.Resources.Writer.dll
 System.Runtime.CompilerServices.Unsafe.dll
 System.Runtime.CompilerServices.VisualC.dll
 System.Runtime.dll
 System.Runtime.Extensions.dll
 System.Runtime.Handles.dll
 System.Runtime.InteropServices.dll
 System.Runtime.InteropServices.JavaScript.dll
 System.Runtime.InteropServices.RuntimeInformation.dll
 System.Runtime.Intrinsics.dll
 System.Runtime.Loader.dll
 System.Runtime.Numerics.dll
 System.Runtime.Serialization.dll
 System.Runtime.Serialization.Formatters.dll
 System.Runtime.Serialization.Json.dll
 System.Runtime.Serialization.Primitives.dll
 System.Runtime.Serialization.Xml.dll
 System.Security.AccessControl.dll
 System.Security.Claims.dll
 System.Security.Cryptography.Algorithms.dll
 System.Security.Cryptography.Cng.dll
 System.Security.Cryptography.Csp.dll
 System.Security.Cryptography.dll
 System.Security.Cryptography.Encoding.dll
 System.Security.Cryptography.OpenSsl.dll
 System.Security.Cryptography.Primitives.dll
 System.Security.Cryptography.X509Certificates.dll
 System.Security.dll
 System.Security.Principal.dll
 System.Security.Principal.Windows.dll
 System.Security.SecureString.dll
 System.ServiceModel.Web.dll
 System.ServiceProcess.dll
 System.Text.Encoding.CodePages.dll
 System.Text.Encoding.dll
 System.Text.Encoding.Extensions.dll
 System.Text.Encodings.Web.dll
 System.Text.Json.dll
 System.Text.RegularExpressions.dll
 System.Threading.Channels.dll
 System.Threading.dll
 System.Threading.Overlapped.dll
 System.Threading.Tasks.Dataflow.dll
 System.Threading.Tasks.dll
 System.Threading.Tasks.Extensions.dll
 System.Threading.Tasks.Parallel.dll
 System.Threading.Thread.dll
 System.Threading.ThreadPool.dll
 System.Threading.Timer.dll
 System.Transactions.dll
 System.Transactions.Local.dll
 System.ValueTuple.dll
 System.Web.dll
 System.Web.HttpUtility.dll
 System.Windows.dll
 System.Xml.dll
 System.Xml.Linq.dll
 System.Xml.ReaderWriter.dll
 System.Xml.Serialization.dll
 System.Xml.XDocument.dll
 System.Xml.XmlDocument.dll
 System.Xml.XmlSerializer.dll
 System.Xml.XPath.dll
 System.Xml.XPath.XDocument.dll
 WindowsBase.dll
 [analyzerReferences]
 <DOTNET>/packs/Microsoft.NETCore.App.Ref/9.0.16/analyzers/dotnet/cs/
 Microsoft.Interop.ComInterfaceGenerator.dll
 Microsoft.Interop.JavaScript.JSImportGenerator.dll
 Microsoft.Interop.LibraryImportGenerator.dll
 Microsoft.Interop.SourceGeneration.dll
 System.Text.Json.SourceGeneration.dll
 System.Text.RegularExpressions.Generator.dll
 <DOTNET>/sdk/9.0.314/Sdks/Microsoft.NET.Sdk/analyzers/
 Microsoft.CodeAnalysis.CSharp.NetAnalyzers.dll
 Microsoft.CodeAnalysis.NetAnalyzers.dll
 [analyzerConfigFiles]
 <DOTNET>/sdk/9.0.314/Sdks/Microsoft.NET.Sdk/analyzers/build/config/analysislevel_9_default.globalconfig
 obj/Debug/net9.0/DorkNet.Models.GeneratedMSBuildEditorConfig.editorconfig
@@ -1,73 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.GameSessions;
 public class GameSession
 {
    [JsonPropertyName("GameSessionId")]
    public long GameSessionId { get; set; }
    [JsonPropertyName("RegionId")]
    public string RegionId { get; set; } = "us";
    [JsonPropertyName("RoomId")]
    public string RoomId { get; set; } = string.Empty;
    [JsonPropertyName("RoomName")]
    public string RoomName { get; set; } = string.Empty;
    [JsonPropertyName("ActivityLevelId")]
    public string ActivityLevelId { get; set; } = string.Empty;
    [JsonPropertyName("EventId")]
    public long? EventId { get; set; }
    [JsonPropertyName("Private")]
    public bool Private { get; set; }
    [JsonPropertyName("GameInProgress")]
    public bool GameInProgress { get; set; }
    [JsonPropertyName("MaxCapacity")]
    public int MaxCapacity { get; set; } = 8;
    [JsonPropertyName("IsFull")]
    public bool IsFull { get; set; }
    [JsonPropertyName("PlayerCount")]
    public int PlayerCount { get; set; }
    [JsonPropertyName("PhotonRoomName")]
    public string PhotonRoomName { get; set; } = string.Empty;
 }
 public class JoinRandomGameSessionRequest
 {
    [JsonPropertyName("RoomId")]
    public string? RoomId { get; set; }
    [JsonPropertyName("ActivityLevelId")]
    public string? ActivityLevelId { get; set; }
    [JsonPropertyName("RegionId")]
    public string RegionId { get; set; } = "us";
 }
 public class JoinGameSessionResponse
 {
    [JsonPropertyName("Result")]
    public JoinGameErrorCode Result { get; set; } = JoinGameErrorCode.Success;
    [JsonPropertyName("GameSession")]
    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
    public GameSession? GameSession { get; set; }
 }
 public enum JoinGameErrorCode
 {
    Success = 0,
    Full = 1,
    NotFound = 2,
    Banned = 3,
    Error = 4,
 }
@@ -1,65 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Notification;
 public class PushNotification
 {
    [JsonPropertyName("Id")]
    public PushNotificationId Id { get; set; }
    [JsonPropertyName("Msg")]
    public object? Msg { get; set; }
 }
 /// <summary>
 /// Mirrors the client's <c>RecNet.Notifications+PushNotificationId</c>
 /// enum exactly (decompiled at
 /// <c>Cpp2IL_CS/.../RecNet/Notifications.cs:52-89</c>). Values are
 /// non-contiguous because the client allocates them in groups (1–6
 /// core; 11–15 subscriptions; 20–25 moderation; 30–31 gifts;
 /// 60–62 storefronts; 70–71 consumables; 80–85 events; 90 chat;
 /// 95–96 community board; 100 inventions).
 ///
 /// Server <c>NotifyAsync(playerId, id)</c> pushes raise an event with
 /// this int value over the SignalR hub. If the value doesn't match
 /// what the client expects for a given concept, the push is silently
 /// dropped — match the client byte-for-byte.
 /// </summary>
 public enum PushNotificationId
 {
    RelationshipChanged = 1,
    MessageReceived = 2,
    MessageDeleted = 3,
    PresenceHeartbeatResponse = 4,
    RefreshLogin = 5,
    Logout = 6,
    SubscriptionUpdateProfile = 11,
    SubscriptionUpdatePresence = 12,
    SubscriptionUpdateGameSession = 13,
    SubscriptionUpdateRoom = 15,
    ModerationQuitGame = 20,
    ModerationUpdateRequired = 21,
    ModerationKick = 22,
    ModerationKickAttemptFailed = 23,
    ModerationRoomBan = 24,
    ServerMaintenance = 25,
    GiftPackageReceived = 30,
    GiftPackageReceivedImmediate = 31,
    ProfileJuniorStatusUpdate = 40,
    RelationshipsInvalid = 50,
    StorefrontBalanceAdd = 60,
    StorefrontBalanceUpdate = 61,
    StorefrontBalancePurchase = 62,
    ConsumableMappingAdded = 70,
    ConsumableMappingRemoved = 71,
    PlayerEventCreated = 80,
    PlayerEventUpdated = 81,
    PlayerEventDeleted = 82,
    PlayerEventResponseChanged = 83,
    PlayerEventResponseDeleted = 84,
    PlayerEventStateChanged = 85,
    ChatMessageReceived = 90,
    CommunityBoardUpdate = 95,
    CommunityBoardAnnouncementUpdate = 96,
    InventionModerationStateChanged = 100,
 }
@@ -1,46 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Players;
 /// <summary>
 /// RecNet.ModerationBlockDetail — dump.cs:583626, Deserialize at RVA 0x1450830.
 ///
 /// Verified by disassembly. Required keys (Util.GetKey, throws if missing):
 ///   ReportCategory (int), Duration (int), GameSessionId (long), Message (string).
 /// Optional keys (Util.GetKeyOrDefault):
 ///   IsHostKick (bool, default false), IsBan (bool, default false),
 ///   PlayerIdReporter (Nullable&lt;int&gt;, default null).
 ///
 /// Returned by:
 ///   GET api.rec.net/api/PlayerReporting/v1/moderationBlockDetails
 /// (Single object, NOT a list — the client method GetModerationBlockDetails
 /// returns IPromise&lt;ModerationBlockDetail&gt;.)
 ///
 /// To indicate "user is not blocked": ReportCategory=0, Duration=0,
 /// GameSessionId=0, Message="", IsBan=false, IsHostKick=false,
 /// PlayerIdReporter=null.
 /// </summary>
 public class ModerationBlockDetail
 {
    // PlayerReporting.ReportCategory enum (int)
    [JsonPropertyName("ReportCategory")]
    public int ReportCategory { get; set; } = 0;
    [JsonPropertyName("Duration")]
    public int Duration { get; set; } = 0;
    [JsonPropertyName("GameSessionId")]
    public long GameSessionId { get; set; } = 0;
    [JsonPropertyName("Message")]
    public string Message { get; set; } = string.Empty;
    [JsonPropertyName("IsHostKick")]
    public bool IsHostKick { get; set; } = false;
    [JsonPropertyName("PlayerIdReporter")]
    public int? PlayerIdReporter { get; set; } = null;
    [JsonPropertyName("IsBan")]
    public bool IsBan { get; set; } = false;
 }
@@ -1,64 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Players;
 public class PlayerProfile
 {
    private string? profileImage;
    [JsonPropertyName("AccountId")]
    public long AccountId { get; set; }
    [JsonPropertyName("Username")]
    public string Username { get; set; } = string.Empty;
    [JsonPropertyName("DisplayName")]
    public string DisplayName { get; set; } = string.Empty;
    [JsonPropertyName("ProfileImage")]
    public string? ProfileImage
    {
        get => profileImage;
        set => profileImage = value;
    }
    [JsonPropertyName("ProfileImageName")]
    public string? ProfileImageName
    {
        get => profileImage;
        set => profileImage = value;
    }
    [JsonPropertyName("BannerImage")]
    public string? BannerImage { get; set; }
    [JsonPropertyName("IsJunior")]
    public bool IsJunior { get; set; } = false;
    [JsonPropertyName("Level")]
    public int Level { get; set; } = 1;
    [JsonPropertyName("XP")]
    public int XP { get; set; } = 0;
    [JsonPropertyName("Reputation")]
    public int Reputation { get; set; } = 0;
    [JsonPropertyName("Bio")]
    public string Bio { get; set; } = string.Empty;
    [JsonPropertyName("IsVerified")]
    public bool IsVerified { get; set; } = false;
    [JsonPropertyName("IsDeveloper")]
    public bool IsDeveloper { get; set; } = false;
    [JsonPropertyName("IsCommunityTeam")]
    public bool IsCommunityTeam { get; set; } = false;
    [JsonPropertyName("CanReceiveInvites")]
    public bool CanReceiveInvites { get; set; } = true;
    [JsonPropertyName("CreatedAt")]
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
 }
@@ -1,26 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Players;
 /// <summary>
 /// RecNet.Progression — dump.cs:582273, Deserialize at RVA 0x1142BB0.
 ///
 /// Verified by disassembly: reads "PlayerId", "Level", "XP" via
 /// Util.GetKey&lt;int&gt;. All three keys are required (non-default) — missing
 /// any of them throws KeyNotFoundException at the client.
 ///
 /// Note: the JSON uses "PlayerId" not "AccountId" even though the C# property
 /// is AccountId on most other types. Returned by:
 ///   GET api.rec.net/api/players/v1/progression/{accountId}
 /// </summary>
 public class Progression
 {
    [JsonPropertyName("PlayerId")]
    public int PlayerId { get; set; }
    [JsonPropertyName("Level")]
    public int Level { get; set; } = 1;
    [JsonPropertyName("XP")]
    public int XP { get; set; } = 0;
 }
@@ -1,56 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Players;
 /// <summary>
 /// RecNet.Reputation — dump.cs:584087, Deserialize at RVA 0x114A830.
 ///
 /// Verified by disassembly. ALL Cheer*/Subscriber* keys are required
 /// (Util.GetKey&lt;int&gt;), missing any throws KeyNotFoundException.
 /// "SelectedCheer" is the only optional one (Util.GetKeyOrDefault&lt;Nullable&lt;int&gt;&gt;).
 ///
 /// CRITICAL TYPO: the JSON key is "Noteriety" — the dev mistyped "Notoriety".
 /// The C# property is named Notoriety in dump.cs (line 584117) but the dict
 /// lookup uses "Noteriety". Server response MUST match the typo.
 ///
 /// Returned by:
 ///   GET api.rec.net/api/playerReputation/v1/{accountId}
 /// </summary>
 public class Reputation
 {
    [JsonPropertyName("AccountId")]
    public int AccountId { get; set; }
    // sic: see class XML doc — typo in the binary's Util.GetKey call.
    [JsonPropertyName("Noteriety")]
    public float Notoriety { get; set; } = 0f;
    [JsonPropertyName("CheerGeneral")]
    public int CheerGeneral { get; set; }
    [JsonPropertyName("CheerHelpful")]
    public int CheerHelpful { get; set; }
    [JsonPropertyName("CheerGreatHost")]
    public int CheerGreatHost { get; set; }
    [JsonPropertyName("CheerSportsman")]
    public int CheerSportsman { get; set; }
    [JsonPropertyName("CheerCreative")]
    public int CheerCreative { get; set; }
    [JsonPropertyName("CheerCredit")]
    public int CheerCredit { get; set; }
    [JsonPropertyName("SubscriberCount")]
    public int SubscriberCount { get; set; }
    [JsonPropertyName("SubscribedCount")]
    public int SubscribedCount { get; set; }
    // PlayerCheering.CheerCategory enum (int) — Nullable; null means "no
    // active cheer set". This is the only optional key.
    [JsonPropertyName("SelectedCheer")]
    public int? SelectedCheer { get; set; } = null;
 }
@@ -1,12 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Players;
 public class UpdateProfileRequest
 {
    [JsonPropertyName("DisplayName")]
    public string? DisplayName { get; set; }
    [JsonPropertyName("Bio")]
    public string? Bio { get; set; }
 }
@@ -1,27 +0,0 @@
 using System.Text.Json.Serialization;
 namespace DorkNet.Models.Relationships;
 public class RelationshipData
 {
    [JsonPropertyName("AccountId")]
    public long AccountId { get; set; }
    [JsonPropertyName("OtherAccountId")]
    public long OtherAccountId { get; set; }
    [JsonPropertyName("Status")]
    public RelationshipStatus Status { get; set; }
    [JsonPropertyName("CreatedAt")]
    public DateTime CreatedAt { get; set; }
 }
 public enum RelationshipStatus
 {
    None = 0,
    Friend = 1,
    PendingSent = 2,
    PendingReceived = 3,
    Blocked = 4,
 }
@@ -1,76 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <!--
    Standalone MelonLoader IL2CPP mod whose ONLY job is to dump every
    Google.Protobuf FileDescriptor that the running client has loaded.
    It carries no Harmony patches, so it is safe to drop onto ANY Rec Room
    build (2020, 2023, …) without the version-specific ClientMod patches
    misfiring. Everything game-side is reached through plain
    System.Reflection over the Il2CppInterop proxy assemblies, so no game
    DLLs are referenced at compile time (they would be derivative works).
    Build (desktop net6 MelonLoader, same pin as the ClientMod):
      dotnet build DorkNet.ProtoDumper/DorkNet.ProtoDumper.csproj -c Release
    Drop bin\Release\DorkNet.ProtoDumper.dll into <RecRoom>\Mods\ on a
    MelonLoader-patched build and launch. Output lands in
    <RecRoom>\DorkNet-ProtoDump\.
  -->
  <PropertyGroup>
    <TargetFramework Condition="'$(TargetFramework)' == ''">net6.0</TargetFramework>
    <LangVersion>latest</LangVersion>
    <Nullable>enable</Nullable>
    <RootNamespace>DorkNet.ProtoDumper</RootNamespace>
    <AssemblyName>DorkNet.ProtoDumper</AssemblyName>
    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
    <CopyLocalLockFileAssemblies>false</CopyLocalLockFileAssemblies>
    <NoWarn>$(NoWarn);CS8602;CS8604;CS0436</NoWarn>
  </PropertyGroup>
  <!-- Reuse the MelonLoader DLLs the ClientMod project already downloads. -->
  <PropertyGroup>
    <MelonLoaderVersion Condition="'$(MelonLoaderVersion)' == ''">v0.6.6</MelonLoaderVersion>
    <MelonLoaderCacheRoot>$(MSBuildThisFileDirectory)..\DorkNet.ClientMod\build\melonloader</MelonLoaderCacheRoot>
    <MelonLoaderZip>$(MelonLoaderCacheRoot)\MelonLoader.x64.$(MelonLoaderVersion).zip</MelonLoaderZip>
    <MelonLoaderDir Condition="'$(MelonLoaderDir)' == ''">$(MelonLoaderCacheRoot)\MelonLoader</MelonLoaderDir>
    <MelonLoaderReferenceTfm Condition="'$(MelonLoaderReferenceTfm)' == '' and '$(TargetFramework)' == 'net8.0'">net8</MelonLoaderReferenceTfm>
    <MelonLoaderReferenceTfm Condition="'$(MelonLoaderReferenceTfm)' == ''">net6</MelonLoaderReferenceTfm>
  </PropertyGroup>
  <Target Name="EnsureMelonLoaderReferences"
          BeforeTargets="ResolveAssemblyReferences"
          Condition="'$(MelonLoaderReferenceTfm)' == 'net6' and !Exists('$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\MelonLoader.dll')">
    <MakeDir Directories="$(MelonLoaderCacheRoot)" />
    <DownloadFile
      SourceUrl="https://github.com/LavaGang/MelonLoader/releases/download/$(MelonLoaderVersion)/MelonLoader.x64.zip"
      DestinationFolder="$(MelonLoaderCacheRoot)"
      DestinationFileName="MelonLoader.x64.$(MelonLoaderVersion).zip"
      SkipUnchangedFiles="true" />
    <Unzip SourceFiles="$(MelonLoaderZip)"
           DestinationFolder="$(MelonLoaderCacheRoot)"
           OverwriteReadOnlyFiles="true" />
  </Target>
  <ItemGroup>
    <Reference Include="MelonLoader">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\MelonLoader.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="0Harmony">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\0Harmony.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="Il2CppInterop.Runtime">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\Il2CppInterop.Runtime.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <Reference Include="Il2CppInterop.Common">
      <HintPath>$(MelonLoaderDir)\$(MelonLoaderReferenceTfm)\Il2CppInterop.Common.dll</HintPath>
      <Private>false</Private>
    </Reference>
  </ItemGroup>
 </Project>
@@ -1,378 +0,0 @@
 // DorkNet ProtoDumper — runtime Google.Protobuf schema extractor.
 //
 // Rec Room compiles its room-save / creation / circuits data model from
 // .proto files into Google.Protobuf C# classes. In the shipped IL2CPP build
 // those classes are name-obfuscated and the descriptor base64 is split into
 // scattered string-literal chunks, so static reconstruction from
 // global-metadata.dat is unreliable.
 //
 // At RUNTIME every FileDescriptor still carries its original, un-obfuscated
 // FileDescriptorProto (message names, field names, numbers, types intact).
 // The catch: these descriptors are built LAZILY and in a specific dependency
 // order by the game. Force-building them ourselves (by reading a message
 // type's static descriptor property out of order) throws inside the type's
 // static constructor and the failure is cached — poisoning the type. So we do
 // NOT enumerate types. Instead we Harmony-postfix the one library method every
 // generated cctor funnels through — Google.Protobuf.Reflection.FileDescriptor
 // .BuildFrom / .FromGeneratedCode — and capture each descriptor as the game
 // builds it. Completely passive: just play the client through the dorm, a
 // created room, the Maker Pen and a circuits board, and every descriptor that
 // loads is recorded.
 //
 // Output (under <RecRoom>\DorkNet-ProtoDump\):
 //   manifest.tsv          — one "<proto path>\t<base64>" line per file
 //   files\<sanitised>.b64 — same base64, one file each
 //   dump.log              — capture log
 //
 // Decode offline with decode_dump.py (see README.md).
 using HarmonyLib;
 using MelonLoader;
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Reflection;
 using System.Text;
 [assembly: MelonInfo(typeof(DorkNet.ProtoDumper.ProtoDumper), "DorkNet ProtoDumper", "2.0.0", "Dork Squad")]
 [assembly: MelonGame(null, null)]
 namespace DorkNet.ProtoDumper;
 public class ProtoDumper : MelonMod
 {
    private static MelonLogger.Instance? _log;
    // proto file name -> descriptor base64 (accumulated as the game builds them)
    private static readonly Dictionary<string, string> Files = new(StringComparer.Ordinal);
    private static readonly object Gate = new();
    private static string _outDir = "";
    private static string _filesDir = "";
    private static volatile bool _dirty;
    private int _frame;
    // Interception heartbeat: how many times any hooked method actually ran.
    // Lets us distinguish "hook never fires (inlined/wrong target)" from
    // "content that builds protos hasn't loaded yet".
    private static long _fireCount;
    private static bool _firstFireLogged;
    public override void OnInitializeMelon()
    {
        _log = LoggerInstance;
        try
        {
            string baseDir = AppDomain.CurrentDomain.BaseDirectory ?? Directory.GetCurrentDirectory();
            _outDir = Path.Combine(baseDir, "DorkNet-ProtoDump");
            _filesDir = Path.Combine(_outDir, "files");
            Directory.CreateDirectory(_filesDir);
            _log.Msg($"ProtoDumper ready. Output dir: {_outDir}");
        }
        catch (Exception e) { _log?.Error($"ProtoDumper init failed: {e}"); }
        InstallHooks();
    }
    private void InstallHooks()
    {
        try
        {
            // Google.Protobuf library type — NOT obfuscated (it's the library,
            // not game code), reached by its original name via every loaded
            // assembly so we never reference the interop DLL at compile time.
            Type? fd = ResolveType("Google.Protobuf.Reflection.FileDescriptor");
            if (fd == null)
            {
                _log?.Error("ProtoDumper: FileDescriptor type not found — cannot hook.");
                return;
            }
            var postfix = new HarmonyMethod(
                typeof(ProtoDumper).GetMethod(nameof(Captured_Postfix),
                    BindingFlags.Public | BindingFlags.Static));
            var ctorPostfix = new HarmonyMethod(
                typeof(ProtoDumper).GetMethod(nameof(Ctor_Postfix),
                    BindingFlags.Public | BindingFlags.Static));
            int patched = 0;
            // PRIMARY hook: the 6-arg instance constructor. Every FileDescriptor
            // is built via `newobj` through this ctor, which is NOT an inlining
            // candidate the way the small static BuildFrom/FromGeneratedCode
            // helpers are (those get AOT-inlined into each generated cctor, so a
            // Harmony patch on the managed wrapper never fires — the real work
            // runs as inlined native code). The ctor stores SerializedData /
            // Proto / Name before it returns, so __instance carries the full
            // descriptor bytes.
            foreach (ConstructorInfo c in fd.GetConstructors(
                         BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance))
            {
                var ps = c.GetParameters();
                // Skip the Il2CppInterop IntPtr wrapper ctor (single IntPtr arg).
                if (ps.Length == 1 && ps[0].ParameterType == typeof(IntPtr)) continue;
                try { HarmonyInstance.Patch(c, postfix: ctorPostfix); patched++; _log?.Msg($"ProtoDumper: hooked .ctor({ps.Length} args)"); }
                catch (Exception e) { _log?.Warning($"ProtoDumper: patch .ctor({ps.Length}) failed: {e.Message}"); }
            }
            // SECONDARY hooks (kept as a belt-and-braces net in case the ctor is
            // itself inlined on some build): BuildFrom / FromGeneratedCode.
            foreach (string name in new[] { "BuildFrom", "FromGeneratedCode" })
            {
                foreach (MethodInfo m in fd.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static))
                {
                    if (m.Name != name) continue;
                    try { HarmonyInstance.Patch(m, postfix: postfix); patched++; _log?.Msg($"ProtoDumper: hooked {name}({m.GetParameters().Length} args)"); }
                    catch (Exception e) { _log?.Warning($"ProtoDumper: patch {name} failed: {e.Message}"); }
                }
            }
            // STRONGEST hook: DescriptorPool.AddSymbol(IDescriptor). Called once
            // per message/enum/service symbol while a descriptor is built. Unlike
            // the tiny BuildFrom/FromGeneratedCode/ctor helpers, AddSymbol does
            // real work (name validation + dictionary insert + duplicate-throw),
            // so the AOT compiler does NOT inline it away — the managed patch
            // actually fires. From the symbol we walk `.File` to the owning
            // FileDescriptor and collect its serialized bytes. We also stash the
            // pool so ScanPools() can later enumerate everything it holds.
            Type? pool = ResolveType("Google.Protobuf.Reflection.DescriptorPool");
            if (pool != null)
            {
                var symPostfix = new HarmonyMethod(
                    typeof(ProtoDumper).GetMethod(nameof(AddSymbol_Postfix),
                        BindingFlags.Public | BindingFlags.Static));
                foreach (MethodInfo m in pool.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance))
                {
                    if (m.Name != "AddSymbol" && m.Name != "AddPackage") continue;
                    try { HarmonyInstance.Patch(m, postfix: symPostfix); patched++; _log?.Msg($"ProtoDumper: hooked DescriptorPool.{m.Name}({m.GetParameters().Length} args)"); }
                    catch (Exception e) { _log?.Warning($"ProtoDumper: patch DescriptorPool.{m.Name} failed: {e.Message}"); }
                }
            }
            else _log?.Warning("ProtoDumper: DescriptorPool type not found — AddSymbol hook skipped.");
            _log?.Msg($"ProtoDumper: installed {patched} descriptor hooks. Play through your content; descriptors are captured as they load. Watch for 'FIRST DESCRIPTOR CAPTURED'.");
        }
        catch (Exception e) { _log?.Error($"ProtoDumper hook install error: {e}"); }
    }
    // Resolve a type by its ORIGINAL (game-side) name, accounting for the
    // Il2Cpp prefix Il2CppInterop puts on the namespace (so
    // "Google.Protobuf.Reflection.FileDescriptor" ->
    // "Il2CppGoogle.Protobuf.Reflection.FileDescriptor").
    private static Type? ResolveType(string name)
    {
        foreach (Assembly asm in AppDomain.CurrentDomain.GetAssemblies())
        {
            try
            {
                var t = asm.GetType(name, false) ?? asm.GetType("Il2Cpp" + name, false);
                if (t != null) return t;
                int dot = name.IndexOf('.');
                if (dot > 0)
                {
                    var ns = asm.GetType("Il2Cpp" + name.Substring(0, dot) + name.Substring(dot), false);
                    if (ns != null) return ns;
                }
            }
            catch { }
        }
        return null;
    }
    // Harmony postfix on FileDescriptor.BuildFrom / FromGeneratedCode.
    // __result is the freshly-built FileDescriptor (Il2Cpp proxy, boxed as
    // object — same pattern the ClientMod uses for il2cpp reference returns).
    public static void Captured_Postfix(object? __result)
    {
        Fired();
        if (__result == null) return;
        try { CollectFile(__result); }
        catch { /* never let our hook disturb the game */ }
    }
    // Postfix on the FileDescriptor instance ctor — __instance is the freshly
    // constructed descriptor (SerializedData/Proto/Name already set).
    public static void Ctor_Postfix(object? __instance)
    {
        Fired();
        if (__instance == null) return;
        try { CollectFile(__instance); }
        catch { /* never let our hook disturb the game */ }
    }
    // Live DescriptorPool references seen via AddSymbol, kept so ScanPools() can
    // enumerate every descriptor a pool holds (already-built → no force-build).
    private static readonly List<object> Pools = new();
    // Postfix on DescriptorPool.AddSymbol / AddPackage. __instance is the pool,
    // __0 is the IDescriptor symbol being registered. Walk symbol.File to the
    // owning FileDescriptor and collect it.
    public static void AddSymbol_Postfix(object? __instance, object? __0)
    {
        Fired();
        try
        {
            if (__instance != null)
            {
                lock (Gate)
                {
                    bool known = false;
                    foreach (var p in Pools) if (ReferenceEquals(p, __instance)) { known = true; break; }
                    if (!known) Pools.Add(__instance);
                }
            }
            if (__0 == null) return;
            object? file = GetProp(__0, "File");
            if (file != null) CollectFile(file);
        }
        catch { /* never let our hook disturb the game */ }
    }
    // Interception heartbeat — proves a hooked method actually ran. Logged once
    // on first fire, so "no output" can be diagnosed as inlining (never fires)
    // vs. content-not-loaded (fires but no proto-building content yet).
    private static void Fired()
    {
        long n = System.Threading.Interlocked.Increment(ref _fireCount);
        if (!_firstFireLogged)
        {
            _firstFireLogged = true;
            _log?.Msg("ProtoDumper: FIRST DESCRIPTOR CAPTURED — interception is live.");
        }
    }
    private static void CollectFile(object file)
    {
        string? name = GetProp(file, "Name") as string;
        if (string.IsNullOrEmpty(name)) return;
        lock (Gate)
        {
            if (Files.ContainsKey(name!)) return;
            string b64 = DescriptorBase64(file);
            Files[name!] = b64;
            _dirty = true;
        }
        // Capture import dependencies too (closure of well-known + leaf protos).
        try
        {
            object? deps = GetProp(file, "Dependencies");
            if (deps != null)
            {
                var dt = deps.GetType();
                var countP = dt.GetProperty("Count");
                var itemM = dt.GetMethod("get_Item", new[] { typeof(int) });
                if (countP != null && itemM != null)
                {
                    int n = (int)(countP.GetValue(deps) ?? 0);
                    for (int i = 0; i < n; i++)
                    {
                        object? dep = itemM.Invoke(deps, new object[] { i });
                        if (dep != null) CollectFile(dep);
                    }
                }
            }
        }
        catch { }
    }
    private static string DescriptorBase64(object file)
    {
        try
        {
            // FileDescriptor exposes no public SerializedData property — only
            // the Il2CppInterop backing field (a ByteString with the original
            // descriptor bytes). Fall back to re-serialising the parsed Proto.
            object? sd = GetProp(file, "_SerializedData_k__BackingField")
                         ?? GetProp(file, "SerializedData");
            if (sd != null)
            {
                string b = ByteStringToBase64(sd);
                if (b.Length > 0) return b;
            }
            object? proto = GetProp(file, "Proto");
            if (proto != null)
            {
                MethodInfo? toBs = proto.GetType().GetMethod("ToByteString", Type.EmptyTypes);
                object? bs = toBs?.Invoke(proto, null);
                if (bs != null) return ByteStringToBase64(bs);
            }
        }
        catch { }
        return "";
    }
    private static string ByteStringToBase64(object byteString)
    {
        MethodInfo? toB64 = byteString.GetType().GetMethod("ToBase64", Type.EmptyTypes);
        return toB64?.Invoke(byteString, null) as string ?? "";
    }
    private static object? GetProp(object obj, string propName)
    {
        var p = obj.GetType().GetProperty(propName,
            BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
        return p?.GetValue(obj);
    }
    private long _lastReportedFire = -1;
    public override void OnUpdate()
    {
        // Flush to disk shortly after new descriptors are captured (every ~1s).
        if (++_frame % 60 == 0 && _dirty)
            Flush();
        // Every ~5s, if the hooks fired since last report, log the running
        // fire/capture counts — surfaces "fired but 0 files" (empty base64)
        // separately from "never fired".
        if (_frame % 300 == 0)
        {
            long f = System.Threading.Interlocked.Read(ref _fireCount);
            if (f != _lastReportedFire)
            {
                _lastReportedFire = f;
                int files; lock (Gate) files = Files.Count;
                _log?.Msg($"ProtoDumper heartbeat: hook-fires={f}, unique-descriptors={files}");
            }
        }
    }
    public override void OnApplicationQuit() => Flush();
    private static void Flush()
    {
        lock (Gate)
        {
            if (!_dirty) return;
            _dirty = false;
            try
            {
                var sb = new StringBuilder();
                int withData = 0;
                foreach (var kv in Files)
                {
                    if (kv.Value.Length == 0) continue;
                    withData++;
                    sb.Append(kv.Key).Append('\t').Append(kv.Value).Append('\n');
                    string fp = Path.Combine(_filesDir, Sanitize(kv.Key) + ".b64");
                    if (!File.Exists(fp)) File.WriteAllText(fp, kv.Value);
                }
                File.WriteAllText(Path.Combine(_outDir, "manifest.tsv"), sb.ToString());
                string line = $"captured files={Files.Count} (with-data={withData})";
                File.AppendAllText(Path.Combine(_outDir, "dump.log"), line + "\n");
                _log?.Msg($"ProtoDumper: {line} -> {_outDir}");
            }
            catch (Exception e) { _log?.Error($"ProtoDumper flush error: {e}"); }
        }
    }
    private static string Sanitize(string protoPath)
    {
        var sb = new StringBuilder(protoPath.Length);
        foreach (char c in protoPath)
            sb.Append(char.IsLetterOrDigit(c) || c == '_' || c == '-' || c == '.' ? c : '_');
        return sb.ToString();
    }
 }
@@ -1,81 +0,0 @@
 # DorkNet ProtoDumper
 Runtime extractor for Rec Room's Google.Protobuf schema (room save /
 creation / circuits data model). Produces clean `.proto` files for any
 client build — including obfuscated ones like 2023.03.21 where static
 reconstruction from `global-metadata.dat` is unreliable (the descriptor
 base64 is split into scattered string-literal chunks whose concat order
 only lives in IL).
 At runtime every `FileDescriptor` still carries its original,
 un-obfuscated `FileDescriptorProto` (real message names, field names,
 numbers and types intact). The catch: Rec Room builds these descriptors
 **lazily and in a specific dependency order** as content loads. Trying to
 force-build them by reading a message type's static descriptor out of
 order throws inside the type's static constructor, and the failure is
 cached — *poisoning* the type (and crashing the client). So this mod does
 **not** enumerate types.
 Instead it Harmony-postfixes the one library method every generated cctor
 funnels through —
 `Google.Protobuf.Reflection.FileDescriptor.BuildFrom` /
 `.FromGeneratedCode` — and records each descriptor as the game builds it.
 Completely passive: **play the client through the content you care about**
 and every descriptor that loads is captured.
 ## Pipeline
 1. **Build the mod**
   ```sh
   dotnet build DorkNet.ProtoDumper/DorkNet.ProtoDumper.csproj -c Release
   ```
   Output: `DorkNet.ProtoDumper/bin/Release/DorkNet.ProtoDumper.dll`.
 2. **Run it on a *runnable* 2023.03.21 client (MelonLoader 0.6.6)**
   > The `GameAssembly.dll` + `il2cpp_data`-only copy under
   > `Recnet-old/dist/RecRoom-2023.03.21-il2cpp/…/staging/` is an
   > **offline-analysis payload, not a runnable build**. Use a full build
   > with the exe + UnityPlayer + MelonLoader (e.g. the devdork package).
   - Drop `DorkNet.ProtoDumper.dll` into `<RecRoom>\Mods\`. On launch it
     installs the descriptor-build hooks (see `dump.log` / MelonLoader
     console for "installed N descriptor-build hooks").
   - **Log in and play through the content whose schema you want:** your
     dorm, a created room, the Maker Pen, and a circuits (CV2) board. Each
     subsystem builds its protos the first time it loads. Descriptors are
     captured the instant they build — no scene/timer scanning, nothing is
     force-built, so the client stays stable.
   - Output appears under `<RecRoom>\DorkNet-ProtoDump\` and is flushed to
     disk ~1 s after new descriptors load, and again on quit:
     - `manifest.tsv`   — `<proto path>\t<base64>` per file
     - `files\*.b64`    — same, one file each
     - `dump.log`       — running capture count
 3. **Decode to .proto**
   ```sh
   pip install protobuf
   python DorkNet.ProtoDumper/decode_dump.py <path>/manifest.tsv proto_out
   ```
   Emits one `.proto` per descriptor under `proto_out/`, plus a combined
   `proto_out/recroom_2023.proto` (every rec_room/circuits message in one
   file) for an easy diff against
   `DorkNet.Server/Protos/recroom_2020.proto`.
 ## Notes
 - No game DLLs are referenced at compile time. `FileDescriptor` is the
  Google.Protobuf *library* type (not obfuscated); it's reached by its
  original name with the Il2Cpp namespace-prefix fallback, and its members
  are read via reflection. The same DLL works across builds and stays clean
  of derivative game code.
 - The only Harmony patches are the two read-only descriptor-build
  postfixes above — safe to run alongside (or without) `DorkNet.ClientMod`.
 - The descriptor base64 is the same `FileDescriptorProto` wire format
  Google's own tooling emits, so `decode_dump.py` (or `protoc
  --decode=google.protobuf.FileDescriptorProto descriptor.proto`) reads it
  directly.
@@ -1,165 +0,0 @@
 #!/usr/bin/env python3
 """Decode a DorkNet ProtoDumper manifest into .proto text.
 Usage:
    python decode_dump.py manifest.tsv  [out_dir]
 manifest.tsv has one  "<proto path>\\t<base64 FileDescriptorProto>"  line per
 file (as written by the ProtoDumper MelonLoader mod). This emits one .proto
 file per descriptor under out_dir/ (default: ./proto_out), plus a combined
 recroom_2023.proto with every rec_room/circuits message in one file for an
 easy diff against DorkNet.Server/Protos/recroom_2020.proto.
 Requires:  pip install protobuf
 """
 import sys, os, base64, re
 from google.protobuf import descriptor_pb2 as D
 FDP = D.FileDescriptorProto
 # proto3 scalar type names keyed by FieldDescriptorProto.Type
 SCALAR = {
    1: "double", 2: "float", 3: "int64", 4: "uint64", 5: "int32",
    6: "fixed64", 7: "fixed32", 8: "bool", 9: "string", 12: "bytes",
    13: "uint32", 15: "sfixed32", 16: "sfixed64", 17: "sint32", 18: "sint64",
 }
 LABEL_REPEATED = 3
 def type_name(f):
    if f.type in (11, 14):  # message / enum -> use type_name (strip leading dot)
        return f.type_name.lstrip(".")
    return SCALAR.get(f.type, f"type{f.type}")
 def emit_enum(e, indent):
    pad = "  " * indent
    out = [f"{pad}enum {e.name} {{"]
    for v in e.value:
        out.append(f"{pad}  {v.name} = {v.number};")
    out.append(f"{pad}}}")
    return out
 def emit_message(m, indent=0):
    pad = "  " * indent
    out = [f"{pad}message {m.name} {{"]
    # map<> detection: synthetic nested *Entry types with map_entry option
    map_entries = {}
    for nt in m.nested_type:
        if nt.options.map_entry:
            kt = type_name(nt.field[0])
            vt = type_name(nt.field[1])
            map_entries[nt.name] = (kt, vt)
    # which oneofs are real (not proto3 optional synthetic)
    for nt in m.nested_type:
        if nt.name in map_entries:
            continue
        out += emit_message(nt, indent + 1)
    for en in m.enum_type:
        out += emit_enum(en, indent + 1)
    # group fields by oneof
    printed_oneof = set()
    for f in m.field:
        # map field?
        if f.type == 11 and f.type_name.split(".")[-1] in map_entries:
            kt, vt = map_entries[f.type_name.split(".")[-1]]
            out.append(f"{pad}  map<{kt}, {vt}> {f.name} = {f.number};")
            continue
        if f.HasField("oneof_index") and not f.proto3_optional:
            idx = f.oneof_index
            if idx not in printed_oneof:
                printed_oneof.add(idx)
                out.append(f"{pad}  oneof {m.oneof_decl[idx].name} {{")
                for g in m.field:
                    if g.HasField("oneof_index") and g.oneof_index == idx and not g.proto3_optional:
                        out.append(f"{pad}    {type_name(g)} {g.name} = {g.number};")
                out.append(f"{pad}  }}")
            continue
        label = "repeated " if f.label == LABEL_REPEATED else ""
        opt = "optional " if f.proto3_optional else ""
        out.append(f"{pad}  {label}{opt}{type_name(f)} {f.name} = {f.number};")
    out.append(f"{pad}}}")
    return out
 def render_file(fdp):
    out = []
    syntax = fdp.syntax or "proto2"
    out.append(f'syntax = "{syntax}";')
    out.append("")
    if fdp.package:
        out.append(f"package {fdp.package};")
    for dep in fdp.dependency:
        out.append(f'import "{dep}";')
    if fdp.package or fdp.dependency:
        out.append("")
    for en in fdp.enum_type:
        out += emit_enum(en, 0)
        out.append("")
    for m in fdp.message_type:
        out += emit_message(m, 0)
        out.append("")
    return "\n".join(out).rstrip() + "\n"
 def main():
    if len(sys.argv) < 2:
        print(__doc__); sys.exit(1)
    manifest = sys.argv[1]
    out_dir = sys.argv[2] if len(sys.argv) > 2 else "proto_out"
    os.makedirs(out_dir, exist_ok=True)
    files = []
    with open(manifest, "r", encoding="utf-8") as fh:
        for ln in fh:
            ln = ln.rstrip("\n")
            if not ln or "\t" not in ln:
                continue
            name, b64 = ln.split("\t", 1)
            try:
                raw = base64.b64decode(b64)
                fdp = FDP(); fdp.ParseFromString(raw)
            except Exception as e:
                print(f"  ! failed to parse {name}: {e}")
                continue
            files.append((name, fdp))
    print(f"parsed {len(files)} descriptors")
    # per-file .proto
    for name, fdp in files:
        safe = re.sub(r"[^A-Za-z0-9_.\-]", "_", name)
        with open(os.path.join(out_dir, safe), "w", encoding="utf-8") as w:
            w.write(render_file(fdp))
    # combined rec_room/circuits view (skip google/* well-known imports)
    rr = [ (n,f) for n,f in files if not n.startswith("google/") ]
    seen = set(); combo = ['syntax = "proto3";', "", "package recroom;", ""]
    total_msgs = 0
    for name, fdp in sorted(rr, key=lambda x: x[0]):
        combo.append(f"// ===== {name}  (package {fdp.package or '-'}) =====")
        for m in fdp.message_type:
            if m.name in seen:
                continue
            seen.add(m.name)
            combo += emit_message(m, 0)
            combo.append("")
            total_msgs += 1
        for en in fdp.enum_type:
            combo += emit_enum(en, 0)
            combo.append("")
    with open(os.path.join(out_dir, "recroom_2023.proto"), "w", encoding="utf-8") as w:
        w.write("\n".join(combo).rstrip() + "\n")
    print(f"wrote {out_dir}/recroom_2023.proto with {total_msgs} unique messages "
          f"from {len(rr)} rec_room/circuits descriptors")
 if __name__ == "__main__":
    main()
@@ -1,154 +0,0 @@
 using System.Net;
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 using DorkNet.Server.Controllers.Match;
 using DorkNet.Server.Data;
 using DorkNet.Server.Services;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Regression: admin "pull a player into an instance" broke because the
 /// instance id (an int64 well past JS's 2^53 safe-integer range) was
 /// emitted as a JSON number. The admin SPA's JSON.parse rounded it to the
 /// nearest double, so the pull URL targeted a non-existent instance and
 /// the server returned <c>instance_not_active</c>. The fix serializes the
 /// id as a STRING so the exact digits survive the browser round-trip.
 /// </summary>
 public sealed class AdminInstancePullTests : IClassFixture<DorkNetServerFactory>
 {
    // A dorm-style instance id past 2^53 — the value class that a JS
    // Number cannot represent exactly.
    private const long BigInstanceId = 7597291079085522944L;
    private readonly DorkNetServerFactory _factory;
    public AdminInstancePullTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Instances_list_emits_id_as_string_and_pull_with_exact_id_succeeds()
    {
        using var setup = ApiClient();
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var streamer = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var pulled = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        long roomId;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            // Promote the caller to admin (AdminOnly reads IsAdmin from DB).
            var adminRow = await db.Players.FirstAsync(p => p.Id == admin.PlayerId);
            adminRow.IsAdmin = true;
            roomId = (await db.Rooms.FirstAsync(r => r.State == 0)).Id;
            await db.SaveChangesAsync();
            // Put the streamer in a live instance carrying the huge id.
            var presence = scope.ServiceProvider.GetRequiredService<PlayerPresenceService>();
            presence.SetRoom(streamer.PlayerId, new RoomInstanceDto
            {
                RoomInstanceId = BigInstanceId,
                RoomId = roomId,
                SubRoomId = 0,
                PhotonRoomId = "^teststreamerinstance",
                PhotonRegionId = "us",
                MaxCapacity = 8,
            });
            presence.MarkActive(streamer.PlayerId);
        }
        using var adminClient = ApiClient(admin);
        adminClient.BaseAddress = new Uri($"http://admin.{_factory.ApexDomain}");
        // The list must emit roomInstanceId as a STRING equal to the exact
        // digits — never a number (which would already be rounded here).
        var list = await GetJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/instances");
        var row = list.EnumerateArray()
            .First(r => r.GetProperty("roomInstanceId").GetString() == BigInstanceId.ToString());
        Assert.Equal(JsonValueKind.String, row.GetProperty("roomInstanceId").ValueKind);
        // Pull the second player in using the EXACT id from the list. This
        // is what the SPA does; with the string round-trip the digits are
        // intact and the instance matches (pre-fix: 404 instance_not_active).
        var idFromList = row.GetProperty("roomInstanceId").GetString()!;
        using var pull = await adminClient.PostAsync(
            $"/api/admin/v1/rooms/{roomId}/instances/{idFromList}/pull",
            new StringContent(JsonSerializer.Serialize(new { PlayerId = pulled.PlayerId }),
                Encoding.UTF8, "application/json"));
        Assert.Equal(HttpStatusCode.OK, pull.StatusCode);
        using var body = await JsonDocument.ParseAsync(await pull.Content.ReadAsStreamAsync());
        Assert.True(body.RootElement.GetProperty("ok").GetBoolean());
        // The pulled player now shares the streamer's instance.
        await using var verify = _factory.Services.CreateAsyncScope();
        var presenceCheck = verify.ServiceProvider.GetRequiredService<PlayerPresenceService>();
        Assert.Equal(BigInstanceId, presenceCheck.GetRoom(pulled.PlayerId)!.RoomInstanceId);
    }
    [Fact]
    public async Task Pull_with_precision_mangled_id_is_rejected()
    {
        using var setup = ApiClient();
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var streamer = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var pulled = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        long roomId;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            roomId = (await db.Rooms.FirstAsync(r => r.State == 0)).Id;
            await db.SaveChangesAsync();
            var presence = scope.ServiceProvider.GetRequiredService<PlayerPresenceService>();
            presence.SetRoom(streamer.PlayerId, new RoomInstanceDto
            {
                RoomInstanceId = BigInstanceId,
                RoomId = roomId,
                PhotonRoomId = "^teststreamerinstance2",
                PhotonRegionId = "us",
                MaxCapacity = 8,
            });
            presence.MarkActive(streamer.PlayerId);
        }
        using var adminClient = ApiClient(admin);
        adminClient.BaseAddress = new Uri($"http://admin.{_factory.ApexDomain}");
        // The value the admin SPA's JSON.parse actually produced for this
        // id (from the bug report log) — the exact failure mode.
        const long mangled = 7597291079085523000L;
        Assert.NotEqual(BigInstanceId, mangled);
        using var pull = await adminClient.PostAsync(
            $"/api/admin/v1/rooms/{roomId}/instances/{mangled}/pull",
            new StringContent(JsonSerializer.Serialize(new { PlayerId = pulled.PlayerId }),
                Encoding.UTF8, "application/json"));
        Assert.Equal(HttpStatusCode.NotFound, pull.StatusCode);
    }
    private HttpClient ApiClient(GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
    private static async Task<JsonElement> GetJsonAsync(HttpClient client, string path)
    {
        using var response = await client.GetAsync(path);
        response.EnsureSuccessStatusCode();
        using var document = await JsonDocument.ParseAsync(await response.Content.ReadAsStreamAsync());
        return document.RootElement.Clone();
    }
 }
@@ -1,47 +0,0 @@
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 using DorkNet.Server.Data;
 namespace DorkNet.Server.Tests;
 public sealed class CanonicalRoomBootstrapTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public CanonicalRoomBootstrapTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Bootstrap_seeds_stunt_runner_subroom_and_rec_rally_remote_image_name()
    {
        using var _ = _factory.CreateClient(new() { AllowAutoRedirect = false });
        await using var scope = _factory.Services.CreateAsyncScope();
        var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
        var stuntRunner = await db.Rooms.SingleAsync(r => r.Name == "StuntRunner");
        var stuntRunnerScenes = await db.RoomScenes
            .Where(s => s.RoomId == stuntRunner.Id)
            .OrderBy(s => s.OrderIndex)
            .ToListAsync();
        Assert.Collection(
            stuntRunnerScenes,
            scene =>
            {
                Assert.Equal(0, scene.OrderIndex);
                Assert.Equal("StuntRunner", scene.Name);
                Assert.Equal("b7281665-a715-4051-826b-8e08e69c6172", scene.RoomSceneLocationId);
                Assert.Equal("", scene.DataBlobName);
            },
            scene =>
            {
                Assert.Equal(1, scene.OrderIndex);
                Assert.Equal("TheMainEvent", scene.Name);
                Assert.Equal("3a636bd2-f896-424c-9225-c184522c0d87", scene.RoomSceneLocationId);
                Assert.Equal("", scene.DataBlobName);
            });
        var recRally = await db.Rooms.SingleAsync(r => r.Name == "RecRally");
        Assert.Equal("image_RecRally.jpg", recRally.ImageName);
    }
 }
@@ -1,88 +0,0 @@
 using System.Net;
 using System.Text;
 using System.Text.Json;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// End-to-end coverage for the 3D Charades word-list feature and the
 /// profanity-filter toggle. Boots the full server (which runs the seeder)
 /// against SQLite via <see cref="DorkNetServerFactory"/> and exercises the
 /// public wire endpoints the March 2023 client actually calls.
 /// </summary>
 public sealed class CharadesWordListTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public CharadesWordListTests(DorkNetServerFactory factory) => _factory = factory;
    private HttpClient ApiClient()
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        return client;
    }
    [Theory]
    [InlineData("Charades")]              // enum-name form
    [InlineData("CharadesAprilFoolsDay")]
    [InlineData("Icebreakers")]
    [InlineData("0")]                     // int form the client may send
    [InlineData("1")]
    [InlineData("2")]
    public async Task Words_endpoint_returns_seeded_deck_in_wire_shape(string source)
    {
        using var client = ApiClient();
        using var res = await client.GetAsync($"/api/activities/charades/v1/words/{source}");
        Assert.Equal(HttpStatusCode.OK, res.StatusCode);
        using var doc = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
        Assert.Equal(JsonValueKind.Array, doc.RootElement.ValueKind);
        Assert.True(doc.RootElement.GetArrayLength() > 0, $"expected a non-empty deck for '{source}'");
        var first = doc.RootElement[0];
        // Exact wire key casing the client's LitJson importer reads.
        Assert.True(first.TryGetProperty("EN_US", out var en) && en.ValueKind == JsonValueKind.String,
            "each card must expose a string EN_US field");
        Assert.True(first.TryGetProperty("Difficulty", out var diff) && diff.ValueKind == JsonValueKind.Number,
            "each card must expose a numeric Difficulty field");
    }
    [Fact]
    public async Task December_noparam_route_serves_the_charades_slot()
    {
        using var client = ApiClient();
        using var res = await client.GetAsync("/api/activities/charades/v1/words");
        Assert.Equal(HttpStatusCode.OK, res.StatusCode);
        using var doc = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
        Assert.True(doc.RootElement.GetArrayLength() > 0);
    }
    [Fact]
    public async Task Unknown_source_falls_back_to_charades_slot()
    {
        using var client = ApiClient();
        using var res = await client.GetAsync("/api/activities/charades/v1/words/totally-bogus");
        Assert.Equal(HttpStatusCode.OK, res.StatusCode);
        using var doc = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
        Assert.Equal(JsonValueKind.Array, doc.RootElement.ValueKind);
        Assert.True(doc.RootElement.GetArrayLength() > 0);
    }
    [Fact]
    public async Task Profanity_filter_is_active_by_default()
    {
        using var client = ApiClient();
        using var res = await client.PostAsync(
            "/api/sanitize/v1/requestIsStringPure",
            new StringContent("{\"Value\":\"you piece of shit\"}", Encoding.UTF8, "application/json"));
        Assert.Equal(HttpStatusCode.OK, res.StatusCode);
        var body = (await res.Content.ReadAsStringAsync()).Trim();
        // Default state: filter on → the profane string is NOT pure.
        Assert.Equal("false", body.ToLowerInvariant());
    }
 }
@@ -1,88 +0,0 @@
 using System.Net;
 using System.Net.Http.Headers;
 using System.Text.Json;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Starting a chat with a player is a two-step handshake, and both steps have to
 /// work on a thread that has never carried a message:
 ///
 ///   POST thread/withmembers?ids={playerId}   -> creates/returns the thread
 ///   GET  thread/{id}                         -> opens it
 ///
 /// Observed failing in production: the POST returned 200 at 06:38:20.862 and the
 /// GET 404'd 415ms later, because the handler decided a thread existed by
 /// counting its messages. A brand-new conversation has none, so the client was
 /// handed a thread id it was then told did not exist, and no chat could ever be
 /// opened with someone you had not already messaged.
 /// </summary>
 public sealed class ChatStartConversationTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public ChatStartConversationTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Brand_new_conversation_can_be_opened_before_any_message_is_sent()
    {
        using var starterClient = Client();
        using var otherClient = Client();
        var starter = await GameClientSessionFactory.CreateAsync(starterClient, _factory.ApexDomain);
        var other = await GameClientSessionFactory.CreateAsync(otherClient, _factory.ApexDomain);
        starterClient.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", starter.AccessToken);
        // Step 1 — the client asks for the thread with that player. It sends the
        // ids as a form body (observed on the wire as
        // "ids=9741717&messageCount=50"), which also matters for routing: the
        // content type is what separates this from POST thread/{chatThreadId},
        // whose parameter segment otherwise also matches "withmembers".
        using var form = new FormUrlEncodedContent(
        [
            new KeyValuePair<string, string>("ids", other.PlayerId.ToString()),
            new KeyValuePair<string, string>("messageCount", "50"),
        ]);
        using var createResponse = await starterClient.PostAsync("/thread/withmembers", form);
        var createBody = await createResponse.Content.ReadAsStringAsync();
        Assert.True(createResponse.IsSuccessStatusCode,
            $"POST /thread/withmembers -> {(int)createResponse.StatusCode}: {createBody}");
        var thread = JsonDocument.Parse(createBody).RootElement;
        Assert.True(thread.TryGetProperty("ChatThreadId", out var idElement)
                    || thread.TryGetProperty("chatThreadId", out idElement),
            $"no thread id in the withmembers reply: {createBody}");
        var threadId = idElement.ValueKind == JsonValueKind.String
            ? idElement.GetString()
            : idElement.ToString();
        Assert.False(string.IsNullOrWhiteSpace(threadId));
        // Step 2 — and immediately opens it. No message has been sent yet.
        using var openResponse = await starterClient.GetAsync($"/thread/{threadId}?maxCount=50");
        var openBody = await openResponse.Content.ReadAsStringAsync();
        Assert.True(openResponse.StatusCode != HttpStatusCode.NotFound,
            $"""
             GET /thread/{threadId} returned 404 for a thread that thread/withmembers
             had just created. An empty thread is not a missing thread — the chat
             cannot be opened until someone has already sent a message, which is
             impossible to do first.
             """);
        Console.WriteLine("=== WITHMEMBERS ===");
        Console.WriteLine(createBody);
        Console.WriteLine("=== GET THREAD ===");
        Console.WriteLine(openBody);
        Assert.True(openResponse.IsSuccessStatusCode,
            $"GET /thread/{threadId} -> {(int)openResponse.StatusCode}: {openBody}");
    }
    private HttpClient Client()
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://chat.{_factory.ApexDomain}");
        return client;
    }
 }
@@ -1,202 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Asserts our responses carry EXACTLY the keys the 2023-03-21 client's
 /// generated readers register — no missing ones, no invented ones.
 ///
 /// This is stricter than "the client doesn't crash" on purpose. A wrong key set
 /// does not produce a bad request: the server answers HTTP 200, the reader
 /// throws while deserialising, and it surfaces later as a bare "Failed to copy
 /// room" with no URL and no payload logged on either side. By the time it is
 /// visible there is nothing left to diagnose it with.
 ///
 /// The expected sets are extracted straight from the binary by
 /// <c>tools/extract-client-dto-keys.py</c> into
 /// <c>data/client-dto-keys-2023.json</c>, keyed by the obfuscated reader type.
 /// Cpp2IL emits each reader's property names as string literals in registration
 /// order, so that file is the client's own contract rather than our reading of
 /// it — regenerate it rather than editing it by hand.
 /// </summary>
 public sealed class ClientDtoParityTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public ClientDtoParityTests(DorkNetServerFactory factory) => _factory = factory;
    /// <summary>GLEGPFFPDBE — the room-details reader. This is what
    /// <c>GET rooms/{id}</c> and <c>POST rooms/{id}/clone</c> both deserialise
    /// into (clone's return type FGCPNAACHIK, NLDBPDCNNCF.txt:4676).</summary>
    private const string RoomDetailsReader = "GLEGPFFPDBE";
    /// <summary>EKEFFNBIOHJ — the chat-thread reader, shared by
    /// <c>POST thread/withmembers</c> and <c>GET thread/{id}</c>.</summary>
    private const string ChatThreadReader = "EKEFFNBIOHJ";
    /// <summary>Keys the reader registers that we deliberately do NOT send.
    ///
    /// A registered slot does not oblige us to fill it — Newtonsoft leaves an
    /// absent key at its default. These two were added for parity and broke
    /// the dorm: which blob a room loads is decided per INSTANCE (the matchmake
    /// response carries it, and a dorm's is per-player, dorm_p{id}_v*.dat) and
    /// per SUB-ROOM. A room-scoped answer to the same question is one the
    /// client preferred, and for a dorm it named a file that was never written,
    /// so the room came back "corrupt".
    ///
    /// Every room loaded fine while these were absent. Their absence is the
    /// fix, not a gap to close later — do not "restore parity" here without a
    /// dorm join to prove it.</summary>
    private static readonly HashSet<(string Reader, string Key)> DeliberatelyOmitted =
    [
        (RoomDetailsReader, "DataBlob"),
        (RoomDetailsReader, "DataBlobHash"),
    ];
    [Fact]
    public async Task Room_details_carries_exactly_the_keys_the_client_reads()
    {
        using var client = RoomsClient();
        var session = await GameClientSessionFactory.CreateAsync(client, _factory.ApexDomain);
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", session.AccessToken);
        var roomId = 9_600_000 + Random.Shared.Next(1, 99_999);
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"Parity{Guid.NewGuid():N}"[..18],
                CreatorPlayerId = session.PlayerId,
                CloningAllowed = true,
            });
            db.RoomScenes.Add(new RoomSceneEntity { RoomId = roomId, Name = "Home", OrderIndex = 0 });
            await db.SaveChangesAsync();
        }
        using var response = await client.GetAsync($"/rooms/{roomId}");
        var body = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"GET /rooms/{roomId} -> {(int)response.StatusCode}: {body}");
        AssertKeyParity(RoomDetailsReader, body, $"GET rooms/{roomId}");
        // The reader walks into the nested objects too, and a wrong key set
        // there fails exactly the same way — a 200 the client throws on.
        var details = JsonDocument.Parse(body).RootElement;
        foreach (var (property, reader) in NestedReaders)
        {
            if (!details.TryGetProperty(property, out var value)) continue;
            var element = value.ValueKind switch
            {
                JsonValueKind.Array when value.GetArrayLength() > 0 => value[0],
                JsonValueKind.Object => value,
                _ => default,
            };
            if (element.ValueKind != JsonValueKind.Object) continue;
            AssertKeyParity(reader, element.GetRawText(),
                $"GET rooms/{roomId} → {property}{(value.ValueKind == JsonValueKind.Array ? "[0]" : "")}");
        }
    }
    /// <summary>Nested objects in the room-details payload and the reader each
    /// one is deserialised by. Sub-room 0, the first role, the stats object and
    /// the first tag all have their own generated readers, and a key set that
    /// disagrees with them breaks the whole room just as hard as a wrong
    /// top-level one.</summary>
    private static readonly (string Property, string Reader)[] NestedReaders =
    [
        ("SubRooms", "JDEKAFDPGBE"),
        ("Roles", "LMEECKCCPHG"),
        ("Stats", "MLHBPDKBABN"),
        ("Tags", "GEGADPCDGBO"),
    ];
    [Fact]
    public async Task Chat_thread_carries_exactly_the_keys_the_client_reads()
    {
        using var client = ChatClient();
        using var otherClient = ChatClient();
        var starter = await GameClientSessionFactory.CreateAsync(client, _factory.ApexDomain);
        var other = await GameClientSessionFactory.CreateAsync(otherClient, _factory.ApexDomain);
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", starter.AccessToken);
        using var form = new FormUrlEncodedContent(
        [
            new KeyValuePair<string, string>("ids", other.PlayerId.ToString()),
            new KeyValuePair<string, string>("messageCount", "50"),
        ]);
        using var response = await client.PostAsync("/thread/withmembers", form);
        var body = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode,
            $"POST /thread/withmembers -> {(int)response.StatusCode}: {body}");
        AssertKeyParity(ChatThreadReader, body, "POST thread/withmembers");
    }
    /// <summary>Compare one response object's keys against the reader's set.
    /// Matching is case-insensitive because the readers register three spellings
    /// per field (Pascal, camel, lower) and accept any of them — casing is the
    /// one thing they are NOT strict about.</summary>
    private static void AssertKeyParity(string readerType, string body, string what)
    {
        var expected = LoadReaderKeys(readerType)
            .Where(k => !DeliberatelyOmitted.Contains((readerType, k)))
            .ToList();
        var actual = JsonDocument.Parse(body).RootElement
            .EnumerateObject().Select(p => p.Name)
            .ToHashSet(StringComparer.OrdinalIgnoreCase);
        var missing = expected.Where(k => !actual.Contains(k)).ToList();
        var extra = actual
            .Where(k => !expected.Contains(k, StringComparer.OrdinalIgnoreCase))
            .Order(StringComparer.OrdinalIgnoreCase)
            .ToList();
        Assert.True(missing.Count == 0 && extra.Count == 0,
            $"""
             {what} does not match what the client's {readerType} reader expects.
             MISSING ({missing.Count}) — the reader registers these and we never send them;
             a non-nullable field left null is what throws mid-deserialise:
               {string.Join(", ", missing)}
             UNEXPECTED ({extra.Count}) — we send these and the reader has no slot for them:
               {string.Join(", ", extra)}
             Expected, in the reader's own registration order:
               {string.Join(", ", expected)}
             """);
    }
    private static List<string> LoadReaderKeys(string readerType)
    {
        var path = Path.Combine(AppContext.BaseDirectory, "data", "client-dto-keys-2023.json");
        Assert.True(File.Exists(path),
            $"missing {path} — regenerate with tools/extract-client-dto-keys.py");
        using var doc = JsonDocument.Parse(File.ReadAllText(path));
        Assert.True(doc.RootElement.TryGetProperty(readerType, out var keys),
            $"{readerType} is not in the extracted catalogue");
        return keys.EnumerateArray().Select(k => k.GetString()!).ToList();
    }
    private HttpClient RoomsClient() => ClientFor("rooms");
    private HttpClient ChatClient() => ClientFor("chat");
    private HttpClient ClientFor(string host)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{host}.{_factory.ApexDomain}");
        return client;
    }
 }
@@ -1,115 +0,0 @@
 using System.Text.RegularExpressions;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Asserts that every HTTP request the Rec Room 2023-03-21 client can issue has
 /// a handler on this server, under the verb the client actually uses.
 ///
 /// Rec Room is shut down, so the client can't be observed against a live server.
 /// <c>data/client-routes-2023.tsv</c> is the recovered inventory of what it
 /// asks for — see <c>docs/recroom-2023-client-api-complete.md</c> for how it was
 /// extracted. This test is the regression guard on that inventory: adding a
 /// client route without a handler, or moving a handler to a different verb,
 /// fails here rather than silently 404/405-ing a real player.
 ///
 /// Routes not yet implemented live in <see cref="KnownGaps"/>. That list is
 /// expected to shrink and never grow. Deleting an entry as you implement it is
 /// the point — it is the project's running score against the client.
 /// </summary>
 public sealed class ClientRouteCoverageTests
 {
    /// <summary>Client routes with no handler yet. Each entry is
    /// <c>VERB route</c> exactly as it appears in the inventory file.
    ///
    /// This is EMPTY, and that is the point: every request the 2023-03-21
    /// client can issue reaches a handler under the verb it actually uses. Do
    /// not add an entry to make a red build green — an entry here is a promise
    /// that the client gets a 404 or 405 in the wild. Implement the route, or
    /// if the inventory itself is wrong (a literal that is really a cache key,
    /// a deeplink, or a base the client concatenates onto), fix the inventory
    /// so the claim stays honest.</summary>
    private static readonly HashSet<string> KnownGaps = new(StringComparer.OrdinalIgnoreCase);
    [Fact]
    public void Every_client_route_has_a_handler()
    {
        var client = LoadClientRoutes();
        Assert.NotEmpty(client);
        var discovered = EndpointContractDiscovery.Discover()
            .Select(r => (Verb: r.Method.ToUpperInvariant(), Pattern: Normalise(r.Template)))
            .ToList();
        var server = discovered.ToHashSet();
        // A bare [Route] with no verb attribute serves every verb.
        var verbless = discovered
            .Where(d => d.Verb == "ANY")
            .Select(d => d.Pattern)
            .ToHashSet(StringComparer.Ordinal);
        var serverAnyVerb = discovered.Select(s => s.Pattern).ToHashSet(StringComparer.Ordinal);
        var missing = new List<string>();
        var wrongVerb = new List<string>();
        foreach (var (verb, route, _) in client)
        {
            var pattern = Normalise(route);
            if (server.Contains((verb, pattern)) || verbless.Contains(pattern)) continue;
            // Distinguish "no handler at all" from "handler exists, wrong verb" —
            // they have different causes and different fixes.
            if (serverAnyVerb.Contains(pattern)) wrongVerb.Add($"{verb} {route}");
            else missing.Add($"{verb} {route}");
        }
        var gaps = missing.Concat(wrongVerb)
            .Where(g => !KnownGaps.Contains(g))
            .OrderBy(g => g, StringComparer.Ordinal)
            .ToList();
        var covered = client.Count - missing.Count - wrongVerb.Count;
        var pct = 100.0 * covered / client.Count;
        Assert.True(gaps.Count == 0,
            $"""
             Client route coverage: {covered}/{client.Count} ({pct:F1}%).
             {missing.Count} missing, {wrongVerb.Count} wrong-verb, {KnownGaps.Count} known gaps.
             Unlisted gaps ({gaps.Count}) — implement them, or add to KnownGaps with a reason:
             {string.Join(Environment.NewLine, gaps)}
             """);
    }
    /// <summary>Collapse a route to a comparable shape: no host, no leading or
    /// trailing slash, no query, and every parameter — the client's <c>{0}</c>
    /// and the server's <c>{id:long}</c> alike — reduced to <c>*</c>.</summary>
    private static string Normalise(string route)
    {
        var r = route.Trim();
        var q = r.IndexOf('?');
        if (q >= 0) r = r[..q];
        r = r.Trim('/', '~');
        r = Regex.Replace(r, @"\{[^}]*\}", "*");
        return r.ToLowerInvariant();
    }
    private static List<(string Verb, string Route, string Subsystem)> LoadClientRoutes()
    {
        var path = Path.Combine(AppContext.BaseDirectory, "data", "client-routes-2023.tsv");
        Assert.True(File.Exists(path), $"missing route inventory at {path}");
        var rows = new List<(string, string, string)>();
        foreach (var line in File.ReadLines(path))
        {
            if (line.Length == 0 || line[0] == '#') continue;
            var parts = line.Split('\t');
            if (parts.Length < 2) continue;
            rows.Add((parts[0].Trim().ToUpperInvariant(), parts[1].Trim(),
                      parts.Length > 2 ? parts[2].Trim() : string.Empty));
        }
        return rows;
    }
 }
@@ -1,32 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsPackable>false</IsPackable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="coverlet.collector" Version="6.0.2" />
    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.4" />
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
    <PackageReference Include="xunit" Version="2.9.2" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\DorkNet.Server\DorkNet.Server.csproj" />
    <ProjectReference Include="..\DorkNet.Contracts\DorkNet.Contracts.csproj" />
  </ItemGroup>
  <ItemGroup>
    <Using Include="Xunit" />
  </ItemGroup>
  <ItemGroup>
    <!-- Recovered client route inventory read by ClientRouteCoverageTests. -->
    <Content Include="data\**" CopyToOutputDirectory="PreserveNewest" />
  </ItemGroup>
 </Project>
@@ -1,90 +0,0 @@
 using System.Text;
 using Microsoft.AspNetCore.Authentication.JwtBearer;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.HostFiltering;
 using Microsoft.AspNetCore.Mvc.Testing;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.IdentityModel.Tokens;
 namespace DorkNet.Server.Tests;
 public sealed class DorkNetServerFactory : WebApplicationFactory<Program>
 {
    private const string JwtSecret = "endpoint-contract-secret-000000000000000000000000000000000000000000";
    private readonly string _dataRoot;
    public DorkNetServerFactory()
    {
        _dataRoot = Path.Combine(Path.GetTempPath(), "dorknet-server-tests", Guid.NewGuid().ToString("N"));
        Directory.CreateDirectory(_dataRoot);
    }
    public string ApexDomain => "dork.test";
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.UseEnvironment("Development");
        builder.UseSetting("Domain:Apex", ApexDomain);
        builder.ConfigureAppConfiguration((_, config) =>
        {
            config.AddInMemoryCollection(new Dictionary<string, string?>
            {
                ["AllowedHosts"] = "*",
                ["Database:Provider"] = "sqlite",
                ["Database:SqlitePath"] = Path.Combine(_dataRoot, "dorknet-test.db"),
                ["Domain:Apex"] = ApexDomain,
                ["Jwt:Secret"] = JwtSecret,
                ["S3:Endpoint"] = "",
                ["S3:AccessKey"] = "",
                ["S3:SecretKey"] = "",
                ["DorkNet:DefaultClientVersion"] = "march_2023_03_21",
                ["DorkNet:SupportedVersions:0"] = "march_2023_03_21",
            });
        });
        builder.ConfigureServices(services =>
        {
            services.PostConfigure<HostFilteringOptions>(options =>
            {
                options.AllowedHosts =
                [
                    ApexDomain,
                    $"*.{ApexDomain}",
                    "localhost",
                    "127.0.0.1",
                ];
                options.AllowEmptyHosts = true;
                options.IncludeFailureMessage = true;
            });
            services.PostConfigure<JwtBearerOptions>(JwtBearerDefaults.AuthenticationScheme, options =>
            {
                options.TokenValidationParameters = new TokenValidationParameters
                {
                    ValidateIssuerSigningKey = true,
                    IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(JwtSecret)),
                    ValidateIssuer = true,
                    ValidIssuer = "https://api.rec.net/",
                    ValidateAudience = false,
                    ClockSkew = TimeSpan.Zero,
                };
            });
        });
    }
    protected override void Dispose(bool disposing)
    {
        base.Dispose(disposing);
        try
        {
            if (Directory.Exists(_dataRoot))
            {
                Directory.Delete(_dataRoot, recursive: true);
            }
        }
        catch
        {
            // Test cleanup must not hide the original test failure.
        }
    }
 }
@@ -1,235 +0,0 @@
 using System.Reflection;
 using System.Text.RegularExpressions;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.AspNetCore.Mvc.Routing;
 namespace DorkNet.Server.Tests;
 public static partial class EndpointContractDiscovery
 {
    public static IReadOnlyList<EndpointContract> Discover()
    {
        var serverAssembly = typeof(Program).Assembly;
        var controllerBaseType = typeof(ControllerBase);
        return serverAssembly.GetTypes()
            .Where(t => !t.IsAbstract && controllerBaseType.IsAssignableFrom(t))
            .SelectMany(DiscoverControllerRoutes)
            .OrderBy(route => route.Method, StringComparer.Ordinal)
            .ThenBy(route => route.SamplePath, StringComparer.Ordinal)
            .ThenBy(route => route.Source, StringComparer.Ordinal)
            .ToArray();
    }
    private static IEnumerable<EndpointContract> DiscoverControllerRoutes(Type controller)
    {
        var controllerName = ControllerName(controller);
        var controllerRouteTemplates = controller.GetCustomAttributes(inherit: true)
            .OfType<IRouteTemplateProvider>()
            .Select(a => a.Template)
            .Where(t => !string.IsNullOrWhiteSpace(t))
            .Cast<string>()
            .DefaultIfEmpty("")
            .ToArray();
        foreach (var method in controller.GetMethods(BindingFlags.Instance | BindingFlags.Public | BindingFlags.DeclaredOnly))
        {
            var httpAttrs = method.GetCustomAttributes(inherit: true)
                .OfType<HttpMethodAttribute>()
                .Cast<IRouteTemplateProvider>()
                .ToArray();
            // An action can carry a bare [Route("...")] with no [HttpGet]/[HttpPost],
            // which routes ALL verbs — the CDN's unity_assets handler is the live
            // example. Skipping those made the discovered table under-report the
            // server, so route-coverage checks saw phantom gaps.
            if (httpAttrs.Length == 0)
            {
                httpAttrs = method.GetCustomAttributes(inherit: true)
                    .OfType<IRouteTemplateProvider>()
                    .Where(a => !string.IsNullOrWhiteSpace(a.Template))
                    .ToArray();
            }
            if (httpAttrs.Length == 0)
            {
                continue;
            }
            foreach (var attr in httpAttrs)
            {
                var attrMethods = attr is HttpMethodAttribute { HttpMethods: var verbs } && verbs.Any()
                    ? verbs
                    : new[] { "ANY" };
                foreach (var httpMethod in attrMethods)
                {
                    foreach (var controllerTemplate in controllerRouteTemplates)
                    {
                        var template = CombineTemplates(controllerTemplate, attr.Template);
                        template = ReplaceRouteTokens(template, controllerName, method.Name);
                        yield return new EndpointContract(
                            httpMethod.ToUpperInvariant(),
                            template,
                            ToSamplePath(template),
                            $"{controller.FullName}.{method.Name}",
                            RequiresAuthorization(controller, method),
                            IsAdminEndpoint(controller, method),
                            ConsumesContentTypes(controller, method));
                    }
                }
            }
        }
    }
    private static bool RequiresAuthorization(Type controller, MethodInfo method)
    {
        var attributes = controller.GetCustomAttributes(inherit: true)
            .Concat(method.GetCustomAttributes(inherit: true))
            .ToArray();
        if (attributes.OfType<IAllowAnonymous>().Any())
        {
            return false;
        }
        return attributes.OfType<IAuthorizeData>().Any();
    }
    private static bool IsAdminEndpoint(Type controller, MethodInfo method)
    {
        return controller.FullName?.Contains(".Controllers.Admin.", StringComparison.Ordinal) == true
            || method.Name.Contains("Admin", StringComparison.OrdinalIgnoreCase);
    }
    private static string[] ConsumesContentTypes(Type controller, MethodInfo method)
    {
        var consumes = method.GetCustomAttributes(inherit: true)
            .Concat(controller.GetCustomAttributes(inherit: true))
            .OfType<ConsumesAttribute>()
            .SelectMany(a => a.ContentTypes)
            .Distinct(StringComparer.OrdinalIgnoreCase)
            .ToArray();
        return consumes.Length == 0
            ? ["application/json"]
            : consumes;
    }
    private static string ControllerName(Type controller)
    {
        const string suffix = "Controller";
        return controller.Name.EndsWith(suffix, StringComparison.Ordinal)
            ? controller.Name[..^suffix.Length]
            : controller.Name;
    }
    private static string CombineTemplates(string? controllerTemplate, string? actionTemplate)
    {
        controllerTemplate ??= "";
        actionTemplate ??= "";
        if (actionTemplate.StartsWith("~/", StringComparison.Ordinal))
        {
            return "/" + actionTemplate[2..].TrimStart('/');
        }
        if (actionTemplate.StartsWith("/", StringComparison.Ordinal))
        {
            return "/" + actionTemplate.TrimStart('/');
        }
        var left = controllerTemplate.Trim('/');
        var right = actionTemplate.Trim('/');
        if (string.IsNullOrEmpty(left) && string.IsNullOrEmpty(right))
        {
            return "/";
        }
        if (string.IsNullOrEmpty(left))
        {
            return "/" + right;
        }
        if (string.IsNullOrEmpty(right))
        {
            return "/" + left;
        }
        return "/" + left + "/" + right;
    }
    private static string ReplaceRouteTokens(string template, string controllerName, string actionName)
    {
        return template
            .Replace("[controller]", controllerName, StringComparison.OrdinalIgnoreCase)
            .Replace("[action]", actionName, StringComparison.OrdinalIgnoreCase);
    }
    private static string ToSamplePath(string template)
    {
        var path = RouteParameterRegex().Replace(template, match =>
        {
            var name = match.Groups["name"].Value.ToLowerInvariant();
            var constraint = match.Groups["constraint"].Value.ToLowerInvariant();
            if (name.Contains("playerid") || name.Contains("accountid") || name == "id")
            {
                return EndpointContract.TestPlayerToken;
            }
            if (constraint.Contains("long") || constraint.Contains("int") || name.EndsWith("id"))
            {
                return "1";
            }
            if (constraint.Contains("bool"))
            {
                return "true";
            }
            if (constraint.Contains("guid"))
            {
                return "00000000-0000-0000-0000-000000000001";
            }
            if (name.Contains("roomname"))
            {
                return "DormRoom";
            }
            if (name.Contains("locale"))
            {
                return "en";
            }
            return "sample";
        });
        path = Regex.Replace(path, "/+", "/");
        return path.StartsWith('/') ? path : "/" + path;
    }
    [GeneratedRegex(@"\{[*]?(?<name>[^}:=\?]+)(?<constraint>:[^}=\?]+)?(?<optional>\?)?(?<default>=[^}]+)?\}")]
    private static partial Regex RouteParameterRegex();
 }
 public sealed record EndpointContract(
    string Method,
    string Template,
    string SamplePath,
    string Source,
    bool RequiresAuthorization,
    bool IsAdminEndpoint,
    string[] Consumes)
 {
    public const string TestPlayerToken = "__test_player_id__";
    public string PathFor(GameClientSession session)
    {
        return SamplePath.Replace(
            TestPlayerToken,
            session.PlayerId.ToString(),
            StringComparison.Ordinal);
    }
 }
@@ -1,438 +0,0 @@
 using System.Net;
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 namespace DorkNet.Server.Tests;
 public sealed class GameClientEndpointContractTests :
    IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public GameClientEndpointContractTests(DorkNetServerFactory factory)
    {
        _factory = factory;
    }
    [Fact]
    public async Task Game_client_contract_probe_reaches_every_controller_route()
    {
        var routes = EndpointContractDiscovery.Discover()
            .Where(r => !DestroysTheProbeSession(r))
            .ToList();
        Assert.NotEmpty(routes);
        using var client = _factory.CreateClient(new()
        {
            AllowAutoRedirect = false,
        });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(20);
        var session = await GameClientSessionFactory.CreateAsync(client, _factory.ApexDomain);
        var failures = new List<string>();
        foreach (var route in routes)
        {
            var result = await ProbeAsync(client, route, session, _factory.ApexDomain);
            if (!result.Passed)
            {
                failures.Add(
                    $"{route.Method,-6} {result.Host}{result.Path} {route.Source} expected {result.Expected}, got {result.Observed}"
                    + (string.IsNullOrWhiteSpace(result.ResponseExcerpt) ? "" : $" body={result.ResponseExcerpt}"));
            }
        }
        Assert.True(
            failures.Count == 0,
            $"Endpoint contract failures ({failures.Count}/{routes.Count}):{Environment.NewLine}"
            + string.Join(Environment.NewLine, failures));
    }
    /// <summary>Routes this probe must not call, because they destroy the very
    /// session it authenticates with.
    ///
    /// The probe walks every route in order using one test player. Account
    /// deletion is a genuine, correctly-guarded purge — but once it runs, that
    /// player row is gone, so every later probe fails on a foreign-key
    /// violation or a 401. Excluding these keeps the failure list meaningful
    /// instead of one real event cascading into dozens of phantom failures.
    ///
    /// This is deliberately narrow: only self-destruct routes belong here, not
    /// anything merely inconvenient.</summary>
    private static bool DestroysTheProbeSession(EndpointContract route)
    {
        if (!string.Equals(route.Method, "DELETE", StringComparison.OrdinalIgnoreCase))
            return false;
        // Case-insensitive to match the method comparison above: a route
        // declared "Account/v1/me" would otherwise slip through and delete
        // the probe player mid-run.
        var template = route.Template.Trim('/');
        return template.Equals("account/me", StringComparison.OrdinalIgnoreCase)
            || template.Equals("account/v1/me", StringComparison.OrdinalIgnoreCase)
            || template.Equals("account/v2/me", StringComparison.OrdinalIgnoreCase);
    }
    private static async Task<EndpointProbeResult> ProbeAsync(
        HttpClient client,
        EndpointContract route,
        GameClientSession session,
        string apexDomain)
    {
        var path = route.PathFor(session);
        path = AddClientQuery(path, route, session);
        var host = HostFor(path, apexDomain);
        using var request = new HttpRequestMessage(
            ToHttpMethod(route.Method),
            new Uri($"http://{host}{path}"));
        request.Headers.Accept.ParseAdd("application/json");
        request.Headers.UserAgent.ParseAdd("RecRoom/2023.03.21");
        request.Headers.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        if (NeedsRequestBody(request.Method))
        {
            request.Content = CreateContent(route, session);
        }
        try
        {
            using var response = await client.SendAsync(request);
            var responseText = await response.Content.ReadAsStringAsync();
            var statusCode = (int)response.StatusCode;
            var passed = ResponseMatchesContract(route, response.StatusCode);
            return new EndpointProbeResult(
                route.Method,
                host,
                path,
                ExpectedContract(route),
                statusCode,
                null,
                Excerpt(responseText),
                passed);
        }
        catch (Exception ex) when (ex is HttpRequestException or TaskCanceledException)
        {
            return new EndpointProbeResult(
                route.Method,
                host,
                path,
                ExpectedContract(route),
                null,
                ex.Message,
                null,
                false);
        }
    }
    private static bool ResponseMatchesContract(
        EndpointContract route,
        HttpStatusCode statusCode)
    {
        if ((int)statusCode >= 500)
        {
            return false;
        }
        if (statusCode is HttpStatusCode.MethodNotAllowed
            or HttpStatusCode.NotImplemented
            or HttpStatusCode.UpgradeRequired)
        {
            return false;
        }
        if (route.RequiresAuthorization
            && statusCode is HttpStatusCode.Unauthorized)
        {
            return false;
        }
        return true;
    }
    private static string ExpectedContract(EndpointContract route)
    {
        if (route.IsAdminEndpoint)
        {
            return "admin endpoint may reject non-admin test player, but must not 5xx/405/426";
        }
        if (route.RequiresAuthorization)
        {
            return "authenticated test player should reach the action without 401/5xx/405/426; 403 is valid for owner/admin-only resources";
        }
        return "game-client request should not 5xx/405/426";
    }
    private static HttpMethod ToHttpMethod(string method)
    {
        return string.Equals(method, "ANY", StringComparison.OrdinalIgnoreCase)
            ? HttpMethod.Get
            : new HttpMethod(method);
    }
    private static bool NeedsRequestBody(HttpMethod method)
    {
        return method == HttpMethod.Post
            || method == HttpMethod.Put
            || method.Method.Equals("PATCH", StringComparison.OrdinalIgnoreCase);
    }
    private static HttpContent CreateContent(
        EndpointContract route,
        GameClientSession session)
    {
        var consumes = route.Consumes.Select(c => c.ToLowerInvariant()).ToArray();
        if (consumes.Any(c => c.Contains("application/x-www-form-urlencoded")))
        {
            return new FormUrlEncodedContent(new Dictionary<string, string>
            {
                ["account_id"] = session.PlayerId.ToString(),
                ["AccountId"] = session.PlayerId.ToString(),
                ["clubId"] = "1",
                ["ClubId"] = "1",
                ["description"] = "Endpoint contract description",
                ["deviceId"] = session.DeviceId,
                ["grant_type"] = "password",
                ["image"] = "endpoint-contract.png",
                ["imageName"] = "endpoint-contract.png",
                ["fileName"] = "endpoint-contract.png",
                ["message"] = "Endpoint contract message",
                ["name"] = "EndpointContract",
                ["newPassword"] = "endpoint-contract-password",
                ["oldPassword"] = "",
                ["password"] = "endpoint-contract-password",
                ["ping"] = "42",
                ["platformId"] = session.PlatformId,
                ["playerId"] = session.PlayerId.ToString(),
                ["playerIds"] = session.PlayerId.ToString(),
                ["query"] = "DormRoom",
                ["region"] = "us",
                ["targetPlayerId"] = session.PlayerId.ToString(),
                ["text"] = "Endpoint contract message",
                ["username"] = "EndpointContract",
                ["device_id"] = session.DeviceId,
                ["platform"] = "0",
                ["platform_id"] = session.PlatformId,
                ["Ids"] = session.PlayerId.ToString(),
                ["PlayerIds"] = session.PlayerId.ToString(),
            });
        }
        if (consumes.Any(c => c.Contains("multipart/form-data")))
        {
            var content = new MultipartFormDataContent();
            content.Add(new StringContent("endpoint-contract"), "name");
            content.Add(new StringContent(session.PlayerId.ToString()), "playerId");
            content.Add(new StringContent("endpoint-contract.png"), "imageName");
            content.Add(new StringContent("endpoint-contract.png"), "fileName");
            content.Add(new ByteArrayContent([]), "file", "endpoint-contract.bin");
            return content;
        }
        if (consumes.Any(c => c.Contains("text/plain")))
        {
            return new StringContent("", Encoding.UTF8, "text/plain");
        }
        var json = JsonSerializer.Serialize(new
        {
            PlayerId = session.PlayerId,
            AccountId = session.PlayerId,
            ClubId = 1,
            Description = "Endpoint contract description",
            DeviceId = session.DeviceId,
            FileName = "endpoint-contract.png",
            Id = session.PlayerId,
            Image = "endpoint-contract.png",
            ImageName = "endpoint-contract.png",
            Message = "Endpoint contract message",
            Platform = 0,
            PlatformId = session.PlatformId,
            PlayerIds = new[] { session.PlayerId },
            Name = "EndpointContract",
            Password = "endpoint-contract-password",
            Query = "DormRoom",
            RoomName = "DormRoom",
            TargetPlayerId = session.PlayerId,
            Text = "Endpoint contract message",
        });
        return new StringContent(json, Encoding.UTF8, "application/json");
    }
    private static string AddClientQuery(
        string path,
        EndpointContract route,
        GameClientSession session)
    {
        var separator = path.Contains('?', StringComparison.Ordinal) ? "&" : "?";
        var lower = path.ToLowerInvariant();
        var query = new List<string>();
        if (lower.Contains("search", StringComparison.Ordinal)
            || lower.Contains("query", StringComparison.Ordinal))
        {
            query.Add("query=EndpointContract");
        }
        if (lower == "/members/bulk")
        {
            query.Add("clubId=1");
            query.Add($"playerIds={session.PlayerId}");
        }
        if (lower == "/player/photonregionpings")
        {
            query.Add("region=us");
            query.Add("ping=42");
        }
        if (route.Source.Contains("CachedLogins", StringComparison.Ordinal)
            || lower.Contains("platformlogin/cached", StringComparison.Ordinal)
            || lower.Contains("savedlogins", StringComparison.Ordinal))
        {
            query.Add("platform=0");
            query.Add($"platformId={Uri.EscapeDataString(session.PlatformId)}");
        }
        if (route.Source.Contains("Bulk", StringComparison.Ordinal)
            && !query.Any(q => q.StartsWith("Ids=", StringComparison.OrdinalIgnoreCase)))
        {
            query.Add($"Ids={session.PlayerId}");
        }
        if (query.Count == 0)
        {
            return path;
        }
        return path + separator + string.Join("&", query);
    }
    private static string HostFor(string path, string apexDomain)
    {
        var lower = path.ToLowerInvariant();
        if (lower.StartsWith("/connect/")
            || lower.StartsWith("/.well-known/")
            || lower.StartsWith("/eac/")
            || lower.StartsWith("/cachedlogin/")
            || lower.StartsWith("/photon/")
            || lower.StartsWith("/api/platformlogin/")
            || lower.StartsWith("/api/version")
            || lower.StartsWith("/api/auth/"))
        {
            return $"auth.{apexDomain}";
        }
        if (lower.StartsWith("/account/"))
        {
            return $"accounts.{apexDomain}";
        }
        if (lower.StartsWith("/roomserver/")
            || lower.StartsWith("/rooms")
            || lower.StartsWith("/playlists")
            || lower.StartsWith("/featuredrooms")
            || lower.StartsWith("/hot_rooms")
            || lower.StartsWith("/search_rooms")
            || lower.StartsWith("/api/rooms")
            || lower.StartsWith("/api/roomkeys")
            || lower.StartsWith("/api/gamesessions")
            || lower.StartsWith("/api/curatedroomplaylists"))
        {
            return $"rooms.{apexDomain}";
        }
        if (lower.StartsWith("/v1/find")
            || lower.StartsWith("/v1/join")
            || lower.StartsWith("/v1/leave")
            || lower.StartsWith("/v1/session")
            || lower.StartsWith("/roominstance/")
            || lower.StartsWith("/goto/")
            || lower.StartsWith("/player/"))
        {
            return $"match.{apexDomain}";
        }
        if (lower.StartsWith("/thread"))
        {
            return $"chat.{apexDomain}";
        }
        if (lower.StartsWith("/club")
            || lower.StartsWith("/announcements/")
            || lower.StartsWith("/subscription/")
            || lower.StartsWith("/members/")
            || lower.StartsWith("/api/clubreporting/"))
        {
            return $"clubs.{apexDomain}";
        }
        if (lower.StartsWith("/api/storefronts/")
            || lower.StartsWith("/api/purchase/")
            || lower.StartsWith("/api/subscription/"))
        {
            return $"commerce.{apexDomain}";
        }
        if (lower.StartsWith("/hub/") || lower.StartsWith("/api/notification/"))
        {
            return $"notify.{apexDomain}";
        }
        if (lower.StartsWith("/v1/regions"))
        {
            return $"geo.{apexDomain}";
        }
        if (lower.StartsWith("/v1/services") || lower.StartsWith("/v1/ping"))
        {
            return $"ns.{apexDomain}";
        }
        if (lower.StartsWith("/upload"))
        {
            return $"storage.{apexDomain}";
        }
        if (lower.StartsWith("/img/") || lower.StartsWith("/room/") || lower.StartsWith("/data/"))
        {
            return $"cdn.{apexDomain}";
        }
        if (lower.StartsWith("/api/admin/"))
        {
            return $"admin.{apexDomain}";
        }
        return $"api.{apexDomain}";
    }
    private static string? Excerpt(string? body)
    {
        if (string.IsNullOrWhiteSpace(body))
        {
            return null;
        }
        var compact = body.ReplaceLineEndings(" ").Trim();
        return compact.Length <= 240 ? compact : compact[..240] + "...";
    }
 }
 public sealed record EndpointProbeResult(
    string Method,
    string Host,
    string Path,
    string Expected,
    int? StatusCode,
    string? Error,
    string? ResponseExcerpt,
    bool Passed)
 {
    public string Observed => StatusCode is int code ? code.ToString() : Error ?? "no response";
 }
@@ -1,65 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 namespace DorkNet.Server.Tests;
 public sealed record GameClientSession(
    long PlayerId,
    string AccessToken,
    string DeviceId,
    string PlatformId);
 public static class GameClientSessionFactory
 {
    public static async Task<GameClientSession> CreateAsync(
        HttpClient client,
        string apexDomain)
    {
        var deviceId = $"endpoint-contract-device-{Guid.NewGuid():N}";
        var platformId = $"endpoint-contract-platform-{Guid.NewGuid():N}";
        var tokenRequest = new HttpRequestMessage(
            HttpMethod.Post,
            new Uri($"http://auth.{apexDomain}/connect/token"));
        tokenRequest.Headers.Accept.ParseAdd("application/json");
        tokenRequest.Headers.UserAgent.ParseAdd("RecRoom/2023.03.21");
        tokenRequest.Headers.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        tokenRequest.Content = new FormUrlEncodedContent(new Dictionary<string, string>
        {
            ["grant_type"] = "password",
            ["username"] = "EndpointContract",
            ["device_id"] = deviceId,
            ["platform"] = "0",
            ["platform_id"] = platformId,
        });
        using var tokenResponse = await client.SendAsync(tokenRequest);
        if (!tokenResponse.IsSuccessStatusCode)
        {
            var body = await tokenResponse.Content.ReadAsStringAsync();
            throw new InvalidOperationException(
                $"Test player token request failed with {(int)tokenResponse.StatusCode} {tokenResponse.StatusCode}: {body}");
        }
        using var tokenJson = await JsonDocument.ParseAsync(
            await tokenResponse.Content.ReadAsStreamAsync());
        var accessToken = tokenJson.RootElement.GetProperty("access_token").GetString()
            ?? throw new InvalidOperationException("Token response did not include access_token.");
        var userInfoRequest = new HttpRequestMessage(
            HttpMethod.Get,
            new Uri($"http://auth.{apexDomain}/connect/userinfo"));
        userInfoRequest.Headers.Accept.ParseAdd("application/json");
        userInfoRequest.Headers.UserAgent.ParseAdd("RecRoom/2023.03.21");
        userInfoRequest.Headers.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        userInfoRequest.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
        using var userInfoResponse = await client.SendAsync(userInfoRequest);
        userInfoResponse.EnsureSuccessStatusCode();
        using var userInfoJson = await JsonDocument.ParseAsync(
            await userInfoResponse.Content.ReadAsStreamAsync());
        var playerId = long.Parse(userInfoJson.RootElement.GetProperty("sub").GetString()!);
        return new GameClientSession(playerId, accessToken, deviceId, platformId);
    }
 }
@@ -1,65 +0,0 @@
 using System.Net;
 using DorkNet.Contracts;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Regression coverage for the 2023 "pull a player into a private instance"
 /// flow. The 2023 client renamed the matchmaking surface from <c>goto/*</c>
 /// to <c>matchmake/*</c> and added <c>matchmake/chatinvite/{account}/{instance}</c>
 /// for chat party invites; the server had neither the routes nor the gateway
 /// ownership entry, so those requests 404'd.
 /// </summary>
 public sealed class MatchmakePullInviteTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public MatchmakePullInviteTests(DorkNetServerFactory factory) => _factory = factory;
    private HttpClient ApiClient()
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        return client;
    }
    [Theory]
    [InlineData("/matchmake/instance/999")]
    [InlineData("/matchmake/invite/999")]
    [InlineData("/matchmake/chatinvite/2/16777216")] // {accountId}/{roomInstanceId}
    [InlineData("/matchmake/player/2")]
    [InlineData("/matchmake/event/999")]
    [InlineData("/matchmake/club/999")]
    [InlineData("/matchmake/code/5/ABCDEF")] // {roomId}/{code}
    public async Task Matchmake_pull_routes_exist(string path)
    {
        using var client = ApiClient();
        using var res = await client.PostAsync(path, new StringContent(string.Empty));
        // The bug was a hard 404 (no route). These resolve to a dorm-fallback
        // matchmaking response when the instance/invite doesn't exist, so any
        // non-404 status proves the route is now mounted.
        Assert.NotEqual(HttpStatusCode.NotFound, res.StatusCode);
    }
    [Theory]
    [InlineData("/matchmake/instance/999")]
    [InlineData("/matchmake/invite/999")]
    [InlineData("/matchmake/chatinvite/2/16777216")]
    [InlineData("/matchmake/room/5")]
    [InlineData("/matchmake/player/2")]
    [InlineData("/matchmake/event/999")]
    [InlineData("/matchmake/club/999")]
    [InlineData("/matchmake/code/5/ABCDEF")]
    public void Matchmake_paths_route_to_same_service_as_goto(string path)
    {
        const string apex = "dork.test";
        var gotoOwner = DorkNetRouteOwnership.ResolvePublicService($"api.{apex}", "/goto/instance/999", apex);
        var owner = DorkNetRouteOwnership.ResolvePublicService($"api.{apex}", path, apex);
        // matchmake/* must land on the same service that owns goto/* — before
        // the fix it fell through to the Monolith default owner.
        Assert.Equal(gotoOwner, owner);
    }
 }
@@ -1,238 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// api/avatar/v4/items — the owned/unlocked wardrobe. The 2023 client's
 /// owned-item DTO (RecNet IFNGBPJGINL) requires <c>AvatarItemId</c> (Int32),
 /// <c>TagList</c> (string) and <c>IsBaseAvatarItem</c> (bool). Omitting them
 /// left every item at AvatarItemId 0; the client keys the wardrobe by that
 /// id, so the second item collided, the unlocked-items list failed to build
 /// (empty wardrobe = "no owned items"), and any refetch — including the one
 /// after a purchase — NRE'd in OutfitManager.UnlockAvatarItemAndMarkNew
 /// ("can't buy items"). Each item must carry a unique, non-zero id.
 /// </summary>
 public sealed class OwnedAvatarItemsTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public OwnedAvatarItemsTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Owned_items_carry_unique_nonzero_ids_and_2023_keys()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        using var client = ApiClient(player);
        var items = await GetJsonAsync(client, "/api/avatar/v4/items");
        Assert.True(items.GetArrayLength() > 0, "starter wardrobe was empty");
        var ids = new List<int>();
        foreach (var it in items.EnumerateArray())
        {
            // Every 2023 key present and correctly typed.
            Assert.Equal(JsonValueKind.Number, it.GetProperty("AvatarItemId").ValueKind);
            Assert.Equal(JsonValueKind.String, it.GetProperty("TagList").ValueKind);
            var isBase = it.GetProperty("IsBaseAvatarItem").ValueKind;
            Assert.True(isBase is JsonValueKind.True or JsonValueKind.False);
            Assert.Equal(JsonValueKind.String, it.GetProperty("AvatarItemDesc").ValueKind);
            var id = it.GetProperty("AvatarItemId").GetInt32();
            Assert.NotEqual(0, id);
            ids.Add(id);
        }
        // No duplicate ids — a collision is what crashed the wardrobe.
        Assert.Equal(ids.Count, ids.Distinct().Count());
    }
    [Fact]
    public async Task Purchased_item_appears_owned_with_valid_shape()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        using var client = ApiClient(player);
        var before = (await GetJsonAsync(client, "/api/avatar/v4/items")).GetArrayLength();
        // Buy the first avatar-backed watch-storefront item.
        var storefront = await GetJsonAsync(client, "/api/storefronts/v3/giftdropstore/3");
        var purchasableId = storefront.GetProperty("StoreItems").EnumerateArray()
            .First(r => !string.IsNullOrEmpty(r.GetProperty("GiftDrop").GetProperty("AvatarItemDesc").GetString()))
            .GetProperty("PurchasableItemId").GetInt32();
        using var buy = await client.PostAsync("/api/storefronts/v2/buyItem",
            new StringContent(JsonSerializer.Serialize(new
            {
                StorefrontType = 3,
                PurchasableItemId = purchasableId,
                CurrencyType = 2,
                RequestedPrice = 1,
                Gift = (object?)null,
            }), Encoding.UTF8, "application/json"));
        buy.EnsureSuccessStatusCode();
        var after = await GetJsonAsync(client, "/api/avatar/v4/items");
        Assert.True(after.GetArrayLength() >= before, "owned count shrank after purchase");
        // Still no duplicate ids after the new item joins the list.
        var ids = after.EnumerateArray().Select(x => x.GetProperty("AvatarItemId").GetInt32()).ToList();
        Assert.DoesNotContain(0, ids);
        Assert.Equal(ids.Count, ids.Distinct().Count());
    }
    [Fact]
    public async Task Buy_gift_desc_matches_v4items_and_consume_grants_once()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        using var client = ApiClient(player);
        // Buy an avatar-backed item — the server queues a post-purchase gift box.
        var storefront = await GetJsonAsync(client, "/api/storefronts/v3/giftdropstore/3");
        var purchasableId = storefront.GetProperty("StoreItems").EnumerateArray()
            .First(r => !string.IsNullOrEmpty(r.GetProperty("GiftDrop").GetProperty("AvatarItemDesc").GetString()))
            .GetProperty("PurchasableItemId").GetInt32();
        using var buy = await client.PostAsync("/api/storefronts/v2/buyItem",
            new StringContent(JsonSerializer.Serialize(new
            {
                StorefrontType = 3, PurchasableItemId = purchasableId,
                CurrencyType = 2, RequestedPrice = 1, Gift = (object?)null,
            }), Encoding.UTF8, "application/json"));
        buy.EnsureSuccessStatusCode();
        var gifts = await GetJsonAsync(client, "/api/avatar/v2/gifts");
        Assert.True(gifts.GetArrayLength() > 0, "buy did not queue a gift box");
        var gift = gifts[0];
        var giftDesc = gift.GetProperty("AvatarItemDesc").GetString()!;
        // The gift's desc MUST be the same 4-part "{guid},,," form v4/items
        // emits — the client matches on it verbatim in
        // OutfitManager.UnlockAvatarItemAndMarkNew after the box is consumed;
        // a bare guid missed and NRE'd ("items removed on every buy").
        Assert.True(giftDesc.Count(c => c == ',') >= 3, $"gift desc not 4-part: {giftDesc}");
        var items = await GetJsonAsync(client, "/api/avatar/v4/items");
        var descs = items.EnumerateArray().Select(x => x.GetProperty("AvatarItemDesc").GetString()).ToHashSet();
        Assert.Contains(giftDesc, descs);
        // Consuming the box must not add a SECOND wardrobe row for the item
        // the direct purchase already granted as a bare guid.
        using var consume = await client.PostAsync(
            $"/api/avatar/v2/gifts/consume/{gift.GetProperty("Id").GetInt64()}",
            new StringContent("{}", Encoding.UTF8, "application/json"));
        consume.EnsureSuccessStatusCode();
        var after = await GetJsonAsync(client, "/api/avatar/v4/items");
        var baseGuid = giftDesc.Split(',')[0];
        var occurrences = after.EnumerateArray()
            .Count(x => x.GetProperty("AvatarItemDesc").GetString()!.Split(',')[0] == baseGuid);
        Assert.Equal(1, occurrences);
    }
    [Fact]
    public async Task Legacy_bare_desc_gift_is_served_as_4part_matching_v4items()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        // Simulate a gift persisted BEFORE the fix: a bare-guid outfit desc
        // (no ",,," suffix) — the class of row that made the post-consume
        // UnlockAvatarItemAndMarkNew Find() miss and NRE.
        string bareGuid;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<Data.DorkNetDbContext>();
            var item = await db.StoreItems.FirstAsync(i => i.IsActive && i.Slug.StartsWith("wardrobe-"));
            bareGuid = item.Slug["wardrobe-".Length..];
            db.GiftPackages.Add(new Data.Entities.GiftPackageEntity
            {
                RecipientPlayerId = player.PlayerId,
                AvatarItemType = 0,               // outfit
                AvatarItemDescOrHairDyeDesc = bareGuid,   // BARE — the legacy bug
                IsValid = true,
            });
            await db.SaveChangesAsync();
        }
        using var client = ApiClient(player);
        var gifts = await GetJsonAsync(client, "/api/avatar/v2/gifts");
        var gift = gifts.EnumerateArray()
            .First(g => g.GetProperty("AvatarItemDesc").GetString()!.StartsWith(bareGuid));
        // Both desc keys are served as the 4-part form regardless of how the
        // row was stored, so the client's exact-match unlock succeeds. (A
        // real buy also grants the item, so v4/items contains it — covered by
        // Purchased_item_appears_owned / Buy_gift_desc_matches_v4items.)
        var giftDesc = gift.GetProperty("AvatarItemDesc").GetString()!;
        Assert.True(giftDesc.Count(c => c == ',') >= 3, $"legacy gift not normalized: {giftDesc}");
        Assert.Equal(giftDesc, gift.GetProperty("AvatarItemDescOrHairDyeDesc").GetString());
    }
    [Fact]
    public async Task Toggle_on_wardrobe_includes_color_variants_with_unique_ids()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var settings = scope.ServiceProvider
                .GetRequiredService<DorkNet.Server.Services.ServerSettingsService>();
            await settings.SetAllAvatarItemsOwnedEnabledAsync(true);
        }
        try
        {
            using var client = ApiClient(player);
            var items = await GetJsonAsync(client, "/api/avatar/v4/items");
            // Variant descs ("{guid},{combo},{mask},") — the colorways — are
            // present, not just base "{guid},,," rows; and every id is unique
            // (base + variants share a base guid, so a base-guid hash would
            // collide → wardrobe dict crash).
            var descs = items.EnumerateArray().Select(x => x.GetProperty("AvatarItemDesc").GetString()!).ToList();
            var hasVariant = descs.Any(d =>
            {
                var p = d.Split(',');
                return p.Length >= 2 && p[1].Length > 0;
            });
            Assert.True(hasVariant, "toggle-on wardrobe has no colored variants");
            var ids = items.EnumerateArray().Select(x => x.GetProperty("AvatarItemId").GetInt32()).ToList();
            Assert.DoesNotContain(0, ids);
            Assert.Equal(ids.Count, ids.Distinct().Count());
        }
        finally
        {
            await using var scope = _factory.Services.CreateAsyncScope();
            await scope.ServiceProvider
                .GetRequiredService<DorkNet.Server.Services.ServerSettingsService>()
                .SetAllAvatarItemsOwnedEnabledAsync(false);
        }
    }
    private HttpClient ApiClient(GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
    private static async Task<JsonElement> GetJsonAsync(HttpClient client, string path)
    {
        using var response = await client.GetAsync(path);
        response.EnsureSuccessStatusCode();
        using var document = await JsonDocument.ParseAsync(await response.Content.ReadAsStreamAsync());
        return document.RootElement.Clone();
    }
 }
@@ -1,101 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// While a join is pending, the heartbeat must tell the joining player which
 /// instance they are joining — never null.
 ///
 /// Deferring the presence commit is about what everyone ELSE sees: presence
 /// stays uncommitted until the join is confirmed so a failed join leaves no
 /// ghost behind. It must not change what the joining player is told about
 /// themselves, because the client XORs (cachedRoomInstance != null) against
 /// (serverRoomInstance != null): holding the target while the server says null
 /// reads as the room vanishing mid-join. The client then logs "presence
 /// heartbeat response indicates local presence is out-of-sync", "Attempting to
 /// go to Invalid RoomInstance", and cancels the very join the server was
 /// waiting on — so it retries until a heartbeat happens to miss the window, and
 /// entering a dorm takes several attempts while looking like a load failure.
 /// </summary>
 public sealed class PendingJoinPresenceTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public PendingJoinPresenceTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Heartbeat_during_a_pending_dorm_join_reports_the_instance_being_joined()
    {
        using var client = Client("match");
        var session = await GameClientSessionFactory.CreateAsync(client, _factory.ApexDomain);
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", session.AccessToken);
        // matchmake/dorm is what arms the deferred-commit pending join.
        using var dormForm = new FormUrlEncodedContent(
            [new KeyValuePair<string, string>("MaxPersistenceVersion", "45")]);
        using var dorm = await client.PostAsync("/matchmake/dorm", dormForm);
        var dormBody = await dorm.Content.ReadAsStringAsync();
        Assert.True(dorm.IsSuccessStatusCode,
            $"POST /matchmake/dorm -> {(int)dorm.StatusCode}: {dormBody}");
        var expectedInstance = JsonDocument.Parse(dormBody).RootElement;
        var instanceId = FindInstanceId(expectedInstance);
        Assert.True(instanceId is not null, $"no roomInstanceId in the dorm reply: {dormBody}");
        // The join has NOT been reported yet, so the commit is still deferred —
        // this is exactly the window the client heartbeats in.
        using var beatForm = new FormUrlEncodedContent(
            [new KeyValuePair<string, string>("LoginLock", Guid.NewGuid().ToString())]);
        using var beat = await client.PostAsync("/player/heartbeat", beatForm);
        var beatBody = await beat.Content.ReadAsStringAsync();
        Assert.True(beat.IsSuccessStatusCode,
            $"POST /player/heartbeat -> {(int)beat.StatusCode}: {beatBody}");
        var presence = JsonDocument.Parse(beatBody).RootElement;
        Assert.True(presence.TryGetProperty("roomInstance", out var reported)
                    || presence.TryGetProperty("RoomInstance", out reported),
            $"no roomInstance key in the heartbeat: {beatBody}");
        Assert.True(reported.ValueKind != JsonValueKind.Null,
            $"""
             The heartbeat returned a null roomInstance while the player's join was
             still pending. The client reads that as the room vanishing mid-join and
             cancels the load it is waiting on:
             {beatBody}
             """);
        Assert.Equal(instanceId, FindInstanceId(reported));
    }
    /// <summary>Pull roomInstanceId out of either the matchmake reply (which
    /// wraps it) or the heartbeat's roomInstance object, whatever the casing.</summary>
    private static string? FindInstanceId(JsonElement element)
    {
        if (element.ValueKind != JsonValueKind.Object) return null;
        foreach (var property in element.EnumerateObject())
        {
            if (property.Name.Equals("roomInstanceId", StringComparison.OrdinalIgnoreCase))
                return property.Value.ToString();
            if (property.Value.ValueKind == JsonValueKind.Object
                && FindInstanceId(property.Value) is { } nested)
                return nested;
        }
        return null;
    }
    private HttpClient Client(string host)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{host}.{_factory.ApexDomain}");
        return client;
    }
 }
@@ -1,145 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Private-room semantics:
 ///   1. A freshly cloned room is PRIVATE (Accessibility=0) regardless of
 ///      the source's visibility — the owner publishes explicitly.
 ///   2. A private room has exactly ONE instance per sub-room: every
 ///      JoinMode (plain matchmake / new public / new private) funnels
 ///      into the same deterministic invite-gated instance instead of
 ///      nonce-forking parallel copies.
 ///   3. Players who are neither the creator nor role-holders/invitees
 ///      are turned away with ErrorCode=4 (indistinguishable from a
 ///      nonexistent room, so private rooms don't leak).
 /// </summary>
 public sealed class PrivateRoomInstanceTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public PrivateRoomInstanceTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Clone_is_private_by_default()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var sourceId = 9_400_100L;
        await SeedRoomAsync(sourceId, creatorId: owner.PlayerId, accessibility: 1);
        using var roomsClient = ApiClient(owner, subdomain: "rooms");
        using var resp = await roomsClient.PostAsync(
            $"/rooms/{sourceId}/clone",
            new FormUrlEncodedContent(new Dictionary<string, string> { ["name"] = $"PrivClone_{Guid.NewGuid():N}"[..24] }));
        var text = await resp.Content.ReadAsStringAsync();
        Assert.True(resp.IsSuccessStatusCode, $"{(int)resp.StatusCode}: {text}");
        using var json = JsonDocument.Parse(text);
        var cloneId = json.RootElement.GetProperty("RoomId").GetInt64();
        await using var scope = _factory.Services.CreateAsyncScope();
        var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
        var clone = await db.Rooms.SingleAsync(r => r.Id == cloneId);
        Assert.Equal(0, clone.Accessibility); // private by default
    }
    [Fact]
    public async Task Private_room_gets_one_instance_per_subroom_for_all_join_modes()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var roomId = 9_400_200L;
        await SeedRoomAsync(roomId, creatorId: owner.PlayerId, accessibility: 0);
        using var matchClient = ApiClient(owner, subdomain: "match");
        var joins = new List<(long InstanceId, string Photon, bool IsPrivate)>();
        foreach (var joinMode in new[] { 0, 1, 2, 0 })
        {
            using var resp = await matchClient.PostAsync(
                $"/matchmake/room/{roomId}",
                new FormUrlEncodedContent(new Dictionary<string, string> { ["JoinMode"] = joinMode.ToString() }));
            var text = await resp.Content.ReadAsStringAsync();
            Assert.True(resp.IsSuccessStatusCode, $"JoinMode={joinMode} -> {(int)resp.StatusCode}: {text}");
            using var json = JsonDocument.Parse(text);
            Assert.Equal(0, json.RootElement.GetProperty("errorCode").GetInt32());
            var inst = json.RootElement.GetProperty("roomInstance");
            joins.Add((
                inst.GetProperty("roomInstanceId").GetInt64(),
                inst.GetProperty("photonRoomId").GetString()!,
                inst.GetProperty("isPrivate").GetBoolean()));
        }
        // Every join mode must land in the SAME single instance.
        Assert.Single(joins.Select(j => j.InstanceId).Distinct());
        Assert.Single(joins.Select(j => j.Photon).Distinct());
        Assert.All(joins, j => Assert.True(j.IsPrivate, "private room instances must be invite-gated"));
    }
    [Fact]
    public async Task Private_room_turns_away_uninvited_players()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var stranger = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var roomId = 9_400_300L;
        await SeedRoomAsync(roomId, creatorId: owner.PlayerId, accessibility: 0);
        using var strangerClient = ApiClient(stranger, subdomain: "match");
        using var resp = await strangerClient.PostAsync(
            $"/matchmake/room/{roomId}",
            new FormUrlEncodedContent(new Dictionary<string, string> { ["JoinMode"] = "0" }));
        var text = await resp.Content.ReadAsStringAsync();
        Assert.True(resp.IsSuccessStatusCode, $"{(int)resp.StatusCode}: {text}");
        using var json = JsonDocument.Parse(text);
        // 4 = RoomDoesNotExist — private rooms are invisible, not "forbidden".
        Assert.Equal(4, json.RootElement.GetProperty("errorCode").GetInt32());
    }
    private async Task SeedRoomAsync(long roomId, long creatorId, int accessibility)
    {
        await using var scope = _factory.Services.CreateAsyncScope();
        var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
        if (await db.Rooms.AnyAsync(r => r.Id == roomId)) return;
        db.Rooms.Add(new RoomEntity
        {
            Id = roomId,
            Name = $"PrivRoom_{roomId}",
            Description = "private-room test",
            CreatorPlayerId = creatorId,
            ImageName = RoomService.DefaultRoomImageName,
            Accessibility = accessibility,
            CloningAllowed = true,
            LocationReplicationId = "76d98498-60a1-430c-ab76-b54a29b7a163",
        });
        db.RoomScenes.Add(new RoomSceneEntity
        {
            RoomId = roomId,
            OrderIndex = 0,
            Name = "Home",
        });
        await db.SaveChangesAsync();
    }
    private HttpClient ApiClient(GameClientSession? session = null, string subdomain = "api")
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{subdomain}.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
 }
@@ -1,127 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// The end-of-quest reward chest is the gifts/generate + gifts/consume
 /// flow. This covers the load-bearing new behaviour: a gift stamped with
 /// a <c>SourceStoreItemId</c> (how quest chests are built) grants exactly
 /// that store item to the player's inventory when the box is opened,
 /// regardless of item kind. (The room-keyed pick itself is data-driven
 /// via data/quest_rewards.json and exercised once real per-quest lists
 /// are configured.)
 /// </summary>
 public sealed class QuestRewardChestTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public QuestRewardChestTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Consuming_quest_chest_grants_backing_item()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        long giftId;
        string wardrobeGuid;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var item = await db.StoreItems.FirstAsync(i => i.IsActive && i.Slug.StartsWith("wardrobe-"));
            wardrobeGuid = item.Slug["wardrobe-".Length..];
            var gift = new GiftPackageEntity
            {
                RecipientPlayerId = player.PlayerId,
                AvatarItemType = 0,
                AvatarItemDescOrHairDyeDesc = wardrobeGuid + ",,,",
                Message = "You earned it!",
                SourceStoreItemId = item.Id,
                IsValid = true,
            };
            db.GiftPackages.Add(gift);
            await db.SaveChangesAsync();
            giftId = gift.Id;
        }
        using var client = ApiClient(player);
        using var consume = await client.PostAsync($"/api/avatar/v2/gifts/consume/{giftId}",
            new StringContent("{}", Encoding.UTF8, "application/json"));
        consume.EnsureSuccessStatusCode();
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var avatar = await db.Avatars.FirstOrDefaultAsync(a => a.PlayerId == player.PlayerId);
            Assert.NotNull(avatar);
            var inv = JsonSerializer.Deserialize<List<string>>(avatar!.InventoryJson) ?? new();
            Assert.Contains(wardrobeGuid, inv);
            var gift = await db.GiftPackages.FirstAsync(g => g.Id == giftId);
            Assert.True(gift.Consumed);
        }
    }
    [Fact]
    public async Task Consuming_is_idempotent_and_does_not_double_grant()
    {
        using var setup = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        long giftId;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var item = await db.StoreItems.FirstAsync(i => i.IsActive && i.Slug.StartsWith("wardrobe-"));
            var gift = new GiftPackageEntity
            {
                RecipientPlayerId = player.PlayerId,
                AvatarItemType = 0,
                AvatarItemDescOrHairDyeDesc = item.Slug["wardrobe-".Length..] + ",,,",
                SourceStoreItemId = item.Id,
                IsValid = true,
            };
            db.GiftPackages.Add(gift);
            await db.SaveChangesAsync();
            giftId = gift.Id;
        }
        using var client = ApiClient(player);
        for (var i = 0; i < 2; i++)
        {
            using var r = await client.PostAsync($"/api/avatar/v2/gifts/consume/{giftId}",
                new StringContent("{}", Encoding.UTF8, "application/json"));
            r.EnsureSuccessStatusCode();
        }
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var avatar = await db.Avatars.FirstAsync(a => a.PlayerId == player.PlayerId);
            var inv = JsonSerializer.Deserialize<List<string>>(avatar.InventoryJson) ?? new();
            // The wardrobe guid appears exactly once despite two consumes.
            Assert.Equal(inv.Distinct().Count(), inv.Count);
        }
    }
    private HttpClient ApiClient(GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
 }
@@ -1,95 +0,0 @@
 using DorkNet.Server.Services;
 using Google.Protobuf;
 using RecRoom.Protobuf;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// A modern RecNet export's subroom save stamps PersistedRoomData
 /// versions past what the March-2023 client knows (field 1
 /// DEPRECATED_RoomPersistenceVersion, max 38; field 30
 /// PersistedRoomVersion, max 19 = V19February23BetaRelease). The client
 /// rejects the whole room with its "update Rec Room to visit this room"
 /// gate — the ShibuyaCrossing import (Sep-2025 save, version=131) is the
 /// canonical repro. The CDN serve path clamps both varints down; these
 /// tests pin the rewrite to exactly those two fields.
 /// </summary>
 public sealed class RoomBlobVersionClampTests
 {
    private static byte[] BuildModernBlob(int deprecatedVersion, int version)
    {
        // Emit the wire shape a modern save actually has: version fields
        // plus payload fields the 2023 schema does and doesn't know about.
        using var ms = new MemoryStream();
        var output = new CodedOutputStream(ms);
        output.WriteTag(1, WireFormat.WireType.Varint);
        output.WriteInt32(deprecatedVersion);
        // Field 2: persistence_views payload (opaque here — the clamp
        // must copy it verbatim).
        output.WriteTag(2, WireFormat.WireType.LengthDelimited);
        output.WriteBytes(ByteString.CopyFrom(0x0A, 0x03, 0x01, 0x02, 0x03));
        // Field 6: sub_room_id.
        output.WriteTag(6, WireFormat.WireType.Varint);
        output.WriteInt64(19589779);
        output.WriteTag(30, WireFormat.WireType.Varint);
        output.WriteInt32(version);
        // Field 37: unknown-to-2023 varint field from newer schemas.
        output.WriteTag(37, WireFormat.WireType.Varint);
        output.WriteInt32(1);
        output.Flush();
        return ms.ToArray();
    }
    [Fact]
    public void Clamps_modern_versions_to_2023_maxima()
    {
        var input = BuildModernBlob(deprecatedVersion: 38, version: 131);
        var (bytes, changed) = RoomDataBlobService.ClampVersionsFor2023(input);
        Assert.True(changed);
        var msg = PersistedRoomData.Parser.ParseFrom(bytes);
        Assert.Equal(RoomDataBlobService.Client2023MaxPersistedRoomVersion, (int)msg.Version);
        Assert.Equal(DEPRECATED_RoomPersistenceVersion.LatestRoomPersistenceVersion, msg.DEPRECATEDVersion);
    }
    [Fact]
    public void Preserves_every_non_version_byte()
    {
        var input = BuildModernBlob(deprecatedVersion: 38, version: 131);
        var (bytes, _) = RoomDataBlobService.ClampVersionsFor2023(input);
        // version=131 is a two-byte varint, 16 is one byte — the output
        // shrinks by exactly that and matches the input everywhere else.
        Assert.Equal(input.Length - 1, bytes.Length);
        var expected = BuildModernBlob(
            deprecatedVersion: 38,
            version: RoomDataBlobService.Client2023MaxPersistedRoomVersion);
        Assert.Equal(expected, bytes);
    }
    [Fact]
    public void Blob_already_at_2023_versions_passes_through_unchanged()
    {
        var input = BuildModernBlob(
            deprecatedVersion: 38,
            version: RoomDataBlobService.Client2023MaxPersistedRoomVersion);
        var (bytes, changed) = RoomDataBlobService.ClampVersionsFor2023(input);
        Assert.False(changed);
        Assert.Same(input, bytes);
    }
    [Fact]
    public void Malformed_input_is_returned_verbatim()
    {
        var input = new byte[] { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x01 };
        var (bytes, changed) = RoomDataBlobService.ClampVersionsFor2023(input);
        Assert.False(changed);
        Assert.Same(input, bytes);
    }
 }
@@ -1,91 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// 2023 play-menu browse sources. The client's room-discovery URL
 /// builder (IBEOONPEELF/GGDPFFDEDKN) requests
 /// <c>rooms/search_rooms/{query}&amp;skip={skip}&amp;take={take}</c> —
 /// note the paging pairs live INSIDE the final path segment, and the
 /// whole family is prefixed with <c>rooms/</c> on the rooms host.
 /// The room photo gallery sends <c>sort</c>/<c>filter</c> as enum
 /// names (<c>CheerCount_Desc</c>, <c>PublicOnly</c>), which must not
 /// trip int model binding.
 /// </summary>
 public sealed class RoomBrowse2023Tests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public RoomBrowse2023Tests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Search_rooms_2023_path_with_embedded_paging_returns_matches()
    {
        using var setupClient = Client();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var marker = $"Zz{Guid.NewGuid():N}"[..14];
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            db.Rooms.Add(new RoomEntity
            {
                Id = 9_300_000 + Random.Shared.Next(1, 99_999),
                Name = $"Search{marker}",
                Description = "2023 search test room",
                CreatorPlayerId = owner.PlayerId,
                ImageName = RoomService.DefaultRoomImageName,
                Accessibility = 1,
                IsAGRoom = true,
                IsDormRoom = false,
            });
            await db.SaveChangesAsync();
        }
        using var roomsClient = Client(owner, subdomain: "rooms");
        using var response = await roomsClient.GetAsync($"/rooms/search_rooms/{marker}&skip=0&take=20");
        var text = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"{(int)response.StatusCode}: {text}");
        using var json = JsonDocument.Parse(text);
        var names = json.RootElement.EnumerateArray()
            .Select(e => e.GetProperty("Name").GetString() ?? string.Empty)
            .ToArray();
        Assert.Contains(names, n => n.Contains(marker));
    }
    [Fact]
    public async Task Room_images_accept_2023_enum_name_sort_and_filter()
    {
        using var setupClient = Client();
        var player = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        using var apiClient = Client(player);
        using var response = await apiClient.GetAsync(
            "/api/images/v4/room/116?sort=CheerCount_Desc&filter=PublicOnly&take=8&skip=0");
        var text = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"{(int)response.StatusCode}: {text}");
        using var json = JsonDocument.Parse(text);
        Assert.Equal(JsonValueKind.Array, json.RootElement.ValueKind);
    }
    private HttpClient Client(GameClientSession? session = null, string subdomain = "api")
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{subdomain}.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
 }
@@ -1,223 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection.Extensions;
 using DorkNet.Server.Services;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// The 2023 "copy room" flow POSTs <c>rooms/{id}/clone</c> and deserialises the
 /// reply into <c>FGCPNAACHIK</c> — the SAME type <c>GET rooms/{id}</c> returns
 /// (RecNet.Runtime/NLDBPDCNNCF.txt:4676 declares
 /// <c>Task&lt;FGCPNAACHIK&gt; GDHIIAHCBMN(Int64, String, CancellationToken)</c>,
 /// with the route literal on :4802).
 ///
 /// So the two responses must be shape-identical. When they drift, the server
 /// still answers 200 and the client throws while reading it — and because the
 /// clone promise's exception is never observed, it surfaces from the finalizer
 /// thread seconds later as a bare "Failed to copy room: Exception of type
 /// '...' was thrown", with nothing in the server log to show for it. That is
 /// exactly how this failed in the wild: the room WAS created, and the client
 /// simply never registered it.
 /// </summary>
 public sealed class RoomCloneShapeTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public RoomCloneShapeTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Clone_response_matches_the_get_by_id_shape()
    {
        using var client = Client();
        var session = await GameClientSessionFactory.CreateAsync(client, _factory.ApexDomain);
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", session.AccessToken);
        var sourceId = 9_400_000 + Random.Shared.Next(1, 99_999);
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            db.Rooms.Add(new RoomEntity
            {
                Id = sourceId,
                Name = $"CloneSrc{Guid.NewGuid():N}"[..20],
                CreatorPlayerId = session.PlayerId,
                CloningAllowed = true,
            });
            // Give the source a real sub-room. Without one, BOTH responses fall
            // back to the synthesised default sub-room and the comparison never
            // exercises the branch a real room (like the seeded RecCenter the
            // room-creation picker clones) actually takes.
            db.RoomScenes.Add(new RoomSceneEntity
            {
                RoomId = sourceId,
                Name = "Home",
                OrderIndex = 0,
            });
            await db.SaveChangesAsync();
        }
        var getBody = await ReadJsonAsync(client, HttpMethod.Get, $"/rooms/{sourceId}");
        var cloneBody = await ReadJsonAsync(client, HttpMethod.Post, $"/rooms/{sourceId}/clone",
            new FormUrlEncodedContent([new KeyValuePair<string, string>("name", $"Copy{Guid.NewGuid():N}"[..20])]));
        var expected = getBody.EnumerateObject().Select(p => p.Name).ToHashSet(StringComparer.Ordinal);
        var actual = cloneBody.EnumerateObject().Select(p => p.Name).ToHashSet(StringComparer.Ordinal);
        var missing = expected.Except(actual).Order(StringComparer.Ordinal).ToList();
        // The reader walks the nested sub-room list too, so a key missing there
        // breaks it just as hard as one missing at the top level.
        foreach (var list in new[] { "SubRooms", "Scenes" })
        {
            if (!getBody.TryGetProperty(list, out var expectedList) ||
                expectedList.ValueKind != JsonValueKind.Array ||
                expectedList.GetArrayLength() == 0) continue;
            Assert.True(cloneBody.TryGetProperty(list, out var actualList)
                        && actualList.ValueKind == JsonValueKind.Array,
                $"clone response has no {list} array while get-by-id does");
            Assert.True(actualList.GetArrayLength() > 0,
                $"clone response has an EMPTY {list} array while get-by-id returns "
                + $"{expectedList.GetArrayLength()}; the client's reader requires at least one entry");
            var expectedKeys = expectedList[0].EnumerateObject().Select(p => p.Name);
            var actualKeys = actualList[0].EnumerateObject().Select(p => p.Name).ToHashSet(StringComparer.Ordinal);
            missing.AddRange(expectedKeys.Where(k => !actualKeys.Contains(k)).Select(k => $"{list}[0].{k}"));
        }
        Assert.True(missing.Count == 0,
            $"""
             The clone response is missing {missing.Count} key(s) that get-by-id
             returns. Both deserialize into FGCPNAACHIK, so the client throws while
             reading the clone and silently never registers the new room:
             {string.Join(Environment.NewLine, missing)}
             clone keys: {string.Join(", ", actual.Order(StringComparer.Ordinal))}
             """);
    }
    /// <summary>A clone must own its save data. Cloning used to be a shallow
    /// copy — the new room's scenes kept pointing at the SOURCE's blob until
    /// someone saved over them — so every copy of a room shared one object and
    /// cloning RecCenter produced rooms whose data blob was literally
    /// <c>room_100_v1.dat</c>. A clone that references another room's blob is
    /// the bug, whatever the name.</summary>
    [Fact]
    public async Task Clone_does_not_reference_the_source_rooms_blob()
    {
        // The suite runs with S3 unconfigured, where there is nothing to copy
        // and the clone deliberately keeps the shallow reference. Swap in a
        // real (in-memory) store so this exercises the copy path itself.
        var store = new InMemoryObjectStorage();
        using var factory = _factory.WithWebHostBuilder(builder =>
            builder.ConfigureServices(services =>
            {
                services.RemoveAll<IObjectStorage>();
                services.AddSingleton<IObjectStorage>(store);
            }));
        using var client = factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://rooms.{_factory.ApexDomain}");
        var session = await GameClientSessionFactory.CreateAsync(client, _factory.ApexDomain);
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", session.AccessToken);
        var sourceId = 9_500_000 + Random.Shared.Next(1, 99_999);
        var sourceBlob = $"room_{sourceId}_v1.dat";
        var sourceBytes = new byte[] { 1, 2, 3, 4, 5, 6, 7, 8 };
        var (srcBucket, srcKey) = BlobRouter.Route(sourceBlob);
        await store.PutAsync(srcBucket, srcKey, sourceBytes, "application/octet-stream");
        await using (var scope = factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            db.Rooms.Add(new RoomEntity
            {
                Id = sourceId,
                Name = $"BlobSrc{Guid.NewGuid():N}"[..20],
                CreatorPlayerId = session.PlayerId,
                CloningAllowed = true,
                CurrentDataBlobName = sourceBlob,
            });
            db.RoomScenes.Add(new RoomSceneEntity
            {
                RoomId = sourceId,
                Name = "Home",
                OrderIndex = 0,
                DataBlobName = sourceBlob,
            });
            await db.SaveChangesAsync();
        }
        var clone = await ReadJsonAsync(client, HttpMethod.Post, $"/rooms/{sourceId}/clone",
            new FormUrlEncodedContent([new KeyValuePair<string, string>("name", $"Copy{Guid.NewGuid():N}"[..20])]));
        var cloneId = clone.GetProperty("RoomId").GetInt64();
        await using (var scope = factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var room = await db.Rooms.FirstAsync(r => r.Id == cloneId);
            var scenes = await db.RoomScenes.Where(s => s.RoomId == cloneId).ToListAsync();
            Assert.False(room.CurrentDataBlobName == sourceBlob,
                $"the clone's room row still points at the source's blob ({sourceBlob})");
            foreach (var scene in scenes)
                Assert.False(scene.DataBlobName == sourceBlob,
                    $"cloned sub-room {scene.OrderIndex} still points at the source's blob ({sourceBlob})");
            // It must be a real copy, not just a cleared reference — the point
            // is that the player's content comes along.
            Assert.False(string.IsNullOrEmpty(room.CurrentDataBlobName),
                "the clone has no blob at all; the source's data should have been copied, not dropped");
            var (dstBucket, dstKey) = BlobRouter.Route(room.CurrentDataBlobName);
            Assert.Equal(sourceBytes, await store.GetAsync(dstBucket, dstKey));
        }
    }
    /// <summary>Minimal in-memory <see cref="IObjectStorage"/>. The suite runs
    /// with S3 unconfigured, so without this the clone's copy path short-circuits
    /// and never gets exercised.</summary>
    private sealed class InMemoryObjectStorage : IObjectStorage
    {
        private readonly Dictionary<string, byte[]> _objects = new(StringComparer.Ordinal);
        public bool IsS3Configured => true;
        public Task<long> PutAsync(
            string bucket, string key, byte[] bytes, string contentType, CancellationToken ct = default)
        {
            _objects[$"{bucket}/{key}"] = bytes;
            return Task.FromResult((long)bytes.Length);
        }
        public Task<byte[]?> GetAsync(string bucket, string key, CancellationToken ct = default) =>
            Task.FromResult(_objects.TryGetValue($"{bucket}/{key}", out var bytes) ? bytes : null);
        public Task<bool> ExistsAsync(string bucket, string key, CancellationToken ct = default) =>
            Task.FromResult(_objects.ContainsKey($"{bucket}/{key}"));
    }
    private static async Task<JsonElement> ReadJsonAsync(
        HttpClient client, HttpMethod method, string path, HttpContent? content = null)
    {
        using var request = new HttpRequestMessage(method, path) { Content = content };
        using var response = await client.SendAsync(request);
        var body = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode,
            $"{method} {path} -> {(int)response.StatusCode}: {body}");
        return JsonDocument.Parse(body).RootElement.Clone();
    }
    private HttpClient Client()
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://rooms.{_factory.ApexDomain}");
        return client;
    }
 }
@@ -1,235 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// End-to-end coverage of the 2023 client's in-room shop
 /// (api/roomconsumables/v1) using the exact request/response wire shapes
 /// the 2023.03.21 client serialises (verified against the RecNet.Runtime
 /// formatters in the ISIL dump). The critical regression guard: every
 /// inventory row returned by <c>/room/{id}/me</c> must carry a non-null
 /// <c>Consumable</c> desc — RoomConsumablesManager NREs on room join
 /// otherwise.
 /// </summary>
 public sealed class RoomConsumablesShopTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public RoomConsumablesShopTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Full_shop_loop_create_purchase_inventory_consume_delete()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var buyer = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var roomId = 9_200_001L;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"ShopRoom_{Guid.NewGuid():N}"[..24],
                Description = "shop test room",
                CreatorPlayerId = owner.PlayerId,
                ImageName = RoomService.DefaultRoomImageName,
                State = 0,
                Accessibility = 1,
                IsAGRoom = true,
                TagsCsv = "community",
            });
            await db.SaveChangesAsync();
            var level = scope.ServiceProvider.GetRequiredService<LevelService>();
            await level.GrantCurrencyAsync(buyer.PlayerId, 2, 100, "test-seed");
        }
        using var ownerClient = ApiClient(owner);
        using var buyerClient = ApiClient(buyer);
        // ── Create (client body = the desc DTO itself) ───────────────────
        var created = await PostJsonAsync(ownerClient, "/api/roomconsumables/v1/roomConsumable", $$"""
            {
                "RoomId": {{roomId}},
                "Name": "Cola",
                "Description": "A refreshing test beverage",
                "ImageName": "",
                "PriceAndCurrency": { "Price": 10, "CurrencyId": null }
            }
            """);
        Assert.Equal(0, created.GetProperty("Status").GetInt32());
        var consumableId = created.GetProperty("Consumable").GetProperty("RoomConsumableId").GetGuid();
        Assert.NotEqual(Guid.Empty, consumableId);
        Assert.Equal(roomId, created.GetProperty("Consumable").GetProperty("RoomId").GetInt64());
        // ── Non-owner cannot create in someone else's room ───────────────
        var forbidden = await PostJsonAsync(buyerClient, "/api/roomconsumables/v1/roomConsumable", $$"""
            { "RoomId": {{roomId}}, "Name": "Hax", "Description": "", "ImageName": "",
              "PriceAndCurrency": { "Price": 1, "CurrencyId": null } }
            """);
        Assert.Equal(7, forbidden.GetProperty("Status").GetInt32()); // PlayerDoesntHavePermission
        // ── Room catalog ─────────────────────────────────────────────────
        var catalog = await GetJsonAsync(buyerClient, $"/api/roomconsumables/v1/roomConsumable/room/{roomId}");
        Assert.Equal(1, catalog.GetArrayLength());
        // Responses carry the price FLAT. The client's consumable formatter
 // (RecNet.Runtime/FCIBLPCOODP) reads RoomConsumableId/RoomId/Name/
 // Description/ImageName/Price/PurchaseCurrencyId/ModifiedAt and has no
 // "PriceAndCurrency" key at all — only REQUEST bodies nest it.
        Assert.Equal(10, catalog[0].GetProperty("Price").GetInt64());
        // ── Purchase at the wrong price is rejected ──────────────────────
        var codeA = Guid.NewGuid();
        var badPrice = await PostJsonAsync(buyerClient,
            $"/api/roomconsumables/v1/roomconsumable/{consumableId}/purchase/tokens", $$"""
            {
                "ConcurrencyCodes": { "CurrentConcurrencyCode": null, "NewConcurrencyCode": "{{codeA}}" },
                "ExpectedPriceAndCurrency": { "Price": 5, "CurrencyId": null }
            }
            """);
        // OperationResult is an OBJECT { Status, InventoryItem } — the base type
        // OKHNOPLBOFP holds a single BGHBAILNNJJ, which itself exposes the status
        // enum plus the inventory row. The scalar token-operation enum lives in
        // BalanceUpdateResult (Nullable<CABBDKFODEC>) on MJKFEHPIDME.
        Assert.Equal(6, badPrice.GetProperty("BalanceUpdateResult").GetInt32()); // RequestedPriceDoesNotMatch
        Assert.Equal(38, badPrice.GetProperty("OperationResult").GetProperty("Status").GetInt32());
        var balanceBefore = badPrice.GetProperty("TokenBalanceResponse").GetProperty("Balance").GetInt64();
        // ── Purchase (client stores NewConcurrencyCode locally) ──────────
        var purchase = await PostJsonAsync(buyerClient,
            $"/api/roomconsumables/v1/roomconsumable/{consumableId}/purchase/tokens", $$"""
            {
                "ConcurrencyCodes": { "CurrentConcurrencyCode": null, "NewConcurrencyCode": "{{codeA}}" },
                "ExpectedPriceAndCurrency": { "Price": 10, "CurrencyId": null }
            }
            """);
        Assert.Equal(0, purchase.GetProperty("OperationResult").GetProperty("Status").GetInt32());
        var tokenBalance = purchase.GetProperty("TokenBalanceResponse");
        Assert.Equal(2, tokenBalance.GetProperty("CurrencyType").GetInt32());
        Assert.Equal(balanceBefore - 10, tokenBalance.GetProperty("Balance").GetInt64());
        // ── Inventory on room join: Consumable must NEVER be null ────────
        var inventory = await GetJsonAsync(buyerClient, $"/api/roomconsumables/v1/roomConsumable/room/{roomId}/me");
        Assert.Equal(1, inventory.GetArrayLength());
        var row = inventory[0];
        Assert.Equal(consumableId, row.GetProperty("RoomConsumableId").GetGuid());
        Assert.Equal((int)buyer.PlayerId, row.GetProperty("AccountId").GetInt32());
        Assert.Equal(1, row.GetProperty("Count").GetInt32());
        Assert.Equal(codeA, row.GetProperty("ConcurrencyCode").GetGuid());
        Assert.Equal(JsonValueKind.Object, row.GetProperty("Consumable").ValueKind);
        Assert.Equal(roomId, row.GetProperty("Consumable").GetProperty("RoomId").GetInt64());
        // ── isOwned: a non-creator holds stock ───────────────────────────
        using var isOwnedResponse = await ownerClient.GetAsync(
            $"/api/roomconsumables/v1/roomConsumable/{consumableId}/isOwned");
        Assert.Equal("true", await isOwnedResponse.Content.ReadAsStringAsync());
        // ── Consume with a stale concurrency code resyncs the client ─────
        var codeB = Guid.NewGuid();
        var staleConsume = await PostJsonAsync(buyerClient,
            $"/api/roomconsumables/v1/roomConsumable/{consumableId}/consume", $$"""
            { "CurrentConcurrencyCode": "{{Guid.NewGuid()}}", "NewConcurrencyCode": "{{codeB}}" }
            """);
        Assert.Equal(32, staleConsume.GetProperty("Status").GetInt32()); // ConcurrencyCodeMismatch
        Assert.Equal(1, staleConsume.GetProperty("InventoryItem").GetProperty("Count").GetInt32());
        // ── Consume with the right code decrements and rotates the code ──
        var consume = await PostJsonAsync(buyerClient,
            $"/api/roomconsumables/v1/roomConsumable/{consumableId}/consume", $$"""
            { "CurrentConcurrencyCode": "{{codeA}}", "NewConcurrencyCode": "{{codeB}}" }
            """);
        Assert.Equal(0, consume.GetProperty("Status").GetInt32());
        Assert.Equal(0, consume.GetProperty("InventoryItem").GetProperty("Count").GetInt32());
        Assert.Equal(codeB, consume.GetProperty("InventoryItem").GetProperty("ConcurrencyCode").GetGuid());
        // ── Consuming an empty stack is refused ──────────────────────────
        var emptyConsume = await PostJsonAsync(buyerClient,
            $"/api/roomconsumables/v1/roomConsumable/{consumableId}/consume", $$"""
            { "CurrentConcurrencyCode": "{{codeB}}", "NewConcurrencyCode": "{{Guid.NewGuid()}}" }
            """);
        Assert.Equal(33, emptyConsume.GetProperty("Status").GetInt32()); // PlayerDoesNotOwnConsumable
        // ── Update via POST with RoomConsumableId in the body ────────────
        var updated = await PostJsonAsync(ownerClient, "/api/roomconsumables/v1/roomConsumable", $$"""
            {
                "RoomConsumableId": "{{consumableId}}",
                "RoomId": {{roomId}},
                "Name": "Diet Cola",
                "Description": "Now with fewer tokens",
                "ImageName": "",
                "PriceAndCurrency": { "Price": 5, "CurrencyId": null }
            }
            """);
        Assert.Equal(0, updated.GetProperty("Status").GetInt32());
        Assert.Equal("Diet Cola", updated.GetProperty("Consumable").GetProperty("Name").GetString());
        Assert.Equal(5, updated.GetProperty("Consumable").GetProperty("Price").GetInt64());
        // ── Delete: buyer refused, owner succeeds, catalog empties ───────
        using var buyerDelete = await buyerClient.DeleteAsync(
            $"/api/roomconsumables/v1/roomConsumable/{consumableId}");
        Assert.Equal("7", await buyerDelete.Content.ReadAsStringAsync()); // PlayerDoesntHavePermission
        using var ownerDelete = await ownerClient.DeleteAsync(
            $"/api/roomconsumables/v1/roomConsumable/{consumableId}");
        Assert.Equal("0", await ownerDelete.Content.ReadAsStringAsync());
        var emptied = await GetJsonAsync(buyerClient, $"/api/roomconsumables/v1/roomConsumable/room/{roomId}");
        Assert.Equal(0, emptied.GetArrayLength());
    }
    [Fact]
    public async Task Unprefixed_2023_commerce_probes_respond()
    {
        // The 2023 client calls these WITHOUT the api/ prefix on startup;
        // a 404 here surfaces as "CleanupPendingTransactions failed" +
        // unobserved-HTTP-404 crash reports in Player.log.
        using var client = ApiClient();
        using var cleanup = await client.PostAsync("/purchase/v1/cleanuppending",
            new StringContent("", Encoding.UTF8, "application/x-www-form-urlencoded"));
        Assert.True(cleanup.IsSuccessStatusCode);
        using var hasSpent = await client.GetAsync("/purchase/v1/hasspentmoney");
        Assert.Equal("false", await hasSpent.Content.ReadAsStringAsync());
        var bundles = await GetJsonAsync(client, "/reminder/currentTokenBundles/v2");
        Assert.Equal(JsonValueKind.Array, bundles.ValueKind);
    }
    private HttpClient ApiClient(GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
    private static async Task<JsonElement> PostJsonAsync(HttpClient client, string path, string json)
    {
        using var response = await client.PostAsync(path, new StringContent(json, Encoding.UTF8, "application/json"));
        response.EnsureSuccessStatusCode();
        using var document = await JsonDocument.ParseAsync(await response.Content.ReadAsStreamAsync());
        return document.RootElement.Clone();
    }
    private static async Task<JsonElement> GetJsonAsync(HttpClient client, string path)
    {
        using var response = await client.GetAsync(path);
        response.EnsureSuccessStatusCode();
        using var document = await JsonDocument.ParseAsync(await response.Content.ReadAsStreamAsync());
        return document.RootElement.Clone();
    }
 }
@@ -1,348 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// 2023 room-save flow (captured from the 2023.03.21 client against dev,
 /// 2026-07-07). The client uploads two blobs to storage /upload —
 /// FileType=6 room metadata, then FileType=1 scene save — and commits
 /// them with a JSON POST to rooms/{id}/subrooms/{id}/data:
 ///   { "UnityAssetId": null,
 ///     "RoomData":    { "Filename": "...", "Hash": null, "OwnershipProof": null },
 ///     "SubRoomData": { "Filename": "...", "Hash": null, "OwnershipProof": null } }
 /// SubRoomData.Filename is the scene blob and must become the room's
 /// CurrentDataBlobName.
 /// </summary>
 public sealed class RoomSave2023Tests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public RoomSave2023Tests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task SubRoomData_accepts_2023_nested_json_and_commits_blob()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var roomId = 9_200_001L;
        var blobName = $"room_{roomId}_v1_{Guid.NewGuid():N}.dat";
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            if (!await db.Rooms.AnyAsync(r => r.Id == roomId))
            {
                db.Rooms.Add(new RoomEntity
                {
                    Id = roomId,
                    Name = $"Save2023_{Guid.NewGuid():N}"[..24],
                    Description = "2023 save flow test room",
                    CreatorPlayerId = owner.PlayerId,
                    ImageName = RoomService.DefaultRoomImageName,
                    Accessibility = 1,
                    IsAGRoom = true,
                    IsDormRoom = false,
                });
                await db.SaveChangesAsync();
            }
            else
            {
                await db.Rooms.Where(r => r.Id == roomId)
                    .ExecuteUpdateAsync(s => s.SetProperty(r => r.CreatorPlayerId, owner.PlayerId));
            }
        }
        using var roomsClient = ApiClient(owner, subdomain: "rooms");
        var body = new
        {
            UnityAssetId = (long?)null,
            RoomData = new { Filename = "roommeta_test.bin", Hash = (string?)null, OwnershipProof = (string?)null },
            SubRoomData = new { Filename = blobName, Hash = (string?)null, OwnershipProof = (string?)null },
        };
        using var response = await roomsClient.PostAsync(
            $"/rooms/{roomId}/subrooms/0/data",
            new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json"));
        var responseText = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"{(int)response.StatusCode}: {responseText}");
        using var json = JsonDocument.Parse(responseText);
        Assert.True(json.RootElement.GetProperty("success").GetBoolean(), responseText);
        // 2023 commit-response contract (NEOPBOMGIOG): value carries a
        // Room and a SubRoomDataSave. The Room reuses the exact GET
        // rooms/{id} shape (BuildRoomServerDetails) — do NOT bolt extra
        // keys onto it: the room-details mapper is strict about value
        // shapes and an invented RankingContext object broke every
        // room-details parse ("Malformed Response"). See befd590 revert.
        var value = json.RootElement.GetProperty("value");
        var roomDto = value.GetProperty("Room");
        Assert.Equal(JsonValueKind.Object, roomDto.ValueKind);
        foreach (var key in new[] { "RoomId", "SubRooms", "Roles", "Tags", "Stats" })
            Assert.True(roomDto.TryGetProperty(key, out _), $"Room missing '{key}': {responseText}");
        var save = value.GetProperty("SubRoomDataSave");
        Assert.Equal(blobName, save.GetProperty("DataBlob").GetString());
        foreach (var key in new[] { "SubRoomDataSaveId", "SubRoomId", "UnityAssetId", "SavedByAccountId", "CreatedAt" })
            Assert.True(save.TryGetProperty(key, out _), $"SubRoomDataSave missing '{key}': {responseText}");
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var room = await db.Rooms.AsNoTracking().SingleAsync(r => r.Id == roomId);
            Assert.Equal(blobName, room.CurrentDataBlobName);
        }
    }
    [Fact]
    public async Task Upload_fileType6_room_metadata_is_stored_not_stubbed()
    {
        using var setupClient = ApiClient();
        var player = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        using var storageClient = ApiClient(player, subdomain: "storage");
        using var form = new MultipartFormDataContent("BestHTTP_HTTPMultiPartForm_TEST");
        var file = new ByteArrayContent(new byte[] { 0x0A, 0x02, 0x08, 0x01 });
        file.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
        form.Add(file, "File", "file.bin");
        form.Add(new StringContent("6"), "FileType");
        using var response = await storageClient.PostAsync("/upload", form);
        var responseText = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"{(int)response.StatusCode}: {responseText}");
        using var json = JsonDocument.Parse(responseText);
        var filename = json.RootElement.GetProperty("filename").GetString();
        Assert.NotNull(filename);
        Assert.StartsWith("roommeta_", filename);
        await using var scope = _factory.Services.CreateAsyncScope();
        var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
        Assert.True(
            await db.RoomDataBlobs.AnyAsync(b => b.BlobName == filename),
            $"expected a RoomDataBlobs row for {filename}");
    }
    /// <summary>
    /// Regression: cloning a room — and then cloning the CLONE — must both
    /// succeed and return the full room-details shape (FGCPNAACHIK). Previously
    /// the handler relied on DB auto-increment for the room id AND the copied
    /// scene ids, which collide with the seeded id range once the identity
    /// sequence lags → the clone POST 500s and the client boots the player to
    /// their dorm ("Failed to copy room: Failed to clone room").
    ///
    /// The first clone goes through the <c>roomserver/</c>-prefixed route:
    /// the 2023 in-room "copy room" flow (RecNet.Runtime NLDBPDCNNCF) sends
    /// that prefix like every other room mutation, and the bare-only route
    /// 404'd with an empty body ("Failed to copy room: Exception of type
    /// '…' was thrown").
    ///
    /// Blob rules: cloning a FIRST-PARTY template (AG + system-owned) must
    /// give the clone a FRESH empty blob — the template's blob is a MakerPen
    /// overlay against the shared baked scene, not the clone's content.
    /// Cloning a USER-owned room (even AG-flagged) must carry its blob so
    /// "copy room" keeps the player's edits.
    /// </summary>
    [Fact]
    public async Task Cloning_a_room_and_then_the_clone_both_succeed()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var roomId = 9_300_777L;
        var templateBlob = $"room_{roomId}_v1.dat";
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            if (!await db.Rooms.AnyAsync(r => r.Id == roomId))
            {
                db.Rooms.Add(new RoomEntity
                {
                    Id = roomId,
                    Name = $"CloneSrc_{Guid.NewGuid():N}"[..20],
                    Description = "clone source",
                    // A first-party RRO/AG base room (RecCenter-like):
                    // system-owned, CloningAllowed=false, yet the base-room
                    // picker must still be able to clone it. Its blob is a
                    // MakerPen overlay that must NOT leak into clones.
                    CreatorPlayerId = PlayerService.SystemAccountId,
                    ImageName = RoomService.DefaultRoomImageName,
                    Accessibility = 1,
                    IsAGRoom = true,
                    IsDormRoom = false,
                    CloningAllowed = false,
                    CurrentDataBlobName = templateBlob,
                });
                db.RoomScenes.Add(new RoomSceneEntity
                {
                    RoomId = roomId,
                    OrderIndex = 0,
                    Name = "Main",
                    DataBlobName = templateBlob,
                });
                await db.SaveChangesAsync();
            }
        }
        using var roomsClient = ApiClient(owner, subdomain: "rooms");
        // First clone: template → player copy, via the roomserver/ prefix the
        // real client uses.
        var firstCloneId = await CloneAndAssertAsync(
            roomsClient, roomId, "FirstClone", pathPrefix: "/roomserver");
        Assert.NotEqual(roomId, firstCloneId);
        // A clone of a first-party template used to be left with NO blob, on
        // the reasoning that its content is baked client geometry. That left
        // the copy with nothing to load: the CDN synthesises a ~1.8 KB stub for
        // a name it has nothing stored under, and the client fetches exactly
        // that through GetRoomData ("/room/{blob}") while copying, then rejects
        // it. Clones that carried real content joined fine.
        //
        // The content now comes across. Sharing the SOURCE's object is still
        // wrong, but that is prevented by copying it under the clone's own name
        // rather than by having no blob at all — see
        // RoomCloneShapeTests.Clone_does_not_reference_the_source_rooms_blob,
        // which runs with a real object store. This suite has none, so the
        // copy deliberately falls back to keeping the reference and only the
        // "has content" half is checkable here.
        await AssertBlobsAsync(firstCloneId, expectEmpty: false,
            "a clone of a first-party template must carry its content");
        // Simulate the player saving MakerPen edits into their clone.
        var editedBlob = $"room_{firstCloneId}_edit_{Guid.NewGuid():N}.dat";
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            var room = await db.Rooms.SingleAsync(r => r.Id == firstCloneId);
            room.CurrentDataBlobName = editedBlob;
            var scene = await db.RoomScenes.SingleAsync(s => s.RoomId == firstCloneId);
            scene.DataBlobName = editedBlob;
            await db.SaveChangesAsync();
        }
        // The regression: cloning the clone (bare path still works too).
        // The source is user-owned — even though it inherited IsAGRoom, the
        // player's edits must carry over.
        var secondCloneId = await CloneAndAssertAsync(roomsClient, firstCloneId, "SecondClone");
        Assert.NotEqual(firstCloneId, secondCloneId);
        await AssertBlobsAsync(secondCloneId, expectEmpty: false,
            "copying a user-owned room must keep its blob (player edits)");
    }
    private async Task AssertBlobsAsync(long roomId, bool expectEmpty, string why)
    {
        await using var scope = _factory.Services.CreateAsyncScope();
        var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
        var room = await db.Rooms.SingleAsync(r => r.Id == roomId);
        var scene = await db.RoomScenes.SingleAsync(s => s.RoomId == roomId);
        if (expectEmpty)
        {
            Assert.True(string.IsNullOrEmpty(room.CurrentDataBlobName), $"{why}: room blob was '{room.CurrentDataBlobName}'");
            Assert.True(string.IsNullOrEmpty(scene.DataBlobName), $"{why}: scene blob was '{scene.DataBlobName}'");
        }
        else
        {
            Assert.False(string.IsNullOrEmpty(room.CurrentDataBlobName), $"{why}: room blob was empty");
            Assert.False(string.IsNullOrEmpty(scene.DataBlobName), $"{why}: scene blob was empty");
        }
    }
    private static async Task<long> CloneAndAssertAsync(
        HttpClient client, long sourceId, string name, string pathPrefix = "")
    {
        // The real 2023 client posts the name as x-www-form-urlencoded
        // (`name=...`), NOT JSON — testing with JSON would miss the 415 that
        // a [FromBody] handler returns for a form POST.
        using var resp = await client.PostAsync(
            $"{pathPrefix}/rooms/{sourceId}/clone",
            new FormUrlEncodedContent(new Dictionary<string, string> { ["name"] = name }));
        var text = await resp.Content.ReadAsStringAsync();
        Assert.True(resp.IsSuccessStatusCode, $"clone of {sourceId} -> {(int)resp.StatusCode}: {text}");
        using var json = JsonDocument.Parse(text);
        var root = json.RootElement;
        // Full room-details shape (FGCPNAACHIK), not a status wrapper.
        foreach (var key in new[] { "RoomId", "SubRooms", "Roles" })
            Assert.True(root.TryGetProperty(key, out _), $"clone response missing '{key}': {text}");
        return root.GetProperty("RoomId").GetInt64();
    }
    /// <summary>
    /// Regression: <c>GET rooms/{id}/subrooms/{sub}/saves</c> must return the
    /// paged wrapper <c>{"Results":[…],"TotalResults":N}</c>
    /// (PagedResultsDTO&lt;SubRoomDataSaveDTO&gt;), NOT a bare array. The 2023
    /// client's GetSubRoomDataSaves strict reader throws
    /// <c>expected:'{', actual:'['</c> on an array, which aborts the whole
    /// calling flow — room clone fails with the message-less "Failed to copy
    /// room" and the private-instance button silently does nothing.
    /// </summary>
    [Fact]
    public async Task SubRoom_saves_returns_paged_object_not_bare_array()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var roomId = 9_300_888L;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            if (!await db.Rooms.AnyAsync(r => r.Id == roomId))
            {
                db.Rooms.Add(new RoomEntity
                {
                    Id = roomId,
                    Name = $"SavesShape_{Guid.NewGuid():N}"[..20],
                    CreatorPlayerId = owner.PlayerId,
                    ImageName = RoomService.DefaultRoomImageName,
                    Accessibility = 1,
                    CurrentDataBlobName = $"room_{roomId}_v1.dat",
                });
                db.RoomScenes.Add(new RoomSceneEntity
                {
                    RoomId = roomId,
                    OrderIndex = 0,
                    Name = "Home",
                    DataBlobName = $"room_{roomId}_v1.dat",
                });
                await db.SaveChangesAsync();
            }
        }
        using var roomsClient = ApiClient(owner, subdomain: "rooms");
        foreach (var path in new[]
        {
            $"/roomserver/rooms/{roomId}/subrooms/0/saves?skip=0&take=10",
            $"/rooms/{roomId}/subrooms/0/saves",
            $"/roomserver/rooms/{roomId}/subrooms/0/saves/no_unity_assets?skip=0&take=10",
        })
        {
            using var resp = await roomsClient.GetAsync(path);
            var text = await resp.Content.ReadAsStringAsync();
            Assert.True(resp.IsSuccessStatusCode, $"{path} -> {(int)resp.StatusCode}: {text}");
            using var json = JsonDocument.Parse(text);
            Assert.Equal(JsonValueKind.Object, json.RootElement.ValueKind);
            Assert.Equal(JsonValueKind.Array, json.RootElement.GetProperty("Results").ValueKind);
            Assert.True(json.RootElement.GetProperty("TotalResults").GetInt64() >= 1, $"TotalResults missing/zero: {text}");
        }
    }
    private HttpClient ApiClient(GameClientSession? session = null, string subdomain = "api")
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{subdomain}.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
 }
@@ -1,39 +0,0 @@
 using System.Text.Json;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 namespace DorkNet.Server.Tests;
 public sealed class RoomServiceTests
 {
    [Fact]
    public void ToWireRoom_never_emits_empty_image_name()
    {
        var room = new RoomEntity
        {
            Id = 1001,
            Name = "CustomRoomWithoutImage",
            Description = "Custom room",
            ImageName = "",
            Accessibility = 1,
            State = 0,
        };
        var json = JsonSerializer.Serialize(RoomService.ToWireRoom(room));
        using var document = JsonDocument.Parse(json);
        Assert.Equal(RoomService.DefaultRoomImageName, document.RootElement.GetProperty("ImageName").GetString());
    }
    [Fact]
    public void ResolveDisplayImageName_preserves_existing_image_name()
    {
        var room = new RoomEntity
        {
            Name = "Paintball",
            ImageName = "custom-thumbnail.png",
        };
        Assert.Equal("custom-thumbnail.png", RoomService.ResolveDisplayImageName(room));
    }
 }
@@ -1,104 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 public sealed class RoomsVisitedByTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public RoomsVisitedByTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Continue_rooms_hide_private_rooms_from_non_owners()
    {
        using var setupClient = ApiClient();
        var owner = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var visitor = await GameClientSessionFactory.CreateAsync(setupClient, _factory.ApexDomain);
        var suffix = Guid.NewGuid().ToString("N")[..8];
        var publicRoomId = 9_100_001L;
        var privateRoomId = 9_100_002L;
        var publicRoomName = $"ContinuePublic_{suffix}";
        var privateRoomName = $"ContinuePrivate_{suffix}";
        var now = DateTime.UtcNow;
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            db.Rooms.AddRange(
                BuildRoom(publicRoomId, publicRoomName, owner.PlayerId, accessibility: 1),
                BuildRoom(privateRoomId, privateRoomName, owner.PlayerId, accessibility: 0));
            db.RoomVisits.AddRange(
                BuildVisit(publicRoomId, visitor.PlayerId, now.AddMinutes(-2)),
                BuildVisit(privateRoomId, visitor.PlayerId, now.AddMinutes(-1)),
                BuildVisit(privateRoomId, owner.PlayerId, now));
            await db.SaveChangesAsync();
        }
        using var visitorClient = ApiClient(visitor);
        var visitorNames = await GetContinueRoomNamesAsync(visitorClient);
        Assert.Contains(publicRoomName, visitorNames);
        Assert.DoesNotContain(privateRoomName, visitorNames);
        using var ownerClient = ApiClient(owner);
        var ownerNames = await GetContinueRoomNamesAsync(ownerClient);
        Assert.Contains(privateRoomName, ownerNames);
    }
    private HttpClient ApiClient(GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://api.{_factory.ApexDomain}");
        client.Timeout = TimeSpan.FromSeconds(30);
        client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
        client.DefaultRequestHeaders.UserAgent.ParseAdd("RecRoom/2023.03.21");
        client.DefaultRequestHeaders.TryAddWithoutValidation("X-DorkNet-Version", "march_2023_03_21");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
    private static async Task<string[]> GetContinueRoomNamesAsync(HttpClient client)
    {
        using var response = await client.GetAsync("/rooms/visitedby/me");
        response.EnsureSuccessStatusCode();
        await using var body = await response.Content.ReadAsStreamAsync();
        using var document = await JsonDocument.ParseAsync(body);
        return document.RootElement
            .EnumerateArray()
            .Select(room => room.GetProperty("Name").GetString() ?? string.Empty)
            .ToArray();
    }
    private static RoomEntity BuildRoom(long id, string name, long creatorPlayerId, int accessibility) => new()
    {
        Id = id,
        Name = name,
        Description = name,
        CreatorPlayerId = creatorPlayerId,
        ImageName = RoomService.DefaultRoomImageName,
        State = 0,
        Accessibility = accessibility,
        IsAGRoom = true,
        IsDormRoom = false,
        HiddenFromBrowse = false,
        TagsCsv = "community",
    };
    private static RoomVisitEntity BuildVisit(long roomId, long playerId, DateTime visitedAt) => new()
    {
        RoomId = roomId,
        PlayerId = playerId,
        FirstVisitAt = visitedAt,
        LastVisitAt = visitedAt,
        VisitCount = 1,
    };
 }
@@ -1,448 +0,0 @@
 using System.Net.Http.Headers;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using DorkNet.Server.Services;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 using RecRoom.Protobuf;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Baked Rec Room Originals (Rec Royale, Paintball, …) ship with an empty
 /// <see cref="RoomSceneEntity.DataBlobName"/>, and every details builder and
 /// matchmaking resolver turns that into an empty <c>DataBlob</c>. The client
 /// reads that as "no room data at all": no persistence views, no room-role
 /// overlay, no Maker Pen, no CV2 chips, no room mood engine. Real Rec Room
 /// served these rooms a blob — Rec Royale's game-rule chip lives in it, not
 /// in the scene — so DorkNet needs a switch that gives such a room one.
 ///
 /// The property pinned here: the admin "enable blob" action stamps the
 /// synthetic default name, that name flows through the game-client details
 /// verbatim while <c>IsRRO</c> stays true (the client still loads the baked
 /// map, and only additionally fetches the blob), the CDN answers that name
 /// with the RRO-editable blob (permissive room roles, no objects), and
 /// "reset" puts everything back to scene-only.
 /// </summary>
 public sealed class RroRoomBlobTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public RroRoomBlobTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Baked_original_gets_no_blob_until_an_admin_enables_one()
    {
        using var setup = Client("rooms");
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_600_000 + Random.Shared.Next(1, 99_999);
        var roomName = $"Royale{Guid.NewGuid():N}"[..18];
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            // Shape of a seeded baked original: system-owned, AG-flagged,
            // tagged recroomoriginal, no blob anywhere.
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = roomName,
                CreatorPlayerId = 1,
                IsAGRoom = true,
                TagsCsv = "recroomoriginal,sport",
                CurrentDataBlobName = string.Empty,
                LocationReplicationId = "b010171f-4875-4e89-baba-61e878cd41e1",
            });
            db.RoomScenes.Add(new RoomSceneEntity
            { RoomId = roomId, Name = "Home", OrderIndex = 0, DataBlobName = string.Empty });
            await db.SaveChangesAsync();
        }
        var synthetic = RoomService.SyntheticDefaultRoomDataBlobName(roomId);
        using var gameClient = Client("rooms", player);
        using var adminClient = Client("admin", admin);
        using var cdnClient = Client("cdn");
        // ── before: baked scene only ────────────────────────────────────────
        var before = await GetJsonAsync(gameClient, $"/rooms/{roomId}");
        Assert.True(before.GetProperty("IsRRO").GetBoolean());
        Assert.Equal(string.Empty, SubRoomZero(before).GetProperty("DataBlob").GetString());
        var listed = await GetJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms");
        var row = listed.EnumerateArray().Single();
        Assert.True(row.GetProperty("isBakedOriginal").GetBoolean());
        Assert.Equal(string.Empty, row.GetProperty("effectiveBlobName").GetString());
        // ── enable: the synthetic name lands on the scene AND the room ─────
        var enabled = await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/enable");
        Assert.True(enabled.GetProperty("changed").GetBoolean());
        Assert.Equal(synthetic, enabled.GetProperty("effectiveBlobName").GetString());
        Assert.Equal(synthetic, enabled.GetProperty("dataBlobName").GetString());
        Assert.Equal(synthetic, enabled.GetProperty("roomCurrentDataBlobName").GetString());
        // Idempotent: a second enable changes nothing and keeps the name.
        var again = await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/enable");
        Assert.False(again.GetProperty("changed").GetBoolean());
        Assert.Equal(synthetic, again.GetProperty("effectiveBlobName").GetString());
        // The game client now gets the blob name, and IsRRO is untouched —
        // that flag is what makes it load the baked map (a false there sends
        // it looking for geometry inside the blob and the join fails).
        var after = await GetJsonAsync(gameClient, $"/rooms/{roomId}");
        Assert.True(after.GetProperty("IsRRO").GetBoolean());
        Assert.Equal(synthetic, SubRoomZero(after).GetProperty("DataBlob").GetString());
        // ── the CDN answers that name with the RRO-editable blob ───────────
        using var blobResponse = await cdnClient.GetAsync($"/room/{synthetic}");
        var blobBytes = await blobResponse.Content.ReadAsByteArrayAsync();
        Assert.True(blobResponse.IsSuccessStatusCode,
            $"GET cdn /room/{synthetic} -> {(int)blobResponse.StatusCode}");
        var persisted = PersistedRoomData.Parser.ParseFrom(blobBytes);
        Assert.NotNull(persisted.RoomRoleData);
        Assert.NotEmpty(persisted.RoomRoleData.RoomRoles);
        Assert.True(persisted.RoomRoleData.RoomRoles.All(r => r.CanUseMakerPen is { Overrides: true, InnerValue: true }));
        // The March-2023 client rejects a blob past PersistedRoomVersion 16
        // (the old stub was stamped 19 and loaded as "no room data"), and a
        // real save carries the room's location id as activity_id. Our proto
        // doesn't type activity_id, so look for it on the wire.
        Assert.Equal(RoomDataBlobService.Client2023MaxPersistedRoomVersion, (int)persisted.Version);
        var blobText = System.Text.Encoding.UTF8.GetString(blobBytes);
        Assert.Contains("b010171f-4875-4e89-baba-61e878cd41e1", blobText);
        // Every real room save carries three GameRoleNode chips (default role
        // named after the room, "In-Game", "Eliminated" — well-known GUIDs).
        // The 2023 client grants Maker Pen off the player's GameRole, so a
        // blob with no role objects leaves even a co-owner with nothing.
        Assert.Equal(3, CountTopLevelPersistenceViews(blobBytes));
        Assert.Contains("In-Game", blobText);
        Assert.Contains("Eliminated", blobText);
        Assert.Contains("2c721342-c7ed-49fe-b8f0-93f8d282a6df", blobText);
        Assert.Contains("0b9ec39e-2cc9-4825-8321-da11561f1c4f", blobText);
        Assert.Contains("c48bac02-a743-4797-94c4-e2d6f0749004", blobText);
        Assert.Contains(roomName, blobText);
        // ── reset: back to scene-only ───────────────────────────────────────
        var reset = await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/reset");
        Assert.True(reset.GetProperty("changed").GetBoolean());
        Assert.Equal(string.Empty, reset.GetProperty("effectiveBlobName").GetString());
        var restored = await GetJsonAsync(gameClient, $"/rooms/{roomId}");
        Assert.True(restored.GetProperty("IsRRO").GetBoolean());
        Assert.Equal(string.Empty, SubRoomZero(restored).GetProperty("DataBlob").GetString());
    }
    /// <summary>The seeded Rec Royale rows have NO RoomScenes at all (the admin
    /// page showed "Scenes 0 / No sub-rooms"). The admin list must synthesise
    /// the entry scene the way the game-client details do, and enable must
    /// create the row rather than 404.</summary>
    [Fact]
    public async Task Room_without_scene_rows_gets_a_virtual_entry_scene_and_enable_creates_it()
    {
        using var setup = Client("rooms");
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_670_000 + Random.Shared.Next(1, 99_999);
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"NoScene{Guid.NewGuid():N}"[..18],
                CreatorPlayerId = 1,
                IsAGRoom = true,
                TagsCsv = "recroomoriginal",
                MaxCapacity = 24,
            });
            await db.SaveChangesAsync();
        }
        var synthetic = RoomService.SyntheticDefaultRoomDataBlobName(roomId);
        using var gameClient = Client("rooms", player);
        using var adminClient = Client("admin", admin);
        var listed = await GetJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms");
        var virtualRow = listed.EnumerateArray().Single();
        Assert.True(virtualRow.GetProperty("isVirtual").GetBoolean());
        Assert.Equal(0, virtualRow.GetProperty("subRoomId").GetInt32());
        Assert.Equal(24, virtualRow.GetProperty("maxPlayers").GetInt32());
        Assert.Equal(string.Empty, virtualRow.GetProperty("effectiveBlobName").GetString());
        var enabled = await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/enable");
        Assert.True(enabled.GetProperty("changed").GetBoolean());
        Assert.Equal(synthetic, enabled.GetProperty("effectiveBlobName").GetString());
        // The row now exists with the game-side defaults, and the game client
        // sees the blob on its entry scene.
        var relisted = await GetJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms");
        var real = relisted.EnumerateArray().Single();
        Assert.False(real.TryGetProperty("isVirtual", out _));
        Assert.Equal("Home", real.GetProperty("name").GetString());
        Assert.Equal(24, real.GetProperty("maxPlayers").GetInt32());
        Assert.Equal(synthetic, real.GetProperty("dataBlobName").GetString());
        var details = await GetJsonAsync(gameClient, $"/rooms/{roomId}");
        Assert.True(details.GetProperty("IsRRO").GetBoolean());
        Assert.Equal(synthetic, SubRoomZero(details).GetProperty("DataBlob").GetString());
        var reset = await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/reset");
        Assert.True(reset.GetProperty("changed").GetBoolean());
        Assert.Equal(string.Empty, SubRoomZero(await GetJsonAsync(gameClient, $"/rooms/{roomId}")).GetProperty("DataBlob").GetString());
    }
    /// <summary>Rec Royale's Frontier scene has no baked game rule; real Rec
    /// Room delivered the RecRoyaleSolos/Squads_GameRuleWrapperCircuit chip
    /// in the blob. The stub for those rooms must carry it (a fourth
    /// persistence view with the palette tag the client generates).</summary>
    [Theory]
    [InlineData("RecRoyaleSolos", "recroyalesolosgamerulecir")]
    [InlineData("RecRoyaleSquads", "recroyalesquadsgameruleci")]
    public async Task Rec_royale_stub_carries_its_game_rule_chip(string roomNamePrefix, string expectedTag)
    {
        using var setup = Client("rooms");
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_680_000 + Random.Shared.Next(1, 99_999);
        var roomName = $"{roomNamePrefix}-{Guid.NewGuid():N}"[..24];
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = roomName,
                CreatorPlayerId = 1,
                IsAGRoom = true,
                TagsCsv = "recroomoriginal",
                LocationReplicationId = "253fa009-6e65-4c90-91a1-7137a56a267f",
            });
            await db.SaveChangesAsync();
        }
        using var adminClient = Client("admin", admin);
        using var cdnClient = Client("cdn");
        await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/enable");
        var synthetic = RoomService.SyntheticDefaultRoomDataBlobName(roomId);
        using var blobResponse = await cdnClient.GetAsync($"/room/{synthetic}");
        Assert.True(blobResponse.IsSuccessStatusCode);
        var blobBytes = await blobResponse.Content.ReadAsByteArrayAsync();
        Assert.Equal(4, CountTopLevelPersistenceViews(blobBytes)); // 3 roles + the rule chip
        Assert.Contains(expectedTag, System.Text.Encoding.UTF8.GetString(blobBytes));
    }
    /// <summary>A real save from any client version can be attached to a baked
    /// original: activity id rewritten to the target room, output log /
    /// sub-room id / unknown fields dropped, version clamped, and in
    /// <c>basics</c> mode only the role + rule objects kept with circuits
    /// stripped. The room then loads that blob (with the CDN's role overlay).</summary>
    [Fact]
    public async Task Uploading_a_real_save_attaches_it_to_the_room_rewritten_for_2023()
    {
        using var setup = Client("rooms");
        var player = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_690_000 + Random.Shared.Next(1, 99_999);
        const string location = "253fa009-6e65-4c90-91a1-7137a56a267f";
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"Upload{Guid.NewGuid():N}"[..18],
                CreatorPlayerId = 1,
                IsAGRoom = true,
                TagsCsv = "recroomoriginal",
                LocationReplicationId = location,
            });
            await db.SaveChangesAsync();
        }
        // A "modern" save: version 138, someone else's activity id, an output
        // log, a sub-room id, a newer-only field 37, circuit payloads, and
        // three views — a game role (field 50), a game rule (field 41) and a
        // plain prop (field 15 only).
        var modern = BuildModernSave();
        using var adminClient = Client("admin", admin);
        using var form = new MultipartFormDataContent();
        form.Add(new ByteArrayContent(modern), "file", "persisted_room_data.binpb");
        using var uploaded = await adminClient.PostAsync($"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/upload?mode=basics", form);
        var uploadBody = await uploaded.Content.ReadAsStringAsync();
        Assert.True(uploaded.IsSuccessStatusCode, $"upload -> {(int)uploaded.StatusCode}: {uploadBody}");
        var result = JsonDocument.Parse(uploadBody).RootElement;
        var blobName = result.GetProperty("dataBlobName").GetString()!;
        Assert.StartsWith($"room_{roomId}_upload_", blobName);
        var summary = result.GetProperty("summary");
        Assert.Equal(3, summary.GetProperty("viewsIn").GetInt32());
        Assert.Equal(2, summary.GetProperty("viewsKept").GetInt32());
        Assert.Equal(138, summary.GetProperty("versionIn").GetInt32());
        Assert.Equal(16, summary.GetProperty("versionOut").GetInt32());
        // The game client is now pointed at the uploaded blob …
        using var gameClient = Client("rooms", player);
        var details = await GetJsonAsync(gameClient, $"/rooms/{roomId}");
        Assert.Equal(blobName, SubRoomZero(details).GetProperty("DataBlob").GetString());
        // … and the CDN serves it rewritten: 2 views, clamped header, our
        // activity id, the role overlay applied, no field 37 / output log.
        using var cdnClient = Client("cdn");
        using var served = await cdnClient.GetAsync($"/room/{blobName}");
        Assert.True(served.IsSuccessStatusCode, $"cdn -> {(int)served.StatusCode}");
        var bytes = await served.Content.ReadAsByteArrayAsync();
        var parsed = PersistedRoomData.Parser.ParseFrom(bytes);
        Assert.Equal(RoomDataBlobService.Client2023MaxPersistedRoomVersion, (int)parsed.Version);
        Assert.NotEmpty(parsed.RoomRoleData.RoomRoles);
        Assert.Equal(2, CountTopLevelPersistenceViews(bytes));
        var text = System.Text.Encoding.UTF8.GetString(bytes);
        Assert.Contains(location, text);
        Assert.DoesNotContain("someone-elses-activity", text);
        Assert.DoesNotContain("Serialized 3 persistence views", text);
    }
    private static byte[] BuildModernSave()
    {
        var ms = new MemoryStream();
        void Varint(int field, ulong v) { WriteVarint(ms, ((ulong)field << 3) | 0); WriteVarint(ms, v); }
        void Bytes(int field, byte[] payload) { WriteVarint(ms, ((ulong)field << 3) | 2); WriteVarint(ms, (ulong)payload.Length); ms.Write(payload); }
        static byte[] View(int markerField)
        {
            var v = new MemoryStream();
            WriteVarint(v, (1UL << 3) | 2); WriteVarint(v, 16); v.Write(Guid.NewGuid().ToByteArray());
            WriteVarint(v, ((ulong)markerField << 3) | 2); WriteVarint(v, 0);
            return v.ToArray();
        }
        Varint(1, 38);
        Bytes(2, View(50));  // game role
        Bytes(2, View(41));  // game rule wrapper
        Bytes(2, View(15));  // a prop (tagged tool only)
        Bytes(4, System.Text.Encoding.UTF8.GetBytes("someone-elses-activity-0000-000000000000"));
        Bytes(5, System.Text.Encoding.UTF8.GetBytes("Serialized 3 persistence views"));
        Varint(6, 3991471883933115623UL);
        Bytes(18, new byte[] { 0x0A, 0x02, 0x08, 0x01 });
        Bytes(28, new byte[] { 0x0A, 0x02, 0x08, 0x01 });
        Varint(30, 138);
        Varint(31, 1);
        Varint(37, 1);
        return ms.ToArray();
    }
    private static void WriteVarint(Stream s, ulong value)
    {
        while (value >= 0x80) { s.WriteByte((byte)(value | 0x80)); value >>= 7; }
        s.WriteByte((byte)value);
    }
    [Fact]
    public async Task Enable_on_a_saved_subroom_keeps_the_saved_blob()
    {
        using var setup = Client("rooms");
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_650_000 + Random.Shared.Next(1, 99_999);
        const string saved = "room_saved_by_a_player_v3.dat";
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"Saved{Guid.NewGuid():N}"[..18],
                CreatorPlayerId = 1,
                IsAGRoom = true,
                TagsCsv = "recroomoriginal",
                CurrentDataBlobName = saved,
            });
            db.RoomScenes.Add(new RoomSceneEntity
            { RoomId = roomId, Name = "Home", OrderIndex = 0, DataBlobName = saved });
            await db.SaveChangesAsync();
        }
        using var adminClient = Client("admin", admin);
        var enabled = await PostJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms/0/blob/enable");
        Assert.False(enabled.GetProperty("changed").GetBoolean());
        Assert.Equal(saved, enabled.GetProperty("effectiveBlobName").GetString());
    }
    /// <summary>Count top-level <c>persistence_views</c> (field 2) entries by
    /// walking the wire format — our server proto doesn't type field 2.</summary>
    private static int CountTopLevelPersistenceViews(byte[] blob)
    {
        var pos = 0;
        var count = 0;
        while (pos < blob.Length)
        {
            var tag = ReadVarint(blob, ref pos);
            var field = (int)(tag >> 3);
            var wireType = (int)(tag & 7);
            switch (wireType)
            {
                case 0: ReadVarint(blob, ref pos); break;
                case 1: pos += 8; break;
                case 2:
                    var len = (int)ReadVarint(blob, ref pos);
                    if (field == 2) count++;
                    pos += len;
                    break;
                case 5: pos += 4; break;
                default: throw new InvalidDataException($"wire type {wireType}");
            }
        }
        return count;
    }
    private static ulong ReadVarint(byte[] input, ref int pos)
    {
        ulong value = 0;
        var shift = 0;
        while (true)
        {
            var b = input[pos++];
            value |= (ulong)(b & 0x7F) << shift;
            if ((b & 0x80) == 0) return value;
            shift += 7;
        }
    }
    private static JsonElement SubRoomZero(JsonElement details) =>
        details.GetProperty("SubRooms").EnumerateArray()
            .First(e => e.GetProperty("SubRoomId").GetInt64() == 0);
    private static async Task<JsonElement> GetJsonAsync(HttpClient client, string path)
    {
        using var response = await client.GetAsync(path);
        var body = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"GET {path} -> {(int)response.StatusCode}: {body}");
        return JsonDocument.Parse(body).RootElement.Clone();
    }
    private static async Task<JsonElement> PostJsonAsync(HttpClient client, string path)
    {
        using var response = await client.PostAsync(path, content: null);
        var body = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"POST {path} -> {(int)response.StatusCode}: {body}");
        return JsonDocument.Parse(body).RootElement.Clone();
    }
    private HttpClient Client(string host, GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{host}.{_factory.ApexDomain}");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization =
                new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
 }
@@ -1,271 +0,0 @@
 using System.Text.RegularExpressions;
 using Microsoft.Data.Sqlite;
 using Microsoft.EntityFrameworkCore;
 using DorkNet.Server.Data;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Guards the two ways a column reaches a database that already exists, because
 /// getting either one wrong is invisible until a live server starts returning
 /// 500s.
 ///
 /// Every other test in this suite runs against a FRESH database, where
 /// <c>EnsureCreated</c> builds the whole schema straight from the entity model —
 /// so every column always exists and none of this is exercised. Only an
 /// *existing* database can be missing a column, and that is exactly what took
 /// down club home, matchmake/dorm, the presence heartbeat and the chat inbox at
 /// once: three columns were added to the entity model with an EF migration, but
 /// the Postgres path never replays migrations, so a deployed database never got
 /// them.
 ///
 /// The two mechanisms, and the invariant each test asserts:
 ///
 /// <list type="number">
 /// <item><b>SQLite</b> applies committed EF migrations via <c>Database.Migrate()</c>.
 /// So the migration history alone must be able to build the current model.</item>
 /// <item><b>Postgres</b> is <c>EnsureCreated</c>-only and NEVER replays
 /// migrations. A database created before a column existed only gets it from an
 /// idempotent <c>Ensure*</c> ALTER in <see cref="DorkNet.Server.Startup"/>'s
 /// DatabaseBootstrap. So anything added after the Initial migration must appear
 /// there too.</item>
 /// </list>
 /// </summary>
 public sealed class SchemaBootstrapParityTests
 {
    /// <summary>Every table and column in the entity model must be reachable on
    /// a database that already exists — via a committed migration, an
    /// idempotent <c>Ensure*</c> patch, or both.
    ///
    /// That union is exactly what boot does: SQLite runs <c>Database.Migrate()</c>
    /// and then the <c>Ensure*</c> helpers, and Postgres runs the helpers alone.
    /// A property with NEITHER reaches only brand-new databases, and every
    /// query touching it throws at runtime on a deployed server.
    ///
    /// The union is asserted rather than migrations alone because a large amount
    /// of the schema legitimately predates this rule and lives only in the
    /// helpers. Tightening that up is a separate cleanup; what must never happen
    /// is a column covered by nothing.</summary>
    [Fact]
    public async Task Every_model_column_reaches_an_existing_database()
    {
        await using var connection = new SqliteConnection("DataSource=:memory:");
        await connection.OpenAsync();
        var options = new DbContextOptionsBuilder<DorkNetDbContext>()
            .UseSqlite(connection)
            .Options;
        await using var db = new DorkNetDbContext(options);
        await db.Database.MigrateAsync();
        var actual = await ReadSqliteSchemaAsync(connection);
        var (patchedTables, patchedColumns) = ReadBootstrapPatches(postgresOnly: false);
        var missing = new List<string>();
        foreach (var entity in db.Model.GetEntityTypes())
        {
            var table = entity.GetTableName();
            if (string.IsNullOrEmpty(table)) continue;
            var migrated = actual.TryGetValue(table, out var columns);
            if (!migrated && !patchedTables.Contains(table))
            {
                missing.Add($"{table} (whole table)");
                continue;
            }
            // A table the helpers create carries its own columns in the same
            // CREATE, so only migrated tables need a per-column check.
            if (!migrated) continue;
            foreach (var property in entity.GetProperties())
            {
                var column = property.GetColumnName();
                if (string.IsNullOrEmpty(column)) continue;
                if (columns!.Contains(column)) continue;
                if (patchedColumns.Contains($"{table}.{column}")) continue;
                missing.Add($"{table}.{column}");
            }
        }
        Assert.True(missing.Count == 0,
            $"""
             {missing.Count} model table(s)/column(s) are covered by NOTHING.
             They exist on a freshly-created database (EnsureCreated builds the
             whole model) but never appear on one that already exists, so a
             deployed server throws "no such column" / "column does not exist"
             on every request that touches them.
             Add a migration AND an idempotent ALTER in an Ensure*Async helper in
             DorkNet.Server/Startup/DatabaseBootstrap.cs for:
             {string.Join(Environment.NewLine, missing.Order(StringComparer.Ordinal))}
             """);
    }
    /// <summary>Every column added AFTER the Initial migration must also be
    /// added by an idempotent Postgres <c>ALTER</c> in DatabaseBootstrap.
    ///
    /// Postgres never replays migrations, so a migration alone reaches only
    /// brand-new databases. A production database created before the column
    /// existed gets it from the Ensure* helpers or not at all — the exact hole
    /// that broke matchmake/dorm (PrivateInstances.RoomCode),
    /// club/home/me (Clubs.ClubChatEnabled) and the chat inbox
    /// (ChatMessages.ModerationState).</summary>
    [Fact]
    public void Post_initial_columns_are_patched_for_existing_postgres_databases()
    {
        var migrations = FindRepoDirectory("DorkNet.Server", "Migrations");
        var (patchedTables, patchedColumns) = ReadBootstrapPatches(postgresOnly: true);
        // Anything AddColumn'd by a migration other than Initial post-dates the
        // baseline, so an existing Postgres database will not have it.
        var gaps = new List<string>();
        foreach (var file in Directory.GetFiles(migrations, "*.cs"))
        {
            var name = Path.GetFileNameWithoutExtension(file);
            if (name.Contains("Designer", StringComparison.Ordinal)) continue;
            if (name.Contains("Initial", StringComparison.Ordinal)) continue;
            if (name.Contains("ModelSnapshot", StringComparison.Ordinal)) continue;
            var text = File.ReadAllText(file);
            foreach (Match m in Regex.Matches(text,
                         @"AddColumn<[^>]+>\(\s*name:\s*""(?<column>\w+)""\s*,\s*table:\s*""(?<table>\w+)""",
                         RegexOptions.Singleline))
            {
                var table = m.Groups["table"].Value;
                var column = m.Groups["column"].Value;
                if (patchedTables.Contains(table)) continue;      // whole table is created by a patch
                if (patchedColumns.Contains($"{table}.{column}")) continue;
                gaps.Add($"{table}.{column}  (added by {name})");
            }
            foreach (Match m in Regex.Matches(text,
                         @"CreateTable\(\s*name:\s*""(?<table>\w+)""",
                         RegexOptions.Singleline))
            {
                var table = m.Groups["table"].Value;
                if (!patchedTables.Contains(table))
                    gaps.Add($"{table} (whole table, created by {name})");
            }
        }
        Assert.True(gaps.Count == 0,
            $"""
             {gaps.Count} schema change(s) reach new databases only.
             The Postgres path is EnsureCreated-only and never replays
             migrations, so a migration alone does NOT add these to a database
             that already exists — a deployed server will throw
             "column does not exist" on every request that touches them.
             Add an idempotent ALTER/CREATE to an Ensure*Async helper in
             DorkNet.Server/Startup/DatabaseBootstrap.cs for:
             {string.Join(Environment.NewLine, gaps.Order(StringComparer.Ordinal))}
             """);
    }
    /// <summary>Tables and columns the <c>Ensure*</c> helpers add by raw SQL.
    ///
    /// The helpers are private, so this reads their statements out of the source
    /// rather than executing them. In that source the SQL sits inside verbatim
    /// strings, so a quoted identifier appears as two literal quote characters
    /// (<c>""Playlists""</c>).
    ///
    /// <paramref name="postgresOnly"/> keys off <c>IF NOT EXISTS</c>: the
    /// Postgres branch uses it, while the SQLite branch omits it and swallows
    /// the duplicate-column error instead. So requiring it isolates the branch
    /// that an existing Postgres database actually depends on.</summary>
    private static (HashSet<string> Tables, HashSet<string> Columns) ReadBootstrapPatches(
        bool postgresOnly)
    {
        var bootstrap = Path.Combine(
            FindRepoDirectory("DorkNet.Server", "Startup"), "DatabaseBootstrap.cs");
        Assert.True(File.Exists(bootstrap), $"missing {bootstrap}");
        var sql = File.ReadAllText(bootstrap);
        // The source mixes both C# string styles, so a quoted identifier shows
        // up as either two quote characters (verbatim, @"... ""X"" ...") or one
        // (raw, """... "X" ..."""). Accept either.
        const string Q = "\"{1,2}";
        var ifNotExists = postgresOnly ? @"IF\s+NOT\s+EXISTS\s+" : @"(?:IF\s+NOT\s+EXISTS\s+)?";
        var columns = Regex
            .Matches(sql,
                $@"ALTER\s+TABLE\s+{Q}(?<table>\w+){Q}\s+ADD\s+COLUMN\s+{ifNotExists}{Q}(?<column>\w+){Q}",
                RegexOptions.IgnoreCase)
            .Select(m => $"{m.Groups["table"].Value}.{m.Groups["column"].Value}")
            .ToHashSet(StringComparer.OrdinalIgnoreCase);
        var tables = Regex
            .Matches(sql,
                $@"CREATE\s+TABLE\s+IF\s+NOT\s+EXISTS\s+{Q}(?<table>\w+){Q}",
                RegexOptions.IgnoreCase)
            .Select(m => m.Groups["table"].Value)
            .ToHashSet(StringComparer.OrdinalIgnoreCase);
        // Some helpers loop a column-name array through one interpolated ALTER
        // (EnsureGameRewardColumnsAsync does). The statement alone only shows
        // "{col}", so pair each such ALTER with the nearest preceding
        // `new[] { "A", "B" }` and expand it.
        foreach (Match alter in Regex.Matches(sql,
                     $@"ALTER\s+TABLE\s+{Q}(?<table>\w+){Q}\s+ADD\s+COLUMN\s+{ifNotExists}{Q}\{{(?<var>\w+)\}}{Q}",
                     RegexOptions.IgnoreCase))
        {
            var loop = Regex.Matches(
                    sql[..alter.Index],
                    $@"foreach\s*\(\s*var\s+{Regex.Escape(alter.Groups["var"].Value)}\s+in\s+new\[\]\s*\{{(?<items>[^}}]*)\}}")
                .Cast<Match>()
                .LastOrDefault();
            if (loop is null) continue;
            foreach (Match item in Regex.Matches(loop.Groups["items"].Value, "\"(?<name>\\w+)\""))
                columns.Add($"{alter.Groups["table"].Value}.{item.Groups["name"].Value}");
        }
        return (tables, columns);
    }
    private static async Task<Dictionary<string, HashSet<string>>> ReadSqliteSchemaAsync(
        SqliteConnection connection)
    {
        var schema = new Dictionary<string, HashSet<string>>(StringComparer.OrdinalIgnoreCase);
        var tables = new List<string>();
        await using (var cmd = connection.CreateCommand())
        {
            cmd.CommandText =
                "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%';";
            await using var reader = await cmd.ExecuteReaderAsync();
            while (await reader.ReadAsync()) tables.Add(reader.GetString(0));
        }
        foreach (var table in tables)
        {
            var columns = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
            await using var cmd = connection.CreateCommand();
            cmd.CommandText = $"PRAGMA table_info(\"{table}\");";
            await using var reader = await cmd.ExecuteReaderAsync();
            while (await reader.ReadAsync()) columns.Add(reader.GetString(1));
            schema[table] = columns;
        }
        return schema;
    }
    /// <summary>Walk up from the test binaries to the repo root, then into the
    /// requested source directory.</summary>
    private static string FindRepoDirectory(params string[] segments)
    {
        var dir = new DirectoryInfo(AppContext.BaseDirectory);
        while (dir is not null && !File.Exists(Path.Combine(dir.FullName, "DorkNet.sln")))
            dir = dir.Parent;
        Assert.NotNull(dir);
        var path = Path.Combine(new[] { dir!.FullName }.Concat(segments).ToArray());
        Assert.True(Directory.Exists(path), $"missing source directory {path}");
        return path;
    }
 }
@@ -1,164 +0,0 @@
 using System.Net.Http.Headers;
 using System.Net.Http.Json;
 using System.Text.Json;
 using DorkNet.Server.Data;
 using DorkNet.Server.Data.Entities;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
 namespace DorkNet.Server.Tests;
 /// <summary>
 /// Max players is a PER SUB-ROOM setting, adjustable from two places:
 ///
 ///   in-game  PUT rooms/{id}/subrooms/{sub}/maxplayers   (owner only — the
 ///            "Max Player Count in This Subroom" slider)
 ///   admin    PUT api/admin/v1/rooms/{id}/subrooms/{sub}/maxplayers
 ///
 /// Both write the same <see cref="RoomSceneEntity.MaxPlayers"/>, so a change
 /// made in one place has to be visible from the other. That is the property
 /// worth pinning: two independent write paths onto one column drift silently,
 /// and the symptom (a slider that snaps back) looks like a client bug.
 ///
 /// Kept distinct from the room's own <see cref="RoomEntity.MaxCapacity"/>,
 /// which is what the ROOM advertises and what matchmaking hands to
 /// RoomInstance.MaxCapacity. Reading the room-level figure off sub-room 0
 /// would collapse the two settings into one.
 /// </summary>
 public sealed class SubRoomMaxPlayersTests : IClassFixture<DorkNetServerFactory>
 {
    private readonly DorkNetServerFactory _factory;
    public SubRoomMaxPlayersTests(DorkNetServerFactory factory) => _factory = factory;
    [Fact]
    public async Task Owner_and_admin_edit_the_same_per_subroom_value()
    {
        using var setup = Client("rooms");
        var owner = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_700_000 + Random.Shared.Next(1, 99_999);
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"Caps{Guid.NewGuid():N}"[..18],
                CreatorPlayerId = owner.PlayerId,
                MaxCapacity = 12,
            });
            db.RoomScenes.Add(new RoomSceneEntity
            { RoomId = roomId, Name = "Home", OrderIndex = 0, MaxPlayers = 8 });
            db.RoomScenes.Add(new RoomSceneEntity
            { RoomId = roomId, Name = "Arena", OrderIndex = 1, MaxPlayers = 8 });
            await db.SaveChangesAsync();
        }
        // ── in-game: the owner's slider on sub-room 1 only ──────────────────
        // Sent exactly as the client sends it. NLDBPDCNNCF.MNBPCGJNLNP(Int64,
        // Int64, Int32) builds a BLNOGFGHIIF whose single JSON key is
        // "maxPlayers" and issues it with verb 3 = PUT — NOT the form encoding
        // most of its siblings use. Testing with a form would pass while the
        // real client's body went unread.
        using var ownerClient = Client("rooms", owner);
        using var slider = await ownerClient.PutAsJsonAsync(
            $"/rooms/{roomId}/subrooms/1/maxplayers", new { maxPlayers = 24 });
        var sliderBody = await slider.Content.ReadAsStringAsync();
        Assert.True(slider.IsSuccessStatusCode,
            $"owner PUT maxplayers -> {(int)slider.StatusCode}: {sliderBody}");
        // The client deserialises the reply as FGCPNAACHIK — the room-details
        // shape — so the slider's own response has to carry the new value.
        var echoed = JsonDocument.Parse(sliderBody).RootElement
            .GetProperty("SubRooms").EnumerateArray()
            .First(e => e.GetProperty("SubRoomId").GetInt64() == 1);
        Assert.Equal(24, echoed.GetProperty("MaxPlayers").GetInt32());
        // ── admin: reads what the owner just set, then edits sub-room 0 ─────
        using var adminClient = Client("admin", admin);
        var listed = await GetJsonAsync(adminClient, $"/api/admin/v1/rooms/{roomId}/subrooms");
        var subRooms = listed.EnumerateArray()
            .ToDictionary(e => e.GetProperty("subRoomId").GetInt32(),
                          e => e.GetProperty("maxPlayers").GetInt32());
        Assert.Equal(24, subRooms[1]);
        Assert.Equal(8, subRooms[0]);
        using var adminSet = await adminClient.PutAsJsonAsync(
            $"/api/admin/v1/rooms/{roomId}/subrooms/0/maxplayers", new { MaxPlayers = 40 });
        Assert.True(adminSet.IsSuccessStatusCode,
            $"admin PUT maxplayers -> {(int)adminSet.StatusCode}: {await adminSet.Content.ReadAsStringAsync()}");
        // ── the room's own details carry each sub-room's own figure ─────────
        var details = await GetJsonAsync(ownerClient, $"/rooms/{roomId}");
        var wire = details.GetProperty("SubRooms").EnumerateArray()
            .ToDictionary(e => e.GetProperty("SubRoomId").GetInt64(),
                          e => e.GetProperty("MaxPlayers").GetInt32());
        Assert.Equal(40, wire[0]);
        Assert.Equal(24, wire[1]);
        // The room-level figure is the room's advertised capacity, NOT a copy
        // of sub-room 0 — otherwise the admin edit above would have moved it.
        Assert.Equal(12, details.GetProperty("MaxPlayers").GetInt32());
    }
    [Fact]
    public async Task Admin_cap_is_clamped_to_a_joinable_range()
    {
        using var setup = Client("rooms");
        var owner = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var admin = await GameClientSessionFactory.CreateAsync(setup, _factory.ApexDomain);
        var roomId = 9_800_000 + Random.Shared.Next(1, 99_999);
        await using (var scope = _factory.Services.CreateAsyncScope())
        {
            var db = scope.ServiceProvider.GetRequiredService<DorkNetDbContext>();
            (await db.Players.FirstAsync(p => p.Id == admin.PlayerId)).IsAdmin = true;
            db.Rooms.Add(new RoomEntity
            {
                Id = roomId,
                Name = $"Clamp{Guid.NewGuid():N}"[..18],
                CreatorPlayerId = owner.PlayerId,
            });
            db.RoomScenes.Add(new RoomSceneEntity
            { RoomId = roomId, Name = "Home", OrderIndex = 0, MaxPlayers = 8 });
            await db.SaveChangesAsync();
        }
        using var adminClient = Client("admin", admin);
        // 0 would make the sub-room unjoinable.
        using var tooLow = await adminClient.PutAsJsonAsync(
            $"/api/admin/v1/rooms/{roomId}/subrooms/0/maxplayers", new { MaxPlayers = 0 });
        var low = JsonDocument.Parse(await tooLow.Content.ReadAsStringAsync()).RootElement;
        Assert.Equal(1, low.GetProperty("maxPlayers").GetInt32());
        using var tooHigh = await adminClient.PutAsJsonAsync(
            $"/api/admin/v1/rooms/{roomId}/subrooms/0/maxplayers", new { MaxPlayers = 9999 });
        var high = JsonDocument.Parse(await tooHigh.Content.ReadAsStringAsync()).RootElement;
        Assert.Equal(80, high.GetProperty("maxPlayers").GetInt32());
    }
    private static async Task<JsonElement> GetJsonAsync(HttpClient client, string path)
    {
        using var response = await client.GetAsync(path);
        var body = await response.Content.ReadAsStringAsync();
        Assert.True(response.IsSuccessStatusCode, $"GET {path} -> {(int)response.StatusCode}: {body}");
        return JsonDocument.Parse(body).RootElement.Clone();
    }
    private HttpClient Client(string host, GameClientSession? session = null)
    {
        var client = _factory.CreateClient(new() { AllowAutoRedirect = false });
        client.BaseAddress = new Uri($"http://{host}.{_factory.ApexDomain}");
        if (session is not null)
            client.DefaultRequestHeaders.Authorization =
                new AuthenticationHeaderValue("Bearer", session.AccessToken);
        return client;
    }
 }
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Alexa	8986b1301e	Refresh main branch documentation	2026-06-15 23:58:36 +03:00
Alexa	a9e08dbe0c	docs: update FAQ with details on Quest standalone support and patching process	2026-06-09 00:16:32 +03:00
Alexa	3098593de5	Ignore local tool settings	2026-06-01 20:55:36 +03:00
Alexa	0a76a4ec13	launcher: EAC-aware exe pick + optional TLS trust bypass Launch RecRoom.exe directly on 2020.12 EAC builds (skip the Recroom_Release.exe EAC wrapper); fall back to whichever single binary exists. Add an opt-in "trust self-signed TLS certs" toggle that flows through ClientPatcher into the ClientMod config, off by default since Localtunnel/Tunnelto serve valid certs.	2026-05-31 12:32:29 +03:00
Alexa	43b27e674a	advanced-setup: patch client via MelonLoader, not BepInEx The BepInEx client patcher is gone; document the MelonLoader installer (install-melon.ps1 on the version branch) dropping DorkNet.ClientMod into Mods/ instead of a BepInEx plugin into BepInEx/plugins/.	2026-05-30 02:13:35 +03:00
Alexa	f5ad4b59ef	Localtunnel hosting + admin panel + AppData db - Default hosting mode is now Localtunnel — public *.loca.lt URL, no account, auto-fetched on first run. Replaces the prototyped Tailscale mode. - Tailscale code purged from launcher + CLI; docs swapped to Localtunnel throughout (easy-setup, joining-a-server, server-cli, troubleshooting, faq, READMEs). - Launcher sidebar gains an Open admin panel button — opens https://admin.<apex> in the browser once the server is live. - SQLite db moves to %APPDATA%\DorkNet\dorknet.db (server reads Database__SqlitePath env var, launcher passes it). Existing dbs under <serverDir>\data\ are migrated on first run. - CLI Program.cs: --mode default flips from tailscale to localtunnel; csproj links in LocaltunnelTunnel + LocaltunnelInstaller. - New Backend files: LauncherNameServer, LocaltunnelInstaller, LocaltunnelTunnel, SingleOriginServiceMap. - .gitignore: exclude installer/out/.	2026-05-28 01:39:38 +03:00
Alexa	7852b410ee	Add installer updater and server CLI	2026-05-27 20:54:53 +03:00
Alexa	4f44505759	Merge branch 'main' of https://github.com/DorkSquadRR/DorkNet	2026-05-27 18:52:38 +03:00
Alexa	25662a864e	Add sanitized README screenshots	2026-05-27 18:52:27 +03:00
Alexa	b6a0990afe	Add Tunnelto hosting support	2026-05-27 18:26:39 +03:00
Alexa	71ea59db00	Update README.md	2026-05-27 17:49:09 +03:00
Alexa	f9a40ba788	patcher: install mod to <root>/Mods, not <root>/MelonLoader/Mods MelonLoader 0.6.x scans <install root>\Mods\ for plugin DLLs and ignores anything under MelonLoader\Mods\. Our default plugin_dest was MelonLoader/Mods, so DorkNet.ClientMod.dll landed somewhere MelonLoader never looked at — Player.log showed '0 Mods loaded.' and Rec Room booted unpatched, hitting the real rec.net version check which returns UpdateRequired. Changed ClientPatcher's default + the manifest doc to 'Mods'. Per-version branches also need 'plugin_dest' = 'Mods' in their build-patcher-zip.ps1 manifest (separate commits).	2026-05-27 13:13:20 +03:00
Alexa	c366b6190a	launcher: ClientPatcher handles steam_stub manifest block Per-version patcher zips now ship a Goldberg steam_api64.dll + steam_appid.txt alongside the existing MelonLoader stuff. The manifest's new steam_stub block describes where to install them: - api_dll / api_dest: stub DLL location and target path under Rec Room root (typically Recroom_Release_Data/Plugins/...) - api_backup_suffix: the original Valve DLL gets renamed to <dest> + suffix on first install; re-runs detect the existing backup and leave it alone so the real DLL is preserved - appid_file / appid_value + appid_dest: writes a steam_appid.txt next to the exe so the stub knows what game ID to claim Block is optional — manifests without steam_stub patch nothing extra, preserving back-compat with pre-stub patcher zips.	2026-05-27 13:04:08 +03:00
Alexa	26786527cd	launcher: auto-strip SteamStub DRM before patching Steam-purchased Rec Room ships with SteamStub Variant 3.1 wrapping Recroom_Release.exe so it refuses to launch without Steam loaded. DorkNet spawns the exe directly, so for Steam installs we have to unwrap it first or the user gets a silent crash on Launch. - SteamDrmStripper.StripIfNeededAsync: PE-walks the exe's section table looking for the .bind section SteamStub adds, and only invokes Steamless when that section is present. Re-runs detect the already-unwrapped exe and short-circuit. Backs up the original next to the exe as Recroom_Release.exe.steamwrapped. - SteamlessInstaller: resolves a usable Steamless.CLI.exe via side-by-side -> %LOCALAPPDATA%\DorkNet\Steamless\ cache -> download v3.1.0.5 from atom0s/Steamless GitHub releases. Same pattern as CloudflaredInstaller. - Inserted as a step between "Download client patcher" and "Patch your Rec Room install" in both host (5 -> 6 steps) and join (2 -> 3 steps). Step detail reports Stripped / AlreadyUnpacked / NotApplicable so the user sees what happened. Oculus / Quest builds and already-unwrapped installs skip the Steamless download entirely.	2026-05-27 12:10:27 +03:00
Alexa	de98ea694f	launcher: side-by-side versions.json fallback + empty-state UX The version dropdown sat silently empty when the GitHub manifest fetch 404'd (private repo, network down, etc.) and there was no DORKNET_LOCAL_MANIFEST to fall back to. Two fixes: - csproj copies the repo-root versions.json next to dorknet.exe on build, and LocalOverrides.GetLocalManifestPath checks that path as a fallback after the env var. Dev checkouts against a private repo now Just Work — no env vars needed. - When the manifest can't be loaded, RefreshManifestAsync now inserts a disabled placeholder "(no versions - check internet or set DORKNET_LOCAL_MANIFEST)" in the dropdown so the user sees the problem at a glance instead of a silent blank. - LocalOverrides.DescribeManifestSource shows in Settings whether the active manifest came from the env var, the side-by-side fallback, or the live GitHub fetch.	2026-05-27 12:05:21 +03:00
Alexa	a5f1d74a8e	launcher: surface env vars even when path is missing on disk Previously DescribeActive() only returned overrides when the path resolved, so DORKNET_LOCAL_RELEASES set to a typo'd or unmounted path would silently fall through to the GitHub fetch and the Settings panel would stay hidden. Now the panel shows the env var value with a [SET BUT NOT FOUND on disk] tag when the path isn't there, so the user can debug 'I set it but it didn't work' without reading the source.	2026-05-27 11:53:40 +03:00
Alexa	7d1ac82cf8	launcher: DORKNET_LOCAL_* env-var overrides for dev testing Set DORKNET_LOCAL_MANIFEST and/or DORKNET_LOCAL_RELEASES to point the launcher at on-disk artifacts instead of the public repo: - DORKNET_LOCAL_MANIFEST: full path to a versions.json file. VersionsManifest.FetchAsync reads it from disk and skips the GitHub round-trip. - DORKNET_LOCAL_RELEASES: path to a directory laid out as {root}/{version_key}/server/ + .../patcher/. EnsureServerAsync / EnsurePatcherAsync return those paths in-place — no download, no copy, no marker files. Both are silent no-ops when unset / missing on disk, so it's safe to leave them set permanently in a dev profile. When at least one is active, the Settings view surfaces a "Dev overrides active" panel listing the paths so it's obvious the launcher isn't using the public manifest. Lets contributors iterate on per-version branch changes against the launcher UI without needing to tag a public Release.	2026-05-27 11:45:08 +03:00
Alexa	5452ff06ee	launcher: welcome screen + guided setup wizard First launch went straight to a Host/Join card picker with no framing. Replaced with a two-phase onboarding: WelcomeView — branded intro with the wordmark, three feature bullets (2 min setup, free, works with regular Rec Room), and one big "Get started" button. Dismissed via AppState.WelcomeSeen. SetupView — multi-step wizard with a STEP X OF N indicator: 1. Host vs Join card picker (self-advances on click) 2. Rec Room install (shows auto-detected path with a green "we found it" banner; Pick... overrides) 3. (Host only) Server name + WHO CAN JOIN radios 4. (Host only) Photon AppIds — "Open setup walkthrough" launches the existing PhotonWizard, or paste fields below for advanced users; live status line confirms when AppIds are set 5. Done card with Finish button Join mode hops 2 -> done since it doesn't need server config or Photon. AppState.SetupComplete gates entry; future launches skip the wizard and route directly to HostView / JoinView. Existing state files get auto-migrated on load (Mode set + RecRoomPath populated = WelcomeSeen + SetupComplete backfilled to true, then flushed). Settings -> "Re-run setup" clears the flag for users who want to walk through again.	2026-05-27 11:25:28 +03:00
Alexa	5b98886937	launcher: friendly errors + Retry / Get help buttons Raw exception messages ("Access is denied", HttpRequestException stack traces) gave the user nothing to do. The flow now translates the common failures into plain language and offers a one-click retry that re-runs the host/join flow from the top: - ErrorTranslator handles HttpRequestException (network down), TaskCanceledException (timeout), SocketException (firewall), UnauthorizedAccessException + IOException "in use" (Rec Room open), missing folder / files (re-pick install), cloudflared download truncation (suggests LAN mode), port 5005 already bound - Patcher log output goes through TranslateMessage which catches the same "access denied" / missing files cases - HostStepsPanel / JoinStepsPanel gain a Retry + "Get help" row below the steps; visible only on failure - "Get help" opens README.md#troubleshooting on GitHub - Stop / new run hides the retry row so a fresh start is clean	2026-05-27 11:17:39 +03:00
Alexa	7c974e39ab	launcher: Photon AppId setup walkthrough The two empty "REALTIME APPID / VOICE APPID" textboxes assumed the user already knew what Photon was, where to sign up, and which app type to create. New 5-step wizard fills that gap: 1. What's Photon? — one-paragraph explanation tying back to DorkNet 2. Make an account — Open Dashboard button launches browser 3. Create a Realtime app — numbered click-by-click instructions 4. Create a Voice app — same, with a Skip button (voice is optional) 5. Paste your AppIds — text fields with live regex validation, region picker, Save commits to AppState Hyphens optional on input; we normalise to canonical 8-4-4-4-12 form before writing back. The existing Photon section keeps its three fields for advanced users, with a "Setup walkthrough" button at the top opening the wizard prefilled with current values.	2026-05-27 11:14:23 +03:00
Alexa	3aa0b55512	launcher: QR code + share buttons on host ready panel The single Copy button left it on the user to format a message and get the code into Discord/email. Added a layout that makes sharing obvious: - QR encodes the join code text so a friend with a phone can scan the host's screen and forward the code without typing it - "Copy as message" formats a one-line "Join {server} on DorkNet! Download at github.com/... and paste this code:" pitch - "Email to friend" opens the default mail client with subject + body prefilled, code in the body - QR built via QRCoder -> WriteableBitmap directly (no System.Drawing dependency); palette matches the launcher	2026-05-27 11:11:31 +03:00
Alexa	3039bebc6c	launcher: step-by-step progress UI replaces single-line status The single HostStatusText/JoinStatusText line gave no sense of where the user was in the flow. Replaced with a step list: - StartupStep model (INotifyPropertyChanged) tracks Title, State (Pending/Active/Done/Failed), Detail, optional Progress 0..1 - ItemsControl + DataTemplate in App.xaml renders each step as a status bullet (empty ring -> filled brand -> green check -> red X), with conditional detail line + restyled mini progress bar - StartupFlow.NewHostFlow / NewJoinFlow build the canonical 5-step host and 2-step join lists; host flow swaps the tunnel step label for LocalNetwork mode - OnHostStart / OnJoinApply advance steps via StartStep/CompleteStep/ FailStep helpers and route progress callbacks to UpdateStepProgress so each download phase has its own bar - Errors mark the active step Failed with the message inline, leaving the rest of the list visible so the user sees where it broke	2026-05-27 11:09:20 +03:00
Alexa	65ca509fa8	launcher: grandma-proof batch 1 — auto-detect + LAN mode - RecRoomPicker.Detect: scan common manual-install paths (Documents/Recnet/dist, Downloads, C:\Games, etc.) on first run; never touches Steam libraries per policy - RecRoomVersionDetector: three-signal cascade (version.txt -> PE timestamp -> file size) maps install to a manifest branch so version dropdown defaults correctly - CloudflaredInstaller: download latest cloudflared-windows-amd64.exe from GitHub releases to %LOCALAPPDATA%\DorkNet on first host; resolves side-by-side -> cache -> PATH -> download - LocalNetwork.GetLanIp + AppState.HostingMode (Internet\|LocalNetwork) + Host view "WHO CAN JOIN?" radio: LAN-only mode skips Cloudflare entirely for families on one network - OnHostStart branches on HostingMode; status text reflects local IP vs public tunnel URL	2026-05-27 11:03:00 +03:00
Alexa	a5ae5da344	launcher: pass PhotonCloudRegion to patcher template DorkNet.ClientMod's config reads PhotonCloudRegion alongside the AppIds, and the joining client needs the host's region to connect to the right Photon cloud. Adds {PHOTON_REGION} to the substitution map and threads region through ClientPatcher.ApplyAsync from both host (AppState.PhotonRegion) and join (JoinPayload.PhotonRegion) flows.	2026-05-27 01:02:25 +03:00
Alexa	b155ae5dbe	launcher: Rec-Room-styled UI; PowerShell-free patcher; Launch button UI redesign: - Warm coral + teal palette over deep purple-navy (closer to Rec Room's marketing aesthetic). New wordmark gradient (coral -> pink -> teal). - Chunky 18px rounded cards on the first-run wizard with per-mode accent tinting (coral for host, teal for join) and clear CTAs. - Form fields wrapped in elevated panels with sectional titles + pill status chips in the header (HOST MODE / JOIN MODE / SETTINGS). - Drop-shadow effects on primary buttons + cards for depth. Patcher rewrite: - ClientPatcher.cs no longer shells out to PowerShell; the launcher unzips MelonLoader, copies the DorkNet plugin DLL, and renders the user-data config template — all in C# in-process. - Patcher zip now driven by a manifest.json at root (schema v1). Per-version branches publish: manifest.json + MelonLoader.zip + DorkNet.ClientMod.dll + config template. - RELEASES.md updated with the new MelonLoader manifest contract and the placeholder substitution rules. Rec Room launch path: - New Backend/RecRoomLauncher.cs runs Recroom_Release.exe directly from the picked install folder's parent dir (no Steam). - 'Launch Rec Room' button appears after a successful patch in both host + join modes.	2026-05-27 00:55:22 +03:00
Alexa	446a23da2b	launcher: rewrite as native WPF, drop PhotinoNET/WebView2 Initial v0.1 (commit `df9dac0`) used PhotinoNET wrapping WebView2 + HTML/JS, but rendered as a blank window on first run — WebView2 + file:// URI quirks. Switching to native WPF: built into the .NET 9 Windows SDK (no NuGet), single-file self-contained publish, instant window open. All Backend/*.cs orchestration logic carried over unchanged (they're UI-framework-agnostic). Replaced: - Program.cs (PhotinoNET bootstrap) -> App.xaml(.cs) + MainWindow.xaml(.cs) - ui/index.html + style.css + app.js -> MainWindow.xaml (XAML views) + App.xaml resource styles - Backend/MessageBridge.cs (JS<->C# router) -> direct method calls in MainWindow.xaml.cs code-behind RecRoomPicker now uses Microsoft.Win32.OpenFolderDialog (added in .NET 8) instead of WinForms FolderBrowserDialog — keeps the project WPF-only. Backend files needed explicit 'using System.IO;' since the WPF SDK doesn't include it in implicit usings.	2026-05-27 00:44:28 +03:00
Alexa	df9dac053d	launcher: v0.1 — PhotinoNET shell + multi-version orchestration Single-download .NET 9 self-contained launcher for hosting / joining DorkNet servers. Reads versions.json from main to discover supported client builds, fetches the matching server binary + client patcher from GitHub Releases per branch, manages the server subprocess + Cloudflare quick-tunnel, and wraps it all in a PhotinoNET window. Code layout: - Program.cs PhotinoNET window + message bridge bootstrap - Backend/ AppPaths, AppState, VersionsManifest, ReleaseDownloader, ServerProcess, ClientPatcher, Tunnel, RecRoomPicker, JoinCode, MessageBridge - ui/ index.html + style.css + app.js (no build step) - RELEASES.md GitHub Releases artifact contract per-version branches must publish to Per-version branches need to ship two release assets per tag: - dorknet-server-{version_key}-win-x64.zip - dorknet-clientpatch-{version_key}.zip (see launcher/RELEASES.md for the full naming + arg contract) Photon AppIds, JWT secret, and the picked Rec Room path stay per-machine; the launcher never bundles them.	2026-05-26 20:54:16 +03:00
Alexa	ce0714ed1a	main: mark march-2020-03-10 active in manifest + chart	2026-05-26 01:19:03 +03:00
Alexa	d1cc50622b	main: branch-aware README + BRANCHES.md + versions.json Rewrites main as a docs-only landing branch. Adds: - BRANCHES.md — per-branch chart (client build, status, notes) - versions.json — machine-readable manifest the Easy launcher reads - Branch-picking step + Easy-app/Docker URLs updated in README + docs/advanced-setup.md Drops the per-folder README stubs (server/, admin-ui/, client-mod/, docker/, easy-app/, tools/) — the actual code lives on per-version branches now, not on main.	2026-05-26 01:17:14 +03:00
Alexa	dc1e5436b5	main: fix 2020.12.18 typo; broaden gitignore (certs + scrub tool)	2026-05-26 01:05:46 +03:00
Alexa	bcc5fe1bcb	Add initial documentation and structure for DorkNet project - Create README.md for project overview and setup instructions - Add admin-ui/README.md for admin UI details and development setup - Introduce client-mod/README.md explaining the MelonLoader mod functionality - Establish docker/README.md for Docker setup and configuration - Create docs/README.md to index project documentation - Implement advanced-setup.md for Docker stack configuration - Document architecture in architecture.md - Provide easy-setup.md for hosting instructions - Add FAQ.md for common questions and legal considerations - Create joining-a-server.md for player connection instructions - Establish troubleshooting.md for common issues and resolutions - Introduce easy-app/README.md for the unified desktop application - Add server/README.md for ASP.NET Core backend details - Document tools/README.md for CLI helper scripts	2026-05-21 13:26:46 +03:00