1A2 - API文档汉化 - 添加文本重定向功能
Updated a week ago添加文本重定向功能
磐石之身(Made of Stone)是一项原版(vanilla)能力,可抵消臭臭(Stinky)和死神之触(Touch of Death)的效果。这是一个能力行为直接关联其他能力的典型案例,在模组开发过程中,您可能会创建类似的功能,无论是能力、属性图标还是其他元素。
在此类情况下,您可能希望让玩家能便捷查看关联能力的效果,而非迫使他们翻阅整个规则书来回忆相关描述。
此时API便可发挥作用。
当创建能力、属性图标、奖励、道具或自定义规则书页面时,您可以在描述文本中将特定词语或短语标记为页面重定向。这些功能类似于互联网上的超链接:被标记的词语会显示为彩色带下划线样式,右键点击后将跳转至其他规则书页面。
例如,若要使磐石之身关联到臭臭和死神之触,您需要执行以下操作:
AbilityInfo info = AbilitiesUtil.GetInfo(Ability.MadeOfStone);
// 注意:提供的字符串区分大小写——若传入"touch of death"将无法生效
info.SetAbilityRedirect("Touch of Death", Ability.Deathtouch, GameColors.Instance.red);
info.SetAbilityRedirect("Stinky", Ability.DebuffEnemy, GameColors.Instance.orange);
完成设置后,当您打开磐石之身页面时,“Stinky”一词将显示为橙色并重定向至臭臭页面,“Touch of Death”将显示为红色并重定向至死神之触页面。
重定向功能同样适用于属性图标、道具、奖励和卡槽修改:
AbilityInfo info = AbilitiesUtil.GetInfo(Ability.MadeOfStone);
info.SetBoonRedirect("effects", BoonData.Type.DoubleDraw, GameColors.Instance.gray);
StatIconInfo stat = StatIconManager.AllStatIconInfos.Find(x => x.iconType == SpecialStatIcon.Ants);
stat.SetItemRedirect("represented", "Harpy Fan", GameColors.Instance.brightLimeGreen);
若需将重定向指向自定义规则书页面,可使用SetUniqueRedirect方法,此时需提供与自定义规则书页面pageId
对应的字符串,而非Ability或Boon.Type枚举值。
文本颜色设置
如您所见,每个重定向方法都需传入Color参数。该参数用于改变文本颜色以标识可点击文本。上述示例仅使用了《邪恶冥刻》内置颜色,但您也可以创建并传入自定义颜色值。
需特别注意:并非所有颜色都能正常显示,尤其在第一章场景中受光照影响。虽然非典型颜色在各章节的兼容性尚未完全测试,但已确认第一章场景中蓝色文本会渲染为绿色,且白色与黄色文本在常规光照下会呈现透明效果。
Pages
- 0 - 邪恶冥刻模组简体中文语言包Wiki
- 100 - API文档汉化 - 首页
- 110 - API文档汉化 - 入门指南
- 120 - API文档汉化 - 卡牌
- 121 - API文档汉化 - 自定义卡牌费用系统
- 122 - API文档汉化 - 会说话的卡牌
- 123 - API文档汉化 - 自定义毛皮
- 130 - API文档汉化 - 能力
- 131 - API文档汉化 - 自定义触发器
- 132 - API文档汉化 - 自定义狙击逻辑
- 133 - API文档汉化 - 伤害护盾行为
- 134 - API文档汉化 - 卡槽修改功能
- 135 - API文档汉化 - 触发器与执行顺序
- 140 - API文档汉化 - 自定义/扩展属性
- 150 - API文档汉化 - 扬升(凯茜模组)
- 160 - API文档汉化 - 地图与遭遇战
- 170 - API文档汉化 - 对手
- 180 - API文档汉化 - 图腾
- 190 - API文档汉化 - 道具
- 1A0 - API文档汉化 - 规则书
- 1A1 - API文档汉化 - 添加自定义页面
- 1A2 - API文档汉化 - 添加文本重定向功能
- 1B0 - API文档汉化 - 资产包
- 1B0 - API文档汉化 - 本地化
- 1B0 - API文档汉化 - 声音
- 1C0 - API文档汉化 - 其他特性
- 200 - JSONLoader文档汉化 - Wiki
- 201 - JSONLoader文档汉化 - 枚举值