@minecraft/server 2.3.0-rc.1.21.120-preview.21 → 2.3.0-rc.1.21.120-preview.23

package/index.d.ts

@@ -3124,6 +3124,23 @@ export class Block {
      * {@link LocationOutOfWorldBoundariesError}
      */
     getItemStack(amount?: number, withData?: boolean): ItemStack | undefined;
+    /**
+     * @rc
+     * @remarks
+     * Returns the total brightness level of light shining on a
+     * certain block.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @returns
+     * The brightness level on the block.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     */
+    getLightLevel(): number;
     /**
      * @remarks
      * Returns the net redstone power of this block.
@@ -3138,6 +3155,23 @@ export class Block {
      * {@link LocationOutOfWorldBoundariesError}
      */
     getRedstonePower(): number | undefined;
+    /**
+     * @rc
+     * @remarks
+     * Returns the brightness level of light shining from the sky
+     * on a certain block.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @returns
+     * The brightness level on the block.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     */
+    getSkyLightLevel(): number;
     /**
      * @remarks
      * Returns a set of tags for a block.
@@ -5598,6 +5632,24 @@ export class ContainerSlot {
      * {@link InvalidContainerSlotError}
      */
     setCanPlaceOn(blockIdentifiers?: string[]): void;
+    /**
+     * @rc
+     * @remarks
+     * Sets multiple dynamic properties with specific values.
+     *
+     * @param values
+     * A Record of key value pairs of the dynamic properties to
+     * set. If the data value is null, it will remove that property
+     * instead.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidContainerSlotError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
+     */
+    setDynamicProperties(values: Record<string, boolean | number | string | Vector3 | undefined>): void;
     /**
      * @remarks
      * Sets a specified property to a value.
@@ -5605,7 +5657,8 @@ export class ContainerSlot {
      * @param identifier
      * The property identifier.
      * @param value
-     * Data value of the property to set.
+     * Data value of the property to set. If the value is null, it
+     * will remove the property instead.
      * @throws
      * Throws if the slot's container is invalid.
      *
@@ -6174,6 +6227,23 @@ export class Dimension {
      * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     getEntitiesFromRay(location: Vector3, direction: Vector3, options?: EntityRaycastOptions): EntityRaycastHit[];
+    /**
+     * @rc
+     * @remarks
+     * Returns the total brightness level of light shining on a
+     * certain block position.
+     *
+     * @param location
+     * Location of the block we want to check the brightness of.
+     * @returns
+     * The brightness level on the block.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     */
+    getLightLevel(location: Vector3): number;
     /**
      * @remarks
      * Returns a set of players based on a set of conditions
@@ -6191,6 +6261,23 @@ export class Dimension {
      * {@link minecraftcommon.InvalidArgumentError}
      */
     getPlayers(options?: EntityQueryOptions): Player[];
+    /**
+     * @rc
+     * @remarks
+     * Returns the brightness level of light shining from the sky
+     * on a certain block position.
+     *
+     * @param location
+     * Position of the block we want to check the brightness of.
+     * @returns
+     * The brightness level on the block.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     */
+    getSkyLightLevel(location: Vector3): number;
     /**
      * @remarks
      * Returns the highest block at the given XZ location.
@@ -6203,6 +6290,16 @@ export class Dimension {
      * @throws This function can throw errors.
      */
     getTopmostBlock(locationXZ: VectorXZ, minHeight?: number): Block | undefined;
+    /**
+     * @rc
+     * @remarks
+     * Returns true if the chunk at the given location is loaded
+     * (and valid for use with scripting).
+     *
+     * @param location
+     * Location to check if the chunk is loaded.
+     */
+    isChunkLoaded(location: Vector3): boolean;
     /**
      * @remarks
      * Places the given feature into the dimension at the specified
@@ -7735,6 +7832,22 @@ export class Entity {
      * {@link InvalidEntityError}
      */
     runCommand(commandString: string): CommandResult;
+    /**
+     * @rc
+     * @remarks
+     * Sets multiple dynamic properties with specific values.
+     *
+     * @param values
+     * A Record of key value pairs of the dynamic properties to
+     * set. If the data value is null, it will remove that property
+     * instead.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidEntityError}
+     */
+    setDynamicProperties(values: Record<string, boolean | number | string | Vector3 | undefined>): void;
     /**
      * @remarks
      * Sets a specified property to a value.
@@ -7742,7 +7855,8 @@ export class Entity {
      * @param identifier
      * The property identifier.
      * @param value
-     * Data value of the property to set.
+     * Data value of the property to set. If the value is null, it
+     * will remove the property instead.
      * @throws This function can throw errors.
      *
      * {@link minecraftcommon.ArgumentOutOfBoundsError}
@@ -12408,6 +12522,22 @@ export class ItemStack {
      * ```
      */
     setCanPlaceOn(blockIdentifiers?: string[]): void;
+    /**
+     * @rc
+     * @remarks
+     * Sets multiple dynamic properties with specific values.
+     *
+     * @param values
+     * A Record of key value pairs of the dynamic properties to
+     * set. If the data value is null, it will remove that property
+     * instead.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
+     */
+    setDynamicProperties(values: Record<string, boolean | number | string | Vector3 | undefined>): void;
     /**
      * @remarks
      * Sets a specified property to a value. Note: This function
@@ -12416,7 +12546,8 @@ export class ItemStack {
      * @param identifier
      * The property identifier.
      * @param value
-     * Data value of the property to set.
+     * Data value of the property to set. If the value is null, it
+     * will remove the property instead.
      * @throws
      * Throws if the item stack is stackable.
      *
@@ -13470,7 +13601,7 @@ export class Player extends Entity {
      * The Entity whose Entity Property overrides are being
      * cleared.
      * @throws
-     * Throws if the entity is invalid.
+     * Throws if the Entity is invalid.
      */
     clearPropertyOverridesForEntity(targetEntity: Entity): void;
     /**
@@ -17479,6 +17610,20 @@ export class World {
      * The difficulty we want to set the world to.
      */
     setDifficulty(difficulty: Difficulty): void;
+    /**
+     * @rc
+     * @remarks
+     * Sets multiple dynamic properties with specific values.
+     *
+     * @param values
+     * A Record of key value pairs of the dynamic properties to
+     * set. If the data value is null, it will remove that property
+     * instead.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     */
+    setDynamicProperties(values: Record<string, boolean | number | string | Vector3 | undefined>): void;
     /**
      * @remarks
      * Sets a specified property to a value.
@@ -17486,7 +17631,8 @@ export class World {
      * @param identifier
      * The property identifier.
      * @param value
-     * Data value of the property to set.
+     * Data value of the property to set. If the value is null, it
+     * will remove the property instead.
      * @throws
      * Throws if the given dynamic property identifier is not
      * defined.
@@ -19941,6 +20087,23 @@ export interface ScriptEventMessageFilterOptions {
  * Contains additional options for spawning an Entity.
  */
 export interface SpawnEntityOptions {
+    /**
+     * @rc
+     * @remarks
+     * Optional boolean which determines if this entity should
+     * persist in the game world. Persistence prevents the entity
+     * from automatically despawning.
+     *
+     */
+    initialPersistence?: boolean;
+    /**
+     * @rc
+     * @remarks
+     * Optional initial rotation, in degrees, to set on the entity
+     * when it spawns.
+     *
+     */
+    initialRotation?: number;
     /**
      * @remarks
      * Optional spawn event to send to the entity after it is

package/package.json

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