sts2_api_reference

STS2 反编译 API 参考

自动生成，来源：sts2.dll 反编译（ilspycmd v9.1.0） 只保留签名，不含方法体实现 游戏路径：见 config.json sts2_path 字段

⚡ 完整反编译源码（优先用这里，不要跑 ilspycmd）

反编译目录路径由 config.json 的 decompiled_src_path 字段配置，已在你的 prompt 的 API Lookup 段注入。 若该段显示"NOT available"，运行 python scripts/decompile_sts2.py --game-path <STS2路径> 生成。

常用子目录（在配置的反编译目录下）：

MegaCrit.Sts2.Core.Commands\      ← DamageCmd, CardCmd, CardSelectCmd, RelicSelectCmd, PowerCmd...
MegaCrit.Sts2.Core.Models.Cards\  ← StrikeIronclad, 所有原版卡牌完整实现
MegaCrit.Sts2.Core.Models\        ← AbstractModel, RelicModel, CardModel, ModelDb
MegaCrit.Sts2.Core.Entities.Players\   ← Player
MegaCrit.Sts2.Core.CardSelection\      ← CardSelectorPrefs

只有在反编译目录里找不到时才用 ilspycmd。

---

官方参照实现（直接抄，不用反编译）

Attack 卡标准实现 — StrikeIronclad（原版基础攻击卡）

// 来源：sts2.dll MegaCrit.Sts2.Core.Models.Cards.StrikeIronclad（完整实现）
using System.Collections.Generic;
using System.Threading.Tasks;
using MegaCrit.Sts2.Core.Commands;                 // DamageCmd
using MegaCrit.Sts2.Core.Entities.Cards;           // CardType, CardRarity, TargetType, CardTag
using MegaCrit.Sts2.Core.GameActions.Multiplayer;  // PlayerChoiceContext, CardPlay
using MegaCrit.Sts2.Core.Localization.DynamicVars; // DamageVar
using MegaCrit.Sts2.Core.ValueProps;               // ValueProp

namespace MegaCrit.Sts2.Core.Models.Cards;

public sealed class StrikeIronclad : CardModel
{
    protected override HashSet<CardTag> CanonicalTags => new HashSet<CardTag> { CardTag.Strike };

    // DamageVar(baseValue, ValueProp.Move) — 伤害值，跟随力量/虚弱/脆弱自动计算
    protected override IEnumerable<DynamicVar> CanonicalVars =>
        [new DamageVar(6m, ValueProp.Move)];

    public StrikeIronclad()
        : base(1, CardType.Attack, CardRarity.Basic, TargetType.AnyEnemy) { }

    protected override async Task OnPlay(PlayerChoiceContext choiceContext, CardPlay cardPlay)
    {
        ArgumentNullException.ThrowIfNull(cardPlay.Target, "cardPlay.Target");
        await DamageCmd.Attack(base.DynamicVars.Damage.BaseValue)
            .FromCard(this)
            .Targeting(cardPlay.Target)
            .WithHitFx("vfx/vfx_attack_slash")   // 可选：命中特效
            .Execute(choiceContext);
    }

    protected override void OnUpgrade()
    {
        base.DynamicVars.Damage.UpgradeValueBy(3m);  // 6 → 9
    }
}