Music Trigger

Music Trigger

一个模组,让你在完成FTB任务时播放特定音乐。

游戏机制

概述

本模组允许你在完成 FTB 任务时播放自定义音乐曲目。用法如下:

    // kubejs/server_scripts/example.js
    
    /**
     * 任务完成时播放音乐
     * 
     * @param {string} questLinkObjectId - 任务 ID(可从任务 UI 中复制)
     * @param {string} fileName          - 音频文件名 .mp3、.wav 或 .flac(必须位于 config/music_trigger/audio/ 目录中)
     * @param {number} volume            - 播放音量,范围:[0.0, 1.0]
     * @param {string} scope             - 播放范围("self"、"nearby" 或 "all")
     * @param {boolean} stopVanillaMusic - 播放时是否抑制原版 Minecraft 背景音乐(可能导致意外行为)
     */
    
    MusicTriggerEvents.registerMusicTriggers(event => {
        // 基本用法:任务完成时为所有玩家播放音乐
        event.register("#67C8AAFC31D6F28B", "victory.mp3", 1.0);
    
        // 高级用法:仅完成任务的玩家能听到,并停止原版音乐
        event.register("#67C8AAFC31D6F28B", "secret_theme.mp3", 0.8, "self", true);
    
        // 或者仅为附近玩家播放
        event.register("#67C8AAFC31D6F28B", "boss_music.flac", 1.0, "nearby");
    });