Skip to content

Troubleshooting

Jump to bottom
Miooowo edited this page Aug 5, 2026 · 1 revision

Troubleshooting

中文

Godot.NET.Sdk/4.5.1 could not be found (MSB4236)

NuGet.org may be missing from your package sources:

dotnet nuget add source https://api.nuget.org/v3/index.json

Then restore / rebuild.

Microsoft.NET.SDK.WorkloadAutoImportPropsLocator could not be found

In Rider: File → Settings, search for toolset, and select an MSBuild version that mentions Rider.

Slay the Spire 2 data not found

Path discovery failed. In Directory.Build.props or local.props, set:

<Sts2Path>C:/Steam/steamapps/common/Slay the Spire 2</Sts2Path>

Use your real install path. On Windows the managed data folder is typically data_sts2_windows_x86_64 under that path.

Godot path must be set up before publishing

Publish needs MegaDot/Godot. Create Directory.Build.props next to the .csproj and set GodotPath to the .NET / mono executable (not a wrong edition).

Publish succeeds but localization / images do not appear

  • Confirm a .pck exists under the game mods/{YourMod}/ folder.
  • Non-code changes require Publish, not only Build.
  • Confirm has_pck is true in {ProjectName}.json when you ship a pck.

Character template: no localization JSON / init fails

  • Keep files under {ModFolder}/localization/**/*.json.
  • Do not leave empty JSON files.
  • Follow key format {MODID}_{CATEGORY}_{ORIGINAL_ID}.title / .description.
  • The stock template includes eng and zhs seeds — restore them if deleted.

Mod loads but RitsuLib features missing / content not registered

  • Install the runtime STS2-RitsuLib into mods (NuGet alone is not enough).
  • Ensure {ProjectName}.json lists dependency STS2-RitsuLib.
  • Match game branch / API: templates target 0.110.1 with package STS2.RitsuLib. Older branches may need STS2.RitsuLib.Compat.* packages and matching RitsuLib variant packs.
  • For auto-registration, ensure your initializer calls RitsuLib discovery / registration (Character template does this; Empty/Content may need the same pattern — see RitsuLib tutorials).

MSB3270 architecture mismatch warning

Expected when referencing a platform-specific sts2.dll while building MSIL mods. Templates suppress this warning.

Analyzer / NuGet restore issues for Miooowo.STS2RitsuLib.ModAnalyzers

Restore from nuget.org. The templates pin 0.0.1-preview. Update the PackageReference when a newer analyzer is published.

Still stuck?

中文

English

链接

Clone this wiki locally