Struct CSound 

pub struct CSound {
    pub sound_id: i32,
    pub source: i32,
    pub pos: IVec3,
    pub volume: f32,
    pub pitch: f32,
    pub seed: i64,
}

Sent to play a sound effect at a specific position.

The position is encoded at 8x precision (divide by 8 to get actual block coordinates). This allows sub-block positioning for more accurate sound placement.

Fields

sound_id: i32

The holder-encoded sound event ID (VarInt).

Vanilla reserves 0 for direct sound events, so registered sound events are encoded as registry_id + 1.

source: i32

The sound source category (VarInt).

pos: IVec3

X position multiplied by 8 (fixed-point).

volume: f32

Volume (1.0 = normal).

pitch: f32

Pitch (1.0 = normal).

seed: i64

Random seed for sound variations.

Implementations

impl CSound

pub fn new( sound: SoundEventRef, source: SoundSource, pos: DVec3, volume: f32, pitch: f32, seed: i64, ) -> Self

Creates a new sound packet.

Arguments

• sound - Sound event to play
• source - Sound source category
• x, y, z - Position in block coordinates (will be scaled by 8)
• volume - Volume multiplier (1.0 = normal)
• pitch - Pitch multiplier (1.0 = normal)
• seed - Random seed for sound variations

pub fn block_sound( sound: SoundEventRef, pos: BlockPos, volume: f32, pitch: f32, seed: i64, ) -> Self

Creates a block sound packet at the center of a block position.

Arguments

• sound - Sound event to play
• pos - Block position (will be centered at +0.5)
• volume - Volume multiplier
• pitch - Pitch multiplier
• seed - Random seed

Trait Implementations

impl ClientPacket for CSound

fn get_id(&self, protocol: ConnectionProtocol) -> Option<i32>

Gets the ID of the packet for the given protocol.

fn write_packet( &self, writer: &mut impl Write, protocol: ConnectionProtocol, ) -> Result<(), PacketError>

Writes the packet to the given writer.

impl Clone for CSound

fn clone(&self) -> CSound

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CSound

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl WriteTo for CSound

fn write(&self, writer: &mut impl Write) -> Result<()>

Writes data to a writer.