@minecraft/server 2.0.0-rc.1.21.90-preview.21 → 2.0.0-rc.1.21.90-preview.23

package/index.d.ts

@@ -128,7 +128,6 @@ export enum CustomComponentNameErrorReason {
 }
 
 /**
- * @rc
  * An enumeration for the various difficulty levels of
  * Minecraft.
  */
@@ -4457,7 +4456,6 @@ export class Camera {
     setCamera(
         cameraPreset: string,
         setOptions?:
-            | CameraDefaultOptions
             | CameraFixedBoomOptions
             | CameraSetFacingOptions
             | CameraSetLocationOptions
@@ -4465,6 +4463,23 @@ export class Camera {
             | CameraSetRotOptions
             | CameraTargetOptions,
     ): void;
+    /**
+     * @rc
+     * @remarks
+     * Sets the current active camera for the specified player and
+     * resets the position and rotation to the values defined in
+     * the JSON.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param cameraPreset
+     * Identifier of a camera preset file defined within JSON.
+     * @param easeOptions
+     * Options to ease the camera back to its original position and
+     * rotation.
+     * @throws This function can throw errors.
+     */
+    setDefaultCamera(cameraPreset: string, easeOptions?: CameraEaseOptions): void;
 }
 
 /**
@@ -4647,6 +4662,10 @@ export class Container {
      * @param itemStack
      * The stack of items to add.
      * @throws This function can throw errors.
+     *
+     * {@link ContainerRulesError}
+     *
+     * {@link Error}
      */
     addItem(itemStack: ItemStack): ItemStack | undefined;
     /**
@@ -4726,6 +4745,10 @@ export class Container {
      * @throws
      * Throws if either this container or `toContainer` are invalid
      * or if the `fromSlot` or `toSlot` indices out of bounds.
+     *
+     * {@link ContainerRulesError}
+     *
+     * {@link Error}
      * @example moveBetweenContainers.ts
      * ```typescript
      * import { world, EntityInventoryComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
@@ -4770,6 +4793,10 @@ export class Container {
      * @throws
      * Throws if the container is invalid or if the `slot` index is
      * out of bounds.
+     *
+     * {@link ContainerRulesError}
+     *
+     * {@link Error}
      */
     setItem(slot: number, itemStack?: ItemStack): void;
     /**
@@ -4788,6 +4815,10 @@ export class Container {
      * @throws
      * Throws if either this container or `otherContainer` are
      * invalid or if the `slot` or `otherSlot` are out of bounds.
+     *
+     * {@link ContainerRulesError}
+     *
+     * {@link Error}
      */
     swapItems(slot: number, otherSlot: number, otherContainer: Container): void;
     /**
@@ -4809,6 +4840,10 @@ export class Container {
      * @throws
      * Throws if either this container or `toContainer` are invalid
      * or if the `fromSlot` or `toSlot` indices out of bounds.
+     *
+     * {@link ContainerRulesError}
+     *
+     * {@link Error}
      * @example transferBetweenContainers.ts
      * ```typescript
      * import { world, EntityInventoryComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
@@ -5174,6 +5209,8 @@ export class ContainerSlot {
      * @throws
      * Throws if the slot's container is invalid.
      *
+     * {@link ContainerRulesError}
+     *
      * {@link InvalidContainerSlotError}
      */
     setItem(itemStack?: ItemStack): void;
@@ -5433,6 +5470,38 @@ export class Dimension {
      * {@link LocationOutOfWorldBoundariesError}
      */
     getBlock(location: Vector3): Block | undefined;
+    /**
+     * @rc
+     * @remarks
+     * Gets the first block found above a given block location
+     * based on the given options (by default will find the first
+     * solid block above).
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param location
+     * Location to retrieve the block above from.
+     * @param options
+     * The options to decide if a block is a valid result.
+     * @throws This function can throw errors.
+     */
+    getBlockAbove(location: Vector3, options?: BlockRaycastOptions): Block | undefined;
+    /**
+     * @rc
+     * @remarks
+     * Gets the first block found below a given block location
+     * based on the given options (by default will find the first
+     * solid block below).
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param location
+     * Location to retrieve the block below from.
+     * @param options
+     * The options to decide if a block is a valid result.
+     * @throws This function can throw errors.
+     */
+    getBlockBelow(location: Vector3, options?: BlockRaycastOptions): Block | undefined;
     /**
      * @remarks
      * Gets the first block that intersects with a vector emanating
@@ -5601,7 +5670,6 @@ export class Dimension {
      */
     getTopmostBlock(locationXZ: VectorXZ, minHeight?: number): Block | undefined;
     /**
-     * @rc
      * @remarks
      * Places the given feature into the dimension at the specified
      * location.
@@ -5632,7 +5700,6 @@ export class Dimension {
      */
     placeFeature(featureName: string, location: Vector3, shouldThrow?: boolean): boolean;
     /**
-     * @rc
      * @remarks
      * Places the given feature rule into the dimension at the
      * specified location.
@@ -12301,7 +12368,6 @@ export class Player extends Entity {
      */
     addLevels(amount: number): number;
     /**
-     * @rc
      * @remarks
      * For this player, removes all overrides of any Entity
      * Properties on the target Entity. This change is not applied
@@ -12420,7 +12486,6 @@ export class Player extends Entity {
      */
     queueMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
-     * @rc
      * @remarks
      * For this player, removes the override on an Entity Property.
      * This change is not applied until the next tick and will not
@@ -12550,7 +12615,6 @@ export class Player extends Entity {
      */
     setGameMode(gameMode?: GameMode): void;
     /**
-     * @rc
      * @remarks
      * For this player, overrides an Entity Property on the target
      * Entity to the provided value. This property must be client
@@ -15119,7 +15183,6 @@ export class StructureManager {
         options?: StructurePlaceOptions,
     ): void;
     /**
-     * @rc
      * @remarks
      * Places a partial jigsaw structure in the world. This is
      * useful for debugging connections between jigsaw blocks.
@@ -15163,7 +15226,6 @@ export class StructureManager {
         options?: JigsawPlaceOptions,
     ): BlockBoundingBox;
     /**
-     * @rc
      * @remarks
      * Places a jigsaw structure in the world.
      *
@@ -15918,7 +15980,6 @@ export class World {
      */
     getDefaultSpawnLocation(): Vector3;
     /**
-     * @rc
      * @remarks
      * Gets the difficulty from the world.
      *
@@ -16170,7 +16231,6 @@ export class World {
      */
     setDefaultSpawnLocation(spawnLocation: Vector3): void;
     /**
-     * @rc
      * @remarks
      * Sets the worlds difficulty.
      *
@@ -16783,7 +16843,6 @@ export class WorldLoadAfterEventSignal {
 }
 
 /**
- * @rc
  * A BlockBoundingBox is an interface to an object which
  * represents an AABB aligned rectangle.
  * The BlockBoundingBox assumes that it was created in a valid
@@ -17054,15 +17113,6 @@ export interface BlockRaycastOptions extends BlockFilter {
     maxDistance?: number;
 }
 
-export interface CameraDefaultOptions {
-    /**
-     * @remarks
-     * Sets a set of easing options for the camera.
-     *
-     */
-    easeOptions: CameraEaseOptions;
-}
-
 /**
  * Contains options associated with a camera ease operation.
  */
@@ -18031,7 +18081,6 @@ export interface ItemCustomComponent {
 }
 
 /**
- * @rc
  * Provides additional options for {@link
  * StructureManager.placeJigsaw}.
  */
@@ -18053,7 +18102,6 @@ export interface JigsawPlaceOptions {
 }
 
 /**
- * @rc
  * Provides additional options for {@link
  * StructureManager.placeJigsawStructure}.
  */
@@ -18171,7 +18219,7 @@ export interface PlayAnimationOptions {
      * A list of players the animation will be visible to.
      *
      */
-    players?: string[];
+    players?: Player[];
     /**
      * @remarks
      * Specifies a Molang expression for when this animation should
@@ -18801,6 +18849,15 @@ export class CommandError extends Error {
     private constructor();
 }
 
+/**
+ * Error thrown if {@link @minecraft/server.ContainerRules} are
+ * broken on container operations.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class ContainerRulesError extends Error {
+    private constructor();
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CustomComponentInvalidRegistryError extends Error {
     private constructor();
@@ -18951,9 +19008,6 @@ export class NamespaceNameError extends Error {
     reason: NamespaceNameErrorReason;
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class PlaceJigsawError extends Error {
     private constructor();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.0.0-rc.1.21.90-preview.21",
+  "version": "2.0.0-rc.1.21.90-preview.23",
   "description": "",
   "contributors": [
     {