setlist/AGENTS.md

1.6 KiB
Raw Blame History

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 guides ../../../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 Steams 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.