@minecraft/server 2.8.0-rc.1.26.30-preview.30 → 2.8.0-rc.1.26.40-preview.20

package/index.d.ts

@@ -7510,8 +7510,12 @@ export class Dimension {
      * locations that satisfied the block filter.
      * @throws This function can throw errors.
      *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
      * {@link Error}
      *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
      * {@link UnloadedChunksError}
      */
     getBlocks(volume: BlockVolumeBase, filter: BlockFilter, allowUnloadedChunks?: boolean): ListBlockVolume;
@@ -7768,9 +7772,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
@@ -8578,6 +8584,26 @@ export class Entity {
      * {@link InvalidEntityError}
      */
     readonly location: Vector3;
+    /**
+     * @rc
+     * @remarks
+     * Boolean which determines if the player nameplate should be
+     * depth tested for visibility.
+     *
+     * This property can't be edited in restricted-execution mode.
+     *
+     */
+    nameplateDepthTested: boolean;
+    /**
+     * @rc
+     * @remarks
+     * Float that determines the render distance of this entity's
+     * nameplate.
+     *
+     * This property can't be edited in restricted-execution mode.
+     *
+     */
+    nameplateRenderDistance: number;
     /**
      * @remarks
      * Given name of the entity.
@@ -16617,6 +16643,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';
@@ -16646,7 +16676,7 @@ export class Player extends Entity {
      * }
      * ```
      */
-    playSound(soundId: string, soundOptions?: PlayerSoundOptions): void;
+    playSound(soundId: string, soundOptions?: PlayerSoundOptions): SoundInstance;
     /**
      * @remarks
      * Queues an additional music track that only this particular
@@ -19934,6 +19964,19 @@ export class SmeltItemFunction extends LootItemFunction {
     private constructor();
 }
 
+/**
+ * Represents a handle to a sound that has been played. The
+ * handle is required to control the sound while it is playing
+ * (for example, to call `stop`, `setVolume`, `setPitch`,
+ * `fade`, or `seekTo`). Infinitely-looping sounds (started
+ * with `loop: -1`) stop automatically when the last
+ * `SoundInstance` reference is dropped; retain the handle for
+ * as long as the sound should keep playing.
+ */
+export class SoundInstance {
+    private constructor();
+}
+
 /**
  * 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.8.0-rc.1.26.30-preview.30",
+  "version": "2.8.0-rc.1.26.40-preview.20",
   "description": "",
   "contributors": [
     {
@@ -14,7 +14,7 @@
   ],
   "peerDependencies": {
     "@minecraft/common": "^1.2.0",
-    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.30-preview.30"
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.40-preview.20"
   },
   "license": "MIT"
 }