1.6 KiB
1.6 KiB
Agent notes — Beat Saber / this repo
Repo
- Modding workflow and references live in
docs/pc-modding.md(Linux + Cursor +dotnetCLI; 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 viabs-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 fornet472plugin 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 buildoutput is valid for the Proton game instance. - Point
BeatSaberDir/ game references at the BSManager instance path above when editing project user files or HintPaths.