From 1f8a6c40d9291545ca45a0bd02ed1114f4134cb4 Mon Sep 17 00:00:00 2001 From: Randall Kwiatkowski Date: Sat, 17 Oct 2026 21:31:51 -0400 Subject: [PATCH] Document Valheim 1.0.20 compatibility and validation --- README.md | 10 ++++--- docs/DEVELOPMENT.md | 16 ++++++++++- docs/VALIDATION.md | 39 ++++++++++++++++++++++---- docs/nexusmods/page-description.bbcode | 2 +- 4 files changed, 55 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 84c95e8..21a3ec8 100644 --- a/README.md +++ b/README.md @@ -73,10 +73,12 @@ or [GitHub Releases](https://github.com/randenko/valheim-guildchest/releases/lat Keep item mods installed on the host and all clients when storing their items. Guild Chest supports solo, player-hosted, and dedicated-server use on PCs with -BepInEx. Console clients cannot load the chest. Recorded native checks use -**Valheim 1.0.16 (Steam build 25527701)**; newer game builds require verification. -Headless checks cover registration, recipes, transfers, and persistence. Live -gameplay was confirmed by the user for launch. See the +BepInEx. Console clients cannot load the chest. The current build reference is +**[Valheim 1.0.20](https://www.valheim.com/news/patch-1-0-20/) (Steam Dedicated +Server build 25909431)**, verified on 2026-10-17. Automated unit tests are +game-independent. The user confirmed live gameplay on **Valheim 1.0.20**. +Recorded native fixture checks on **Valheim 1.0.16 (Steam build 25527701)** cover +registration, recipes, transfers, and persistence. See the [validation record and detailed gameplay scenarios](docs/VALIDATION.md). ## Configuration and optional integrations diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 7ab6a95..db8d4ac 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -161,6 +161,16 @@ product build and test configuration. Packaging always builds Release. `Release` and `Compatibility` use Debug for their solution build by default; neither target runs gameplay checks or publishes a release. +As of 2026-10-17, the downloaded build reference is **Valheim 1.0.20**, Steam +Dedicated Server app **896660**, build **25909431**. Iron Gate released +[patch 1.0.20](https://www.valheim.com/news/patch-1-0-20/) on 2026-10-15. +Setup downloads Steam's `public` branch; the game version is not pinned. +Container startup, `--update-references`, `Release`, and `Compatibility` refresh +that reference, while ordinary builds can reuse cached assemblies. Core tests +are game-independent, and `NativeSmoke` compiles the fixture without running it. +See the [validation record](VALIDATION.md) for current build checks and the +user-confirmed 1.0.20 gameplay and historical native fixture results. + `ValheimManagedDir` defaults to the downloaded server's `.local/valheim-server/valheim_server_Data/Managed` directory. Override it when building against a different client or server installation: @@ -179,7 +189,11 @@ Game downloads and dependency DLLs are ignored by Git and excluded from the release ZIP. `.local/references.json` records the Managed directory, dependency versions, and assembly SHA-256 hashes. Default downloads also record the Steam manifest/build ID; custom references use absolute hash keys for external files -and do not claim the downloaded server's Steam manifest. To update the game +and do not claim the downloaded server's Steam manifest. For default downloads, +compare `buildid` in +`.local/valheim-server/steamapps/appmanifest_896660.acf` with that recorded +manifest, and obtain the game version from the installed server's startup log +or `Version.CurrentVersion` in its `assembly_valheim.dll`. To update the game references deliberately and refetch pinned mod dependencies: ```bash diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index 9ebb8df..39ca31c 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -1,10 +1,36 @@ # Validation -Recorded native/gameplay reference: **Valheim 1.0.16**, Steam build **25527701**, -obtained through anonymous SteamCMD app 896660 on 2026-10-05. Current setup -provenance is recorded locally in `.local/references.json`; the publication record -below identifies the newer release build. A successful compile checks assembly -compatibility; runtime behavior on newer builds needs separate verification. +Current build reference, verified on **2026-10-17**: **Valheim 1.0.20**, Steam +Dedicated Server build **25909431**, using anonymous SteamCMD app **896660**, +branch **public**. Iron Gate released +[patch 1.0.20](https://www.valheim.com/news/patch-1-0-20/) on 2026-10-15 and lists +it as the latest patch. Setup follows the public branch rather than pinning a +game version; ordinary builds can reuse cached references. + +The user confirmed on **2026-10-17** that Guild Chest works correctly on the +latest server version, **Valheim 1.0.20**. Historical native fixture results +below use **Valheim 1.0.16**, Steam build **25527701**, obtained on 2026-10-05. +Automated unit tests do not load Valheim, and compiling the native fixture does +not execute it; the fixture has not been rerun on 1.0.20. + +## Server reference verification (2026-10-17) + +- A fresh anonymous SteamCMD `app_info_update 1` / `app_info_print 896660` + query reports public build **25909431**, matching the installed + `.local/valheim-server/steamapps/appmanifest_896660.acf` and the manifest in + `.local/references.json`. +- Inspection of the installed `assembly_valheim.dll` confirms + `Version.CurrentVersion = new GameVersion(1, 0, 20)` and network version **41**. + Reference paths, pinned BepInExPack **5.4.2351** and Jötunn **2.30.2** versions, + and assembly SHA-256 hashes are recorded locally in `.local/references.json`. +- `dotnet run --project build -- --target Test Compile Package NativeSmoke` + passes **15 C#** and **162 Python** tests, builds the Debug solution and Release + plugin, creates the release ZIP, and compiles the native fixture against these + references. Product builds have no warnings or errors. The native fixture + restore/build reports **NU1900** because NuGet vulnerability metadata could not + be fetched (`Permission denied (api.nuget.org:443)`); compilation succeeds. + No automated native fixture was run on 1.0.20; live gameplay is confirmed by + the user above. ## Hexium publication (2026-10-17) @@ -121,7 +147,8 @@ compatibility; runtime behavior on newer builds needs separate verification. the existing installation. Setup and restore succeeded against build 25909431. The standalone setup fix passes 15 C# and 71 Python tests; Compile succeeds with no warnings or errors against the refreshed references. Gameplay on this newer - build remains unvalidated. + build was unvalidated at that time; the user's 2026-10-17 confirmation is + recorded above. ## 1.1.0 publication (2026-10-13) diff --git a/docs/nexusmods/page-description.bbcode b/docs/nexusmods/page-description.bbcode index 368e3d1..fcca363 100644 --- a/docs/nexusmods/page-description.bbcode +++ b/docs/nexusmods/page-description.bbcode @@ -57,7 +57,7 @@ Guild Chest supports solo, player-hosted, and dedicated-server use on PCs with B Optional adapters were tested in the native fixture with [b]AzuAutoStore 3.1.7[/b] and [b]AzuCraftyBoxes 1.8.27[/b]. Neither is required or bundled. AutoStore supports player hotkey/single-item deposits. CraftyBoxes supports nearby resource previews, crafting supply, and building after acknowledged transfers. AutoStore ground-drop automation and CraftyBoxes fuel/ore feeding and Epic Loot consumers exclude guild storage. Other storage mods need explicit integration. -Recorded native checks use [b]Valheim 1.0.16 (Steam build 25527701)[/b]. Compilation against newer references does not establish gameplay compatibility. See the [url=https://github.com/randenko/valheim-guildchest/blob/main/docs/VALIDATION.md]validation record[/url] and [url=https://github.com/randenko/valheim-guildchest/blob/main/docs/COMPATIBILITY.md]compatibility details[/url] for tested behavior and limits. +The current build reference is [b][url=https://www.valheim.com/news/patch-1-0-20/]Valheim 1.0.20[/url] (Steam Dedicated Server build 25909431)[/b], verified on 2026-10-17. The user confirmed live gameplay on [b]Valheim 1.0.20[/b]. Automated unit tests are game-independent. Recorded native fixture checks use [b]Valheim 1.0.16 (Steam build 25527701)[/b]. See the [url=https://github.com/randenko/valheim-guildchest/blob/main/docs/VALIDATION.md]validation record[/url] and [url=https://github.com/randenko/valheim-guildchest/blob/main/docs/COMPATIBILITY.md]compatibility details[/url] for tested behavior and limits. [b][size=4]Backups and removal[/size][/b] Back up the complete world before installing or removing the mod. To remove it, first withdraw all shared contents into ordinary storage and remove the Guild Chests while the mod is installed. Save, then stop the game/server before removing the plugin files.