33 lines
2.2 KiB
Markdown
33 lines
2.2 KiB
Markdown
# Maintained .NET tools
|
|
|
|
Every `.csproj` under `tools/` is part of `AcDream.slnx`. The complete Release
|
|
gate restores and builds these tools, so a missing personal checkout or an API
|
|
change cannot leave a tracked tool silently broken. They are diagnostic/manual
|
|
programs: the gate builds them but does not run data-dependent investigations.
|
|
|
|
| Tool | Purpose | Runtime prerequisite |
|
|
| --- | --- | --- |
|
|
| `A8CellAudit` | Inspect landblock, EnvCell, portal, and collision topology. | Installed AC DAT files / the arguments documented by the program. |
|
|
| `dump-keymap` | Extract the retail master input maps and decoded actions. | Installed `client_portal.dat`. |
|
|
| `PesChainAudit` | Walk weather PES call chains and particle emitters. | Installed AC DAT files. |
|
|
| `ProjectileVfxAudit` | Audit projectile physics-script and particle-emitter VFX mappings. | Installed AC DAT files. |
|
|
| `RainMeshProbe` | Inspect rain surfaces, polygon sidedness, and generated mesh counts. | Installed AC DAT files. |
|
|
| `RetailTimeProbe` | Read retail time-of-day and sky state for comparison. | Windows, a running retail client, and process-read access. |
|
|
| `SetupInspect` | Dump Setup parts, placement poses, and animation frames. | Installed AC DAT files and a Setup ID. |
|
|
| `ShaderCompiler` | Compile the Vulkan GLSL shader set to committed SPIR-V. | Source and output directory arguments. |
|
|
| `SkyObjectInspect` | Inspect Dereth sky/day-group objects and texture data. | Installed AC DAT files. |
|
|
| `StarsProbe` | Audit sky-object geometry, UV ranges, and surfaces. | Installed AC DAT files. |
|
|
| `TextureDump` | Dump render-surface statistics and texture images. | Installed AC DAT files. |
|
|
| `WeatherEnumerator` | Enumerate weather sky objects and their bounds. | Installed AC DAT files. |
|
|
| `WeatherSetupProbe` | Inspect the parts and surfaces of weather Setups. | Installed AC DAT files. |
|
|
|
|
Build the complete maintained graph with:
|
|
|
|
```powershell
|
|
dotnet restore AcDream.slnx --locked-mode --force-evaluate
|
|
dotnet build AcDream.slnx -c Release --no-restore
|
|
```
|
|
|
|
Use `pwsh ./tools/run-release-gate.ps1` for the authoritative bounded gate.
|
|
Package versions and lock-file maintenance are documented in
|
|
[`docs/release-gate.md`](../docs/release-gate.md).
|