Plasmo Voice Quick Guide (NeoForge 1.21.1)

Plasmo Voice 是一款“近距离语音（Proximity Voice Chat）”模组/插件体系，主打 3D 声音定位与沉浸式交流。安装后，你与其他玩家的声音会随距离衰减，并具有方向感（更像现实中的“你在左边说话/你在背后说话”）。

Plasmo Voice 支持多平台服务端（如 Paper/Folia/Forge/NeoForge 等）与多平台客户端（Fabric/Forge/NeoForge），通常要求“服务端安装 + 玩家客户端安装”才能使用语音功能；未安装客户端的玩家仍可正常进入服务器，只是无法使用语音。

Installation

Client Setup

首次进入世界后，建议立刻按V打开语音设置界面，确认输入/输出设备正确，并进行麦克风测试；如果你使用 Push-to-Talk，务必把按键改成自己最顺手的键。

Keybinds

说明：以下为“常见默认按键”。不同整合包可能会修改绑定；如有冲突，请到 Controls/Keybinds 里重新设置。

Core Keys

V：打开语音设置/主菜单。
Left Alt：Push-to-Talk（按住说话）。
.：麦克风静音（Mute）。

Practical Mouse Actions

对着某个玩家按住鼠标右键（RMB）并滚动滚轮：快速调节该玩家的音量，适合临时“把某人调小/调大”。

Getting Started

5-Minute Checklist

按 V 打开菜单，在 Devices/Audio 类页面里选择正确的输入（麦克风）与输出（耳机/音箱）。
打开麦克风测试，确认游戏能收到你的声音且没有严重爆音。
在 Activation 里选择你想用的说话方式：
- Push-to-Talk：按住按键才说话，最不扰民。
- Voice Activation：检测到声音就自动说话，适合双手忙时。
进入多人环境后，先找队友试音：确认彼此音量、延迟、以及是否有“回声/串音”。

Advanced Features

Audio Quality & Immersion

你可以在设置中针对沉浸感与清晰度做取舍：

3D 定位与距离衰减：让声音更有方向感与空间感。
声音遮挡（Occlusion）：隔着方块说话会被“闷住”，更真实。
方向性音源：当说话者背对你时会更小声，强调“朝向”。

Overlay & UI

Plasmo Voice 提供类似 Discord 的 HUD/Overlay：

显示你当前听到谁、谁在说话。
可调节玩家图标显示与位置，避免遮挡其他 UI 模组。

Activation Model (Why It Matters)

在 2.x 体系里，“说话方式”以 Activation 为核心：

Proximity（近距离）是一种 Activation。
Add-on（如 Groups）也可以提供独立 Activation。
你可以把多个 Activation 设为同一个按键（例如 Inherit），实现“一键同时对近距离与小队频道说话”的效果（如果你希望这样）。

Privacy & Control

你可以在客户端随时静音自己的麦克风，或禁用语音功能。
服务端通常也能通过指令/权限进行管理（如禁言、踢出未安装客户端的玩家、与权限系统联动）。

Groups Add-on (pv-addon-groups)

Overview

为 Plasmo Voice 增加“分组语音频道”，使你能与队友在远距离甚至不同子服间保持通话。

该 add-on 目前以 聊天指令管理分组；未来可能会有 GUI 侧的增强，但常规使用不依赖 GUI。

Setup

Enable Groups Activation

按 V 打开 Plasmo Voice 菜单。
进入 Activation 选项卡。
找到 Groups activation，并为其选择模式：
- Push-to-Talk：给小队频道单独绑一个按键。
- Inherit：让小队频道跟随 Proximity 的触发（实现“一键双通道”）。

Create & Invite

创建分组：/groups create（可带 flags）
邀请玩家：/groups invite <player>
浏览公开分组：/groups 或 /groups browse

Common Commands

/groups info：查看当前分组信息。
/groups leave：退出当前分组。
/groups delete：删除当前分组（通常需要组主权限）。
/groups transfer <player>：转移组主。
/groups kick <player>：踢出成员。
/groups ban <player> / /groups unban <player>：封禁/解封。

Flags & Use Cases

创建分组时可用 flags 改行为（顺序通常不敏感）：

name:：分组名。
password:：分组密码，适合公开服务器。
persistent:：设置为 true 后，分组不会因“无人/重启”自动消失，适合长期小队。
permissions:：限制只有拥有特定权限的玩家可加入（适合公会/管理组）。

示例（仅示意）：

/groups create name: TeamA password: 123456 persistent: true

Recommended Workflow

生存开荒：用 Proximity 做近距离交流；遇到分头行动时，启用 Groups 作为“队伍频道”。
大型服务器/多子服：如果你有代理环境，优先把 groups add-on 安装在代理侧，以便跨服通话。
PTT 习惯：建议把 Proximity 与 Groups 分配为不同按键，避免误把闲聊广播到队伍频道。

Troubleshooting

No One Can Hear Me

检查输入设备是否选对、麦克风是否被系统独占。
确认你没有按到 M（静音）或在设置里禁用了输入。
如果用 Push-to-Talk：确认按键绑定没有冲突，且你按住时有“说话指示”。

I Can’t Hear Others

检查输出设备与主音量。
确认没有把对方音量滚轮调到很小。
服务器侧可能限制了语音距离或某些功能（尤其在有权限系统/规则的服务器）。

Groups Doesn’t Work

确认服务端已安装 pv-addon-groups（并与 Plasmo Voice 版本兼容）。
确认你在 V -> Activation 中启用了 Groups activation。
确认你已加入某个分组，且你说话时触发的是“Groups”对应的 activation。

Quick Cheat Sheet

打开菜单：V
按住说话（PTT）：Left Alt
麦克风静音：.
调整某玩家音量：对着玩家 按住 RMB + 滚轮
创建分组：/groups create
邀请玩家：/groups invite <player>
浏览分组：/groups / /groups browse
退出分组：/groups leave

语音通话