# Agent notes — Beat Saber / this repo

## Repo

- Modding workflow and references live in `docs/pc-modding.md` (Linux + Cursor + `dotnet` CLI; no VS/Rider BSMT extension).
- `docs/pc-modding.md` §References (wiki paths, BSMT templates, BSIPA, SongCore, etc.) match local git checkouts under `~/src/…` on this machine (same layout as the guide’s `../../../src/…` links from here). Read those directories first; only fetch upstream (raw GitHub, bsmg.wiki) if a checkout is missing.
- BSMG wiki (Modding section): Available on disk at `~/src/bsmg/wiki` (also opened via `bs-modding-tools.code-workspace`). Prefer that tree over web mirrors for static wiki content.

## Game install (BSManager)

- Path: `/home/pleb/.local/share/BSManager/BSInstances/1.40.8`
- Version pin: `1.40.8` (managed copy; launch modded build from BSManager, not Steam’s live folder).
- BSIPA: Present (`IPA/`, `IPA.exe`, `winhttp.dll`, `Plugins/`).

## Plugins currently in `Plugins/`

BeatSaverDownloader, BeatSaverUpdater, BSML, BS_Utils, PlaylistManager, SiraUtil, SongCore (+ manifests/libs as shipped).

## Host toolchain

- dotnet: `9.0.312` (SDK 6+ is fine for `net472` plugin builds per guide).
- ilspycmd: `9.1.0.0` (decompile/reference game or plugin assemblies from CLI).
- NuGet: Installed (per user setup).

## Conventions agents should respect

- Plugin projects are .NET Framework 4.7.2 class libraries loaded by BSIPA; builds are CIL — Linux `dotnet build` output is valid for the Proton game instance.
- Point `BeatSaberDir` / game references at the BSManager instance path above when editing project user files or HintPaths.