播放声音事件（SoundEvent）

Minecraft 有大量的声音供您选择。 查看 SoundEvents 类以查看 Mojang 提供的所有原版声音事件实例。

在您的模组中使用声音

使用声音时请确保在逻辑服务端执行 playSound() 方法。

在此示例中，自定义交互项的 useOnEntity() 和 useOnBlock() 方法用于播放“放置铜块”和掠夺者声音。

@Override
public ActionResult useOnEntity(ItemStack stack, PlayerEntity user, LivingEntity entity, Hand hand) {
	// As stated above, don't use the playSound() method on the client side
	// ... it wont work!
	if (!entity.getWorld().isClient()) {
		// Play the sound as if it was coming from the entity.
		entity.playSound(SoundEvents.ENTITY_PILLAGER_AMBIENT, 2f, 0.7f);
	}

	return super.useOnEntity(stack, user, entity, hand);
}

playerSound() 方法与 LivingEntity 对象一起使用。 只需要指定 SoundEvent、音量（volume）和音高（pitch）。 您还可以使用世界实例中的 playSound() 方法以获得更高级别的控制。

@Override
public ActionResult useOnBlock(ItemUsageContext context) {
	// Tip of the day: Check out "Guard Clauses" to keep your code clean.
	if (!context.getWorld().isClient()) {
		// Play the sound and specify location, category and who made the sound.
		// No entity made the sound, so we specify null.
		context.getWorld().playSound(null, context.getBlockPos(),
				SoundEvents.BLOCK_COPPER_PLACE, SoundCategory.PLAYERS,
				1f, 1f);
	}

	return super.useOnBlock(context);
}

声音事件与声音组（SoundCategory）

声音事件定义了播放哪个声音。 您也可以注册您自己的声音事件以包含您自己的声音。

Minecraft 在游戏设置中有多个音频滑块。 SoundCategory 枚举类用于确定哪个滑块可以调整您声音的音量。

音量和音高

音量参数可能有些误导。 在 0.0f - 1.0f 的范围内可以改变声音的实际音量。 如果数字大于这个范围，将使用 1.0f 的音量，并且仅使用您所在的距离。可以听到声音，进行调整。 通过 volume * 16 可以粗略算出方块距离。

音高参数会增加或减少音高数值，还会改变声音的持续时间。 在 (0.5f - 1.0f) 范围内，音高和速度会减小，而较大的数字会增加音高和速度。 0.5f 以下的数字将保持 0.5f。