0.4.20

• ModelCapability Added a IModelCapabilityRunLoadNotification interface to allow abilities to execute custom logic when saving/loading.
• Fixed the append logic of EventModel to ensure it can be correctly appended to the list.

---

• ModelCapability 增加了一个 IModelCapabilityRunLoadNotification 接口，以允许能力在存读档时执行自定义逻辑
• 修复了 EventModel 的追加逻辑，以确保其能够正确地被追加到列表中

---

Full Changelog: v0.4.19...v0.4.20

0.4.19

• Optimized and adjusted the drawing logic of the blood bar prediction display system to resolve rendering errors of some rendering styles and fix some rendering logic defects.
• Added the ICardOnPlayHookListener interface to allow cards to execute custom logic after OnPlay completes.
  • Correspondingly, fixed the implementation of CardPlayCapability, changed from AfterCardPlayed to the above interface implementation to ensure semantic correctness, but actual behavior may differ from before.
• Added the ICardTitleContributor interface to allow powers to custom modify card titles.
• Added the ModSecondaryResourceRegistry.CreateHoverTip wrapper method to easily create secondary resource HoverTip.
• Applied an additional interface wrapper to the deprecated StartingDeckTypes, StartingRelicTypes, StartingPotionTypes.
  • This will allow complete replacement and use of a Model that conforms to the vanilla interface as the return value to solve the problem that the Type type is not convenient for providing additional data decoration.

---

• 优化调整了血条预测显示系统的绘制逻辑，以解决部分渲染样式的渲染错误并修正了部分渲染逻辑缺陷
• 增加了 ICardOnPlayHookListener 接口，以允许卡牌在 OnPlay 完成后执行自定义逻辑
  • 相对的，修正了 CardPlayCapability 的实现方式，从 AfterCardPlayed 改为了以上接口实现以确保语义正确性，但可能实际表现与之前不同
• 增加了 ICardTitleContributor 接口，以允许能力对卡牌标题进行自定义修饰
• 补充了 ModSecondaryResourceRegistry.CreateHoverTip 包装方法，以简便的创建次级资源 HoverTip
• 对弃用的 StartingDeckTypes、StartingRelicTypes、StartingPotionTypes 套用了一个额外的接口包装
  • 这将允许对其进行完整替换并使用符合原版接口的 Model 作为返回值以解决 Type 类型不便于提供额外的数据修饰的问题

---

Full Changelog: v0.4.18...v0.4.19

Development build (dev)

This is an automated development build from branch dev.

• Development Version: 9999.0.0-dev.27369219016+87b17844 (independent from stable release versions)

• Current Stable Line in repo: 0.4.20

• Purpose: quick testing and integration validation.

• Stability: may change frequently and can include breaking changes.

• Install target: developers/testers only.

• Repository: BAKAOLC/STS2-RitsuLib

• Commit: 87b17844

• Workflow Run: #27369219016

0.4.18

• Added a patch for the vanilla DevConsole to correct erroneous index and operation behaviors in the original behavior, making its performance more aligned with user expectations
• Added a setting entry to allow users to enable or disable feature enhancements related to DevConsole. The relevant configuration items include:
  • Whether to enable command completion enhancement
  • Whether to enable history navigation fix
  • Whether to clear state when toggling show/hide
• Fixed the hook distribution logic of ModelCapability to resolve exceptional cases that may occur under certain circumstances

---

• 增加了一个对原版 DevConsole 的补丁，以修正原版行为中错误的索引和操作行为，使其的表现更为符合用户认知
• 增加了一个设置项入口，以允许用户是否启用 DevConsole 相关的功能增强，相关的配置项包括：
  • 是否启用命令补全增强
  • 是否启用历史记录导航修正
  • 是否在切换显示隐藏时清空状态
• 修正了 ModelCapability 的 Hook 分发逻辑，以解决某些特定情况下可能出现的异常情况

---

Full Changelog: v0.4.17...v0.4.18

0.4.17

• Modified the right-click binding execution logic; when the target object deletes itself, the remaining binding execution will be interrupted and directly enter the settlement process.
  • Avoid as much as possible performing operations in right-click binding events that would cause the object itself to be deleted, because the game's Hook logic is inconsistent with such situations and cannot ensure stable judgment of whether the state diverges.
• Modified the trigger event of right-click binding, which should solve the problem of not being able to correctly trigger right-click binding in some cases.
• Continued to fix refresh issues in some secondary resource UIs.
• Modified the HoverTip processing logic for secondary resources, cleared the fixed appending of Amount text, and changed the relevant parameters to be injected into LocString to allow users to define the Amount text themselves.
• Added some helper methods to simplify development.

---

• 修改了右键绑定执行逻辑，当目标对象删除自身时将会打断剩余绑定执行并直接进入结算流程
  • 尽可能避免在右键绑定事件中执行会导致对象自身被删除等情况的操作，因为游戏中的 Hook 逻辑和这种情况不一致，它无法确保在这种情况下稳定判定状态是否分歧
• 修改了右键绑定的触发事件，应当能够解决部分情况下无法正确触发右键绑定的问题
• 继续修正了部分次级资源 UI 的刷新问题
• 修改了次级资源的 HoverTip 处理逻辑，清理了固定的 Amount 文本追加，并将相关参数改为注入到 LocString 中以允许用户自行定义 Amount 文本
• 增加了部分辅助方法以简化开发

---

Full Changelog: v0.4.16...v0.4.17

0.4.16

• Fixed an issue where the layout of some UI elements was not completely correct.
• Added preview checks to the secondary resource processing logic to avoid possible errors in certain situations.
• Added a path to support optional secondary resource payment.
  • Still in experimental feature status, no guarantee of API stability. Please use with caution and provide relevant issues to help improve.
• Added a log to output whether the character has Epoch and Timeline enabled.
• Relaxed some interface checks for Epoch and Timeline to allow characters that have not registered RitsuLib to use related interfaces normally.

---

• 修正了部分 UI 元素布局不完全正确的问题
• 次级资源处理逻辑补充了 preview 检查，以避免在某些情况下可能出现的错误
• 补充了一条路径以支持可选的次级资源支付
  • 仍为实验性功能状态，并不保证功能 API 稳定性，请谨慎使用并尽可能提供相关的 issue 以协助改进
• 补充了一个输出角色是否启用 Epoch 和 Timeline 的日志
• 解除了部分对 Epoch 和 Timeline 的接口检查，以允许未注册 RitsuLib 的角色也能正常使用相关接口

---

Full Changelog: v0.4.15...v0.4.16

0.4.15

• Cleaned up structure and heavily split composite patches to improve JIT-ability of patches
• Added ComputedEnergyVar, ComputedStarsVar, ComputedPowerVar<T> computed dynamic variables to support more dynamic variable usage needs
• Fixed incorrect toggle judgment logic for content source tooltip
• Adjusted content source retrieval logic to avoid possible deviations in certain specific scenarios
  • Since BaseLib's implementation cannot accurately determine the base source of CustomEnums, it is fixed as BaseLib for such cases
• Reverted Label optimization in settings menu to ensure consistency in display style
• Adjusted CardModel.GetDescriptionForPile injection point to fix issue where required text might not be correctly injected in some cases
  • If you previously encountered the issue of Keyword description not displaying, it should be fixed as a result.

---

• 清理结构并大量拆分了复合 Patch 以提高补丁的可 JIT 化能力
• 增加了 ComputedEnergyVar、ComputedStarsVar、ComputedPowerVar<T> 计算型动态变量，以支持更多的动态变量使用需求
• 修正了内容来源悬浮窗的错误的开关判定逻辑
• 调整了内容来源的获取逻辑，以避免部分特定场景下可能出现的偏差
  • 由于 BaseLib 的实现无法准确判定 CustomEnums 的基础来源，因此对于此类固定显示为 BaseLib
• 回退了设置菜单中的 Label 优化以保证显示样式的一致性
• 调整了 CardModel.GetDescriptionForPile 注入点，以修正某些情况下可能并没有正确注入所需文本的问题
  • 如果你之前遇到了 Keyword 描述不显示的问题，它应当被因此修正

---

Full Changelog: v0.4.14...v0.4.15

0.4.14

• Fixed the issue where the call chain for displaying secondary resource cost bindings in the card UI was broken.
• Added a wrapper class for secondary resource costs in the card UI.
• Added some convenience methods to simplify registration and updating of secondary resource UI.
• Added some convenience methods to simplify Capability-related calls and operations.
• Refactored part of the ModSettingsUi rendering to improve interface performance, and simplified some layouts to provide more page space.

---

• 修正了卡牌 UI 中次级资源费用显示挂钩的调用链断开的问题
• 补充了一个卡牌 UI 上次级资源费用的包装类
• 补充了一些快捷方法，用于简化次级资源 UI 的注册和更新
• 补充了一些快捷方法，用于简化 Capability 的相关调用和操作
• 重构了部分 ModSettingsUi 的渲染实现，以提升界面性能，并简化了部分布局以提供更大的页面空间

---

What's Changed

• Updated the doc by @LingkongSky in #52
• 次要资源bug修复&优化 by @GlitchedReme in #53
• fix: Guard ModelDb getter merges and warm resolved caches by @WRXinYue in #54

Full Changelog: v0.4.13...v0.4.14

0.4.13

• Fixed an issue where main interface buttons could compete for layer priority with other main interface buttons.
• Fixed an issue where secondary resources might lose cost definitions and other information when copied.
• Redesigned the creation logic and hovertip binding logic of the secondary resource energy gauge to handle related content in a more reasonable and standardized manner.

---

• 修复了主界面按钮可能会和其他主界面按钮抢占层级的问题
• 修复了次级资源在复制时可能会丢失费用定义等信息的问题
• 重新设计了次级资源能量表盘的创建逻辑和 hovertip 绑定逻辑，以用更合理和规范化的方式来处理相关内容

---

Full Changelog: v0.4.12...v0.4.13

0.4.12

• The settings interface button of RitsuLib will now be displayed above the Modding row of the vanilla game, instead of below it.
• A main menu button has been added to RitsuLib, which identifies the version and compatibility branch info of RitsuLib, and allows clicking to open the settings interface of RitsuLib.
  • Enabled by default, can be turned off in the settings interface.
• Optimized the implementation of some patches to ensure they are more precise with less coverage, reducing and avoiding potential future logic divergence caused by duplicated logic.
• Added an experimental secondary resource system to unify the implementation of auto-refreshing resources like energy in the game and token-accumulating resources like Radiance (as well as other types).
  • API stability is not guaranteed; it may undergo significant changes in future versions, but the current version is mostly usable and requires more testing.
  • By default, secondary resource display is not provided, but a unified hook system allows creating custom UI to show secondary resource counts on the game's energy UI, cards, and multiplayer list.
    • Includes a simple basic style implementation. If no specific needs, it can be used directly; otherwise, implement a custom factory to create custom UI.
  • Currently covered capabilities:
    • Resource definition (quantity range, turn-start behavior, persistence behavior, localization table, title, description, small icon, large icon)
    • Resource calculation and settlement (quantity judgment, X-cost, free play, play judgment, hook chain, history, etc.)
    • Resource display (energy UI, on cards, in multiplayer list)
    • Resource persistence (save, load, reload)
    • Resource localization (multi-language icon display, title, description)
    • Resource dynamic variables (DynamicVar wrapper)
    • Resource operation command set (SecondaryResourceCmd)
• Adjusted some judgments of right-click interaction; now, when the execution side check returns false, the task is still marked as complete to ensure execution integrity.
  • Also fixed the inconsistency of capability logic hierarchy with other styles.
• Adjusted the log output when registering content; now the ID of the registered content will be output to the log.

---

• 现在 RitsuLib 的设置界面按钮将移动至游戏原版的 Modding 行的上方显示，而不再是其下方
• RitsuLib 现在增加了一个主界面按钮，用于标识 RitsuLib 的版本和兼容分支信息，并允许点击后打开 RitsuLib 的设置界面
  • 默认开启，可在设置界面中关闭
• 优化了部分补丁的实现方案，以保证其覆盖面更小且精确，以减少和避免因复制逻辑而可能产生的未来逻辑分歧问题
• 增加了一个实验性的次级资源系统，用于统一实现类似于游戏中的能量这种自动刷新的资源以及辉星这种累积Token的资源（以及其他类型）
  • 不保证 API 稳定性，可能在未来版本中发生重大变化，但目前版本已基本可用，且需要更多测试
  • 默认不提供次级资源的显示，并带有统一的挂钩处理以允许在游戏的能量UI、卡牌上、多人列表处创建自定义UI用以显示次级资源数量
    • 带有简单的基本样式实现，如果没有特定的需求，可以直接使用，否则请自行实现 factory 以创建自定义UI
  • 目前已覆盖的能力范围：
    • 资源定义（数量范围、回合开始行为、持久化行为、本地化表、标题、描述、小图标、大图标）
    • 资源计算与结算（数量判定、X费、免费打出、打出判定、Hook链、历史记录等）
    • 资源显示（能量UI、卡牌上、多人列表处）
    • 资源持久化（存档、读档、重载）
    • 资源本地化（多语言图标显示、标题、描述）
    • 资源动态变量（DynamicVar 包装）
    • 资源操作指令集（SecondaryResourceCmd）
• 调整了右键交互的部分判定，现在在执行端检查时判定 false 也会标记任务完成以保证执行的完整性
  • 同时修正了 capability 的相关逻辑层级与其他样式不一致的问题
• 调整了注册内容时输出的日志信息，现在会将注册的内容的 ID 输出至日志中

---

Full Changelog: v0.4.11...v0.4.12