Skip to content

Sound

Воспроизводит или останавливает звуковой эффект или музыку на клиенте. Поддерживает зацикливание, регулировку громкости и высоты, а также плавные переходы.

Сторона

CLIENT

Синтаксис

sound <type:string> <action:string> <name:string> [volume:float=1.0] [pitch:float=1.0] [--loop] [fadeTime:float=0]

Параметры

  • type (string, обязательный): Категория звука. Допустимые значения: sfx (звуковой эффект), song (музыка), stop (используется с all для остановки всех активных звуков).
  • action (string, обязательный): Что делать со звуком. Допустимые значения: play, stop.
  • name (string, обязательный): Идентификатор звука. Используйте формат namespace:sound_name для кастомных звуков или просто sound_name для пространства имён minecraft. Используйте all с action stop, чтобы остановить все звуки данного типа.
  • volume (float, необязательный): Громкость воспроизведения от 0.0 до 1.0. По умолчанию 1.0.
  • pitch (float, необязательный): Множитель высоты звука. По умолчанию 1.0.
  • --loop (флаг, необязательный): Зацикливает звук до остановки.
  • fadeTime (float, необязательный): Длительность плавного изменения громкости в секундах при включении (play) или остановке (stop). По умолчанию 0.

Примеры

// Воспроизвести звуковой эффект на полной громкости
# sound sfx play minecraft:entity.thunder_clap
// Воспроизвести зацикленную музыку с плавным появлением
# sound song play mymod:music.theme --loop fadeTime:2.0
// Остановить конкретный трек с плавным затуханием
# sound song stop mymod:music.theme fadeTime:1.5
// Остановить все активные звуки мгновенно
# sound stop stop all