[DCME] 动态情境音乐引擎

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

DCME

`[DCME]` 动态情境音乐引擎

DCME 用一套完全动态、感知情境的音乐系统取代了 Minecraft 原版的音乐系统。音乐会根据你正在进行的活动实时调整：探索、战斗、下矿洞、面对 Boss，或是观看制作人员名单。

重要：需要资源包

DCME 是一个音乐引擎，不包含音乐曲目。你需要在游戏内听到音乐，就需要一个兼容的资源包。在 CurseForge 或 Modrinth 上搜索 [DCME] 即可找到社区制作的配乐。

如果你制作了一个音乐包，请在项目标题中加入 [DCME]，方便用户找到它。

情境音乐

该模组每秒都会评估数十种条件，并为当下的情景播放合适的音乐：

主世界 - 白天、夜晚、黎明和黄昏各有自己的配乐
天气 - 下雨会触发专属的氛围音乐
地下 - 洞穴和深暗之域拥有独特的音乐
维度 - 下界和末地拥有截然不同的音景
战斗（PvE） - 当敌对生物锁定你时，动态音乐会响起
战斗（PvP） - 攻击者和受害者都会触发音乐，并具备队伍保护和可配置的超时时间
Boss - 凋灵、末影龙和远古守卫者各有专属的 Boss 主题曲
界面 - 主菜单和制作人员名单拥有自己的音乐

平滑过渡

3 种过渡模式 - 交叉淡入淡出（同时淡出淡入）、间隔（曲目之间静音）或混合（同一分组内交叉淡入淡出，分组之间间隔）
战斗叠加 - 战斗音乐播放时，基础音乐淡出至近乎静音，随后从离开的位置继续播放
Boss 战 - 在长时间 Boss 遭遇战中，基础音乐会释放以节省资源
维度过渡 - 进入传送门时音频状态会干净地重置
曲末淡出 - 曲目在接近结尾时会优雅地淡出，而不是戛然而止

PvP 战斗检测

DCME 在服务端追踪玩家对玩家的战斗。当一名玩家击中另一名玩家时，双方都会收到 PvP 战斗音乐信号。

双向触发 - 双方玩家都会获得战斗音乐
队伍保护 - 同一计分板队伍中的玩家之间不会触发 PvP 音乐
可配置超时 - 音乐在最后一次击中后可配置的持续时间内保持激活（默认：5 秒）

播放一次（智能分组）

情境可以在过渡之前播完当前曲目，但仅在同一个分组内生效。切换维度或从地表进入地下时，始终会立即交叉淡入淡出。

分组：overworld_surface、overworld_underground、nether、end、screen、combat、boss

配置

JSON 配置位于 config/dcme.json - 主音量、淡入淡出时长、曲目间隔、战斗半径、PvP 超时、队伍保护、各情境开关等更多内容
游戏内配置界面通过 Mod Menu - 无需编辑文件即可开关每个情境、调整 PvP 设置并更改过渡模式
各情境独立覆盖 - 每个情境都可以定义自己的音量、淡入淡出时间和间隔时长

通过资源包实现 100% 自定义

替换曲目 - 通过资源包替换任意 OGG 文件
添加新情境 - 创建 JSON 文件来定义新的音乐触发条件
覆盖现有情境 - 用自己的情境替换任意默认情境
自定义条件 - 生物群系、维度、一天中的时间、天气、海拔、天空光照、战斗、Boss、结构、季节、进度等更多内容

请参阅随附的示例资源包和数据包以获取完整指南。

配置文件夹覆盖

将情境 JSON 放入 config/dcme/contexts/，即可无需资源包覆盖任意情境。优先级最高 - 会同时覆盖默认值和资源包。

第三方音乐拦截

DCME 会拦截其他模组播放它们自己的音乐，以防止冲突。可在 config/dcme.json 中按命名空间进行配置。唱片机音乐永远不会被拦截。

情境优先级系统

情境	优先级	层级	分组
末影龙	100	覆盖	boss
凋灵	95	覆盖	boss
远古守卫者	90	覆盖	boss
战斗（监守者）	85	覆盖	combat
战斗（通用）	80	覆盖	combat
制作人员名单	70	基础	screen
菜单	60	基础	screen
深暗之域	50	基础	overworld_underground
地下	40	基础	overworld_underground
下雨	38	基础	overworld_surface
黎明	22	基础	overworld_surface
黄昏	22	基础	overworld_surface
夜晚	20	基础	overworld_surface
白天 / 下界 / 末地	10	基础	（视情况而定）

兼容

Mod Menu - 用于游戏内配置界面
Serene Seasons / Fabric Seasons - 基于季节的音乐
Sound Physics Remastered、AmbientSounds
PartyAddon 以及任何使用计分板队伍的组队模组

用于 Legends Reborn: Medieval 整合包。