BaseLib 至 RitsuLib

将你的BaseLib开发的mod与RitsuLib开发的mod相互迁移的指南。

注册内容

两个库都支持自动注册内容。

baselib:

1
2

[Pool(typeof(TestCardPool))]
public class TestCard : CustomCardModel {} // 其他内容同等换成CustomXXXModel

ritsulib:

需要先在初始化函数(Entry.Init)中调用ModTypeDiscoveryHub.RegisterModAssembly。同时也支持显式注册。

1
2

[RegisterCard(typeof(TestCardPool))] // 其他内容同等换成RegisterXXX
public class TestCard : ModCardTemplate {} // 其他内容同等换成ModXXXTemplate

ID

除了关键词，

baselib使用{命名空间第一段大写}-{原卡牌id}的写法，例如TEST-TEST_CARD。

ritsulib使用{ModId}_{类别}_{原卡牌id}的写法，例如TEST_CARD_TEST_CARD。

变量对照

注册与基类

关键词、动态变量

人物、卡池

遗物、药水、能力、充能球

事件、遭遇、先古之民

遗物、卡牌升级

baselib:

古老牙齿可以把一张初始卡变成先古升级。需要实现ITranscendenceCard接口，在你的卡牌类添加以下代码：

1 2 3 4 5 6

[Pool(typeof(TestCardPool))] public class TestCard : CustomCardModel, ITranscendenceCard // 实现接口 { // 其余省略 public CardModel GetTranscendenceTransformedCard() => ModelDb.Card<TestCard2>(); // 实现方法。自己更改类型。 }

欧洛巴斯之触可以把初始遗物升级。

1 2 3 4 5 6

[Pool(typeof(TestRelicPool))] public class TestRelic : CustomRelicModel { // 其余省略 public override RelicModel? GetUpgradeReplacement() => ModelDb.Relic<TestRelic2>(); // 实现方法。自己更改类型。 }

尘封魔典可以获得一张先古卡。这个结果是从你池子里选出所有先古卡，然后去除古老牙齿的那张得到的。所以只需再创建一张先古卡即可。

ritsulib:

给你待变化的卡牌类或者遗物类加上这两个特性：

1
2
3

[RegisterCard(typeof(TestCardPool))]
[RegisterArchaicToothTranscendence(typeof(Shiv))] // 让古老牙齿把这张牌变化成指定类型
public class TestCard : ModCardTemplate {}

1
2
3

[RegisterRelic(typeof(TestRelicPool))]
[RegisterTouchOfOrobasRefinement(typeof(Akabeko))] // 让欧洛巴斯之触把这个遗物变化成指定类型
public class TestRelic : ModRelicTemplate {}

或者在你的Init初始化函数中加上：

1
2
3
4
5
6

public static void Init()
{
    // 其余省略
    RitsuLibFramework.RegisterArchaicToothTranscendenceMapping<TestCard, Shiv>();
    RitsuLibFramework.RegisterTouchOfOrobasRefinementMapping<TestRelic, Akabeko>();
}

场景

baselib已支持大部分场景自动转换，即你不需要挂载任何脚本或唯一化命名。

ritsulib支持半自动转换，例如角色类里重载TryCreateCreatureVisuals。能量表盘全自动转换。