Development build (dev)

This is an automated development build from branch dev.

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

• Current Stable Line in repo: 0.2.21

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

• Workflow Run: #25296148690

0.2.21

• Modified logic to get initial cards, relics, and potions in ModCharacterTemplate
• Somewhat lifted the restriction on FMod support, now if the audio file in the PCK is not imported by Godot, it should be able to be played by FMod
  • It is necessary to ensure that the audio file does not use the import option, otherwise Godot will treat it as an imported resource, rather than a raw file, which will cause FMod to fail to obtain the correct audio data
    • If played forcibly, the game will crash, therefore this restriction is still maintained
• Improved the layout and style of the settings interface, now supports more setting values
• Fixed the character visual processing logic in the fake merchant scene
• Fixed the issue that multiple FMod Guid tables will cause the previous loaded Guid tables to be invalid when loaded
• Added FmodStudioDeferredBankRegistration.RegisterBank and FmodStudioDeferredBankRegistration.RegisterStudioGuidMappings methods, used to defer the loading of FMod banks and Guid tables until the DeferredInitializationCompletedEvent is raised, and load them in one batch to ensure that the correct content is loaded when FMod is available

---

• 修改了 ModCharacterTemplate 对初始卡、遗物、药水的获取逻辑
• 一定程度上解除对 FMod 支持的限制，现在如果 PCK 内放置的音频是没有被 Godot 导入过的，那么它应当可以被 FMod 播放了
  • 需要确保设置音频文件不使用导入选项，否则 Godot 会将其视为导入资源，而不是原始文件，这将会导致 FMod 无法获取正确的音频数据
    • 如果强行播放，将会导致游戏崩溃，因此目前仍然保持这种限制
• 继续优化设置界面的布局和样式，现在支持了更多的设置值
• 修复了假商人场景的角色视觉处理逻辑
• 修复了多个 FMod Guid 表加载时会错误的导致之前加载的 Guid 表失效的问题
• 增加了 FmodStudioDeferredBankRegistration.RegisterBank 和 FmodStudioDeferredBankRegistration.RegisterStudioGuidMappings 方法，用于将 FMod bank 和 Guid 表的加载推迟到 DeferredInitializationCompletedEvent 之后，并在同一批里完成加载，以保证在 FMod 可用时在正确加载所需内容

---

What's Changed

• fix(character): merge registered starter content by @alkaid616 in #31

New Contributors

• @alkaid616 made their first contribution in #31

Full Changelog: v0.2.19...v0.2.21

0.2.19

• Provide MaterialUtils.CreateUnmodulatedHsvShaderMaterial method to create HSV shader material with H=0, S=1, V=1
• Optimize the implementation of AnyPlayer、Anyone hand operation to improve logic safety
• Optimize the logic of CardReward to improve logic safety
• Optimize and fix the anchor point calculation logic of extra card piles, now you can pass custom anchor point parameters.
  • Also fix the anchor point calculation of some animation targets (e.g. card fly animation) to find the correct target position and enter it (roughly).

---

• 提供了 MaterialUtils.CreateUnmodulatedHsvShaderMaterial 方法用于创建 H=0, S=1, V=1 的 HSV 着色器材质
  • 这可以用于 FrameMaterial 以保持你的贴图颜色不变
• 优化了 AnyPlayer、Anyone 的手柄操作实现，以提升逻辑的安全性
• 优化了 CardReward 的相关逻辑，以提升逻辑的安全性
• 优化修正了额外牌堆的锚点计算逻辑，现在允许传递自定义的锚点参数了
  • 并且修正了部分动画目标（如卡牌飞行动画）的锚点计算，现在它们会找到正确的目标位置钻进去了（大概）

---

Full Changelog: v0.2.18...v0.2.19

0.2.18

• Add some defensive measures to the settings menu code to improve stability
• Fix the issue where some mirror page logic will cause infinite recursion
• Modify the position and layout of some settings items to optimize the experience
• The theme now includes version number logic to ensure automatic updates (old files will be backed up)
• Fixed the layout issue of the scrollbar, now the scrollbar styles can be correctly displayed
• Added a Toast system that can be used to display global notification messages

---

• 为设置界面的部分逻辑添加了防御性措施以提升稳定性
• 修复了部分镜像页面逻辑会错误的发生无限递归的问题
• 修改了部分设置项的位置和说明以及布局位置，以优化体验
• 主题增加了版本号逻辑，以保证自动更新（会备份旧文件）
• 修复了滚动条的布局问题，现在能正确显示滚动条样式了
• 增加了一组 Toast 系统，可以用于显示全局通知消息

---

Full Changelog: v0.2.17...v0.2.18

0.2.17

• Continue refactoring the settings menu code, simplifying some styles and adjusting the default styles, now more settings are visible in the same conditions.
• Fixed the issue where the sidebar list content was not correctly refreshed when switching pages, now the correct chapter of the current page is displayed instead of the fixed chapter list of the main page.
• Added a unified theme style system that can be used to set the style of Godot native controls and allow users to customize and switch at runtime.
  • Users can add new style files in the persistent data storage directory of RitsuLib to customize additional themes, or adjust the theme styles by modifying the JSON file of the current embedded theme.
    • The theme file structure follows the W3C Design Tokens Format Module specification.
• Fixed #30, now the energy counter structure of baselib is fully implemented, and the position and style of the star counter are set using the consistent structure.
• Implemented the functionality to modify the player's hand size limit, the effect is basically aligned with the current implementation of baselib.
• Modified the detection mechanism for additional frameworks, now the detection will be performed at a unified time point, and the related implementation forwarding and redirection will be performed at this time point.
• Added the implementation of CustomTargetType.Anyone and CustomTargetType.Everyone, now these types can be used as TargetType.
• Modified a large number of reflection calls to delegate calls, improving performance to some extent.

---

• 继续重构设置菜单的代码，简化部分样式并调整默认样式，现在在同等情况下，能看到更多的设置项了
• 修复了切换页面没有正确的刷新侧边栏列表内容的问题，现在会正确展示当前页面的章节而不是固定主页面的章节列表了
• 增加了一套统一的主题样式系统，可以用于设置 Godot 原生控件的样式，并允许用户进行自定义和运行时切换。
  • 用户可以在 RitsuLib 的持久化数据存储目录中新增样式文件以自定义额外主题，也可以通过修改当前内嵌主题的 JSON 文件来调整主题的样式。
    • 主题文件结构遵循 W3C 的 Design Tokens Format Module 规范。
• 修复 #30 ，现在补全了 baselib 的能量表盘结构的处理逻辑，会使用一致的结构设置辉星表盘的位置和样式。
• 实现了修改玩家手牌上限的功能，效果基本与 baselib 的当前实现对齐。
• 修改了额外框架的探测机制，现在会在统一的时间点进行探测，并将相关的实现转发和重定向改为在此时机进行。
• 增加了 CustomTargetType.Anyone 和 CustomTargetType.Everyone 的实现，现在允许使用这两个类型作为 TargetType。
• 修改了大量反射调用为委托调用，提升了一定的性能。

---

• Added a minimal FMOD project template at https://github.com/BAKAOLC/STS2_FModProject_Minimal, which can be used by mod authors to quickly start making FMOD audio content.
• 在 https://github.com/BAKAOLC/STS2_FModProject_Minimal 提供了一个最简的 FMOD 工程模板，方便模组作者快速上手制作 FMOD 音频内容。

---

Full Changelog: v0.2.15...v0.2.17

0.2.15

• Fixed a few issues with ModTemporaryPowerTemplate and standardized the design to ensure expected behavior in most cases.

---

• 修复了 ModTemporaryPowerTemplate 的部分实现问题，并重新规范化了设计以保证大多数情况下应当以预期行为运行。

---

Full Changelog: v0.2.14...v0.2.15

0.2.14

• Modified the delegate parameter structure for the card pile flight start and end points, and provided as much data as possible, and filled in some paths that were not handled correctly
  • Some data cannot be provided in certain cases, so it is necessary to check if it is empty
• Completed the implementation of ComputedDynamicVar, now closer to the implementation of CalculatedVar

---

• 调整了牌堆飞行起始和结束点的委托参数类型结构，并尽可能的提供了大部分数据，并补全了部分没有被正确处理的路径
  • 部分数据在特定情况下暂时无法被提供，因此需要注意判断是否为空
• 补全了 ComputedDynamicVar 的实现，现在更贴近于 CalculatedVar 的实现了

---

Full Changelog: v0.2.13...v0.2.14

0.2.13

• Implemented a set of APIs for refreshing the partial visual effects of cards, relics, potions, and other resources at runtime
• Fixed a bug that could cause the quality color to be incorrect in certain cases

---

• 增加了一组 API 用于运行时刷新卡牌、遗物、药水、能量球等资源的部分视觉效果
• 修复了一个特定情况下会导致品质颜色错误的错误

---

Full Changelog: v0.2.12...v0.2.13

0.2.12

• Added an optional Order to the registrars for starting cards, relics, potions, and other content, to allow for a certain degree of custom sorting
• Continued to expand resource overriding functionality significantly; overriding support across various paths has been greatly improved
• Added custom badge support
• Modified the NuGet package's Targets definition; now you need to explicitly define RitsuLibDeployDir to the folder where files need to be copied for the files to be copied there
  • Will not be placed in subfolders; please specify the final destination folder yourself
• Extended and reorganized the entire settings system; the file structure layout is now slightly clearer
  • Added a Custom constructor for creating custom controls
  • Added a workflow for constructing settings pages and data binding based on annotation types
  • Fixed a misplaced reference example and simplified the descriptive text
  • Added a Spine preview example page to serve as a demonstration for the annotation construction settings page
• Adjusted the version number log output format for the compatible version

---

• 对起始卡牌、遗物、药水等内容的注册器添加了一个可选的 Order，以用于一定程度上允许自定义排序
• 继续扩展了大量资源覆写功能，现在多种路径上的覆写支持能力都获得了大幅提升
• 添加了自定义 badge 支持
• 修改了 NuGet 包的 Targets 定义，现在需要自己显式定义 RitsuLibDeployDir 到需要复制的文件夹才会复制文件过去
  • 不会放置于子文件夹，请自行指定到最终目标文件夹
• 扩展、整理了整个设置系统，现在文件结构布局会略微清晰一些
  • 增加了 Custom 构造器，用于创建自定义控件
  • 增加了依靠注解类型来构造设置页面和数据绑定的工作方式
  • 修正了一个摆放位置错误的参考示例，并简化了描述文本
  • 新增了一个 Spine 预览示例页，用于作为注解构造设置页面的演示
• 调整了兼容版本的版本号日志输出格式

---

Full Changelog: v0.2.11...v0.2.12

0.2.11

• Reverted a patch modification to address a specific issue
• Now the compatibility version branch files output a specific compatibility version label to the log, so that they can be distinguished from the official version in the log

---

• 回退了一个补丁的修改方案，以解决特定情况下的问题
• 现在兼容性版本分支文件会输出特定的兼容性版本标签到日志中，以使其能够在日志中与正式版本区分开来

---

Full Changelog: v0.2.10...v0.2.11