@minecraft/server 1.10.0-rc.1.21.0-preview.21 → 1.10.0

package/index.d.ts

@@ -15,15 +15,12 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.9.0"
+ *   "version": "1.10.0"
  * }
  * ```
  *
  */
 import * as minecraftcommon from '@minecraft/common';
-/**
- * @beta
- */
 export enum BlockComponentTypes {
     Inventory = 'minecraft:inventory',
     Piston = 'minecraft:piston',
@@ -263,9 +260,6 @@ export enum EasingType {
     Spring = 'Spring',
 }
 
-/**
- * @beta
- */
 export enum EntityComponentTypes {
     CanClimb = 'minecraft:can_climb',
     CanFly = 'minecraft:can_fly',
@@ -691,27 +685,23 @@ export enum GameMode {
 }
 
 /**
- * @beta
  * The types of item components that are accessible via
  * function ItemStack.getComponent.
  */
 export enum ItemComponentTypes {
     /**
-     * @beta
      * @remarks
      * The minecraft:cooldown component.
      *
      */
     Cooldown = 'minecraft:cooldown',
     /**
-     * @beta
      * @remarks
      * The minecraft:durability component.
      *
      */
     Durability = 'minecraft:durability',
     /**
-     * @beta
      * @remarks
      * The minecraft:food component.
      *
@@ -905,18 +895,12 @@ export enum SignSide {
     Front = 'Front',
 }
 
-/**
- * @beta
- */
 export enum StructureAnimationMode {
     Blocks = 'Blocks',
     Layers = 'Layers',
     None = 'None',
 }
 
-/**
- * @beta
- */
 export enum StructureMirrorAxis {
     None = 'None',
     X = 'X',
@@ -924,9 +908,6 @@ export enum StructureMirrorAxis {
     Z = 'Z',
 }
 
-/**
- * @beta
- */
 export enum StructureRotation {
     None = 'None',
     Rotate180 = 'Rotate180',
@@ -934,9 +915,6 @@ export enum StructureRotation {
     Rotate90 = 'Rotate90',
 }
 
-/**
- * @beta
- */
 export enum StructureSaveMode {
     Memory = 'Memory',
     World = 'World',
@@ -1171,7 +1149,6 @@ export class Block {
      */
     getComponent(componentId: string): BlockComponent | undefined;
     /**
-     * @beta
      * @remarks
      * Creates a prototype item stack based on this block that can
      * be used with Container/ContainerSlot APIs.
@@ -1436,7 +1413,6 @@ export class BlockPermutation {
      */
     getAllStates(): Record<string, boolean | number | string>;
     /**
-     * @beta
      * @remarks
      * Retrieves a prototype item stack based on this block
      * permutation that can be used with item
@@ -2837,7 +2813,6 @@ export class Dimension {
      *
      * @param options
      * Additional options for processing this raycast query.
-     * @throws This function can throw errors.
      */
     getEntitiesFromRay(location: Vector3, direction: Vector3, options?: EntityRaycastOptions): EntityRaycastHit[];
     /**
@@ -3229,6 +3204,7 @@ export class EffectAddBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: EffectAddBeforeEvent) => void): void;
 }
@@ -5127,6 +5103,7 @@ export class EntityLoadAfterEventSignal {
      * @param callback
      * Original function that was passed into the subscribe event,
      * that is to be unregistered.
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: EntityLoadAfterEvent) => void): void;
 }
@@ -5250,7 +5227,6 @@ export class EntityOnFireComponent extends EntityComponent {
 }
 
 /**
- * @beta
  * The projectile component controls the properties of a
  * projectile entity and allows it to be shot in a given
  * direction.
@@ -5541,6 +5517,7 @@ export class EntityRemoveBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: EntityRemoveBeforeEvent) => void): void;
 }
@@ -5653,12 +5630,12 @@ export class EntitySpawnAfterEventSignal {
      * @param callback
      * Original function that was passed into the subscribe event,
      * that is to be unregistered.
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: EntitySpawnAfterEvent) => void): void;
 }
 
 /**
- * @beta
  * Represents information about a type of entity.
  */
 export class EntityType {
@@ -5672,9 +5649,6 @@ export class EntityType {
     readonly id: string;
 }
 
-/**
- * @beta
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class EntityTypeFamilyComponent extends EntityComponent {
     private constructor();
@@ -5690,7 +5664,6 @@ export class EntityTypeFamilyComponent extends EntityComponent {
 }
 
 /**
- * @beta
  * Used for accessing all entity types currently available for
  * use within the world.
  */
@@ -5786,6 +5759,7 @@ export class ExplosionAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ExplosionAfterEvent) => void): void;
 }
@@ -5837,6 +5811,7 @@ export class ExplosionBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ExplosionBeforeEvent) => void): void;
 }
@@ -5928,6 +5903,7 @@ export class IButtonPushAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ButtonPushAfterEvent) => void): void;
 }
@@ -5952,6 +5928,7 @@ export class ILeverActionAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: LeverActionAfterEvent) => void): void;
 }
@@ -5976,6 +5953,7 @@ export class IPlayerJoinAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerJoinAfterEvent) => void): void;
 }
@@ -6000,6 +5978,7 @@ export class IPlayerLeaveAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerLeaveAfterEvent) => void): void;
 }
@@ -6024,6 +6003,7 @@ export class IPlayerSpawnAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerSpawnAfterEvent) => void): void;
 }
@@ -6077,6 +6057,7 @@ export class ItemCompleteUseAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemCompleteUseAfterEvent) => void): void;
 }
@@ -6090,7 +6071,6 @@ export class ItemComponent extends Component {
 }
 
 /**
- * @beta
  * When present on an item, this item has a cooldown effect
  * when used by entities.
  */
@@ -6294,6 +6274,7 @@ export class ItemReleaseUseAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemReleaseUseAfterEvent) => void): void;
 }
@@ -6303,7 +6284,7 @@ export class ItemReleaseUseAfterEventSignal {
  * @example givePlayerIronFireSword.ts
  * ```typescript
  * // Spawns a bunch of item stacks
- * import { EnchantmentType, ItemComponentTypes, ItemStack, Player } from '@minecraft/server';
+ * import { ItemComponentTypes, ItemStack, Player } from '@minecraft/server';
  * import { MinecraftItemTypes, MinecraftEnchantmentTypes } from '@minecraft/vanilla-data';
  *
  * function giveFireSword(player: Player) {
@@ -6311,7 +6292,7 @@ export class ItemReleaseUseAfterEventSignal {
  *
  *     const enchantments = ironFireSword?.getComponent(ItemComponentTypes.Enchantable);
  *     if (enchantments) {
- *         enchantments.addEnchantment({ type: new EnchantmentType(MinecraftEnchantmentTypes.FireAspect), level: 1 });
+ *         enchantments.addEnchantment({ type: MinecraftEnchantmentTypes.FireAspect, level: 1 });
  *     }
  *
  *     const inventory = player.getComponent('minecraft:inventory');
@@ -6774,6 +6755,7 @@ export class ItemStartUseAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemStartUseAfterEvent) => void): void;
 }
@@ -6838,6 +6820,7 @@ export class ItemStartUseOnAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemStartUseOnAfterEvent) => void): void;
 }
@@ -6895,6 +6878,7 @@ export class ItemStopUseAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemStopUseAfterEvent) => void): void;
 }
@@ -6952,6 +6936,7 @@ export class ItemStopUseOnAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemStopUseOnAfterEvent) => void): void;
 }
@@ -7010,6 +6995,7 @@ export class ItemUseAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemUseAfterEvent) => void): void;
 }
@@ -7047,6 +7033,7 @@ export class ItemUseBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemUseBeforeEvent) => void): void;
 }
@@ -7113,6 +7100,7 @@ export class ItemUseOnAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemUseOnAfterEvent) => void): void;
 }
@@ -7154,6 +7142,7 @@ export class ItemUseOnBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ItemUseOnBeforeEvent) => void): void;
 }
@@ -7380,6 +7369,7 @@ export class PistonActivateAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PistonActivateAfterEvent) => void): void;
 }
@@ -7509,7 +7499,6 @@ export class Player extends Entity {
      */
     getTotalXp(): number;
     /**
-     * @beta
      * @remarks
      * Plays a music track that only this particular player can
      * hear.
@@ -7535,7 +7524,6 @@ export class Player extends Entity {
      */
     playSound(soundId: string, soundOptions?: PlayerSoundOptions): void;
     /**
-     * @beta
      * @remarks
      * Queues an additional music track that only this particular
      * player can hear. If a track is not playing, a music track
@@ -7616,7 +7604,6 @@ export class Player extends Entity {
      */
     setSpawnPoint(spawnPoint?: DimensionLocation): void;
     /**
-     * @beta
      * @remarks
      * Stops any music tracks from playing for this particular
      * player.
@@ -7689,6 +7676,7 @@ export class PlayerBreakBlockAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerBreakBlockAfterEvent) => void): void;
 }
@@ -7746,6 +7734,7 @@ export class PlayerBreakBlockBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerBreakBlockBeforeEvent) => void): void;
 }
@@ -7811,6 +7800,7 @@ export class PlayerDimensionChangeAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerDimensionChangeAfterEvent) => void): void;
 }
@@ -7879,6 +7869,7 @@ export class PlayerInteractWithBlockAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerInteractWithBlockAfterEvent) => void): void;
 }
@@ -7953,6 +7944,7 @@ export class PlayerInteractWithBlockBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerInteractWithBlockBeforeEvent) => void): void;
 }
@@ -8008,6 +8000,7 @@ export class PlayerInteractWithEntityAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerInteractWithEntityAfterEvent) => void): void;
 }
@@ -8069,6 +8062,7 @@ export class PlayerInteractWithEntityBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerInteractWithEntityBeforeEvent) => void): void;
 }
@@ -8170,6 +8164,7 @@ export class PlayerLeaveBeforeEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerLeaveBeforeEvent) => void): void;
 }
@@ -8214,6 +8209,7 @@ export class PlayerPlaceBlockAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PlayerPlaceBlockAfterEvent) => void): void;
 }
@@ -8297,6 +8293,7 @@ export class PressurePlatePopAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PressurePlatePopAfterEvent) => void): void;
 }
@@ -8352,6 +8349,7 @@ export class PressurePlatePushAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: PressurePlatePushAfterEvent) => void): void;
 }
@@ -8425,6 +8423,7 @@ export class ProjectileHitBlockAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ProjectileHitBlockAfterEvent) => void): void;
 }
@@ -8498,6 +8497,7 @@ export class ProjectileHitEntityAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: ProjectileHitEntityAfterEvent) => void): void;
 }
@@ -8952,7 +8952,6 @@ export class ScriptEventCommandMessageAfterEventSignal {
 }
 
 /**
- * @beta
  * Represents a loaded structure template (.mcstructure file).
  * Structures can be placed in a world using the /structure
  * command or the {@link StructureManager} APIs.
@@ -9029,7 +9028,6 @@ export class Structure {
 }
 
 /**
- * @beta
  * Manager for Structure related APIs. Includes APIs for
  * creating, getting, placing and deleting Structures.
  */
@@ -9301,6 +9299,7 @@ export class TargetBlockHitAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: TargetBlockHitAfterEvent) => void): void;
 }
@@ -9409,6 +9408,7 @@ export class TripWireTripAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: TripWireTripAfterEvent) => void): void;
 }
@@ -9458,6 +9458,7 @@ export class WeatherChangeAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: WeatherChangeAfterEvent) => void): void;
 }
@@ -9492,7 +9493,6 @@ export class World {
      */
     readonly scoreboard: Scoreboard;
     /**
-     * @beta
      * @remarks
      * Returns the manager for {@link Structure} related APIs.
      *
@@ -10204,7 +10204,6 @@ export class WorldAfterEvents {
      */
     readonly weatherChange: WeatherChangeAfterEventSignal;
     /**
-     * @beta
      * @remarks
      * This event fires when the script environment is initialized
      * on a World.
@@ -10271,7 +10270,6 @@ export class WorldBeforeEvents {
 }
 
 /**
- * @beta
  * Contains information and methods that can be used at the
  * initialization of the scripting environment for a World.
  */
@@ -10280,7 +10278,6 @@ export class WorldInitializeAfterEvent {
 }
 
 /**
- * @beta
  * Manages callbacks that are run on the first tick of the
  * World. Do note that this event may run multiple times within
  * a session in the case that the /reload command is used.
@@ -10303,6 +10300,7 @@ export class WorldInitializeAfterEventSignal {
      *
      * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
     unsubscribe(callback: (arg: WorldInitializeAfterEvent) => void): void;
 }
@@ -10327,15 +10325,6 @@ export interface BlockEventOptions {
     permutations?: BlockPermutation[];
 }
 
-export interface BlockFilter {
-    excludePermutations?: BlockPermutation[];
-    excludeTags?: string[];
-    excludeTypes?: string[];
-    includePermutations?: BlockPermutation[];
-    includeTags?: string[];
-    includeTypes?: string[];
-}
-
 /**
  * Contains more information for events where a block is hit.
  */
@@ -10390,8 +10379,7 @@ export interface BlockRaycastHit {
  * Contains additional options for configuring a block raycast
  * query.
  */
-// @ts-ignore Class inheritance allowed for native defined classes
-export interface BlockRaycastOptions extends BlockFilter {
+export interface BlockRaycastOptions {
     /**
      * @remarks
      * If true, liquid blocks will be considered as blocks that
@@ -10688,127 +10676,6 @@ export interface EntityEventOptions {
     entityTypes?: string[];
 }
 
-/**
- * Contains options for filtering entities.
- */
-export interface EntityFilter {
-    /**
-     * @remarks
-     * Excludes entities that match one or more of the specified
-     * families.
-     *
-     */
-    excludeFamilies?: string[];
-    /**
-     * @remarks
-     * Excludes entities if have a specific gamemode that matches
-     * the specified gamemode.
-     *
-     */
-    excludeGameModes?: GameMode[];
-    /**
-     * @remarks
-     * Excludes entities that have a name that match one of the
-     * specified values.
-     *
-     */
-    excludeNames?: string[];
-    /**
-     * @remarks
-     * Excludes entities with a tag that matches one of the
-     * specified values.
-     *
-     */
-    excludeTags?: string[];
-    /**
-     * @remarks
-     * Excludes entities if they are one of the specified types.
-     *
-     */
-    excludeTypes?: string[];
-    /**
-     * @remarks
-     * If specified, includes entities that match all of the
-     * specified families.
-     *
-     */
-    families?: string[];
-    /**
-     * @remarks
-     * If specified, includes entities with a gamemode that matches
-     * the specified gamemode.
-     *
-     */
-    gameMode?: GameMode;
-    /**
-     * @remarks
-     * If specified, will only include entities that have at most
-     * this horizontal rotation.
-     *
-     */
-    maxHorizontalRotation?: number;
-    /**
-     * @remarks
-     * If defined, only players that have at most this level are
-     * returned.
-     *
-     */
-    maxLevel?: number;
-    /**
-     * @remarks
-     * If specified, only entities that have at most this vertical
-     * rotation are returned.
-     *
-     */
-    maxVerticalRotation?: number;
-    /**
-     * @remarks
-     * If specified, will only include entities that have at a
-     * minimum this horizontal rotation.
-     *
-     */
-    minHorizontalRotation?: number;
-    /**
-     * @remarks
-     * If defined, only players that have at least this level are
-     * returned.
-     *
-     */
-    minLevel?: number;
-    /**
-     * @remarks
-     * If specified, will only include entities that have at least
-     * this vertical rotation.
-     *
-     */
-    minVerticalRotation?: number;
-    /**
-     * @remarks
-     * Includes entities with the specified name.
-     *
-     */
-    name?: string;
-    /**
-     * @remarks
-     * Gets/sets a collection of EntityQueryScoreOptions objects
-     * with filters for specific scoreboard objectives.
-     *
-     */
-    scoreOptions?: EntityQueryScoreOptions[];
-    /**
-     * @remarks
-     * Includes entities that match all of the specified tags.
-     *
-     */
-    tags?: string[];
-    /**
-     * @remarks
-     * If defined, entities that match this type are included.
-     *
-     */
-    type?: string;
-}
-
 /**
  * Contains additional information about an entity that was
  * hit.
@@ -10877,162 +10744,6 @@ export interface EntityHitInformation {
  *     });
  * }
  * ```
- * @example testPropertyOptionsWithEqualsComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={propId=propValue}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesHavingPropertyEqualsTo(propId: string, propValue: boolean | number | string) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { equals: propValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithGreaterThanComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // No equivalent commands as `propValue..` is inclusive in commands
- *
- * function findEntitiesHavingPropertyGreaterThan(propId: string, propValue: number) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { greaterThan: propValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithGreaterThanOrEqualsComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={propId=propValue..}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesHavingPropertyGreaterThanOrEqualsTo(propId: string, propValue: number) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { greaterThanOrEquals: propValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithHavingAProperty.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={property=propId}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesHavingAProperty(propId: string) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithLessThanComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // No equivalent commands as `..propValue` is inclusive in commands
- *
- * function findEntitiesHavingPropertyLessThan(propId: string, propValue: number) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { lessThan: propValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithLessThanOrEqualsComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={propId=..propValue}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesHavingPropertyLessThanOrEqualsTo(propId: string, propValue: number) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { lessThanOrEquals: propValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithNotEqualsComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={propId=!propValue}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesHavingPropertyNotEqualsTo(propId: string, propValue: boolean | number | string) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { notEquals: propValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithNotHavingAProperty.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={property=!propId}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesNotHavingAProperty(propId: string) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, exclude: true }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
- * @example testPropertyOptionsWithRangeComparison.ts
- * ```typescript
- * import { world, EntityQueryOptions } from '@minecraft/server';
- *
- * // Having this command:
- *
- * // execute as @e[has_property={propId=lowerBoundValue..upperBoundValue}]
- *
- * // Equivalent scripting code would be:
- * function findEntitiesHavingPropertyWithinRange(propId: string, lowerBoundValue: number, upperBoundValue: number) {
- *     const queryOption: EntityQueryOptions = {
- *         propertyOptions: [{ propertyId: propId, value: { lowerBound: lowerBoundValue, upperBound: upperBoundValue } }]
- *     };
- *
- *     const overworld = world.getDimension('overworld');
- *     const entities = overworld.getEntities(queryOption);
- * }
- * ```
  * @example testSendMessageAllPlayers.ts
  * ```typescript
  * import { Dimension } from '@minecraft/server';
@@ -11111,9 +10822,32 @@ export interface EntityHitInformation {
  *     });
  * }
  * ```
+ * @example checkFeatherNearby.ts
+ * ```typescript
+ * import { DimensionLocation, EntityComponentTypes } from "@minecraft/server";
+ *
+ * // Returns true if a feather item entity is within 'distance' blocks of 'location'.
+ * function isFeatherNear(location: DimensionLocation, distance: number): boolean {
+ *     const items = location.dimension.getEntities({
+ *         location: location,
+ *         maxDistance: 20,
+ *     });
+ *
+ *     for (const item of items) {
+ *         const itemComp = item.getComponent(EntityComponentTypes.Item);
+ *
+ *         if (itemComp) {
+ *             if (itemComp.itemStack.typeId.endsWith('feather')) {
+ *                 return true;
+ *             }
+ *         }
+ *     }
+ *
+ *     return false;
+ * }
+ * ```
  */
-// @ts-ignore Class inheritance allowed for native defined classes
-export interface EntityQueryOptions extends EntityFilter {
+export interface EntityQueryOptions {
     /**
      * @remarks
      * Limits the number of entities to return, opting for the
@@ -11123,6 +10857,47 @@ export interface EntityQueryOptions extends EntityFilter {
      *
      */
     closest?: number;
+    /**
+     * @remarks
+     * Excludes entities that match one or more of the specified
+     * families.
+     *
+     */
+    excludeFamilies?: string[];
+    /**
+     * @remarks
+     * Excludes entities if have a specific gamemode that matches
+     * the specified gamemode.
+     *
+     */
+    excludeGameModes?: GameMode[];
+    /**
+     * @remarks
+     * Excludes entities that have a name that match one of the
+     * specified values.
+     *
+     */
+    excludeNames?: string[];
+    /**
+     * @remarks
+     * Excludes entities with a tag that matches one of the
+     * specified values.
+     *
+     */
+    excludeTags?: string[];
+    /**
+     * @remarks
+     * Excludes entities if they are one of the specified types.
+     *
+     */
+    excludeTypes?: string[];
+    /**
+     * @remarks
+     * If specified, includes entities that match all of the
+     * specified families.
+     *
+     */
+    families?: string[];
     /**
      * @remarks
      * Limits the number of entities to return, opting for the
@@ -11132,6 +10907,13 @@ export interface EntityQueryOptions extends EntityFilter {
      *
      */
     farthest?: number;
+    /**
+     * @remarks
+     * If specified, includes entities with a gamemode that matches
+     * the specified gamemode.
+     *
+     */
+    gameMode?: GameMode;
     /**
      * @remarks
      * Adds a seed location to the query that is used in
@@ -11148,6 +10930,27 @@ export interface EntityQueryOptions extends EntityFilter {
      *
      */
     maxDistance?: number;
+    /**
+     * @remarks
+     * If specified, will only include entities that have at most
+     * this horizontal rotation.
+     *
+     */
+    maxHorizontalRotation?: number;
+    /**
+     * @remarks
+     * If defined, only players that have at most this level are
+     * returned.
+     *
+     */
+    maxLevel?: number;
+    /**
+     * @remarks
+     * If specified, only entities that have at most this vertical
+     * rotation are returned.
+     *
+     */
+    maxVerticalRotation?: number;
     /**
      * @remarks
      * If specified, includes entities that are least this distance
@@ -11155,6 +10958,52 @@ export interface EntityQueryOptions extends EntityFilter {
      *
      */
     minDistance?: number;
+    /**
+     * @remarks
+     * If specified, will only include entities that have at a
+     * minimum this horizontal rotation.
+     *
+     */
+    minHorizontalRotation?: number;
+    /**
+     * @remarks
+     * If defined, only players that have at least this level are
+     * returned.
+     *
+     */
+    minLevel?: number;
+    /**
+     * @remarks
+     * If specified, will only include entities that have at least
+     * this vertical rotation.
+     *
+     */
+    minVerticalRotation?: number;
+    /**
+     * @remarks
+     * Includes entities with the specified name.
+     *
+     */
+    name?: string;
+    /**
+     * @remarks
+     * Gets/sets a collection of EntityQueryScoreOptions objects
+     * with filters for specific scoreboard objectives.
+     *
+     */
+    scoreOptions?: EntityQueryScoreOptions[];
+    /**
+     * @remarks
+     * Includes entities that match all of the specified tags.
+     *
+     */
+    tags?: string[];
+    /**
+     * @remarks
+     * If defined, entities that match this type are included.
+     *
+     */
+    type?: string;
 }
 
 /**
@@ -11212,8 +11061,7 @@ export interface EntityRaycastHit {
 /**
  * Contains additional options for an entity raycast operation.
  */
-// @ts-ignore Class inheritance allowed for native defined classes
-export interface EntityRaycastOptions extends EntityFilter {
+export interface EntityRaycastOptions {
     /**
      * @remarks
      * Maximum distance, in blocks, to process the raycast.
@@ -11359,9 +11207,6 @@ export interface PlayerSoundOptions {
     volume?: number;
 }
 
-/**
- * @beta
- */
 export interface ProjectileShootOptions {
     uncertainty?: number;
 }
@@ -11578,7 +11423,6 @@ export interface ScriptEventMessageFilterOptions {
 }
 
 /**
- * @beta
  * Provides additional options for {@link
  * StructureManager.createFromWorld}
  */
@@ -11607,7 +11451,6 @@ export interface StructureCreateOptions {
 }
 
 /**
- * @beta
  * Provides additional options for {@link
  * StructureManager.place}
  */
@@ -11851,7 +11694,6 @@ export class InvalidContainerSlotError extends Error {
 }
 
 /**
- * @beta
  * 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": "1.10.0-rc.1.21.0-preview.21",
+  "version": "1.10.0",
   "description": "",
   "contributors": [
     {