卡牌动态变量
当卡牌描述中需要显示运行时变化的数值时,使用 ModCardVars。
using MegaCrit.Sts2.Core.Localization.DynamicVars;using STS2RitsuLib.Cards.DynamicVars;
public sealed class MyStrike : ModCardTemplate(1, CardType.Attack, CardRarity.Common, TargetType.SingleEnemy){ public override DynamicVarSet DynamicVars => new() { ModCardVars.Int("damage", Damage), ModCardVars.Computed("block", 3, card => card?.Upgraded == true ? 5 : 3), };}然后在 cards.json 中使用这些变量名,例如 造成 {damage} 点伤害。获得 {block} 点格挡。
值已经存在于卡牌上时,用普通 IntVar。显示值依赖目标、升级状态或预览模式时,用 ComputedDynamicVar。
添加 Tooltip
Section titled “添加 Tooltip”可以直接给动态变量挂 hover tip。
ModCardVars.Int("heat", Heat) .WithSharedTooltip("MY_MOD_HEAT", "res://MyMod/images/ui/heat.png");它读取 static_hover_tips 中的 key:
{ "MY_MOD_HEAT.title": "热量", "MY_MOD_HEAT.description": "部分卡牌会根据当前热量改变效果。"}需要自定义布局时,传入 .WithTooltip(var => new HoverTip(...)) 工厂。
当卡牌或效果需要读取另一张牌的动态变量时,使用扩展方法:
var amount = card.DynamicVars.GetIntOrDefault("damage");var hasHeat = card.DynamicVars.HasPositiveValue("heat");变量不存在时这些方法会返回默认值,通常比假定每张牌都有你的变量更稳。
ComputedDynamicVar 可以传入 preview factory:
ModCardVars.Computed( "damage", Damage, (card, target) => ResolveDamage(card, target), (card, mode, target, runGlobalHooks) => ResolvePreviewDamage(card, mode, target));当卡牌预览、目标预览或升级预览需要显示不同于当前实卡的值时,再写 preview 逻辑。