[DCME] Dynamic Contextual Music Engine

[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 设置并更改过渡模式
• 各情境单独覆盖设置 – 每种情境都可以单独设置音量、淡入淡出时长和间隔时长

资源包支持完全自定义

• 替换曲目 – 通过资源包替换任意 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。