@minecraft/server 2.4.0-rc.1.21.130-preview.28 → 2.4.0

package/README.md

@@ -2,8 +2,6 @@
 
 Contains many types related to manipulating a Minecraft world, including entities, blocks, dimensions, and more.
 
-## **NOTE: This version of this module is still in pre-release.  It may change or it may be removed in future releases.**
-
 See full documentation for this module here:
 
 https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/minecraft/server/minecraft-server

package/index.d.ts

@@ -7,7 +7,6 @@
    Copyright (c) Microsoft Corporation.
    ***************************************************************************** */
 /**
- * @preview
  * @packageDocumentation
  * Contains many types related to manipulating a Minecraft
  * world, including entities, blocks, dimensions, and more.
@@ -231,7 +230,6 @@ export enum ContainerRulesErrorReason {
 }
 
 /**
- * @rc
  * Control Scheme types which define how the player moves in
  * response to player inputs.
  * See the following page for more details on control schemes:
@@ -2028,9 +2026,6 @@ export enum ItemComponentTypes {
      */
     Food = 'minecraft:food',
     Inventory = 'minecraft:inventory',
-    /**
-     * @rc
-     */
     Potion = 'minecraft:potion',
 }
 
@@ -2060,7 +2055,6 @@ export enum ItemLockMode {
 }
 
 /**
- * @rc
  * Specifies how to handle waterloggable blocks overlapping
  * with existing liquid.
  */
@@ -3516,7 +3510,6 @@ export class BlockComponent extends Component {
 }
 
 /**
- * @rc
  * Contains information regarding a specific block being
  * broken.
  */
@@ -4294,9 +4287,6 @@ export class BlockPistonComponent extends BlockComponent {
     getAttachedBlocksLocations(): Vector3[];
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class BlockPrecipitationInteractionsComponent extends BlockComponent {
     private constructor();
@@ -4393,7 +4383,6 @@ export class BlockRecordPlayerComponent extends BlockComponent {
 }
 
 /**
- * @rc
  * Represents a block that can output a redstone signal.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -6019,7 +6008,6 @@ export class CustomComponentParameters {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether the loot source was
  * damaged by a specific type of entity.
  */
@@ -7104,7 +7092,6 @@ export class EffectTypes {
 }
 
 /**
- * @rc
  * Represents a completely empty entry in a loot pool. If this
  * entry is chosen, no items will drop.
  */
@@ -7113,9 +7100,6 @@ export class EmptyLootItem extends LootPoolEntry {
     private constructor();
 }
 
-/**
- * @rc
- */
 export class EnchantInfo {
     private constructor();
     readonly enchantment: string;
@@ -7171,7 +7155,6 @@ export class EnchantmentTypes {
 }
 
 /**
- * @rc
  * Loot item function that applies a random enchant to the
  * dropped item using the same algorithm used while enchanting
  * equipment vanilla mobs spawn with.
@@ -7189,7 +7172,6 @@ export class EnchantRandomEquipmentFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that randomly enchants the dropped item.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -7205,7 +7187,6 @@ export class EnchantRandomlyFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that applies a random enchant to the
  * dropped item.
  */
@@ -7690,7 +7671,6 @@ export class Entity {
      */
     extinguishFire(useEffects?: boolean): boolean;
     /**
-     * @rc
      * @remarks
      * Gets the entity's collision bounds.
      *
@@ -7702,7 +7682,6 @@ export class Entity {
      */
     getAABB(): AABB;
     /**
-     * @rc
      * @remarks
      * Gets the solid blocks that this entity is directly standing
      * on. Ignores pressure plates.
@@ -7734,7 +7713,6 @@ export class Entity {
      */
     getBlockFromViewDirection(options?: BlockRaycastOptions): BlockRaycastHit | undefined;
     /**
-     * @rc
      * @remarks
      * Gets a single solid block closest to the center of the
      * entity that this entity is directly standing on. Ignores
@@ -9002,7 +8980,6 @@ export class EntityFrictionModifierComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Loot item condition that checks the value of the mark
  * variant of a mob as it drops its loot.
  */
@@ -9019,7 +8996,6 @@ export class EntityHasMarkVariantCondition extends LootItemCondition {
 }
 
 /**
- * @rc
  * Loot item condition that checks the variant value of a mob
  * as it drops its loot.
  */
@@ -9573,7 +9549,6 @@ export class EntityItemComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Loot item condition that checks the entity type of the
  * entity dropping its loot.
  */
@@ -11008,7 +10983,6 @@ export class EntityWantsJockeyComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Loot item function that modifies a dropped treasure map to
  * mark a location.
  */
@@ -11135,7 +11109,6 @@ export class ExplosionBeforeEventSignal {
 }
 
 /**
- * @rc
  * Loot item function that determines whether or not loot drops
  * should be destroyed by explosions.
  */
@@ -11212,7 +11185,6 @@ export class FeedItemEffect {
 }
 
 /**
- * @rc
  * Loot item function that populates a dropped container item
  * using another loot table.
  */
@@ -11573,7 +11545,6 @@ export class InputInfo {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether or not the entity
  * dropping loot is a baby.
  */
@@ -12497,7 +12468,6 @@ export class ItemInventoryComponent extends ItemComponent {
 }
 
 /**
- * @rc
  * When present on an item, this item is a potion item.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -13512,7 +13482,6 @@ export class ItemUseOnEvent {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether or not the drop
  * source was killed by a specific type of entity.
  */
@@ -13529,7 +13498,6 @@ export class KilledByEntityCondition extends LootItemCondition {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether or not the source of
  * the loot drop was killed by the player.
  */
@@ -13539,7 +13507,6 @@ export class KilledByPlayerCondition extends LootItemCondition {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether or not the source of
  * the loot drop was killed by the player or any of the
  * player's pets.
@@ -13701,7 +13668,6 @@ export class ListBlockVolume extends BlockVolumeBase {
 }
 
 /**
- * @rc
  * Loot item function that drops extra items if the provided
  * tool has the looting enchant.
  */
@@ -13719,7 +13685,6 @@ export class LootingEnchantFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Represents a loot pool entry containing an item to drop.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -13735,7 +13700,6 @@ export class LootItem extends LootPoolEntry {
 }
 
 /**
- * @rc
  * An abstract base class from which all loot item conditions
  * are derived. A loot item condition is a set of rules or
  * requirements which must be met for a loot drop to happen.
@@ -13745,7 +13709,6 @@ export class LootItemCondition {
 }
 
 /**
- * @rc
  * An abstract base class from which all loot item functions
  * are derived. Loot item functions can modify loot drops in a
  * variety of ways as they happen, optionally dependent on a
@@ -13757,7 +13720,6 @@ export class LootItemFunction {
 }
 
 /**
- * @rc
  * A collection of entries which individually determine loot
  * drops. Can contain values determining drop outcomes,
  * including rolls, bonus rolls and tiers.
@@ -13797,7 +13759,6 @@ export class LootPool {
 }
 
 /**
- * @rc
  * 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
@@ -13826,7 +13787,6 @@ export class LootPoolEntry {
 }
 
 /**
- * @rc
  * 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
@@ -13862,7 +13822,6 @@ export class LootPoolTiers {
 }
 
 /**
- * @rc
  * Represents a single Loot Table, which determines what items
  * are generated when killing a mob, breaking a block, filling
  * a container, and more.
@@ -13886,7 +13845,6 @@ export class LootTable {
 }
 
 /**
- * @rc
  * Represents a loot pool entry containing another separate,
  * nested loot table.
  */
@@ -13986,7 +13944,6 @@ export class LootTableManager {
      */
     generateLootFromEntityType(entityType: EntityType, tool?: ItemStack): ItemStack[] | undefined;
     /**
-     * @rc
      * @remarks
      * Generates loot from a given LootTable.
      *
@@ -13999,7 +13956,6 @@ export class LootTableManager {
      */
     generateLootFromTable(lootTable: LootTable, tool?: ItemStack): ItemStack[] | undefined;
     /**
-     * @rc
      * @remarks
      * Retrieves a single loot table from the level's current
      * registry.
@@ -14016,7 +13972,6 @@ export class LootTableManager {
 }
 
 /**
- * @rc
  * Represents a loot pool entry containing a reference to
  * another loot table, described by its path.
  */
@@ -14033,7 +13988,6 @@ export class LootTableReference extends LootPoolEntry {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether an appropriate tool
  * was used to trigger the loot event. Can describe item type,
  * count, durability, enchantments, or arrays of item tags to
@@ -14160,7 +14114,6 @@ export class MolangVariableMap {
 }
 
 /**
- * @rc
  * Loot item condition that checks whether the looting entity
  * is currently a passenger of a specific type of entity.
  */
@@ -14474,7 +14427,6 @@ export class Player extends Entity {
      */
     clearPropertyOverridesForEntity(targetEntity: Entity | string): void;
     /**
-     * @rc
      * @remarks
      * Returns the player's current control scheme.
      *
@@ -14705,7 +14657,6 @@ export class Player extends Entity {
      */
     sendMessage(message: (RawMessage | string)[] | RawMessage | string): void;
     /**
-     * @rc
      * @remarks
      * Set a player's control scheme. The player's active camera
      * preset must be set by scripts like with camera.setCamera()
@@ -16126,7 +16077,6 @@ export class PlayerSpawnAfterEventSignal {
 }
 
 /**
- * @rc
  * Represents how the potion effect is delivered.
  */
 export class PotionDeliveryType {
@@ -16135,7 +16085,6 @@ export class PotionDeliveryType {
 }
 
 /**
- * @rc
  * Represents a type of potion effect - like healing or
  * leaping.
  */
@@ -16155,7 +16104,6 @@ export class PotionEffectType {
 }
 
 /**
- * @rc
  * Used for accessing all potion effect types, delivery types,
  * and creating potions.
  */
@@ -16483,7 +16431,6 @@ export class ProjectileHitEntityAfterEventSignal {
 }
 
 /**
- * @rc
  * Loot item function that randomly modifies the data value of
  * the item dropped.
  */
@@ -16500,7 +16447,6 @@ export class RandomAuxValueFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that randomly modifies the block state of
  * the item dropped.
  */
@@ -16519,7 +16465,6 @@ export class RandomBlockStateFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item condition that applies a given value to the
  * chances that loot will drop.
  */
@@ -16535,7 +16480,6 @@ export class RandomChanceCondition extends LootItemCondition {
 }
 
 /**
- * @rc
  * Loot item condition that applies a given value to the
  * chances that loot will drop, modified by the level of
  * looting enchantment on the tool used.
@@ -16559,7 +16503,6 @@ export class RandomChanceWithLootingCondition extends LootItemCondition {
 }
 
 /**
- * @rc
  * Loot item condition that applies given values to the chances
  * that loot will drop based on the current difficulty level.
  */
@@ -16577,7 +16520,6 @@ export class RandomDifficultyChanceCondition extends LootItemCondition {
 }
 
 /**
- * @rc
  * Loot item function that applies a randomly dye to the
  * dropped item.
  */
@@ -16587,7 +16529,6 @@ export class RandomDyeFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item condition that applies a given value to the
  * chances that loot will drop, modified by the region the drop
  * is happening within.
@@ -17289,7 +17230,6 @@ export class Seat {
 }
 
 /**
- * @rc
  * Loot item function that modifies the trim on a dropped armor
  * item.
  */
@@ -17311,7 +17251,6 @@ export class SetArmorTrimFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the type of a banner that
  * drops.
  */
@@ -17327,7 +17266,6 @@ export class SetBannerDetailsFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the contents of a dropped
  * book.
  */
@@ -17355,7 +17293,6 @@ export class SetBookContentsFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the dropped item's data
  * value based on its color index. Defaults to zero if no color
  * index is set.
@@ -17366,7 +17303,6 @@ export class SetDataFromColorIndexFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the number items that drop
  * from the loot pool entry.
  */
@@ -17384,7 +17320,6 @@ export class SetItemCountFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the durability value of the
  * item dropped.
  */
@@ -17402,7 +17337,6 @@ export class SetItemDamageFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the data value of the item
  * dropped.
  */
@@ -17419,7 +17353,6 @@ export class SetItemDataFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the lore of the item
  * dropped.
  */
@@ -17435,7 +17368,6 @@ export class SetItemLoreFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the name of the item
  * dropped.
  */
@@ -17451,7 +17383,6 @@ export class SetItemNameFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies an ominous bottle's
  * amplifier value.
  */
@@ -17469,7 +17400,6 @@ export class SetOminousBottleFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that assigns a type to a dropped potion.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -17484,7 +17414,6 @@ export class SetPotionFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that assigns an entity type to a dropped
  * spawn egg. Does not work on any items other than spawn eggs.
  */
@@ -17500,7 +17429,6 @@ export class SetSpawnEggFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that modifies the effects of a dropped
  * stew item.
  */
@@ -17561,7 +17489,6 @@ export class ShutdownEvent {
 }
 
 /**
- * @rc
  * Loot item function that processes the dropped item as if it
  * was smelted or cooked in a furnace.
  */
@@ -17571,7 +17498,6 @@ export class SmeltItemFunction extends LootItemFunction {
 }
 
 /**
- * @rc
  * Loot item function that applies one or several predefined
  * enchants to the dropped item.
  */
@@ -19606,7 +19532,6 @@ export class WorldLoadAfterEventSignal {
 }
 
 /**
- * @rc
  * Axis-aligned bounding box.
  */
 export interface AABB {
@@ -19672,7 +19597,6 @@ export interface BlockCustomComponent {
      */
     beforeOnPlayerPlace?: (arg0: BlockComponentPlayerPlaceBeforeEvent, arg1: CustomComponentParameters) => void;
     /**
-     * @rc
      * @remarks
      * This function will be called when a specific block is
      * destroyed.
@@ -20900,7 +20824,6 @@ export interface ExplosionOptions {
 }
 
 /**
- * @rc
  * Contains additional options for getBlockStandingOn and
  * getAllBlocksStandingOn.
  */
@@ -21114,7 +21037,6 @@ export interface JigsawPlaceOptions {
      */
     keepJigsaws?: boolean;
     /**
-     * @rc
      * @remarks
      * Specifies how to handle waterloggable blocks overlapping
      * with existing liquid. Defaults to `ApplyWaterlogging`.
@@ -21151,7 +21073,6 @@ export interface JigsawStructurePlaceOptions {
      */
     keepJigsaws?: boolean;
     /**
-     * @rc
      * @remarks
      * Specifies how to handle waterloggable blocks overlapping
      * with existing liquid. Defaults to `ApplyWaterlogging`.
@@ -22006,7 +21927,6 @@ export class EntitySpawnError extends Error {
 }
 
 /**
- * @rc
  * The error can occur when a block is invalid. This can also
  * occur when accessing components on a block that doesn't have
  * them.
@@ -22081,17 +22001,11 @@ export class InvalidIteratorError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class InvalidPotionDeliveryTypeError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class InvalidPotionEffectTypeError extends Error {
     private constructor();

package/package.json

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