@minecraft/server 2.6.0-beta.1.26.0-preview.25 → 2.6.0-beta.1.26.0-preview.27

package/index.d.ts

@@ -3299,6 +3299,8 @@ export class AimAssistCategory {
      * The record mapping block tags to their priority settings.
      * Larger numbers have greater priority.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
      */
     getBlockTagPriorities(): Record<string, number>;
     /**
@@ -3311,6 +3313,18 @@ export class AimAssistCategory {
      * @throws This function can throw errors.
      */
     getEntityPriorities(): Record<string, number>;
+    /**
+     * @remarks
+     * Gets the priority settings used for entity targeting.
+     *
+     * @returns
+     * Map entity type families to their priority settings in a
+     * Record. Larger numbers have greater priority.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    getEntityTypeFamilyPriorities(): Record<string, number>;
 }
 
 /**
@@ -3378,6 +3392,15 @@ export class AimAssistCategorySettings {
      * Larger numbers have greater priority.
      */
     getEntityPriorities(): Record<string, number>;
+    /**
+     * @remarks
+     * Gets the priority settings used for entity targeting.
+     *
+     * @returns
+     * Map entity type families to their priority settings in a
+     * Record. Larger numbers have greater priority.
+     */
+    getEntityTypeFamilyPriorities(): Record<string, number>;
     /**
      * @remarks
      * Sets the priority settings used for block targeting.
@@ -3412,6 +3435,14 @@ export class AimAssistCategorySettings {
     setEntityPriorities(
         entityPriorities: Record<keyof typeof minecraftvanilladata.MinecraftEntityTypes | string, number>,
     ): void;
+    /**
+     * @remarks
+     * Sets the priority settings used for entity targeting.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    setEntityTypeFamilyPriorities(entityTypeFamilyPriorities: Record<string, number>): void;
 }
 
 /**
@@ -3450,6 +3481,8 @@ export class AimAssistPreset {
      * @returns
      * The array of block tags.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
      */
     getExcludedBlockTagTargets(): string[];
     /**
@@ -3472,6 +3505,18 @@ export class AimAssistPreset {
      * @throws This function can throw errors.
      */
     getExcludedEntityTargets(): string[];
+    /**
+     * @remarks
+     * Gets the list of entity type families to exclude from aim
+     * assist targeting.
+     *
+     * @returns
+     * The array of entity type families.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    getExcludedEntityTypeFamilyTargets(): string[];
     /**
      * @remarks
      * Gets the per-item aim-assist category Ids.
@@ -3557,6 +3602,15 @@ export class AimAssistPresetSettings {
      * The array of entity Ids.
      */
     getExcludedEntityTargets(): string[] | undefined;
+    /**
+     * @remarks
+     * Gets the list of entity type families to exclude from aim
+     * assist targeting.
+     *
+     * @returns
+     * The array of entity type families.
+     */
+    getExcludedEntityTypeFamilyTargets(): string[] | undefined;
     /**
      * @remarks
      * Gets the per-item aim-assist category Ids.
@@ -3607,6 +3661,17 @@ export class AimAssistPresetSettings {
      * An array of entity Ids.
      */
     setExcludedEntityTargets(targets?: (keyof typeof minecraftvanilladata.MinecraftEntityTypes | string)[]): void;
+    /**
+     * @remarks
+     * Sets the list of entity type families to exclude from aim
+     * assist targeting.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param targets
+     * An array of entity type families.
+     */
+    setExcludedEntityTypeFamilyTargets(targets?: string[]): void;
     /**
      * @remarks
      * Sets the per-item aim-assist category Ids.
@@ -4792,6 +4857,16 @@ export class BlockComponentRedstoneUpdateEvent extends BlockEvent {
      *
      */
     readonly powerLevel: number;
+    /**
+     * @beta
+     * @remarks
+     * The redstone signal strength from the last tick that was
+     * passing through this block. It is guaranteed to be >= the
+     * `min_power` of the block's 'minecraft:redstone_consumer'
+     * component.
+     *
+     */
+    readonly previousPowerLevel: number;
 }
 
 export class BlockComponentRegistry {
@@ -11555,6 +11630,61 @@ export class EntityItemComponent extends EntityComponent {
     static readonly componentId = 'minecraft:item';
 }
 
+/**
+ * @beta
+ * Contains information related to an entity having dropped
+ * items.
+ */
+export class EntityItemDropAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The entity that has dropped the items.
+     *
+     */
+    readonly entity: Entity;
+    /**
+     * @remarks
+     * The list of items the entity has dropped.
+     *
+     */
+    readonly items: Entity[];
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when an entity has
+ * dropped items.
+ */
+export class EntityItemDropAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when an entity has
+     * dropped items.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: EntityItemDropAfterEvent) => void,
+        options?: EntityItemDropEventOptions,
+    ): (arg0: EntityItemDropAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when an entity has
+     * dropped items.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: EntityItemDropAfterEvent) => void): void;
+}
+
 /**
  * @beta
  * Contains information related to an entity having picked up
@@ -22052,6 +22182,15 @@ export class WorldAfterEvents {
      *
      */
     readonly entityHurt: EntityHurtAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when an entity drops items.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly entityItemDrop: EntityItemDropAfterEventSignal;
     /**
      * @beta
      * @remarks
@@ -23692,6 +23831,30 @@ export interface EntityHurtBeforeEventOptions {
     entityFilter?: EntityFilter;
 }
 
+/**
+ * @beta
+ * An interface that is passed into {@link
+ * @minecraft/Server.EntityItemDropAfterEventSignal.subscribe}
+ * that filters out which events are passed to the provided
+ * callback.
+ */
+export interface EntityItemDropEventOptions {
+    /**
+     * @remarks
+     * If this value is set, this event will only fire for entities
+     * that match.
+     *
+     */
+    entityFilter?: EntityFilter;
+    /**
+     * @remarks
+     * If this value is set, this event will only fire if an item
+     * in the event matches.
+     *
+     */
+    itemFilter?: ItemFilter;
+}
+
 /**
  * @beta
  * An interface that is passed into {@link

package/package.json

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