Merge branch 'master' into redist-update/client-publicized

Author: sunnamed434

.github/workflows/redist-update.yaml

@@ -301,7 +301,26 @@ jobs:
           SOURCE_KEY: ${{ steps.ids.outputs.source_key }}
         run: |
           set -euo pipefail
-          names=$(gh api --paginate "repos/$REPO/actions/runs/$RUN_ID/artifacts" --jq '.artifacts[].name' || true)
+          # Fail LOUD on an API error. The ONLY thing that may mean "this source
+          # is unchanged" is a SUCCESSFUL artifacts listing that doesn't contain
+          # our artifact. If the gh call itself fails (transient 5xx / network /
+          # rate-limit), we must NOT treat that as "unchanged" — that would
+          # silently skip a genuinely-changed source under a green run, and
+          # notify-failure (failure()-only) would never fire. Retry, then fail.
+          ok=false
+          names=""
+          for attempt in 1 2 3; do
+            if names=$(gh api --paginate "repos/$REPO/actions/runs/$RUN_ID/artifacts" --jq '.artifacts[].name'); then
+              ok=true
+              break
+            fi
+            echo "::warning::Listing run artifacts failed (attempt ${attempt}/3); retrying after backoff..."
+            sleep $((attempt * 5))
+          done
+          if [ "$ok" != "true" ]; then
+            echo "::error::Could not list this run's artifacts after 3 attempts — cannot determine whether source ${SOURCE_KEY} changed. Failing loudly instead of skipping."
+            exit 1
+          fi
           if printf '%s\n' "$names" | grep -qx "source-${SOURCE_KEY}"; then
             echo "Source ${SOURCE_KEY} changed (artifact present); processing ${{ matrix.variant }}."
             echo "changed=true" >> "$GITHUB_OUTPUT"

README.md

@@ -1,78 +1,50 @@
 # RocketModFix.Unturned.Redist
 
-## Why Use This?
+Unturned's managed assemblies (`Assembly-CSharp.dll`, `com.rlabrecque.steamworks.net.dll`, `UnturnedDat.dll`, the SDG/Unity dependencies, and the API XML docs), packaged for NuGet and refreshed automatically each time Unturned ships a new build. Reference a package instead of hand-copying DLLs out of the game's `Managed` folder after every patch.
 
-Do you find it annoying to manually copy libraries from the Managed directory every time Unturned updates? With this NuGet package, you get all the necessary Unturned libraries, and they update automatically. You don't need to wait for manual updates — this package acts like a redistributable that stays current.
+> **Redistributed with permission.** Nelson Sexton (Smartly Dressed Games) gave explicit written approval to distribute Unturned's libraries — see [issue #8](https://github.com/RocketModFix/RocketModFix.Unturned.Redist/issues/8).
 
-> ✅ Officially Approved - This project has explicit written permission from SDG (Smartly Dressed Games) to distribute Unturned libraries. See the [official approval from Nelson Sexton (SDG)](https://github.com/RocketModFix/RocketModFix.Unturned.Redist/issues/8) for legal clarity and peace of mind.
+## Install
 
-You get:
-
-- **Assembly-CSharp.dll**  
-- **com.rlabrecque.steamworks.net.dll**  
-- **UnturnedDat.dll**  
-- And many more, including XML docs for the Unturned API and related dependencies.
-
----
-
-## Available Packages and What They Mean
-
-| Package Name                                   | Description                                      |
-|-----------------------------------------------|------------------------------------------------|
-| **RocketModFix.Unturned.Redist.Client**       | Libraries for Unturned client-side tools.       |
-| **RocketModFix.Unturned.Redist.Server**       | Libraries for Unturned server-side tools.       |
-| **RocketModFix.Unturned.Redist.Client.Publicized** | Publicized client-side libraries with public method/property (members) visibility for modding or advanced reflection. |
-| **RocketModFix.Unturned.Redist.Server.Publicized** | Publicized server-side libraries with public method/property (members) visibility. Useful for plugins needing deeper access. |
-| **RocketModFix.Unturned.Redist.Client-Preview** | Early access (preview) versions of client-side libraries. |
-| **RocketModFix.Unturned.Redist.Server-Preview** | Early access (preview) versions of server-side libraries. |
-
-> **Note:** The main `Client` and `Server` packages now include preview (prerelease) versions inside them for simplicity. The `*-Preview` packages remain available for backward compatibility.
-
----
-
-## How to Install
+```bash
+dotnet add package RocketModFix.Unturned.Redist.Server
+```
 
-Simply pick the package that matches your needs and add it via NuGet. For example, in your `.csproj` or `packages.config`:
+or in your `.csproj`:
 
 ```xml
 <PackageReference Include="RocketModFix.Unturned.Redist.Server" Version="x.y.z" />
 ```
 
-Or use the NuGet CLI:
-
-```bash
-dotnet add package RocketModFix.Unturned.Redist.Server
-```
+## Which package do I want?
 
----
+Choose by **side** (client or server). Use a **`.Publicized`** variant when your plugin needs to touch private/internal members — their visibility is rewritten to public.
 
-## Installation Links
+| Package | For |
+| --- | --- |
+| [![Client](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Client?label=Client)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Client) | Client-side tools and mods |
+| [![Server](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Server?label=Server)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Server) | Server-side plugins and tools |
+| [![Client.Publicized](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Client.Publicized?label=Client.Publicized)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Client.Publicized) | Client mods that need non-public members |
+| [![Server.Publicized](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Server.Publicized?label=Server.Publicized)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Server.Publicized) | Server plugins that need non-public members |
 
-[![Client](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Client?label=RocketModFix.Unturned.Redist.Client)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Client)  
-[![Server](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Server?label=RocketModFix.Unturned.Redist.Server)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Server)  
-[![Client Preview](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Client-Preview?label=RocketModFix.Unturned.Redist.Client-Preview)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Client-Preview)  
-[![Server Preview](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Server-Preview?label=RocketModFix.Unturned.Redist.Server-Preview)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Server-Preview)  
-[![Client Publicized](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Client.Publicized?label=RocketModFix.Unturned.Redist.Client.Publicized)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Client.Publicized)  
-[![Server Publicized](https://img.shields.io/nuget/v/RocketModFix.Unturned.Redist.Server.Publicized?label=RocketModFix.Unturned.Redist.Server.Publicized)](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Server.Publicized)  
+### Stable vs. preview builds
 
----
+`Client` and `Server` carry two streams under the **same package id**:
 
-## Architecture
+- **Stable** — Unturned's default branch, versioned `x.y.z.n`.
+- **Preview** — Unturned's `preview` branch, published as a prerelease `x.y.z.n-preview<build>`. Enable "include prerelease" in your NuGet client to pull it.
 
-All updates and automation are handled entirely through GitHub Actions.  
-We don't run any of this on external servers — everything happens directly on GitHub.
+The standalone [`…Client-Preview`](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Client-Preview) and [`…Server-Preview`](https://www.nuget.org/packages/RocketModFix.Unturned.Redist.Server-Preview) packages are **legacy**. They still update for projects that already reference them, but new code should use the prerelease stream above.
 
-📖 **See [ARCHITECTURE.md](ARCHITECTURE.md)** for the full picture: the workflows, the variant matrix (`.github/variants.json`), how the 10 redist directories map to 6 NuGet packages, and how to add a variant.
+## How it works
 
-![Architecture](architecture.svg)
+Everything runs on GitHub Actions, with no external servers. A scheduled job watches Steam for new Unturned builds; when one lands it downloads the build, repackages the managed DLLs, and opens a pull request. The PR is validated (files present, hashes match, version not a downgrade) and auto-merged, which publishes the affected package to NuGet.
 
-> Diagram source: [`architecture.svg`](architecture.svg) (crisp, version-controlled). `ARCHITECTURE.md` has the details and a Mermaid version.
+📖 **[ARCHITECTURE.md](ARCHITECTURE.md)** has the full picture: the workflows, the variant matrix in [`.github/variants.json`](.github/variants.json), how the 4 Steam sources map to 10 directories and 6 packages, and how to add a variant.
 
----
+![Architecture](architecture.svg)
 
 ## Credits
 
-Special thanks to these projects that helped us build this auto-updating tool:
-
-- [Unturned-Datamining](https://github.com/Unturned-Datamining)  
-- [setup-steamcmd](https://github.com/CyberAndrii/setup-steamcmd)
+- [Unturned-Datamining](https://github.com/Unturned-Datamining)
+- [setup-steamcmd](https://github.com/CyberAndrii/setup-steamcmd)

redist/redist-manifests/.manifest.redist-client-preview-publicized.txt

@@ -1 +1 @@
-6484140218604384819
+763708736677468005