erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions

build: make release restore reproducible

Browse source
This commit is contained in:
Erik 2026-08-18 10:29:00 +02:00
parent b459e0cf0c
commit c38f6b8852
129 changed files with 16810 additions and 188 deletions
Download patch file Download diff file Expand all files Collapse all files

33
tools/README.md Normal file
View file

@ -0,0 +1,33 @@
# 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).