语音框架（摄政魅惑声线）

语音模组框架

一个为《杀戮尖塔2》打造的角色语音播放框架。默认支持瑞金特的小恶魔语音包！
这个模组最初名为“瑞金特·梅苏加基的语音但语音播放系统已大幅扩展，因此已重生为一个框架！
它会根据游戏中的各种事件自动播放角色语音，并在对话气泡中显示字幕。

无需DLL即可添加语音包。只需放置一个文件名中含有"voicepack"的JSON文件即可（例如： Test_voicepack.json) 以及音频文件（mp3或ogg格式），即可为对应角色启用语音。其他模组作者发布自制的角色语音包时，只需依赖此框架即可。



特色

零配置语音包 — 放置即可自动识别并注册 voicepack.json 以及音频文件。语音包无需额外DLL。
超过20个自动触发器 — 出牌、生命值伤害（无视格挡/贯穿）、完全格挡、获得增益、附加减益、获得能量、击败敌人、战斗开始/胜利/失败、生命值过低（每场战斗一次）、闲置（玩家回合内）、使用药水、卡牌升级、商店购买、宝箱等。
卡牌专属语音 — 添加一个 card_{CardID} 该卡专属语音播放文件夹
字幕显示 ——带角色图标的对话气泡叠加层。支持日语、英语、简体中文和韩语。
香草泡泡模式 — 启用游戏原本的头顶对话气泡显示（NSpeechBubbleVfx）。
自定义字体 — 指定 .ttf / .otf 每种语言对应的字体，以正确显示日文、中文、韩文及其他文字。
气泡图替换 — 将原生气泡素材替换为自定义图片（PNG/JPG/WEBP格式）。
富文本支持 — 字幕JSON支持Godot 4的BBCode标签（粗体、颜色、波浪、震动、彩虹等）。
打字机效果 — 逐字显示文本，可设置每秒显示字数（cps）。经典气泡模式下无效。
音频缓存与连续播放防止 — 在游戏开始前预解码文件，避免同一文件夹内的相同文件连续播放。
游戏内设置 — 音量(dB)、触发概率(%)、分项开关、闲置触发延迟(秒)、字幕位置(四角可选)、缩放比例、淡入淡出时间等

安装

请提供需要翻译的文本内容。 将 VoiceModFramework 文件夹放入游戏 mods/ 目录中。
    若已安装“魅惑女王语音包”，请将其删除。
2. 启动游戏后将自动扫描所有模组文件夹，包含voicepack.json的语音包会被自动加载。

无需额外设置。可在游戏内的模组设置面板中调整各项参数。

如何创建语音包（简化版）

无需任何DLL即可发布。

在 `mods/` 目录下新建一个文件夹（例如 `MyCharacterVoice/`）。 在其中创建一个名称包含 `voicepack` 的 JSON 文件（例如 `voicepack.json`），并写入以下内容： ```json { "character_id": "Character_ID", "voices_dir": "voices" } ``` 将音频文件（.ogg 或 .mp3）放入对应的分类子文件夹中： ``` voices/ card/ ← 使用卡牌时播放 damage/ ← 受到生命值伤害时播放 combat_start/ ← 战斗开始时播放 victory/ ← 胜利时播放 ... ``` 启动游戏后，该语音包会在使用对应角色的局内自动识别并启用。

您也可以在游戏内的「模组配置」菜单中自动完成此操作！请先进入您要应用的角色战斗界面，然后再执行。

角色ID可通过以下方式验证 设置 → 语音模组 → 工具 → 导出角色ID.json.

如需使用字体替换、气泡图片替换、富文本及API钩子等高级功能，请参阅 [模组制作指南（施工中）].

针对其他模组制作者（基于DLL注册）

对于包含DLL的模组，可直接在ModEntry.Init()中注册：

VoiceModApi.Register(new VoicePackConfig
→ VoiceModApi.注册(new VoicePackConfig)
{
CharacterId = "MYCHARACTER"
VoicesDir = Path.Combine(modDir, "voices"),
SubtitleDir = Path.Combine(modDir, "voices")，
IconPath = Path.Combine(modDir, "icon.png"),
SubtitleColor = "#FFCC88"
});

你也可以通过自己的Harmony补丁触发语音：

VoiceModApi.PlayCurrentPackVoice("my_custom_category");

*未经充分测试，故无法保证完全正常运行。如有错误请报告。
请参阅 [模组制作者指南] 详情。

欢迎基于此框架制作并发布语音包。无需标注出处，但如果能提及一下，我们将不胜感激！

推荐模组： 

摄政皮肤模组 by anaertailin 摄政卡牌动画重制 by DoublePigeon

**媚惑尖塔**