@minecraft/server 2.3.0-beta.1.21.110-preview.23 → 2.3.0-beta.1.21.110-preview.25

package/index.d.ts

@@ -133,7 +133,7 @@ export enum BlockVolumeIntersection {
 }
 
 /**
- * @beta
+ * @rc
  * An enum of error reasons relating to using {@link
  * ItemBookComponent}.
  */
@@ -1891,6 +1891,26 @@ export enum GraphicsMode {
     Simple = 'Simple',
 }
 
+/**
+ * @beta
+ * Specifies options related to the item currently being held
+ * by an entity.
+ */
+export enum HeldItemOption {
+    /**
+     * @remarks
+     * Any item is being held.
+     *
+     */
+    AnyItem = 'AnyItem',
+    /**
+     * @remarks
+     * No item is being held.
+     *
+     */
+    NoItem = 'NoItem',
+}
+
 export enum HudElement {
     PaperDoll = 0,
     Armor = 1,
@@ -2076,7 +2096,7 @@ export enum InputPermissionCategory {
  */
 export enum ItemComponentTypes {
     /**
-     * @beta
+     * @rc
      * @remarks
      * The minecraft:book component.
      *
@@ -5708,6 +5728,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
@@ -5725,7 +5762,7 @@ export class Camera {
      */
     setDefaultCamera(cameraPreset: string, easeOptions?: EaseOptions): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This function can't be called in read-only mode.
      *
@@ -6811,7 +6848,7 @@ export class ContainerSlot {
      */
     getLore(): string[];
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns the lore value - a secondary display string - for an
      * ItemStack. String lore lines will be converted to a {@link
@@ -7301,8 +7338,6 @@ export class Dimension {
      * time to complete, so avoid using many of these calls within
      * a particular tick.
      *
-     * This function can't be called in read-only mode.
-     *
      * @param pos
      * Starting location to look for a biome to find.
      * @param biomeToFind
@@ -7319,6 +7354,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.
@@ -7349,8 +7402,6 @@ export class Dimension {
      * 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
@@ -7364,8 +7415,6 @@ export class Dimension {
      * 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
@@ -7531,8 +7580,6 @@ export class Dimension {
      * Returns the total brightness level of light shining on a
      * certain block position.
      *
-     * This function can't be called in read-only mode.
-     *
      * @param location
      * Location of the block we want to check the brightness of.
      * @returns
@@ -7567,8 +7614,6 @@ export class Dimension {
      * Returns the brightness level of light shining from the sky
      * on a certain block position.
      *
-     * This function can't be called in read-only mode.
-     *
      * @param location
      * Position of the block we want to check the brightness of.
      * @returns
@@ -7584,8 +7629,6 @@ export class Dimension {
      * @remarks
      * Returns the highest block at the given XZ location.
      *
-     * This function can't be called in read-only mode.
-     *
      * @param locationXZ
      * Location to retrieve the topmost block for.
      * @param minHeight
@@ -7599,13 +7642,21 @@ export class Dimension {
      * @remarks
      * Returns the current weather.
      *
-     * This function can't be called in read-only mode.
-     *
      * @returns
      * Returns a WeatherType that explains the broad category of
      * weather that is currently going on.
      */
     getWeather(): WeatherType;
+    /**
+     * @beta
+     * @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
@@ -8206,6 +8257,16 @@ export class EffectTypes {
     static getAll(): EffectType[];
 }
 
+/**
+ * @beta
+ * Represents a completely empty entry in a loot pool. If this
+ * entry is chosen, no items will drop.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class EmptyLootItem extends LootPoolEntry {
+    private constructor();
+}
+
 /**
  * Contains information on a type of enchantment.
  */
@@ -8726,6 +8787,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
@@ -8741,6 +8819,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)
@@ -12531,7 +12627,7 @@ export class InputInfo {
 }
 
 /**
- * @beta
+ * @rc
  * When present on an item, this item is a book item. Can
  * access and modify the contents of the book and sign it.
  */
@@ -13844,7 +13940,7 @@ export class ItemStack {
      */
     getLore(): string[];
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns the lore value - a secondary display string - for an
      * ItemStack. String lore lines will be converted to a {@link
@@ -14615,6 +14711,166 @@ export class ListBlockVolume extends BlockVolumeBase {
 
 /**
  * @beta
+ * Represents a loot pool entry containing an item to drop.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class LootItem extends LootPoolEntry {
+    private constructor();
+    /**
+     * @remarks
+     * The name of the item contained in this entry.
+     *
+     */
+    readonly name?: ItemType;
+}
+
+/**
+ * @beta
+ * A collection of entries which individually determine loot
+ * drops. Can contain values determining drop outcomes,
+ * including rolls, bonus rolls and tiers.
+ */
+export class LootPool {
+    private constructor();
+    /**
+     * @remarks
+     * Returns the number of extra times a loot pool will be rolled
+     * based on the player's luck level, represented as a range
+     * from minimum to maximum rolls.
+     *
+     */
+    readonly bonusRolls: minecraftcommon.NumberRange;
+    /**
+     * @remarks
+     * Gets a complete list of all loot pool entries contained in
+     * the loot pool.
+     *
+     */
+    readonly entries: LootPoolEntry[];
+    /**
+     * @remarks
+     * Returns the number of times a loot pool will be rolled,
+     * represented as a range from minimum to maximum rolls.
+     *
+     */
+    readonly rolls: minecraftcommon.NumberRange;
+    /**
+     * @remarks
+     * Gets the loot pool tier values for a given table if they
+     * exist.
+     *
+     */
+    readonly tiers?: LootPoolTiers;
+}
+
+/**
+ * @beta
+ * Represents one entry within Loot Table, which describes one
+ * possible drop when a loot drop occurs. Can contain an item,
+ * another loot table, a path to another loot table, or an
+ * empty drop.
+ */
+export class LootPoolEntry {
+    private constructor();
+    /**
+     * @remarks
+     * Gets the quality of a given loot pool entry.
+     *
+     */
+    readonly quality: number;
+    /**
+     * @remarks
+     * Gets the subtable of a given loot pool entry.
+     *
+     */
+    readonly subTable?: LootPoolEntry;
+    /**
+     * @remarks
+     * Gets the weight of a given loot pool entry.
+     *
+     */
+    readonly weight: number;
+}
+
+/**
+ * @beta
+ * Represents the values which determine loot drops in a tiered
+ * loot pool. Potential drops from tiered loot pools are
+ * ordered, and chosen via logic controlled by the values in
+ * this object.
+ */
+export class LootPoolTiers {
+    private constructor();
+    /**
+     * @remarks
+     * The chance for each bonus roll attempt to upgrade the tier
+     * of the dropped item.
+     *
+     */
+    readonly bonusChance: number;
+    /**
+     * @remarks
+     * The number of attempts for the loot drop to upgrade its
+     * tier, thereby incrementing its position in the loot pool
+     * entry array, resulting in a higher tier drop.
+     *
+     */
+    readonly bonusRolls: number;
+    /**
+     * @remarks
+     * Represents the upper bound for the starting point in
+     * determining which tier of loot to drop. The lower bound is
+     * always 1. For example, a value of 3 would result in the tier
+     * drop logic starting at a randomly selected position in the
+     * loot pool entry array between 1 and 3.
+     *
+     */
+    readonly initialRange: number;
+}
+
+/**
+ * @beta
+ * Represents a single Loot Table, which determines what items
+ * are generated when killing a mob, breaking a block, filling
+ * a container, and more.
+ */
+export class LootTable {
+    private constructor();
+    /**
+     * @remarks
+     * Returns the path to the JSON file that represents this loot
+     * table. Does not include file extension, or 'loot_tables/'
+     * folder prefix. Example: `entities/creeper`.
+     *
+     */
+    readonly path: string;
+    /**
+     * @remarks
+     * Returns the array of loot pools on a given loot table.
+     *
+     */
+    readonly pools: LootPool[];
+}
+
+/**
+ * @beta
+ * Represents a loot pool entry containing another separate,
+ * nested loot table.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class LootTableEntry extends LootPoolEntry {
+    private constructor();
+    /**
+     * @remarks
+     * Gets the loot table stored as a subtable in the parent loot
+     * pool.
+     *
+     */
+    readonly lootTable: LootTable;
+}
+
+/**
+ * @rc
  * Manager for Loot Table related APIs. Allows for generation
  * of drops from blocks and entities according to their loot
  * tables.
@@ -14697,6 +14953,51 @@ export class LootTableManager {
      * Can be empty if no loot dropped.
      */
     generateLootFromEntityType(entityType: EntityType, tool?: ItemStack): ItemStack[] | undefined;
+    /**
+     * @beta
+     * @remarks
+     * Generates loot from a given LootTable.
+     *
+     * @param tool
+     * Optional. The tool to use in the looting operation.
+     * @returns
+     * An array of item stacks dropped from the loot drop event.
+     * Can be empty if no loot dropped, or undefined if the
+     * provided tool is insufficient to mine the block.
+     */
+    generateLootFromTable(lootTable: LootTable, tool?: ItemStack): ItemStack[] | undefined;
+    /**
+     * @beta
+     * @remarks
+     * Retrieves a single loot table from the level's current
+     * registry.
+     *
+     * @param path
+     * Path to the table to retrieve. Does not include file
+     * extension, or 'loot_tables/' folder prefix. Example:
+     * `entities/creeper`.
+     * @returns
+     * Returns a LootTable if one is found, or `undefined` if the
+     * provided path does not correspond to an existing loot table.
+     */
+    getLootTable(path: string): LootTable | undefined;
+}
+
+/**
+ * @beta
+ * Represents a loot pool entry containing a reference to
+ * another loot table, described by its path.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class LootTableReference extends LootPoolEntry {
+    private constructor();
+    /**
+     * @remarks
+     * The path to the referenced loot table. Example:
+     * `loot_tables/chests/village/village_bundle.json`
+     *
+     */
+    readonly path: string;
 }
 
 /**
@@ -14811,7 +15112,7 @@ export class PackSettingChangeAfterEvent {
      * The value of the setting.
      *
      */
-    readonly settingValue: boolean | number;
+    readonly settingValue: boolean | number | string;
 }
 
 /**
@@ -16923,6 +17224,65 @@ export class PlayerSpawnAfterEventSignal {
     unsubscribe(callback: (arg0: PlayerSpawnAfterEvent) => void): void;
 }
 
+/**
+ * @beta
+ * Contains information regarding a player starting to swing
+ * their arm.
+ */
+export class PlayerSwingStartAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The item stack being held by the player at the start of
+     * their swing.
+     *
+     */
+    readonly heldItemStack?: ItemStack;
+    /**
+     * @remarks
+     * Source Player for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when a player starts
+ * to swing their arm (e.g. attacking, using an item,
+ * interacting).
+ */
+export class PlayerSwingStartAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a player starts to
+     * swing their arm (e.g. attacking, using an item,
+     * interacting).
+     *
+     * This function can't be called in read-only mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: PlayerSwingStartAfterEvent) => void,
+        options?: PlayerSwingEventOptions,
+    ): (arg0: PlayerSwingStartAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a player starts to
+     * swing their arm (e.g. attacking, using an item,
+     * interacting).
+     *
+     * This function can't be called in read-only mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: PlayerSwingStartAfterEvent) => void): void;
+}
+
 /**
  * @beta
  * Represents how the potion effect is delivered.
@@ -19382,7 +19742,14 @@ export class World {
      */
     getEntity(id: string): Entity | undefined;
     /**
-     * @beta
+     * @rc
+     * @remarks
+     * Returns a manager capable of generating loot from an
+     * assortment of sources.
+     *
+     * @returns
+     * A loot table manager with a variety of loot generation
+     * methods.
      */
     getLootTableManager(): LootTableManager;
     /**
@@ -19399,7 +19766,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
@@ -20008,6 +20375,13 @@ export class WorldAfterEvents {
      *
      */
     readonly playerSpawn: PlayerSpawnAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly playerSwingStart: PlayerSwingStartAfterEventSignal;
     /**
      * @remarks
      * A pressure plate has popped back up (i.e., there are no
@@ -20580,12 +20954,8 @@ export interface CameraFixedBoomOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Used to change the field of view of the current camera.
- *
- * Required Experiments:
- * - Required Experiment Toggle: Experimental Creator Cameras
- *
  */
 export interface CameraFovOptions {
     easeOptions?: EaseOptions;
@@ -21565,6 +21935,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.
  */
@@ -21959,6 +22352,24 @@ export interface PlayerSoundOptions {
     volume?: number;
 }
 
+/**
+ * @beta
+ * An interface that is passed into {@link
+ * @minecraft/Server.PlayerSwingStartAfterEvent.subscribe} that
+ * filters out which events are passed to the provided
+ * callback.
+ */
+export interface PlayerSwingEventOptions {
+    /**
+     * @remarks
+     * The held item option that the callback should be called for.
+     * If undefined, the callback will be called whether or not the
+     * player is holding an item in their hand.
+     *
+     */
+    heldItemOption?: HeldItemOption;
+}
+
 /**
  * Optional arguments for
  * @minecraft/server.EntityProjectileComponent.shoot.
@@ -22566,7 +22977,7 @@ export class BlockCustomComponentReloadVersionError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Errors that can be thrown when using {@link
  * ItemBookComponent}.
  */
@@ -22584,7 +22995,7 @@ export class BookError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * The error called if page content being set on an {@link
  * ItemBookComponent} are invalid ie. exceeding the maximum
  * page length.
@@ -22729,7 +23140,7 @@ export class InvalidEntityError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * The error called when an item is invalid. This can occur
  * when accessing components on a removed item.
  */

package/package.json

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