feat: 更新至 v1.8.7，增强对话和音效触发功能

[BAKAOLC]

更新内容

• 新增自定义对话系统，支持在动画状态机中触发对话
• 新增 ModelSoundTrigger 组件，支持在动画状态机中直接触发音效
• 增强音效触发功能，新增多个战斗相关音效标签
• 增强动画器控制功能，新增多个战斗相关触发器
• 增强 ModelHandler 音效触发功能，支持暴击判断和音效播放概率配置
• 优化音效标签处理，移除标签验证限制
• 更新 README 和 CHANGELOG 文档

相关提交

• feat: 添加自定义对话管理器以增强对话功能
• feat: 添加 ModelSoundTrigger 以增强音效触发机制
• feat: 增强 CustomAnimatorControl 和 ModelHandler 的音效触发功能
• feat: 更新至 v1.8.7，增强对话和音效触发功能

[Copilot]

Pull request overview

This PR updates the mod to v1.8.7, introducing a comprehensive dialogue system and enhancing combat-related audio and animation triggers. The changes enable more dynamic character interactions through dialogue bubbles and expanded sound effect triggers for combat events, including critical hit variations. The implementation removes previous sound tag validation restrictions, allowing for more flexible custom sound configurations.

Key Changes

• Added custom dialogue system with multilingual support and multiple playback modes (Sequential, Random, RandomNoRepeat, Continuous)
• Added ModelSoundTrigger and ModelDialogueTrigger components for triggering audio and dialogue from animation state machines
• Enhanced combat event handling with 6 new sound tags and 8 new animator triggers for normal and critical hit/death scenarios
• Added sound playback probability configuration (SoundTagPlayChance) for fine-grained audio control

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
README.md	Added documentation for dialogue system, ModelSoundTrigger/ModelDialogueTrigger components, combat triggers, and sound probability configuration (Chinese)
README_EN.md	Added documentation for dialogue system, ModelSoundTrigger/ModelDialogueTrigger components, combat triggers, and sound probability configuration (English)
DuckovCustomModel/Constant.cs	Updated version to 1.8.7
DuckovCustomModel/ModEntry.cs	Added CustomDialogueManager initialization and cleanup
DuckovCustomModel/MonoBehaviours/ModelHandler.cs	Enhanced sound triggering with crit detection, global damage/death event handling, probability configuration, and ModelSoundTrigger event subscription
DuckovCustomModel/MonoBehaviours/CustomAnimatorControl.cs	Added 8 new trigger methods for combat events (Hurt, Dead, HitTarget, KillTarget + Crit variants)
DuckovCustomModel/Managers/CustomDialogueManager.cs	New manager for loading, caching, and playing dialogue with multilingual support
DuckovCustomModel.Core/MonoBehaviours/Animators/ModelSoundTrigger.cs	New StateMachineBehaviour for triggering sounds from animation states
DuckovCustomModel.Core/MonoBehaviours/Animators/ModelDialogueTrigger.cs	New StateMachineBehaviour for triggering dialogue from animation states
DuckovCustomModel.Core/Data/SoundTags.cs	Added 6 new combat-related sound tag constants
DuckovCustomModel.Core/Data/SoundInfo.cs	Removed tag validation restriction to allow custom tags
DuckovCustomModel.Core/Data/ModelInfo.cs	Added SoundTagPlayChance property for probability configuration
DuckovCustomModel.Core/Data/DialogueDefinition.cs	New data class for dialogue configuration
DuckovCustomModel.Core/Data/CustomAnimatorHash.cs	Added 8 new animator parameter hashes for combat triggers
CHANGELOG.md	Documented v1.8.7 changes (Chinese)
CHANGELOG_EN.md	Documented v1.8.7 changes (English)

Comments suppressed due to low confidence (1)

DuckovCustomModel/MonoBehaviours/ModelHandler.cs:179

• [nitpick] The event subscriptions in OnDestroy() are unsubscribed before checking if CharacterMainControl is null (lines 170-173), but the corresponding subscriptions in Initialize() are done after the null check (lines 230-233). While this works, it could lead to attempting to unsubscribe from global events even when initialization failed or never completed. Consider adding a guard to ensure these global event unsubscriptions only occur if initialization was successful, or moving them after the null check for consistency.

Example:

if (CharacterMainControl != null && CharacterMainControl.Health != null)
{
    CharacterMainControl.Health.OnHurtEvent.RemoveListener(OnHurt);
    CharacterMainControl.Health.OnDeadEvent.RemoveListener(OnDeath);
}

ModelSoundTrigger.OnSoundTriggered -= OnSoundTriggered;
Health.OnHurt -= OnGlobalHurt;
Health.OnDead -= OnGlobalDead;

        private void OnDestroy()
        {
            ModelSoundTrigger.OnSoundTriggered -= OnSoundTriggered;

            Health.OnHurt -= OnGlobalHurt;
            Health.OnDead -= OnGlobalDead;

            if (CharacterMainControl == null) return;
            if (CharacterMainControl.Health == null) return;
            CharacterMainControl.Health.OnHurtEvent.RemoveListener(OnHurt);
            CharacterMainControl.Health.OnDeadEvent.RemoveListener(OnDeath);
        }

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 18 out of 18 changed files in this pull request and generated 4 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.