feat(ui): 新增模型高度设置和运行时数据记录功能

## 变更内容

- 新增模型高度设置功能，允许按角色目标和模型单独设置高度
- 增加运行时数据记录功能，数据位于 config 文件夹的 RuntimeData/<ModelTarget>/<ModelId>.json
- 优化动画参数显示界面，新增对参数名开头和结尾空白字符的提示功能
- 优化模型选择界面，AI角色会将在所有AI角色中设置的模型以紫色标出
- 修复特定情形下（如场景内远距离传送）动画器参数失去同步的问题

## 相关文件

- DuckovCustomModel/RuntimeData/
- DuckovCustomModel/UI/Components/AnimatorParameterDisplay.cs
- DuckovCustomModel/Managers/ModelManager.cs
- DuckovCustomModel/HarmonyPatches/
- CHANGELOG.md, CHANGELOG_EN.md

Author: BAKAOLC

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 [English](CHANGELOG_EN.md) | 中文
 
+## v1.10.5
+
+- 动画参数显示界面优化
+  - 新增对参数名开头和结尾空白字符的提示功能
+  - 参数名开头或结尾的空格会以红色粗体的 `␣` 符号标记
+- 修复了特定情形下（如：场景内远距离传送）会导致动画器参数失去同步的问题
+- 增加了运行时的数据记录，数据位于 config 文件夹的 RuntimeData/<ModelTarget>/<ModelId>.json
+- 增加了模型高度设置功能，允许设置模型的高度，根据每个角色目标的每个模型单独设置
+  - 高度对应角色模型的 HelmetLocator 的位置
+    - 注意：如果模型不存在 HelmetLocator，那么该功能将会被禁用
+  - 会记录于运行时数据记录中，并保持应用
+  - **该功能不支持通过 “所有AI角色” 选项页面进行设置**
+- 优化了模型选择界面，现在AI角色会将在所有AI角色中设置的模型以紫色标出
+
 ## v1.10.4-fix4
 
 - 修复错误的将透视材质也替换成普通材质导致渲染表现异常的问题

CHANGELOG_EN.md

@@ -2,6 +2,20 @@
 
 English | [中文](CHANGELOG.md)
 
+## v1.10.5
+
+- Animator parameter display interface optimization
+  - Added warning for leading and trailing whitespace characters in parameter names
+  - Spaces at the beginning or end of parameter names are marked with red bold `␣` symbols
+- Fixed an issue where animator parameters could lose synchronization in specific scenarios (e.g., long-distance teleportation within a scene)
+- Added runtime data recording, data is located in config folder's RuntimeData/<ModelTarget>/<ModelId>.json
+- Added model height setting functionality, allows setting model height, configured separately for each model of each character target
+  - Height corresponds to the position of the character model's HelmetLocator
+    - Note: If the model does not have a HelmetLocator, this feature will be disabled
+  - Recorded in runtime data and persisted
+  - **This feature does not support configuration via the "All AI Characters" option page**
+- Optimized model selection interface, AI characters will now highlight models set in all AI characters in purple
+
 ## v1.10.4-fix4
 
 - Fixed the issue of replacing the transparent material with the normal material, causing abnormal rendering performance

DuckovCustomModel.Core/Data/ModelTargetType.cs

@@ -10,7 +10,7 @@ public static class ModelTargetType
         public const string Character = BuiltInPrefix + "Character";
         public const string Pet = BuiltInPrefix + "Pet";
         public const string AICharacterTemplate = BuiltInPrefix + "AICharacter_";
-        public const string AllAICharacters = AICharacterTemplate + "*";
+        public const string AllAICharacters = AICharacterTemplate + AICharacters.AllAICharactersKey;
 
         public static string CreateAICharacterTargetType(string aiCharacterName)
         {

DuckovCustomModel/Configs/ModelRuntimeData.cs

@@ -0,0 +1,62 @@
+using System;
+using System.Collections.Generic;
+
+namespace DuckovCustomModel.Configs
+{
+    public class ModelRuntimeData : ConfigBase
+    {
+        public Dictionary<string, object> Data { get; set; } = [];
+
+        public T? GetValue<T>(string key)
+        {
+            if (string.IsNullOrWhiteSpace(key)) return default;
+            if (!Data.TryGetValue(key, out var value)) return default;
+
+            try
+            {
+                if (value is T typedValue)
+                    return typedValue;
+
+                return (T)Convert.ChangeType(value, typeof(T));
+            }
+            catch
+            {
+                return default;
+            }
+        }
+
+        public void SetValue<T>(string key, T value)
+        {
+            if (string.IsNullOrWhiteSpace(key)) return;
+
+            if (value == null)
+                Data.Remove(key);
+            else
+                Data[key] = value;
+        }
+
+        public bool RemoveValue(string key)
+        {
+            return !string.IsNullOrWhiteSpace(key) && Data.Remove(key);
+        }
+
+        public override void LoadDefault()
+        {
+            Data.Clear();
+        }
+
+        public override bool Validate()
+        {
+            // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract
+            if (Data != null) return false;
+            Data = [];
+            return true;
+        }
+
+        public override void CopyFrom(IConfigBase other)
+        {
+            if (other is not ModelRuntimeData otherData) return;
+            Data = new(otherData.Data);
+        }
+    }
+}

DuckovCustomModel/Constant.cs

@@ -4,7 +4,7 @@ public static class Constant
     {
         public const string ModID = "DuckovCustomModel";
         public const string ModName = "Duckov Custom Model";
-        public const string ModVersion = "1.10.4-fix4";
+        public const string ModVersion = "1.10.5";
         public const string HarmonyId = "com.ritsukage.DuckovCustomModel";
     }
 }

DuckovCustomModel/Extensions/ShoulderSurfing/ShoulderCameraParameterUpdater.cs

@@ -15,7 +15,7 @@ public class ShoulderCameraParameterUpdater : IAnimatorParameterUpdater, IDispos
         public ShoulderCameraParameterUpdater()
         {
             ShoulderCameraCompat.Initialize();
-            _cancellationTokenSource = new CancellationTokenSource();
+            _cancellationTokenSource = new();
             UpdateLoop(_cancellationTokenSource.Token).Forget();
         }
 

DuckovCustomModel/Localizations/Chinese.json

@@ -66,6 +66,9 @@
   "PublishedAt": "发布时间",
   "CharacterModelWarning": "由于部分角色使用建筑模型，因此不保证所有该角色都能被正确替换为设置的模型",
   "ModelAudioVolume": "模型音效音量",
+  "ModelHeight": "模型高度",
+  "Reset": "重置",
+  "ClearRuntimeData": "清除运行时数据",
   "EmotionModifierKey1": "表情修饰键 1",
   "EmotionModifierKey2": "表情修饰键 2",
   "EmotionModifierKeyWarning": "警告：按下修饰键时会屏蔽所有其他按键响应，只能响应 F1~F8 组合键事件",

DuckovCustomModel/Localizations/ChineseTraditional.json

@@ -66,6 +66,9 @@
   "PublishedAt": "發布時間",
   "CharacterModelWarning": "由於部分角色使用建築模型，因此不保證所有該角色都能被正確替換為設置的模型",
   "ModelAudioVolume": "模型音效音量",
+  "ModelHeight": "模型高度",
+  "Reset": "重置",
+  "ClearRuntimeData": "清除運行時數據",
   "EmotionModifierKey1": "表情修飾鍵 1",
   "EmotionModifierKey2": "表情修飾鍵 2",
   "EmotionModifierKeyWarning": "警告：按下修飾鍵時會屏蔽所有其他按鍵響應，只能響應 F1~F8 組合鍵事件",

DuckovCustomModel/Localizations/English.json

@@ -66,6 +66,9 @@
   "PublishedAt": "Published At",
   "CharacterModelWarning": "Some characters use building models, so not all instances of this character may be correctly replaced with the set model",
   "ModelAudioVolume": "Model Audio Volume",
+  "ModelHeight": "Model Height",
+  "Reset": "Reset",
+  "ClearRuntimeData": "Clear Runtime Data",
   "EmotionModifierKey1": "Emotion Modifier Key 1",
   "EmotionModifierKey2": "Emotion Modifier Key 2",
   "EmotionModifierKeyWarning": "Warning: Pressing modifier keys will block all other key inputs, only F1~F8 combination key events will be responded to",

DuckovCustomModel/Localizations/French.json

@@ -66,6 +66,9 @@
   "PublishedAt": "Publié le",
   "CharacterModelWarning": "Certains personnages utilisent des modèles de bâtiment, donc toutes les instances de ce personnage ne peuvent pas être correctement remplacées par le modèle défini",
   "ModelAudioVolume": "Volume audio du modèle",
+  "ModelHeight": "Hauteur du modèle",
+  "Reset": "Réinitialiser",
+  "ClearRuntimeData": "Effacer les données d'exécution",
   "EmotionModifierKey1": "Touche de modification d'émotion 1",
   "EmotionModifierKey2": "Touche de modification d'émotion 2",
   "EmotionModifierKeyWarning": "Avertissement : Appuyer sur les touches de modification bloquera toutes les autres entrées de touches, seuls les événements de combinaison de touches F1~F8 seront pris en compte",