This is an automated development build from branch dev.

• Development Version: 9999.0.0-dev.27532594180+bb40a8b0 (independent from stable release versions)

• Current Stable Line in repo: 0.4.22

• 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: bb40a8b0

• Workflow Run: #27532594180

• Fixed an issue where character selection buttons in the custom match interface would abnormally shift.
• Fixed an issue where some card resource patches were not applied correctly.
• Added a missing card face resource override definition.
• Extended some ModManager APIs.
• Adjusted registration rules for some property scanning and storage interfaces to ensure data order more stably.
  • This may introduce compatibility issues when playing online with older versions of RitsuLib, please ensure users use the new version of RitsuLib as much as possible.

• 修正了一个会导致自定义对局界面里角色选择按钮会发生异常的偏移的问题
• 修正了部分卡牌资源补丁未正确应用的问题
• 补充了一个遗漏的卡面资源覆盖定义
• 扩展了一些 ModManager 的 API
• 调整了部分属性扫描和存储接口的注册规则，以更为稳定的确保数据顺序
  • 这可能引入与老版本 RitsuLib 联机时的兼容性问题，请尽可能确保用户使用新版本的 RitsuLib

Full Changelog: v0.4.21...v0.4.22

• Adjusted the icon selection priority for secondary resources on card UI; now correctly prioritizes large icons.
• Fixed an issue where visibility conditions for secondary resource UI were not taking effect.
• Fixed an issue where secondary resource UI did not correctly refresh visibility after resource count acquisition.
• Fixed an issue where the default visibility transition conditions for secondary resource UI were inconsistent with vanilla game behavior.
• Fixed an issue where secondary resources on card UI did not respond to free play state changes.
• Fixed an issue where the parsed cost result for secondary resources in free play state was incorrect.
• Added the sresource command and related console extension methods to allow users to control secondary resources in the vanilla console.
• Added and aligned missing Hook sequences for secondary resources.
• Added and extended the missing CardAssetProfile override and the corresponding ModCardTemplate override.
• Corrected erroneous logic in the secondary resource payment parsing process to resolve undefined behavior when payment is disabled.
• Added more setting mirroring logic for BaseLib and optimized some behaviors.

• 调整了卡牌 UI 上次级资源的图标选择优先级，现在会正确优先使用大图标
• 修复了次级资源 UI 的可见性条件不生效的问题
• 修复了次级资源 UI 不会正确在资源数量获取后刷新可见性的问题
• 修复了次级资源 UI 可见性变换条件默认情况与原版行为不一致的问题
• 修复了卡牌 UI 上次级资源不响应免费打出状态变化的问题
• 修复了次级资源在免费打出状态下解析的花费结果不正确的问题
• 补充了 sresource 命令以及相关控制台扩展方法，以允许用户在原版的控制台中操控次级资源
• 补充对齐了次级资源缺失的 Hook 时序
• 补充扩展了缺失的 CardAssetProfile 覆盖项，以及对应的 ModCardTemplate 覆盖项
• 修正了次级资源支付解析流程的错误逻辑，以解决支付被禁用时会导致未定义行为的问题
• 补充了更多 BaseLib 的设置镜像逻辑，并优化了部分行为

Full Changelog: v0.4.20...v0.4.21

• 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

• 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

• 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

• 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

• 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

• 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

• 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