添加卡牌属性
添加新卡牌关键词
这里的关键词指的是消耗，虚无一类的卡牌属性。RitsuLib没有customenum，但是统一管理。
1
2
3
4
5
6
7
| [RegisterOwnedCardKeyword(nameof(Unique), IconPath = "res://icon.svg", CardDescriptionPlacement = ModKeywordCardDescriptionPlacement.BeforeCardDescription)]
public class MyKeywords
{
public static readonly string Unique = ModContentRegistry.GetQualifiedKeywordId(Entry.ModId, nameof(Unique));
}
|
CardDescriptionPlacement代表这个关键词的描述加在卡牌的位置。BeforeCardDescription表示在描述之前。默认不显示。
IconPath和CardDescriptionPlacement都是可选的。
添加一个本地化文件，{modId}/localization/{Language}/card_keywords.json。使用的键是TEST_KEYWORD_{id大写}。
1
2
3
4
| {
"TEST_KEYWORD_UNIQUE.description": "卡组中只能有一张同名牌。",
"TEST_KEYWORD_UNIQUE.title": "唯一"
}
|
- 然后在你的卡牌类里添加这一行添加自定义keyword：
1
| protected override IEnumerable<string> RegisteredKeywordIds => [MyKeywords.Unique];
|
判断是否有：card.HasModKeyword(MyKeywords.Unique)
![alt text]()
添加新动态变量
动态变量是指伤害，格挡，抽牌数，获得能量数等这种动态数值。虽然可以通过new DynamicPower("xxx", 1)这种形式添加，但是写一个新的类比较规范也便于扩展功能。参考变量与描述这章。
通过ritsulib的WithSharedTooltip可以添加tooltip。如果不需要添加本地化文本，就不添加这行。
如果你只是个简单的数值，这样就行：
1
2
3
4
5
| protected override IEnumerable<DynamicVar> CanonicalVars => [
new DamageVar(12, ValueProp.Move),
ModCardVars.Int("Leech", 3)
];
|
（可选）然后添加一个新的本地化文件{modId}/localization/{Language}/static_hover_tips.json。
1
2
3
4
| {
"TEST_LEECH.description": "吸取等量生命。",
"TEST_LEECH.title": "汲取"
}
|
然后在卡牌的描述写上{Leech}以使用：
1
2
3
4
| {
"TEST_CARD_TEST_CARD.title": "测试卡牌",
"TEST_CARD_TEST_CARD.description": "[gold]汲取[/gold]{Leech:diff()}。\n造成{Damage:diff()}点伤害。"
}
|
:diff()表示这个值一旦和基础值不同，就会变红色或绿色（例如升级时增加数值，预览变成绿色）。
简单来说效果可以在OnPlay这么写，或者写一个自己的Cmd方便执行效果：
1
2
3
4
|
await CreatureCmd.Damage(choiceContext, [cardPlay.Target!], DynamicVars["Leech"].BaseValue, ValueProp.Unblockable | ValueProp.Unpowered, cardPlay.Card.Owner.Creature);
await CreatureCmd.Heal(cardPlay.Card.Owner.Creature, DynamicVars["Leech"].BaseValue);
|
![alt text]()
添加卡牌提示文本
指的是卡牌旁出现的提示方框，或预览卡牌。在描述里的关键词一般是添加提示文本和染色搭配，例如易伤，激发等。
和塔1不同，关键词提示是通过描述染色（[gold]易伤[/gold]）然后添加卡牌提示文本实现的。
例如，你给卡牌加上消耗就会自动给你加它的提示文本。但是如果你的卡牌没有消耗但是描述中是“消耗一张牌”，就通过这种方式添加提示文本。
仅需在卡牌类中重载AdditionalHoverTips即可：
1
2
3
4
5
6
7
8
9
10
11
12
13
| [RegisterCard(typeof(TestCardPool))]
public class TestCard : ModCardTemplate
{
protected override IEnumerable<IHoverTip> AdditionalHoverTips => [
HoverTipFactory.FromCard<Shiv>(),
HoverTipFactory.FromPower<TestPower>(),
HoverTipFactory.FromKeyword(CardKeyword.Exhaust),
];
}
|
添加卡牌tag
tag是指打击 防御这种。如果有打击tag会被打击木偶增伤。
1
2
3
4
5
6
7
8
| [RegisterOwnedCardTag(nameof(Heavy))]
public class MyTags
{
public static readonly string Heavy = ModContentRegistry.GetQualifiedCardTagId(Entry.ModId, nameof(Heavy));
}
|
然后在你的卡牌类里添加：
1
| protected override IEnumerable<string> RegisteredCardTagIds => [MyTags.Heavy];
|
需要使用时这么写。Card需要是个CardModel类型。
1
2
3
4
| if (cardPlay.Card.HasModCardTag(MyTags.Heavy))
{
}
|
