Simple Voice Mechanics

插件

· 作者 F02K

使用 Simple Voice Chat 和 Simple Voice Mechanics,让游戏听到你的声音!

0 本站下载 0 关注 更新于 4 个月前

最新 1.4.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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.19+

安装

  1. 安装 Simple Voice Chat
  2. 将 SimpleVoiceMechanics JAR 文件放入 plugins/ 文件夹
  3. 重启服务器
  4. 根据需要调整 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

技术细节

检测流程:

  1. 接收音频数据包 → 解码 Opus → 计算分贝值
  2. 新增:应用环境修正系数(生物群系 + 时间)
  3. 检查类别阈值 → 计算有效范围
  4. 基于概率的检测 → 自然行为检查
  5. 执行动作(攻击/注视/逃跑/跟随)
  6. 新增:若检测到敌对目标,通知附近的盟友

公式:

有效范围 = 配置范围 × 生物群系乘数 × 时间乘数 × (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
  • 环境声学灵感来源于现实世界的声音传播

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源