/music

/music

来源：Commands/music；原文修订 ID：3187584。

本命令仅适用于基岩版和教育版；权限等级为 1，需要启用作弊。

播放、排队或停止音乐，或调整音乐音量。

语法

  • music play <trackName: string> [volume: float] [fadeSeconds: float] [repeatMode: MusicRepeatMode]：播放音乐曲目。
  • music queue <trackName: string> [volume: float] [fadeSeconds: float] [repeatMode: MusicRepeatMode]：将曲目加入播放队列。
  • music stop [fadeSeconds: float]：停止音乐。
  • music volume <volume: float>：调整音量。

参数

  • trackName: string（basic_string）：要播放的音乐曲目名称，例如 record.cat；也可以是在 <a_resource_pack>/sounds/sound_definitions.json 的 JSON 路径 "record.<music_name>" 或 "music.game.<music_name>" 下定义的音乐名，例如 cat 用于播放 Cat 音乐唱片。
  • volume: float：曲目音量，必须是浮点数，且应在 0–1 范围内（含边界）。
  • fadeSeconds: float：曲目淡入/淡出的时长，必须是浮点数，且应在 0–10 范围内（含边界）。
  • repeatMode: MusicRepeatMode：是否循环播放，必须为 loop 或 play_once，省略时默认为 play_once。

结果

条件 基岩版结果
命令不完整或任意参数不正确 无法解析
/music play ... 的淡入时长不在 0–10 或音量不在 0–1 失败
/music queue ... 时当前音乐设为 loop，或音量不在 0–1，或淡入时长不在 0–10 失败
/music stop ... 时没有音乐播放，或淡出时长不在 0–10 失败
/music volume ... 的音量不在 0–1 失败
其他情况 成功

输出

失败时成功次数为 0，成功时为 1。

示例

  • 循环播放 Pigstep 音乐唱片：/music play record.pigstep 0.5 0 loop。
  • 将 Stal 音乐唱片加入队列：/music queue record.stal 0.5 0 play_once。

外部链接

中文翻译/改编自 Minecraft Wiki 原条目，原文作者可由页面历史查看；译文遵循 CC BY-NC-SA 3.0（署名、非商业性使用、相同方式共享）。