feat: asset packs for New Game as dotnet new item templates

New Stride.Templates.AssetPacks package (nuget.org only, fetched on demand)
ships Building blocks / Animated models / Materials / Particles. GameStudio
offers them as checkboxes when creating a game; dotnet new and the stride
CLI instantiate them into an existing game.

Author: xen2

.github/workflows/release-deploy.yml

@@ -137,10 +137,10 @@ jobs:
           }
 
           $packages = Get-ChildItem -Path bin/packages -Filter "*.nupkg"
-          $contentVersionedIds = @('Stride.Templates.Samples', 'Stride.Templates.Games.Starters')
-          $contentVersioned = $packages | Where-Object { $_.Name -match 'Stride\.Templates\.(Samples|Games\.Starters)\.' }
+          $contentVersionedIds = @('Stride.Templates.Samples', 'Stride.Templates.Games.Starters', 'Stride.Templates.AssetPacks')
+          $contentVersioned = $packages | Where-Object { $_.Name -match 'Stride\.Templates\.(Samples|Games\.Starters|AssetPacks)\.' }
           $gameStudio = $packages | Where-Object { $_.Name -match 'GameStudio' }
-          $main = $packages | Where-Object { $_.Name -notmatch 'GameStudio' -and $_.Name -notmatch 'Stride\.Templates\.(Samples|Games\.Starters)\.' }
+          $main = $packages | Where-Object { $_.Name -notmatch 'GameStudio' -and $_.Name -notmatch 'Stride\.Templates\.(Samples|Games\.Starters|AssetPacks)\.' }
 
           echo "::group::Pushing main packages ($($main.Count))"
           foreach ($pkg in $main) {
@@ -150,7 +150,7 @@ jobs:
           echo "::endgroup::"
 
           if ($contentVersioned) {
-            echo "::group::Pushing content-versioned template packages (Samples, Starters)"
+            echo "::group::Pushing content-versioned template packages (Samples, Starters, AssetPacks)"
             foreach ($pkg in $contentVersioned) {
               $id = $contentVersionedIds | Where-Object { $pkg.Name.StartsWith($_ + '.') } | Select-Object -First 1
               if ($id -and (Test-NuGetPublished $id $pkg.BaseName.Substring($id.Length + 1))) {

build/Stride.slnx

@@ -189,6 +189,7 @@
   </Folder>
   <Folder Name="/72-StrideSamples.Templates/">
     <Project Path="../sources/engine/Stride.Games.AutoTesting/Stride.Games.AutoTesting.csproj" />
+    <Project Path="../sources/templates/Stride.Templates.AssetPacks/Stride.Templates.AssetPacks.csproj" />
     <Project Path="../sources/templates/Stride.Templates.Games.Starters/Stride.Templates.Games.Starters.csproj" />
     <Project Path="../sources/templates/Stride.Templates.Games/Stride.Templates.Games.csproj" />
     <Project Path="../sources/templates/Stride.Templates.Samples/Stride.Templates.Samples.csproj" />

docs/build/versioning.md

@@ -82,6 +82,6 @@ dotnet msbuild build/Stride.Samples.build -t:SamplesToReleaseVersion   # finaliz
 **Template package versions** ([`Stride.Templates.Common.targets`](../../sources/templates/Stride.Templates.Common.targets)):
 
 - `Stride.Templates.Games` (NewGame + Library) → **engine-versioned** (`$(StrideNuGetVersion)`), always rebuilt and pushed (small).
-- `Stride.Templates.Samples` + `Stride.Templates.Games.Starters` → **content-versioned** at the committed `StrideSamplesVersion` ([`StrideSamplesVersion.props`](../../sources/templates/StrideSamplesVersion.props)); they only change (and re-publish) when the samples are actually bumped. The GameStudio bridge resolves the highest published version `<=` the engine version for these.
+- `Stride.Templates.Samples` + `Stride.Templates.Games.Starters` + `Stride.Templates.AssetPacks` → **content-versioned** at the committed `StrideSamplesVersion` ([`StrideSamplesVersion.props`](../../sources/templates/StrideSamplesVersion.props)); they only change (and re-publish) when the samples are actually bumped. The GameStudio bridge resolves the highest published version `<=` the engine version for these.
 
 A user instantiating any template gets their installed engine version stamped in (the package upgrader rewrites `Stride.*` references on instantiation), so a lagging template package still produces a project on the user's current Stride.

samples/NewGame/NewGame/NewGame.sdtpl

@@ -12,3 +12,4 @@ Parameters:
     - HDR
     - graphicsProfile
     - orientation
+    - assetPacks

samples/Templates/Packs/MaterialPackage/MaterialPackage.sdtpl

@@ -0,0 +1,5 @@
+!TemplateAssetPack
+Id: 02eb39ec-2ec1-4bbb-a3fd-d1541f3a8727
+Name: "Materials pack"
+Description: A collection of ready-made materials.
+Group: AssetPacks

samples/Templates/Packs/PrototypingBlocks/PrototypingBlocks.sdtpl

@@ -0,0 +1,5 @@
+!TemplateAssetPack
+Id: dcaecb85-b5e8-4001-a394-a7039fe95d4d
+Name: "Building blocks"
+Description: Simple block models and prefabs to quickly prototype levels.
+Group: AssetPacks

samples/Templates/Packs/VFXPackage/VFXPackage.sdtpl

@@ -0,0 +1,5 @@
+!TemplateAssetPack
+Id: 63911545-be4b-40d9-b851-e0861fcee961
+Name: "Particles pack"
+Description: Ready-made particle effects such as fire, smoke and explosions.
+Group: AssetPacks

samples/Templates/Packs/mannequinModel/mannequinModel.sdtpl

@@ -0,0 +1,5 @@
+!TemplateAssetPack
+Id: faf82c1e-579e-49a3-a6aa-73548d01be04
+Name: "Animated models"
+Description: Mannequin model with a set of ready-to-use animations.
+Group: AssetPacks

sources/assets/Stride.Core.Assets/PackageStore.cs

@@ -117,6 +117,17 @@ public async Task<IEnumerable<PackageMeta>> GetPackages()
         return package is null ? null : (UDirectory)store.GetRealPath(package);
     }
 
+    /// <summary>
+    /// Fetches (if needed) and installs <paramref name="packageName"/> at <paramref name="version"/>
+    /// into the local package store, from the configured NuGet sources. Returns the installed
+    /// package, or null when it could not be resolved (e.g. offline and not cached).
+    /// </summary>
+    public Task<NugetLocalPackage?> InstallPackage(string packageName, PackageVersion version, ProgressReport? progress = null)
+    {
+        ArgumentNullException.ThrowIfNull(packageName);
+        return store.InstallPackage(packageName, version, [], progress);
+    }
+
     /// <summary>
     /// Gets the default package manager.
     /// </summary>

sources/assets/Stride.Core.Packages/NugetStore.cs

@@ -482,7 +482,7 @@ public static string GetPackageVersionVariable(string packageId, string packageV
     /// <remarks>It is safe to call it concurrently be cause we operations are done using the FileLock.</remarks>
     /// <param name="packageId">Name of package to install.</param>
     /// <param name="version">Version of package to install.</param>
-    public async Task<NugetLocalPackage?> InstallPackage(string packageId, PackageVersion version, IEnumerable<string> targetFrameworks, ProgressReport progress)
+    public async Task<NugetLocalPackage?> InstallPackage(string packageId, PackageVersion version, IEnumerable<string> targetFrameworks, ProgressReport? progress)
     {
         using (GetLocalRepositoryLock())
         {