Package net.neoforged.neoforge.client.event.sound

Class PlaySoundEvent

java.lang.Object

net.neoforged.bus.api.Event

net.neoforged.neoforge.client.event.sound.SoundEvent

net.neoforged.neoforge.client.event.sound.PlaySoundEvent

public class PlaySoundEvent
extends SoundEvent

Fired when a sound is about to be played by the sound engine. This fires before the sound is played and before any checks on the sound (such as a zeroed volume, an empty Sound, and others). This can be used to change or prevent (by passing null) a sound from being played through setSound(SoundInstance)).

This event is not

invalid reference

cancellable

, and does not

invalid reference

have a result

.

This event is fired on the main Forge event bus, only on the logical client.

See Also:

• PlaySoundSourceEvent
• PlayStreamingSourceEvent

Nested Class Summary

Nested classes/interfaces inherited from class net.neoforged.neoforge.client.event.sound.SoundEvent

SoundEvent.SoundSourceEvent

Field Summary

Fields

Modifier and Type	Field	Description
private final String	name
private final SoundInstance	originalSound
private @Nullable SoundInstance	sound

Constructor Summary

Constructors

Constructor	Description
PlaySoundEvent(SoundEngine manager, SoundInstance sound)

Method Summary

Modifier and Type	Method	Description
String	getName()	Returns the name of the original sound.
SoundInstance	getOriginalSound()	Returns the original sound that was to be played.
@Nullable SoundInstance	getSound()	Returns the sound to be played, or null if no sound will be played.
void	setSound(@Nullable SoundInstance newSound)	Sets the sound to be played, which may be null to prevent any sound from being played.

Methods inherited from class net.neoforged.neoforge.client.event.sound.SoundEvent

getEngine

Methods inherited from class java.lang.Object

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

Field Details

name

private final String name

originalSound

private final SoundInstance originalSound

sound

@Nullable
private @Nullable SoundInstance sound

Constructor Details

PlaySoundEvent

@Internal
public PlaySoundEvent(SoundEngine manager,
 SoundInstance sound)

Method Details

getName

public String getName()

Returns the name of the original sound. This is equivalent to the path of the location of the original sound.

Returns:

the name of the original sound

getOriginalSound

public SoundInstance getOriginalSound()

Returns the original sound that was to be played.

Returns:

the original sound that was to be played

getSound

@Nullable
public @Nullable SoundInstance getSound()

Returns the sound to be played, or null if no sound will be played.

Returns:

the sound to be played, or null if no sound will be played

setSound

public void setSound(@Nullable
 @Nullable SoundInstance newSound)

Sets the sound to be played, which may be null to prevent any sound from being played.

Parameters:

newSound - the new sound to be played, or null for no sound