Simple Voice Mechanics
对 Minecraft 中生物声音反应的模组。使用 Simple Voice Chat 进行动态音频检测,基于音量和距离的行为逻辑。
功能特性
- 实时音频分析:Opus 解码与分贝 (dB) 计算
- 动态范围:更大的声音能从更远的地方被听到(基础范围的 40%-220%)
- 环境修饰符:基于生物群系和时间的声学效果(洞穴回声、森林消音、夜晚 = 更敏感)
- 生物群呼警报:敌对生物会呼叫增援(僵尸召唤尸潮,狼群协同狩猎)
- 自然行为:概率性反应、冷却时间、视线接触系统
- 4 种生物类别:敌对(攻击)、中立(注视)、和平(注视/逃跑/跟随)、监守者(愤怒系统)
- 幽匿传感器:大音量时基于 GameEvent 激活
生物行为
| 类别 | 反应 | 阈值 | 特殊功能 |
|---|---|---|---|
| 敌对 | 攻击 | -40 dB | 锁定玩家,通知附近盟友(新增) |
| 中立 | 注视 (8秒) | -35 dB | 60% 反应几率 |
| 和平 | 注视 (10秒) | -30 dB | >-20 dB 时逃跑,潜行 + 视线接触时跟随 |
| 监守者 | 愤怒 +15-60 | -20 dB | 取决于音量和距离 |
| 幽匿 | 激活 | -20 dB | 仅在大音量时激活 |
和平类生物详情:
- 正常说话:注视玩家
- 大声说话 (>-20 dB):向后退 3 格逃跑
- 潜行 + 说话 + 视线接触:跟随 60 秒
环境影响
| 环境 | 范围修饰 | 敏感度 | 示例 |
|---|---|---|---|
| 洞穴 + 夜晚 | ~2.0x | -13 dB | 极度危险 - 生物能听到远处的耳语 |
| 森林 + 白天 | 0.75x | +3 dB | 更安全 - 植被削弱了声音 |
| 下界 | 1.3x | 正常 | 开阔空间中声音传播更远 |
| 山峰 + 夜晚 | 1.56x | -8 dB | 声音在峰峦间回荡 |
生物群呼警报:
- 僵尸:呼叫 16 格内的 5 名盟友 → 尸潮攻击
- 狼:通知 20 格内的狼群同伴 → 协同狩猎
- 猪灵:召唤 18 格内的群体 → 集团战斗
要求
- Minecraft 1.18+ (Paper 或兼容服务端)
- Java 17+
- Simple Voice Chat 插件
注意: 幽匿传感器需要 Minecraft 1.19+
安装
- 安装 Simple Voice Chat
- 将 SimpleVoiceMechanics JAR 文件放入
plugins/文件夹 - 重启服务器
- 根据需要调整
plugins/SimpleVoiceMechanics/config.yml
配置
全局设置
detection:
max-range: 16.0
min-range: 2.0
falloff-curve: 1.0 # 0.5-2.0 (0.5=线性, 2.0=陡峭)
环境修饰符
environmental-modifiers:
biome-modifiers:
enabled: true # 洞穴回声,森林消音
time-modifiers:
enabled: true # 夜晚 = 范围增加 30%,敏感度提高 8 dB
生物群呼警报
mob-hearing:
hostile-mobs:
group-alert:
enabled: true
max-alerts: 5 # 每次检测最多召唤的生物数量
ranges:
zombie: 16.0 # 尸潮半径
wolf: 20.0 # 狼群半径
piglin: 18.0 # 猪灵群体半径
按类别设置
peaceful-mobs:
enabled: true
volume-threshold-db: -30.0
max-range: 8.0
natural-behavior:
reaction-chance: 0.7 # 70% 反应概率
look-duration: 10 # 注视持续时间(秒)
reaction-cooldown: 3 # 反应之间的冷却时间
flee-behavior:
enabled: true
flee-volume-db: -20.0
flee-distance: 3.0
flee-duration: 3
follow-when-sneaking:
enabled: true
require-eye-contact: true
eye-contact-range: 4.0
eye-contact-memory: 5
duration: 60
max-distance: 12.0
blacklist: [] # 排除的实体类型
音量刻度 (dB)
- -60 dB:耳语
- -40 dB:正常说话(默认敌对生物阈值)
- -30 dB:安静到正常(默认和平生物阈值)
- -20 dB:大声说话(默认监守者/幽匿阈值)
- -10 dB:喊叫
命令
/voicelistener reload- 重新加载配置/voicelistener toggle <hostile|neutral|peaceful|warden|sculk>- 切换类别/voicelistener status- 显示当前配置
别名: /vl, /voicemechanics
权限
voicelistener.admin(默认: op)
预设示例
潜行服务器
hostile-mobs:
volume-threshold-db: -50.0 # 检测到耳语
max-range: 24.0
falloff-curve: 0.8
environmental-modifiers:
biome-modifiers:
enabled: true # 洞穴更加危险
time-modifiers:
enabled: true # 夜晚令人恐惧
动作服务器
hostile-mobs:
volume-threshold-db: -25.0 # 仅大声说话
max-range: 12.0
falloff-curve: 1.5
group-alert:
enabled: true
max-alerts: 8 # 更大的生物群!
监守者极限挑战
warden:
volume-threshold-db: -60.0 # 听到一切!
max-range: 32.0
falloff-curve: 0.5
硬核生存
environmental-modifiers:
biome-modifiers:
enabled: true
time-modifiers:
enabled: true
mob-hearing:
hostile-mobs:
volume-threshold-db: -50.0
group-alert:
enabled: true
max-alerts: 10 # 巨大的尸潮!
游戏实例
夜间洞穴探索:
- 生物群系:洞穴 (1.5x 范围,-5 dB)
- 时间:夜晚 (1.3x 范围,-8 dB)
- 综合:~2x 范围,敏感度提高 13 dB
- 结果:耳语会从远处吸引僵尸。1 只僵尸呼叫 5 只更多 → 6 只僵尸攻击!
森林潜行(白天):
- 生物群系:森林 (0.75x 范围,+3 dB)
- 时间:白天 (正常)
- 综合:0.75x 范围
- 结果:植被削弱了声音。正常说话是安全的。
下界要塞:
- 生物群系:下界 (1.3x 范围)
- 生物:猪灵 (18 格警报范围)
- 结果:1 只猪灵听到你 → 通知附近 5 只猪灵 → 协调的集团攻击
调试选项
debug:
audio-logging: false
range-logging: false
detection-logging: false
warden-logging: false
sculk-logging: false
peaceful-logging: false
environmental-logging: false
group-alert-logging: false
技术细节
检测流程:
- 接收音频数据包 → 解码 Opus → 计算分贝值
- 新增:应用环境修正系数(生物群系 + 时间)
- 检查类别阈值 → 计算有效范围
- 基于概率的检测 → 自然行为检查
- 执行动作(攻击/注视/逃跑/跟随)
- 新增:若检测到敌对目标,通知附近的盟友
公式:
有效范围 = 配置范围 × 生物群系乘数 × 时间乘数 × (1.0 + (分贝值 - 阈值) / 25.0)
上限限制:0.5倍至2.5倍
检测概率 = (1 - 归一化距离)^衰减曲线
≤ 最小范围时 100%,≥ 最大范围时 0%
生物警报 = 动态生成(1-5次,取决于距离,距离越近警报次数越多)
API 使用
@EventHandler
public void onVoiceDetected(VoiceDetectedEvent event) {
Player player = event.getPlayer();
double decibels = event.getDecibels();
// 自定义逻辑
}
// 访问配置
ConfigManager config = plugin.getConfigManager();
double threshold = config.getHostileVolumeThresholdDb();
boolean biomeMods = config.isBiomeModifiersEnabled();
// 新的工具类
Biome biome = location.getBlock().getBiome();
double rangeMultiplier = BiomeModifier.getRangeMultiplier(biome);
boolean isNight = TimeModifier.isNight(world);
boolean isSocial = MobGroupAlert.isSocialMob(EntityType.ZOMBIE);
开发者 API
其他插件可以通过 Bukkit 服务 API 进行集成:
import de.tecca.simplevoicemechanics.api.HookPriority;
import de.tecca.simplevoicemechanics.api.MobReactionType;
import de.tecca.simplevoicemechanics.api.SimpleVoiceMechanicsApi;
import org.bukkit.Location;
import org.bukkit.plugin.RegisteredServiceProvider;
import org.bukkit.plugin.java.JavaPlugin;
public final class RegionVoiceBridge extends JavaPlugin {
private SimpleVoiceMechanicsApi voiceApi;
@Override
public void onEnable() {
RegisteredServiceProvider<SimpleVoiceMechanicsApi> provider =
getServer().getServicesManager().getRegistration(SimpleVoiceMechanicsApi.class);
if (provider == null) {
getLogger().warning("SimpleVoiceMechanics API is not available");
return;
}
voiceApi = provider.getProvider();
voiceApi.registerMobReactionHook(this, HookPriority.NORMAL, context -> {
if (context.getReactionType() == MobReactionType.HOSTILE_TARGET
&& isInProtectedRegion(context.getPlayer().getLocation())) {
context.setCancelled(true);
}
});
}
@Override
public void onDisable() {
if (voiceApi != null) {
voiceApi.unregisterHooks(this);
}
}
private boolean isInProtectedRegion(Location location) {
return false;
}
}
可用的服务钩子:
registerDetectionHook可以取消语音机制或在正常处理前调整有效分贝值。registerMobReactionHook可以取消特定的生物反应,例如敌对目标锁定、隐形玩家调查、群体警报、逃跑、跟随或监守者愤怒。registerSculkActivationHook可以取消单个幽匿感测体的激活。
拥有 voicelistener.bypass 权限的玩家不会触发生物或幽匿的语音机制。
构建
git clone https://github.com/yourusername/SimpleVoiceMechanics.git
cd SimpleVoiceMechanics
mvn clean package
许可证
MIT License
致谢
- 音频计算改编自 Simple Voice Chat (henkelmax)
- 基于 Paper 构建
- SimpleVoiceChat API
- 环境声学灵感来源于现实世界的声音传播
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
评论 0
登录后参与评分
还没有评论,来抢沙发吧