@minecraft/server 2.9.0-beta.1.26.30-preview.21 → 2.9.0-beta.1.26.30-preview.25

package/index.d.ts

@@ -8662,9 +8662,11 @@ export class Dimension {
      * An error will be thrown if pitch is less than 0.01.
      * An error will be thrown if volume is less than 0.0.
      *
+     * {@link minecraftcommon.EngineError}
+     *
      * {@link minecraftcommon.PropertyOutOfBoundsError}
      */
-    playSound(soundId: string, location: Vector3, soundOptions?: WorldSoundOptions): void;
+    playSound(soundId: string, location: Vector3, soundOptions?: WorldSoundOptions): SoundInstance;
     /**
      * @remarks
      * Runs a command synchronously using the context of the
@@ -17826,6 +17828,10 @@ export class Player extends Entity {
      * @param soundOptions
      * Additional optional options for the sound.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link Error}
      * @example playMusicAndSound.ts
      * ```typescript
      * import { world, MusicOptions, WorldSoundOptions, PlayerSoundOptions, DimensionLocation } from '@minecraft/server';
@@ -17855,7 +17861,7 @@ export class Player extends Entity {
      * }
      * ```
      */
-    playSound(soundId: string, soundOptions?: PlayerSoundOptions): void;
+    playSound(soundId: string, soundOptions?: PlayerSoundOptions): SoundInstance;
     /**
      * @beta
      * @remarks
@@ -21383,6 +21389,22 @@ export class SmeltItemFunction extends LootItemFunction {
     private constructor();
 }
 
+/**
+ * @beta
+ * Represents a handle to a sound that has been played.
+ */
+export class SoundInstance {
+    private constructor();
+    /**
+     * @remarks
+     * Stops this sound from playing.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    stop(): void;
+}
+
 /**
  * Loot item function that applies one or several predefined
  * enchants to the dropped item.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.9.0-beta.1.26.30-preview.21",
+  "version": "2.9.0-beta.1.26.30-preview.25",
   "description": "",
   "contributors": [
     {
@@ -14,7 +14,7 @@
   ],
   "peerDependencies": {
     "@minecraft/common": "^1.2.0",
-    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.30-preview.21"
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.30-preview.25"
   },
   "license": "MIT"
 }