Package net.kyori.adventure.sound

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 Detail

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