# SculkVoicePlugin
SculkVoicePlugin 是一个轻量级且创新的插件，专为运行 Minecraft **1.19 至 1.21.5** 版本的 Paper、Bukkit 和 Purpur 服务器设计。 此插件通过与 **Simple Voice Chat** 集成增强游戏玩法，允许玩家的语音活动触发游戏中的 **sculk 传感器震动**。 当玩家通过麦克风说话时，该插件会根据可配置的阈值生成微弱或强烈的 sculk 震动，为您的 Minecraft 服务器增加一层沉浸感。
无论您运行基于 sculk 的红石装置的生存服务器，还是利用 sculk 传感器的自定义地图，SculkVoicePlugin 都会将语音通信与游戏机制联系起来，创造独特的互动体验。
## 特性
- **语音激活的 sculk 震动**: 当玩家使用 Simple Voice Chat 说话时，触发微弱或强烈的 sculk 传感器震动。
- **高度可配置**: 自定义震动阈值、冷却时间和低语和潜行的音量修改器。
- **组支持**: 可选地将震动限制为特定语音组中的玩家。
- **可切换系统**: 通过命令启用或禁用语音检测系统。
- **基于权限的控制**: 使用管理员和玩家的权限进行细致的访问控制。
- **轻量级和兼容**: 在 Minecraft 1.19 至 1.21.5 的 Paper、Bukkit 和 Purpur 服务器上无缝运行。
## 安装
1. 确保您的服务器安装了 **Simple Voice Chat**，因为它是一个软依赖项。
2. 从 [releases page](https://modrinth.com/plugin/sculkvoiceplugin/versions) 下载 `SculkVoicePlugin.jar` 的最新版本。
3. 将 `.jar` 文件放在服务器的 `plugins` 文件夹中。
4. 重新启动您的服务器以加载插件。
5. 在 `plugins/SculkVoicePlugin/config.yml` 中配置插件设置以满足您的需求。
## 配置
插件可以通过 `config.yml` 文件进行高度自定义，允许您微调语音活动触发 sculk 震动的方式。 以下是配置选项的概览：
- **`enabled`**: 启用或禁用语音检测系统 (`true`/`false`)。
- **`weak-vibration-threshold`**: 设置微弱震动的阈值 (默认: `400.0`)。
- **`strong-vibration-threshold`**: 设置强烈震动的阈值 (默认: `1500.0`)。
- **`cooldown-duration`**: 定义玩家触发另一个震动前的冷却时间（以 tick 为单位）(默认: `20`)。
- **`restrictions.groups`**: 将震动限制为语音组中的玩家 (`true`/`false`)。
- **`restrictions.whispering`**: 启用低语时的降低音量震动 (`true`/`false`)。
- **`restrictions.whisper-factor`**: 低语的音量降低系数（0.0 = 沉默，1.0 = 无变化，默认: `0.8`）。
- **`restrictions.sneaking`**: 启用潜行时的降低音量震动 (`true`/`false`)。
- **`restrictions.sneak-factor`**: 潜行时的音量降低系数（0.0 = 沉默，1.0 = 无变化，默认: `0.7`）。
**示例 `config.yml`:**
```yaml
# SculkVoicePlugin Plugin Configuration
enabled: true
weak-vibration-threshold: 400.0
strong-vibration-threshold: 1500.0
cooldown-duration: 20
restrictions:
groups: false
whispering: true
whisper-factor: 0.8
sneaking: true
sneak-factor: 0.7
```
## 命令
- **`/sculkvoice toggle`**: 启用或禁用 sculk 震动的语音检测系统。
- **用法**: `/sculkvoice toggle`
- **权限**: `sculkvoice.admin`（默认：仅限 operator）
## 权限
- **`sculkvoice.admin`**: 允许玩家使用 `/sculkvoice` 命令来切换语音检测系统。
- **默认**: 仅限 Operator
- **`sculkvoice.ignore`**: 免除玩家基于语音生成 sculk 震动。
- **默认**: `false`（默认未授予）
## 依赖项
- **依赖项**: [Simple Voice Chat](https://modrinth.com/plugin/simple-voice-chat)
- 确保安装 Simple Voice Chat，以便插件能够正常运行。
## 兼容性
- **Minecraft 版本**: 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
- **服务器类型**: Paper, Bukkit, Purpur
- **API 版本**: 1.19 (与较新版本兼容)
## 致谢
- **作者**: RazorPlay
- **网站**: [https://github.com/RazorPlay01](https://github.com/RazorPlay01)