# CLAUDE.md

This is an SCP: Secret Laboratory LabAPI plugin, generated from the
`labapi-plugin` `dotnet new` template. `EntryPoint.cs` is the plugin's entry
point (`Plugin<Config>`); `Config.cs` is its YAML-backed settings class.

## LabAPI contract (verified against northwood-studios/LabAPI source, not guessed)

`Plugin<TConfig>` (`LabApi.Loader.Features.Plugins`) requires implementing:
`Name`, `Description`, `Author`, `RequiredApiVersion` (all abstract get-only) plus
`Enable()`/`Disable()`. Overridable but optional: `Version` (defaults to the
assembly's version), `Priority` (`LoadPriority`, defaults to `Medium`),
`ConfigFileName` (defaults to `"config.yml"`). `Config` is a plain `class` with a
public parameterless constructor and public get/set properties — the base class
(de)serializes it via YamlDotNet automatically; don't hand-roll config I/O.

**Never invent a LabAPI class/namespace/method/property/attribute.** Before using one
you haven't already seen in this project, check the restored package (`LabApi.dll` +
`LabApi.xml` under `%userprofile%\.nuget\packages\northwood.labapi\<version>\lib\net48\`)
or https://github.com/northwood-studios/LabAPI. If you can't verify a member exists,
say so instead of guessing.

## Toolchain choices — don't "fix" these without being asked

- `TargetFramework` is `netstandard2.1` on purpose, even though LabAPI's own docs and
  the `Northwood.LabAPI` NuGet package only target `net48`/`net481`. This is a
  deliberate compatibility choice (compiled output still loads under the game's
  Mono/.NET Framework 4.8 host) that trades away some netstandard2.1 BCL/language
  surface .NET Framework can't actually run (e.g. default interface members). Don't
  switch it to `net48`, don't add multi-targeting, unless asked.
- `LangVersion` is pinned explicitly in the `.csproj` — don't let it drift to `latest`.
- The `.csproj` suppresses exactly two warnings, both scoped as narrowly as MSBuild
  allows, because of the netstandard2.1/net48-only-package combination above:
  `NU1701` (via a per-`PackageReference` `<NoWarn>`, not a project-wide one) and
  `MSB3270` (via `ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch=None`). Don't
  broaden either into a blanket suppression and don't remove them without
  understanding why (both are explained here, not in the `.csproj` — this project's
  code style forbids comments, including in the `.csproj`, see "Code style" below).
- `Northwood.LabAPI` uses a floating `Version="*"` on purpose, so every
  `dotnet restore` pulls whatever is latest on NuGet at that moment. This is
  intentionally **not** wired to `EntryPoint.cs`'s `RequiredApiVersion`, which is a
  separate, manually-maintained literal for the minimum LabAPI version this code is
  known to work with — bump it by hand if you verify compatibility with a newer
  release, don't try to auto-sync it with the floating restore.

## Code style

- No `//`, `/* */`, `///`, or XML (`<!-- -->`) comments unless explicitly asked for.
  No comments restating self-explanatory code.
- All text embedded in code defaults to **English**: string/log/console messages,
  exception messages, `[Description]`/config text, any user-facing string.
- This never applies to identifiers picked deliberately (project name, namespace,
  class/method/property/variable names) — keep those as requested.

## How to verify a change

There is no test project scaffolded. Verify with:

```bash
dotnet build
```

Expect `Build succeeded. 0 Warning(s) 0 Error(s)`.