@minecraft/server 2.10.0-beta.1.26.40-preview.29 → 2.10.0-beta.1.26.40-preview.30

package/index.d.ts

@@ -220,6 +220,34 @@ export enum CameraShakeType {
     Rotational = 'Rotational',
 }
 
+/**
+ * @beta
+ * An enumeration for the clone modes used when cloning blocks.
+ */
+export enum CloneMode {
+    /**
+     * @remarks
+     * Clones the blocks from the source region to the destination,
+     * leaving the source intact.
+     *
+     */
+    Copy = 0,
+    /**
+     * @remarks
+     * Clones the blocks from the source region to the destination,
+     * allowing the source and destination regions to overlap.
+     *
+     */
+    ForceCopy = 1,
+    /**
+     * @remarks
+     * Clones the blocks from the source region to the destination
+     * and replaces the source region with air.
+     *
+     */
+    Move = 2,
+}
+
 /**
  * The required permission level to execute the custom command.
  */
@@ -8408,6 +8436,40 @@ export class Dimension {
         biomeToFind: BiomeType | string,
         options?: BiomeSearchOptions,
     ): Vector3 | undefined;
+    /**
+     * @beta
+     * @remarks
+     * Clones a region of blocks from one area of the dimension to
+     * another.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param beginLocation
+     * The lower northwest starting corner of the area to clone
+     * from.
+     * @param endLocation
+     * The upper southeast ending corner of the area to clone from.
+     * @param destination
+     * The lower northwest starting corner of the area to clone to.
+     * @param cloneMode
+     * Specifies how the cloned blocks should be placed at the
+     * destination.
+     * @param filter
+     * An optional block filter used to include only matching
+     * blocks from the source area.
+     * @throws This function can throw errors.
+     *
+     * {@link Error}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    cloneBlocks(
+        beginLocation: Vector3,
+        endLocation: Vector3,
+        destination: Vector3,
+        cloneMode: CloneMode,
+        filter?: BlockFilter,
+    ): void;
     /**
      * @remarks
      * Checks if an area contains the specified biomes. If the area
@@ -17489,7 +17551,7 @@ export class LootingEnchantFunction extends LootItemFunction {
 export class LootItem extends LootPoolEntry {
     private constructor();
     /**
-     * @beta
+     * @rc
      */
     readonly conditions: LootItemCondition[];
     readonly functions: LootItemFunction[];
@@ -20933,6 +20995,18 @@ export class PrimitiveShapesManager {
      * {@link PrimitiveShapeError}
      */
     addText(text: TextPrimitive, dimension?: Dimension): void;
+    /**
+     * @beta
+     * @remarks
+     * Fetches and queries all primitive shapes stored in the
+     * manager and returns the results as an array of shape
+     * handles.
+     *
+     * @param options
+     * Optional options for querying existing shapes to narrow down
+     * the results.
+     */
+    getShapes(options?: PrimitiveShapeQueryOptions): PrimitiveShape[];
     /**
      * @remarks
      * Removes all text primitives from the world.
@@ -22352,13 +22426,14 @@ export class SoundDurationInfo {
     readonly isActive: boolean;
     /**
      * @remarks
-     * Returns the elapsed playback time of the sound, in seconds,
-     * since it started playing.
+     * Returns the current playback position within the sound, in
+     * seconds, measured from the beginning of the sound.
      *
      * This function can't be called in restricted-execution mode.
      *
      * @returns
-     * Elapsed playback time in seconds.
+     * Current playback position in seconds, measured from the
+     * beginning of the sound.
      */
     getPlaybackPosition(): number;
 }
@@ -22448,7 +22523,12 @@ export class SoundInstance {
      *
      * @param seconds
      * Position to seek to in seconds. Must be non-negative.
-     * Minimum value: 0
+     * Bounds: [0, 107374184]
+     * @throws
+     * Throws if `seconds` is negative, or if the sound has a known
+     * duration and `seconds` is greater than that duration.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
      */
     seekTo(seconds: number): void;
     /**
@@ -27446,6 +27526,43 @@ export interface PlayerVisibilityRules extends EntityVisibilityRules {
     showSpectatorToSpectator?: boolean;
 }
 
+/**
+ * @beta
+ * Contains optional filters that control which primitive
+ * shapes are returned from a primitive shapes query.
+ */
+export interface PrimitiveShapeQueryOptions {
+    /**
+     * @remarks
+     * If specified, only returns shapes attached to this entity.
+     *
+     */
+    attachedTo?: Entity;
+    /**
+     * @remarks
+     * Adds a seed location to the query that is used in
+     * conjunction with distance properties.
+     *
+     */
+    location?: Vector3;
+    /**
+     * @remarks
+     * If specified, only includes shapes that are less than this
+     * distance away from the location specified in the location
+     * property.
+     *
+     */
+    maxDistance?: number;
+    /**
+     * @remarks
+     * If specified, only includes shapes that are at least this
+     * distance away from the location specified in the location
+     * property.
+     *
+     */
+    minDistance?: number;
+}
+
 /**
  * Key frame that holds the progress of the camera animation.
  */

package/package.json

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