原创 开源 工具 [原版/萌芽/龙核(WIP)][EnvironmentalAudio] 环境音效 - 高度自定义环境音效/背景音乐 1.4

Area:
  test_area:
    Name: 区域1
    # 世界名
    World: world
    # 区块表
    # 坐标1(x y z) 坐标2(x y z)
    # 多个区块组成一个区块表 用于监测玩家坐标是否在这些区块中
    Chunks:
      - 0 0 0 0 0 0
      - 0 0 0 0 0 0
      - 0 0 0 0 0 0

Audio:
  default_audio1:
    Name: 测试音效1
    # 音效种类
    # DEFAULT   默认圆形距离检测范围音效
    # AREA      不规则区域检测音效
    Type: DEFAULT
    # 播放时执行事件
    # COMMAND 执行指令
    PlayEvent:
      Event1:
        Type: COMMAND
        # %player%替换玩家名
        # %state_id%替换音效状态ID
        # %state_name%替换音效状态名称
        Cmd: m %player% Play
        AsOP: false
        AsConsole: true
    # 停止时执行事件
    StopEvent:
      Event1:
        Type: COMMAND
        Cmd: m %player% Stop
        AsOP: false
        AsConsole: true
    AudioData:
      # 设置音效组 多个音效可以设置同个音效组
      Type: 主音效组
      # 支持 萌芽音效 龙核音效
      # 原版音效minecraft:xxx或modid:xxx
      # 萌芽音效加前缀"germmod:"
      # 龙核音效加前缀"dragon:"
      Sound: test
      # MASTER MUSIC RECORDS WEATHER BLOCKS HOSTILE NEUTRAL PLAYERS AMBIENT VOICE
      Category: MASTER
      # 音效是否循环
      Cycle: true
      # 重设循环时间
      # 启用时 进入音效范围内优先播放音效后再进入循环延迟
      # 关闭时 是否播放取决于全局延迟 这能距离内使全部玩家都同时播放音效 (如果准备播放时玩家不在区域内 音效不会为该玩家播放)
      CycleReset: false
      # 需要能被AudioConfig-Threshold整除的数
      # 循环延迟(固定每多少毫秒播放一次 比音效长度短可能会造成音效重复播放) 小等于0禁用
      CycleDelay: 0
      # 需要能被AudioConfig-Threshold整除的数
      # 音效长度(秒)(暂无用)
      Length: 0
      # 音效量与音高
      Volume: 1
      Pitch: 1
      # 音效触发范围
      Range: 100
      # 音效淡出效果(仅支持萌芽)
      # 开启Enhance后无效
      FadeOut: 80
      # 增强效果
      # 使音效支持3D效果 仅基础音效种类(圆形距离检测)可用
      # 仅支持单通道的音效文件 双通道没有3D效果
      # 使用的原版音效播放
      Enhance: true
      # 冲突音效 在以下音效播放的时候禁止播放
      Exclude:
        - "冲突音效"
      # 静音音效 播放时静音以下音效
      Mute:
        - "将静音的音效"
  area_audio1:
    Name: 测试音效1
    Type: AREA
    # 使用的区域配置(area/xxx.yml)
    Area: test_area
    AudioData:
      Type: 主音效组
      Sound: test
      Category: MASTER
      Cycle: true
      Delay: 0
      Length: 0
      Volume: 1
      Pitch: 1
      Range: 100
      FadeOut: 80
      Enhance: true
      Exclude:
        - "冲突音效"
      Mute:
        - "将静音的音效"

AudioState:
  world_default_audio1:
    # 可删除 默认使用音效的配置名(Name)
    Name: 测试音效1
    # 指向配置的音效(audio/xxx.yml)
    Audio: default_audio1
    Location: world 0 0 0
    # 可删除 默认音效的配置(AudioData)
    AudioData:
      Type: 主音效组
      Sound: germmod:test
      Category: MASTER
      Cycle: true
      CycleDelay: 0
      Length: 0
      Volume: 1
      Pitch: 1
      Range: 100
      FadeOut: 80
      Enhance: true
      Exclude: []
      Mute: []
  world_area_audio1:
    # 可删除 默认使用音效的配置名(Name)
    Name: 测试音效1
    # 指向配置的音效(audio/xxx.yml)
    Audio: area_audio1
    Location: world 0 0 0

# 控制台信息输出
Debug: true
# 是否开启检测文件修改后重载配置文件
EnableFileCheck: true
# 异步检测
# 功能暂未完成
Async: true
# 当启用TickCheck时 每Threshold个tick 监测一次玩家位置以计算播放音效
# 当关闭TickCheck时 玩家每移动Threshold个tick 监测一次玩家位置以计算播放音效
# 所有音效长度 循环延迟设置都需要能整除Threshold 否则音效将会失效
EnableTickCheck: true
Threshold: 1

    public static void example()
    {
        //创建音效
        //创建自动添加到全局音效库里(AudioManager.audios)
        audio = new Audio("example","实例音效");

        //可设置回调
        audio.registerCallbackCheck((p,s)->{return true;});
        audio.registerCallbackStop((p,s)-> {return true;});
        audio.registerCallbackPlay((p,s)-> {return true;});

        //通过音效数据修改内容
        //详细请看配置文件或者内部定义
        AudioData audioData = audio.data;
        //设置音效请用AudioData.setSound(String)
        //# 支持 萌芽音效 龙核音效
        //# 原版音效minecraft:xxx或modid:xxx
        //# 萌芽音效加前缀"germmod:"
        //# 龙核音效加前缀"dragon:"
        audioData.setSound("germmod:xxx");


        //以音效可创建多个音效状态
        //id name data默认为音效的配置
        AudioState state = audio.createState(new Location(Bukkit.getWorld("world"),0,0,0));

        //音效状态生效需到AudioManager注册
        AudioManager.registerAudioState(state);

        //可随时设置音效是否开启
        state.setEnable(false);
    }