@minecraft/server 2.3.0-beta.1.21.110-preview.22 → 2.3.0-beta.1.21.110-preview.24

package/index.d.ts

@@ -171,7 +171,6 @@ export enum ButtonState {
 }
 
 /**
- * @rc
  * The required permission level to execute the custom command.
  */
 export enum CommandPermissionLevel {
@@ -302,7 +301,6 @@ export enum ContainerRulesErrorReason {
 }
 
 /**
- * @rc
  * Reason why custom command registration failed.
  */
 export enum CustomCommandErrorReason {
@@ -356,7 +354,6 @@ export enum CustomCommandErrorReason {
 }
 
 /**
- * @rc
  * The types of paramaters accepted by a custom command.
  */
 export enum CustomCommandParamType {
@@ -430,7 +427,6 @@ export enum CustomCommandParamType {
 }
 
 /**
- * @rc
  * Who executed the command.
  */
 export enum CustomCommandSource {
@@ -455,9 +451,6 @@ export enum CustomCommandSource {
     Server = 'Server',
 }
 
-/**
- * @rc
- */
 export enum CustomCommandStatus {
     Success = 0,
     Failure = 1,
@@ -1086,7 +1079,6 @@ export enum EntityComponentTypes {
      */
     OnFire = 'minecraft:onfire',
     /**
-     * @rc
      * @remarks
      * Use this component to read the exhaustion of a player. This
      * is only available on players.
@@ -1094,7 +1086,6 @@ export enum EntityComponentTypes {
      */
     Exhaustion = 'minecraft:player.exhaustion',
     /**
-     * @rc
      * @remarks
      * Use this component to read the hunger of a player. This is
      * only available on players.
@@ -1102,7 +1093,6 @@ export enum EntityComponentTypes {
      */
     Hunger = 'minecraft:player.hunger',
     /**
-     * @rc
      * @remarks
      * Use this component to read the saturation of a player. This
      * is only available on players.
@@ -2462,7 +2452,6 @@ export enum PlatformType {
 }
 
 /**
- * @rc
  * Specifies the player inventory type.
  */
 export enum PlayerInventoryType {
@@ -2481,7 +2470,6 @@ export enum PlayerInventoryType {
 }
 
 /**
- * @rc
  * The player permission level.
  */
 export enum PlayerPermissionLevel {
@@ -3584,7 +3572,6 @@ export class Block {
      */
     readonly isWaterlogged: boolean;
     /**
-     * @rc
      * @remarks
      * Key for the localization of this block's name used in .lang
      * files.
@@ -3821,6 +3808,23 @@ export class Block {
      * {@link LocationOutOfWorldBoundariesError}
      */
     getItemStack(amount?: number, withData?: boolean): ItemStack | undefined;
+    /**
+     * @beta
+     * @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;
     /**
      * @beta
      * @throws This function can throw errors.
@@ -3844,6 +3848,23 @@ export class Block {
      * {@link LocationOutOfWorldBoundariesError}
      */
     getRedstonePower(): number | undefined;
+    /**
+     * @beta
+     * @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.
@@ -5687,6 +5708,23 @@ export class Camera {
             | CameraSetRotOptions
             | CameraTargetOptions,
     ): void;
+    /**
+     * @beta
+     * @remarks
+     * Sets the current active camera with easing.
+     *
+     * 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 from the previous camera to the
+     * current one.
+     * @throws
+     * Throws when easing to minecraft:first_person presets
+     * currently without the experimental cameras toggle enabled.
+     */
+    setCameraWithEase(cameraPreset: string, easeOptions: EaseOptions): void;
     /**
      * @remarks
      * Sets the current active camera for the specified player and
@@ -6328,7 +6366,6 @@ export class Container {
      */
     clearAll(): void;
     /**
-     * @rc
      * @remarks
      * Attempts to find an item inside the container
      *
@@ -6340,7 +6377,6 @@ export class Container {
      */
     contains(itemStack: ItemStack): boolean;
     /**
-     * @rc
      * @remarks
      * Find the index of the first instance of an item inside the
      * container
@@ -6353,7 +6389,6 @@ export class Container {
      */
     find(itemStack: ItemStack): number | undefined;
     /**
-     * @rc
      * @remarks
      * Find the index of the last instance of an item inside the
      * container
@@ -6366,7 +6401,6 @@ export class Container {
      */
     findLast(itemStack: ItemStack): number | undefined;
     /**
-     * @rc
      * @remarks
      * Finds the index of the first empty slot inside the container
      *
@@ -6376,7 +6410,6 @@ export class Container {
      */
     firstEmptySlot(): number | undefined;
     /**
-     * @rc
      * @remarks
      * Finds the index of the first item inside the container
      *
@@ -6979,7 +7012,6 @@ export class ContainerSlot {
 }
 
 /**
- * @rc
  * Details about the origins of the command.
  */
 export class CustomCommandOrigin {
@@ -7014,7 +7046,6 @@ export class CustomCommandOrigin {
 }
 
 /**
- * @rc
  * Provides the functionality for registering custom commands.
  */
 export class CustomCommandRegistry {
@@ -7157,7 +7188,6 @@ export class Dimension {
      */
     readonly id: string;
     /**
-     * @rc
      * @remarks
      * Key for the localization of a dimension's name used by
      * language files.
@@ -7306,6 +7336,24 @@ export class Dimension {
      * {@link Error}
      */
     findClosestBiome(pos: Vector3, biomeToFind: BiomeType | string, options?: BiomeSearchOptions): Vector3 | undefined;
+    /**
+     * @beta
+     * @remarks
+     * Returns the biome type at the specified location.
+     *
+     * @param location
+     * Location at which to check the biome.
+     * @throws
+     * An error will be thrown if the location is out of world
+     * bounds.
+     * An error will be thrown if the location is in an unloaded
+     * chunk.
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    getBiome(location: Vector3): BiomeType;
     /**
      * @remarks
      * Returns a block instance at the given location.
@@ -8359,7 +8407,6 @@ export class Entity {
      */
     readonly isValid: boolean;
     /**
-     * @rc
      * @remarks
      * Key for the localization of this entity's name used in .lang
      * files.
@@ -8714,6 +8761,23 @@ export class Entity {
      * ```
      */
     extinguishFire(useEffects?: boolean): boolean;
+    /**
+     * @beta
+     * @remarks
+     * Gets the solid blocks that this entity is directly standing
+     * on. Ignores pressure plates.
+     *
+     * @param options
+     * Additional configuration options for what blocks are
+     * returned.
+     * @returns
+     * The solid blocks that this entity is directly standing on.
+     * Returns an empty list if the entity is jumping or flying.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     */
+    getAllBlocksStandingOn(options?: GetBlocksStandingOnOptions): Block[];
     /**
      * @remarks
      * Returns the first intersecting block from the direction that
@@ -8729,6 +8793,24 @@ export class Entity {
      * {@link InvalidEntityError}
      */
     getBlockFromViewDirection(options?: BlockRaycastOptions): BlockRaycastHit | undefined;
+    /**
+     * @beta
+     * @remarks
+     * Gets a single solid block closest to the center of the
+     * entity that this entity is directly standing on. Ignores
+     * pressure plates.
+     *
+     * @param options
+     * Additional configuration options for what block is returned.
+     * @returns
+     * A single solid block closest to the center of the entity
+     * that this entity is directly standing on. Undefined if
+     * entity is flying or jumping.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     */
+    getBlockStandingOn(options?: GetBlocksStandingOnOptions): Block | undefined;
     /**
      * @remarks
      * Gets a component (that represents additional capabilities)
@@ -9876,7 +9958,6 @@ export class EntityDieAfterEventSignal {
 export class EntityEquippableComponent extends EntityComponent {
     private constructor();
     /**
-     * @rc
      * @remarks
      * Returns the total Armor level of the owner.
      *
@@ -9886,7 +9967,6 @@ export class EntityEquippableComponent extends EntityComponent {
      */
     readonly totalArmor: number;
     /**
-     * @rc
      * @remarks
      * Returns the total Toughness level of the owner.
      *
@@ -9937,7 +10017,6 @@ export class EntityEquippableComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Defines the interactions with this entity for Exhaustion.
  * Wraps the `minecraft.player.exhaustion` attribute.
  */
@@ -10235,7 +10314,6 @@ export class EntityHitEntityAfterEventSignal {
 }
 
 /**
- * @rc
  * Defines the interactions with this entity for hunger. Wraps
  * the `minecraft.player.hunger` attribute.
  */
@@ -11603,7 +11681,6 @@ export class EntityRidingComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Defines the interactions with this entity for Saturation.
  * Wraps the `minecraft.player.saturation` attribute.
  */
@@ -13448,25 +13525,26 @@ export class ItemPotionComponent extends ItemComponent {
     private constructor();
     /**
      * @remarks
-     * The PotionEffectType associated with the potion item.
+     * The PotionDeliveryType associated with the potion item.
      *
      * @throws This property can throw when used.
-     */
-    readonly potionEffectType: PotionEffectType;
-    /**
-     * @remarks
-     * The PotionLiquidType associated with the potion item.
      *
-     * @throws This property can throw when used.
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link Error}
      */
-    readonly potionLiquidType: PotionLiquidType;
+    readonly potionDeliveryType: PotionDeliveryType;
     /**
      * @remarks
-     * The PotionModifierType associated with the potion item.
+     * The PotionEffectType associated with the potion item.
      *
      * @throws This property can throw when used.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link Error}
      */
-    readonly potionModifierType: PotionModifierType;
+    readonly potionEffectType: PotionEffectType;
     static readonly componentId = 'minecraft:potion';
 }
 
@@ -13631,7 +13709,6 @@ export class ItemStack {
      */
     keepOnDeath: boolean;
     /**
-     * @rc
      * @remarks
      * Key for the localization of this items's name used in .lang
      * files.
@@ -14050,16 +14127,6 @@ export class ItemStack {
      * ```
      */
     setLore(loreList?: (RawMessage | string)[]): void;
-    /**
-     * @beta
-     * @remarks
-     * Helper function for creating potion items.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
-     */
-    static createPotion(options: PotionOptions): ItemStack;
 }
 
 /**
@@ -14814,7 +14881,7 @@ export class PackSettingChangeAfterEvent {
      * The value of the setting.
      *
      */
-    readonly settingValue: boolean | number;
+    readonly settingValue: boolean | number | string;
 }
 
 /**
@@ -14986,7 +15053,6 @@ export class Player extends Entity {
      */
     readonly clientSystemInfo: ClientSystemInfo;
     /**
-     * @rc
      * @remarks
      * This property can't be edited in read-only mode.
      *
@@ -15069,7 +15135,6 @@ export class Player extends Entity {
      */
     readonly onScreenDisplay: ScreenDisplay;
     /**
-     * @rc
      * @throws This property can throw when used.
      *
      * {@link InvalidEntityError}
@@ -16016,7 +16081,6 @@ export class PlayerGameModeChangeBeforeEventSignal {
 }
 
 /**
- * @rc
  * Contains information regarding an event after changing the
  * selected hotbar slot for a player.
  */
@@ -16049,7 +16113,6 @@ export class PlayerHotbarSelectedSlotChangeAfterEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are connected after a player selected
  * hotbar slot is changed.
  */
@@ -16531,7 +16594,6 @@ export class PlayerInteractWithEntityBeforeEventSignal {
 }
 
 /**
- * @rc
  * Contains information regarding an event after a player's
  * inventory item changes.
  */
@@ -16570,7 +16632,6 @@ export class PlayerInventoryItemChangeAfterEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are connected after a player's
  * inventory item is changed.
  */
@@ -16934,41 +16995,65 @@ export class PlayerSpawnAfterEventSignal {
 
 /**
  * @beta
- * Represents a type of potion effect - like healing or leaping
- * - that can be used with PotionOptions.
+ * Represents how the potion effect is delivered.
  */
-export class PotionEffectType {
+export class PotionDeliveryType {
     private constructor();
     readonly id: string;
 }
 
 /**
  * @beta
- * Represents a type of potion liquid - like splash, or
- * lingering - that can be used with PotionOptions.
+ * Represents a type of potion effect - like healing or
+ * leaping.
  */
-export class PotionLiquidType {
-    private constructor();
-    readonly id: string;
-}
-
-/**
- * @beta
- * Represents a type of potion modifier - like strong, or long
- * - that can be used with PotionOptions.
- */
-export class PotionModifierType {
+export class PotionEffectType {
     private constructor();
+    /**
+     * @remarks
+     * Duration of the effect when applied to an entity in ticks.
+     * Undefined means the effect does not expire.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    readonly durationTicks?: number;
     readonly id: string;
 }
 
 /**
  * @beta
- * Used for accessing all potion effects, liquids, and
- * modifiers currently available for use within the world.
+ * Used for accessing all potion effect types, delivery types,
+ * and creating potions.
  */
 export class Potions {
     private constructor();
+    /**
+     * @remarks
+     * Retrieves handles for all registered potion delivery types.
+     *
+     * @returns
+     * Array of all registered delivery type handles.
+     */
+    static getAllDeliveryTypes(): PotionDeliveryType[];
+    /**
+     * @remarks
+     * Retrieves all type handle for all registered potion effects.
+     *
+     * @returns
+     * Array of all registered effect type handles.
+     */
+    static getAllEffectTypes(): PotionEffectType[];
+    /**
+     * @remarks
+     * Retrieves a type handle for a specified potion delivery id.
+     *
+     * @returns
+     * A type handle wrapping the valid delivery id, or undefined
+     * for an invalid delivery id.
+     */
+    static getDeliveryType(potionDeliveryId: string): PotionDeliveryType | undefined;
     /**
      * @remarks
      * Retrieves a type handle for a specified potion effect id.
@@ -16980,25 +17065,23 @@ export class Potions {
      * A type handle wrapping the valid effect id, or undefined for
      * an invalid effect id.
      */
-    static getPotionEffectType(potionEffectId: string): PotionEffectType | undefined;
+    static getEffectType(potionEffectId: string): PotionEffectType | undefined;
     /**
      * @remarks
-     * Retrieves a type handle for a specified potion liquid id.
+     * Creates a potion given an effect and delivery type.
      *
-     * @returns
-     * A type handle wrapping the valid liquid id, or undefined for
-     * an invalid liquid id.
-     */
-    static getPotionLiquidType(potionLiquidId: string): PotionLiquidType | undefined;
-    /**
-     * @remarks
-     * Retrieves a type handle for a specified potion modifier id.
+     * @throws This function can throw errors.
      *
-     * @returns
-     * A type handle wrapping the valid modifier id, or undefined
-     * for an invalid modifier id.
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link InvalidPotionDeliveryTypeError}
+     *
+     * {@link InvalidPotionEffectTypeError}
      */
-    static getPotionModifierType(potionModifierId: string): PotionModifierType | undefined;
+    static resolve<
+        T extends string = minecraftvanilladata.MinecraftPotionEffectTypes,
+        U extends string = minecraftvanilladata.MinecraftPotionDeliveryTypes,
+    >(potionEffectType: PotionEffectType | T, potionDeliveryType: PotionDeliveryType | U): ItemStack;
 }
 
 /**
@@ -18056,7 +18139,6 @@ export class StartupEvent {
      */
     readonly blockComponentRegistry: BlockComponentRegistry;
     /**
-     * @rc
      * @remarks
      * This property can be read in early-execution mode.
      *
@@ -19387,7 +19469,7 @@ export class World {
      * This function can be called in early-execution mode.
      *
      */
-    getPackSettings(): Record<string, boolean | number>;
+    getPackSettings(): Record<string, boolean | number | string>;
     /**
      * @remarks
      * Returns a set of players based on a set of conditions
@@ -19912,7 +19994,6 @@ export class WorldAfterEvents {
      */
     readonly playerGameModeChange: PlayerGameModeChangeAfterEventSignal;
     /**
-     * @rc
      * @remarks
      * This event fires when a player's selected slot changes.
      *
@@ -19953,7 +20034,6 @@ export class WorldAfterEvents {
      */
     readonly playerInteractWithEntity: PlayerInteractWithEntityAfterEventSignal;
     /**
-     * @rc
      * @remarks
      * This event fires when an item gets added or removed to the
      * player's inventory.
@@ -20699,7 +20779,6 @@ export interface ContainerRules {
 }
 
 /**
- * @rc
  * Define the custom command, including name, permissions, and
  * parameters.
  */
@@ -20744,7 +20823,6 @@ export interface CustomCommand {
 }
 
 /**
- * @rc
  * Definition for each parameter expected by the custom
  * command.
  */
@@ -20773,7 +20851,6 @@ export interface CustomCommandParameter {
 }
 
 /**
- * @rc
  * Interface returned from custom command callback function.
  */
 export interface CustomCommandResult {
@@ -21558,6 +21635,29 @@ export interface ExplosionOptions {
     source?: Entity;
 }
 
+/**
+ * @beta
+ * Contains additional options for getBlockStandingOn and
+ * getAllBlocksStandingOn.
+ */
+export interface GetBlocksStandingOnOptions {
+    /**
+     * @remarks
+     * When specified, the function will include / exclude what
+     * block(s) are returned based on the block filter.
+     *
+     */
+    blockFilter?: BlockFilter;
+    /**
+     * @remarks
+     * If true, all blocks of height 0.2 or lower like trapdoors
+     * and carpets will be ignored, and the block underneath will
+     * be returned.
+     *
+     */
+    ignoreThinBlocks?: boolean;
+}
+
 /**
  * Greater than operator.
  */
@@ -21583,7 +21683,6 @@ export interface GreaterThanOrEqualsComparison {
 }
 
 /**
- * @rc
  * Contains additional filtering options for hotbar events.
  */
 export interface HotbarEventOptions {
@@ -21620,7 +21719,6 @@ export interface InputEventOptions {
 }
 
 /**
- * @rc
  * Contains additional filtering options for inventory item
  * events.
  */
@@ -21954,35 +22052,6 @@ export interface PlayerSoundOptions {
     volume?: number;
 }
 
-/**
- * @beta
- * Options for use in creating potions. See
- * ItemStack.createPotion.
- */
-export interface PotionOptions {
-    /**
-     * @remarks
-     * The type of potion effect to create. See
-     * @minecraft/vanilla-data.MinecraftPotionEffectTypes.
-     *
-     */
-    effect: PotionEffectType | string;
-    /**
-     * @remarks
-     * Optional potion liquid, defaults to 'Regular'. See
-     * @minecraft/vanilla-data.MinecraftPotionLiquidTypes.
-     *
-     */
-    liquid?: PotionLiquidType | string;
-    /**
-     * @remarks
-     * Optional potion modifier, defaults to 'Normal'. See
-     * @minecraft/vanilla-data.MinecraftPotionModifierTypes.
-     *
-     */
-    modifier?: PotionModifierType | string;
-}
-
 /**
  * Optional arguments for
  * @minecraft/server.EntityProjectileComponent.shoot.
@@ -22658,7 +22727,6 @@ export class ContainerRulesError extends Error {
 }
 
 /**
- * @rc
  * Error object thrown when CustomCommandRegistry errors occur.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -22711,7 +22779,6 @@ export class EntitySpawnError extends Error {
 }
 
 /**
- * @rc
  * The container is invalid. This can occur if the container is
  * missing or deleted.
  */
@@ -22777,6 +22844,22 @@ export class InvalidIteratorError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class InvalidPotionDeliveryTypeError extends Error {
+    private constructor();
+}
+
+/**
+ * @beta
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class InvalidPotionEffectTypeError extends Error {
+    private constructor();
+}
+
 /**
  * Thrown when a Structure is invalid. A structure becomes
  * invalid when it is deleted.

package/package.json

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