[Bug]

[Haidex]

Area

Other

Severity

Broken feature

What happened?

getting this error when loading mods

Steps to reproduce

its like that when i open the game, the only other mod i have is show player hand cards

Expected behavior

it should probably load properly

Logs / stack trace

MegaDot v4.5.1.m.9.mono.custom_build - https://godotengine.org
D3D12 12_0 - Forward+ - Using Device #0: AMD - AMD Radeon RX 5700
WARNING: PSO caching is not implemented yet in the Direct3D 12 driver.
   at: pipeline_cache_create (drivers/d3d12/rendering_device_driver_d3d12.cpp:4467)

FMOD Sound System: Successfully initialized
[INFO] Found release_info.json at: C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\release_info.json
[INFO] [Sentry.NET] Initialized: env=development, release=v0.103.2
[INFO] Steamworks: attempting initialization...
[INFO] Steam is running: True
[INFO] Steamworks initialization succeeded!
[INFO] Steam is enabled, we will write saves to steam storage. Enabled for account: True, app: False 
[INFO] Registered 11 migrations
[INFO] Current save versions: PrefsSave v2; ProfileSave v2; SerializableProgress v21; RunHistory v9; SerializableRun v16; SettingsSave v5
[INFO] Found mod manifest file C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\mods\STS2 RitsuLib-137-0-2-27-1778209417\mod_manifest.json
[INFO] Found mod manifest file C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\mods\STS2-ShowPlayerHandCards-169-0-5-2-1777655087\mod_manifest.json
[INFO] Loading assembly DLL C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\mods\STS2 RitsuLib-137-0-2-27-1778209417\STS2-RitsuLib.dll
[ERROR] Exception thrown while loading mod STS2-RitsuLib: System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' from assembly 'STS2-RitsuLib, Version=0.2.27.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
   at System.Reflection.RuntimeModule.GetDefinedTypes()
   at System.Reflection.RuntimeModule.GetTypes()
   at MegaCrit.Sts2.Core.Modding.ModManager.TryLoadMod(Mod mod)
System.TypeLoadException: Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' from assembly 'STS2-RitsuLib, Version=0.2.27.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
   at MegaCrit.Sts2.Core.Modding.ModManager.TryLoadMod(Mod mod)
   at MegaCrit.Sts2.Core.Modding.ModManager.Initialize(IModManagerFileIo fileIo, ModSettings settings)
   at MegaCrit.Sts2.Core.Helpers.OneTimeInitialization.ExecuteVeryEarly()
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartup()
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.Start[TStateMachine](TStateMachine& stateMachine)
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartup()
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartupWrapper()
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.Start[TStateMachine](TStateMachine& stateMachine)
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartupWrapper()
   at MegaCrit.Sts2.Core.Nodes.NGame._EnterTree()
   at Godot.Node.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at Godot.CanvasItem.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at Godot.Control.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at MegaCrit.Sts2.Core.Nodes.NGame.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at Godot.Bridge.CSharpInstanceBridge.Call(IntPtr godotObjectGCHandle, godot_string_name* method, godot_variant** args, Int32 argCount, godot_variant_call_error* refCallError, godot_variant* ret)

[ERROR] Tried to load mod STS2-ShowPlayerHandCards, but it depends on mods which have not been loaded: STS2-RitsuLib!
   at MegaCrit.Sts2.Core.Modding.ModManager.TryLoadMod(Mod mod)
   at MegaCrit.Sts2.Core.Modding.ModManager.Initialize(IModManagerFileIo fileIo, ModSettings settings)
   at MegaCrit.Sts2.Core.Helpers.OneTimeInitialization.ExecuteVeryEarly()
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartup()
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.Start[TStateMachine](TStateMachine& stateMachine)
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartup()
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartupWrapper()
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.Start[TStateMachine](TStateMachine& stateMachine)
   at MegaCrit.Sts2.Core.Nodes.NGame.GameStartupWrapper()
   at MegaCrit.Sts2.Core.Nodes.NGame._EnterTree()
   at Godot.Node.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at Godot.CanvasItem.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at Godot.Control.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at MegaCrit.Sts2.Core.Nodes.NGame.InvokeGodotClassMethod(godot_string_name& method, NativeVariantPtrArgs args, godot_variant& ret)
   at Godot.Bridge.CSharpInstanceBridge.Call(IntPtr godotObjectGCHandle, godot_string_name* method, godot_variant** args, Int32 argCount, godot_variant_call_error* refCallError, godot_variant* ret)

[INFO]  --- RUNNING MODDED! --- Loaded 0 mods (2 total)
[INFO] Syncing cloud save files to the local save directory
[WARN] Asset not cached: res://scenes/cards/card.tscn
[WARN] Asset not cached: res://scenes/cards/holders/grid_card_holder.tscn
[INFO] AtlasManager: Loaded ui_atlas with 102 sprites
[INFO] AtlasManager: Loaded compressed with 45 sprites
[INFO] Loading locale path=res://localization/eng
[INFO] ModelIdSerializationCache initialized. Categories: 19 Entries: 1611 Epochs: 57 Hash: 1357847701
[Sentry.GDExtension] Initialized: env=playtesters, release=v0.103.2
[INFO] Profile-scoped data path initialized: user://steam/76561198810326023/modded/profile1
[INFO] [Sentry.NET] Is running modded
[INFO] [Sentry.NET] Shutting down because event reporting is disabled.
[INFO] [Sentry.NET] Shutting down
[Sentry.GDExtension] Shutting down
[INFO] AtlasManager: Loaded controller_atlas with 112 sprites
[INFO] Applying display settings...
  FULLSCREEN: True
  ASPECT_RATIO: (SixteenByNine)
  TARGET_DISPLAY: (0)
  WINDOW_SIZE: (1920, 1080)
  POSITION: (-1, -1)
[INFO] [Display] Min size: (64, 64) Max size: (16384, 16384)
[INFO] Window changed! New size: (1920, 1061)
[INFO] [Display] Setting FULLSCREEN on Display: 1 of 1
[INFO] Window changed! New size: (1934, 1100)
[INFO] Window changed! New size: (1920, 1080)
[INFO] VSync: Adaptive
[INFO] SteamStatsManager: User stats received
[INFO] SteamStatsManager: Global stats received (found=True), architect damage = 192412490714
[INFO] Wrote 2527 bytes to path=user://steam/76561198810326023/settings.save save_dir=user://steam/76561198810326023
[INFO] Wrote 2527 bytes to settings.save in steam remote store
[INFO] === Godot OS Debug Information ===
Timestamp: 05/08/2026 00:33:24
OS: Windows
OS Version: 10.0.19045
Distribution Name: Windows
Device Model: A520M K V2
Is Debug Build: False
Is Sandboxed: False
Executable Path: C:/Program Files (x86)/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.exe
Data Directory: C:/Users/vital/AppData/Roaming
User Data Directory: C:/Users/vital/AppData/Roaming/SlayTheSpire2
Command Line Args: 
User Command Line Args: 
OS Locale: en_US
OS Language: en
Game Locale: en_US
Is UserFS Persistent: True
Is Stdout Verbose: False
Is Low Processor Usage Mode: False
Architecture: x86_64
Engine Version: 4.5.1-m.9 (custom_build)
Is Editor: False
Release Version: v0.103.2
Release Commit: 89765e1e
Release Date: 04/16/2026 21:53:23
Processor Count: 12
Processor Name: AMD Ryzen 5 5600 6-Core Processor
Main assembly hash: 1832700724
Rendering device name: AMD Radeon RX 5700
  Graphics adapter 0: AMD Radeon RX 5700
  version: 32.0.21043.0
  Graphics adapter 1: Microsoft Basic Render Driver
  version: 10.0.19041.0
Screen info (primary 0):
  Index 0: Size: (1920, 1080) Orientation: Landscape Scale: 1 DPI: 96 Refresh Rate: 144
Video Memory Used: 0.0B
Memory Info:
  physical: 31.9GB
  free: 19.8GB
  available: 33.9GB
  stack: 8.0MB
  Static Memory Usage: 0.0B
  Static Memory Peak Usage: 0.0B
Important Environment Variables:
  PATH: C:\Program Files\Common Files\Oracle\Java\javapath;C:\Program Files (x86)\Common Files\Oracle\Java\java8path;C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\Program Files (x86)\Razer Chroma SDK\bin;C:\Program Files\Razer Chroma SDK\bin;C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\System32\OpenSSH\;C:\Program Files\dotnet\;C:\Program Files\Microsoft SQL Server\150\Tools\Binn\;C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\170\Tools\Binn\;C:\Windows\system32\config\systemprofile\AppData\Local\Microsoft\WindowsApps;C:\Program Files (x86)\Razer\ChromaBroadcast\bin;C:\Program Files\Razer\ChromaBroadcast\bin;C:\Program Files\MySQL\MySQL Shell 8.0\bin\;C:\Users\vital\AppData\Local\Microsoft\WindowsApps;C:\Users\vital\AppData\Local\Muse Hub\lib;C:\Users\vital\.dotnet\tools;C:\Program Files (x86)\ZeroTier\One\;C:\Program Files\MySQL\MySQL Shell 8.0\bin\;C:\Users\vital\AppData\Local\Microsoft\WindowsApps;C:\Users\vital\AppData\Local\Muse Hub\lib;C:\Users\vital\.dotnet\tools
  GODOT_ROOT_DIR: 
  HOME: 
  DYLD_LIBRARY_PATH: 
  LD_LIBRARY_PATH: 

[INFO] Preloading 'IntroLogo' assets... count=3 vfx=0
[INFO] Preloading 'IntroLogo' Complete: assets=3 time_elapsed=51ms
[INFO] Preloading 'MainMenuEssentials' assets... count=5 vfx=0
[INFO] Preloading 'MainMenuEssentials' Complete: assets=5 time_elapsed=159ms
[WARN] Asset not cached: res://debug_audio/SOTE_Logo_Echoing_ShortTail.mp3
[INFO] [Startup] Time to main menu (Godot ticks): 6083ms
[INFO] [Startup] Time to main menu: 6,088ms
[INFO] [Startup] Resource stats (main menu loaded (essential)): StaticMem=0B, VRAM=273.6MB, Objects=8,152, Resources=477, Nodes=1,566, CachedAssets=10
[INFO] AtlasManager: Loaded epoch_atlas with 57 sprites
[INFO] AtlasManager: Loaded relic_atlas with 341 sprites
[INFO] AtlasManager: Loaded relic_outline_atlas with 341 sprites
[INFO] AtlasManager: Loaded power_atlas with 266 sprites
[INFO] AtlasManager: Loaded card_atlas with 864 sprites
[INFO] AtlasManager: Loaded potion_atlas with 63 sprites
[INFO] AtlasManager: Loaded potion_outline_atlas with 63 sprites
[INFO] AtlasManager: Loaded stats_screen_atlas with 16 sprites
[INFO] AtlasManager: Loaded intent_atlas with 310 sprites
[INFO] AtlasManager: Loaded era_atlas with 27 sprites
[INFO] Unloading 3 missed cache assets
[INFO] Preloading 'Common' assets... count=683 vfx=86
[INFO] [Startup] Resource stats (main menu loaded (complete)): StaticMem=0B, VRAM=477.7MB, Objects=8,130, Resources=476, Nodes=1,564, CachedAssets=5
[INFO] Preloading 'Common' Complete: assets=769 time_elapsed=3,362ms
[WARN] Asset not cached: res://scenes/screens/modding/modding_screen_row.tscn
[WARN] Asset not cached: res://images/ui/mods/folder.png
[INFO] Limiting background FPS to 30
[INFO] Restored foreground FPS
[INFO] Limiting background FPS to 30
[INFO] Restored foreground FPS
[INFO] Limiting background FPS to 30
[INFO] Restored foreground FPS
[INFO] Limiting background FPS to 30
[INFO] Restored foreground FPS
[INFO] Limiting background FPS to 30
[INFO] Restored foreground FPS
[INFO] Wrote 2527 bytes to path=user://steam/76561198810326023/settings.save save_dir=user://steam/76561198810326023
[INFO] Wrote 2527 bytes to settings.save in steam remote store
[INFO] Wrote 299 bytes to path=user://steam/76561198810326023/modded/profile1\saves\prefs.save save_dir=user://steam/76561198810326023
[INFO] Wrote 299 bytes to modded/profile1/saves/prefs.save in steam remote store
[INFO] Wrote 2527 bytes to path=user://steam/76561198810326023/settings.save save_dir=user://steam/76561198810326023
[INFO] Wrote 2527 bytes to settings.save in steam remote store
[INFO] Wrote 299 bytes to path=user://steam/76561198810326023/modded/profile1\saves\prefs.save save_dir=user://steam/76561198810326023
[INFO] Wrote 299 bytes to modded/profile1/saves/prefs.save in steam remote store
[INFO] Quit button pressed
[INFO] Quit confirmed
[INFO] NGame.Quit called
[INFO] Wrote 2527 bytes to path=user://steam/76561198810326023/settings.save save_dir=user://steam/76561198810326023
[INFO] Wrote 2527 bytes to settings.save in steam remote store
[INFO] Wrote 299 bytes to path=user://steam/76561198810326023/modded/profile1\saves\prefs.save save_dir=user://steam/76561198810326023
[INFO] Wrote 299 bytes to modded/profile1/saves/prefs.save in steam remote store
[INFO] Wrote 811 bytes to path=user://steam/76561198810326023/modded/profile1\saves\progress.save save_dir=user://steam/76561198810326023
[INFO] Wrote 811 bytes to modded/profile1/saves/progress.save in steam remote store
[INFO] Wrote 52 bytes to path=user://steam/76561198810326023/profile.save save_dir=user://steam/76561198810326023
[INFO] Wrote 52 bytes to profile.save in steam remote store
[INFO] Steamworks: shutting down...
[INFO] Steamworks shutdown succeeded!
FMOD Sound System: System released
WARNING: 1050 RIDs of type "CanvasItem" were leaked.
   at: _free_rids (servers/rendering/renderer_canvas_cull.cpp:2678)
ERROR: 1 RID allocations of type 'N26RendererEnvironmentStorage11EnvironmentE' were leaked at exit.
ERROR: 5 shaders of type CanvasShaderRD were never freed
   at: ~ShaderRD (servers/rendering/renderer_rd/shader_rd.cpp:1044)
ERROR: 30 RID allocations of type 'N10RendererRD16ParticlesStorage9ParticlesE' were leaked at exit.
ERROR: 1 shaders of type ParticlesShaderRD were never freed
   at: ~ShaderRD (servers/rendering/renderer_rd/shader_rd.cpp:1044)
ERROR: 30 RID allocations of type 'N10RendererRD11MeshStorage4MeshE' were leaked at exit.
ERROR: 125 RID allocations of type 'N10RendererRD15MaterialStorage8MaterialE' were leaked at exit.
ERROR: 6 RID allocations of type 'N10RendererRD15MaterialStorage6ShaderE' were leaked at exit.
ERROR: 25 RID allocations of type 'N10RendererRD14TextureStorage7TextureE' were leaked at exit.
WARNING: 245 RIDs of type "UniformBuffer" were leaked.
   at: _free_rids (servers/rendering/rendering_device.cpp:6981)
WARNING: 46 RIDs of type "Texture" were leaked.
   at: finalize (servers/rendering/rendering_device.cpp:7191)
ERROR: 360 RID allocations of type 'PN18TextServerAdvanced22ShapedTextDataAdvancedE' were leaked at exit.
ERROR: 3 RID allocations of type 'PN18TextServerAdvanced12FontAdvancedE' were leaked at exit.
ERROR: 4 RID allocations of type 'PN18TextServerAdvanced27FontAdvancedLinkedVariationE' were leaked at exit.
WARNING: ObjectDB instances leaked at exit (run with --verbose for details).
   at: cleanup (core/object/object.cpp:2514)
ERROR: 65 resources still in use at exit (run with --verbose for details).
   at: clear (core/io/resource.cpp:795)

RitsuLib version

lastest

Environment

windows 10

[ritsukage-local-analyzer]

Warning

此分析由 AI 自动生成，仅供开发者参考，最终判断请以人工确认为准。如有疑问建议结合本地环境进一步复现确认。

摘要

RitsuLib v0.2.27 在 STS2 游戏版本 v0.103.2 上加载失败，根因为 RuntimeTemplateBadge 类型中 RequiresWin 属性缺少实现（TypeLoadException）。这是由于编译时常量 STS2_AT_LEAST_0_104_0 条件分支导致的问题：当 DLL 以 0.104.0+ 为目标编译时，RequiresWin 在基类中是具体属性无需覆写；但在用户运行的 0.103.2 版本中该属性仍是抽象成员，运行时反射检测到缺失 override 即报错。建议立即检查 0.2.27 发布的 DLL 实际编译目标与 mod_manifest.json 中的 min_game_version 字段是否一致，并考虑同时发布面向 0.103.2 的兼容版本。

问题描述

期望行为

加载 RitsuLib 后游戏正常启动，其他依赖模组（如 ShowPlayerHandCards）可成功加载。

实际行为

游戏在启动时尝试加载 STS2-RitsuLib.dll 时抛出 System.Reflection.ReflectionTypeLoadException，提示 RuntimeTemplateBadge 类型的 get_RequiresWin 方法没有实现。RitsuLib 加载失败后，依赖它的 ShowPlayerHandCards 也连带失败，最终 Loaded 0 mods (2 total)。

复现步骤

1. 在 STS2 v0.103.2 上安装 RitsuLib v0.2.27（Thunderstore 渠道）
2. 同时安装 ShowPlayerHandCards（依赖 RitsuLib）
3. 启动游戏，观察控制台日志

环境与版本

项目	值
OS	Windows 10 (10.0.19045)
CPU	AMD Ryzen 5 5600
GPU	AMD Radeon RX 5700
游戏版本	v0.103.2 (commit 89765e1e, 2026-04-16)
引擎版本	Godot 4.5.1-m.9 (MegaDot custom_build)
RitsuLib 版本	0.2.27（用户标注 "lastest"）
其他模组	ShowPlayerHandCards（因依赖关系加载失败）

日志与附件

点击展开关键异常片段

[INFO] Loading assembly DLL ...\STS2-RitsuLib.dll
[ERROR] Exception thrown while loading mod STS2-RitsuLib: System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' from assembly 'STS2-RitsuLib, Version=0.2.27.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
   at System.Reflection.RuntimeModule.GetDefinedTypes()
   ...
System.TypeLoadException: Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' from assembly 'STS2-RitsuLib, Version=0.2.27.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
   ...
[ERROR] Tried to load mod STS2-ShowPlayerHandCards, but it depends on mods which have not been loaded: STS2-RitsuLib!
[INFO]  --- RUNNING MODDED! --- Loaded 0 mods (2 total)

反馈规范性提醒

模板覆盖情况

维度	状态	备注
复现步骤	已提供	"启动即发生" 已足够明确
期望/实际行为	已提供	期望正常加载，实际报错
环境与版本	已提供	完整系统信息和游戏版本均在日志中
日志/附件	已提供	完整启动日志附带截图
标题与背景	含糊	标题仅为 [Bug]，缺少对问题性质的概括

对报告者的可执行要求

• 请补充标题，例如 [Bug] RitsuLib 0.2.27 在 STS2 v0.103.2 上加载报错 TypeLoadException

原文摘录与理解

Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' does not have an implementation.

要点：C# 运行时在加载程序集时检测到 RuntimeTemplateBadge 继承自抽象基类 Badge，但未覆写抽象属性 RequiresWin 的 getter。

[ERROR] Tried to load mod STS2-ShowPlayerHandCards, but it depends on mods which have not been loaded: STS2-RitsuLib!

要点：连环失败——RitsuLib 加载失败后，所有依赖它的模组均被跳过。

分析

可能原因与涉及面

根因定位在 Scaffolding/Content/Patches/BadgeOverridePatches.cs 的条件编译逻辑与发布配置之间的不一致。

版本间 API 差异：

• v0.103.2：Badge.RequiresWin 声明为 public abstract bool RequiresWin { get; }——抽象属性，任何非抽象子类必须覆写。
• v0.104.0：Badge.RequiresWin 变为 public bool RequiresWin { get; }——具体自动属性，由构造函数赋值，子类不再需要覆写。
• v0.105.0（RitsuLibLatestApiCompat）：假定与 0.104.0 相同的 Badge 构造函数签名。

条件编译分支（BadgeOverridePatches.cs:122-183）：

编译符号范围	目标 API	RequiresWin 行为
!STS2_AT_LEAST_0_104_0	0.103.2	显式 public override bool RequiresWin ✅
STS2_AT_LEAST_0_104_0 && !STS2_AT_LEAST_0_105_0	0.104.0	不覆写（基类为具体属性）❌ 对 0.103.2
STS2_AT_LEAST_0_105_0	0.105.0	不覆写（基类为具体属性）❌ 对 0.103.2

故障链路：

1. STS2-RitsuLib.csproj 中 RitsuLibLatestApiCompat 设为 0.105.0，默认 Sts2ApiCompat 继承此值。
2. 若发布的 Thunderstore 包使用默认构建（即 Sts2ApiCompat=0.105.0），则 STS2_AT_LEAST_0_104_0 和 STS2_AT_LEAST_0_105_0 均被定义，进入 #else 分支，不生成 override RequiresWin。
3. 当此 DLL 被 v0.103.2 游戏加载时，运行时解析基类 Badge 来自游戏自身程序集（v0.103.2），其中 RequiresWin 仍为抽象属性，检测到未覆写即抛出 TypeLoadException。
4. mod_manifest.json 中的 min_game_version（构建时注入）可能缺失或未在游戏模组加载器中得到校验，导致不兼容的 DLL 被允许加载。

相关模块或配置（若可从上下文推断）

• Scaffolding/Content/Patches/BadgeOverridePatches.cs — RuntimeTemplateBadge 的三个 #if 分支
• build/RitsuLib.CompatDefines.targets — STS2_AT_LEAST_* 符号与 Sts2ApiCompat 的映射
• STS2-RitsuLib.csproj — RitsuLibLatestApiCompat 和默认 Sts2ApiCompat
• build/RitsuLib.ModManifest.targets — min_game_version 的注入逻辑
• scripts/release_lib/nuget.py — 多版本打包脚本，依次构建 0.105.0;0.104.0;0.103.2

验证建议

• 确认 0.2.27 Thunderstore 包中实际包含的 DLL 是用哪个 Sts2ApiCompat 编译的（可通过 ILSpy/dnSpy 查看 RuntimeTemplateBadge 是否有 override RequiresWin）。
• 在 v0.103.2 游戏上，以 Sts2ApiCompat=0.103.2 重新编译 RitsuLib DLL，替换到 mod 目录后验证加载正常。
• 检查 Thunderstore 包中 mod_manifest.json 是否包含 min_game_version 字段且其值与实际编译目标一致。
• 确认 STS2 模组加载器在 ModManager.TryLoadMod 阶段是否校验 min_game_version，若未校验则除修复 DLL 外还需考虑在清单中加入该字段作为防护。
• 验证 nuget.py 多版本构建产出的 0.103.2 对应 NuGet 包是否确实能正常工作。

风险与未决

• 无法从现有信息确定 0.2.27 发布包实际使用的 Sts2ApiCompat 值——需要检查 Thunderstore 上传的制品。
• 若 min_game_version 缺失而游戏加载器不校验，则未来每次以高版本 API 编译的 DLL 都可能被低版本游戏加载并崩溃，影响面不限本报告。
• 不排除打包流水线中 0.103.2 兼容包未被正确上传至 Thunderstore 的可能性。

---

English translation

Click to expand

Summary

RitsuLib v0.2.27 fails to load on STS2 game version v0.103.2 due to a TypeLoadException: the RequiresWin property in RuntimeTemplateBadge lacks an implementation. The root cause lies in the STS2_AT_LEAST_0_104_0 conditional compilation branch — when the DLL is compiled targeting API 0.104.0+, RequiresWin is a concrete property in the base class and requires no override; however, on the user's v0.103.2 runtime the property remains abstract, and the missing override triggers the reflection error. Immediately verify which Sts2ApiCompat value was used to build the released 0.2.27 DLL and whether mod_manifest.json contains a matching min_game_version. Consider publishing a compat build targeting 0.103.2.

Issue Description

Expected Behavior

RitsuLib loads successfully at game startup, and dependent mods (e.g., ShowPlayerHandCards) load without error.

Actual Behavior

During startup the game throws System.Reflection.ReflectionTypeLoadException when loading STS2-RitsuLib.dll, reporting that method get_RequiresWin in RuntimeTemplateBadge has no implementation. RitsuLib fails, and ShowPlayerHandCards — which depends on it — is also skipped. Result: Loaded 0 mods (2 total).

Steps to Reproduce

1. Install RitsuLib v0.2.27 (Thunderstore) on STS2 v0.103.2
2. Also install ShowPlayerHandCards (depends on RitsuLib)
3. Launch the game and observe the console log

Environment & Versions

Item	Value
OS	Windows 10 (10.0.19045)
CPU	AMD Ryzen 5 5600
GPU	AMD Radeon RX 5700
Game version	v0.103.2 (commit 89765e1e, 2026-04-16)
Engine version	Godot 4.5.1-m.9 (MegaDot custom_build)
RitsuLib version	0.2.27 (user marked "lastest")
Other mods	ShowPlayerHandCards (failed due to missing dependency)

Logs & Attachments

Click to expand — key exception fragment

[INFO] Loading assembly DLL ...\STS2-RitsuLib.dll
[ERROR] Exception thrown while loading mod STS2-RitsuLib: System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' from assembly 'STS2-RitsuLib, Version=0.2.27.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
   at System.Reflection.RuntimeModule.GetDefinedTypes()
   ...
System.TypeLoadException: Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' from assembly 'STS2-RitsuLib, Version=0.2.27.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
   ...
[ERROR] Tried to load mod STS2-ShowPlayerHandCards, but it depends on mods which have not been loaded: STS2-RitsuLib!
[INFO]  --- RUNNING MODDED! --- Loaded 0 mods (2 total)

Reporter Hygiene Notes

Template Coverage

Dimension	Status	Note
Repro steps	Provided	"Happens on launch" is sufficiently clear
Expected/Actual behavior	Provided	Expected normal load, got error
Environment & version	Provided	Full system info and game version in logs
Logs/attachments	Provided	Full startup log with screenshot
Title & background	Vague	Title is just [Bug] with no summary of the problem

Actionable Requests for Reporter

• Please update the title, e.g., [Bug] RitsuLib 0.2.27 fails to load on STS2 v0.103.2 with TypeLoadException

Key Excerpts

Method 'get_RequiresWin' in type 'STS2RitsuLib.Scaffolding.Content.Patches.RuntimeTemplateBadge' does not have an implementation.

The C# runtime detected that RuntimeTemplateBadge inherits from abstract base class Badge but does not override the abstract RequiresWin getter.

[ERROR] Tried to load mod STS2-ShowPlayerHandCards, but it depends on mods which have not been loaded: STS2-RitsuLib!

Cascade failure — after RitsuLib fails, all dependent mods are skipped.

Analysis

Probable Cause & Scope

Root cause is a mismatch between the conditional compilation logic in Scaffolding/Content/Patches/BadgeOverridePatches.cs and the release build configuration.

Cross-version API differences:

• v0.103.2: Badge.RequiresWin is public abstract bool RequiresWin { get; } — abstract, must be overridden.
• v0.104.0: Badge.RequiresWin changed to public bool RequiresWin { get; } — concrete auto-property, set via constructor.
• v0.105.0 (RitsuLibLatestApiCompat): Assumed same Badge constructor signature as 0.104.0.

Conditional compilation branches (BadgeOverridePatches.cs:122-183):

Symbol range	Target API	RequiresWin behavior
!STS2_AT_LEAST_0_104_0	0.103.2	Explicit public override bool RequiresWin ✅
STS2_AT_LEAST_0_104_0 && !STS2_AT_LEAST_0_105_0	0.104.0	No override (base is concrete) ❌ for 0.103.2
STS2_AT_LEAST_0_105_0	0.105.0	No override (base is concrete) ❌ for 0.103.2

Failure chain:

1. STS2-RitsuLib.csproj sets RitsuLibLatestApiCompat to 0.105.0; default Sts2ApiCompat inherits this.
2. If the published Thunderstore package uses the default build (Sts2ApiCompat=0.105.0), both STS2_AT_LEAST_0_104_0 and STS2_AT_LEAST_0_105_0 are defined, landing in the #else branch which produces no override RequiresWin.
3. When this DLL is loaded by the v0.103.2 game, the runtime resolves base class Badge from the game's own assembly (v0.103.2), where RequiresWin is still abstract. The missing override triggers TypeLoadException.
4. mod_manifest.json may lack a min_game_version field, or the game's mod loader may not enforce it, allowing the incompatible DLL to load.

Relevant Modules / Configuration

• Scaffolding/Content/Patches/BadgeOverridePatches.cs — three #if branches for RuntimeTemplateBadge
• build/RitsuLib.CompatDefines.targets — maps Sts2ApiCompat to STS2_AT_LEAST_* symbols
• STS2-RitsuLib.csproj — RitsuLibLatestApiCompat and default Sts2ApiCompat
• build/RitsuLib.ModManifest.targets — min_game_version injection logic
• scripts/release_lib/nuget.py — multi-version packaging script iterating over 0.105.0;0.104.0;0.103.2

Verification Checklist

• Confirm which Sts2ApiCompat value was used to compile the actual DLL inside the 0.2.27 Thunderstore package (use ILSpy/dnSpy to check whether RuntimeTemplateBadge has override RequiresWin).
• Rebuild the RitsuLib DLL with Sts2ApiCompat=0.103.2, swap into the mod directory on a v0.103.2 game, and verify it loads correctly.
• Check whether the Thunderstore package's mod_manifest.json contains a min_game_version field that matches the actual build target.
• Confirm whether STS2's ModManager.TryLoadMod enforces min_game_version; if not, adding it to the manifest would serve as a safeguard even if the DLL issue is fixed.
• Verify that the 0.103.2-targeted NuGet package produced by nuget.py multi-version builds actually works when installed.

Risks & Open Questions

• Cannot determine from available information which Sts2ApiCompat value was used for the published 0.2.27 artifact — the Thunderstore upload itself needs inspection.
• If min_game_version is missing and the game loader does not enforce it, any future DLL compiled against a higher API version may crash on older game versions, with impact beyond this single report.
• It is possible that the 0.103.2 compat package is built correctly by the pipeline but was not uploaded to Thunderstore.

---

工具侧记录

• BAKAOLC/STS2-RitsuLib#34 · 退出码 0 · 进程 314.87s
• deepseek-v4-pro · API 312500ms · 22 轮 · ↓71406 ↑10375 · 缓存读561792 写0 · $0.8973

[Haidex]

this is a bit much to me, what exactly am i meant to do to fix this, sorry its a little confusing

[BAKAOLC]

Oh, that was an AI automatic analysis; you don't need to pay too much attention to it.
Apologies for the delay in responding. I would like to know which version of RitsuLib you downloaded and are using?

Your game is version 0.103.2, which is the release branch.
You should download and use the STS2.RitsuLib.Compat.0.103.2.0.2.28.github.zip version to run it.
Because the main branch is targeted at the latest version, which is currently 0.105.0 (the beta branch).

If you find switching versions troublesome or are unsure which version to download, I recommend using STS2-RitsuLib.0.2.28.variant-pack.zip
This includes an automatic discrimination loader for the release and beta branches, enabling it to automatically load different versions of RitsuLib based on the specific branch.
I hope this helps you.

The current file naming of this dependency library is indeed quite confusing; I will try to improve it in the future

[Haidex]

the version i was using 0.2.27, thanks for the help! it works now!

[BAKAOLC]

the version i was using 0.2.27, thanks for the help! it works now!

I'm glad I could help! Enjoy the game!