140 - API文档汉化 - 自定义/扩展属性

Updated a week ago

自定义/扩展属性

本API实现了一套自定义属性系统,您可将其添加至CardInfo、AbilityInfo及CardModificationInfo中,并按需调用。

正如您可通过Evolve参数使进化能力生效,或通过Ice Cube参数使IceCube能力生效一样,此系统允许您设置自定义参数以实现自定义能力功能。


// 向CardInfo添加自定义属性
CardInfo sample = CardLoader.CardByName("MyCustomCard");
sample.SetExtendedProperty("CustomPropertyName", "CustomPropertyValue");

string propValue = sample.GetExtendedProperty("CustomPropertyName");

保留属性

部分扩展属性被API保留用于特定用途。 以下是为您的卡牌可使用的部分扩展属性。

若您使用C#,可通过相应的setter方法设置这些属性,并通过对应的getter方法调用这些属性。 对于JsonLoader用户,这些属性的访问方式与其他扩展属性相同。

注意:属性名称区分大小写。

属性名称 作用类型 值类型 描述 扩展方法
TriggersOncePerStack AbilityInfo 布尔值 当卡牌进化时,该能力是否应触发两次。 SetTriggersOncePerStack
HideSingleStacks AbilityInfo 布尔值 隐藏能力时,应隐藏该能力所有的叠加还是每次仅隐藏一个。 SetHideSingleStacks
AffectedByTidalLock CardInfo 布尔值 该卡牌是否应被潮汐锁定(Tidal Lock)效果消灭。 SetAffectedByTidalLock
TransformerCardId CardInfo 字符串 当该卡牌具有易形者(Transformer)印记时,将变形为此字段指定的卡牌名称。 SetTransformerCardId
RemoveGreenGem CardModificationInfo 布尔值 移除卡牌上的绿色玛珂(Green Mox)。 RemoveGreenGemCost*
RemoveOrangeGem CardModificationInfo 布尔值 移除卡牌上的橙色玛珂(Orange Mox)。 RemoveOrangeGemCost*
RemoveBlueGem CardModificationInfo 布尔值 移除卡牌上的蓝色玛珂(Blue Mox)。 RemoveBlueGemCost*
  • 您亦可使用RemoveGemsCost一次性移除多个玛珂