FuYnAloft.Sts2.References 0.105.0-beta

Languages: English, 简体中文.

Slay the Spire 2 Modding References

Stripped reference assemblies for Slay the Spire 2 modding. Specifically designed for CI/CD (Continuous Integration) environments and automated builds.

Important Notes

• Stripped Only (No Publicize): These assemblies have been processed using JetBrains.Refasmer. All method bodies (IL code) have been removed, but original access modifiers (private, internal, etc.) are completely retained.
• GodotSharp is NOT included: To avoid library conflicts, GodotSharp.dll is omitted. Please ensure your project uses the standard <Project Sdk="Godot.NET.Sdk/4.5.1"> to resolve Godot dependencies.
• No Game Logic: You cannot play or run the game using these files.

Versioning & Steam Branches

As the game is currently in Early Access (EA) and updates frequently, this package strictly follows the game's Steam branches:

• Default Branch: Published as standard stable versions (e.g., 0.103.2).
• public-test Branch: Published as pre-release versions with a -beta suffix (e.g., 0.105.0-beta).

Auto-updating using Wildcards: You can use NuGet wildcards in your .csproj to automatically fetch the latest references without manually changing version numbers:

Use * to target the latest Default branch.

<PackageReference Include="FuYnAloft.Sts2.References" Version="*" PrivateAssets="all" />

Use *-* to target the latest public-test branch.

<PackageReference Include="FuYnAloft.Sts2.References" Version="*-*" PrivateAssets="all" />

How to Use (Seamless CI/CD Integration)

In a typical mod project, you reference the local game assemblies via <HintPath> during local development.

You can use MSBuild Condition attributes to automatically switch to this NuGet package when building on a CI server. Most CI platforms automatically set the CI=true environment variable.

Update your .csproj file like this:

<ItemGroup Condition="'$(CI)' != 'true'">
    <Reference Include="0Harmony">
        <HintPath>$(Sts2DataDir)/0Harmony.dll</HintPath>
        <Private>false</Private>
    </Reference>
    <Reference Include="sts2">
        <HintPath>$(Sts2DataDir)/sts2.dll</HintPath>
        <Private>false</Private>
    </Reference>
    
</ItemGroup>


<ItemGroup Condition="'$(CI)' == 'true'">
    
    <PackageReference Include="FuYnAloft.Sts2.References" Version="*-*" PrivateAssets="all" />
</ItemGroup>

Disclaimer

This is an unofficial, community-provided package. All intellectual property rights and copyrights of the game metadata belong to Mega Crit. This package is created solely to facilitate the modding community's build pipelines and does not distribute any playable game assets.

杀戮尖塔 2 模组引用程序集

这是 《杀戮尖塔 2》 模组开发引用程序集包。 主要用于解决 CI/CD（如 GitHub Actions）环境下的自动化编译报错问题。

核心须知

• 仅剥离，未公开化： 本包使用 JetBrains.Refasmer 进行了剥离处理。所有的实现代码（IL）均已清空，但完全保留了原本的 private 和 internal 等访问修饰符，未进行 Publicize 处理。
• 不包含 GodotSharp： 为了防止与本地或 CI 环境的 Godot SDK 冲突，本包不包含 GodotSharp.dll。请在你的项目中通过 <Project Sdk="Godot.NET.Sdk/4.5.1"> 自动获取 Godot 依赖。
• 无游戏逻辑： 本包只包含函数签名（元数据），无法用于运行游戏。

版本号与 Steam 分支说明

由于游戏目前处于 EA（抢先体验）阶段，更新非常频繁。本引用包的版本号与 Steam 上的游戏分支严格对应：

• 默认公开分支 (Default): 采用标准稳定版本号（例如 0.103.2）。
• public-test 测试分支: 采用带有 -beta 后缀的预发布版本号（例如 0.105.0-beta）。

使用通配符自动同步最新版： 强烈建议利用 NuGet 的通配符机制。这样每当游戏更新且本包同步后，你的项目会自动拉取最新引用，无需手动改代码：

使用 * 为最新“默认公开分支”开发。

<PackageReference Include="FuYnAloft.Sts2.References" Version="*" PrivateAssets="all" />

使用 *-* 为最新“ public-test 测试分支”开发。

<PackageReference Include="FuYnAloft.Sts2.References" Version="*-*" PrivateAssets="all" />

如何使用 (本地与 CI 自动切换)

在日常开发中，我们通常会在本地通过 <HintPath> 引用完整的游戏程序集。

为了做到“本地用完整版，云端用 NuGet 引用版”，你可以利用 MSBuild 的 Condition 属性配合环境变量进行自动切换。主流 CI 平台在运行时都会自动设置环境变量 CI=true。

请将你的 Mod 项目文件 (.csproj) 修改为如下结构：

<ItemGroup Condition="'$(CI)' != 'true'">
    <Reference Include="0Harmony">
        <HintPath>$(Sts2DataDir)/0Harmony.dll</HintPath>
        <Private>false</Private>
    </Reference>
    <Reference Include="sts2">
        <HintPath>$(Sts2DataDir)/sts2.dll</HintPath>
        <Private>false</Private>
    </Reference>
    
</ItemGroup>


<ItemGroup Condition="'$(CI)' == 'true'">
    
    <PackageReference Include="FuYnAloft.Sts2.References" Version="*-*" PrivateAssets="all" />
</ItemGroup>

免责声明

本包为社区非官方维护的辅助工具。 游戏中所有的元数据及结构版权均归属于 Mega Crit。本包的发布仅为方便模组社区的自动化工程建设，绝对不包含任何可运行的盗版游戏资产。