Plasmo Voice Voice Changer

作者：sawiq_, EssciZ

Plasmo Voice 的客户端模组，添加了完整的实时变声器，支持预设、自定义调音、保存配置、自我监听以及原生设置界面。

模组 Fabric NeoForge 实用社交管理附属

截图

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

EN

适用于Plasmo Voice的 Fabric 和 NeoForge 模组，提供完整的变声器功能，内置预设，支持自定义调节和保存配置。变声效果仅在你自己的客户端生效；也可以将它安装到服务器上，为所有人设置统一规则，并分发你自己的音色。

✨ 功能

内置语音预设 – Man、Woman、Kid、Titan、Demon、Batman 和 Radio
实时处理外发语音 – 在 Plasmo Voice 编码并发送麦克风音频之前对其进行处理
音高与共振峰独立调节 – 分别调整音调和说话者听起来的体型，让升高后的声音听起来像另一个人，而不是花栗鼠
变声器工作室 – 布局与 Plasmo Voice 自带的设置相似：包含“效果”和“AI语音”选项卡，每项设置各占一行。打开时为简易模式，提供一个强度控制和麦克风音量表；高级模式则显示所有参数
清晰的信号处理链 – 提供噪声门、去齿音和输出限制器，避免房间噪声、嘶嘶声和爆裂声传入语音聊天
保存预设 – 将自定义配置保存为文件，以便日后加载
预设分享社区 – 加入 Discord 服务器分享自己的预设，并下载其他用户的预设
AI语音 – 使用 AI 语音代替效果处理：可在自己的电脑上免费实时运行 Voice Changer Engine 或 w-okada，也可以使用自己的 ElevenLabs 密钥。系统会自动选择引擎。参见 docs/AI_VOICE.md
一键安装引擎 – “AI语音”选项卡会根据你的显卡下载 Voice Changer Engine（NVIDIA RTX、较旧的 NVIDIA 显卡，或通过 DirectML 支持的 AMD 和 Intel 显卡），显示下载进度，并在你游玩时继续运行。模组会自动启动和停止引擎
直接添加语音 – 将 RVC 语音放入 voices 文件夹：可以放入包含对应 .index 的 .pth 文件，也可以直接放入下载的 .zip 文件。语音会显示在语音库中并自动选中，无需重启
训练自己的语音 – 将录音放入文件夹，即可在游戏内训练语音；模组会先检查录音，并提示缺少的内容
供其他模组使用的 API – 收音机、面具或机器可以在使用期间应用语音效果，并在使用结束后恢复原状；其他模组也可以将自定义语音添加到工作室。参见 docs/API.md
服务端支持 – 也在服务器上安装此模组，即可允许或禁止使用变声器、通过命令单独禁言玩家，并向所有已连接玩家分发自定义语音
无需服务器也能使用 – 除服务器策略外，所有功能都只需在客户端运行

🎮 入门指南

在客户端安装 Plasmo Voice 和此模组。使用 Fabric 时还需要安装 Fabric API。
打开 Plasmo Voice 设置，进入 Activations 选项卡，然后点击 Open Voice Changer Studio。
从网格中选择一种语音并设置强度。Self Listen 会播放处理后的自己的语音，让你听到其他人听见的效果。
按 J 即可开关效果，无需打开任何界面。你可以在同一选项卡中重新绑定该按键；这里还有一个默认未绑定的 Open Studio 按键。
要使用 AI 语音，请打开 AI Voice 选项卡并点击 Free, on my PC：模组会安装引擎，所需空间为 0.25 至 2.7 GB，具体取决于你的显卡。然后通过 Voices folder 添加语音，或训练 Your own voice。

这里的功能无需服务器：即使服务器没有安装此模组，除服务器策略外的所有功能仍可使用。

🛠️ 服务器管理员指南

服务器端也要安装此模组。首次启动时，它会写入 config/pv-voice-changer/server.properties，文件中对每个配置项都有说明。

先说明一点：语音会在说话者自己的设备上变声，然后才发送出去。以下所有规则都是未修改的客户端会遵守的策略，服务器无法强制执行。

命令 – /voicechanger，也可以简写为 /vc。默认仅限管理员使用。

限制 – all 允许玩家自由调整语音。presets 仅允许使用现成语音：内置语音、其他模组添加的语音，或此服务器共享的语音；不允许手动调整，也不允许使用个人预设文件。server-only 仅允许使用此服务器共享的语音。其他模组正在使用的语音（例如无线电语音）不会受到影响。

权限 – pv-voice-changer.use 决定谁可以更改自己的语音（默认所有人均可），pv-voice-changer.command 决定谁可以运行命令（默认仅限管理员）。权限由 Plasmo Voice 自带的权限系统管理，因此 LuckPerms 在两种加载器上都能使用。

共享自己的语音 – 在工作室中保存语音，点击 打开文件夹，将文件复制到服务器上的 config/pv-voice-changer/shared-voices/，然后运行 /voicechanger reload。所有已连接玩家的工作室中都会显示该语音；玩家离开后，语音也会消失。系统只会读取这些文件中的数字，并将每个数值限制在其对应范围内，因此无法借此让客户端加载或运行任何内容。

完整参考文档（包括供其他模组使用的 API）请见 docs/API.md。

📦 依赖项

Plasmo Voice – 必需
Fabric API – 仅 Fabric 版本需要

🔗 链接

GitHub： imsawiq/pv-voice-changer
Discord： 预设分享服务器
问题反馈： 报告错误或提出建议

RU

Мод для Plasmo Voice под Fabric и NeoForge, который добавляет полноценный войсченджер с готовыми пресетами, кастомной настройкой и сохранением профилей. Голос меняется на твоём клиенте; поставь мод ещё и на сервер, чтобы задавать правила для всех и раздавать свои голоса

✨ Особенности

现成的语音预设 – Man、Woman、Kid、Titan、Demon、Batman 和 Radio
真实的出站语音处理 – 在通过 Plasmo Voice 编码和发送之前就改变麦克风声音
音高与共振峰分离 – 音高和说话者的感知体型可以分别调整，所以提高后的声音听起来像另一个人，而不是花栗鼠
变声器工作室 – 布局和 Plasmo Voice 本身的设置一样：「效果」和「AI 语音」标签页，每项设置一行。简单模式下只有一个强度旋钮和麦克风指示器；高级模式下显示所有参数
干净的信号链 – 降噪、去齿音和限幅器，让房间噪音、嘶嘶声和爆音不会进入聊天
保存预设 – 可以把自定义设置保存到文件并加载
带预设的 Discord 服务器 – 可以分享自己的预设，也可以下载其他用户的预设
AI 语音 – 用 AI 语音代替效果：在自己的电脑上免费实时运行 Voice Changer Engine 或 w-okada，或者用自己的密钥使用 ElevenLabs。引擎会自动选择。参见 docs/AI_VOICE.md
一键安装引擎 – 「AI 语音」标签页会根据你的显卡（NVIDIA RTX、较旧的 NVIDIA，或通过 DirectML 的 AMD 和 Intel）下载 Voice Changer Engine，显示进度，并在你玩游戏时继续下载。模组会自动启动和停止引擎
语音直接丢进文件夹 – 把 RVC 语音放进语音文件夹，.pth 连同 .index，或者直接放下载的 .zip，它就会出现在语音库中并自动选中，无需重启
自己的声音 – 把自己的录音放进文件夹，直接在游戏里训练语音；模组会先检查录音并告诉你缺什么
供其他模组使用的 API – 对讲机、面具或机器可以临时替换语音再恢复；模组可以把自己的语音添加到工作室。参见 docs/API.md
服务端部分 – 模组也可以装在服务器上：允许或禁止改变语音，用命令禁言玩家，把自己的语音分发给所有进入的人
没有服务器也能用 – 除服务端策略外，一切都在客户端运行

🎮 从何开始

在客户端安装 Plasmo Voice 和这个模组。Fabric 上还需要 Fabric API。
打开 Plasmo Voice 设置中的激活标签页，点击打开变声器工作室。
从网格中选择语音并设置强度。Self Listen 会向你播放你自己处理后的声音——听到的正是别人听到的。
J 键开启和关闭效果，不打开任何界面。可以在同一处重新绑定，旁边还有打开工作室按键，默认未分配。
对于 AI 语音，打开AI 语音标签页并点击在我的电脑上免费使用：模组会自动安装引擎，根据显卡不同为 0.25 到 2.7 GB。然后通过语音文件夹添加语音，或训练自己的声音。

不需要为此搭建服务器：在没有模组的服务器上，除服务端规则外一切都能正常工作。

🛠️ 给服务器管理员

把模组也装到服务器上。首次启动时它会创建 config/pv-voice-changer/server.properties，其中每个键都在文件里直接说明。

先说明一下：语音会在发送前由说话者的机器进行变声。以下所有内容都是未经修改的客户端遵循的规则，服务器无法强制更改。

命令 — /voicechanger，简称 /vc。默认仅限管理员使用。

限制 — all 允许随意调整。presets 仅允许使用预设语音：内置语音、其他模组添加的语音或服务器分发的语音；不能手动调整，也不能使用个人预设文件。server-only 仅允许使用此服务器提供的语音。其他模组控制的语音（例如对讲机语音）始终不受这些限制。

权限 — pv-voice-changer.use 决定谁可以更改语音（默认所有人均可），pv-voice-changer.command 决定谁可以执行命令（默认仅限管理员）。权限通过 Plasmo Voice 自带的权限层处理，因此 LuckPerms 在两种加载器上都能正常工作。

分发自定义语音 — 在工作室中保存语音，点击打开文件夹，将文件复制到服务器上的 config/pv-voice-changer/shared-voices/，然后执行 /voicechanger reload。所有已连接玩家的工作室中都会出现该语音；玩家退出后，语音便会消失。程序只会读取这些文件中的数字，且每个值都会限制在各自的范围内，因此无法借此让客户端下载或执行任何内容。

完整参考文档（包括供其他模组使用的 API）请参阅 docs/API.md。