Interface Sound

All Superinterfaces:
net.kyori.examination.Examinable

@NonExtendable
public interface Sound
extends net.kyori.examination.Examinable
Represents an in-game sound which can be played to the client.

A sound consists of:

key/type
the resource location of this sound (e.g minecraft:ambient.cave or my_plugin:custom_sound
source
a Sound.Source telling the game where the sound is coming from
volume
a number in the range [0,∞) representing how loud the sound should be played. Increasing volume does not actually play the sound louder, but increases the radius of where it can be heard
pitch
a number in the range [0,2] representing which pitch the sound should be played at
Since:
4.0.0
See Also:
SoundStop
  • Nested Class Summary

    Nested Classes
    Modifier and Type Interface Description
    static class  Sound.Source
    The sound source.
    static interface  Sound.Type
    A sound type.
  • Method Summary

    Modifier and Type Method Description
    @NonNull net.kyori.adventure.key.Key name()
    Gets the name.
    float pitch()
    Gets the pitch.
    static @NonNull Sound sound​(@NonNull Supplier<? extends Sound.Type> type, @NonNull Sound.Source source, float volume, float pitch)
    Creates a new sound.
    static @NonNull Sound sound​(@NonNull net.kyori.adventure.key.Key name, @NonNull Sound.Source source, float volume, float pitch)
    Creates a new sound.
    static @NonNull Sound sound​(@NonNull Sound.Type type, @NonNull Sound.Source source, float volume, float pitch)
    Creates a new sound.
    @NonNull Sound.Source source()
    Gets the source.
    float volume()
    Gets the volume.

    Methods inherited from interface net.kyori.examination.Examinable

    examinableName, examinableProperties, examine
  • Method Details

    • sound

      static @NonNull Sound sound​(@NonNull net.kyori.adventure.key.Key name, @NonNull Sound.Source source, float volume, float pitch)
      Creates a new sound.
      Parameters:
      name - the name
      source - the source
      volume - the volume
      pitch - the pitch
      Returns:
      the sound
      Since:
      4.0.0
    • sound

      static @NonNull Sound sound​(@NonNull Sound.Type type, @NonNull Sound.Source source, float volume, float pitch)
      Creates a new sound.
      Parameters:
      type - the type
      source - the source
      volume - the volume
      pitch - the pitch
      Returns:
      the sound
      Since:
      4.0.0
    • sound

      static @NonNull Sound sound​(@NonNull Supplier<? extends Sound.Type> type, @NonNull Sound.Source source, float volume, float pitch)
      Creates a new sound.
      Parameters:
      type - the type
      source - the source
      volume - the volume
      pitch - the pitch
      Returns:
      the sound
      Since:
      4.0.0
    • name

      @NonNull net.kyori.adventure.key.Key name()
      Gets the name.
      Returns:
      the name
      Since:
      4.0.0
    • source

      @NonNull Sound.Source source()
      Gets the source.
      Returns:
      the source
      Since:
      4.0.0
    • volume

      float volume()
      Gets the volume.
      Returns:
      the volume
      Since:
      4.0.0
    • pitch

      float pitch()
      Gets the pitch.
      Returns:
      the pitch
      Since:
      4.0.0