Voice Framework (Regent Mesugaki Voice)

模组简介

A character voice playback framework for Slay the Spire 2. Supports Regent's Mesugaki voice by default! This mod was originally "Regent Mesugaki Voice", but the voice playback system has been greatly expanded, so it has been reborn as a framework. It automatically plays character voices in conjunction with various in-game events and displays subtitles in speech bubbles. ⚠ Before You Install • RitsuLib is now required. This mod will not load without it. The requirement changed from ModConfig to RitsuLib in V1.13. • BaseLib is no longer required. • Requires game version 0.107.1 or later. There have been quite a few changes this version, so there may still be some bugs. Please report anything you run into. Installation • Subscribe to RitsuLib . It is listed as a required item on this page, and this mod will not load without it. • Subscribe to this mod. Steam installs both automatically. • Launch the game. That is all — no files need to be moved by hand. If you installed an older version manually (the Nexus release, or "Regent Mesugaki Voice"), delete it from the game's mods/ folder first. Running both at once will conflict. Settings are found in the RitsuLib settings panel , reachable from the main menu or the pause menu. What's New in V1.13 • Migration from ModConfig to RitsuLib • Multiple voice packs can now be registered for a single character and switched between in the settings • Improved the voice playback system for multiplayer (this has not been tested, as I do not have any friends who own StS2) • Added a feature to manage the total amount of speech during multiplayer sessions • Added triggers for orb acquisition and activation • Added triggers for minion summoning • Voice packs downloaded from the Steam Workshop are now detected • Reported bug fixes Note: A "minion" folder is created when generating a template, but voices placed in it will not play yet. That feature is still under development. Features Zero-Configuration Voice Packs Automatic detection and registration just by placing voicepack.json and audio files. No DLL required on the voice pack side. Over 40 Automatic Triggers Card usage, HP damage (unblocked/piercing), full block, buff acquisition, debuff application, star acquisition, enemy defeat, combat start/victory/defeat, low HP (once per combat), idle (during player turn), potion usage, card upgrade, shop purchase, treasure chest, and more. Card-Specific Voices Add a card_{CardID}/ folder to play exclusive voices for that specific card. Multiple Voice Packs per Character Register several packs for the same character and switch between them in the settings. Subtitle Display Speech bubble overlay with character icons. Supports Japanese, English, Simplified Chinese, and Korean. Vanilla Bubble Mode Option to use the game's original overhead speech bubbles (NSpeechBubbleVfx). Custom Fonts Specify .ttf / .otf fonts per language to correctly render Japanese, Chinese, Korean, and other texts. Speech Bubble Image Replacement Replace native bubble sprites with custom images (PNG/JPG/WEBP). Rich Text Support Subtitle JSON allows Godot 4 BBCode tags (bold, color, wave, shake, rainbow, etc.). Typewriter Effect Displays text character by character. Speed can be set in cps (characters per second). Does not work in Vanilla Bubble Mode. Audio Caching & Consecutive Playback Prevention Audio files are decoded on first use and kept in memory within a size budget. The same file from the same folder will not play twice in a row. In-Game Settings Volume (dB), trigger probability (%), category-specific ON/OFF, idle trigger delay (seconds), subtitle position (choose from four corners), scale, fade time, and more. How to Create a Voice Pack Voice packs can be published without any DLLs. • Create a folder inside mods/ (e.g., MyCharacterVoice/). • Create a JSON file with "voicepack" in its name (e.g., voicepack.json): { "character_id": "Character_ID", "voices_dir": "voices" } • Place audio files (.ogg or .mp3) into category subfolders: voices/ card/ Voicepack Template -> Create Template . Run it after entering combat with the character you want it for, so the character ID can be picked up automatically. Character IDs can also be exported via RitsuLib settings -> VoiceModFramework -> Utility -> Export character_ids.json . For advanced features such as font replacement, speech bubble image replacement, rich text, and API hooks, please refer to the Modder's Guide (work in progress). For Other Modders (DLL-Based Registration) For mods with a DLL, you can register directly from ModEntry.Init(): VoiceModApi.Register(new VoicePackConfig { CharacterId = "MYCHARACTER", VoicesDir = Path.Combine(modDir, "voices"), SubtitleDir = Path.Combine(modDir, "voices"), IconPath = Path.Combine(modDir, "icon.png"), SubtitleColor = "#FFCC88", }); You can also trigger voices from your own Harmony patches: VoiceModApi.PlayCurrentPackVoice("my_custom_category"); This part is not fully tested, so I am not sure it works perfectly. Please report any bugs. Feel free to create and publish voice packs that depend on this framework. No credit is required, but it would be appreciated! Recommended Mods • Regent Skin Mod by anaertailin • Regent Cards Anime Rework by DoublePigeon fun Mesugaki the Spire Earlier Changes V1.12 Fixed an issue where KO and CN subtitles were not displayed during non-combat phases (such as map movement, shops and rest areas). I initially thought it was a subtitle problem, but the cause turned out to be a reference error in a function.

条目信息

所属游戏

杀戮尖塔 2 (Slay the Spire 2)

创意工坊 ID

3780124701

文件名

3780124701.bin

文件大小

7.5 MB

最后更新

2026/08/09

内容版本

v1786231636-e4e91b41b3e92b49

作者与来源

由原作者发布于 Steam 创意工坊。本站不改变署名，作者信息与原始内容请以 Steam 原始页面 为准。