Package org.bukkit

Class MusicInstrument

java.lang.Object

org.bukkit.MusicInstrument

All Implemented Interfaces:

Keyed, Translatable, Keyed

@NullMarked
public abstract class MusicInstrument
extends Object
implements Keyed, Translatable

Field Summary

Fields

Modifier and Type	Field	Description
static final MusicInstrument	ADMIRE_GOAT_HORN
static final MusicInstrument	CALL_GOAT_HORN
static final MusicInstrument	DREAM_GOAT_HORN
static final MusicInstrument	FEEL_GOAT_HORN
static final MusicInstrument	PONDER_GOAT_HORN
static final MusicInstrument	SEEK_GOAT_HORN
static final MusicInstrument	SING_GOAT_HORN
static final MusicInstrument	YEARN_GOAT_HORN

Constructor Summary

Constructors

Constructor	Description
MusicInstrument()

Method Summary

Modifier and Type	Method	Description
static MusicInstrument	create(Consumer<RegistryBuilderFactory<MusicInstrument,? extends InstrumentRegistryEntry.Builder>> value)	Creates an inlined music instrument.
abstract Component	description()	Gets the description of this instrument as displayed to the client.
static @Nullable MusicInstrument	getByKey(NamespacedKey namespacedKey)	Deprecated. use Registry.get(NamespacedKey) instead
abstract float	getDuration()	Gets the use duration of this music instrument.
abstract NamespacedKey	getKey()	Deprecated, for removal: This API element is subject to removal in a future version. use Registry.getKey(Keyed), RegistryAccess.getRegistry(io.papermc.paper.registry.RegistryKey), and RegistryKey.INSTRUMENT.
abstract float	getRange()	Gets the range of the sound.
abstract Sound	getSound()	Gets the sound for this instrument.
@NotNull Key	key()	Deprecated, for removal: This API element is subject to removal in a future version. use Registry.getKey(Keyed), RegistryAccess.getRegistry(io.papermc.paper.registry.RegistryKey), and RegistryKey.INSTRUMENT.
abstract String	translationKey()	Deprecated, for removal: This API element is subject to removal in a future version. this method assumes that the instrument description always be a translatable component which is not guaranteed.
static Collection<MusicInstrument>	values()	Deprecated. use Iterable.iterator()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ADMIRE_GOAT_HORN

public static final MusicInstrument ADMIRE_GOAT_HORN

CALL_GOAT_HORN

public static final MusicInstrument CALL_GOAT_HORN

DREAM_GOAT_HORN

public static final MusicInstrument DREAM_GOAT_HORN

FEEL_GOAT_HORN

public static final MusicInstrument FEEL_GOAT_HORN

PONDER_GOAT_HORN

public static final MusicInstrument PONDER_GOAT_HORN

SEEK_GOAT_HORN

public static final MusicInstrument SEEK_GOAT_HORN

SING_GOAT_HORN

public static final MusicInstrument SING_GOAT_HORN

YEARN_GOAT_HORN

public static final MusicInstrument YEARN_GOAT_HORN

Constructor Details

MusicInstrument

public MusicInstrument()

Method Details

create

@Experimental
public static MusicInstrument create(Consumer<RegistryBuilderFactory<MusicInstrument,? extends InstrumentRegistryEntry.Builder>> value)

Creates an inlined music instrument.

Parameters:

value - a consumer for the builder factory

Returns:

the created music instrument

getByKey

@Deprecated(since="1.20.1")
public static @Nullable MusicInstrument getByKey(NamespacedKey namespacedKey)

Deprecated.

use Registry.get(NamespacedKey) instead

Returns a MusicInstrument by a NamespacedKey.

Parameters:

namespacedKey - the key

Returns:

the event or null

values

@Deprecated(since="1.20.1")
public static Collection<MusicInstrument> values()

Deprecated.

use Iterable.iterator()

Returns all known music instruments.

Returns:

the music instruments

getDuration

public abstract float getDuration()

Gets the use duration of this music instrument.

Returns:

the duration expressed in seconds

getRange

public abstract float getRange()

Gets the range of the sound.

Returns:

the range of the sound

description

public abstract Component description()

Gets the description of this instrument as displayed to the client.

Returns:

the description component

getSound

public abstract Sound getSound()

Gets the sound for this instrument.

Returns:

the sound

getKey

@Deprecated(forRemoval=true,
            since="1.20.5")
public abstract NamespacedKey getKey()

Deprecated, for removal: This API element is subject to removal in a future version.

use Registry.getKey(Keyed), RegistryAccess.getRegistry(io.papermc.paper.registry.RegistryKey), and RegistryKey.INSTRUMENT. MusicInstruments can exist without a key.

Description copied from interface: Keyed

Return the namespaced identifier for this object.

Specified by:

getKey in interface Keyed

Returns:

this object's key

key

@Deprecated(forRemoval=true,
            since="1.20.5")
public @NotNull Key key()

Deprecated, for removal: This API element is subject to removal in a future version.

use Registry.getKey(Keyed), RegistryAccess.getRegistry(io.papermc.paper.registry.RegistryKey), and RegistryKey.INSTRUMENT. MusicInstruments can exist without a key.

Description copied from interface: Keyed

Returns the unique identifier for this object.

Specified by:

key in interface Keyed

Specified by:

key in interface Keyed

Returns:

this object's key

translationKey

@Deprecated(forRemoval=true)
public abstract String translationKey()

Deprecated, for removal: This API element is subject to removal in a future version.

this method assumes that the instrument description always be a translatable component which is not guaranteed.

Description copied from interface: net.kyori.adventure.translation.Translatable

Gets the translation key.

Specified by:

translationKey in interface Translatable

Returns:

the translation key