diff --git a/.gitignore b/.gitignore
index 1a768f054..d00d9cd16 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,9 +1,8 @@
# Dependencies
-/node_modules
+node_modules/
# Production
/build
-/src/pages/api
/innercore*-docs.pdf
# Generated files
diff --git a/.vscode/settings.json b/.vscode/settings.json
index ed25a758b..b04e26dc1 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,12 +1,16 @@
{
- "editor.defaultFormatter": "esbenp.prettier-vscode",
"markdown.preferredMdPathExtensionStyle": "removeExtension",
"markdown.validate.enabled": true,
- "mdx.experimentalLanguageServer": true,
+ "markdown.validate.ignoredLinks": [
+ "/images/**/*"
+ ],
"search.exclude": {
"**/node_modules": true,
"**/package-lock.json": true,
"**/.wireit": true,
"**/build": true
+ },
+ "[markdown]": {
+ "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
}
}
diff --git a/README.md b/README.md
index 089110419..c67085096 100644
--- a/README.md
+++ b/README.md
@@ -32,14 +32,6 @@ I mean modding documentation for Inner Core of course, rewrited from zero to Typ
Everything divided by categories, which also represents sidebar structure. Every markdown location described in **sidebars.js**, you can use it for auto-generation or manually provide required routes.
-## API Reference
-
-New era of Core Engine documentation, generated into single webpage like everything here. See [Nernar/API](https://github.com/Nernar/API) repository for details.
-
-## Modding Examples
-
-Here represented most of legendary Core Engine mods with unique mechanics, that you can freely take into your content.
-
## Libraries freely to use
At beginning, it located by few locations: **libraries** where everything starts, **i18n** where localization performs and **static** where additional files is located.
diff --git a/api/.gitignore b/api/.gitignore
new file mode 100644
index 000000000..18088f8a0
--- /dev/null
+++ b/api/.gitignore
@@ -0,0 +1,6 @@
+# Production
+docs/
+
+# Generated files
+/declarations/core-engine.d.ts
+/.wireit
diff --git a/api/LICENSE b/api/LICENSE
new file mode 100644
index 000000000..672f9658b
--- /dev/null
+++ b/api/LICENSE
@@ -0,0 +1,924 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. .
+
+---
+
+ This is the official Core Engine documentation repository
+ Copyright (C) 2020 #mineprogramming (https://github.com/mineprogramming)
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see ;
+
+ /**
+ * Executes command with the entity on the specified coordinates.
+ * @param command command to be executed
+ * @returns Error message or null if the command was run successfully.
+ */
+ execAt(command: string, x: number, y: number, z: number): Nullable;
+ }
+}
diff --git a/api/core-engine/Animation.d.ts b/api/core-engine/Animation.d.ts
new file mode 100644
index 000000000..b4dd3e253
--- /dev/null
+++ b/api/core-engine/Animation.d.ts
@@ -0,0 +1,258 @@
+/**
+ * Animations are used to display some 3d models in the world without use of
+ * entities.
+ * @remarks
+ * Rendering performs locally in client-side, use packets to transfer
+ * data between server and players.
+ */
+declare namespace Animation {
+ /**
+ * Base animations are used to display arbitrary model in the world.
+ */
+ class Base {
+ /**
+ * Constructs a new Base animation on the specified coordinates.
+ */
+ constructor(x: number, y: number, z: number);
+
+ /**
+ * Changes the animation's position.
+ */
+ setPos(x: number, y: number, z: number): void;
+
+ /**
+ * @param enabled if true, animation position will be interpolated
+ * between tick calls
+ */
+ setInterpolationEnabled(enabled: boolean): void;
+
+ /**
+ * @deprecated Use {@link Animation.Base.setBlockLightPos setBlockLightPos} and related methods instead.
+ */
+ setIgnoreBlocklight(ignore: boolean): void;
+
+ /**
+ * Sets specified coordinates as light measuring position for the
+ * animation. In other words, animation lightning will be calculated
+ * as if animation was at the specified coordinates.
+ */
+ setBlockLightPos(x: number, y: number, z: number): void;
+
+ /**
+ * Resets light measuring position for the animation (to it's coordinates).
+ */
+ resetBlockLightPos(): void;
+
+ /**
+ * Sets light measuring position to always match day/night lightning,
+ * even when the animation is not directly illuminated.
+ */
+ setSkylightMode(): void;
+
+ /**
+ * Sets light measuring to match the animation coordinated.
+ */
+ setBlocklightMode(): void;
+
+ /**
+ * Makes the animation ignore light at all.
+ */
+ setIgnoreLightMode(): void;
+
+ /**
+ * @returns Object for current animation's render.
+ */
+ transform(): Render.Transform;
+
+ /**
+ * @returns Object for current animation's render.
+ * @since 2.0.2b20
+ */
+ getShaderUniforms(): ShaderUniformSet;
+
+ /**
+ * Creates a set of transformations for the current animation.
+ * @param transformations
+ * @param noClear
+ */
+ newTransform(transformations: {
+ /**
+ * Transformation function name, one of {@link Render.Transform} class member
+ * functions names.
+ */
+ name: string,
+ /**
+ * Transformation function parameters, see {@link Render.Transform} functions
+ * for details.
+ */
+ params: any[]
+ }[], noClear: boolean): void;
+
+ /**
+ * Creates render if it was not previously created and applies all the
+ * parameters from animation description.
+ */
+ createRenderIfNeeded(): void;
+
+ /**
+ * Refreshes the animation.
+ */
+ updateRender(): void;
+
+ /**
+ * Loads animation in the world.
+ */
+ load(): void;
+
+ /**
+ * Loads animation in the world registering it as an {@link Updatable}.
+ * @param func function to be used as {@link Updatable.update} function
+ * @since 2.3.1b116 (client-side)
+ */
+ loadCustom(func: () => void): void;
+
+ /**
+ * @deprecated Backwards compatibility, render doesn't have attributes.
+ */
+ getAge(): void;
+
+ /**
+ * Refreshes the animation.
+ */
+ refresh(): void;
+
+ /**
+ * Describes animation parameters for the future use. Call {@link Animation.Base.load load} or
+ * {@link Animation.Base.loadCustom loadCustom} to actually launch the animation.
+ * @param description an object containing all the required data about
+ * animation
+ */
+ describe(description: {
+ /**
+ * {@link RenderMesh} object to be displayed with animation.
+ * @since 2.0.2b20
+ */
+ mesh?: RenderMesh,
+ /**
+ * Numeric ID of the {@link Render} object to be displayed with animation.
+ * Can be obtained using {@link Render.getId}
+ */
+ render?: number,
+ /**
+ * Name of the texture to be used as render's skin.
+ */
+ skin?: string,
+ /**
+ * Animation scale.
+ * @default 1
+ */
+ scale?: number,
+ /**
+ * Animation material, can be used to apply custom materials to the
+ * animation.
+ * @since 2.0.2b20
+ */
+ material?: string
+ }): void;
+
+ /**
+ * Destroys animation and releases all the resources.
+ */
+ destroy(): void;
+
+ /**
+ * @since 2.1.0b60
+ */
+ exists(): boolean;
+ }
+
+ /**
+ * Item animations are used to display items or blocks models in the world.
+ */
+ class Item extends Base {
+ /**
+ * Constructs a new Item animation on the specified coordinates.
+ */
+ constructor(x: number, y: number, z: number);
+
+ /**
+ * Describes item to be used for the animation.
+ * @param item item parameters object
+ */
+ describeItem(item: {
+ /**
+ * Item ID.
+ */
+ id: number,
+ /**
+ * Item count, will be transform to display an appropriate animation.
+ */
+ count?: number,
+ /**
+ * Item data.
+ */
+ data?: number,
+ /**
+ * Item extra.
+ */
+ extra?: ItemExtraData,
+ /**
+ * Whether the item should be in glint state or not.
+ */
+ glint?: boolean,
+ /**
+ * Item/block size.
+ * @default 0.5
+ */
+ size?: number,
+ /**
+ * If `true`, the position of the item will not be randomized.
+ */
+ notRandomize?: boolean,
+ /**
+ * If string "x" is passed, the item is rotated 90 along x axis, if
+ * "z" is passed, the item is rotated 90 along z axis, otherwise the
+ * item is rotated according to the rotation array along all the three
+ * axes.
+ */
+ rotation?: string | [number, number, number],
+ /**
+ * Skin name to be used for the render. If no skin is passed, default
+ * item skin is used.
+ */
+ skin?: string,
+ /**
+ * Shader material name.
+ * @since 2.0.2b20
+ */
+ material?: string
+ }): void;
+
+ /**
+ * @deprecated Consider using {@link Animation.Item.describeItem describeItem} instead.
+ */
+ describeItemDefault(item: any): void;
+
+ /**
+ * Resets all the transformations made via {@link Animation.Base.transform transform} calls.
+ */
+ resetTransform(): void;
+
+ /**
+ * Specifies item rotation along the three axes.
+ * @default x: 0, y: 0, z: 0
+ */
+ setItemRotation(x: number, y: number, z: number): void;
+
+ /**
+ * Specifies item size.
+ * @default 0.5
+ */
+ setItemSize(size: number): void;
+
+ /**
+ * Specifies item size and rotation via single function call.
+ */
+ setItemSizeAndRotation(size: number, x: number, y: number, z: number): void;
+ }
+}
diff --git a/api/core-engine/Armor.d.ts b/api/core-engine/Armor.d.ts
new file mode 100644
index 000000000..cb5542792
--- /dev/null
+++ b/api/core-engine/Armor.d.ts
@@ -0,0 +1,129 @@
+/**
+ * Module used to manage armor's behavior.
+ */
+declare namespace Armor {
+
+ interface IArmorHurtParams {
+ /**
+ * Attacker entity or -1 if the damage was not
+ * caused by an entity.
+ */
+ attacker: number;
+ /**
+ * Damage amount that was applied to the player.
+ */
+ damage: number;
+ /**
+ * Damage type.
+ */
+ type: number;
+ /**
+ * TODO: Unknown param!
+ */
+ bool1: boolean;
+ /**
+ * TODO: Unknown param!
+ */
+ bool2: boolean;
+ }
+
+ interface IArmorJSCallback {
+ /**
+ * Called every tick if player wears the armor.
+ * @param slot current armor item instance
+ * @param index armor slot, one of the {@link EArmorType} values
+ * @param durability maximum damage the armor
+ * @returns `true`, if changes to the item parameter should be applied,
+ * `false` otherwise.
+ */
+ tick(slot: ItemInstance, index: number, durability: number): boolean;
+
+ /**
+ * Called when player deals damage if player wears the armor.
+ * @param params additional data about damage
+ * @param slot current armor item instance
+ * @param index armor slot, one of the {@link EArmorType} values
+ * @param durability maximum damage the armor
+ * @returns `true`, if changes to the item parameter should be applied,
+ * `false` otherwise.
+ */
+ hurt(params: IArmorHurtParams, slot: ItemInstance, index: number, durability: number): boolean;
+ }
+
+ /**
+ * Registers armor's hurt and tick functions.
+ * @param id armor item string or numeric ID
+ * @param funcs
+ * @deprecated Use multiplayer {@link Armor.registerOnHurtListener} and
+ * anothers or callbacks.
+ */
+ function registerFuncs(id: number | string, funcs: Armor.IArmorJSCallback): void;
+
+ /**
+ * Prevents armor from being damaged.
+ * @param id armor item string or numeric ID
+ */
+ function preventDamaging(id: number | string): void;
+
+ interface ArmorGeneralFunction {
+ (item: ItemInstance, slot: number, player: number): void
+ }
+
+ /**
+ * This event is called every tick for every player that has this armor put on.
+ * @returns Item object to change armor item, if nothing is returned,
+ * armor will not be changed.
+ */
+ function registerOnTickListener(id: number, func: ArmorGeneralFunction): void;
+
+ /**
+ * This event is called every tick for local player that has this armor put on.
+ * @returns Item object to change armor item, if nothing is returned,
+ * armor will not be changed.
+ * @since 2.2.1b106
+ */
+ function registerOnLocalTickListener(id: number, func: ArmorGeneralFunction): void;
+
+ interface ArmorHurtFunction {
+ (item: ItemInstance, slot: number, player: number, value: number, type: number, attacker: number, bool1: boolean, bool2: boolean): void
+ }
+
+ /**
+ * This event is called when the damage is dealt to the player that has this armor put on.
+ * @returns Item object to change armor item, if nothing is returned,
+ * armor will not be changed.
+ */
+ function registerOnHurtListener(id: number, func: ArmorHurtFunction): void;
+
+ /**
+ * This event is called when player takes on this armor, or spawns with it.
+ */
+ function registerOnTakeOnListener(id: number, func: ArmorGeneralFunction): void;
+
+ /**
+ * This event is called when local player takes on this armor, or spawns with it.
+ * @since 2.2.1b106
+ */
+ function registerLocalOnTakeOnListener(id: number, func: ArmorGeneralFunction): void;
+
+ /**
+ * This event is called when player takes off or changes this armor item.
+ */
+ function registerOnTakeOffListener(id: number, func: ArmorGeneralFunction): void;
+
+ /**
+ * This event is called when local player takes off or changes this armor item.
+ * @since 2.2.1b106
+ */
+ function registerLocalOnTakeOffListener(id: number, func: ArmorGeneralFunction): void;
+
+ interface IArmorCallback {
+ tick(slot: ItemInstance, index: number, armorInfo: Armor.IArmorInfo): boolean;
+ hurt(params: IArmorHurtParams, slot: ItemInstance, index: number, armorInfo: Armor.IArmorInfo): boolean;
+ }
+
+ interface IArmorInfo {
+ callback: IArmorCallback;
+ durability: number;
+ }
+}
diff --git a/api/core-engine/AttachableRender.d.ts b/api/core-engine/AttachableRender.d.ts
new file mode 100644
index 000000000..2b2d296ef
--- /dev/null
+++ b/api/core-engine/AttachableRender.d.ts
@@ -0,0 +1,33 @@
+/**
+ * Class used to attach attachables to entities.
+ * @since 2.2.0b75
+ */
+declare class AttachableRender {
+
+ static attachRendererToItem(id: number, renderer: AttachableRender, texture?: string, material?: string): void;
+
+ static detachRendererFromItem(id: number): void;
+
+ /**
+ * Constructs new {@link AttachableRender} object bind to given entity.
+ */
+ constructor(actorUid: number);
+
+ getUniformSet(): ShaderUniformSet;
+
+ /**
+ * Sets the render, root render parts will be drawing
+ * together with mob's render parts with same names
+ * (names can be seen in json description of the model in resources).
+ */
+ setRenderer(actorRenderer: ActorRenderer): AttachableRender;
+
+ setTexture(textureName: string): AttachableRender;
+
+ setMaterial(materialName: string): AttachableRender;
+
+ destroy(): void;
+
+ isAttached(): boolean;
+
+}
\ No newline at end of file
diff --git a/api/core-engine/Block.d.ts b/api/core-engine/Block.d.ts
new file mode 100644
index 000000000..a7aba1501
--- /dev/null
+++ b/api/core-engine/Block.d.ts
@@ -0,0 +1,853 @@
+/**
+ * Module used to create and manipulate blocks. The difference between terms
+ * "block" and "tile" is in it's usage: blocks are used in the inventory,
+ * tiles are placed in the world and have different IDs for some vanilla blocks.
+ * Use {@link Block.convertBlockToItemId} and {@link Block.convertItemToBlockId}
+ * to perform conversion between block and it item variation.
+ */
+declare namespace Block {
+ /**
+ * @param id string ID of the block
+ * @returns Block numeric ID by it's string ID or just returns it's numeric ID
+ * if input was a numeric ID.
+ */
+ function getNumericId(id: string | number): number;
+
+ /**
+ * Creates new block using specified params.
+ * @param nameID string ID of the block. You should register it via
+ * {@link IDRegistry.genBlockID} call first
+ * @param defineData array containing all variations of the block. Each
+ * variation corresponds to block data value, data values are assigned
+ * according to variations order
+ * @param blockType {@link Block.SpecialType} object, either java-object returned by
+ * {@link Block.createSpecialType} or js-object with the required properties,
+ * you can also pass special type name, if the type was previously
+ * registered
+ */
+ function createBlock(nameID: string, defineData: BlockVariation[], blockType?: SpecialType | string): void;
+
+ /**
+ * Creates new block using specified params, creating four variations for
+ * each of the specified variations to be able to place it facing flayer
+ * with the front side and defines the appropriate behavior. Useful for
+ * different machines and mechanisms.
+ * @param nameID string ID of the block. You should register it via
+ * {@link IDRegistry.genBlockID} call first
+ * @param defineData array containing all variations of the block. Each
+ * variation corresponds to four block data values, data values are assigned
+ * according to variations order
+ * @param blockType {@link Block.SpecialType SpecialType} object, either java-object returned by
+ * {@link Block.createSpecialType} or js-object with the required properties,
+ * you can also pass special type name, if the type was previously
+ * registered
+ */
+ function createBlockWithRotation(nameID: string, defineData: BlockVariation[], blockType?: SpecialType | string): void;
+
+ /**
+ * Object used to represent single block variation.
+ */
+ interface BlockVariation {
+ /**
+ * Variation name, displayed as item name everywhere.
+ * @default "Unknown Block"
+ */
+ name?: string,
+ /**
+ * Variation textures, array containing pairs of texture name and data.
+ * Texture file should be located in items-opaque folder and it's name
+ * should be in the format: `"name_data"`, e.g. if the file name is
+ * `"ingot_copper_0"`, you should specify an array `["ingot_copper", 0]`.
+ * @remarks
+ * There should be from one to six texture pairs in the array,
+ * if less then six variations are specified, the last texture is used
+ * for missing textures. The sides go in the following order:
+ * ```js
+ * texture: [
+ * ["name1", index1], // bottom (Y: -1)
+ * ["name2", index2], // top (Y: +1)
+ * ["name3", index3], // back (X: -1)
+ * ["name4", index4], // front (X: +1)
+ * ["name5", index5], // left (Z: -1)
+ * ["name6", index6] // right (Z: +1)
+ * ]
+ * ```
+ */
+ texture: [string, number][],
+ /**
+ * If `true`, block variation will be added to creative inventory.
+ * @default false
+ */
+ inCreative?: boolean
+ }
+
+ /**
+ * Creates new liquid block using specified params.
+ * @param nameID string ID of the block. You should register it via
+ * {@link IDRegistry.genBlockID} call first
+ * @param defineData object containing all needed params to describe your custom liquid block.
+ * There you can specify custom name IDs for static and dynamic liquid blocks separately,
+ * and if you do this, you have to register those name IDs
+ * via {@link IDRegistry.genBlockID} before using them
+ * @param blockType {@link Block.SpecialType SpecialType} object, either java-object returned by
+ * {@link Block.createSpecialType} or js-object with the required properties,
+ * you can also pass special type name, if the type was previously registered
+ * @since 2.2.1b102
+ */
+ function createLiquidBlock(nameID: string, defineData: LiquidDescriptor, blockType?: SpecialType | string): void;
+
+ /**
+ * Object to specify needed params for custom liquid block.
+ * @since 2.2.1b102
+ */
+ interface LiquidDescriptor {
+ /**
+ * Name of the block to be displayed.
+ */
+ name: string,
+ /**
+ * Delay between liquid spreading steps in ticks.
+ * @default 10
+ */
+ tickDelay?: number,
+ /**
+ * True if the liquid will be renewable, as water.
+ * @default false
+ * @since 2.2.1b103
+ */
+ isRenewable?: boolean,
+ /**
+ * Object to describe static liquid block
+ * texture, and name ID additionally.
+ */
+ still: {
+ /**
+ * Optional, name ID for static liquid block.
+ * @default "nameId_still"
+ */
+ id?: string,
+ /**
+ * For static liquid block,
+ * textures must be of standard block texture format.
+ */
+ texture: [string, number]
+ },
+ /**
+ * Object to describe dynamic liquid block
+ * texture, and name ID additionally.
+ */
+ flowing: {
+ /**
+ * Optional, name ID for dynamic liquid block.
+ * @default "nameId"
+ */
+ id?: string,
+ /**
+ * Unlike static liquid blocks,
+ * for dynamic ones, texture must look like
+ * `"texture.liquid.png"` (with no index).
+ */
+ texture: [string, number]
+ },
+ /**
+ * Optional section, if added, this will create fully
+ * functional (including dispensers) bucket items.
+ * @since 2.2.1b103
+ */
+ bucket?: {
+ /**
+ * Optional, name ID for bucket item.
+ * @default "nameId_bucket"
+ */
+ id?: string,
+ /**
+ * Name of the filled with liquid bucket to be displayed.
+ */
+ name?: string,
+ texture: { name: string, meta?: number },
+ /**
+ * An item that can capture liquid (including when using
+ * a dispenser and obtaining it with your hand).
+ * @default 325
+ * @since 2.3.1b116
+ */
+ emptyId?: number,
+ /**
+ * @default "bucket.fill_water"
+ */
+ fillSound?: string,
+ /**
+ * @default "bucket.empty_water"
+ */
+ emptySound?: string,
+ /**
+ * If `true`, bucket cannot be obtained from creative inventory.
+ */
+ isTech?: boolean
+ },
+ /**
+ * Whether to add liquid block to creative inventory.
+ * @default false
+ */
+ inCreative?: boolean,
+ uiTextures?: string,
+ modelTextures?: string
+ }
+
+ /**
+ * @param id numeric block ID
+ * @returns `true`, if the specified block ID is a vanilla block.
+ */
+ function isNativeTile(id: number): boolean;
+
+ /**
+ * Converts tile ID to the block ID.
+ * @param id numeric tile ID
+ * @returns Numeric block ID corresponding to the given tile ID.
+ */
+ function convertBlockToItemId(id: number): number;
+
+ /**
+ * Converts block ID to the tile ID.
+ * @param id numeric tile ID
+ * @returns Numeric tile ID corresponding to the given block ID.
+ */
+ function convertItemToBlockId(id: number): number;
+
+ /**
+ * Defines custom behavior when the player clicks on the block with definite ID.
+ * @param numericId block's numeric ID
+ * @param func function that will be called when the player clicks the block with given ID
+ * @since 2.2.1b103 (TODO: changelog says it 104)
+ */
+ function registerClickFunctionForID(numericId: number, func: ClickFunction): void;
+
+ /**
+ * Defines custom behavior when the player clicks on the block with definite ID.
+ * @param id block's numeric or string ID
+ * @param func function that will be called when the player clicks the block with given ID
+ * @since 2.2.1b103 (TODO: changelog says it 104)
+ */
+ function registerClickFunction(id: string | number, func: ClickFunction): void;
+
+ /**
+ * Function used to define how the block will behave when the player clicks on it.
+ * @param coords set of all coordinate values that can be useful to write
+ * custom logics on click
+ * @param item item that was in the player's hand when he touched the block
+ * @param block block that was touched
+ * @param player unique ID of the player entity
+ */
+ interface ClickFunction {
+ (coords: Callback.ItemUseCoordinates, item: ItemInstance, block: Tile, player: number): void;
+ }
+
+ /**
+ * Registers function used by Core Engine to determine block drop for the
+ * specified block ID.
+ * @param numericId tile numeric ID
+ * @param dropFunc function to be called to determine what will be dropped
+ * when the block is broken
+ * @param level if level is specified and is not 0, digging level of the
+ * block is additionally set
+ * @returns `true`, if specified string or numeric ID exists and the function
+ * was registered correctly, `false` otherwise.
+ */
+ function registerDropFunctionForID(numericId: number, dropFunc: DropFunction, level?: number): boolean;
+
+ /**
+ * Registers function used by Core Engine to determine block drop for the
+ * specified block ID.
+ * @param id tile string or numeric ID
+ * @param dropFunc function to be called to determine what will be dropped
+ * when the block is broken
+ * @param level if level is specified and is not 0, digging level of the
+ * block is additionally set
+ * @returns `true`, if specified string or numeric ID exists and the function
+ * was registered correctly, `false` otherwise.
+ */
+ function registerDropFunction(id: string | number, dropFunc: DropFunction, level?: number): boolean;
+
+ /**
+ * Function used to determine block drop.
+ * @param blockCoords coordinates where the block is destroyed and side from
+ * where it is destroyed
+ * @param blockID numeric tile ID
+ * @param blockData block data value
+ * @param diggingLevel level of the tool the block was dug with
+ * @param enchant enchant data of the tool held in player's hand
+ * @param item item stack held in player's hand
+ * @param region BlockSource object
+ * @returns Block drop, the array of arrays, each containing three or four values:
+ * ID, count, data and extra respectively.
+ */
+ interface DropFunction {
+ (blockCoords: Callback.ItemUseCoordinates, blockID: number, blockData: number, diggingLevel: number, enchant: ToolAPI.EnchantData, item: ItemInstance, region: BlockSource): ItemInstanceArray[]
+ }
+
+ /**
+ * Registered function used by Core Engine to determine block drop for the
+ * specified block ID.
+ * @param numericId tile numeric ID
+ * @param func function to be called when a block in the world is broken by
+ * environment (explosions, pistons, etc.)
+ * @returns `true`, if specified string or numeric ID exists and the function
+ * was registered correctly, `false` otherwise.
+ */
+ function registerPopResourcesFunctionForID(numericId: number, func: PopResourcesFunction): boolean;
+
+ /**
+ * Registered function used by Core Engine to determine block drop for the
+ * specified block ID.
+ * @param id tile string or numeric ID
+ * @param func function to be called when a block in the world is broken by
+ * environment (explosions, pistons, etc.)
+ * @returns `true`, if specified string or numeric ID exists and the function
+ * was registered correctly, `false` otherwise.
+ */
+ function registerPopResourcesFunction(id: string | number, func: PopResourcesFunction): boolean;
+
+ /**
+ * Function used to determine when block is broken by
+ * environment (explosions, pistons, etc.).
+ * @param blockCoords coordinates where the block is destroyed and side from
+ * where it is destroyed
+ * @param block information about block that is broken
+ * @param region BlockSource object
+ * @param i unknown parameter, supposed to always be zero
+ */
+ interface PopResourcesFunction {
+ (blockCoords: Vector, block: Tile, region: BlockSource, explosionRadius: number, i: number): void
+ }
+
+ /**
+ * Registers function on entity being inside the block. Can be used to create portals.
+ * @param numericId tile string or numeric ID
+ * @param func function to be called when entity is inside the block
+ * @returns `true`, if the function was registered correctly, `false` otherwise.
+ * @since 2.0.2b26
+ */
+ function registerEntityInsideFunctionForID(numericId: number, func: EntityInsideFunction): boolean;
+
+ /**
+ * Registers function on entity being inside the block. Can be used to create portals.
+ * @param id tile string or numeric ID
+ * @param func function to be called when entity is inside the block
+ * @returns `true`, if the function was registered correctly, `false` otherwise.
+ * @since 2.0.2b26
+ */
+ function registerEntityInsideFunction(id: string | number, func: EntityInsideFunction): boolean;
+
+ interface EntityInsideFunction {
+ (blockCoords: Vector, block: Tile, entity: number): void
+ }
+
+ /**
+ * Registers function on entity step on the block.
+ * @param numericId tile numeric ID
+ * @param func function to be called when entity step on the block
+ * @returns `true`, if the function was registered correctly, `false` otherwise.
+ * @since 2.3.1b116 (implemented in 2.0.2b26)
+ */
+ function registerEntityStepOnFunctionForID(numericId: number, func: EntityStepOnFunction): boolean;
+
+ /**
+ * Registers function on entity step on the block.
+ * @param id tile string or numeric ID
+ * @param func function to be called when entity step on the block
+ * @returns `true`, if the function was registered correctly, `false` otherwise.
+ * @since 2.3.1b116 (implemented in 2.0.2b26)
+ */
+ function registerEntityStepOnFunction(id: string | number, func: EntityStepOnFunction): boolean;
+
+ interface EntityStepOnFunction {
+ (coords: Vector, block: Tile, entity: number): void
+ }
+
+ /**
+ * Registers function on neighbour blocks updates.
+ * @param numericId tile numeric ID
+ * @param func function to be called when neighbour block updates
+ * @returns `true`, if the function was registered correctly, `false` otherwise.
+ * @since 2.0.2b26
+ */
+ function registerNeighbourChangeFunctionForID(numericId: number, func: NeighbourChangeFunction): boolean;
+
+ /**
+ * Registers function on neighbour blocks updates.
+ * @param id tile string or numeric ID
+ * @param func function to be called when neighbour block updates
+ * @returns `true`, if the function was registered correctly, `false` otherwise.
+ * @since 2.0.2b26
+ */
+ function registerNeighbourChangeFunction(id: string | number, func: NeighbourChangeFunction): boolean;
+
+ /**
+ * Function used to check block's neighbours changes.
+ * @param coords coords vector of the block
+ * @param block Tile object of the block
+ * @param changedCoords coords vector of the neighbour block that was changed
+ * @param region BlockSource object
+ */
+ interface NeighbourChangeFunction {
+ (coords: Vector, block: Tile, changedCoords: Vector, region: BlockSource): void
+ }
+
+ /**
+ * @returns Drop function of the block with given numeric ID.
+ */
+ function getDropFunction(id: number): Block.DropFunction;
+
+ /**
+ * Registers a default destroy function for the specified block, considering
+ * it's digging level.
+ * @param numericId tile numeric ID
+ * @param level digging level of the block
+ * @param resetData if true, the block is dropped with data equals to 0
+ */
+ function setDestroyLevelForID(numericId: number, level: number, resetData?: boolean): void;
+
+ /**
+ * Registers a default destroy function for the specified block, considering
+ * it's digging level.
+ * @param id tile string or numeric ID
+ * @param level digging level of the block
+ * @param resetData if true, the block is dropped with data equals to 0
+ */
+ function setDestroyLevel(id: string | number, level: number, resetData?: boolean): void;
+
+ /**
+ * Sets destroy time for the block with specified ID.
+ * @param nameID string or numeric block ID
+ * @param time destroy time for the block, in ticks
+ */
+ function setDestroyTime(nameID: string | number, time: number): void;
+
+ /**
+ * @returns Given block's material numeric ID.
+ * @since 2.2.1b101 (TODO: fix in changelog)
+ */
+ function getMaterial(id: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns `true`, if block is solid, `false` otherwise.
+ */
+ function isSolid(numericId: number): boolean;
+
+ /**
+ * @returns Whether the block of given ID can contain liquid inside.
+ * @since 2.2.1b95
+ */
+ function canContainLiquid(id: number): boolean;
+
+ /**
+ * @returns Whether the block of given ID can be an extra block
+ * (it's the block that can be set inside of another blocks, for ex. water and other liquids).
+ * @since 2.2.1b95
+ */
+ function canBeExtraBlock(id: number): boolean;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Destroy time of the block, in ticks.
+ */
+ function getDestroyTime(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Explosion resistance of the block.
+ */
+ function getExplosionResistance(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Friction of the block.
+ */
+ function getFriction(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Translucency of the block.
+ */
+ function getTranslucency(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Light level, emitted by block, from 0 to 15.
+ */
+ function getLightLevel(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Light opacity of the block, from 0 to 15.
+ */
+ function getLightOpacity(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Render layer of the block.
+ */
+ function getRenderLayer(numericId: number): number;
+
+ /**
+ * @param numericId numeric block ID
+ * @returns Render type of the block.
+ */
+ function getRenderType(numericId: number): number;
+
+ function getBlockAtlasTextureCoords(str: string, int: number): BlockAtlasTextureCoords;
+
+ interface BlockAtlasTextureCoords {
+ u1: number, v1: number, u2: number, v2: number;
+ }
+
+ /**
+ * Temporarily sets destroy time for block, saving the old value for the
+ * further usage.
+ * @param numericId numeric block ID
+ * @param time new destroy time in ticks
+ */
+ function setTempDestroyTime(numericId: number, time: number): void;
+
+ /**
+ * Registers material and digging level for the specified block.
+ * @param nameID block numeric or string ID
+ * @param material material name
+ * @param level block's digging level
+ * @returns `true` if specified string or numeric ID exists, `false` otherwise.
+ */
+ function setBlockMaterial(nameID: string | number, material: string, level: number): boolean;
+
+ /**
+ * @param id numeric block ID
+ * @returns Color specified block is displayed on the vanilla maps.
+ */
+ function getMapColor(id: number): number;
+
+ /**
+ * Makes block accept redstone signal.
+ * @param nameID block numeric or string ID
+ * @param data block data, currently not used
+ * @param isRedstone if true, the redstone changes at the block will notify
+ * the "RedstoneSignal" callback
+ * @deprecated Use {@link Block.setupAsRedstoneReceiver} and
+ * {@link Block.setupAsRedstoneEmitter} instead.
+ */
+ function setRedstoneTile(nameID: string | number, data: number, isRedstone: boolean): void;
+
+ /**
+ * Makes block receive redstone signals via "RedstoneSignal" callback.
+ * @param nameID block numeric or string ID
+ * @param connectToRedstone if true, redstone wires will connect to the block
+ * @since 2.0.2b23
+ */
+ function setupAsRedstoneReceiver(nameID: number | string, connectToRedstone: boolean): void;
+
+ /**
+ * Makes block emit redstone signal.
+ * @param nameID block numeric or string ID
+ * @param connectToRedstone if true, redstone wires will connect to the block
+ * @since 2.0.2b23
+ */
+ function setupAsRedstoneEmitter(nameID: number | string, connectToRedstone: boolean): void;
+
+ /**
+ * Removes all the redstone functionality from the block.
+ * @param nameID block numeric or string ID
+ * @since 2.0.2b23
+ */
+ function setupAsNonRedstoneTile(nameID: number | string): void;
+
+ /**
+ * Gets drop for the specified block. Used mostly by Core Engine's
+ * {@link ToolAPI}, though, can be useful in the mods, too.
+ * @param block block info
+ * @param item item that was (or is going to be) used to break the block
+ * @param coords coordinates where the block was (or is going to be) broken
+ * @returns Block drop, the array of arrays, each containing three values:
+ * ID, count and data respectively.
+ */
+ function getBlockDropViaItem(block: Tile, item: ItemInstance, coords: Vector, region: BlockSource): ItemInstanceArray[];
+
+ /**
+ * Registers function to be called when the block is placed in the world.
+ * @param numericId block numeric ID
+ * @param func function to be called when the block is placed in the world
+ */
+ function registerPlaceFunctionForID(numericId: number, func: PlaceFunction): void;
+
+ /**
+ * Registers function to be called when the block is placed in the world.
+ * @param id block numeric or string ID
+ * @param func function to be called when the block is placed in the world
+ */
+ function registerPlaceFunction(id: string | number, func: PlaceFunction): void;
+
+ /**
+ * @returns Place function of the block with given numeric ID,
+ * or undefined if it was not specified.
+ */
+ function getPlaceFunc(id: number): Block.PlaceFunction;
+
+ /**
+ * Function used to determine when block is placed in the world.
+ * @param coords set of all coordinate values that can be useful to write
+ * custom use logics
+ * @param item item that was in the player's hand when he touched the block
+ * @param block block that was touched
+ * @param player Player unique ID
+ * @param region BlockSource object
+ * @returns Coordinates where to actually place the block, or void for
+ * default placement.
+ */
+ interface PlaceFunction {
+ (coords: Callback.ItemUseCoordinates, item: ItemInstance, block: Tile, player: number, region: BlockSource): Vector | void
+ }
+
+ /**
+ * Sets block box shape, like {@link Block.setShape},
+ * but in voxel objects for each coordinate.
+ * @param id block numeric ID
+ * @param pos1 block lower corner position
+ * @param pos2 block upper conner position
+ * @param data block optional data (or -1)
+ */
+ function setBlockShape(id: number, pos1: Vector, pos2: Vector, data?: number): void;
+
+ /**
+ * Sets block box shape via scalar coordinates,
+ * usually presented in voxels (1/16 of block).
+ * @param id block numeric ID
+ * @param data block optional data (or -1)
+ */
+ function setShape(id: number, x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, data?: number): void;
+
+ /**
+ * Creates a new special type using specified params
+ * and optionally registers it by name.
+ * @param description special type properties
+ * @param name string name to register the special type
+ * @returns Special type name.
+ */
+ function createSpecialType(description: SpecialType, name?: string): string;
+
+ type ColorSource = "grass" | "leaves" | "water";
+
+ type Sound = "normal"
+ | "gravel"
+ | "wood"
+ | "grass"
+ | "metal"
+ | "stone"
+ | "cloth"
+ | "glass"
+ | "sand"
+ | "snow"
+ | "ladder"
+ | "anvil"
+ | "slime"
+ | "silent"
+ | "itemframe"
+ | "turtle_egg"
+ | "bamboo"
+ | "bamboo_sapling"
+ | "lantern"
+ | "scaffolding"
+ | "sweet_berry_bush"
+ | "default";
+
+ /**
+ * Special types are used to set properties to the block. Unlike items,
+ * blocks properties are defined using special types, due to old Inner
+ * Core's block IDs limitations.
+ */
+ interface SpecialType {
+ /**
+ * Unique string identifier of the SpecialType.
+ */
+ name?: string,
+ /**
+ * Vanilla block ID to inherit some of the properties.
+ * @default 0
+ */
+ base?: number,
+ /**
+ * Block material constant to be inherited.
+ * @default 3
+ */
+ material?: number,
+ /**
+ * If `true`, the block is not transparent.
+ * @default false
+ */
+ solid?: boolean,
+ /**
+ * If `true`, all block faces are rendered, otherwise back faces are not
+ * rendered, like for glass.
+ * @default false
+ */
+ renderallfaces?: boolean,
+ /**
+ * Sets render type of the block. Default is full block, use other
+ * values to change block's shape.
+ * @default 0
+ */
+ rendertype?: number,
+ /**
+ * Specifies the layer that is used to render the block.
+ * @default 4
+ */
+ renderlayer?: number,
+ /**
+ * If non-zero value is used, the block emits light of that value.
+ * Default is no lighting, use values from 1 to 15 to set light level.
+ * @default 0
+ */
+ lightlevel?: number,
+ /**
+ * Specifies how opaque the block is. Default is transparent, use values
+ * from 1 to 15 to make the block opaque.
+ * @default 0
+ */
+ lightopacity?: number,
+ /**
+ * Specifies how block resists to the explosions.
+ * @default 3
+ */
+ explosionres?: number,
+ /**
+ * Specifies how player walks on this block. The higher the friction is,
+ * the more difficult it is to change speed and direction.
+ * @default 0.6000000238418579
+ */
+ friction?: number,
+ /**
+ * Specifies the time required to destroy the block, in ticks.
+ */
+ destroytime?: number,
+ /**
+ * If non-zero value is used, the shadows will be rendered on the block.
+ * Default is zero, allows float values from 0 to 1.
+ * @default 0
+ */
+ translucency?: number,
+ /**
+ * Block color when displayed on the vanilla maps.
+ * @since 2.0.2b23
+ */
+ mapcolor?: number,
+ /**
+ * Makes block use biome color source when displayed on the vanilla maps.
+ * @since 2.1.0b56
+ */
+ color_source?: ColorSource,
+ /**
+ * Specifies sounds of the block, one of {@link Block.Sound}.
+ * @since 2.0.2b25
+ */
+ sound?: Sound,
+ /**
+ * Whether or not block may filled by water bucket or
+ * other custom fillable liquids.
+ * @default false
+ * @since 2.2.1b95
+ */
+ can_contain_liquid?: boolean,
+ /**
+ * Whether or not block may overlay different block,
+ * like water overlapping fillable blocks.
+ * @default false
+ * @since 2.2.1b95
+ */
+ can_be_extra_block?: boolean
+ }
+
+ /**
+ * Makes block invoke callback randomly depending on game speed.
+ * @param id block ID to register for random ticks
+ * @param callback function to be called on random block tick
+ */
+ function setRandomTickCallback(id: number, callback: RandomTickFunction): void;
+
+ /**
+ * Function used to track random block ticks.
+ */
+ interface RandomTickFunction {
+ /**
+ * @param id block numeric identifier
+ * @param data block data
+ * @param region block source instance
+ */
+ (x: number, y: number, z: number, id: number, data: number, region: BlockSource): void;
+ }
+
+ /**
+ * Makes block invoke callback randomly depending on game speed. Occurs more
+ * often then {@link Block.setRandomTickCallback} and only if the block is not
+ * far away from player.
+ * @param id block ID to register
+ * @param callback function to be called
+ */
+ function setAnimateTickCallback(id: number, callback: AnimateTickFunction): void;
+
+ /**
+ * Function used to track random block animation ticks.
+ */
+ interface AnimateTickFunction {
+ /**
+ * @param id block numeric identifier
+ * @param data block data
+ */
+ (x: number, y: number, z: number, id: number, data: number): void;
+ }
+
+ /**
+ * Once upon a time, a new way of registering blocks, however,
+ * in current state, either does not work or is undesirable to use.
+ */
+ interface BlockLegacyPrototype extends Scriptable {
+ type: "createBlock" | "createBlockWithRotation",
+ init?: () => void,
+ getVariations: (item: null) => BlockVariation[],
+ getSpecialType?: (item: null) => Nullable,
+ /**
+ * Unused at all.
+ */
+ getCategory?: (item: null) => Nullable,
+ /**
+ * Unused at all.
+ */
+ getEnchant?: (item: null) => Nullable,
+ /**
+ * Unused at all.
+ */
+ getProperties?: (item: null) => Nullable,
+ /**
+ * Unused at all.
+ */
+ isStackedByData?: (item: null) => Nullable,
+ /**
+ * Unused at all.
+ */
+ isEnchanted?: (item: null) => Nullable,
+ getMaterial?: (item: null) => Nullable,
+ getDestroyLevel?: (item: null) => Nullable,
+ getShape?: (item: null) => Nullable,
+ getDrop?: (coords: Vector, id: number, data: number, diggingLevel: number, enchant: any) => ItemInstanceArray[],
+ /**
+ * Incorrect function, it will considered as {@link BlockLegacyPrototype.getDrop}
+ */
+ onPlaced?: (coords: Vector, item: ItemInstance, block: Tile) => void,
+ /**
+ * Unused at all.
+ */
+ onItemUsed?: (coords: Vector, item: ItemInstance, block: Tile) => void
+ }
+
+ /**
+ * @deprecated Better performance should be inherited by manually
+ * manipulation with properties and {@link Block.SpecialType special type}.
+ */
+ function setPrototype(nameID: string, Prototype: BlockLegacyPrototype): void;
+}
diff --git a/api/core-engine/BlockRenderer.d.ts b/api/core-engine/BlockRenderer.d.ts
new file mode 100644
index 000000000..840c0b5b3
--- /dev/null
+++ b/api/core-engine/BlockRenderer.d.ts
@@ -0,0 +1,300 @@
+/**
+ * Module used to create blocks with any custom model.
+ */
+declare namespace BlockRenderer {
+ /**
+ * Class representing model used by {@link BlockRenderer}.
+ */
+ class Model {
+ /**
+ * Creates a new empty model.
+ */
+ constructor();
+
+ /**
+ * Constructs new model using specified {@link RenderMesh}.
+ */
+ constructor(mesh: RenderMesh);
+
+ constructor(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, descr: ModelTextureSet);
+
+ constructor(descr: ModelTextureSet);
+
+ /**
+ * Constructs new block model with single box inside specified block shape.
+ * The width of the full block is 1x1x1 units.
+ * @param texName block texture name to be used with the model
+ * @param texId block texture meta to be used with the model
+ */
+ constructor(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, texName: string, texId: number);
+
+ /**
+ * Constructs new block model with single box of the normal block size.
+ * @param texName block texture name to be used with the model
+ * @param texId block texture meta to be used with the model
+ */
+ constructor(texName: string, texId: number);
+
+ /**
+ * Constructs new block model with single box inside specified block shape.
+ * The width of the full block is 1x1x1 units. Uses block ID and data to
+ * determine texture.
+ * @param id sample block ID
+ * @param data sample block data
+ */
+ constructor(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, id: number, data: number);
+
+ /**
+ * Constructs new block model with single box of the normal block size.
+ * The width of the full block is 1x1x1 units. Uses block ID and data to
+ * determine texture.
+ * @param id
+ * @param data
+ */
+ constructor(id: number, data: number);
+
+ /**
+ * Adds new box to the model using specified block's textures.
+ */
+ addBox(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, id: number, data: number): void;
+
+ /**
+ * Adds new box to the model using specified textures for the six sides
+ * of the box.
+ */
+ addBox(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, descr: ModelTextureSet): void;
+
+ /**
+ * Adds new box to the model using specified block texture name and ID.
+ */
+ addBox(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, texName: string, texId: number): void;
+
+ /**
+ * Adds new block with specified block's textures.
+ */
+ addBox(id: number, data?: number): void;
+
+ /**
+ * Adds new {@link RenderMesh} to the model.
+ */
+ addMesh(mesh: RenderMesh): void;
+ }
+
+ /**
+ * Type used to describe a new model for {@link BlockRenderer}.
+ */
+ type ModelTextureSet =
+ [string, number][];
+
+ /**
+ * Creates a new empty block model.
+ * @returns Empty block model.
+ */
+ function createModel(): BlockRenderer.Model;
+
+ /**
+ * Constructs new block model of specified simple block shape with specified
+ * textures.
+ * @param descr texture set used for the box
+ */
+ function createTexturedBox(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, descr: ModelTextureSet): BlockRenderer.Model;
+
+ /**
+ * Constructs new block model of specified simple block of the normal block
+ * size shape with specified textures.
+ * @param descr texture set used for the box
+ */
+ function createTexturedBlock(descr: ModelTextureSet): BlockRenderer.Model;
+
+ /**
+ * Adds "CustomBlockTessellation" callback function for specified block ID.
+ * @param id block ID
+ * @param callback function to be called when the event occurs
+ */
+ function addRenderCallback(id: number, callback: Callback.CustomBlockTessellationFunction): void;
+
+ /**
+ * Forces block renders to be rebuilt immediately.
+ * @param mode if 0 is passed, only the specified block gets rebuilt, if
+ * 1 is passed, all the blocks along y axes are rebuilt
+ */
+ function forceRenderRebuild(x: number, y: number, z: number, mode: number): void;
+
+ /**
+ * Specifies custom collision shape for the block.
+ * @param id block ID
+ * @param data block data
+ * @param shape {@link ICRender.CollisionShape} object to be used as
+ * default collision shape for the specified block
+ * @since 2.1.0b59
+ */
+ function setCustomCollisionShape(id: number, data: number, shape: ICRender.CollisionShape): void;
+
+ /**
+ * Specifies custom raycast shape for the block.
+ * @param id block ID
+ * @param data block data or -1 to map all the data values
+ * @param shape {@link ICRender.CollisionShape} object to be used as
+ * default raycast shape for the specified block
+ * @since 2.1.0b59
+ */
+ function setCustomRaycastShape(id: number, data: number, shape: ICRender.CollisionShape): void;
+
+ /**
+ * Specifies custom collision and raycast shape for the block.
+ * @param id block ID
+ * @param data block data or -1 to map all the data values
+ * @param shape {@link ICRender.CollisionShape} object to be used as
+ * default collision and raycast shape for the specified block
+ * @since 2.1.0b59
+ */
+ function setCustomCollisionAndRaycastShape(id: number, data: number, shape: ICRender.CollisionShape): void;
+
+ /**
+ * Enables custom rendering for the specified block.
+ * @param id block ID
+ * @param data block data or -1 to map all the data values
+ */
+ function enableCustomRender(id: number, data: number): void;
+
+ /**
+ * Disables custom rendering for the specified block.
+ * @param id block ID
+ * @param data block data or -1 to map all the data values
+ */
+ function disableCustomRender(id: number, data: number): void;
+
+ /**
+ * Sets static ICRender model as block render shape.
+ * @param id block ID
+ * @param data block data or -1 to map all the data values
+ * @param icRender {@link ICRender.Model} object to be used as static block shape
+ */
+ function setStaticICRender(id: number, data: number, icRender: ICRender.Model): void;
+
+ /**
+ * Enables block mapping for the specified block.
+ * @param id block ID
+ * @param data block data or -1 to map all the data values
+ * @param icRender default model for the block
+ */
+ function enableCoordMapping(id: number, data: number, icRender: ICRender.Model): void;
+
+ /**
+ * Changes shape of the block on the specified coordinates.
+ * @param icRender {@link ICRender.Model} object to be displayed at the coordinates
+ * @param preventRebuild if false or not specified, rebuild is performed immediately
+ */
+ function mapAtCoords(x: number, y: number, z: number, icRender: ICRender.Model, preventRebuild?: boolean): void;
+
+ /**
+ * Resets shape of the block to default on the specified coordinates.
+ * @param preventRebuild if false or not specified, rebuild is performed immediately
+ */
+ function unmapAtCoords(x: number, y: number, z: number, preventRebuild?: boolean): void;
+
+ /**
+ * Changes collision shape of the block on given coords in given dimension.
+ * @param shape {@link ICRender.CollisionShape} object to be used as new collision shape
+ * @since 2.1.0b59
+ */
+ function mapCollisionModelAtCoords(dimension: number, x: number, y: number, z: number, shape: ICRender.CollisionShape): void;
+
+ /**
+ * Changes raycast shape of the block on given coords in given dimension.
+ * @param shape {@link ICRender.CollisionShape} object to be used as new raycast shape
+ * @since 2.1.0b59
+ */
+ function mapRaycastModelAtCoords(dimension: number, x: number, y: number, z: number, shape: ICRender.CollisionShape): void;
+
+ /**
+ * Changes both collision and raycast shape of the block on given coords in given dimension.
+ * @param shape {@link ICRender.CollisionShape} object to be used as new collision and raycast shape
+ * @since 2.1.0b59
+ */
+ function mapCollisionAndRaycastModelAtCoords(dimension: number, x: number, y: number, z: number, shape: ICRender.CollisionShape): void;
+
+ /**
+ * Resets collision shape of the block to default on given coords in given dimension.
+ * @since 2.1.0b59
+ */
+ function unmapCollisionModelAtCoords(dimension: number, x: number, y: number, z: number): void;
+
+ /**
+ * Resets raycast shape of the block to default on given coords in given dimension.
+ * @since 2.1.0b59
+ */
+ function unmapRaycastModelAtCoords(dimension: number, x: number, y: number, z: number): void;
+
+ /**
+ * Resets both collision and raycast shape of the block to default on given coords in given dimension.
+ * @since 2.1.0b59
+ */
+ function unmapCollisionAndRaycastModelAtCoords(dimension: number, x: number, y: number, z: number): void;
+
+ /**
+ * Object used to manipulate rendered block during
+ * {@link Callback.CustomBlockTessellationFunction} calls.
+ */
+
+ interface RenderAPI {
+ /**
+ * @returns Pointer to native object instance of the following object,
+ * to be used in custom native code, etc.
+ */
+ getAddr(): number;
+ /**
+ * Renders box at the specified coordinates of the specified size.
+ * @param id ID of the block to be used as texture source
+ * @param data data of the block to be used as texture source
+ */
+ renderBoxId(x: number, y: number, z: number, x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, id: number, data: number): void;
+
+ /**
+ * Renders box at current block coordinates of the specified size.
+ * @param id ID of the block to be used as texture source
+ * @param data data of the block to be used as texture source
+ */
+ renderBoxIdHere(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, id: number, data: number): void;
+
+ /**
+ * Renders box at the specified coordinates of the specified size.
+ * @param texName block texture name
+ * @param texId block texture ID
+ */
+ renderBoxTexture(x: number, y: number, z: number, x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, texName: string, texId: number): void;
+
+ /**
+ * Renders box at current block coordinates of the specified size.
+ * @param id ID of the block to be used as texture source
+ * @param data data of the block to be used as texture source
+ */
+ renderBoxTextureHere(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, id: number, data: number): void;
+
+ /**
+ * Renders full block at specified coordinates.
+ * @param blockId ID of the block to be used as texture source
+ * @param blockData data of the block to be used as texture source
+ */
+ renderBlock(x: number, y: number, z: number, blockId: number, blockData: number): void;
+
+ /**
+ * Renders full block at current block coordinates.
+ * @param blockId ID of the block to be used as texture source
+ * @param blockData data of the block to be used as texture source
+ */
+ renderBlockHere(blockId: number, blockData: number): void;
+
+ /**
+ * Renders block model at the specified coordinates.
+ * @param model block model to be rendered at the specified coordinates
+ */
+ renderModel(x: number, y: number, z: number, model: BlockRenderer.Model): void;
+
+ /**
+ * Renders block model at current block coordinates.
+ * @param model block model to be rendered at current block coordinates
+ */
+ renderModelHere(model: BlockRenderer.Model): void;
+ }
+}
diff --git a/api/core-engine/BlockSource.d.ts b/api/core-engine/BlockSource.d.ts
new file mode 100644
index 000000000..6c2e8cd10
--- /dev/null
+++ b/api/core-engine/BlockSource.d.ts
@@ -0,0 +1,428 @@
+declare namespace BlockSource {
+ interface BlockBreakResult {
+ items: ItemInstance[];
+ experience: number;
+ }
+}
+
+/**
+ * New class to work with world instead of some methods from {@link World} module.
+ */
+declare class BlockSource {
+
+ /**
+ * @returns Interface to given dimension by default
+ * (`null` if given dimension is not loaded and this interface
+ * was not created yet).
+ */
+ static getDefaultForDimension(dimension: number): Nullable;
+
+ /**
+ * @returns Interface to the dimension where the given entity is
+ * (`null` if given entity does not exist or the dimension is not loaded
+ * and interface was not created).
+ */
+ static getDefaultForActor(entityUid: number): Nullable;
+
+ /**
+ * @returns BlockSource for world generation.
+ */
+ static getCurrentWorldGenRegion(): Nullable;
+
+ /**
+ * @returns BlockSource for the current client.
+ * @since 2.1.0b57 (caching since 2.3.1b115)
+ */
+ static getCurrentClientRegion(): Nullable;
+
+ /**
+ *
+ * @param pointer
+ */
+ static getFromCallbackPointer(pointer: number): Nullable;
+
+ /**
+ *
+ * @param pointer
+ * @since 2.3.1b115
+ */
+ static getFromServerCallbackPointer(pointer: number): Nullable;
+
+ /**
+ *
+ */
+ static resetDefaultBlockSources(): void;
+
+ /**
+ *
+ */
+ getPointer(): number;
+
+ /**
+ *
+ * @param allowed
+ */
+ setBlockUpdateAllowed(allowed: boolean): void;
+
+ /**
+ *
+ */
+ getBlockUpdateAllowed(): boolean;
+
+ /**
+ *
+ * @param type
+ */
+ setBlockUpdateType(type: number): void;
+
+ /**
+ *
+ */
+ getBlockUpdateType(): number;
+
+ /**
+ * Whether or not particles must be emitted when destroying
+ * blocks with this source.
+ * @default true
+ * @since 2.2.1b102
+ */
+ setDestroyParticlesEnabled(enabled: boolean): void;
+
+ /**
+ * @since 2.2.1b102
+ */
+ getDestroyParticlesEnabled(): boolean;
+
+ /**
+ * @returns Block's ID at coords.
+ * @param x X coord of the block
+ * @param y Y coord of the block
+ * @param z Z coord of the block
+ */
+ getBlockId(x: number, y: number, z: number): number;
+
+ /**
+ * @returns Block's ID at coords.
+ * @param x X coord of the block
+ * @param y Y coord of the block
+ * @param z Z coord of the block
+ * @since 2.2.1b96
+ */
+ getBlockID(x: number, y: number, z: number): number;
+
+ /**
+ * @returns Block's data at coords.
+ * @param x X coord of the block
+ * @param y Y coord of the block
+ * @param z Z coord of the block
+ */
+ getBlockData(x: number, y: number, z: number): number;
+
+ /**
+ * @param x X coord of the block
+ * @param y Y coord of the block
+ * @param z Z coord of the block
+ * @returns Object of the block on given coords
+ * or {@link Tile} object in Legacy pack.
+ * @since 2.1.0b59
+ */
+ getBlock(x: number, y: number, z: number): BlockState | Tile;
+
+ /**
+ * @returns Object of the extra block on given coords.
+ * @since 2.2.1b95
+ */
+ getExtraBlock(x: number, y: number, z: number): BlockState;
+
+ /**
+ * Sets block on coords.
+ * @param id ID of the block to set
+ * @param data data of the block to set
+ */
+ setBlock(x: number, y: number, z: number, id: number, data: number): void;
+
+ /**
+ * Sets block on coords.
+ * @param id ID of the block to set
+ * @since 2.2.1b95
+ */
+ setBlock(x: number, y: number, z: number, id: number): void;
+
+ /**
+ * Sets block by given {@link BlockState} on coords.
+ */
+ setBlock(x: number, y: number, z: number, state: BlockState): void;
+
+ /**
+ * Sets extra block (for example, water inside another blocks),
+ * on given coords by given ID and data.
+ * @since 2.2.1b95
+ */
+ setExtraBlock(x: number, y: number, z: number, id: number, data?: number): void;
+
+ /**
+ * Sets extra block (for example, water inside another blocks),
+ * on given coords by given {@link BlockState}.
+ * @since 2.2.1b95
+ */
+ setExtraBlock(x: number, y: number, z: number, state: BlockState): void;
+
+ /**
+ * @since 2.2.1b102
+ */
+ addToTickingQueue(x: number, y: number, z: number, state: BlockState, delay: number, todo?: number): void;
+
+ /**
+ * @since 2.2.1b102
+ */
+ addToTickingQueue(x: number, y: number, z: number, delay: number, todo?: number): void;
+
+ /**
+ *
+ * @since 2.4.0b119
+ */
+ getRainLevel(): number;
+
+ /**
+ *
+ * @param level
+ * @since 2.4.0b119
+ */
+ setRainLevel(level: number): void;
+
+ /**
+ *
+ * @since 2.4.0b119
+ */
+ getLightningLevel(): number;
+
+ /**
+ *
+ * @param level
+ * @since 2.4.0b119
+ */
+ setLightningLevel(level: number): void;
+
+ /**
+ * Destroys block on coords producing appropriate drop
+ * and particles. Do not use for massive tasks due to particles being
+ * produced.
+ * @param drop whether to provide drop for the block or not
+ */
+ destroyBlock(x: number, y: number, z: number, drop?: boolean): void;
+
+ /**
+ * Destroys block on coords by entity using specified item or without it.
+ * @param allowDrop whether to provide drop for the block or not
+ * @param entityUid entity ID or -1 ID if entity is not specified
+ * @param item tool which broke block
+ * @since 2.2.0b83
+ */
+ breakBlock(x: number, y: number, z: number, allowDrop: boolean, entityUid?: number, item?: ItemInstance): void;
+
+ /**
+ * Destroys block on coords by entity using specified item.
+ * @param allowDrop whether to provide drop for the block or not
+ * @param item tool which broke block
+ * @since 2.2.0b83
+ */
+ breakBlock(x: number, y: number, z: number, allowDrop: boolean, item: ItemInstance): void;
+
+ /**
+ * Same as breakBlock, but returns object containing drop and experience.
+ * @param entityUid entity ID or -1 ID if entity is not specified
+ * @param item tool which broke block
+ * @since 2.2.0b83
+ */
+ breakBlockForJsResult(x: number, y: number, z: number, entityUid?: number, item?: ItemInstance): BlockSource.BlockBreakResult;
+
+ /**
+ * Same as breakBlock, but returns object containing drop and experience.
+ * @param item tool which broke block
+ * @since 2.2.0b83
+ */
+ breakBlockForJsResult(x: number, y: number, z: number, item: ItemInstance): BlockSource.BlockBreakResult;
+
+ /**
+ * Creates an explosion on coords.
+ * @param power defines how many blocks can the explosion destroy and what
+ * blocks can or cannot be destroyed
+ * @param fire if true, puts the crater on fire
+ */
+ explode(x: number, y: number, z: number, power: number, fire: boolean): void;
+
+ /**
+ * @param mode certain modes also working with actors
+ */
+ clip(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, mode: number, output: number[]): number;
+
+ /**
+ * @returns Dimension ID to which the following object belongs.
+ */
+ getDimension(): number;
+
+ /**
+ * @returns Interface to the vanilla TileEntity (chest, furnace, etc.)
+ * on the coords, and null if it's not found.
+ */
+ getBlockEntity(x: number, y: number, z: number): Nullable;
+
+ /**
+ * @param x X coord of the block
+ * @param z Z coord of the block
+ * @returns Biome ID.
+ */
+ getBiome(x: number, z: number): number;
+
+ /**
+ * Sets biome ID by coords.
+ * @param biomeID ID of the biome to set
+ */
+ setBiome(chunkX: number, chunkZ: number, biomeID: number): void;
+
+ /**
+ * @returns Temperature of the biome on coords.
+ */
+ getBiomeTemperatureAt(x: number, y: number, z: number): number;
+
+ /**
+ * @returns Downfall of the biome on coords.
+ * @since 2.2.1b96
+ */
+ getBiomeDownfallAt(x: number, y: number, z: number): number;
+
+ /**
+ * @returns Grass color on chunk coords.
+ */
+ getGrassColor(x: number, z: number): number;
+
+ /**
+ * @param chunkX X coord of the chunk
+ * @param chunkZ Z coord of the chunk
+ * @returns `true` if chunk is loaded, `false` otherwise.
+ */
+ isChunkLoaded(chunkX: number, chunkZ: number): boolean;
+
+ /**
+ * @param x X coord of the position
+ * @param z Z coord of the position
+ * @returns `true` if chunk on the position is loaded, `false` otherwise.
+ */
+ isChunkLoadedAt(x: number, z: number): boolean;
+
+ /**
+ * @param chunkX X coord of the chunk
+ * @param chunkZ Z coord of the chunk
+ * @returns Loading state of the chunk by chunk coords.
+ */
+ getChunkState(chunkX: number, chunkZ: number): number;
+
+ /**
+ * @param x X coord of the position
+ * @param z Z coord of the position
+ * @returns Loading state of the chunk by coords.
+ */
+ getChunkStateAt(x: number, z: number): number;
+
+ /**
+ * @returns Light level on the specified coordinates, from 0 to 15.
+ * @since 2.1.0b69
+ */
+ getLightLevel(x: number, y: number, z: number): number;
+
+ /**
+ * @returns Whether the sky can be seen from coords.
+ */
+ canSeeSky(x: number, y: number, z: number): boolean;
+
+ /**
+ * @param type entity type, since 2.3.1b115 could be used
+ * to fetch all entities via `0` or `256`
+ * @returns Iterator of entity IDs in given box,
+ * that are equal to the given type, if blacklist value is `false`,
+ * and all except the entities of the given type, if blacklist value is `true`.
+ */
+ fetchEntitiesInAABB(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, type?: number, blacklist?: boolean): number[];
+
+ /**
+ * @param namespace entity namespace, e.g. "minecraft"
+ * @param type entity type, e.g. "chicken"
+ * @returns Iterator of entity IDs in given box, that are equal to the given type.
+ * @since 2.3.1b115
+ */
+ fetchEntitiesOfTypeInAABB(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, namespace: string, type: string): number[];
+
+ /**
+ * @param type namespaced entity type, e.g. "minecraft:chicken"; if there is
+ * no namespace, default "minecraft" will be used instead, e.g. "chicken"
+ * @returns Iterator of entity IDs in given box, that are equal to the given type.
+ * @since 2.3.1b115
+ */
+ fetchEntitiesOfTypeInAABB(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, type: string): number[];
+
+ /**
+ * @param type entity type, since 2.3.1b115 could be used
+ * to fetch all entities via `0` or `256`
+ * @returns List of entity IDs in given box,
+ * that are equal to the given type, if blacklist value is `false`,
+ * and all except the entities of the given type, if blacklist value is `true`.
+ */
+ listEntitiesInAABB(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, type?: number, blacklist?: boolean): number[];
+
+ /**
+ * @param namespace entity namespace, e.g. "minecraft"
+ * @param type entity type, e.g. "chicken"
+ * @returns List of entity IDs in given box, that are equal to the given type.
+ * @since 2.3.1b115
+ */
+ listEntitiesOfTypeInAABB(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, namespace: string, type: string): number[];
+
+ /**
+ * @param type namespaced entity type, e.g. "minecraft:chicken"; if there is
+ * no namespace, default "minecraft" will be used instead, e.g. "chicken"
+ * @returns List of entity IDs in given box, that are equal to the given type.
+ * @since 2.3.1b115
+ */
+ listEntitiesOfTypeInAABB(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, type: string): number[];
+
+ /**
+ * Spawns entity of given numeric or namespaced type on coords.
+ * @param type numeric entity type, e.g. `EEntityType.CHICKEN` or
+ * namespaced type with possible ommitions, e.g. "minecraft:chicken:",
+ * "minecraft:chicken", "chicken" does same
+ * @example
+ * ```ts
+ * Callback.addCallback("ItemUse", (coords: ItemUseCoordinates, item: ItemInstance, block: Tile, isExternal: boolean, player: number) =>
+ * BlockSource.getDefaultForActor(player)?.spawnEntity(coords.relative.x, coords.relative.y, coords.relative.z, EEntityType.CHICKEN));
+ * ```
+ */
+ spawnEntity(x: number, y: number, z: number, type: number | string): number;
+
+ /**
+ * Spawns entity of given namespace by string type on coords
+ * with optional spawn events data.
+ * @example
+ * ```ts
+ * Callback.addCallback("ItemUse", (coords: ItemUseCoordinates, item: ItemInstance, block: Tile, isExternal: boolean, player: number) =>
+ * BlockSource.getDefaultForActor(player)?.spawnEntity(coords.relative.x, coords.relative.y, coords.relative.z, "minecraft", "chicken", ""));
+ * ```
+ */
+ spawnEntity(x: number, y: number, z: number, namespace: string, type: string, initData?: string): number;
+
+ /**
+ * Creates dropped item and returns entity ID.
+ * @param id ID of the item to drop
+ * @param count count of the item to drop
+ * @param data data of the item to drop
+ * @param extra extra of the item to drop
+ * @returns Drop entity ID.
+ */
+ spawnDroppedItem(x: number, y: number, z: number, id: number, count: number, data: number, extra?: ItemExtraData): number;
+
+ /**
+ * Spawns experience orbs on coords.
+ * @param amount experience amount
+ */
+ spawnExpOrbs(x: number, y: number, z: number, amount: number): void;
+
+}
diff --git a/api/core-engine/BlockState.d.ts b/api/core-engine/BlockState.d.ts
new file mode 100644
index 000000000..f1a9b485d
--- /dev/null
+++ b/api/core-engine/BlockState.d.ts
@@ -0,0 +1,113 @@
+/**
+ * Class to work with vanilla blocks parameters.
+ * @since 2.2.1b89
+ */
+declare class BlockState implements Tile {
+
+ /**
+ * Data of the block.
+ */
+ readonly data: number;
+
+ /**
+ * Numeric ID of the block.
+ */
+ readonly id: number;
+
+ /**
+ * Constructs new BlockState object
+ * from given ID and data.
+ */
+ constructor(id: number, data: number);
+
+ /**
+ * Constructs new BlockState object
+ * from given ID and states object.
+ */
+ constructor(id: number, scriptable: {[key: number]: number});
+
+ /**
+ * @returns ID of the block.
+ */
+ getId(): number;
+
+ /**
+ * @returns Data of the block.
+ */
+ getData(): number;
+
+ /**
+ * @returns ID of the blockstate in runtime.
+ */
+ getRuntimeId(): number;
+
+ /**
+ * @returns Whether the state is valid.
+ */
+ isValidState(): boolean;
+
+ /**
+ * @returns State of the given number
+ * if it's present in the following object.
+ */
+ getState(state: number): number;
+
+ /**
+ * @returns Whether the state by given number
+ * is present in the following object.
+ */
+ hasState(state: number): boolean;
+
+ /**
+ * Adds state to the following object.
+ * @returns BlockState object itself.
+ */
+ addState(state: number, value: number): BlockState;
+
+ /**
+ * Adds states to the following object
+ * from given map instance.
+ * @returns BlockState object itself.
+ * @since 2.2.1b102
+ */
+ addStatesMap(states: java.util.Map): BlockState;
+
+ /**
+ * Adds states to the following object
+ * from given JS object instance.
+ * @returns BlockState object itself.
+ * @since 2.2.1b102
+ */
+ addStates(states: object): BlockState;
+
+ /**
+ * @returns All states from following object
+ * in {@link java.util.Map} instance.
+ */
+ getStates(): java.util.Map;
+
+ /**
+ * @returns All named states from following object
+ * in {@link java.util.Map} instance.
+ */
+ getNamedStates(): java.util.Map;
+
+ /**
+ * @returns All states from following object
+ * in JS object instance.
+ */
+ getStatesScriptable(): { [key: string]: number };
+
+ /**
+ * @returns All named states from following object
+ * in JS object instance.
+ */
+ getNamedStatesScriptable(): { [key: string]: number };
+
+ /**
+ * @returns Whether the following object is equal to given,
+ * according to different parameters.
+ */
+ equals(object: any): boolean;
+
+}
diff --git a/api/core-engine/Callback.d.ts b/api/core-engine/Callback.d.ts
new file mode 100644
index 000000000..ab349d796
--- /dev/null
+++ b/api/core-engine/Callback.d.ts
@@ -0,0 +1,1043 @@
+/**
+ * Module used to handle callbacks. Investigate details about the
+ * callback mechanism and the list of pre-defined callbacks.
+ */
+declare namespace Callback {
+
+ /**
+ * Adds callback function for the specified callback name. Most of native
+ * events can be prevented using {@link Game.prevent} call.
+ * @param name callback name, should be one of the pre-defined or a custom
+ * name if invoked via {@link Callback.invokeCallback}
+ * @param func function to be called when an event occurs
+ * @param priority the more this value is, the earlier your callback handler
+ * will be called when an event occurs
+ */
+ function addCallback(name: string, func: Function, priority?: number): void;
+
+ /**
+ * Invokes callback with any name and up to 10 additional parameters. You
+ * should not generally call pre-defined callbacks until you really need to
+ * do so. If you want to trigger some event in your mod, use your own
+ * callback names.
+ * @param name callback name
+ */
+ function invokeCallback(name: string, o1?: any, o2?: any, o3?: any, o4?: any, o5?: any, o6?: any, o7?: any, o8?: any, o9?: any, o10?: any): void;
+
+ /**
+ * Function used in "DimensionLoaded" callback.
+ */
+ interface DimensionLoadedFunction {
+ /**
+ * @param currentId vanilla dimension ID, one of the {@link EDimension}
+ * values, or custom dimension ID
+ * @param lastId previous unloaded dimension ID
+ */
+ (currentId: number, lastId: number): void
+ }
+
+ /**
+ * @since 2.0.4b37
+ */
+ function addCallback(name: "DimensionLoaded", func: DimensionLoadedFunction, priority?: number): void;
+
+ /**
+ * Function used in "DimensionUnloaded" callback.
+ */
+ interface DimensionUnloadedFunction {
+ (dimensionId: number): void
+ }
+
+ /**
+ * @since 2.0.4b37
+ */
+ function addCallback(name: "DimensionUnloaded", func: DimensionUnloadedFunction, priority?: number): void;
+
+ /**
+ * Function used in "LocalPlayerChangedDimension" and "PlayerChangedDimension" callback.
+ */
+ interface PlayerChangedDimensionFunction {
+ /**
+ * @param playerUid player entity unique numeric ID
+ * @param currentId vanilla dimension ID, one of the {@link EDimension}
+ * values, or custom dimension ID
+ * @param lastId previous unloaded dimension ID
+ */
+ (playerUid: number, currentId: number, lastId: number): void
+ }
+
+ /**
+ * @since 2.2.1b106
+ */
+ function addCallback(name: "LocalPlayerChangedDimension", func: PlayerChangedDimensionFunction, priority?: number): void;
+
+ function addCallback(name: "PlayerChangedDimension", func: PlayerChangedDimensionFunction, priority?: number): void;
+
+ /**
+ * Function used in "CustomDimensionTransfer" callback.
+ */
+ interface CustomDimensionTransferFunction {
+ /**
+ * @param entityUid entity that was transferred between dimensions
+ * @param from ID of the dimension the entity was transferred from
+ * @param to ID of the dimension the entity was transferred to
+ */
+ (entityUid: number, from: number, to: number): void
+ }
+
+ function addCallback(name: "CustomDimensionTransfer", func: CustomDimensionTransferFunction, priority?: number): void;
+
+ function addCallback(name: "tick", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "LocalTick", func: { (): void }, priority?: number): void;
+
+ /**
+ * Function used in "LocalPlayerTick" and "ServerPlayerTick" callback.
+ */
+ interface PlayerTickFunction {
+ /**
+ * @param playerUid player entity unique ID
+ * @param isDead is following player dead
+ */
+ (playerUid: number, isDead: boolean): void
+ }
+
+ /**
+ * @since 2.2.1b106
+ */
+ function addCallback(name: "LocalPlayerTick", func: PlayerTickFunction, priority?: number): void;
+
+ function addCallback(name: "ServerPlayerTick", func: PlayerTickFunction, priority?: number): void;
+
+ /**
+ * Object used in some callbacks for coordinate set with side information
+ * and relative coordinates set.
+ */
+ interface ItemUseCoordinates extends BlockPosition {
+ /**
+ * Relative coordinates, coordinates of the block to the specified side
+ * of current block.
+ */
+ relative: Vector,
+ /**
+ * Exact touch point, absolute point coordinates. Used only in "ItemUse"
+ * callback.
+ */
+ vec?: Vector
+ }
+
+ /**
+ * Function used in "ItemUse" and "ItemUseLocalServer" callbacks.
+ */
+ interface LegacyItemUseFunction {
+ /**
+ * @param coords set of all coordinate values that can be useful to write
+ * custom use logics, relative and vectorized one
+ * @param item item that was in the player's hand when it touched the block
+ * @param block block that was touched
+ * @param isExternal received from external player on server
+ * @param playerUid player entity UID
+ */
+ (coords: ItemUseCoordinates, item: ItemInstance, block: Tile, isExternal: boolean, playerUid: number): void
+ }
+
+ function addCallback(name: "ItemUse", func: LegacyItemUseFunction, priority?: number): void;
+
+ function addCallback(name: "ItemUseLocalServer", func: LegacyItemUseFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemUseServer" and "ItemUseLocal" callbacks.
+ */
+ interface ItemUseFunction {
+ /**
+ * @param coords set of all coordinate values that can be useful to write
+ * custom use logics
+ * @param item item that was in the player's hand when it touched the block
+ * @param block block that was touched
+ * @param playerUid player entity UID
+ */
+ (coords: ItemUseCoordinates, item: ItemInstance, block: Tile, playerUid: number): void
+ }
+
+ function addCallback(name: "ItemUseServer", func: ItemUseFunction, priority?: number): void;
+
+ /**
+ * @since 2.1.0b57
+ */
+ function addCallback(name: "ItemUseLocal", func: ItemUseFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemUseNoTarget" callback.
+ */
+ interface ItemUseNoTargetFunction {
+ /**
+ * @param item item that was in the player's hand when the event occurred
+ */
+ (item: ItemInstance, playerUid: number): void
+ }
+
+ function addCallback(name: "ItemUseNoTarget", func: ItemUseNoTargetFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemUsingReleased" callback.
+ */
+ interface ItemUsingReleasedFunction {
+ /**
+ * @param item item that was in the player's hand when the event occurred
+ * @param ticks amount of ticks left to the specified max use duration value
+ */
+ (item: ItemInstance, ticks: number, playerUid: number): void
+ }
+
+ function addCallback(name: "ItemUsingReleased", func: ItemUsingReleasedFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemUsingComplete" callback.
+ */
+ interface ItemUsingCompleteFunction {
+ /**
+ * @param item item that was in the player's hand when the event occurred
+ */
+ (item: ItemInstance, playerUid: number): void
+ }
+
+ function addCallback(name: "ItemUsingComplete", func: ItemUsingCompleteFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemDispensed" callback.
+ */
+ interface ItemDispensedFunction {
+ /**
+ * @param coords full coords object, where the main coords are the position of the dispenser block,
+ * `relative` ones are the position of the block to which the dispenser is pointed,
+ * and `vec` are the coords for the item to be dropped at
+ * @param item item that was dispensed
+ * @param region BlockSource object
+ * @param slot numeric ID of the slot from which the item was dispensed
+ */
+ (coords: Callback.ItemUseCoordinates, item: ItemInstance, region: BlockSource, slot: number): void
+ }
+
+ function addCallback(name: "ItemDispensed", func: ItemDispensedFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemIconOverride" callback.
+ */
+ interface ItemIconOverrideFunction {
+ /**
+ * @param item information about item that is used in override function
+ * @param isModUi whether icon override is working in mod ui or in vanilla one
+ * @returns Nothing if used in callback, {@link Item.TextureData} if used in item
+ * override function to return texture that will be used for the item.
+ */
+ (item: ItemInstance, isModUi: boolean): void | Item.TextureData
+ }
+
+ function addCallback(name: "ItemIconOverride", func: ItemIconOverrideFunction, priority?: number): void;
+
+ /**
+ * Function used in "ItemNameOverride" callback.
+ */
+ interface ItemNameOverrideFunction {
+ /**
+ * @param item information about item that is used in override function
+ * @param translation translated item name
+ * @param name original item name
+ * @returns Nothing if used in callback, string if used in item override
+ * function to return new name that will be displayed.
+ */
+ (item: ItemInstance, translation: string, name: string): void | string;
+ }
+
+ function addCallback(name: "ItemNameOverride", func: ItemNameOverrideFunction, priority?: number): void;
+
+ interface ExplosionParams {
+ /**
+ * Explosion power.
+ */
+ power: number,
+ /**
+ * If explosion is produced by an entity, entity unique ID, -1 otherwise.
+ */
+ entity: number,
+ /**
+ * If `true`, explosion produced the fire.
+ */
+ onFire: boolean,
+ /**
+ * Should explosion break blocks or not.
+ */
+ someBool: boolean,
+ /**
+ * Max block resistance.
+ */
+ someFloat: number;
+ }
+
+ /**
+ * Function used in "DestroyBlock" and "DestroyBlockStart" callbacks.
+ */
+ interface DestroyBlockFunction {
+ /**
+ * @param coords coordinates where the block is destroyed and side from
+ * where it is destroyed
+ * @param block block that is destroyed
+ * @param playerUid player entity unique numeric ID
+ */
+ (coords: ItemUseCoordinates, block: Tile, playerUid: number): void
+ }
+
+ function addCallback(name: "DestroyBlock", func: DestroyBlockFunction, priority?: number): void;
+
+ function addCallback(name: "DestroyBlockStart", func: DestroyBlockFunction, priority?: number): void;
+
+ /**
+ * Function used in "DestroyBlockContinue" callback.
+ */
+ interface DestroyBlockContinueFunction {
+ /**
+ * @param coords coordinates where the block is destroyed and side from
+ * where it is destroyed
+ * @param block block that is destroyed
+ * @param progress current fraction of breaking progress
+ */
+ (coords: ItemUseCoordinates, block: Tile, progress: number): void
+ }
+
+ function addCallback(name: "DestroyBlockContinue", func: DestroyBlockContinueFunction, priority?: number): void;
+
+ /**
+ * Function used in "BuildBlock" callback.
+ */
+ interface BuildBlockFunction {
+ /**
+ * @param coords coordinates where the block is placed and side from
+ * where it is placed
+ * @param block block that is placed
+ * @param playerUid player entity unique numeric ID
+ */
+ (coords: ItemUseCoordinates, block: Tile, playerUid: number): void
+ }
+
+ function addCallback(name: "BuildBlock", func: BuildBlockFunction, priority?: number): void;
+
+ /**
+ * Function used in "BlockChanged" callback.
+ */
+ interface BlockChangedFunction {
+ /**
+ * @param coords coordinates where block change occurred
+ * @param oldBlock the block that is being replaced
+ * @param newBlock replacement block
+ */
+ (coords: Vector, oldBlock: Tile, newBlock: Tile, region: BlockSource): void
+ }
+
+ function addCallback(name: "BlockChanged", func: BlockChangedFunction, priority?: number): void;
+
+ /**
+ * Function used in "BreakBlock" callback.
+ */
+ interface BreakBlockFunction {
+ /**
+ * @param coords coordinates where the block is placed and side from
+ * where it is placed
+ * @param block block that is placed
+ * @param playerUid player entity unique numeric ID
+ * @param item item that was in the player's hand when it breaked the block
+ */
+ (region: BlockSource, coords: ItemUseCoordinates, block: Tile, dropAllowed: boolean, playerUid: number, item: ItemInstance): void
+ }
+
+ /**
+ * @since 2.2.0b83
+ */
+ function addCallback(name: "BreakBlock", func: BreakBlockFunction, priority?: number): void;
+
+ interface RedstoneSignalParams {
+ /**
+ * Redstone signal power.
+ */
+ power: number,
+ /**
+ * Same as {@link RedstoneSignalParams.power}.
+ */
+ signal: number,
+ /**
+ * `true` if it is loading change.
+ */
+ onLoad: boolean
+ }
+
+ /**
+ * Function used in "RedstoneSignal" callback.
+ */
+ interface RedstoneSignalFunction {
+ /**
+ * @param coords coordinates where redstone signal changed
+ * @param params information about redstone signal
+ * @param block information about the block on the specified coordinates
+ */
+ (coords: Vector, params: RedstoneSignalParams, block: Tile, region: BlockSource): void
+ }
+
+ function addCallback(name: "RedstoneSignal", func: RedstoneSignalFunction, priority?: number): void;
+
+ function addCallback(name: "BlockEventEntityInside", func: Block.EntityInsideFunction, priority?: number): void;
+
+ function addCallback(name: "BlockEventEntityStepOn", func: Block.EntityStepOnFunction, priority?: number): void;
+
+ function addCallback(name: "BlockEventNeighbourChange", func: Block.NeighbourChangeFunction, priority?: number): void;
+
+ /**
+ * Function used in "PopBlockResources" callback.
+ */
+ interface PopBlockResourcesFunction {
+ /**
+ * @param coords coordinates of the block that was broken
+ * @param block information about the block that was broken
+ * @param explosionRadius explosion power in case of exploding
+ * @param cause cause information, supposed to always be zero
+ */
+ (coords: Vector, block: Tile, explosionRadius: number, cause: number, region: BlockSource): void
+ }
+
+ function addCallback(name: "PopBlockResources", func: PopBlockResourcesFunction, priority?: number): void;
+
+ /**
+ * Function used in "Explosion" callback.
+ */
+ interface ExplosionFunction {
+ /**
+ * @param coords coordinates of the explosion
+ * @param params additional explosion data
+ */
+ (coords: Vector, params: ExplosionParams): void
+ }
+
+ function addCallback(name: "Explosion", func: ExplosionFunction, priority?: number): void;
+
+ /**
+ * Function used in "CustomBlockTessellation" callback.
+ */
+ interface CustomBlockTessellationFunction {
+ /**
+ * @param renderer object used to manipulate block rendering process
+ * @param coords rendering block coordinates
+ * @param block block information
+ */
+ (renderer: BlockRenderer.RenderAPI, coords: Vector, block: Tile): void
+ }
+
+ function addCallback(name: "CustomBlockTessellation", func: CustomBlockTessellationFunction, priority?: number): void;
+
+ /**
+ * Function used in the "FoodEaten" callback.
+ */
+ interface FoodEatenFunction {
+ /**
+ * You can use {@link Entity.getCarriedItem} to get info about food item.
+ * @param food food amount produced by eaten food
+ * @param ratio saturation ratio produced by food
+ * @param playerUid player entity UID
+ */
+ (food: number, ratio: number, playerUid: number): void
+ }
+
+ function addCallback(name: "FoodEaten", func: FoodEatenFunction, priority?: number): void;
+
+ /**
+ * Function used in the "LocalPlayerEat" and "ServerPlayerEat" callback.
+ */
+ interface PlayerEatFunction {
+ /**
+ * You can use {@link Entity.getCarriedItem} to get info about food item.
+ * @param playerUid player entity UID
+ * @param food food amount produced by eaten food
+ * @param ratio saturation ratio produced by food
+ */
+ (playerUid: number, food: number, ratio: number): void
+ }
+
+ /**
+ * @since 2.2.1b106
+ */
+ function addCallback(name: "LocalPlayerEat", func: PlayerEatFunction, priority?: number): void;
+
+ /**
+ * @since 2.2.1b106
+ */
+ function addCallback(name: "ServerPlayerEat", func: PlayerEatFunction, priority?: number): void;
+
+ /**
+ * Function used in "EntityAdded" callback.
+ */
+ interface EntityFunction {
+ /**
+ * @param entityUid entity unique ID
+ */
+ (entityUid: number): void
+ }
+
+ function addCallback(name: "EntityAdded", func: EntityFunction, priority?: number): void;
+
+ function addCallback(name: "EntityRemoved", func: EntityFunction, priority?: number): void;
+
+ /**
+ * @since 2.2.1b93
+ */
+ function addCallback(name: "EntityAddedLocal", func: EntityFunction, priority?: number): void;
+
+ /**
+ * @since 2.2.1b93
+ */
+ function addCallback(name: "EntityRemovedLocal", func: EntityFunction, priority?: number): void;
+
+ /**
+ * Function used in "PlayerAttack" callback.
+ */
+ interface PlayerAttackFunction {
+ /**
+ * @param attackerUid player entity unique ID
+ * @param victimUid attacked entity unique ID
+ */
+ (attackerUid: number, victimUid: number): void
+ }
+
+ function addCallback(name: "PlayerAttack", func: PlayerAttackFunction, priority?: number): void;
+
+ /**
+ * Function used in "EntityHurt" callback.
+ */
+ interface EntityHurtFunction {
+ /**
+ * @param attackerUid entity that caused damage, determines actor of damage source, `-1` otherwise
+ * @param damageValue produced damage value in half-hearts
+ * @param damageType existing {@link Entity.DamageSource} or any inclusive value between 25 and 32
+ * @param armorReducesDamage if `true`, damage can be reduced by armor
+ */
+ (attackerUid: number, entityUid: number, damageValue: number, damageType: Entity.DamageSource, armorReducesDamage: boolean): void
+ }
+
+ function addCallback(name: "EntityHurt", func: EntityHurtFunction, priority?: number): void;
+
+ /**
+ * Function used in "EntityDeath" callback.
+ */
+ interface EntityDeathFunction {
+ /**
+ * @param attackerUid entity that caused damage, determines actor of damage source, `-1` otherwise
+ * @param damageType existing {@link Entity.DamageSource} or any inclusive value between 25 and 32
+ */
+ (entityUid: number, attackerUid: number, damageType: Entity.DamageSource): void
+ }
+
+ function addCallback(name: "EntityDeath", func: EntityDeathFunction, priority?: number): void;
+
+ /**
+ * Function used in "EntityInteract" callback.
+ */
+ interface EntityInteractFunction {
+ /**
+ * @param entityUid entity unique ID
+ * @param playerUid player entity unique ID
+ * @param coords exact vector in which interaction happened
+ */
+ (entityUid: number, playerUid: number, coords: Vector): void
+ }
+
+ function addCallback(name: "EntityInteract", func: EntityInteractFunction, priority?: number): void;
+
+ /**
+ * Function used in "EntityPickUpDrop" callback.
+ * @since 2.2.1b88
+ */
+ interface EntityPickUpDropFunction {
+ /**
+ * @param entityUid entity that picked up the item
+ * (this callback is currently called only for players)
+ * @param dropEntityUid dropped item's entity
+ * @param item ItemInstance of the drop entity
+ * @param count which count of item stack
+ */
+ (entityUid: number, dropEntityUid: number, item: ItemInstance, count: number)
+ }
+
+ /**
+ * @since 2.2.1b88
+ */
+ function addCallback(name: "EntityPickUpDrop", func: EntityPickUpDropFunction, priority?: number): void;
+
+ /**
+ * Function used in "ExpAdd" callback.
+ */
+ interface ExpAddFunction {
+ /**
+ * @param exp amount of experience to be added
+ * @param playerUid player's unique ID
+ */
+ (exp: number, playerUid: number): void
+ }
+
+ function addCallback(name: "ExpAdd", func: ExpAddFunction, priority?: number): void;
+
+ /**
+ * Function used in "ExpLevelAdd" callback.
+ */
+ interface ExpLevelAddFunction {
+ /**
+ * @param level amount of levels to be added
+ * @param playerUid player's uID
+ */
+ (level: number, playerUid: number): void
+ }
+
+ function addCallback(name: "ExpLevelAdd", func: ExpLevelAddFunction, priority?: number): void;
+
+ /**
+ * Function used in "ExpOrbsSpawned" callback.
+ */
+ interface ExpOrbsSpawnedFunction {
+ /**
+ * @param amount amount of experience to be added
+ * @param coords dropped orbs entity coordinates
+ * @param playerUid player entity unique numeric ID
+ */
+ (region: BlockSource, amount: number, coords: Vector, playerUid: number): void
+ }
+
+ function addCallback(name: "ExpOrbsSpawned", func: ExpOrbsSpawnedFunction, priority?: number): void;
+
+ /**
+ * Function used in "ProjectileHit" callback.
+ */
+ interface ProjectileHitFunction {
+ /**
+ * @param projectileUid projectile entity unique ID
+ * @param item projectile item
+ * @param target object containing hit coordinates and information about
+ * hit entity/block
+ */
+ (projectileUid: number, item: ItemInstance, target: ProjectileHitTarget): void
+ }
+
+ /**
+ * Object containing hit coordinates and information about hit entity/block.
+ */
+ interface ProjectileHitTarget {
+ /**
+ * Exact hit position x.
+ */
+ x: number,
+ /**
+ * Exact hit position y.
+ */
+ y: number,
+ /**
+ * Exact hit position z.
+ */
+ z: number,
+ /**
+ * If an entity was hit, entity unique ID, `-1` otherwise.
+ */
+ entity: number,
+ /**
+ * Coordinates and side of the hit block or null if an entity was hit.
+ */
+ coords: Nullable
+ }
+
+ function addCallback(name: "ProjectileHit", func: ProjectileHitFunction, priority?: number): void;
+
+ /**
+ * @since 2.4.0b122
+ */
+ function addCallback(name: "ChunkLoadingStateChanged", func: World.ChunkStateChangedFunction, priority?: number): void;
+
+ /**
+ * @since 2.4.0b122
+ */
+ function addCallback(name: "LocalChunkLoadingStateChanged", func: World.ChunkStateChangedFunction, priority?: number): void;
+
+ /**
+ * Function used in all generation callbacks.
+ */
+ interface GenerateChunkFunction {
+ /**
+ * @param chunkX chunk X coordinate; multiply by 16 to receive
+ * corner block coordinates
+ * @param chunkZ chunk Z coordinate; multiply by 16 to receive
+ * corner block coordinates
+ * @param random random object that should be used for generation
+ * process; already seeded by appropriate values
+ * @param dimensionId current dimension's numeric ID
+ * @param chunkSeed chunk-specific seed to use in chunk random generation
+ * @param worldSeed world-specific seed to use in chunk generation
+ * @param dimensionSeed dimension-specific seed to use in chunk generation
+ */
+ (chunkX: number, chunkZ: number, random: java.util.Random,
+ dimensionId: number, chunkSeed: number, worldSeed: number, dimensionSeed: number): void
+ }
+
+ function addCallback(name: "GenerateChunk", func: GenerateChunkFunction, priority?: number): void;
+
+ /**
+ * @deprecated Use "GenerateChunk" with condition instead.
+ */
+ function addCallback(name: "GenerateChunkUnderground", func: GenerateChunkFunction, priority?: number): void;
+
+ function addCallback(name: "GenerateNetherChunk", func: GenerateChunkFunction, priority?: number): void;
+
+ function addCallback(name: "GenerateEndChunk", func: GenerateChunkFunction, priority?: number): void;
+
+ function addCallback(name: "GenerateChunkUniversal", func: GenerateChunkFunction, priority?: number): void;
+
+ /**
+ * Function used in "GenerateCustomDimensionChunk" callback.
+ */
+ interface GenerateCustomDimensionChunkFunction {
+ /**
+ * @param chunkX chunk X coordinate; multiply by 16 to receive
+ * corner block coordinates
+ * @param chunkZ chunk Z coordinate; multiply by 16 to receive
+ * corner block coordinates
+ * @param random random object that should be used for generation
+ * process; already seeded by appropriate values
+ * @param dimensionId current dimension's numeric ID
+ */
+ (chunkX: number, chunkZ: number, random: java.util.Random, dimensionId: number): void
+ }
+
+ function addCallback(name: "GenerateCustomDimensionChunk", func: GenerateCustomDimensionChunkFunction, priority?: number): void;
+
+ /**
+ * @since 2.0.1b11
+ */
+ function addCallback(name: "GenerateBiomeMap", func: GenerateChunkFunction, priority?: number): void;
+
+ /**
+ * @since 2.2.0b84
+ */
+ function addCallback(name: "PreProcessChunk", func: GenerateChunkFunction, priority?: number): void;
+
+ /**
+ * @since 2.2.0b84
+ */
+ function addCallback(name: "PostProcessChunk", func: GenerateChunkFunction, priority?: number): void;
+
+ /**
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ function addCallback(name: "EnchantPostAttack", func: CustomEnchant.DamageCallback, priority?: number): void;
+
+ /**
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ function addCallback(name: "EnchantGetProtectionBonus", func: CustomEnchant.ProtectionBonusProvider, priority?: number): void;
+
+ /**
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ function addCallback(name: "EnchantGetDamageBonus", func: CustomEnchant.AttackDamageBonusProvider, priority?: number): void;
+
+ /**
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ function addCallback(name: "EnchantPostHurt", func: CustomEnchant.DamageCallback, priority?: number): void;
+
+ /**
+ * Function used in "NativeCommand" callback.
+ */
+ interface NativeCommandFunction {
+ /**
+ * @param command command that was entered or `null` if
+ * no command was providen
+ */
+ (command: Nullable): void
+ }
+
+ function addCallback(name: "NativeCommand", func: NativeCommandFunction, priority?: number): void;
+
+ /**
+ * Function used in "CraftRecipePreProvided" callback.
+ */
+ interface CraftRecipePreProvidedFunction {
+ /**
+ * @param recipe object containing recipe information
+ * @param field object containing crafting field information
+ * @param playerUid player which caused craft, since 2.4.0b122
+ */
+ (recipe: Recipes.WorkbenchRecipe, field: Recipes.WorkbenchField, playerUid: number): void
+ }
+
+ function addCallback(name: "CraftRecipePreProvided", func: CraftRecipePreProvidedFunction, priority?: number): void;
+
+ /**
+ * Function used in "CraftRecipeProvided" callback.
+ */
+ interface CraftRecipeProvidedFunction {
+ /**
+ * @param recipe object containing recipe information
+ * @param field object containing crafting field information
+ * @param isPrevented if `true`, recipe was prevented by craft function
+ * @param playerUid player which caused craft, since 2.4.0b122
+ */
+ (recipe: Recipes.WorkbenchRecipe, field: Recipes.WorkbenchField, isPrevented: boolean, playerUid: number): void
+ }
+
+ function addCallback(name: "CraftRecipeProvidedFunction", func: CraftRecipeProvidedFunction, priority?: number): void;
+
+ /**
+ * Function used in "VanillaWorkbenchCraft" and "VanillaWorkbenchPostCraft"
+ * callbacks.
+ */
+ interface VanillaWorkbenchCraftFunction {
+ /**
+ * @param result recipe result item
+ * @param workbenchContainer workbench container instance
+ * @param playerUid player which caused craft
+ */
+ (result: ItemInstance, workbenchContainer: UI.Container, playerUid: number): void
+ }
+
+ function addCallback(name: "VanillaWorkbenchCraft", func: VanillaWorkbenchCraftFunction, priority?: number): void;
+
+ function addCallback(name: "VanillaWorkbenchPostCraft", func: VanillaWorkbenchCraftFunction, priority?: number): void;
+
+ /**
+ * Function used in "VanillaWorkbenchRecipeSelected" callback.
+ */
+ interface VanillaWorkbenchRecipeSelectedFunction {
+ /**
+ * @param recipe object containing recipe information
+ * @param result recipe result item
+ * @param workbenchContainer workbench container instance
+ */
+ (recipe: Recipes.WorkbenchRecipe, result: ItemInstance, workbenchContainer: UI.Container)
+ }
+
+ function addCallback(name: "VanillaWorkbenchRecipeSelected", func: VanillaWorkbenchRecipeSelectedFunction, priority?: number): void;
+
+ /**
+ * Function used in "TileEntityAdded" callback.
+ */
+ interface TileEntityAddedFunction {
+ (updatable: Updatable | TileEntity, isTileEntity: boolean): void
+ }
+
+ function addCallback(name: "TileEntityAdded", func: TileEntityAddedFunction, priority?: number): void;
+
+ /**
+ * Function used in "TileEntityRemoved" callback.
+ */
+ interface TileEntityRemovedFunction {
+ (updatable: Updatable | TileEntity): void
+ }
+
+ function addCallback(name: "TileEntityRemoved", func: TileEntityRemovedFunction, priority?: number): void;
+
+ /**
+ * Function used in "ContainerClosed" callback.
+ */
+ interface ContainerClosedFunction {
+ /**
+ * @param container container that was closed
+ * @param window window that was loaded in the container
+ * @param byUser if `true`, container was closed by user,
+ * from the code otherwise
+ */
+ (container: UI.Container, window: UI.IWindow, byUser: boolean): void
+ }
+
+ function addCallback(name: "ContainerClosed", func: ContainerClosedFunction, priority?: number): void;
+
+ /**
+ * Function used in "ContainerOpened" callback.
+ */
+ interface ContainerOpenedFunction {
+ /**
+ * @param container container that was opened
+ * @param window window that was loaded in the container
+ */
+ (container: UI.Container, window: UI.IWindow): void
+ }
+
+ function addCallback(name: "ContainerOpened", func: ContainerOpenedFunction, priority?: number): void;
+
+ /**
+ * Function used in "NativeGuiChanged" callback.
+ */
+ interface NativeGuiChangedFunction {
+ /**
+ * @param screenName current screen name
+ * @param lastScreenName previous screen name
+ * @param isPushEvent if `true`, the new screen was pushed to
+ * the screen stack, popped from the stack otherwise
+ */
+ (screenName: string, lastScreenName: string, isPushEvent: boolean): void
+ }
+
+ function addCallback(name: "NativeGuiChanged", func: NativeGuiChangedFunction, priority?: number): void;
+
+ /**
+ * Function used in "CustomWindowOpened" and "CustomWindowClosed" callbacks.
+ */
+ interface CustomWindowFunction {
+ /**
+ * @param window window that was opened
+ */
+ (window: UI.IWindow): void;
+ }
+
+ function addCallback(name: "CustomWindowOpened", func: CustomWindowFunction, priority?: number): void;
+
+ function addCallback(name: "CustomWindowClosed", func: CustomWindowFunction, priority?: number): void;
+
+ function addCallback(name: "AddRuntimePacks", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "PreBlocksDefined", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "BlocksDefined", func: { (): void }, priority?: number): void;
+
+ /**
+ * Function used in "CoreConfigured" callback.
+ */
+ interface CoreConfiguredFunction {
+ /**
+ * @param config Inner Core default config instance
+ */
+ (config: Config): void;
+ }
+
+ function addCallback(name: "CoreConfigured", func: CoreConfiguredFunction, priority?: number): void;
+
+ function addCallback(name: "PreLoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "APILoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ModsLoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "PostLoaded", func: { (): void }, priority?: number): void;
+
+ /**
+ * @since 2.4.0b122
+ */
+ function addCallback(name: "OptionsChanged", func: { (): void }, priority?: number): void;
+
+ /**
+ * Function used in "LevelSelected" callback.
+ */
+ interface LevelSelectedFunction {
+ /**
+ * @param worldName name of the selected world
+ * @param worldDir name of the directory where the world is stored; worlds
+ * directories are located at `games/horizon/packs/Inner_Core/worlds/`
+ */
+ (worldName: string, worldDir: string): void
+ }
+
+ function addCallback(name: "LevelSelected", func: LevelSelectedFunction, priority?: number): void;
+
+ /**
+ * Function used in "ConnectingToHost" callback.
+ */
+ interface ConnectingToHostFunction {
+ (host: string, minecraftPort: number, moddedPort: number): void
+ }
+
+ /**
+ * @since 2.1.0b57
+ */
+ function addCallback(name: "ConnectingToHost", func: ConnectingToHostFunction, priority?: number): void;
+
+ function addCallback(name: "LevelCreated", func: { (): void }, priority?: number): void;
+
+ /**
+ * Function used in "LevelLoaded" and "LevelPreLoaded" callbacks.
+ */
+ interface LevelLoadedFunction {
+ /**
+ * @param isServer server-side or remote level is loaded
+ */
+ (isServer: boolean): void
+ }
+
+ function addCallback(name: "LevelPreLoaded", func: LevelLoadedFunction, priority?: number): void;
+
+ function addCallback(name: "LevelLoaded", func: LevelLoadedFunction, priority?: number): void;
+
+ function addCallback(name: "LocalLevelLoaded", func: { (): void }, priority?: number): void;
+
+ /**
+ * Function used in "LocalPlayerLoaded", "ServerPlayerLoaded" and "ServerPlayerLeft" callback.
+ */
+ interface PlayerFunction {
+ /**
+ * @param playerUid unique ID of the player entity, that has been connected to server
+ */
+ (playerUid: number): void
+ }
+
+ /**
+ * @since 2.2.1b106
+ */
+ function addCallback(name: "LocalPlayerLoaded", func: PlayerFunction, priority?: number): void;
+
+ function addCallback(name: "RemoteLevelLoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "RemoteLevelPreLoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ServerLevelLoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ServerLevelPreLoaded", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ServerPlayerLoaded", func: PlayerFunction, priority?: number): void;
+
+ function addCallback(name: "LevelDisplayed", func: { (): void }, priority?: number): void;
+
+ /**
+ * Function used in "ReadSaves" and "WriteSaves" callbacks.
+ * Avoid modifying values directly, consider using {@link Saver} instead.
+ */
+ interface SavesFunction {
+ (globalScope: object): void
+ }
+
+ function addCallback(name: "ReadSaves", func: SavesFunction, priority?: number): void;
+
+ function addCallback(name: "WriteSaves", func: SavesFunction, priority?: number): void;
+
+ /**
+ * Function used in "SystemKeyEventDispatched" callback.
+ */
+ interface SystemKeyEventDispatchedFunction {
+ /**
+ * @param code key code of pressed button
+ * @param state pressing state, such as down, etc.
+ */
+ (code: number, state: number): void
+ }
+
+ function addCallback(name: "SystemKeyEventDispatched", func: SystemKeyEventDispatchedFunction, priority?: number): void;
+
+ function addCallback(name: "NavigationBackPressed", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "GameLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "LevelPreLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "LevelLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "LocalLevelPreLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "LocalLevelLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ServerLevelPreLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ServerLevelLeft", func: { (): void }, priority?: number): void;
+
+ function addCallback(name: "ServerPlayerLeft", func: PlayerFunction, priority?: number): void;
+
+ function addCallback(name: "AppSuspended", func: { (): void }, priority?: number): void;
+
+}
diff --git a/api/core-engine/Commands.d.ts b/api/core-engine/Commands.d.ts
new file mode 100644
index 000000000..9807e54cf
--- /dev/null
+++ b/api/core-engine/Commands.d.ts
@@ -0,0 +1,19 @@
+/**
+ * Namespace used to manipulate Minecraft commands.
+ */
+declare namespace Commands {
+ /**
+ * Executes specified command.
+ * @param command command to be executed
+ * @returns Error message or null if the command was run successfully.
+ */
+ function exec(command: string): Nullable;
+
+ /**
+ * Executes specified command using specified coordinates as command
+ * location for all relative calculations.
+ * @param command command to be executed
+ * @returns Error message or null if the command was run successfully.
+ */
+ function execAt(command: string, x: number, y: number, z: number): Nullable;
+}
diff --git a/api/core-engine/Config.d.ts b/api/core-engine/Config.d.ts
new file mode 100644
index 000000000..b300b4fe6
--- /dev/null
+++ b/api/core-engine/Config.d.ts
@@ -0,0 +1,131 @@
+/**
+ * Json configuration file reading/writing utility.
+ */
+declare class Config {
+ /**
+ * Creates new {@link Config} instance using specified file.
+ * @param file {@link java.io.File} instance of the file to use
+ */
+ constructor(file: java.io.File);
+ /**
+ * Creates new {@link Config} instance using specified file.
+ * @param path path to configuration file
+ */
+ constructor(path: string);
+ /**
+ * @since 2.2.1b96
+ */
+ getPath(): string;
+ /**
+ * @since 2.2.1b96
+ */
+ reload(): void;
+ /**
+ * Writes configuration JSON to the file.
+ */
+ save(): void;
+ /**
+ * @returns Read-only ArrayList instance containing
+ * all the names in the current config file.
+ */
+ getNames(): java.util.ArrayList;
+ /**
+ * Gets property from the config.
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns Config instance with current config as parent if the
+ * property is object, {@link org.json.JSONArray} instance if the property is an
+ * array, raw type if the property is of that raw type, `null` otherwise.
+ *
+ * @example
+ * ```ts
+ * config.get("generation.ore_copper.max_height");
+ * ```
+ */
+ get>(name: string): T;
+ /**
+ * Same as {@link Config.get}.
+ */
+ access>(name: string): T;
+ /**
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns Boolean config value specified in config or false if no value was
+ * specified.
+ */
+ getBool(name: string): boolean;
+ /**
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns Number object instance, containing numeric value by given name
+ * from the config, or `0` if no value was specified.
+ */
+ getNumber(name: string): java.lang.Number;
+ /**
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns Integer of value by given name from the config, or `0` if no value was specified.
+ */
+ getInteger(name: string): number;
+ /**
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns Floating-point number of value by given name from the config, or `0.0` if no value was specified.
+ */
+ getFloat(name: string): number;
+ /**
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns Double number of value by given name from the config, or `0.0` if no value was specified.
+ */
+ getDouble(name: string): number;
+ /**
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @returns String by given name from the config, or `null` if no value was specified.
+ */
+ getString(name: string): Nullable;
+ /**
+ * Sets config value. Do not use {@link org.json.JSONObject} instances to create
+ * nested objects, consider using dot-separated names instead.
+ * @param name option name, supports multi-layer calls, separated by **'.'**
+ * @param val value, may be {@link org.json.JSONArray} instance,
+ * {@link org.json.JSONObject} instance or raw data type
+ */
+ set(name: string, val: T): boolean;
+ /**
+ * @param path option name, supports multi-layer calls, separated by **'.'**
+ * @returns Editable {@link Config.ConfigValue} instance that can be used
+ * to manipulate this config option separately.
+ */
+ getValue(path: string): Nullable;
+ /**
+ * Ensures that config has all the properties the data pattern contains, if
+ * not, puts default values to match the pattern.
+ * @param jsonstr string representation of JSON object representing the data pattern
+ */
+ checkAndRestore(jsonstr: string): void;
+ /**
+ * Ensures that config has all the properties the data pattern contains, if
+ * not, puts default values to match the pattern.
+ * @param jsonobj javascript object representing the data pattern checkAndRestore
+ */
+ checkAndRestore(jsonobj: Scriptable): void;
+ /**
+ * Ensures that config has all the properties the data pattern contains, if
+ * not, puts default values to match the pattern.
+ * @param json {@link org.json.JSONObject} instance to be used as data pattern
+ */
+ checkAndRestore(json: org.json.JSONObject): void;
+}
+
+declare namespace Config {
+ /**
+ * Class representing config value with it's path withing {@link Config} object.
+ */
+ class ConfigValue {
+ /**
+ * Sets config value and saves configuration file.
+ * @param value value, may be {@link org.json.JSONArray} instance,
+ * {@link org.json.JSONObject} instance or raw data type.
+ */
+ set(value: T): void;
+ /**
+ * @returns Config value, result is the same as the result of {@link Config.get} call.
+ */
+ get>(): T;
+ }
+}
diff --git a/api/core-engine/CustomBiome.d.ts b/api/core-engine/CustomBiome.d.ts
new file mode 100644
index 000000000..cebd1d36f
--- /dev/null
+++ b/api/core-engine/CustomBiome.d.ts
@@ -0,0 +1,267 @@
+/**
+ * Class used to create custom biomes. Note that Minecraft has a limit of 256 biomes
+ * and there are already more than 100 vanilla biomes, so do not overuse
+ * this functionality.
+ */
+declare class CustomBiome {
+
+ /**
+ * @returns Object instance, with all custom
+ * biomes registered by every mod.
+ * @since 2.2.1b93
+ */
+ static getAllCustomBiomes(): java.util.Map;
+
+ /**
+ * Called when server detection packet received.
+ * @internal
+ * @since 2.3.1b116
+ */
+ static updateNativeId(json: org.json.JSONObject): void;
+
+ /**
+ * Called when server stopped to cleanup biome synced IDs.
+ * @internal
+ * @since 2.3.1b116
+ */
+ static reset(): void;
+
+ /**
+ * @returns Whether biome is invalid.
+ */
+ isInvalid(): boolean;
+
+ /**
+ * Crates a new custom biome with specified string identifier.
+ * @param name string identifier of the biome
+ */
+ constructor(name: string);
+
+ /**
+ * custom biome numeric ID.
+ */
+ readonly id: number;
+
+ /**
+ * Custom biome name.
+ */
+ readonly name: string;
+
+ /**
+ * Pointer to biome's native object,
+ * represented as long number.
+ */
+ readonly pointer: number;
+
+ /**
+ * Sets biome's grass color. Grass color is interpolated on the bounds of
+ * the biome.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setGrassColor(r: number, g: number, b: number): CustomBiome;
+
+ /**
+ * Sets biome's grass color. Grass color is interpolated on the bounds of
+ * the biome.
+ * @param color integer color value (you can specify it using hex value)
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setGrassColor(color: number): CustomBiome;
+
+ /**
+ * Sets biome's sky color.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.4.0b120
+ */
+ setSkyColor(r: number, g: number, b: number): CustomBiome;
+
+ /**
+ * Sets biome's sky color.
+ * @param color integer color value (you can specify it using hex value)
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setSkyColor(color: number): CustomBiome;
+
+ /**
+ * Sets biome's foliage color.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setFoliageColor(r: number, g: number, b: number): CustomBiome;
+
+ /**
+ * Sets biome's foliage color.
+ * @param color integer color value (you can specify it using hex value)
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setFoliageColor(color: number): CustomBiome;
+
+ /**
+ * Sets biome's water color.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setWaterColor(r: number, g: number, b: number): CustomBiome;
+
+ /**
+ * Sets biome's water color.
+ * @param color integer color value (you can specify it using hex value)
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setWaterColor(color: number): CustomBiome;
+
+ /**
+ * Sets biome's temperature and downfall.
+ * @param temperature temperature value, from 0 to 1
+ * @param downfall downfall value, from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setTemperatureAndDownfall(temperature: number, downfall: number): CustomBiome;
+
+ /**
+ * Specifies the block that will cover the biome; e.g., most of the biomes
+ * use grass as cover block, though some of the biomes use other blocks
+ * (sand, ice, etc.).
+ * @param id block's tile ID
+ * @param data block data
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setCoverBlock(id: number, data: number): CustomBiome;
+
+ /**
+ * Specifies the block that will be under the covering block of the biome;
+ * e.g., most of the biomes use dirt as cover block,
+ * though some of the biomes use other blocks.
+ * @param id block's tile ID
+ * @param data block data
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setSurfaceBlock(id: number, data: number): CustomBiome;
+
+ /**
+ * Sets the block that fills the terrain. Vanilla biomes use stone filling.
+ * @param id block's tile ID
+ * @param data block data
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setFillingBlock(id: number, data: number): CustomBiome;
+
+ /**
+ * Sets the block that fills the floor at the bottom of the sea or the ocean.
+ * Vanilla biomes use gravel or stone filling.
+ * @param id block's tile ID
+ * @param data block data
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.2.0b1 pre-alpha
+ */
+ setSeaFloorBlock(id: number, data: number): CustomBiome;
+
+ /**
+ * Specifies the block that will cover the biome. E.g. most of the biomes
+ * use grass as cover block, though some of the biomes use other blocks
+ * (sand, ice, etc.).
+ * @param id block's tile ID
+ * @param data block data
+ * @returns Reference to itself to be used in sequential calls.
+ * @deprecated Use {@link CustomBiome.setSurfaceBlock} instead.
+ */
+ setAdditionalBlock(id: number, data: number): CustomBiome;
+
+ /**
+ * Sets the average depth of the sea floor in this biome.
+ * @param depth depth of the see floor by Y-axis.
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.2.0b1 pre-alpha
+ */
+ setSeaFloorDepth(depth: number): CustomBiome;
+
+ /**
+ * Sets the average depth of the something in this biome.
+ * @param depth surface depth parameter.
+ * @returns Reference to itself to be used in sequential calls.
+ * @default 7
+ * @deprecated Use {@link CustomBiome.setSeaFloorDepth} instead.
+ * @since 2.2.0b1 pre-alpha
+ */
+ setSurfaceParam(depth: number): CustomBiome;
+
+ /**
+ * Defines the server-side biome params from given JSON string.
+ * @returns Reference to itself to be used in sequential calls.
+ * @throws Java {@link java.lang.IllegalArgumentException} if the string cannot be parsed.
+ *
+ * @example
+ * Many thanks to DansZbar2 for the example!
+ * ```js
+ * const CHERRY_BIOME = new CustomBiome("environmental_cherry");
+ * CHERRY_BIOME.setServerJson(JSON.stringify({
+ * "minecraft:climate": {
+ * "downfall": 0.0,
+ * "snow_accumulation": [ 0.0, 0.0 ],
+ * "temperature": 2.0,
+ * "blue_spores": 0,
+ * "red_spores": 0,
+ * "white_ash": 0,
+ * "ash": 0
+ * },
+ * "minecraft:overworld_height": {
+ * "noise_type": "default"
+ * },
+ * "animal": {},
+ * "monster": {},
+ * "overworld": {},
+ * "environmental_cherry": {},
+ * "minecraft:surface_parameters": {
+ * "top_material": "minecraft:grass",
+ * "mid_material": "minecraft:dirt",
+ * "foundation_material": "minecraft:stone",
+ * "sea_floor_material": "minecraft:clay",
+ * "sea_material": "minecraft:water",
+ * "sea_floor_depth": 7
+ * },
+ * "minecraft:overworld_generation_rules": {
+ * "hills_transformation": "jungle_hills",
+ * "generate_for_climates": [
+ * [ "cold", 5 ],
+ * [ "medium", 20 ],
+ * [ "warm", 35 ]
+ * ]
+ * }
+ * }));
+ * ```
+ * @since 2.2.0b1 pre-alpha
+ */
+ setServerJson(json: string): CustomBiome;
+
+ /**
+ * Defines the client-side biome params from given JSON string.
+ * @returns Reference to itself to be used in sequential calls.
+ * @throws Java {@link java.lang.IllegalArgumentException} if the string cannot be parsed.
+ *
+ * @example
+ * Many thanks to DansZbar2 for the example!
+ * ```js
+ * const CHERRY_BIOME = new CustomBiome("environmental_cherry");
+ * CHERRY_BIOME.setClientJson(JSON.stringify({
+ * "water_surface_color": "#d176e1",
+ * "water_fog_color": "#a35dc2",
+ * "water_surface_transparency": 0.7,
+ * "water_fog_distance": 11,
+ * // custom fog defined in the addon
+ * "fog_identifier": "environmental:environmental_cherry"
+ * }));
+ * ```
+ * @since 2.2.0b1 pre-alpha
+ */
+ setClientJson(json: string): CustomBiome;
+}
diff --git a/api/core-engine/CustomEnchant.d.ts b/api/core-engine/CustomEnchant.d.ts
new file mode 100644
index 000000000..fa4b7094b
--- /dev/null
+++ b/api/core-engine/CustomEnchant.d.ts
@@ -0,0 +1,144 @@
+/**
+ * Module to create custom enchantments.
+ * @since 2.2.1b105
+ */
+declare namespace CustomEnchant {
+
+ /**
+ * Object returned by {@link CustomEnchant.newEnchant} method.
+ * Used to configure different custom enchantment behaviors.
+ */
+ interface EnchantSetupInterface {
+
+ /**
+ * The numeric ID of the following enchantment
+ * to be used in different operations.
+ * This ID will not change after the first generation,
+ * same as it works with blocks' and items' IDs.
+ */
+ readonly id: number;
+
+ /**
+ * Sets the following enchantment frequency, possibly used in treasures.
+ * @default 3
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setFrequency(freq: number): EnchantSetupInterface;
+
+ /**
+ * Sets whether the following enchantment will be able
+ * to be found in dungeon chests or not.
+ * @default true
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setIsLootable(lootable: boolean): EnchantSetupInterface;
+
+ /**
+ * Sets whether the following enchantment will be able
+ * to be received on the enchanting table or not.
+ * @default true
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setIsDiscoverable(discoverable: boolean): EnchantSetupInterface;
+
+ /**
+ * Sets whether the following enchantment will be able
+ * to be caught during fishing as a treasure, or not.
+ * @default false
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setIsTreasure(treasure: boolean): EnchantSetupInterface;
+
+ /**
+ * Sets the mask of items, that the following enchantment can be applied to,
+ * paired parameter for item is enchant slot.
+ * @returns Reference to itself to be used in sequential calls.
+ * @default -1 = 0xFFFFFFFF // all
+ */
+ setMask(mask: number): EnchantSetupInterface;
+
+ /**
+ * Sets minimum and maximum level, that the following enchantment
+ * will be able to have in legal conditions.
+ * @default min: 1, max: 5
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setMinMaxLevel(min: number, max: number): EnchantSetupInterface;
+
+ /**
+ * Sets linear dependency of enchant cost by level,
+ * the formula is `level * b + c`.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setMinMaxCost(bMin: number, cMin: number, bMax: number, cMax: number): EnchantSetupInterface;
+
+ /**
+ * Defines the function that will be called, when item with following enchantment is used for attack.
+ * The function must return bonus damage dealt to the victim.
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ setAttackDamageBonusProvider(func: AttackDamageBonusProvider): EnchantSetupInterface;
+
+ /**
+ * Defines the function that will be called after the item with following enchantment is used for attack.
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ setPostAttackCallback(func: DamageCallback): EnchantSetupInterface;
+
+ /**
+ * Defines the function that will be called, when the entity wearing item
+ * with following enchantment, is hit.
+ * The function must return bonus protection value.
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ setProtectionBonusProvider(func: ProtectionBonusProvider): EnchantSetupInterface;
+
+ /**
+ * Defines the function that will be called, when the entity wearing item
+ * with following enchantment, is hit.
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.3.1b115 (implemented in 2.2.1b105)
+ */
+ setPostHurtCallback(func: DamageCallback): EnchantSetupInterface;
+
+ }
+
+ /**
+ * Registers new custom enchantment from given name ID and displayed name.
+ * @param nameID internal string ID of the enchantment
+ * @param displayedName enchantment name that will be displayed in the
+ * tooltips of the items having this enchant.
+ * Use {@link Translation} module to make localization of the displayed name
+ * @returns Object to work with different enchantment behaviors.
+ */
+ function newEnchant(nameID: string, displayedName: string): EnchantSetupInterface;
+
+ /**
+ * Function interface used in
+ * {@link EnchantSetupInterface.setAttackDamageBonusProvider EnchantSetupInterface.setAttackDamageBonusProvider} method.
+ */
+ interface AttackDamageBonusProvider {
+ (damage: number, entity: number): number;
+ }
+
+ /**
+ * Function interface used in
+ * {@link EnchantSetupInterface.setPostAttackCallback EnchantSetupInterface.setPostAttackCallback} and
+ * {@link EnchantSetupInterface.setPostHurtCallback EnchantSetupInterface.setPostHurtCallback} methods.
+ */
+ interface DamageCallback {
+ (item: ItemInstance, damage: number, entity1: number, entity2: number): void;
+ }
+
+ /**
+ * Function interface used in
+ * {@link EnchantSetupInterface.setProtectionBonusProvider EnchantSetupInterface.setProtectionBonusProvider} method.
+ */
+ interface ProtectionBonusProvider {
+ (damage: number, damageType: number, entity: number): number;
+ }
+
+}
\ No newline at end of file
diff --git a/api/core-engine/CustomEntity.d.ts b/api/core-engine/CustomEntity.d.ts
new file mode 100644
index 000000000..2e32e092d
--- /dev/null
+++ b/api/core-engine/CustomEntity.d.ts
@@ -0,0 +1,112 @@
+/**
+ * @deprecated Use behavior packs to creating entities.
+ */
+declare namespace MobRegistry {
+ function registerEntity(name: any): CustomEntity;
+
+ function registerUpdatableAsEntity(updatable: any): void;
+
+ function spawnEntityAsPrototype(typeName: any, coords: any, extraData: any): CustomEntity;
+
+ function getEntityUpdatable(entity: number): CustomEntity;
+
+ // /**
+ // * @deprecated Not implemented yet.
+ // */
+ // function registerNativeEntity(entity: number): undefined;
+
+ function registerEntityRemove(entity: number): void;
+
+ function resetEngine(): void;
+}
+
+/**
+ * @deprecated Use behavior packs to register spawning
+ * entities in server or use callbacks.
+ */
+declare namespace MobSpawnRegistry {
+ function registerSpawn(entityType: number, rarity: number, condition?: () => boolean, denyNaturalDespawn?: boolean): void;
+
+ interface SpawnInterface {
+ type: number,
+ rarity: number,
+ condition: () => boolean,
+ denyNaturalDespawn?: boolean;
+ }
+
+ function getRandomSpawn(rarityMultiplier: number): any;
+
+ function getRandPosition(): { x: number, z: number };
+
+ function executeSpawn(spawn: SpawnInterface, position: { x: number, z: number }): void;
+}
+
+/**
+ * @deprecated Use behavior packs instead.
+ */
+declare class CustomEntity {
+ readonly nameId: string;
+ readonly isInstance: boolean;
+ readonly entity: Nullable;
+ addController(name: string, basicPrototype: any): CustomEntity;
+ customizeController(name: string, customPrototype: object): void;
+ /**
+ * Customizes controller "event".
+ */
+ customizeEvents(custom: object): void;
+ /**
+ * Customizes controller "description".
+ */
+ customizeDescription(custom: object): void;
+ /**
+ * Customizes controller "visual".
+ */
+ customizeVisual(custom: object): void;
+ /**
+ * Customizes controller "AI".
+ */
+ customizeAI(custom: object): void;
+ setBaseType(type: number): void;
+ callControllerEvent(event: string, ...params: any[]): void;
+ setNativeEntity(entity: number): void;
+ recreateEntity(): void;
+ getPlayerDistance(): number;
+ denyDespawn(): void;
+ allowNaturalDespawn(): void;
+ destroy(): void;
+}
+
+/**
+ * @deprecated Use resource packs or {@link Render} instead.
+ */
+declare class EntityModel {
+ constructor(parentModel?: EntityModel);
+ readonly isAnimated: boolean;
+ readonly animator: any;
+ /**
+ * @internal
+ */
+ applyTextureResolution(): void;
+ setTexture(texture: Texture): EntityModel;
+ getTextureObj(): Texture;
+ getTexture(): string;
+ getTextureResolution(): number;
+ setRender(render: Render): void;
+ createAnimation(ticks: number, func: (tick: number, self: EntityModel) => Nullable, delay: number): EntityModel;
+ resetAnimation(token: number): void;
+ getTextureAndRender(token: number): { texture: Texture, render: number };
+}
+
+/**
+ * @deprecated Use resource packs to customize entities
+ * appearance or {@link Render} with {@link AttachableRender}.
+ */
+declare class EntityModelWatcher {
+ constructor(entity: number, model: EntityModel);
+ readonly model: EntityModel;
+ readonly entity: number;
+ readonly token: number;
+ update(): void;
+ resetAnimation(): void;
+ destroy(): void;
+}
diff --git a/api/core-engine/Debug.d.ts b/api/core-engine/Debug.d.ts
new file mode 100644
index 000000000..0b6bf7765
--- /dev/null
+++ b/api/core-engine/Debug.d.ts
@@ -0,0 +1,63 @@
+/**
+ * Defines some useful methods for debugging.
+ */
+declare namespace Debug {
+
+ /**
+ * @returns Current system time in milliseconds.
+ */
+ function sysTime(): number;
+
+ /**
+ * Spawns vanilla debug particle on the specified coordinates.
+ * @param id particle type ID, should be one of the {@link EParticleType}
+ * @param vx x velocity
+ * @param vy y velocity
+ * @param vz y velocity
+ * @param data additional particles data
+ */
+ function addParticle(id: number, x: number, y: number, z: number, vx: number, vy: number, vz: number, data: number): void;
+
+ /**
+ * Writes general debug message (in green) to local player in chat.
+ * @param message message to be displayed
+ */
+ function message(message: any): void;
+
+ /**
+ * Writes warning debug message (in gold) to local player in chat.
+ * @param message message to be displayed
+ */
+ function warning(message: any): void;
+
+ /**
+ * Writes error debug message (in red) to local player in chat.
+ * @param message message to be displayed
+ */
+ function error(message: any): void;
+
+ /**
+ * Writes several comma-separated values to local player in chat as
+ * a general debug message, serializing javascript objects if possible.
+ * @param args messages to be displayed
+ * @since 2.0.5b44
+ */
+ function m(...args: any[]): void;
+
+ /**
+ * Displays an {@link android.app.AlertDialog} with given title and bitmap.
+ * @param bitmap android.graphics.Bitmap object of the bitmap to be
+ * displayed
+ * @param title title of the AlertDialog
+ */
+ function bitmap(bitmap: android.graphics.Bitmap, title?: any): void;
+
+ /**
+ * Writes several values in JSON format to the selectable
+ * alert window text view, serializing javascript objects if possible.
+ * @param args messages to be displayed
+ * @since 2.0.5b44
+ */
+ function big(...args: any[]): void;
+
+}
diff --git a/api/core-engine/Dimensions.d.ts b/api/core-engine/Dimensions.d.ts
new file mode 100644
index 000000000..b51e78cd2
--- /dev/null
+++ b/api/core-engine/Dimensions.d.ts
@@ -0,0 +1,508 @@
+/**
+ * Namespace used to create and manipulate custom dimensions.
+ */
+declare namespace Dimensions {
+ /**
+ * Class representing custom dimension.
+ */
+ class CustomDimension {
+ /**
+ * Constructs a new dimension with specified name and preferred ID.
+ * @param name dimension name, can be used to get dimension via
+ * {@link Dimensions.getDimensionByName} call
+ * @param preferredId preferred dimension ID. If ID is already occupied
+ * by some another dimension, constructor will look for the next empty
+ * dimension ID and assign it to the current dimension
+ */
+ constructor(name: string, preferredId: number);
+
+ /**
+ * Custom dimension ID.
+ */
+ id: number;
+
+ /**
+ * Sets custom landscape generator.
+ * @param generator custom landscape generator used for current
+ * dimension
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setGenerator(generator: CustomGenerator): CustomDimension;
+
+ /**
+ * Specifies whether the sky produces light (like in overworld) or not
+ * (like in the End or Nether).
+ * @param hasSkyLight if true, the sky produces light in the dimension
+ * @returns Reference to itself to be used in sequential calls.
+ * @default true
+ */
+ setHasSkyLight(hasSkyLight: boolean): CustomDimension;
+
+ /**
+ * @returns Whether the sky produces light in the current dimension.
+ */
+ hasSkyLight(): boolean;
+
+ /**
+ * Sets sky color for the dimension in the RGB format. Default
+ * color is as in the Overworld.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setSkyColor(r: number, g: number, b: number): CustomDimension;
+
+ /**
+ * Resets sky color to the default value.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ resetSkyColor(): CustomDimension;
+
+ /**
+ * Sets fog color for the dimension in the RGB format. Default
+ * color is as in the Overworld.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setFogColor(r: number, g: number, b: number): CustomDimension;
+
+ /**
+ * Resets fog color to the default value.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ resetFogColor(): CustomDimension;
+
+ /**
+ * Sets clouds color for the dimension in the RGB format. Default
+ * color is as in the Overworld.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setCloudColor(r: number, g: number, b: number): CustomDimension;
+
+ /**
+ * Resets clouds color to the default value.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ resetCloudColor(): CustomDimension;
+
+ /**
+ * Sets sunset sky color for the dimension in the RGB format. Default
+ * color is as in the Overworld.
+ * @param r red color component, value from 0 to 1
+ * @param g green color component, value from 0 to 1
+ * @param b blue color component, value from 0 to 1
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setSunsetColor(r: number, g: number, b: number): CustomDimension;
+
+ /**
+ * Resets sunset sky color to the default value.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ resetSunsetColor(): CustomDimension;
+
+ /**
+ * Sets fog displaying distance.
+ * @param start nearest fog distance
+ * @param end farthest fog distance
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.0.2b20
+ */
+ setFogDistance(start: number, end: number): CustomDimension;
+
+ /**
+ * Resets fog displaying distance.
+ * @returns Reference to itself to be used in sequential calls.
+ * @since 2.0.2b20
+ */
+ resetFogDistance(): CustomDimension;
+ }
+
+ /**
+ * Class representing landscape generator used for the dimension.
+ */
+ class CustomGenerator {
+ /**
+ * Creates a new {@link Dimensions.CustomGenerator} instance using specified base type.
+ * @param baseType base generator type constant, can be from 0 to 4. 0
+ * and 1 represent overworld generator, 2 represents flat world
+ * generator, 3 represents nether generator and 4 represents end
+ * generator
+ */
+ constructor(baseType: number);
+
+ /**
+ * Creates a new {@link Dimensions.CustomGenerator} instance using specified base type.
+ * @param baseType base generator type constant, can be one of the
+ * following: "overworld", "overworld1", "flat", "nether", "end"
+ */
+ constructor(baseType: string);
+
+ /**
+ * Specifies whether to use vanilla biome surface cover blocks (grass,
+ * sand, podzol, etc.).
+ * @param value if `true`, vanilla surface will be generated
+ * @default false
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setBuildVanillaSurfaces(value: boolean): CustomGenerator;
+
+ /**
+ * Specifies whether to generate minecraft vanilla structures.
+ * @param value if `true`, vanilla structures will be generated
+ * @default false
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setGenerateVanillaStructures(value: boolean): CustomGenerator;
+
+ /**
+ * Specifies whether to use mod's generation callbacks.
+ * @param value if `true`, mod generation will be used
+ * @default true
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setGenerateModStructures(value: boolean): CustomGenerator;
+
+ /**
+ * Determines whether the generator should generate underground
+ * and/or underwater caves as part of its result.
+ * Wworks only with the "overworld"1" and "flat" base types.
+ * @param caves generate caves
+ * @param underwaterCaves generate large caves and canyons
+ * @since 2.3.1b115
+ */
+ setGenerateCaves(caves: boolean, underwaterCaves?: boolean): CustomDimension;
+
+ /**
+ * Sets terrain generator object used for the landscape generation.
+ * @param generator terrain generator to be used with current landscape
+ * generator or removes terrain generator, if the value is null
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setTerrainGenerator(generator: Nullable): CustomGenerator;
+
+ /**
+ * Specifies which of the generation {@link Callback Callbacks} to call, `-1` to call
+ * no mods generation, `0` to call overworld generation callback, `1` for nether,
+ * `2` for end generation callbacks.
+ * @param id generation callback to call
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setModGenerationBaseDimension(id: number): CustomGenerator;
+
+ /**
+ * Disables mods generation in current generator.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ removeModGenerationBaseDimension(): CustomGenerator;
+ }
+
+ /**
+ * Interface representing terrain generator. All terrain generators found
+ * in Inner Core API implement this interface.
+ */
+ interface AbstractTerrainGenerator {}
+
+ /**
+ * Class representing terrain that consists of single biome.
+ */
+ class MonoBiomeTerrainGenerator implements AbstractTerrainGenerator {
+ /**
+ * Constructs new {@link Dimensions.MonoBiomeTerrainGenerator MonoBiomeTerrainGenerator}
+ * instance with no terrain layers.
+ */
+ constructor();
+
+ addTerrainLayer(minY: number, maxY: number): TerrainLayer;
+
+ /**
+ * Sets base biome for the current terrain.
+ * @param id ID of the biome to be used as a single biome of the terrain
+ * layer
+ */
+ setBaseBiome(id: number): MonoBiomeTerrainGenerator;
+ }
+
+ /**
+ * Class representing single terrain layer that may consist of several noise
+ * layers.
+ */
+ interface TerrainLayer {
+ addNewMaterial(generator: NoiseGenerator, priority: number): TerrainMaterial;
+
+ setHeightmapNoise(generator: NoiseGenerator): TerrainLayer;
+
+ setMainNoise(generator: NoiseGenerator): TerrainLayer;
+
+ setYConversion(conversion: NoiseConversion): TerrainLayer;
+
+ getMainMaterial(): TerrainMaterial;
+ }
+
+ /**
+ * Class representing material that is used to generate terrain layer.
+ */
+ interface TerrainMaterial {
+
+ setBase(id: number, data: number): TerrainMaterial;
+
+ setCover(id: number, data: number): TerrainMaterial;
+
+ setSurface(width: number, id: number, data: number): TerrainMaterial;
+
+ setFilling(width: number, id: number, data: number): TerrainMaterial;
+
+ setDiffuse(value: number): TerrainMaterial;
+ }
+
+ /**
+ * Class representing noise conversion function. Used to define "density" of
+ * the landscape at a given height. Values between nodes are interpolated
+ * linearly.
+ */
+ class NoiseConversion {
+ constructor();
+
+ /**
+ * Adds a new node to the noise conversion function.
+ * @param x value from 0 to 1 representing the height of the block in the
+ * terrain layer
+ * @param y landscape density at a given height, generally can be between
+ * -0.5 and 0.5. Values between nodes are interpolated linearly
+ */
+ addNode(x: number, y: number): NoiseConversion;
+ }
+
+ /**
+ * Class representing multi-layer noise generator.
+ */
+ class NoiseGenerator {
+ constructor();
+
+ addLayer(layer: NoiseLayer): NoiseGenerator;
+
+ setConversion(conversion: NoiseConversion): NoiseGenerator;
+ }
+
+ /**
+ * Class representing single noise layer.
+ */
+ class NoiseLayer {
+ constructor();
+
+ addOctave(octave: NoiseOctave): NoiseLayer;
+
+ setConversion(conversion: NoiseConversion): NoiseLayer;
+ }
+
+ type NoiseOctaveStringType = "perlin" | "gray" | "chess" | "sine_x" | "sine_y" | "sine_z" | "sine_xy" | "sine_yz" | "sine_xz" | "sine_xyz";
+ /**
+ * Class representing noise octave. Each noise layer consists of multiple
+ * noise octaves of different scale and weight.
+ */
+ class NoiseOctave {
+ /**
+ * Creates a new noise octave of specified type.
+ * @param type numeric type constant or one of the following strings:
+ *
+ * **"perlin"** (0) is a general-purpose noise generator.
+ *
+ * Used to generate noise of completely random nature
+ * **"gray"** (1)
+ * **"chess"** (2)
+ *
+ * The following sine noises are used to generate sinusoidal noise.
+ * Generally they should be used with some noise octaves of other types to avoid
+ * too mathematical landscapes
+ * **"sine_x"** (10)
+ * **"sine_y"** (11)
+ * **"sine_z"** (12)
+ * **"sine_xy"** (13)
+ * **"sine_yz"** (14)
+ * **"sine_xz"** (15)
+ * **"sine_xyz"** (16)
+ */
+ constructor(type?: number | NoiseOctaveStringType);
+
+ setTranslate(x: number, y: number, z: number): NoiseOctave;
+
+ setScale(x: number, y: number, z: number): NoiseOctave;
+
+ setWeight(weight: number): NoiseOctave;
+
+ setSeed(x: number, y: number, z: number): NoiseOctave;
+
+ setConversion(conversion: NoiseConversion): NoiseOctave;
+ }
+
+ /**
+ * Overrides default generator of vanilla dimension.
+ * @param id vanilla dimension ID, one of the {@link EDimension}
+ * values
+ * @param generator custom landscape generator used for vanilla
+ * dimension
+ */
+ function overrideGeneratorForVanillaDimension(id: number, generator: CustomGenerator): void;
+
+ /**
+ * @param name dimension name
+ * @returns Dimension by it's string name specified in
+ * {@link Dimensions.CustomDimension CustomDimension} constructor.
+ */
+ function getDimensionByName(name: string): CustomDimension;
+
+ /**
+ * @param id dimension ID
+ * @returns Custom dimension by it's numeric ID.
+ */
+ function getDimensionById(id: number): CustomDimension;
+
+ /**
+ * @param id dimension ID
+ * @returns `true`, if dimension is a limbo dimension; limbo dimension is
+ * created by Horizon automatically if you try to teleport the player to
+ * non-existing dimension
+ */
+ function isLimboId(id: number): boolean;
+
+ /**
+ * Transfers specified entity to the dimension with specified ID.
+ * @param entity numeric ID of the
+ * @param dimensionId numeric ID of the dimension to transfer the entity to
+ */
+ function transfer(entity: number, dimensionId: number): void;
+
+ /**
+ * @returns JS object instance, containing all registered custom biomes.
+ * @since 2.2.1b93
+ */
+ function getAllRegisteredCustomBiomes(): { [key: string]: CustomBiome };
+
+ /**
+ * Function used to simplify the creation of terrain generator by passing
+ * a json-like structure as a single generator parameter.
+ * @param description object containing all the required generator information
+ */
+ function newGenerator(description: {
+ /**
+ * Specifies base generator, see {@link Dimensions.CustomGenerator CustomGenerator}
+ * constructor for details.
+ */
+ base?: number | string,
+
+ /**
+ * Specifies whether to use vanilla biome surface cover blocks
+ * (grass, sand, podzol, etc.).
+ *
+ * See {@link Dimensions.CustomGenerator.setBuildVanillaSurfaces setBuildVanillaSurfaces} for details.
+ */
+ buildVanillaSurfaces?: boolean,
+
+ /**
+ * Specifies whether to generate minecraft vanilla structures.
+ *
+ * See {@link Dimensions.CustomGenerator.setGenerateVanillaStructures setGenerateVanillaStructures} for details.
+ */
+ generateVanillaStructures?: boolean,
+
+ /**
+ * Can be either string for an existing dimensions (**"overworld"**,
+ * **"nether"**, **"end"**) or -1 to disable mods generation.
+ *
+ * See {@link Dimensions.CustomGenerator.setModGenerationBaseDimension setModGenerationBaseDimension} for details.
+ */
+ modWorldgenDimension?: number | string,
+
+ /**
+ * Specifies what generator type to use. Default and the only currently
+ * available option is "mono", that is equivalent to creating a
+ * {@link MonoBiomeTerrainGenerator}.
+ */
+ type?: string,
+
+ /**
+ * Sets base biome for the current terrain, applicable only to **"mono"**.
+ */
+ biome?: number,
+
+ /**
+ * An array of terrain layers descriptions, each one representing it's
+ * own terrain layer.
+ *
+ * See {@link Dimensions.MonoBiomeTerrainGenerator.addTerrainLayer MonoBiomeTerrainGenerator.addTerrainLayer} for details.
+ */
+ layers?: TerrainLayerParams[]
+
+ }): CustomGenerator;
+
+ interface TerrainLayerParams {
+ minY: number,
+ maxY: number,
+ noise?: NoiseOctaveParams | NoiseLayerParams | NoiseGeneratorParams,
+ heightmap?: NoiseOctaveParams | NoiseLayerParams | NoiseGeneratorParams,
+ yConversion?: NoiseConversionParams,
+ material?: TerrainMaterialParams,
+ materials?: TerrainMaterialParams[],
+ }
+
+ interface TerrainMaterialParams {
+ noise?: NoiseOctaveParams | NoiseLayerParams | NoiseGeneratorParams,
+ base?: MaterialBlockData,
+ cover?: MaterialBlockData,
+ surface?: MaterialBlockData,
+ filling?: MaterialBlockData,
+ diffuse?: number
+ }
+
+ interface NoiseGeneratorParams {
+ layers: NoiseLayerParams[],
+ conversion?: NoiseConversionParams,
+ }
+
+ interface NoiseLayerParams {
+ octaves: NoiseOctaveParams[] | {
+ count?: number,
+ seed?: number,
+ weight?: number,
+ weight_factor?: number,
+ scale_factor?: number,
+ scale?: number
+ },
+ conversion?: NoiseConversionParams
+ }
+
+ interface NoiseOctaveParams {
+ /**
+ * Noise octave type, see {@link Dimensions.NoiseOctave} for details.
+ * @default "perlin"
+ */
+ type?: number | string,
+ scale?: Vec3Data,
+ weight?: number,
+ seed?: number,
+ conversion?: NoiseConversionParams
+ }
+
+ type NoiseConversionParams = string | Vec2Data[];
+
+ type MaterialBlockData =
+ [number, number?, number?] |
+ { id: number, data?: number, width?: number } |
+ number;
+
+ type Vec3Data =
+ [number, number, number] |
+ { x: number, y: number, z: number } |
+ number;
+
+ type Vec2Data =
+ [number, number] |
+ { x: number, y: number } |
+ number
+}
diff --git a/api/core-engine/ECS.d.ts b/api/core-engine/ECS.d.ts
new file mode 100644
index 000000000..451a6c64e
--- /dev/null
+++ b/api/core-engine/ECS.d.ts
@@ -0,0 +1,200 @@
+/**
+ * @since 2.3.1b115
+ */
+declare namespace ECS {
+ function getEntityManager(): EcsEntityManager;
+ function getTypeName(id: number): string;
+ function getTypeId(name: string): number;
+ /**
+ * Same as {@link ECS_INVALID_ENTITY}.
+ */
+ function getInvalidEntity(): number;
+ /**
+ * Same as {@link ECS_TAG_OBJECT}.
+ */
+ function getTagComponentObject(): any;
+
+ interface LocalTicking {
+ tick(queue: EcsActionQueue): void;
+ }
+
+ interface ServerTicking {
+ tick(queue: EcsActionQueue): void;
+ }
+
+ interface VariadicQueryConsumer {
+ (entity: number, components: any[]): void;
+ }
+
+ interface FixedQueryConsumer0 {
+ (entity: number): void;
+ }
+
+ interface FixedQueryConsumer1 {
+ (entity: number, query1: T1): void;
+ }
+
+ interface FixedQueryConsumer2 {
+ (entity: number, query1: T1, query2: T2): void;
+ }
+
+ interface FixedQueryConsumer3 {
+ (entity: number, query1: T1, query2: T2, query3: T3): void;
+ }
+
+ interface FixedQueryConsumer4 {
+ (entity: number, query1: T1, query2: T2, query3: T3, query4: T4): void;
+ }
+
+ interface FixedQueryConsumer5 {
+ (entity: number, query1: T1, query2: T2, query3: T3, query4: T4, query5: T5): void;
+ }
+
+ interface FixedQueryConsumer6 {
+ (entity: number, query1: T1, query2: T2, query3: T3, query4: T4, query5: T5, query6: T6): void;
+ }
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare interface EcsEntityManager {
+ /* static */ INVALID_ENTITY: number;
+ /* static */ TAG: java.lang.Object;
+ createEntity(): number;
+ removeEntity(entity: number): void;
+ detachEntity(entity: number): EcsAddComponents;
+ extend(entity: number, components: EcsAddComponents): void;
+ shrink(entity: number, components: EcsRemoveComponents): void;
+ removeAllEntitiesWithComponents(query: EcsQuery): void;
+ performVariadicQuery(query: EcsQuery, consumer: ECS.VariadicQueryConsumer): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer0): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer1): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer2): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer3): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer4): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer5): void;
+ performQuery(query: EcsQuery, consumer: ECS.FixedQueryConsumer6): void;
+ getComponents(entity: number, query: EcsQuery): any[];
+ getComponent(entity: number, index: number): any;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare class IntFlatMap {
+ constructor();
+ constructor(emptyKey: number);
+ get(key: number, defaultValue: number): number;
+ put(key: number, value: number): boolean;
+ remove(key: number): boolean;
+ clearNoDealloc(): void;
+ clear(): void;
+ reserve(newCount: number): void;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare class EcsQuery {
+ constructor(...queries: object[]);
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare class EcsAddComponents {
+ constructor();
+ addComponent(type: number | string, value: any): EcsAddComponents;
+ addComponent(type: java.lang.Class, value: T): EcsAddComponents;
+ setTypes(...types: number[] | string[]): EcsAddComponents;
+ setTypes(...types: java.lang.Class[]): EcsAddComponents;
+ setValues(...values: object[]): EcsAddComponents;
+ empty(): boolean;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare class EcsRemoveComponents {
+ constructor();
+ addComponent(type: number | string): EcsRemoveComponents;
+ addComponent(type: java.lang.Class): EcsRemoveComponents;
+ setTypes(...types: number[] | string[]): EcsRemoveComponents;
+ setTypes(...types: java.lang.Class[]): EcsRemoveComponents;
+ empty(): boolean;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare class EcsActionQueue {
+ constructor();
+ createEntity(): number;
+ getEntityCount(): number;
+ removeEntity(entity: number): EcsActionQueue;
+ addComponent(entity: number, type: number | string, value: any): EcsActionQueue;
+ addComponent(entity: number, type: java.lang.Class, value: any): EcsActionQueue;
+ extend(entity: number, components: EcsAddComponents): EcsActionQueue;
+ extend(entity: number, types: number[], values: any[], count: number): EcsActionQueue;
+ removeComponent(entity: number, type: number | string): EcsActionQueue;
+ removeComponent(entity: number, type: java.lang.Class): EcsActionQueue;
+ shrink(entity: number, components: EcsRemoveComponents): EcsActionQueue;
+ shrink(entity: number, types: number[], count: number): EcsActionQueue;
+ flush(): void;
+ clear(): void;
+ /**
+ * Does {@link flush}() and {@link clear}() at same time.
+ */
+ flushNoClear(): void;
+ reserve(entityCount: number): void;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare interface EcsComponent {
+ /* static */ COMPONENT_ID: number
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare interface EcsBlockComponent extends EcsComponent {
+ id: number;
+ nameId: string;
+ name: string;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare interface EcsItemComponent extends EcsComponent {
+ id: number;
+ nameId: string;
+ name: string;
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare interface EcsArmorItemComponent extends EcsComponent, Armor.IArmorInfo {
+ slot: number;
+ protection: number;
+ kbResist: number; // knockback
+}
+
+/**
+ * @since 2.3.1b115
+ */
+declare const EntityManager: EcsEntityManager;
+
+/**
+ * @since 2.3.1b115
+ */
+declare const ECS_INVALID_ENTITY: object;
+
+/**
+ * @since 2.3.1b115
+ */
+declare const ECS_TAG_OBJECT: object;
diff --git a/api/core-engine/Entity.d.ts b/api/core-engine/Entity.d.ts
new file mode 100644
index 000000000..3360a64e8
--- /dev/null
+++ b/api/core-engine/Entity.d.ts
@@ -0,0 +1,1002 @@
+/**
+ * Module used to manipulate entities (mobs, drop, arrows, etc.) in the world.
+ * Every entity has it's unique numeric ID which is often used across this module
+ * as the first function parameter.
+ */
+declare namespace Entity {
+ /**
+ * @returns An array of all server entities UIDs.
+ */
+ function getAll(): number[];
+
+ /**
+ * @returns An array of all server entities UIDs.
+ * @deprecated Consider using {@link Entity.getAll} instead.
+ */
+ function getAllJS(): number[];
+
+ /**
+ * @returns An array of all client entities UIDs.
+ * @since 2.4.0b120
+ */
+ function getAllLocal(): number[];
+
+ /**
+ * @deprecated Use attributes instead, or {@link Saver}.
+ */
+ function getExtra(entityUid: number, name: string): null;
+
+ /**
+ * @deprecated Use attributes instead, or {@link Saver}.
+ */
+ function putExtra(entityUid: number, name: string, extra?: object): void;
+
+ /**
+ * @deprecated Use attributes instead, or {@link Saver}.
+ */
+ function getExtraJson(entityUid: number, name: string): object;
+
+ /**
+ * @deprecated Use attributes instead, or {@link Saver}.
+ */
+ function putExtraJson(entityUid: number, name: string, obj: object): void;
+
+ /**
+ * Adds an effect to entity.
+ * @param effectId effect ID, should be one one of {@link EPotionEffect} values
+ * @param effectData effect amplifier
+ * @param effectTime effect time in ticks
+ * @param ambience if true, particles are ambient
+ * @param particles if true, particles are not displayed
+ */
+ function addEffect(entityUid: number, effectId: number, effectData: number, effectTime: number, ambience?: boolean, particles?: boolean): void;
+
+ /**
+ * Adds an effect to entity.
+ * @param effectId effect ID, should be one one of {@link EPotionEffect} values
+ * @param effectData effect amplifier
+ * @param effectTime effect time in ticks
+ * @param ambience if true, particles are ambient
+ * @param particles if true, particles are not displayed
+ * @param effectAnimation if true, flashing are displayed
+ * @since 2.3.1b116
+ */
+ function addEffect(entityUid: number, effectId: number, effectData: number, effectTime: number, ambience: boolean, particles: boolean, effectAnimation: boolean): void;
+
+ /**
+ * @param effectId numeric ID of the potion effect,
+ * one of {@link EPotionEffect} values
+ * @returns Whether the given entity is affected by the potion effect with given numeric ID.
+ * @since 2.2.1b102
+ */
+ function hasEffect(entity: number, effectId: number): boolean;
+
+ /**
+ * @returns Object with duration and level of the potion effect with given numeric ID
+ * on the given entity. These fields are set to 0, if the given effect doesn't affect
+ * the given entity at the moment.
+ * @since 2.2.1b102
+ */
+ function getEffect(entity: number, effectId: number): EffectInstance;
+
+ interface EffectInstance {
+ level: number;
+ duration: number;
+ }
+
+ /**
+ * Clears effect, applied to the mob.
+ * @param id effect ID, should be one of the {@link EPotionEffect}
+ */
+ function clearEffect(entityUid: number, id: number): void;
+
+ /**
+ * Clears all effects of the mob.
+ */
+ function clearEffects(entityUid: number): void;
+
+ /**
+ * Damage sources, which are used to determine entity damage type:
+ *
+ * Type | Name | Message | Translation
+ * ---|---|---|---
+ * 0 | Generic | "death.attack.generic" (fallback damage source) | * died
+ * 1 | Cactus | "death.attack.cactus" (only when standing on cactus) | * was pricked to death
+ * 2 | Mob | "death.attack.mob" | * was slain by *
+ * 3 | Impact | n/a
+ * 4 | In Wall | "death.attack.inWall" | * suffocated in a wall
+ * 5 | Fall | "death.attack.fall" OR "death.fell.accident.generic" | * hit the ground too hard OR * fell from a high place
+ * 6 | In Fire | "death.attack.inFire" | * went up in flames
+ * 7 | On Fire | "death.attack.onFire" | * burned to death
+ * 8 | Lava | "death.attack.lava" | * tried to swim in lava
+ * 9 | Drown | "death.attack.drown" | * drowned
+ * 10 | Explosion | "death.attack.explosion" | * blew up
+ * 11 | Explosion (Player) | "death.attack.explosion" | * was blown up by *
+ * 12 | Out Of World | "death.attack.outOfWorld" | * fell out of the world
+ * 13 | Command | n/a
+ * 14 | Magic | "death.attack.magic" | * was killed by magic
+ * 15 | Wither | "death.attack.wither" | * withered away
+ * 16 | Starve | "death.attack.starve" | * starved to death
+ * 17 | Anvil | "death.attack.anvil" | * was squashed by a falling anvil
+ * 18 | Thorns | "death.attack.thorns" | * was killed trying to hurt *
+ * 19 | Projectile | n/a
+ * 20 | Falling Block | "death.attack.fallingBlock" | * was squashed by a falling block
+ * 21 | Fly Into Wall | "death.attack.flyIntoWall" | * experienced kinetic energy
+ * 22 | Magma | "death.attack.magma" | * discovered floor was lava
+ * 23 | Fireworks | "death.attack.fireworks" | * went off with a bang
+ * 24 | Lightning Bolt | "death.attack.lightningBolt" | * was struck by lightning
+ */
+ type DamageSource = number;
+
+ /**
+ * Damages entity.
+ * @param damage damage value in half-hearts
+ * @param cause existing {@link DamageSource} or any inclusive value between 25 and 32
+ * @param properties additional damage source properties
+ */
+ function damageEntity(entityUid: number, damage: number, cause?: DamageSource, properties?: {
+ /**
+ * Entity that caused damage, determines actor of damage source.
+ */
+ attacker?: number,
+ /**
+ * If `true`, damage can be reduced by armor.
+ */
+ bool1?: boolean
+ }): void;
+
+ /**
+ * Adds specified health amount to the entity.
+ * @param heal health to be added to entity, in half-hearts
+ */
+ function healEntity(entityUid: number, heal: number): void;
+
+ /**
+ * @returns Numeric entity type, one of the {@link EEntityType}.
+ */
+ function getType(entityUid: number): number;
+
+ /**
+ * @returns String entity type, like `minecraft:chicken<>` (`:[]`).
+ */
+ function getTypeName(entityUid: number): string;
+
+ /**
+ * @returns String type for entities defined via add-ons or numeric type for
+ * all the other entities.
+ */
+ function getTypeUniversal(entityUid: number): number | string;
+
+ /**
+ * @returns String type for entities defined via add-ons, otherwise `null`.
+ * @remarks
+ * Includes only entities spawned locally (with {@link Entity.spawnAddon}),
+ * test entities manually with {@link Entity.getTypeName} or use {@link BlockSource.listEntitiesInAABB}
+ * with appropriate arguments.
+ */
+ function getTypeAddon(entityUid: number): Nullable;
+
+ /**
+ * @returns Compound tag for the specified entity.
+ * @since 2.0.5b44
+ */
+ function getCompoundTag(entityUid: number): Nullable;
+
+ /**
+ * Sets compound tag for the specified entity.
+ * @since 2.0.5b44
+ */
+ function setCompoundTag(entityUid: number, tag: NBT.CompoundTag): void;
+
+ /**
+ * Sets hitbox to the entity. Hitboxes defines entity collisions
+ * between terrain and themselves (e.g. physics).
+ * @param w hitbox width and length
+ * @param h hitbox height
+ */
+ function setHitbox(entityUid: number, w: number, h: number): void;
+
+ /**
+ * @returns `true` if specified entity is loaded within any player chunks
+ * (not despawned or unloaded) and identifier is valid.
+ */
+ function isExist(entityUid: number): boolean;
+
+ /**
+ * @returns Current dimension numeric ID, one of the {@link EDimension}
+ * values or custom dimension ID.
+ * @since 2.0.4b35
+ */
+ function getDimension(entityUid: number): number;
+
+ /**
+ * Spawns vanilla entity on the specified coordinates.
+ * @param type numeric entity type, one of the {@link EEntityType}
+ * @param skin skin to set for the entity. Leave empty or null to use
+ * default skin of the mob
+ * @returns Numeric ID of spawn entity or -1 if entity was not created.
+ * @deprecated Client-side method, use {@link BlockSource.spawnEntity} instead.
+ */
+ function spawn(x: number, y: number, z: number, type: number, skin?: Nullable): number;
+
+ /**
+ * Same as {@link Entity.spawn}, but uses {@link Vector} object to represent
+ * coordinates.
+ * @deprecated Client-side method, use {@link BlockSource.spawnEntity} instead.
+ */
+ function spawnAtCoords(coords: Vector, type: number, skin?: string): void;
+
+ /**
+ * Spawns custom entity on the specified coords. Allows to pass some values
+ * to controllers via extra param.
+ * @param name custom entity string ID
+ * @param extra object that contains some data for the controllers
+ * @deprecated You are should implement addon entity and spawn it with
+ * {@link BlockSource.spawnEntity} instead.
+ */
+ function spawnCustom(name: string, x: number, y: number, z: number, extra?: object): CustomEntity;
+
+ /**
+ * Same as {@link Entity.spawnCustom}, but uses {@link Vector} object to represent
+ * coordinates.
+ * @deprecated You are should implement addon entity and spawn it with
+ * {@link BlockSource.spawnEntity} instead.
+ */
+ function spawnCustomAtCoords(name: string, coords: Vector, extra?: any): CustomEntity;
+
+ /**
+ * Spawns custom entity defined in behavior packs or game itself.
+ * @returns Instance to performing commands on entity.
+ * @deprecated Client-side method, use {@link BlockSource.spawnEntity} instead.
+ */
+ function spawnAddon(x: number, y: number, z: number, name: string): AddonEntityRegistry.AddonEntity;
+
+ /**
+ * Same as {@link Entity.spawnAddon}, but uses {@link Vector} object to represent
+ * coordinates.
+ * @returns Instance to performing commands on entity.
+ * @deprecated Client-side method, use {@link BlockSource.spawnEntity} instead.
+ */
+ function spawnAddonAtCoords(coords: Vector, name: string): AddonEntityRegistry.AddonEntity;
+
+ /**
+ * @returns Instance to performing commands on requested addon
+ * entity if it spawned by Inner Core or `null` instead.
+ * @remarks
+ * Includes only entities spawned locally (with {@link Entity.spawnAddon}).
+ */
+ function getAddonEntity(entity: number): Nullable;
+
+ /**
+ * Removes entity from the world.
+ */
+ function remove(entityUid: number): void;
+
+ /**
+ * @returns Custom entity object by it's numeric entity UID.
+ * @deprecated Not supported anymore, use behavior packs.
+ */
+ function getCustom(entityUid: number): CustomEntity;
+
+ /**
+ * @deprecated Use attributes instead.
+ */
+ function getAge(entityUid: number): number;
+
+ /**
+ * @deprecated Use attributes instead.
+ */
+ function setAge(entityUid: number, age: number): void;
+
+ /**
+ * @deprecated Use NBT instead.
+ */
+ function getSkin(entityUid: number): string;
+
+ /**
+ * Sets mob skin.
+ * @param skin skin name, full path in the resourcepack (mod assets)
+ * @deprecated Use NBT or resource packs instead.
+ */
+ function setSkin(entityUid: number, skin: string): void;
+
+ /**
+ * Sets mob skin, uses {@link Texture} object.
+ * @deprecated Use NBT or resource packs instead.
+ */
+ function setTexture(entityUid: number, texture: Texture): void;
+
+ /**
+ * @returns Entity render type, should be one of the
+ * {@link EMobRenderType} values.
+ * @deprecated Use resource packs instead.
+ */
+ function getRender(entityUid: number): number;
+
+ /**
+ * Sets entity render type.
+ * @param render entity render type, should be one of the
+ * {@link EMobRenderType} values
+ * @deprecated Use resource packs instead.
+ */
+ function setRender(entityUid: number, render: number): void;
+
+ /**
+ * Makes rider ride entity.
+ * @param entityUid ridden entity
+ * @param riderUid rider entity
+ */
+ function rideAnimal(entityUid: number, riderUid: number): void;
+
+ /**
+ * @returns Entity name tag or player name.
+ * @since 2.2.1b97 (not working before)
+ */
+ function getNameTag(entityUid: number): string;
+
+ /**
+ * Sets custom entity name tag. Custom entity tags are
+ * displayed above the entities and can be set by player
+ * using label.
+ * @param tag name tag to be set to the entity
+ */
+ function setNameTag(entityUid: number, tag: string): void;
+
+ /**
+ * Gets the attack target of current entity.
+ * @returns Target entity's unique ID.
+ */
+ function getTarget(entityUid: number): number;
+
+ /**
+ * Sets the attack target for current entity. Works only for mobs that
+ * actually can attack.
+ * @param targetUid target entity's unique ID
+ */
+ function setTarget(entityUid: number, targetUid: number): void;
+
+ /**
+ * @returns `true`, if entity was immobilized.
+ * @since 2.3.1b116-3
+ */
+ function getMobile(entityUid: number): boolean;
+
+ /**
+ * Sets entity's immobile state.
+ * @param mobile if `true`, entity can move, otherwise it is immobilized
+ */
+ function setMobile(entityUid: number, mobile: boolean): void;
+
+ /**
+ * @returns `true` if entity is sneaking, `false` otherwise.
+ */
+ function getSneaking(entityUid: number): boolean;
+
+ /**
+ * Sets entity's sneaking state, supported slightly
+ * entities, resource pack render controlling it.
+ * @param sneak if `true`, entity becomes sneaking, else not
+ */
+ function setSneaking(entityUid: number, sneak: boolean): void;
+
+ /**
+ * @returns Entity that is riding the specified entity.
+ */
+ function getRider(entityUid: number): number;
+
+ /**
+ * @returns Entity that is ridden by specified entity.
+ */
+ function getRiding(entityUid: number): number;
+
+ /**
+ * Puts entity on fire.
+ * @param fire duration (in ticks) of the fire
+ * @param force should always be true
+ */
+ function setFire(entityUid: number, fire: number, force: boolean): void;
+
+ /**
+ * @returns An object that allows to manipulate entity health.
+ * @deprecated Consider using {@link Entity.getHealth}, {@link Entity.setHealth},
+ * {@link Entity.getMaxHealth} and {@link Entity.setMaxHealth} instead.
+ */
+ function health(entityUid: number): EntityHealth;
+
+ /**
+ * Class used to manipulate entity's health.
+ * @deprecated Consider using {@link Entity.getHealth}, {@link Entity.setHealth},
+ * {@link Entity.getMaxHealth} and {@link Entity.setMaxHealth} instead.
+ */
+ class EntityHealth {
+ /**
+ * @returns Entity's current health value.
+ * @throws No such method.
+ */
+ get(): number;
+
+ /**
+ * Sets entity's current health value.
+ * @param health health value to be set
+ * @throws No such method.
+ */
+ set(health: number): void;
+
+ /**
+ * @returns Entity's maximum health value.
+ * @throws No such method.
+ */
+ getMax(): number;
+
+ /**
+ * Sets entity's maximum health value.
+ * @throws No such method.
+ */
+ setMax(maxHealth: number): void;
+ }
+
+ /**
+ * @returns Entity's current health value.
+ */
+ function getHealth(entityUid: number): number;
+
+ /**
+ * Sets entity's current health value.
+ * @param health health value to be set
+ */
+ function setHealth(entityUid: number, health: number): void;
+
+ /**
+ * @returns Entity's maximum health value.
+ */
+ function getMaxHealth(entityUid: number): number;
+
+ /**
+ * Sets entity's maximum health value.
+ */
+ function setMaxHealth(entityUid: number, health: number): void;
+
+ /**
+ * Sets the specified coordinates as a new position for the entity.
+ * No checks are performed.
+ */
+ function setPosition(entityUid: number, x: number, y: number, z: number): void;
+
+ /**
+ * @returns Entity position.
+ */
+ function getPosition(entityUid: number): Vector;
+
+ /**
+ * Updates current entity position by specified coordinates.
+ */
+ function addPosition(entityUid: number, x: number, y: number, z: number): void;
+
+ /**
+ * Set current entity's velocity using velocity vector.
+ */
+ function setVelocity(entityUid: number, x: number, y: number, z: number): void;
+
+ /**
+ * Get current entity's velocity using velocity vector.
+ * @returns Containing current entity's velocity.
+ */
+ function getVelocity(entityUid: number): Vector;
+
+ /**
+ * Updates current entity's velocity by specified value.
+ */
+ function addVelocity(entityUid: number, x: number, y: number, z: number): void;
+
+ /**
+ * @returns Distance in blocks between the two coordinate sets.
+ */
+ function getDistanceBetweenCoords(coords1: Vector, coords2: Vector): number;
+
+ /**
+ * @returns Distance between specified entity and a fixed coordinate set.
+ */
+ function getDistanceToCoords(entityUid: number, coords: Vector): number;
+
+ /**
+ * @returns Distance in blocks between two entities.
+ */
+ function getDistanceToEntity(ent1: number, ent2: number): number;
+
+ /**
+ * @returns Distance between player and entity, counting only x and z values
+ * (y value is ignored).
+ */
+ function getXZPlayerDis(entityUid: number): number;
+
+ /**
+ * @returns Entity's look angle in radians.
+ */
+ function getLookAngle(entityUid: number): LookAngle;
+
+ /**
+ * Sets specified pitch and yaw as look angle for the entity.
+ * @param yaw look angle yaw in radians
+ * @param pitch look angle pitch in radians
+ */
+ function setLookAngle(entityUid: number, yaw: number, pitch: number): void;
+
+ /**
+ * Transforms look angle into look vector.
+ * @param angle look angle to transform into {@link Vector}
+ * @returns Transformation result.
+ */
+ function getLookVectorByAngle(angle: LookAngle): Vector;
+
+ /**
+ * @returns Look vector for the entity.
+ */
+ function getLookVector(entityUid: number): Vector;
+
+ /**
+ * @returns Look angle between entity and static coordinates.
+ */
+ function getLookAt(entityUid: number, x: number, y: number, z: number): LookAngle;
+
+ /**
+ * Sets entity look angle to look at specified coordinates.
+ */
+ function lookAt(entityUid: number, x: number, y: number, z: number): void;
+
+ /**
+ * Same as {@link Entity.lookAt} but uses Vector as param type.
+ * @param coords
+ */
+ function lookAtCoords(entityUid: number, coords: Vector): void;
+
+ /**
+ * Makes entity move to the target coordinates.
+ * @param params additional move parameters
+ */
+ function moveToTarget(entityUid: number, target: Vector, params: MoveParams): void;
+
+ /**
+ * Makes entity move using pitch/yaw angle to determine direction.
+ * @param angle angle to define entity's direction
+ * @param params additional move parameters
+ */
+ function moveToAngle(entityUid: number, angle: LookAngle, params: MoveParams): void;
+
+ /**
+ * Makes entity move towards it's current look angle.
+ * @param params additional move parameters
+ */
+ function moveToLook(entityUid: number, params: MoveParams): void;
+
+ /**
+ * Interface used to specify how entity should move.
+ */
+ interface MoveParams {
+ /**
+ * Movement speed.
+ */
+ speed?: number,
+
+ /**
+ * If `true`, entity won't change it's Y velocity.
+ */
+ denyY?: boolean,
+
+ /**
+ * Y velocity (jump speed).
+ */
+ jumpVel?: number
+ }
+
+ /**
+ * Retrieves entity's current movement information.
+ * @returns Object that contains normalized moving vector, moving speed and
+ * moving xz speed (with no Y coordinate).
+ */
+ function getMovingVector(entityUid: number): MovingVector;
+
+ /**
+ * Interface used to return entity's current moving vector and some
+ * additional data.
+ */
+ interface MovingVector {
+ /**
+ * Normalized vector X coordinate.
+ */
+ x: number,
+
+ /**
+ * Normalized vector Y coordinate.
+ */
+ y: number,
+
+ /**
+ * Normalized vector Z coordinate.
+ */
+ z: number,
+
+ /**
+ * Vector real length.
+ */
+ size: number,
+
+ /**
+ * Vector real length excluding Y coordinate.
+ */
+ xzsize: number
+ }
+
+ /**
+ * Retrieves entity look angle in the form of pitch/yaw angle. No other
+ * information included to the resulting object.
+ */
+ function getMovingAngle(entityUid: number): LookAngle;
+
+ /**
+ * @deprecated Nothing to perform here anymore.
+ */
+ function getMovingAngleByPositions(pos1: any, pos2: any): undefined;
+
+ /**
+ * Retrieves nearest to the coordinates entity of the specified entity type.
+ * @param coords search range center coordinates
+ * @param type entity type ID. Parameter is no longer supported and should
+ * be 0 in all cases
+ * @param maxRange if specified, determines search radius
+ * @remarks
+ * Overheating method, capture entities by {@link BlockSource.fetchEntitiesInAABB}
+ * and pass over them by checking radius between coords and entity.
+ */
+ function findNearest(coords: Vector, type?: number, maxRange?: number): Nullable;
+
+ /**
+ * Returns array of all entities numeric IDs in given range in blocks.
+ * @param coords search range center coordinates
+ * @param maxRange determines search radius
+ * @param type entity type ID
+ * @remarks
+ * Overheating method, capture entities by {@link BlockSource.fetchEntitiesInAABB}
+ * and pass over them by checking radius between coords and entity.
+ */
+ function getAllInRange(coords: Vector, maxRange: number, type?: number): number[];
+
+ /**
+ * @deprecated Consider use {@link Entity.getCarriedItem} instead.
+ */
+ function getInventory(entityUid: number, handleNames?: boolean, handleEnchant?: boolean): void;
+
+ /**
+ * @param slot armor slot index, should be one of the {@link EArmorType}
+ * values
+ * @returns Armor slot contents for entity.
+ */
+ function getArmorSlot(entityUid: number, slot: number): ItemInstance;
+
+ /**
+ * Sets armor slot contents for the entity.
+ * @param slot armor slot index, should be one of the {@link EArmorType}
+ * values
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ */
+ function setArmorSlot(entityUid: number, slot: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * @returns Entity's current carried item information.
+ */
+ function getCarriedItem(entityUid: number): ItemInstance;
+
+ /**
+ * Sets current carried item for the entity.
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ */
+ function setCarriedItem(entityUid: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * @returns Entity's current offhand item information.
+ */
+ function getOffhandItem(entityUid: number): ItemInstance;
+
+ /**
+ * Sets current offhand item for the entity.
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ * @since 2.2.1b93 (not working before)
+ */
+ function setOffhandItem(entityUid: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * Gets item from specified drop entity
+ * @returns Instance that is in the dropped item.
+ */
+ function getDroppedItem(entityUid: number): ItemInstance;
+
+ /**
+ * Sets item to the specified drop entity
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ */
+ function setDroppedItem(entityUid: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * @deprecated Use callbacks and {@link Entity.getAll} instead.
+ */
+ function getProjectileItem(projectile: number): ItemInstance;
+
+ type Attribute = "minecraft:follow_range" | "minecraft:luck" | "minecraft:lava_movement" | "minecraft:underwater_movement" | "minecraft:movement" | "minecraft:knockback_resistance" | "minecraft:absorption" | "minecraft:health" | "minecraft:attack_damage" | "minecraft:jump_strength";
+
+ /**
+ * Creates an object used to change entity's attributes.
+ * @param entityUid entity uid
+ * @param attribute one of {@link Attribute} or your custom one
+ * @returns Object used to manipulate entity's attributes.
+ * @since 2.0.3b33
+ */
+ function getAttribute(entityUid: number, attribute: Attribute | string): AttributeInstance;
+
+ /**
+ * Interface used to modify attribute values.
+ * @since 2.0.3b33
+ */
+ interface AttributeInstance {
+
+ /**
+ * @returns Current attribute's value.
+ */
+ getValue(): number;
+
+ /**
+ * @returns Attribute's maximum value.
+ */
+ getMaxValue(): number;
+
+ /**
+ * @returns Attribute's minimum value.
+ */
+ getMinValue(): number;
+
+ /**
+ * @returns Attribute's default value
+ */
+ getDefaultValue(): number;
+
+ /**
+ * Sets current attribute's value.
+ */
+ setValue(value: number): void;
+
+ /**
+ * Sets attribute's maximum value.
+ */
+ setMaxValue(value: number): void;
+
+ /**
+ * Sets attribute's minimum value.
+ */
+ setMinValue(value: number): void;
+
+ /**
+ * Sets attribute's default value.
+ */
+ setDefaultValue(value: number): void;
+ }
+
+ /**
+ * Creates or gets an existing {@link Entity.PathNavigation} instance for the specified mob
+ * @returns Navigation used to control entity's target position and
+ * the way to get there.
+ * @since 2.0.3b33
+ */
+ function getPathNavigation(entityUid: number): PathNavigation;
+
+ /**
+ * Object used to build path and move mobs to the required coordinates using
+ * specified parameters. All the setters return current {@link Entity.PathNavigation}
+ * instance to be able to produce chained calls.
+ * @since 2.0.3b33
+ */
+ interface PathNavigation {
+ /**
+ * Builds path to the specified coordinates.
+ * @param speed entity movement speed
+ */
+ moveToCoords(x: number, y: number, z: number, speed: number): PathNavigation;
+
+ /**
+ * Builds path to the specified entity. Note that current coordinates of
+ * entity are used, and are not updated.
+ * @param speed entity movement speed
+ */
+ moveToEntity(entity: number, speed: number): PathNavigation;
+
+ /**
+ * Sets function to be notified when path navigation is finished or aborted.
+ * @param callback function to be called when navigation is finished or aborted
+ */
+ setResultFunction(callback: PathNavigationResultFunction): PathNavigation;
+
+ /**
+ * @returns Whether the entity can pass doors.
+ */
+ canPassDoors(): boolean;
+ /**
+ * Sets entity's door passing ability.
+ */
+ setCanPassDoors(can: boolean): PathNavigation;
+
+ isRiverFollowing(): boolean;
+ setIsRiverFollowing(follow: boolean): PathNavigation;
+
+ /**
+ * @returns Whether the entity can open doors.
+ */
+ canOpenDoors(): boolean;
+ /**
+ * Sets entity's door opening ability.
+ */
+ setCanOpenDoors(can: boolean): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getAvoidSun(): boolean;
+ /**
+ * Sets entity's sun avoiding.
+ */
+ setAvoidSun(avoid: boolean): PathNavigation;
+
+ /**
+ * @returns Whether the entity avoids water.
+ */
+ getAvoidWater(): boolean;
+ /**
+ * Sets entity's water avoiding.
+ */
+ setAvoidWater(avoid: boolean): PathNavigation;
+
+ setEndPathRadius(radius: number): PathNavigation;
+
+ getCanSink(): boolean;
+ setCanSink(can: boolean): PathNavigation;
+
+ getAvoidDamageBlocks(): boolean;
+ setAvoidDamageBlocks(avoid: boolean): PathNavigation;
+
+ getCanFloat(): boolean;
+ setCanFloat(can: boolean): PathNavigation;
+
+ isAmphibious(): boolean;
+ setIsAmphibious(amphibious: boolean): PathNavigation;
+
+ getAvoidPortals(): boolean;
+ setAvoidPortals(avoid: boolean): PathNavigation;
+
+ getCanBreach(): boolean;
+ setCanBreach(can: boolean): PathNavigation;
+
+ /**
+ * @returns Whether entity can jump.
+ */
+ getCanJump(): boolean;
+
+ /**
+ * Enables or disables entity's jumping ability.
+ */
+ setCanJump(can: boolean): PathNavigation;
+
+ /**
+ * @returns Entity's speed value.
+ */
+ getSpeed(): number;
+
+ /**
+ * Sets entity's speed value.
+ */
+ setSpeed(speed: number): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getCanPathOverLava(): boolean;
+ /**
+ * @since 2.2.1b93
+ */
+ setCanPathOverLava(can: boolean): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getCanWalkInLava(): boolean;
+ /**
+ * @since 2.2.1b93
+ */
+ setCanWalkInLava(can: boolean): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getCanOpenIronDoors(): boolean;
+ /**
+ * @since 2.2.1b93
+ */
+ setCanOpenIronDoors(can: boolean): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getHasEndPathRadius(): boolean;
+ /**
+ * @since 2.2.1b93
+ */
+ setHasEndPathRadius(has: boolean): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getTerminationThreshold(): number;
+ /**
+ * @since 2.2.1b93
+ */
+ getTerminationThreshold(threshold: number): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ getTickTimeout(): number;
+ /**
+ * @since 2.2.1b93
+ */
+ setTickTimeout(ticks: number): PathNavigation;
+
+ /**
+ * @since 2.2.1b93
+ */
+ isStuck(ticks: number): boolean;
+ }
+
+ /**
+ * Path navigation result, which is used in result callback:
+ *
+ * Result code | Meaning
+ * ---|---
+ * 0 | Path successfully completed
+ * 1 | Cannot reach target, no available path
+ * 2 | Cannot reach target, out of range
+ * 3 | Entity has been unloaded or removed
+ * 4 | Cancelled by `stop()` or similar method
+ * 5 | Player left level or server closed
+ * 6 | Result function will be replaced
+ */
+ type PathNavigationResultCode = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
+ /**
+ * Occurs when path navigation is finished or aborted.
+ * @param navigation {@link Entity.PathNavigation} that the handler is attached to
+ * @param result result code, see {@link PathNavigationResultCode} for details
+ */
+ interface PathNavigationResultFunction {
+ (navigation: PathNavigation, result: PathNavigationResultCode): void
+ }
+
+ /**
+ * Returns array of all entities numeric IDs in given range in blocks.
+ * @param coords1 start search range coordinates
+ * @param coords2 end search range coordinates
+ * @param type entity type ID
+ * @default type: 255, flag: true
+ * @since 2.0.4b35
+ * @remarks
+ * Local method, use {@link BlockSource.listEntitiesInAABB} instead.
+ */
+ function getAllInsideBox(coords1: Vector, coords2: Vector, type?: number, flag?: boolean): number[];
+
+}
diff --git a/api/core-engine/EntityAI.d.ts b/api/core-engine/EntityAI.d.ts
new file mode 100644
index 000000000..1d6d2d18c
--- /dev/null
+++ b/api/core-engine/EntityAI.d.ts
@@ -0,0 +1,402 @@
+/**
+ * Class used to create new entity AI types.
+ * @deprecated
+ */
+declare class EntityAIClass implements EntityAIClass.EntityAIPrototype {
+ /**
+ * Creates new entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype);
+
+ /**
+ * Sets execution timer time in ticks. AI will be executed specified
+ * number of ticks.
+ * @param timer execution time in ticks
+ */
+ setExecutionTimer(timer: number): void;
+
+ /**
+ * Resets execution timer so that AI is executed with no time limits.
+ */
+ removeExecutionTimer(): void;
+
+ /**
+ * If set to true, it is an instance of AI type, else the pattern
+ * (pattern should not be modified directly, AI controller calls
+ * instantiate to create instances of AI type).
+ */
+ isInstance: boolean;
+
+ /**
+ * Instantiated custom entity that uses this AI type
+ * instance or `null` if it is the pattern.
+ */
+ parent?: CustomEntity;
+
+ /**
+ * Numeric unique entity idenifier that uses this AI type
+ * instance or `null` if it is the pattern.
+ */
+ entity?: number;
+
+ /**
+ * Method that is called to create AI type instance using current
+ * instance as pattern.
+ */
+ instantiate(parent: any, name: string): EntityAIClass;
+
+ /**
+ * Occurs when entity this instance is assigned to this AI type
+ * instance, if you override this method, be sure to assign entity
+ * to {@link EntityAIClass.EntityAIPrototype}.
+ */
+ aiEntityChanged(entity: number): void;
+
+ /**
+ * Finishes AI execution and disables it in parent controller.
+ */
+ finishExecution(): void;
+
+ /**
+ * Changes own priority in parent's controller.
+ */
+ changeSelfPriority(priority: number): void;
+
+ /**
+ * Enables any AI by it's name in the controller.
+ * @param name AI name to be enables
+ * @param priority priority to be set to the enabled AI
+ * @param extra some extra data passed to
+ */
+ enableAI(name: string, priority: number, extra: any): void;
+
+ /**
+ * Disables any AI by it's name in the controller.
+ * @param name AI name to be disabled
+ */
+ disableAI(name: string): void;
+
+ /**
+ * Sets any AI priority by it's name in the controller.
+ * @param name AI name to change priority
+ * @param priority priority to be set to the AI
+ */
+ setPriority(name: string, priority: number): void;
+
+ /**
+ * Gets any AI object by it's name from the current controller.
+ * @param name AI name
+ */
+ getAI(name: string): EntityAIClass;
+
+ /**
+ * Gets any AI priority from the current controller by AI name.
+ * @param name AI name
+ */
+ getPriority(name: string): number;
+
+ /**
+ * @returns AI type's default name.
+ */
+ setParams(params: object): void;
+
+ /**
+ * All the parameters of the AI instance.
+ */
+ params: object;
+
+ /**
+ * Object containing the state of the AI type.
+ */
+ data: object;
+}
+
+/**
+ * @deprecated
+ */
+declare namespace EntityAIClass {
+ /**
+ * Object used to register entity AI prototypes.
+ */
+ interface EntityAIPrototype {
+ /**
+ * @returns AI type's default priority.
+ */
+ getDefaultPriority?(): number,
+
+ /**
+ * @returns AI type's default name.
+ */
+ getDefaultName?(): string,
+
+ /**
+ * Default parameters set.
+ */
+ params?: object,
+
+ /**
+ * Called when AI type execution starts.
+ * @param extra additional data passed from {@link EntityAIClass.enableAI}
+ * method
+ */
+ executionStarted?(extra?: any): void,
+
+ /**
+ * Called when AI type execution ends.
+ */
+ executionEnded?(): void,
+
+ /**
+ * Called when AI type execution is paused.
+ */
+ executionPaused?(): void,
+
+ /**
+ * Called when AI type execution is resumed.
+ */
+ executionResumed?(): void,
+
+ /**
+ * Defines main logic of the AI type.
+ */
+ execute?(): void,
+
+ /**
+ * Object containing the state of the AI type.
+ */
+ data?: object,
+
+ /**
+ * Called when entity is attacked by player.
+ * @param attacker player that attacked this entity
+ */
+ attackedBy?(attacker: number): void;
+
+ /**
+ * Called when entity gets hurt.
+ * @param attacker entity that damaged this entity, or -1 if damage
+ * source is not an entity
+ * @param damage amount of damage
+ */
+ hurtBy?(attacker: number, damage: number): void;
+
+ /**
+ * Called when a projectile hits the entity.
+ * @param projectile projectile entity ID
+ */
+ projectileHit?(projectile: number): void;
+
+ /**
+ * Called when entity is dead.
+ * @param attacker entity that damaged this entity, or -1 if damage
+ * source is not an entity
+ */
+ death?(attacker: number): void;
+ }
+
+ /**
+ * Object used to register entity AI prototypes.
+ */
+ interface WanderLikeAIPrototype extends EntityAIPrototype {
+ /**
+ * Entity movement speed when AI is executed.
+ */
+ speed?: number;
+ /**
+ * Entity speed when turning.
+ */
+ angular_speed?: number;
+ }
+
+}
+
+/**
+ * A set of predefined entity AI types.
+ * @deprecated
+ */
+declare namespace EntityAI {
+ /**
+ * Simple Idle AI type, entity just does nothing.
+ */
+ class Idle extends EntityAIClass {
+ /**
+ * Creates Idle entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype);
+ }
+
+ /**
+ * Follow AI type, entity follows it's target. Use another AI type to set
+ * target for this AI type.
+ */
+ class Follow extends EntityAIClass {
+ /**
+ * Creates follow entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype & {
+ /**
+ * Entity movement speed when AI is executed.
+ * @default 0.2
+ */
+ speed?: number;
+ /**
+ * Jump (y) velocity.
+ * @default 0.45
+ */
+ jumpVel?: number;
+ /**
+ * Entity rotation speed.
+ * @default 0.4
+ */
+ rotateSpeed?: number;
+ /**
+ * How long will be the rotation path.
+ * @default 0.5
+ */
+ rotateRatio?: number;
+ /**
+ * If `true`, entity turns it's head to the target.
+ * @default true
+ */
+ rotateHead?: boolean;
+ /**
+ * If `true`, entity won't change it's Y velocity.
+ * @default true
+ */
+ denyY?: boolean;
+ /**
+ * Coordinates used as a target.
+ */
+ target?: Vector;
+ /**
+ * Entity used as a target; when specified, target data is ignored.
+ */
+ targetEntity?: number;
+ });
+ }
+
+ /**
+ * Panic AI type, entity just rushes around.
+ */
+ class Panic extends EntityAIClass {
+ /**
+ * Creates panic entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.WanderLikeAIPrototype);
+ }
+
+ /**
+ * Wander AI type, entity walks around making pauses.
+ */
+ class Wander extends EntityAIClass {
+ /**
+ * Creates wander entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.WanderLikeAIPrototype & {
+ /**
+ * Part of the time entity is making pause.
+ * @default 0.3
+ */
+ delay_weight?: number;
+ });
+ }
+
+ /**
+ * Attack AI type, entity causes damage to the target entity.
+ */
+ class Attack extends EntityAIClass {
+ /**
+ * Creates attack entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype & {
+ /**
+ * Damage amount.
+ * @default 5
+ */
+ attack_damage?: number;
+ /**
+ * Damage radius.
+ * @default 2.5
+ */
+ attack_range?: number;
+ /**
+ * Time between to attacks in ticks.
+ * @default 12
+ */
+ attack_rate?: number;
+ /**
+ * Target entity.
+ * @default null
+ */
+ target?: Nullable;
+ });
+ }
+
+ /**
+ * Swim AI type, if the entity is in water, it swims.
+ */
+ class Swim extends EntityAIClass {
+ /**
+ * Creates swim entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype & {
+ /**
+ * Swimming speed.
+ * @default 0.2
+ */
+ velocity?: number;
+ });
+ }
+
+ /**
+ * Panic AI watcher type, controls entity panic behavior after getting hurt.
+ */
+ class PanicWatcher extends EntityAIWatcher {
+ /**
+ * Creates panic watcher entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype & {
+ /**
+ * Time the entity will be in panic.
+ * @default 200
+ */
+ panic_time?: number;
+ /**
+ * Panic AI priority when entity should be in panic.
+ * @default 5
+ */
+ priority_panic?: number;
+ /**
+ * Panic AI priority when entity should not be in panic.
+ * @default 1
+ */
+ priority_default?: number;
+ /**
+ * Panic AI priority when entity should not be in panic
+ * @default "panic"
+ */
+ name?: string;
+ });
+ }
+}
+
+/**
+ * Parent class for {@link EntityAI.PanicWatcher}, does nothing
+ * like {@link EntityAI.Idle}.
+ * @deprecated
+ */
+declare class EntityAIWatcher extends EntityAIClass {
+ /**
+ * Creates watcher entity AI type.
+ * @param customPrototype AI type prototype
+ */
+ constructor(customPrototype: EntityAIClass.EntityAIPrototype);
+}
diff --git a/api/core-engine/FileTools.d.ts b/api/core-engine/FileTools.d.ts
new file mode 100644
index 000000000..e9281d94c
--- /dev/null
+++ b/api/core-engine/FileTools.d.ts
@@ -0,0 +1,148 @@
+/**
+ * Module that provides methods to work with file system.
+ */
+declare namespace FileTools {
+ /**
+ * Defines path to mounted devices directory (e.g. *\/mnt*).
+ */
+ const mntdir: string;
+
+ /**
+ * Defines external user directory path with trailing slash (e.g. *\/sdcard\/*, *\/storage\/emulated\/0\/*).
+ */
+ const root: string;
+
+ /**
+ * Defines in-pack directory where modders alives with trailing slash (e.g. *\/storage\/emulated\/0\/games\/horizon\/packs\/Inner_Core_Test\/innercore\/mods\/*, *\/storage\/emulated\/0\/Android\/data\/com.zheka.horizon\/files\/games\/horizon\/packs\/Inner_Core_Test\/innercore\/mods\/*).
+ */
+ const moddir: string;
+
+ /**
+ * Creates directory by it's home-relative or absolute path, if one of the
+ * parent directories doesn't exist, creates them.
+ * @param dir path to the new directory
+ */
+ function mkdir(dir: string): void;
+
+ /**
+ * Creates Core Engine working directories.
+ * @internal
+ */
+ function mkworkdirs(): void;
+
+ /**
+ * Converts home-relative path to absolute.
+ * @param path input path
+ * @returns Same string if input string is an absolute path, an absolute
+ * path if input string is a home-relative path.
+ */
+ function getFullPath(path: string): string;
+
+ /**
+ * Verifies if specified home-relative or absolute path exists.
+ * @param path path to be verified
+ * @returns `true`, if specified path exists, `false` otherwise.
+ */
+ function isExists(path: string): boolean;
+
+ /**
+ * Writes text to the file.
+ * @param file home-relative or absolute path to the file
+ * @param text text to be written to the file
+ * @param add if `true`, appends text to the file, overrides it otherwise
+ * @default add: false
+ */
+ function WriteText(file: string, text: string, add?: boolean): void;
+
+ /**
+ * Reads text as-is from file, append `?.trim()` to drop trailing newlines.
+ * @param file home-relative or absolute path to the file
+ * @returns File contents or `null` if file does not exist or not accessible.
+ */
+ function ReadText(file: string): Nullable;
+
+ /**
+ * Writes bitmap to PNG (lossless and transparent extension) file.
+ * @param file home-relative or absolute path to the file
+ * @param bitmap {@link android.graphics.Bitmap} to be written to the file
+ */
+ function WriteImage(file: string, bitmap: android.graphics.Bitmap): void;
+
+ /**
+ * Reads high-resolution (as-is) bitmap from file.
+ * @param file home-relative or absolute path to the file
+ * @returns object of the bitmap that was read from
+ * file or null if file does not exist or is not accessible.
+ */
+ function ReadImage(file: string): Nullable;
+
+ /**
+ * Reads string from asset by it's full name.
+ * @param name asset name
+ * @returns Asset contents or `null` if asset doesn't exist.
+ */
+ function ReadTextAsset(name: string): Nullable;
+
+ /**
+ * Reads high-resolution (as-is) bitmap from asset by it's full name.
+ * @param name asset name
+ * @returns Object of the bitmap that was read from
+ * asset or null, if asset doesn't exist.
+ */
+ function ReadImageAsset(name: string): Nullable;
+
+ /**
+ * Reads bytes array from assets.
+ * @param name asset name
+ * @returns JArray of bytes read from assets or null if asset doesn't exist.
+ */
+ function ReadBytesAsset(name: string): Nullable>;
+
+ /**
+ * Lists children directories for the specified path.
+ * @param path home-relative or absolute path to the file
+ * @returns JArray of {@link java.io.File} instances of listed directories.
+ */
+ function GetListOfDirs(path: string): java.io.File[];
+
+ /**
+ * Lists files in the specified directory.
+ * @param path path to directory to look for files in
+ * @param ext extension of the files to include to the output
+ * @returns JArray of {@link java.io.File} instances that match specified extension.
+ */
+ function GetListOfFiles(path: string, ext?: string): java.io.File[];
+
+ /**
+ * Reads file as `:` pairs.
+ * @param dir home-relative or absolute path to the file
+ * @param specialSeparator separator between key and value, ":" by default
+ * @returns Object containing `:` pairs from file.
+ */
+ function ReadKeyValueFile(dir: string, specialSeparator?: string): {
+ [key: string]: string
+ };
+
+ /**
+ * Writes `:` pairs to the file.
+ * @param dir home-relative or absolute path to the file
+ * @param data object to be written to the file as a set of key:value pairs
+ * @param specialSeparator separator between key and value, ":" by default
+ */
+ function WriteKeyValueFile(dir: string, data: object, specialSeparator?: string): void;
+
+ /**
+ * Reads JSON file without comments as object.
+ * @param dir home-relative or absolute path to the file
+ * @returns Object represents JSON value read from JSON file.
+ */
+ function ReadJSON(dir: string): object;
+
+ /**
+ * Writes object to file as JSON.
+ * @param dir home-relative or absolute path to the file
+ * @param obj object to be written to the file as JSON
+ * @param beautify if `true`, output JSON is beautified with tabs
+ */
+ function WriteJSON(dir: string, obj: object, beautify?: boolean): void;
+}
diff --git a/api/core-engine/Game.d.ts b/api/core-engine/Game.d.ts
new file mode 100644
index 000000000..91b75069e
--- /dev/null
+++ b/api/core-engine/Game.d.ts
@@ -0,0 +1,199 @@
+/**
+ * Module that provides some general game-related functions.
+ */
+declare namespace Game {
+ /**
+ * `true` if developer mode was enabled in Inner Core config.
+ * @internal
+ */
+ let isDeveloperMode: boolean;
+
+ /**
+ * `true` if Inner Core config allows spending items in creative.
+ * @internal
+ */
+ let spendItemsInCreative: boolean;
+
+ /**
+ * Allows you to determine whether current instance of game has
+ * a client or not (clientless game requires a server core, e.g.
+ * [Zote Core (GitHub)](https://github.com/reider745/zotecoreloader)).
+ * @since 2.3.1b116
+ */
+ function isDedicatedServer(): boolean;
+
+ /**
+ * Prevents current callback function from being called in Minecraft.
+ * For most callbacks it prevents default game behavior.
+ */
+ function prevent(): void;
+
+ /**
+ * @returns `true` if the current callback function has already been
+ * prevented from being called in Minecraft using {@link Game.prevent},
+ * `false `otherwise.
+ */
+ function isActionPrevented(): boolean;
+
+ /**
+ * Writes message to the chat.
+ * Message can be formatted using {@link EColor} values.
+ * @param message message to be displayed
+ */
+ function message(message: any): void;
+
+ /**
+ * Writes message above the hot bar.
+ * Message can be formatted using {@link EColor} values.
+ * @param message message to be displayed
+ */
+ function tipMessage(message: any): void;
+
+ /**
+ * Displays {@link android.app.AlertDialog} with given message and dialog title.
+ * Message can be mixed with {@link android.text.Html.fromHtml HTML-like} formatting,
+ * for example `I'm a bold I'm a italic `.
+ * @param message message to be displayed
+ * @param title title before message
+ */
+ function dialogMessage(message: any, title: any): void;
+
+ /**
+ * Sets game difficulty, one of {@link EGameDifficulty} values.
+ * @param difficulty game difficulty to be set
+ */
+ function setDifficulty(difficulty: number): void;
+
+ /**
+ * @returns Current game difficulty, one of the {@link EGameDifficulty} values.
+ */
+ function getDifficulty(): number;
+
+ /**
+ * Sets current level game mode.
+ * @param mode new game mode, should be one of the {@link EGameMode}
+ * values
+ */
+ function setGameMode(mode: number): void;
+
+ /**
+ * @returns Current level game mode, one of the {@link EGameMode} values.
+ */
+ function getGameMode(): number;
+
+ /**
+ * Option types, which can be used to determine option data:
+ *
+ * Type | Name | Description
+ * ---|---|---
+ * 0 | None | Internal type, it cannot be used.
+ * 1 | Boolean | `true` or `false` switch.
+ * 2 | Float | Field with float value.
+ * 3 | Float Slider | Slider with float value in specified ranges.
+ * 4 | String | Field with string text value.
+ * 5 | Int | Field with integer value.
+ * 6 | Int Slider | Slider with integer value in specified ranges.
+ * @since 2.4.0b122
+ */
+ type OptionType = number;
+
+ /**
+ * Option instance, which can be obtained via {@link Game.getOption}.
+ * @since 2.4.0b122
+ */
+ interface Option {
+ /**
+ * @internal
+ */
+ getPointer(): number;
+ /**
+ * Gets numeric option type, which can be used to
+ * determine data type and retrieve proper value.
+ */
+ getType(): OptionType;
+ /**
+ * Can option be changed in game settings.
+ */
+ canModify(): boolean;
+ /**
+ * Gets boolean value of option, suitable for
+ * boolean {@link OptionType}.
+ */
+ getBoolean(): boolean;
+ /**
+ * Gets boolean value of option, suitable for
+ * float and float slider {@link OptionType}s.
+ */
+ getFloat(): number;
+ /**
+ * Gets minimum value in slider range, suitable
+ * for float slider {@link OptionType}.
+ */
+ getFloatMin(): number;
+ /**
+ * Gets maximum value in slider range, suitable
+ * for float slider {@link OptionType}.
+ */
+ getFloatMax(): number;
+ /**
+ * Gets boolean value of option, suitable for
+ * string {@link OptionType}.
+ */
+ getString(): string;
+ /**
+ * Gets boolean value of option, suitable for
+ * int and int slider {@link OptionType}s.
+ */
+ getInt(): number;
+ /**
+ * Gets minimum value in slider range, suitable
+ * for int slider {@link OptionType}.
+ */
+ getIntMin(): number;
+ /**
+ * Gets maximum value in slider range, suitable
+ * for int slider {@link OptionType}.
+ */
+ getIntMax(): number;
+ }
+
+ /**
+ * Retrieves option by requested name, which instance
+ * could be used for getting values.
+ * @param name option name, suitable names could be found
+ * in your "options.txt" file or via {@link Game.getOptions}
+ * @since 2.4.0b122
+ */
+ function getOption(name: string): Nullable;
+
+ /**
+ * Fetches available option names, which can be used to
+ * obtain values via {@link Game.getOption}.
+ * @since 2.4.0b122
+ */
+ function getOptions(): string[];
+
+ /**
+ * String containing current Minecraft version.
+ * @returns `"1.16.201"` or `"1.11.4"`
+ */
+ function getMinecraftVersion(): string;
+
+ /**
+ * String containing current Core Engine version.
+ * @returns `"2.1"`
+ */
+ function getEngineVersion(): string;
+
+ /**
+ * @returns `true` if item spending allowed or player in creative.
+ */
+ function isItemSpendingAllowed(playerUid?: number): boolean;
+
+ /**
+ * Emulates native pressing of the back button inside
+ * the game, for example, necessary to close current window.
+ * @since 2.0.4b35
+ */
+ function simulateBackPressed(): void;
+}
diff --git a/api/core-engine/GameController.d.ts b/api/core-engine/GameController.d.ts
new file mode 100644
index 000000000..1601d707b
--- /dev/null
+++ b/api/core-engine/GameController.d.ts
@@ -0,0 +1,65 @@
+/**
+ * Methods for manipulating player with world,
+ * use callbacks of callbacks in their implementation.
+ * @since 2.4.0b120
+ */
+declare namespace GameController {
+
+ /**
+ * @remarks Can break a block that breaks instantly.
+ */
+ function startDestroyBlock(x: number, y: number, z: number, side: number): boolean;
+
+ /**
+ * Triggers client-side "DestroyBlockContinue" and "DestroyBlockStart" (on zero progress).
+ */
+ function continueDestroyBlock(x: number, y: number, z: number, side: number): boolean;
+
+ /**
+ * Interrupts destruction animation.
+ */
+ function stopDestroyBlock(x: number, y: number, z: number): void;
+
+ /**
+ */
+ function startBuildBlock(x: number, y: number, z: number, side: number): void;
+
+ /**
+ */
+ function continueBuildBlock(x: number, y: number, z: number, side: number): void;
+
+ /**
+ */
+ function stopBuildBlock(): void;
+
+ /**
+ * Triggers server-side "BreakBlock" and "DestroyBlock" (if not prevented).
+ */
+ function destroyBlock(x: number, y: number, z: number, side: number): void;
+
+ /**
+ * Triggers server-side "BuildBlock".
+ */
+ function buildBlock(x: number, y: number, z: number, side: number): void;
+
+ /**
+ * Triggers server-side "ItemUse" and "ItemUseServer"
+ * with client-side "ItemUseLocal" and "ItemUseLocalServer".
+ */
+ function onItemUse(x: number, y: number, z: number, side: number): void;
+
+ /**
+ * Triggers server-side "PlayerAttack" and "EntityHurt".
+ */
+ function attack(entityUid: number): void;
+
+ /**
+ * Triggers server-side "EntityInteract".
+ */
+ function interact(entityUid: number, x: number, y: number, z: number): void;
+
+ /**
+ */
+ function releaseUsingItem(): void;
+
+}
diff --git a/api/core-engine/GameObject.d.ts b/api/core-engine/GameObject.d.ts
new file mode 100644
index 000000000..f3a7c21a0
--- /dev/null
+++ b/api/core-engine/GameObject.d.ts
@@ -0,0 +1,157 @@
+interface GameObjectPrototype extends Updatable {
+ /**
+ * Function that is called when a new instance of {@link GameObject} is created,
+ * the engine passes all the arguments of {@link GameObject.deploy} function to
+ * this function.
+ */
+ init?: (...args: any) => void,
+ /**
+ * Function that is called when a {@link GameObject} is loaded.
+ */
+ loaded?: () => void
+}
+
+/**
+ * Class used to create and manipulate game objects. Game objects are {@link Updatable Updatables}
+ * that are being saved between game launches.
+ */
+declare class GameObject {
+ /**
+ * Constructs a new {@link GameObject} with given params.
+ * @param type unique name for the game object type. Use package-like names to
+ * ensure your game object name is unique
+ * @param prototype
+ */
+ constructor(type: string, prototype: T);
+
+ /**
+ * Original value passed to {@link GameObject.constructor} as type.
+ */
+ readonly originalName: string;
+ /**
+ * Same as {@link GameObject.originalName}, but with suffix
+ * which are used for object saving to be unique.
+ */
+ readonly gameobjectName: string;
+ /**
+ * Used when {@link Saver.registerObject} calling inside.
+ * @internal
+ */
+ readonly saverId: number;
+ /**
+ * `true` if current object is instance, prototype otherwise.
+ */
+ readonly isInstance: boolean;
+ /**
+ * `true` if current object was deployed or added directly.
+ */
+ readonly isDeployed: boolean;
+ /**
+ * Prototype from which instantiated objects are created.
+ * @internal
+ */
+ readonly Prototype: T;
+
+ /**
+ * Creates a new game object without deploying it; you are shouldn't
+ * do it normally, it was called by {@link GameObject.deploy}.
+ * @returns Instantiated game object.
+ * @internal
+ */
+ instantiate(): GameObject;
+
+ /**
+ * Creates a new game object with specified params and registers
+ * it for saving and as an {@link Updatable}.
+ * @param args any arguments that are passed to {@link GameObjectPrototype.init} function
+ * @returns Instantiated game object.
+ */
+ deploy(...args: any): GameObject;
+
+ /**
+ * Destroys current game object.
+ */
+ destroy(): void;
+}
+
+declare namespace GameObjectRegistry {
+ /**
+ * Game objects which are registered via {@link GameObject.constructor}
+ * or internally via {@link GameObjectRegistry.registerClass}.
+ * @internal
+ */
+ const gameObjectTypes: {
+ [gameobjectName: string]: GameObject
+ };
+ /**
+ * Game objects which are deployed via {@link GameObject.deploy}
+ * or internally via {@link GameObjectRegistry.deployGameObject}
+ * and {@link GameObjectRegistry.addGameObject}.
+ * @internal
+ */
+ const activeGameObjects: {
+ [type: string]: GameObject
+ };
+
+ /**
+ * Suffixes game object type if it already registered.
+ * @internal
+ */
+ function genUniqueName(name: string): string;
+
+ /**
+ * Registers game object to be saveable, called from {@link GameObject.constructor}.
+ * @internal
+ */
+ function registerClass(gameObject: GameObject): void;
+
+ /**
+ * Puts game object to an updatable queue, calling {@link GameObjectPrototype.loaded}.
+ * Should be called by {@link GameObject.deploy}.
+ * @internal
+ */
+ function deployGameObject(gameObject: GameObject): void;
+
+ /**
+ * Puts game object as active, but without adding as updatable, which
+ * has been achieved by calling {@link GameObject.deploy}.
+ * @internal
+ */
+ function addGameObject(gameObject: GameObject): void;
+
+ /**
+ * Destroys game object, but without removing updatable as
+ * it is done via {@link GameObject.destroy}.
+ * @internal
+ */
+ function removeGameObject(gameObject: GameObject): void;
+
+ /**
+ * Clears active game object list, maintaining updatable states.
+ * @internal
+ */
+ function resetEngine(): void;
+
+ /**
+ * Gets an array of deployed {@link GameObject game objects} of specified type.
+ * @param type unique {@link GameObject} type to get all the instances of
+ * @param clone if `true`, a new array is created to be changeable,
+ * recommended by default
+ */
+ function getAllByType(type: string, clone: boolean): GameObject[];
+
+ /**
+ * Calls function of the {@link GameObject} of specified type
+ * with specified parameters.
+ * @param type unique {@link GameObject} type to get all the instances of
+ * @param what function name as defined in {@link GameObjectPrototype}
+ * passed to {@link GameObject.constructor}
+ * @param params parameters to be passed to the function
+ */
+ function callForType(type: string, what: string, ...params: any): any;
+
+ /**
+ * Same as {@link GameObjectRegistry.callForType} but for async operations.
+ */
+ function callForTypeSafe(type: string, what: string, ...params: any): any;
+}
diff --git a/api/core-engine/GenerationUtils.d.ts b/api/core-engine/GenerationUtils.d.ts
new file mode 100644
index 000000000..cf5310968
--- /dev/null
+++ b/api/core-engine/GenerationUtils.d.ts
@@ -0,0 +1,160 @@
+/**
+ * Module used to simplify generation tasks in mods logic.
+ */
+declare namespace GenerationUtils {
+ /**
+ * @param id numeric tile ID
+ * @returns `true` if block is solid and light blocking block, `false` otherwise.
+ */
+ function isTerrainBlock(id: number): boolean;
+
+ /**
+ * @param id numeric tile ID
+ * @returns `true` if block is transparent, `false` otherwise.
+ */
+ function isTransparentBlock(id: number): boolean;
+
+ /**
+ * @returns `true`, if one can see sky from the specified position, `false`
+ * otherwise.
+ */
+ function canSeeSky(x: number, y: number, z: number): boolean;
+
+ /**
+ * Generates random x and z coordinates inside specified chunk.
+ * @param cx chunk x coordinate
+ * @param cz chunk z coordinate
+ */
+ function randomXZ(cx: number, cz: number): { x: number, z: number };
+
+ /**
+ * Generates random coordinates inside specified chunk.
+ * @param cx chunk x coordinate
+ * @param cz chunk z coordinate
+ * @param lowest lowest possible y coordinate; default is `0`
+ * @param highest highest possible y coordinate; default is `128`
+ */
+ function randomCoords(cx: number, cz: number, lowest?: number, highest?: number): Vector;
+
+ /**
+ * Finds limited to the specified y coordinate empty space on the specified
+ * x and z coordinates.
+ */
+ function findSurface(x: number, y: number, z: number): Vector;
+
+ /**
+ * Finds limited to `y=128` coordinate empty space on the specified x and z
+ * coordinates.
+ */
+ function findHighSurface(x: number, z: number): Vector;
+
+ /**
+ * Finds limited to `y=64` coordinate empty space on the specified x and z
+ * coordinates.
+ */
+ function findLowSurface(x: number, z: number): Vector;
+
+ // /**
+ // * Locked via {@link GenerationUtils.lockInBlock} block, air by default.
+ // */
+ // const __lockedReal: Tile;
+ // /**
+ // * Changes block to be locked when generating new chunk, unused
+ // * since upgrading to new Inner Core generation.
+ // */
+ // function lockInBlock(id: number, data: number, checkerBlock?: number, inverse?: boolean): void;
+ // /**
+ // * Locks block at specified location, which are changed via
+ // * {@link GenerationUtils.lockInBlock} call.
+ // */
+ // function setLockedBlock(x: number, y: number, z: number): void;
+
+ interface IMinableParams {
+ /**
+ * Ore block numeric identifier.
+ */
+ id: number,
+ /**
+ * Ore block data.
+ */
+ data: number,
+ /**
+ * If `true`, no check for stone is performed so the ore may be
+ * generated in the air. Use this to debug ore generation in
+ * the superflat worlds.
+ */
+ noStoneCheck?: number
+ }
+
+ interface MinableAmountParams extends IMinableParams {
+ /**
+ * Amount of the ore to be generated, minimum allowed value is `1`.
+ * Use at least `6` to be able to find generated ore vein.
+ * Note that amount doesn't mean blocks count, it is just an
+ * input value for generation algorithm.
+ */
+ amount: number
+ }
+
+ interface MinableSizeParams extends IMinableParams {
+ /**
+ * Amount ratio of ore vein per generation chunk.
+ * @default 1
+ */
+ ratio?: number,
+ /**
+ * Used to calculate amount, using simple formula `size * ratio * 3`.
+ * Minimum allowed value of amount is `1`.
+ */
+ size: number
+ }
+
+ type MinableParams = MinableAmountParams | MinableSizeParams;
+
+ /**
+ * Generates ore vein on the specified coordinates using specified params.
+ * @param params vein generation params
+ */
+ function genMinable(x: number, y: number, z: number, params: MinableParams): void;
+
+ /**
+ * Generates ore vein on the specified coordinates.
+ * @param id ore block ID
+ * @param data ore block data
+ * @param amount ore amount, use at least `6` to be able to find generated
+ * ore vein; note that amount doesn't mean blocks count, it is just an
+ * input value for generation algorithm
+ * @param noStoneCheck if `true`, no check for stone is performed so the ore
+ * may be generated in the air; use this to debug ore generation in the
+ * superflat worlds
+ */
+ function generateOre(x: number, y: number, z: number, id: number, data: number, amount: number, noStoneCheck: boolean): void;
+
+ /**
+ * Generates ore vein on the specified coordinates with custom whitelist/blacklist.
+ * @param id ore block ID
+ * @param data ore block data
+ * @param amount ore amount, use at least `6` to be able to find generated
+ * ore vein; note that amount doesn't mean blocks count, it is just an
+ * input value for generation algorithm
+ * @param whitelist if `true`, specified block IDs are used as whitelist for generation
+ * (only the IDs from the list can be replaced with ores); if `false`, specified
+ * block IDs are used as a blacklist (only the IDs from the list canNOT be
+ * replaced with ores)
+ * @param listOfIds array of block IDs to be used as whitelist or blacklist
+ * @since 2.0.1b17
+ */
+ function generateOreCustom(x: number, y: number, z: number, id: number, data: number, amount: number, whitelist: boolean, listOfIds: number[]): void;
+
+ /**
+ * Retrieves perlin noise value at the specified coordinates.
+ * @param seed integer random generator seed. If not specified or set to 0, the default
+ * constant value is used
+ * @param scale noise size, to set the main octave size, use *1 / octave size*
+ * @param numOctaves number of octaves, the more octaves you use, the more
+ * detailed is the generated noise. The next octave is two times smaller then
+ * the previous one
+ * @since 2.0.1b11
+ */
+ function getPerlinNoise(x: number, y: number, z: number, seed?: number, scale?: number, numOctaves?: number): number;
+}
diff --git a/api/core-engine/ICRender.d.ts b/api/core-engine/ICRender.d.ts
new file mode 100644
index 000000000..041c99704
--- /dev/null
+++ b/api/core-engine/ICRender.d.ts
@@ -0,0 +1,261 @@
+/**
+ * Class used to define block models that depend on surrounding blocks. Some
+ * examples of such blocks are wires, pipes, block structure parts, etc.
+ */
+declare namespace ICRender {
+ /**
+ * Used to specify that the block should be present to satisfy condition.
+ */
+ const MODE_INCLUDE = 0;
+
+ /**
+ * Used to specify that the block should be absent to satisfy condition.
+ */
+ const MODE_EXCLUDE = 1;
+
+ /**
+ * @param name group name
+ * @returns Block group by it's name, if no group with specified name exist,
+ * this function creates a new one.
+ */
+ function getGroup(name: string): ICRender.Group;
+
+ /**
+ * Creates a new group with a unique name.
+ */
+ function getUnnamedGroup(): ICRender.Group;
+
+ /**
+ * Groups (of blocks) are used to determine some render conditions; e.g.,
+ * if a block exists on some relative coordinates, display some part of the
+ * model.
+ */
+ interface Group {
+ /**
+ * @returns Group's name.
+ */
+ getName(): string,
+
+ name: string;
+
+ /**
+ * Adds a block to the group.
+ * @param id block ID
+ * @param data block data or -1 to use with all registered data values
+ */
+ add(id: number, data: number): void
+ }
+
+ class Model {
+ /**
+ * Constructs a base model that will be displayed in world.
+ * @param model optional model to be added without additional conditions
+ */
+ constructor(model?: BlockRenderer.Model);
+
+ getPtr(): number;
+
+ /**
+ * Adds block model as an entry to the {@link ICRender}. You can then call
+ * {@link ICRender.RenderEntry.asCondition RenderEntry.asCondition} to specify when to display the entry.
+ * @returns Created {@link ICRender.RenderEntry} object.
+ */
+ addEntry(model?: BlockRenderer.Model): RenderEntry;
+
+ /**
+ * Adds render mesh as an entry to the {@link ICRender}. You can then call
+ * {@link ICRender.RenderEntry.asCondition RenderEntry.asCondition} to specify when to display the entry.
+ * @returns Created {@link ICRender.RenderEntry} object.
+ */
+ addEntry(mesh?: RenderMesh): RenderEntry;
+
+ /**
+ * @since 2.2.1b96
+ */
+ clear(): void;
+ }
+
+ /**
+ * Object representing render entry with it's displaying condition.
+ */
+ interface RenderEntry {
+ /**
+ * @returns Parent {@link ICRender.Model} object this entry belongs to.
+ */
+ getParent(): Model;
+
+ /**
+ * Sets {@link ICRender.BLOCK} condition with specified parameters. Uses coordinates
+ * that are relative to current block's ones.
+ * @param group group name or object
+ * @param mode one of the {@link ICRender.MODE_INCLUDE} and {@link ICRender.MODE_EXCLUDE} constants
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ asCondition(x: number, y: number, z: number, group: Group | string, mode: number): RenderEntry;
+
+ /**
+ * Sets {@link ICRender.BLOCK} condition with specified parameters. Uses coordinates
+ * that are relative to current block's ones. Creates a new anonymous
+ * group with single block.
+ * @param id condition block ID
+ * @param data condition block data
+ * @param mode one of the {@link ICRender.MODE_INCLUDE} and {@link ICRender.MODE_EXCLUDE} constants
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ asCondition(x: number, y: number, z: number, id: number, data: number, mode: number): RenderEntry;
+
+ /**
+ * Sets condition to be used for current entry.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setCondition(condition: CONDITION): RenderEntry;
+
+ /**
+ * Sets block model used for the entry, specifying it's coordinates.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setModel(x: number, y: number, z: number, model: BlockRenderer.Model): RenderEntry;
+
+ /**
+ * Sets block model used for the entry.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setModel(model: BlockRenderer.Model): RenderEntry;
+
+ /**
+ * Sets render mesh to be used for the entry.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setMesh(mesh: RenderMesh): RenderEntry;
+ }
+
+ /**
+ * Class representing custom collision shapes used for block.
+ */
+ class CollisionShape {
+ /**
+ * Constructs a base model that will be raycasted in world.
+ */
+ constructor();
+
+ getPtr(): number;
+
+ /**
+ * Adds new entry to the collision shape. You can then call
+ * {@link ICRender.CollisionEntry.setCondition CollisionEntry.setCondition} to specify when to display the entry.
+ */
+ addEntry(): CollisionEntry;
+
+ /**
+ * @since 2.2.1b96
+ */
+ clear(): void;
+ }
+
+ /**
+ * Object representing collision shape entry with it's displaying condition.
+ */
+ interface CollisionEntry {
+ /**
+ * Adds new collision box to collision entry.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ addBox(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number): CollisionEntry;
+
+ /**
+ * Sets condition, all the boxes of the entry work only if the condition is `true`.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setCondition(condition: CONDITION): CollisionEntry;
+ }
+
+ /**
+ * Common superclass for all condition classes.
+ * @internal
+ */
+ class CONDITION {
+ /**
+ * @since 2.3.1b116
+ */
+ constructor(ptr: number);
+ }
+
+ /**
+ * Condition depending on random value.
+ * @since 2.0.2b23
+ */
+ abstract class RANDOM_CONDITION implements CONDITION {
+ /**
+ * Forces engine to treat blocks along some axis in same way if enabled
+ * parameter value is `false`.
+ * @param axis 0 fpr x, 1 for y, 2 for z axis
+ */
+ setAxisEnabled(axis: number, enabled: boolean): RANDOM_CONDITION;
+ }
+
+ /**
+ * Constructs new {@link ICRender.RANDOM_CONDITION} condition.
+ * @param value value that a generated random integer number should be for the
+ * condition to evaluate as true
+ * @param max maximum value for the generator
+ * @param seed seed to be used for random numbers generation
+ * @since 2.0.2b23
+ */
+ function RANDOM(value: number, max: number, seed?: number): RANDOM_CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.RANDOM} condition with default seed and `0` as
+ * desired random value.
+ * @param max maximum value for the generator
+ * @since 2.0.2b23
+ */
+ function RANDOM(max: number): RANDOM_CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.BLOCK} condition.
+ * @param x is relative x coordinate
+ * @param y is relative y coordinate
+ * @param z is relative z coordinate
+ * @param group blocks group to check the condition for
+ * @param exclude if true, the blocks from the group make the condition
+ * evaluate as false, as true otherwise
+ */
+ function BLOCK(x: number, y: number, z: number, group: ICRender.Group, exclude: boolean): CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.NOT} condition.
+ * @param condition condition to be inverted
+ */
+ function NOT(condition: CONDITION): CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.OR} condition.
+ */
+ function OR(...conditions: CONDITION[]): CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.AND} condition.
+ */
+ function AND(...conditions: CONDITION[]): CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.BlockState} condition that uses
+ * block state data (it must match the value) to display.
+ * @param x is relative x coordinate
+ * @param y is relative y coordinate
+ * @param z is relative z coordinate
+ * @param state one of {@link EBlockStates} values of relative block
+ * @param value value to match selected state
+ * @since 2.3.1b116
+ */
+ function BlockState(x: number, y: number, z: number, state: number, value: number): CONDITION;
+
+ /**
+ * Constructs new {@link ICRender.BlockState} condition that uses
+ * block state data (it must match the value) to display.
+ * @param state one of {@link EBlockStates} values
+ * @param value value to match selected state
+ * @since 2.3.1b116
+ */
+ function BlockState(state: number, value: number): CONDITION;
+}
diff --git a/api/core-engine/IDRegistry.d.ts b/api/core-engine/IDRegistry.d.ts
new file mode 100644
index 000000000..16414e91a
--- /dev/null
+++ b/api/core-engine/IDRegistry.d.ts
@@ -0,0 +1,126 @@
+/**
+ * Module used to manage item and block IDs. Items and blocks have the same
+ * underlying nature, so their IDs are interchangeable. Though, the blocks are
+ * defined "twice", as an item (in player's hand or inventory) and as a tile
+ * (a block placed in the world).
+ */
+declare namespace IDRegistry {
+ /**
+ * Defines the numeric ID of the first user-defined item.
+ */
+ const ITEM_ID_OFFSET: number;
+
+ /**
+ * Defines the numeric ID of the first user-defined block.
+ */
+ const BLOCK_ID_OFFSET: number;
+
+ /**
+ * Defines maximum item/block ID.
+ */
+ const MAX_ID: number;
+
+ /**
+ * Generates a new numeric block ID.
+ * @param name string block ID. Used in {@link Block} module functions and
+ * in some other block-related functions. Inner Core converts it to
+ * block_ as minecraft vanilla block ID to avoid string ID clashes
+ * @returns Numeric block ID.
+ */
+ function genBlockID(name: string): number;
+
+ /**
+ * Generates a new numeric item ID.
+ * @param name string item ID. Used in {@link Item} module functions and
+ * in some other item-related functions. Inner Core converts it to
+ * item_ as minecraft vanilla item ID to avoid string ID clashes
+ * @returns Numeric item ID.
+ */
+ function genItemID(name: string): number;
+
+ /**
+ * Gets known modded item or block string ID by it's numeric ID.
+ * @param id numeric item or block ID
+ */
+ function getNameByID(id: number): string;
+
+ /**
+ * Gets unique identifier of item or block string ID by it's numeric ID.
+ * IDs represented in format `type:identifier#extra`, e.g.
+ * `item:ruby_shovel` or `block:ancient_debris#negative`,
+ * @param id numeric item or block ID
+ * @since 2.2.1b94
+ */
+ function getStringIdAndTypeForItemId(id: number): Nullable;
+
+ /**
+ * Gets ID type by specific numeric ID.
+ * @param id numeric item or block ID
+ * @since 2.2.1b94
+ */
+ function getTypeForItemId(id: number): Nullable<"block" | "item">;
+
+ /**
+ * Gets item or block string ID by it's numeric ID.
+ * @param id numeric item or block ID
+ * @since 2.2.1b94
+ */
+ function getStringIdForItemId(id: number): Nullable;
+
+ /**
+ * Ensures given ID is a tile ID, not a block ID. It is generally recommended
+ * to use {@link Block.convertItemToBlockId} since it performs less calculations.
+ * @param id block or tile ID
+ * @returns Tile ID.
+ */
+ function ensureBlockId(id: number): number;
+
+ /**
+ * Ensures given ID is a block ID, not a tile ID. It is generally recommended
+ * to use {@link Block.convertBlockToItemId} since it performs less calculations.
+ * @param id block or tile ID
+ * @returns Block ID.
+ */
+ function ensureItemId(id: number): number;
+
+ /**
+ * @param id numeric item or block ID
+ * @returns `true` if item is vanilla Minecraft item, `false` otherwise.
+ * @since 2.2.1b102
+ */
+ function isVanilla(id: number): boolean;
+
+ /**
+ * Gets type of item ("block" or "item") and it's string ID in Minecraft.
+ * @param id numeric item or block ID
+ * @returns String in format `"type:string_id"` or
+ * `"type:string_id#extra_information"`.
+ * @deprecated Use {@link IDRegistry.getStringIdAndTypeForItemId} instead.
+ */
+ function getIdInfo(id: number): string;
+
+ /**
+ * Gets type of item ("block" or "item") and it's string ID in Minecraft.
+ * @param id numeric item or block ID
+ * @returns String in format `"type:string_id"`.
+ * @since 2.2.1b94
+ */
+ function getStringIdAndTypeForIntegerId(id: number): string;
+
+ /**
+ * Gets type of item ("block" or "item").
+ * @param id numeric item or block ID
+ * @returns Represent of type.
+ * @since 2.2.1b94
+ */
+ function getTypeForIntegerId(id: number): string;
+
+ /**
+ * Gets item string ID in Minecraft.
+ * @param id numeric item or block ID
+ * @returns Represent of named identifier.
+ * @since 2.2.1b94
+ */
+ function getStringIdForIntegerId(id: number): string;
+
+}
diff --git a/api/core-engine/Item.d.ts b/api/core-engine/Item.d.ts
new file mode 100644
index 000000000..a18d4aec1
--- /dev/null
+++ b/api/core-engine/Item.d.ts
@@ -0,0 +1,547 @@
+/**
+ * Module used to define items and their properties.
+ */
+declare namespace Item {
+ /**
+ * @param id string ID of the item
+ * @returns Item numeric ID by it's string ID or just returns it's numeric ID
+ * if input was a numeric ID.
+ */
+ function getNumericId(id: string | number): number;
+
+ /**
+ * Gets NativeItem instance that can be used to apply some properties to the
+ * item.
+ * @param id string ID of the item
+ * @returns NativeItem instance associated with this item.
+ */
+ function getItemById(id: string): NativeItem;
+
+ /**
+ * Object used in {@link Item.createItem} and {@link Item.createThrowableItem}
+ * methods to specify general item parameters.
+ */
+ interface ItemParams {
+ /**
+ * Maximum item in stack size.
+ * @default 64
+ */
+ stack?: number;
+ /**
+ * If true, the item will not be added to creative.
+ * @default false
+ */
+ isTech?: boolean;
+ /**
+ * @since 2.2.0b76
+ */
+ category?: number;
+ }
+
+ /**
+ * Creates new item using specified parameters.
+ * @param nameID string ID of the item; you should register it via
+ * {@link IDRegistry.genItemID} call first
+ * @param name item name in English; add translations to the name using
+ * {@link Translation} module, all translation to the item and block names are
+ * applied automatically
+ * @param texture texture data used to create item
+ * @param params additional item parameters
+ */
+ function createItem(nameID: string, name: string, texture: TextureData, params?: ItemParams): NativeItem;
+
+ /**
+ * Object used in {@link Item.createFoodItem} method
+ * to specify general food item parameters.
+ */
+ interface FoodParams extends ItemParams {
+ /**
+ * Amount of hunger restored by this food in halfs.
+ * @default 1 // 0.5 hunger unit
+ */
+ food?: number;
+ }
+
+ /**
+ * Creates eatable item using specified parameters.
+ * @param nameID string ID of the item. You should register it via
+ * {@link IDRegistry.genItemID} call first
+ * @param name item name in English; add translations to the name using
+ * {@link Translation} module, all translation to the item and block names are
+ * applied automatically
+ * @param texture texture data used to create item
+ * @param params additional item parameters
+ */
+ function createFoodItem(nameID: string, name: string, texture: TextureData, params?: FoodParams): NativeItem;
+
+ /**
+ * @deprecated Use {@link Item.createItem} and
+ * {@link Recipes.addFurnaceFuel} instead.
+ * @throws Unsupported usage.
+ */
+ function createFuelItem(nameID: string, name: string, texture: TextureData, params?: ItemParams): void;
+
+ /**
+ * Object used in {@link Item.createArmorItem} method
+ * to specify general armor item parameters.
+ */
+ interface ArmorParams {
+ /**
+ * If `true`, the item will not be added to creative.
+ * @default false
+ */
+ isTech?: boolean,
+ /**
+ * Armor durability, the more it is, the more hits the armor will resist.
+ * @default 1
+ */
+ durability?: number,
+ /**
+ * Armor protection.
+ * @default 0
+ */
+ armor?: number,
+ /**
+ * Relative path to the armor model texture from the mod assets directory.
+ * @default "textures/logo.png"
+ */
+ texture?: string,
+ /**
+ * Armor type, should be one of the `helmet`, `chestplate`, `leggings` or `boots`.
+ */
+ type: ArmorType,
+ /**
+ * Knockback resistance, that the player will have when wearing the following armor.
+ * It must be value from 0 (no knockback resistance) to 1 (full knockback resistance).
+ * @default 0
+ */
+ knockbackResist?: number;
+ }
+
+ /**
+ * Creates armor item using specified parameters.
+ * @param nameID string ID of the item; you should register it via
+ * {@link IDRegistry.genItemID} call first
+ * @param name item name in English; add translations to the name using
+ * {@link Translation} module, all translation to the item and block names are
+ * applied automatically
+ * @param texture texture data used to create item
+ * @param params general armor item parameters object, the armor type there is required
+ */
+ function createArmorItem(nameID: string, name: string, texture: TextureData, params: ArmorParams): NativeItem;
+
+ /**
+ * Creates throwable item using specified parameters.
+ * @param nameID string ID of the item; you should register it via
+ * {@link IDRegistry.genItemID} call first
+ * @param name item name in English; add translations to the name using
+ * {@link Translation} module, all translation to the item and block names are
+ * applied automatically
+ * @param texture texture data used to create item
+ * @param params additional item parameters
+ */
+ function createThrowableItem(nameID: string, name: string, texture: TextureData, params?: ItemParams): NativeItem;
+
+ /**
+ * @param id numeric item ID
+ * @returns `true` if given item is vanilla item, `false` otherwise.
+ */
+ function isNativeItem(id: number): boolean;
+
+ /**
+ * @param id numeric item ID
+ * @returns Maximum damage value for the specified item.
+ */
+ function getMaxDamage(id: number): number;
+
+ /**
+ * @param id numeric item ID
+ * @returns Maximum stack size for the specified item.
+ * @deprecated Use same function with data parameter.
+ */
+ function getMaxStack(id: number): number;
+
+ /**
+ * @param id numeric item ID
+ * @returns Maximum stack size for the specified item.
+ * @since 2.2.0b1 pre-alpha
+ */
+ function getMaxStack(id: number, data: number): number;
+
+ /**
+ * @param id numeric item ID
+ * @param data item data
+ * @returns Current item name.
+ */
+ function getName(id: number, data: number): string;
+
+ /**
+ * @param id numeric item ID
+ * @param data item data
+ * @param encode no longer supported, do not use this parameter
+ * @returns Current item name.
+ * @deprecated Use same method without last parameter.
+ */
+ function getName(id: number, data: number, encode: any): string;
+
+ /**
+ * Natural armor points, that also is displayed above hotbar.
+ * @param id numeric item ID
+ * @returns Natural armor half points.
+ * @since 2.4.0b119
+ */
+ function getArmorValue(id: number): number;
+
+ /**
+ * @param id numeric item ID
+ * @returns `true`, if an item with such ID exists, `false` otherwise.
+ * @since 2.2.1b94 (not worked before)
+ */
+ function isValid(id: number): boolean;
+
+ /**
+ * @param id numeric item ID
+ * @param data no longer supported, do not use this parameter
+ * @returns `true`, if an item with such ID exists, `false` otherwise.
+ * @deprecated Use same method without last parameter.
+ */
+ function isValid(id: number, data: number): boolean;
+
+ /**
+ * Adds item to creative inventory.
+ * @param id string or numeric item ID
+ * @param count amount of the item to be added, generally should be 1
+ * @param data item data
+ */
+ function addToCreative(id: number | string, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * Creates group of creative items.
+ * @param name name of group
+ * @param displayedName name of group in game
+ * @param ids array of items in group
+ */
+ function addCreativeGroup(name: string, displayedName: string, ids: number[]): void
+
+ /**
+ * Applies several properties via one method call.
+ * @param numericID numeric item ID
+ * @deprecated Consider using appropriate setters instead.
+ */
+ function describeItem(numericID: number, description: object): void;
+
+ /**
+ * Sets item creative category.
+ * @param id string or numeric item ID
+ * @param category item category, should be one of the
+ * {@link EItemCategory} values
+ */
+ function setCategory(id: number | string, category: number): void;
+
+ /**
+ * Specifies how the item can be enchanted.
+ * @param id string or numeric item ID
+ * @param enchant enchant type defining when enchants can or cannot be
+ * applied to this item, one of the {@link EEnchantType}
+ * @param value quality of the enchants that are applied, the higher this
+ * value is, the better enchants you get with the same level
+ */
+ function setEnchantType(id: number | string, enchant: number, value: number): void;
+
+ /**
+ * Specifies what items can be used to repair this item in the anvil.
+ * @param id string or numeric item ID
+ * @param items array of numeric item IDs to be used as repair items
+ */
+ function addRepairItemIds(id: number | string, items: number[]): void;
+
+ /**
+ * Specifies how the player should hold the item.
+ * @param id string or numeric item ID
+ * @param enabled if true, player holds the item as a tool, not as a simple
+ * item
+ */
+ function setToolRender(id: number | string, enabled: boolean): void;
+
+ /**
+ * Sets item maximum data value.
+ * @param id string or numeric item ID
+ * @param maxdamage maximum data value for the item
+ */
+ function setMaxDamage(id: number | string, maxdamage: number): void;
+
+ /**
+ * Sets item as glint (like enchanted tools or golden apple).
+ * @param id string or numeric item ID
+ * @param enabled if true, the item will be displayed as glint item
+ */
+ function setGlint(id: number | string, enabled: boolean): void;
+
+ /**
+ * Allows to click with item on liquid blocks.
+ * @param id string or numeric item ID
+ * @param enabled if true, liquid blocks can be selected on click
+ */
+ function setLiquidClip(id: number | string, enabled: boolean): void;
+
+ function setArmorDamageable(damageable: boolean): void;
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function setStackedByData(id: number | string, enabled: boolean): void;
+
+ /**
+ * Allows item to be put in offhand slot.
+ * @param id string or numeric item ID
+ * @since 2.0.4b35
+ */
+ function setAllowedInOffhand(id: number | string, allowed: boolean): void;
+
+ /**
+ *
+ * @param id
+ * @param should
+ * @since 2.4.0b119
+ */
+ function setShouldDespawn(id: number | string, should: boolean): void;
+
+ /**
+ *
+ * @param id
+ * @param resistant
+ * @since 2.4.0b119
+ */
+ function setFireResistant(id: number | string, resistant: boolean): void;
+
+ /**
+ *
+ * @param id
+ * @param explodable
+ * @since 2.4.0b119
+ */
+ function setExplodable(id: number | string, explodable: boolean): void;
+
+ /**
+ * Sets additional properties for the item, uses Minecraft mechanisms to
+ * set them. Full list of properties is currently unavailable.
+ * @param id string or numeric item ID
+ * @param props JSON string containing some of the properties
+ */
+ function setProperties(id: number | string, props: string): void;
+
+ /**
+ * Sets animation type for the item.
+ * @param id string or numeric item ID
+ * @param animType use animation type, one of the {@link EItemAnimation}
+ * values
+ */
+ function setUseAnimation(id: number | string, animType: number): void;
+
+ /**
+ * Limits maximum use duration. This is useful to create such items as bows.
+ * @param id string or numeric item ID
+ * @param duration maximum use duration in ticks
+ */
+ function setMaxUseDuration(id: number | string, duration: number): void;
+
+ /**
+ * Same as {@link Item.registerUseFunction}, but supports numeric IDs only.
+ */
+ function registerUseFunctionForID(numericID: number, useFunc: Callback.ItemUseFunction): void;
+
+ /**
+ * Registers function that is called when user touches some block in the
+ * world with specified item.
+ * @param nameID string or numeric ID of the item
+ * @param useFunc function that is called when such an event occurs
+ */
+ function registerUseFunction(nameID: string | number, useFunc: Callback.ItemUseFunction): void;
+
+ /**
+ * Same as {@link Item.registerThrowableFunction}, but supports numeric IDs only.
+ */
+ function registerThrowableFunctionForID(numericID: number, useFunc: Callback.ProjectileHitFunction): void;
+
+ /**
+ * Registers function that is called when throwable item with specified ID
+ * hits block or entity.
+ * @param nameID string or numeric ID of the item
+ * @param useFunc function that is called when such an event occurs
+ */
+ function registerThrowableFunction(nameID: string | number, useFunc: Callback.ProjectileHitFunction): void;
+
+ /**
+ * Registers item ID as requiring item icon override and registers function
+ * to perform such an override.
+ * @param nameID string or numeric ID of the item
+ * @param func function that is called to override item icon. Should return
+ * {@link Item.TextureData} object to be used for the item. See
+ * {@link Callback.ItemIconOverrideFunction} documentation for details
+ */
+ function registerIconOverrideFunction(nameID: string | number, func: Callback.ItemIconOverrideFunction): void;
+
+ /**
+ * Registers function to perform item name override.
+ * @param nameID string or numeric ID of the item
+ * @param func function that is called to override item name. Should return
+ * string to be used as new item name
+ */
+ function registerNameOverrideFunction(nameID: string | number, func: Callback.ItemNameOverrideFunction): void;
+
+ /**
+ * Registers function to be called when player uses item in the air (not on
+ * the block).
+ * @param nameID string or numeric ID of the item
+ * @param func function that is called when such an event occurs
+ */
+ function registerNoTargetUseFunction(nameID: string | number, func: Callback.ItemUseNoTargetFunction): void;
+
+ /**
+ * Registers function to be called when player doesn't complete using item
+ * that has maximum use time set with {@link Item.setMaxUseDuration} function.
+ * Vanilla bow uses this function with max use duration of 72000 ticks.
+ * @param nameID string or numeric ID of the item
+ * @param func function that is called when such an event occurs
+ */
+ function registerUsingReleasedFunction(nameID: string | number, func: Callback.ItemUsingReleasedFunction): void;
+
+ /**
+ * Registers function to be called when player completes using item
+ * that has maximum use time set with {@link Item.setMaxUseDuration} function.
+ * @param nameID string or numeric ID of the item
+ * @param func function that is called when such an event occurs
+ */
+ function registerUsingCompleteFunction(nameID: string | number, func: Callback.ItemUsingCompleteFunction): void;
+
+ /**
+ * Registers function to be called when item is dispensed from dispenser.
+ * @param nameID string or numeric ID of the item
+ * @param func function that is called when such an event occurs
+ */
+ function registerDispenseFunction(nameID: string | number, func: Callback.ItemDispensedFunction): void;
+
+ /**
+ * Invoke click on the block in world.
+ * @param coords coords of click on the block
+ * @param item item which used on the block
+ * @param noModCallback if `true`, mod ItemUse callback will be not executed
+ * @param entity player which clicked on the block
+ * @internal
+ */
+ function invokeItemUseOn(coords: Callback.ItemUseCoordinates, item: ItemInstance, noModCallback: boolean, entity: number): void;
+
+ /**
+ * Invoke click on the block in world without target.
+ * @param item item which used on the block
+ * @param noModCallback if `true`, mod ItemUse callback will be not executed
+ * @internal
+ */
+ function invokeItemUseNoTarget(item: ItemInstance, noModCallback: boolean): void;
+
+ /**
+ * Class representing item used to set it's properties.
+ */
+ interface NativeItem {
+ addRepairItem(id: number): void;
+ addRepairItems(id: number[]): void;
+ setAllowedInOffhand(allowed: boolean): void;
+ setArmorDamageable(damageable: boolean): void;
+ setCreativeCategory(category: number): void;
+ setEnchantType(type: number): void;
+ setEnchantType(enchant: number, value: number): void;
+ setEnchantability(enchant: number, value: number): void;
+ setGlint(glint: boolean): void;
+ setHandEquipped(equipped: boolean): void;
+ setLiquidClip(clip: boolean): void;
+ setMaxDamage(maxDamage: number): void;
+ setMaxStackSize(maxStack: number): void;
+ setMaxUseDuration(duration: number): void;
+ setProperties(props: string): void;
+ setStackedByData(stacked: boolean): void;
+ setUseAnimation(animation: number): void;
+ }
+
+ /**
+ * Represents item texture data. For example, if *\/items-opaque* folder
+ * contains file *nugget_iron_0.png*, you should pass `"nugget_iron"` as
+ * texture name and `0` as texture index. *_N* suffix can be omitted, but it is
+ * generally not recommended.
+ */
+ interface TextureData {
+ /**
+ * Texture name, name of the file stored in the *\/items-opaque* asset
+ * folder without extension and *_N* suffixes.
+ */
+ name: string,
+
+ /**
+ * Texture index defined by *_N* texture suffix.
+ * @default 0
+ */
+ data?: number,
+
+ /**
+ * @deprecated Same as data, so data is preferred in all cases.
+ */
+ meta?: number
+ }
+
+ /**
+ * All items name override functions object.
+ * @internal
+ */
+ const nameOverrideFunctions: {
+ [key: number]: Callback.ItemNameOverrideFunction
+ };
+
+ /**
+ * All items icon override functions object.
+ * @internal
+ */
+ const iconOverrideFunctions: {
+ [key: number]: Callback.ItemIconOverrideFunction
+ };
+
+ /**
+ * Once upon a time, a new way of registering items, however,
+ * in current state, either does not work or is undesirable to use.
+ * @deprecated
+ */
+ interface ItemLegacyPrototype {
+ type: "createItem" | "createFoodItem" | "createArmorItem" | "createThrowableItem",
+ init?: () => void,
+ getName: (item: null) => Nullable,
+ getTexture: (item: null) => Nullable,
+ getDefineParams?: (item: null) => Nullable,
+ getMaxDamage?: (item: null) => Nullable,
+ getCategory?: (item: null) => Nullable,
+ getEnchant?: (item: null) => Nullable,
+ getUseAnimation?: (item: null) => Nullable,
+ getMaxUseDuration?: (item: null) => Nullable,
+ /**
+ * Cannot be used, because of properties should be passed as string,
+ * but properties here internally depends on object.
+ */
+ getProperties?: (item: null) => Nullable,
+ isToolRender?: (item: null) => Nullable,
+ isStackedByData?: (item: null) => Nullable,
+ isEnchanted?: (item: null) => Nullable,
+ getToolMaterial?: (item: null) => Nullable,
+ getToolTarget?: (item: null) => Nullable,
+ getToolPrototype?: (item: null) => Nullable,
+ getArmorFuncs?: (item: null) => Nullable,
+ onUsed?: (coords: Vector, item: ItemInstance, block: Tile) => void,
+ /**
+ * Unused at all.
+ */
+ onTick?: (item: null) => void,
+ onThrowableImpact?: (projectile: number, item: ItemInstance, target: Callback.ProjectileHitTarget) => void
+ }
+
+ /**
+ * @deprecated Should not be used in new mods, consider using {@link Item}
+ * properties setters instead.
+ */
+ function setPrototype(nameID: any, prototype: ItemLegacyPrototype): void;
+}
diff --git a/api/core-engine/ItemContainer.d.ts b/api/core-engine/ItemContainer.d.ts
new file mode 100644
index 000000000..1ba425388
--- /dev/null
+++ b/api/core-engine/ItemContainer.d.ts
@@ -0,0 +1,415 @@
+declare namespace ItemContainer {
+ type PrimitiveTypes = string | number | boolean;
+ type PacketData = {
+ [key: string]: PrimitiveTypes;
+ };
+
+ interface BindingValidator {
+ (container: ItemContainer, str: string, obj: any, time: number): any;
+ }
+ interface ClientEventListener {
+ (container: ItemContainer, window: UI.IWindow, scriptable: any, obj: any): void;
+ }
+ interface ClientOnCloseListener {
+ (container: ItemContainer): void;
+ }
+ interface ClientOnOpenListener {
+ (container: ItemContainer, str: string): void;
+ }
+ interface DirtySlotListener {
+ (container: ItemContainer, str: string, slot: ItemContainerSlot): void;
+ }
+ interface ServerEventListener {
+ (container: ItemContainer, client: NetworkClient, obj: any): void;
+ }
+ interface ServerOnCloseListener {
+ (container: ItemContainer, client: NetworkClient): void;
+ }
+ interface ServerOnOpenListener {
+ (container: ItemContainer, client: NetworkClient, screenName: string): void;
+ }
+ interface Transaction {
+ (container: ItemContainer, str: string): void;
+ }
+ interface TransferPolicy {
+ (container: ItemContainer, str: string, id: number, count: number, data: number, extra: Nullable, time: number): number;
+ }
+ interface UiScreenFactory {
+ (container: ItemContainer, screen: string): UI.IWindow;
+ }
+}
+
+/**
+ * Backwards compatibility.
+ */
+declare type TransferPolicy = ItemContainer.TransferPolicy;
+
+declare interface ItemContainerUiHandler extends UI.UiAbstractContainer {
+ getWindow(): UI.IWindow;
+ getParent(): ItemContainer;
+ handleBindingDirty(elementName: string, bindingName: string): void;
+ applyAllBindingsFromMap(): void;
+ setBindingByComposedName(name: string, value: ItemContainer.PrimitiveTypes): void;
+ receiveBindingsFromServer(bindings: org.json.JSONObject): void;
+}
+
+/**
+ * Type of TileEntity container that supports multiplayer.
+ */
+declare class ItemContainer implements Recipes.WorkbenchField {
+ readonly isServer: boolean;
+ readonly slots: {[key: string]: ItemContainerSlot};
+ readonly transactionLock: any;
+ static loadClass(): void;
+ static registerScreenFactory(factoryName: string, factory: ItemContainer.UiScreenFactory): void;
+ static addClientEventListener(typeName: string, packetName: string, listener: ItemContainer.ClientEventListener): void;
+ static addClientOpenListener(typeName: string, listener: ItemContainer.ClientOnOpenListener): void;
+ static addClientCloseListener(typeName: string, listener: ItemContainer.ClientOnCloseListener): void;
+ static getClientContainerInstance(name: string): Nullable;
+ /**
+ * Constructs a new {@link ItemContainer} object.
+ */
+ constructor();
+ /**
+ * Constructs a new {@link ItemContainer} object from given
+ * deprecated {@link UI.Container} object.
+ */
+ constructor(legacyContainer: UI.Container);
+ getNetworkEntity(): NetworkEntity;
+ getNetworkName(): string;
+ getUiAdapter(): ItemContainerUiHandler;
+ getWindow(): UI.IWindow;
+ getWindowContent(): UI.WindowContent;
+ removeEntity(): void;
+ /**
+ * Sets container's parent object, for {@link TileEntity}'s
+ * container it should be it reference, otherwise you can pass any
+ * value to be used in your code later.
+ * @param parent an object to be set as container's parent
+ */
+ setParent(parent: Nullable | any): void;
+ /**
+ * @returns Tile if the following container is part of it,
+ * and `null` otherwise.
+ */
+ getParent(): Nullable | any;
+
+ setGlobalAddTransferPolicy(policy: ItemContainer.TransferPolicy): ItemContainer;
+ setGlobalGetTransferPolicy(policy: ItemContainer.TransferPolicy): ItemContainer;
+ setSlotAddTransferPolicy(slotName: string, policy: ItemContainer.TransferPolicy): ItemContainer;
+ setSlotGetTransferPolicy(slotName: string, policy: ItemContainer.TransferPolicy): ItemContainer;
+ setGlobalDirtySlotListener(listener: ItemContainer.DirtySlotListener): ItemContainer;
+ setDirtySlotListener(listener: ItemContainer.DirtySlotListener): void;
+ sealSlot(slotName: string): void;
+ sealAllSlots(): void;
+ getAddTransferPolicy(slot: string): ItemContainer.TransferPolicy;
+ getGetTransferPolicy(slot: string): ItemContainer.TransferPolicy;
+ setGlobalBindingValidator(validator: ItemContainer.BindingValidator): void;
+ setBindingValidator(composedBindingName: string, validator: ItemContainer.BindingValidator): void;
+ getBindingValidator(composedBindingName: string): ItemContainer.BindingValidator;
+ runTransaction(transaction: ItemContainer.Transaction): void;
+ /**
+ * Gets the slot by it's name. If a slot with specified name doesn't
+ * exists, creates an empty one with specified name.
+ * @param name slot name
+ * @returns Contents of the slot in a {@link ItemContainerSlot} object.
+ * You can modify it to change the contents of the slot.
+ */
+ getSlot(name: string): ItemContainerSlot;
+ /**
+ * @deprecated Use {@link ItemContainer.getSlot} instead.
+ */
+ getFullSlot(name: string): ItemContainerSlot;
+ markSlotDirty(name: string): void;
+ markAllSlotsDirty(): void;
+ /**
+ * Sets slot's content by it's name from given slot object. If a slot with specified
+ * name doesn't exist, a new slot with specified name and item will be created.
+ * @param name slot name
+ * @param slot {@link ItemContainerSlot} object to specify slot contents
+ */
+ setSlot(name: string, slot: ItemContainerSlot): void;
+ /**
+ * Set slot's content by it's name. If a slot with specified name doesn't
+ * exists, creates new with specified name and item.
+ * @param name slot name
+ */
+ setSlot(name: string, id: number, count: number, data: number): void;
+ /**
+ * Set slot's content by it's name. If a slot with specified name doesn't
+ * exists, creates new with specified name and item.
+ * @param name slot name
+ * @param extra item extra data
+ */
+ setSlot(name: string, id: number, count: number, data: number, extra: Nullable): void;
+ addToSlot(name: string, id: number, count: number, data: number, extra: Nullable, player: number): number;
+ getFromSlot(name: string, id: number, count: number, data: number, extra: Nullable, player: number): number;
+ /**
+ * Sends changes in container to all clients.
+ * Needs to be used every time when something changes in container.
+ */
+ sendChanges(): void;
+ dropAt(region: BlockSource, x: number, y: number, z: number): void;
+ /**
+ * Validates all the slots in the container.
+ */
+ validateAll(): void;
+ /**
+ * Validates slot contents. If the data value is less then 0, it becomes
+ * 0, if ID is 0 or count is less then or equals to zero, slot is reset
+ * to an empty one.
+ * @param name slot name
+ */
+ validateSlot(name: string): void;
+ /**
+ * Clears slot's contents.
+ * @param name slot name
+ */
+ clearSlot(name: string): void;
+ /**
+ * Drops slot's contents on the specified coordinates and clears the
+ * slot.
+ * @param name slot name
+ */
+ dropSlot(region: BlockSource, name: string, x: number, y: number, z: number): void;
+ /**
+ * Sends event to move specified amount of items from the player inventory slot by given index
+ * to container slot by given name. This event is sent from client to server,
+ * so you should use it only on the client side, for example, in custom slot element touch events, etc.
+ * @param inventorySlot numeric index of the inventory slot, from where to retrieve the item
+ * @param slotName string name of the container slot, where to put taken item
+ * @param amount item count to be retrieved from inventory slot
+ */
+ sendInventoryToSlotTransaction(inventorySlot: number, slotName: string, amount: number): void;
+ handleInventoryToSlotTransaction(player: number, inventorySlot: number, slotName: string, amount: number): void;
+ /**
+ * Sends event to move specified amount of items from one container slot to another by given names.
+ * This event is sent from client to server, so you should use it only on the client side,
+ * for example, in custom slot element touch events, etc.
+ * @param slot1 string name of the container slot, from where to retrieve item
+ * @param slot2 string name of the container slot, where to put taken item
+ * @param amount item count to be retrieved from container slot
+ */
+ sendSlotToSlotTransaction(slot1: string, slot2: string, amount: number): void;
+ handleSlotToSlotTransaction(player: number, slot1: string, slot2: string, amount: number): void;
+ /**
+ * Sends event to move specified amount of items from the container slot by given name
+ * to player's inventory. The index of the inventory slot, where to put item, can't be specified,
+ * because it's decided by {@link ItemContainer} automatically, and you just don't need to do this.
+ * This event is sent from client to server, so you should use it only on the client side,
+ * for example, in custom slot element touch events, etc.
+ * @param slot string name of the container slot, from where to retrieve item
+ * @param amount item count to be retrieved from container slot
+ */
+ sendSlotToInventoryTransaction(slot: string, amount: number): void;
+ handleSlotToInventoryTransaction(player: number, slotName: string, inventorySlot: number, amount: number): void;
+ sendDirtyClientBinding(key: string, value: ItemContainer.PrimitiveTypes): void;
+ handleDirtyBindingsPacket(client: NetworkClient, packet: org.json.JSONObject): void;
+ setBinding(composedBindingName: string, value: ItemContainer.PrimitiveTypes): void;
+ setClientBinding(composedBindingName: string, value: ItemContainer.PrimitiveTypes): void;
+ getBinding(composedBindingName: string): ItemContainer.PrimitiveTypes;
+ setBinding(elementName: string, bindingName: string, value: ItemContainer.PrimitiveTypes): void;
+ setClientBinding(elementName: string, bindingName: string, value: ItemContainer.PrimitiveTypes): void;
+ getBinding(elementName: string, bindingName: string): ItemContainer.PrimitiveTypes;
+ /**
+ * Sets "value" binding value for the element. Used to set scales values.
+ * @param elementName element name
+ * @param value value to be set for the element
+ */
+ setScale(elementName: string, value: number): void;
+ setClientScale(elementName: string, value: number): void;
+ /**
+ * @param elementName element name
+ * @returns Value with "value" binding, e.g. scale value, or `null` if no
+ * element with specified name exist.
+ */
+ getValue(elementName: string, value: number): Nullable;
+ /**
+ * Sets "text" binding value for the element. Used to set element's text.
+ * @param elementName element name
+ * @param text value to be set for the element
+ */
+ setText(elementName: string, text: string | number): void;
+ setClientText(elementName: string, text: string): void;
+ /**
+ * @param elementName element name
+ * @returns Value "text" binding, usually the text displayed on the
+ * element, or `null` if no element with specified name exist.
+ */
+ getText(elementName: string): Nullable;
+ setClientContainerTypeName(type: string): void;
+ getClientContainerTypeName(): string;
+ addServerEventListener(name: string, listener: ItemContainer.ServerEventListener): void;
+ addServerOpenListener(listener: ItemContainer.ServerOnOpenListener): void;
+ addServerCloseListener(listener: ItemContainer.ServerOnCloseListener): void;
+ /**
+ * Sends packet from client container copy to server.
+ */
+ sendEvent(name: string, data: ItemContainer.PacketData | string): void;
+ /**
+ * Sends packet from server container copy to client.
+ */
+ sendEvent(client: NetworkClient, name: string, data: ItemContainer.PacketData | string): void;
+ /**
+ * Sends packet from server container.
+ * @remarks
+ * Available only in server container events!
+ */
+ sendResponseEvent(name: string, data: ItemContainer.PacketData | string): void;
+ /**
+ * Opens UI for client.
+ * @param client client in which UI will be open
+ * @param screenName name of the screen to open
+ */
+ openFor(client: NetworkClient, screenName: string): void;
+ /**
+ * Closes UI for client.
+ * @param client client in which UI will be open
+ */
+ closeFor(client: NetworkClient): void;
+ /**
+ * Closes UI for all clients
+ */
+ close(): void;
+ sendClosed(): void;
+ /**
+ * @since 2.2.0b82
+ */
+ setGlobalSlotSavingEnabled(enabled: boolean): void;
+ /**
+ * @since 2.2.0b82
+ */
+ isGlobalSlotSavingEnabled(): boolean;
+ /**
+ * @since 2.2.0b82
+ */
+ setSlotSavingEnabled(name: string, enabled: boolean): void;
+ /**
+ * @since 2.2.0b82
+ */
+ resetSlotSavingEnabled(name: string): void;
+ /**
+ * @since 2.2.0b82
+ */
+ isSlotSavingEnabled(name: string): boolean;
+ /**
+ * @returns `false` if container supports multiplayer, `true` otherwise.
+ */
+ isLegacyContainer(): false;
+ /**
+ * @since 2.2.0b82
+ */
+ asLegacyContainer(allSlots: boolean): UI.Container;
+ asLegacyContainer(): UI.Container;
+ setWorkbenchFieldPrefix(prefix: string): void;
+ /**
+ * @since 2.2.1b106
+ */
+ setWorkbenchFieldSize(workbenchFieldSize: number): void;
+ /**
+ * @param slot slot index
+ * @returns Workbench slot instance by slot index.
+ */
+ getFieldSlot(slot: number): UI.AbstractSlot;
+ /**
+ * @since 2.2.1b108
+ */
+ getFieldSlot(x: number, y: number): UI.AbstractSlot;
+ /**
+ * @returns JS array of all slots.
+ */
+ asScriptableField(): UI.AbstractSlot[];
+ /**
+ * @since 2.2.1b106
+ */
+ getWorkbenchFieldSize(): number;
+}
+
+declare class ItemContainerSlot implements UI.AbstractSlot {
+ count: number;
+ data: number;
+ extra: Nullable;
+ id: number;
+ constructor(id: number, count: number, data: number);
+ constructor(id: number, count: number, data: number, extra: Nullable);
+ constructor(item: ItemInstance);
+ constructor(json: org.json.JSONObject, convert: boolean);
+ constructor();
+ /**
+ * @returns Slot name.
+ */
+ getName(): string;
+ /**
+ * @returns Container linked to the slot.
+ */
+ getContainer(): ItemContainer;
+ /**
+ * @returns Following {@link ItemContainerSlot} as {@link ItemInstance} object.
+ */
+ asScriptable(): ItemInstance;
+ /**
+ * @returns Following {@link ItemContainerSlot} as {@link org.json.JSONObject} instance.
+ */
+ asJson(): org.json.JSONObject;
+ /**
+ * @returns Whether the slot is empty or not.
+ */
+ isEmpty(): boolean;
+ /**
+ * Refreshes slot in UI.
+ */
+ markDirty(): void;
+ /**
+ * Clears slot contents.
+ */
+ clear(): void;
+ /**
+ * Resets slot if it's ID or count equals `0`.
+ */
+ validate(): void;
+ /**
+ * Drops slot contents in given world at given coords.
+ */
+ dropAt(region: BlockSource, x: number, y: number, z: number): void;
+ /**
+ * Sets slot contents.
+ */
+ setSlot(id: number, count: number, data: number): void;
+ /**
+ * Sets slot contents.
+ */
+ setSlot(id: number, count: number, data: number, extra: Nullable): void;
+ /**
+ * Sets slot contents.
+ */
+ set(id: number, count: number, data: number, extra: Nullable): void;
+ /**
+ * @since 2.2.0b82
+ */
+ resetSavingEnabled(): void;
+ /**
+ * @since 2.2.0b82
+ */
+ setSavingEnabled(enabled: boolean): void;
+ /**
+ * @since 2.2.0b82
+ */
+ isSavingEnabled(): boolean;
+ /**
+ * @returns Numeric ID of the item in slot.
+ */
+ getId(): number;
+ /**
+ * @returns Count of the item in slot.
+ */
+ getCount(): number;
+ /**
+ * @returns Data of the item in slot.
+ */
+ getData(): number;
+ /**
+ * @returns Extra data object of the item in slot,
+ * or `null` if it is not present in the given item.
+ */
+ getExtra(): Nullable;
+}
diff --git a/api/core-engine/ItemExtraData.d.ts b/api/core-engine/ItemExtraData.d.ts
new file mode 100644
index 000000000..6bd24a9b8
--- /dev/null
+++ b/api/core-engine/ItemExtraData.d.ts
@@ -0,0 +1,190 @@
+/**
+ * Class representing item extra data. Used to store additional information
+ * about item other then just item ID and data.
+ */
+declare class ItemExtraData {
+ /**
+ * Creates an empty {@link ItemExtraData} instance.
+ */
+ constructor();
+ /**
+ * Creates a copy of current {@link ItemExtraData} instance with the same contents.
+ */
+ constructor(extraData?: ItemExtraData);
+ /**
+ * Creates an {@link ItemExtraData} Java object instance
+ * from given native item extra data object pointer,
+ * represented as 64-bit integer (long).
+ */
+ constructor(pointer: number);
+
+ asJson(): org.json.JSONObject;
+ /**
+ * Creates a copy of current {@link ItemExtraData} object.
+ * @returns A created copy of the data.
+ */
+ copy(): ItemExtraData;
+ getValue(): number;
+ /**
+ * @returns `true`, if item extra exists and is not empty.
+ */
+ isEmpty(): boolean;
+ applyTo(item: ItemInstance): void;
+ /**
+ * @returns `true` if the item is enchanted, `false` otherwise.
+ */
+ isEnchanted(): boolean;
+ /**
+ * Adds a new enchantment to the item.
+ * @param type enchantment ID, one of the {@link EEnchantment} constants
+ * @param level enchantment level, generally between 1 and 5
+ */
+ addEnchant(type: number, level: number): void;
+ /**
+ * @param type enchantment ID, one of the {@link EEnchantment} constants
+ * @returns Level of the specified enchantment.
+ */
+ getEnchantLevel(type: number): number;
+ /**
+ * Removes enchantments by it's ID.
+ * @param type enchantment ID, one of the {@link EEnchantment} constants
+ */
+ removeEnchant(type: number): void;
+ /**
+ * Removes all the enchantments of the item.
+ */
+ removeAllEnchants(): void;
+ /**
+ * @returns Amount of enchantments applied to the item.
+ */
+ getEnchantCount(): number;
+ /**
+ * @param id enchantment ID, one of the {@link EEnchantment} constants
+ * @param level enchantment level, generally between 1 and 5
+ * @returns Enchantment name by it's ID and level.
+ * @since 2.2.1b94 (not worked before)
+ */
+ getEnchantName(id: number, level: number): string;
+ getRawEnchants(): number[][];
+ getEnchants(): { [id: number]: number };
+ /**
+ * @returns All enchantments names separated by line breaks.
+ */
+ getAllEnchantNames(): string;
+ getAllCustomData(): string;
+ setAllCustomData(data: string): void;
+ /**
+ * @returns Item's custom name.
+ */
+ getCustomName(): string;
+ /**
+ * Sets item's custom name.
+ */
+ setCustomName(name: string): void;
+ /**
+ * @returns Compound tag for the specified item.
+ * @since 2.0.5b44
+ */
+ getCompoundTag(): Nullable;
+ /**
+ * Sets compound tag for the specified item.
+ * @since 2.0.5b44
+ */
+ setCompoundTag(ent: number, tag: NBT.CompoundTag): void;
+ /**
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putObject(name: string, value: any): ItemExtraData;
+ /**
+ * Puts some custom string parameter to the extra data of the item.
+ * @param name parameter name
+ * @param value parameter value
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putString(name: string, value: string): ItemExtraData;
+ /**
+ * Puts some custom integer parameter to the extra data of the item.
+ * @param name parameter name
+ * @param int parameter value
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putInt(name: string, int: number): ItemExtraData;
+ /**
+ * Puts some custom long integer parameter to the extra data of the item.
+ * @param name parameter name
+ * @param long parameter value
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putLong(name: string, long: number): ItemExtraData;
+ /**
+ * Puts some custom floating point number parameter to the extra data of the item.
+ * @param name parameter name
+ * @param float parameter value
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putFloat(name: string, float: number): ItemExtraData;
+ /**
+ * Puts some custom boolean parameter to the extra data of the item.
+ * @param name parameter name
+ * @param bool parameter value
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putBoolean(name: string, bool: boolean): ItemExtraData;
+ /**
+ * @param name parameter name
+ * @param fallback default value to be returned if item extra data doesn't
+ * contain a parameter with specified name
+ * @returns Custom string parameter value if extra data of the item contains
+ * one, fallback value otherwise. If fallback was not specified, `null` is returned.
+ */
+ getString(name: string, fallback?: string): Nullable;
+ /**
+ * @param name parameter name
+ * @param fallback default value to be returned if item extra data doesn't
+ * contain a parameter with specified name
+ * @returns Custom integer parameter value if extra data of the item contains
+ * one, fallback value otherwise. If fallback was not specified, `null` is returned.
+ */
+ getInt(name: string, fallback?: number): Nullable;
+ /**
+ * @param name parameter name
+ * @param fallback default value to be returned if item extra data doesn't
+ * contain a parameter with specified name
+ * @returns Custom long integer parameter value if extra data of the item contains
+ * one, fallback value otherwise. If fallback was not specified, `null` is returned.
+ */
+ getLong(name: string, fallback?: number): Nullable;
+ /**
+ * @param name parameter name
+ * @param fallback default value to be returned if item extra data doesn't
+ * contain a parameter with specified name
+ * @returns Custom float parameter value if extra data of the item contains
+ * one, fallback value otherwise. If fallback was not specified, `null` is returned.
+ */
+ getFloat(name: string, fallback?: number): Nullable;
+ /**
+ * @param name parameter name
+ * @param fallback default value to be returned if item extra data doesn't
+ * contain a parameter with specified name
+ * @returns Custom boolean parameter value if extra data of the item contains
+ * one, fallback value otherwise. If fallback was not specified, `null` is returned.
+ */
+ getBoolean(name: string, fallback?: boolean): Nullable;
+ /**
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ putSerializable(name: string, serializableObject: any): ItemExtraData;
+ getSerializable(name: string): any;
+ /**
+ * Removes all custom parameters from item extra data.
+ */
+ removeCustomData(): void;
+ isFinalizableInstance(): boolean;
+
+ static unwrapObject(extra: any): Nullable;
+ static unwrapValue(extra: any): number;
+ static getValueOrNullPtr(extra: ItemExtraData): number;
+ static getExtraOrNull(pointer: number): Nullable;
+ static cloneExtra(extra: Nullable): Nullable;
+ static fromJson(json: org.json.JSONObject): Nullable;
+}
diff --git a/api/core-engine/ItemModel.d.ts b/api/core-engine/ItemModel.d.ts
new file mode 100644
index 000000000..5ece319d4
--- /dev/null
+++ b/api/core-engine/ItemModel.d.ts
@@ -0,0 +1,277 @@
+
+/**
+ * Namespace used to change item models in player's hand and/or inventory.
+ * By default, if the block has an {@link ICRender}, it is automatically applied as item's model.
+ * @since 2.0.2b20
+ */
+declare namespace ItemModel {
+ /**
+ * Gets {@link ItemModel} object for the specified ID and data.
+ * @param id item or block ID
+ * @param data item or block data
+ * @returns Exist {@link ItemModel} object used to manipulate item's model.
+ */
+ function getFor(id: number, data: number): ItemModel;
+
+ /**
+ * Run it at start of your mod to create new group, it will
+ * be applied to all models, created at the root of your mod
+ * (including default mod).
+ * @remarks
+ * If specified version does not match cache version, whole
+ * group will be re-created.
+ * @since 2.1.0b56
+ */
+ function setCurrentCacheGroup(mod: string, version: string): void;
+
+ /**
+ * Gets {@link ItemModel} object for the specified ID and data. If no {@link ItemModel} for
+ * specified data exist, uses default data `0`.
+ * @returns Any {@link ItemModel} object used to manipulate item's model.
+ */
+ function getForWithFallback(id: number, data: number): ItemModel;
+
+ /**
+ * Creates a new standalone item model that is not connected with any item or block,
+ * should be used in {@link ItemModel.setModelOverrideCallback}.
+ * @since 2.0.5b45
+ */
+ function newStandalone(): ItemModel;
+
+ /**
+ * @returns A collection of all existing item models.
+ */
+ function getAllModels(): java.util.Collection;
+
+ /**
+ * Releases some of the bitmaps to free up memory
+ * by run garbage cleaner.
+ * @param bytes bytes count to be released
+ */
+ function tryReleaseModelBitmapsOnLowMemory(bytes: number): void;
+
+ interface ModelOverrideFunction {
+ (item: ItemInstance): ItemModel
+ }
+
+ interface IconRebuildListener {
+ (model: ItemModel, newIcon: android.graphics.Bitmap): void
+ }
+
+ /**
+ * @returns Empty {@link RenderMesh} from the pool or creates an empty one. Used
+ * to reduce constructors/destructors calls.
+ */
+ function getEmptyMeshFromPool(): RenderMesh;
+
+ /**
+ * Releases {@link RenderMesh} and returns it to the pool. Used to reduce
+ * constructors/destructors calls.
+ */
+ function releaseMesh(mesh: RenderMesh): void;
+
+ /**
+ * @param randomize if true, item mesh position is randomized
+ * @returns New {@link RenderMesh} generated for specified item.
+ */
+ function getItemRenderMeshFor(id: number, count: number, data: number, randomize: boolean): RenderMesh;
+
+ /**
+ * @param id item or block numeric ID
+ * @param data item or block data
+ * @returns Texture name for the specified item or block.
+ */
+ function getItemMeshTextureFor(id: number, data: number): string;
+}
+
+/**
+ * Class representing item model in player's hand and/or inventory. To get an instance of this
+ * class from your code, use {@link ItemModel.getFor} static function.
+ * @remarks
+ * The coordinates of the full block in player's hand or inventory is
+ * (0, 0, 0), (1, 1, 1), so it is generally recommended to use the models
+ * that fit that bound at least for the inventory.
+ * @since 2.0.2b20
+ */
+declare interface ItemModel {
+ /**
+ * Item or block ID current {@link ItemModel} relates to.
+ */
+ readonly id: number;
+
+ /**
+ * Item or block data current {@link ItemModel} relates to.
+ */
+ readonly data: number;
+
+ occupy(): ItemModel;
+
+ isSpriteInUi(): boolean;
+
+ isEmptyInUi(): boolean;
+
+ isSpriteInWorld(): boolean;
+
+ isEmptyInWorld(): boolean;
+
+ /**
+ * @returns `true`, if the model is empty.
+ */
+ isEmpty(): boolean;
+
+ isNonExistant(): boolean;
+
+ /**
+ * @returns `true`, if this item model overrides the default model in player's hand.
+ */
+ overridesHand(): boolean;
+
+ /**
+ * @returns `true`, if this item model overrides the default model in player's inventory.
+ */
+ overridesUi(): boolean;
+
+ getShaderUniforms(): ShaderUniformSet;
+
+ /**
+ * Determines whether an item should be displayed as a sprite within
+ * inventory, or if a model should be used instead, which can be
+ * particularly relevant for items such as blocks.
+ */
+ setSpriteUiRender(isSprite: boolean): ItemModel;
+
+ /**
+ * Determines whether an item being held in the hand should be displayed
+ * as a sprite, or if a model should be used instead, which can be
+ * particularly relevant for items such as blocks.
+ * @since 2.3.1b115
+ */
+ setSpriteHandRender(isSprite: boolean): ItemModel;
+
+ /**
+ * Sets item's model to display both in the inventory and in hand.
+ * @param model {@link RenderMesh}, {@link ICRender.Model} or {@link BlockRenderer.Model} to be used as item model
+ * @param texture texture name to be used for the model (use `"atlas::terrain"` for block textures)
+ * @param material material name to be used for the model
+ */
+ setModel(model: RenderMesh | ICRender.Model | BlockRenderer.Model, texture?: string, material?: string): ItemModel;
+
+ /**
+ * Sets item's model to display only in player's hand.
+ * @param model {@link RenderMesh}, {@link ICRender.Model} or {@link BlockRenderer.Model} to be used as item model
+ * @param texture texture name to be used for the model (use `"atlas::terrain"` for block textures)
+ * @param material material name to be used for the model
+ */
+ setHandModel(model: RenderMesh | ICRender.Model | BlockRenderer.Model, texture?: string, material?: string): ItemModel;
+
+ /**
+ * Sets item's model to display only in player's inventory.
+ * @param model {@link RenderMesh}, {@link ICRender.Model} or {@link BlockRenderer.Model} to be used as item model
+ * @param texture texture name to be used for the model (use `"atlas::terrain"` for block textures)
+ * @param material material name to be used for the model
+ */
+ setUiModel(model: RenderMesh | ICRender.Model | BlockRenderer.Model, texture?: string, material?: string): ItemModel;
+
+ /**
+ * Sets item model's texture in both player's inventory and in hand.
+ * @param texture texture name to be used for the model (use `"atlas::terrain"` for block textures)
+ */
+ setTexture(texture: string): ItemModel;
+
+ /**
+ * Sets item model's texture only in player's hand.
+ * @param texture texture name to be used for the model (use `"atlas::terrain"` for block textures)
+ */
+ setHandTexture(texture: string): ItemModel;
+
+ /**
+ * Sets item model's texture only in player's inventory.
+ * @param texture texture name to be used for the model (use `"atlas::terrain" `for block textures)
+ */
+ setUiTexture(texture: string): ItemModel;
+
+ /**
+ * Sets item model's material in both player's inventory and in hand.
+ * @param texture material name to be used for the model.
+ */
+ setMaterial(texture: string): ItemModel;
+
+ /**
+ * Sets item model's material only in player's hand.
+ * @param texture material name to be used for the model
+ */
+ setHandMaterial(texture: string): ItemModel;
+
+ /**
+ * Sets item model's material only in player's inventory.
+ * @param texture material name to be used for the model
+ */
+ setUiMaterial(texture: string): ItemModel;
+
+ setGlintMaterial(material: string): ItemModel;
+
+ setHandGlintMaterial(material: string): ItemModel;
+
+ setUiGlintMaterial(material: string): ItemModel;
+
+ getUiTextureName(): string;
+
+ getWorldTextureName(): string;
+
+ getUiMaterialName(): string;
+
+ getWorldMaterialName(): string;
+
+ getUiGlintMaterialName(): string;
+
+ getWorldGlintMaterialName(): string;
+
+ newTexture(): android.graphics.Bitmap;
+
+ getSpriteMesh(): RenderMesh;
+
+ addToMesh(mesh: RenderMesh, x: number, y: number, z: number): void;
+
+ getMeshTextureName(): string;
+
+ setItemTexturePath(path: string): ItemModel;
+
+ setItemTexture(name: string, index: number): ItemModel;
+
+ removeModUiSpriteTexture(): ItemModel;
+
+ setModUiSpritePath(path: string): ItemModel;
+
+ setModUiSpriteName(name: string, index: number): ItemModel;
+
+ setModUiSpriteBitmap(bitmap: android.graphics.Bitmap): ItemModel;
+
+ getModelForItemInstance(id: number, count: number, data: number, extra: ItemExtraData): ItemModel;
+
+ /**
+ * @since 2.0.5b45
+ */
+ setModelOverrideCallback(callback: ItemModel.ModelOverrideFunction): ItemModel;
+
+ isUsingOverrideCallback(): boolean;
+
+ releaseIcon(): void;
+
+ reloadIconIfDirty(): void;
+
+ getIconBitmap(): android.graphics.Bitmap;
+
+ getIconBitmapNoReload(): android.graphics.Bitmap;
+
+ reloadIcon(): void;
+
+ queueReload(listener?: ItemModel.IconRebuildListener): android.graphics.Bitmap;
+
+ setCacheKey(key: string): void;
+
+ getCacheKey(): string;
+
+ updateForBlockVariant(variant: any): void;
+
+ getItemRenderMesh(count: number, randomize: boolean): RenderMesh;
+}
diff --git a/api/core-engine/LiquidRegistry.d.ts b/api/core-engine/LiquidRegistry.d.ts
new file mode 100644
index 000000000..054a5a9c8
--- /dev/null
+++ b/api/core-engine/LiquidRegistry.d.ts
@@ -0,0 +1,97 @@
+declare namespace LiquidRegistry {
+ /**
+ * @internal
+ */
+ const liquids: { [key: string]: LiquidData };
+ function registerLiquid(key: string, name?: string, uiTextures?: string[], modelTextures?: string[]): void;
+ function getLiquidData(key: string): LiquidData;
+ function isExists(key: string): boolean;
+ function getLiquidName(key: string): string;
+ function getLiquidUITexture(key: string, width: number, height: number): string;
+ function getLiquidUIBitmap(key: string, width: number, height: number): android.graphics.Bitmap;
+ /**
+ * @since 2.2.1b102
+ */
+ function registerBlock(liquid: string, blockId: number, isDynamic: boolean): void;
+ function registerItem(liquid: string, empty: { id: number, data: number }, full: { id: number, data: number }): void;
+ function getEmptyItem(id: number, data: number): { id: number, data: number, liquid: string };
+ function getItemLiquid(id: number, data: number): string;
+ function getFullItem(id: number, data: number, liquid: string): { id: number, data: number };
+
+ interface LiquidData {
+ key: string,
+ name: string,
+ uiTextures: string[],
+ addUITexture(name: string): void,
+ modelTextures: string[],
+ addModelTexture(name: string): void,
+ blockId: number,
+ /**
+ * @since 2.2.1b103
+ */
+ staticBlockId: number,
+ uiCache: object
+ }
+
+ class Storage {
+ /**
+ * @internal
+ */
+ readonly liquidAmounts: { [key: string]: number };
+ /**
+ * @internal
+ */
+ readonly liquidLimits: { [key: string]: number };
+ readonly tileEntity: TileEntity;
+ constructor(tileEntity: TileEntity);
+ setParent(tileEntity: TileEntity): void;
+ getParent(): TileEntity;
+ hasDataFor(liquid: string): boolean;
+ setLimit(liquid: Nullable, limit: number): void;
+ getLimit(liquid: string): number;
+ getAmount(liquid: string): number;
+ getRelativeAmount(liquid: string): number;
+ /**
+ * @internal
+ */
+ _setContainerScale(container: UI.Container, scale: string, liquid: string, val: number): void;
+ updateUiScale(scale: string, liquid: string, container?: UI.Container): void;
+ setAmount(liquid: string, amount: number): void;
+ getLiquidStored(): Nullable;
+ isFull(liquid?: string): boolean;
+ isEmpty(liquid?: string): boolean;
+ addLiquid(liquid: string, amount: number, onlyFullAmount?: boolean): number;
+ getLiquid(liquid: string, amount: number, onlyFullAmount?: boolean): number;
+ }
+
+ /**
+ * @since 2.2.1b102
+ * @internal
+ */
+ const LiquidByBlock: { [blockId: number]: string };
+
+ /**
+ * @returns String ID of a liquid for given block,
+ * or `null`, if a block with given ID is not a liquid.
+ * @since 2.2.1b102
+ */
+ function getLiquidByBlock(id: number): Nullable;
+
+ /**
+ * @returns Numeric ID of the liquid block by given {@link LiquidRegistry} string ID.
+ * @remarks
+ * This function will return `0` if no liquid with given string ID exists.
+ * @since 2.2.1b102
+ */
+ function getBlockByLiquid(liquidId: string): number;
+
+ /**
+ * @param isStatic static liquid block ID will be returned, otherwise
+ * the dynamic block ID will be returned
+ * @returns Numeric ID of the liquid block by given {@link LiquidRegistry} string ID.
+ * @remarks
+ * This function will return `0` if no liquid with given string ID exists.
+ * @since 2.2.1b103
+ */
+ function getBlockByLiquid(liquidId: string, isStatic: boolean): number;
+}
diff --git a/api/core-engine/Logger.d.ts b/api/core-engine/Logger.d.ts
new file mode 100644
index 000000000..cce671fa6
--- /dev/null
+++ b/api/core-engine/Logger.d.ts
@@ -0,0 +1,53 @@
+/**
+ * Module used to log messages to Inner Core and internal log.
+ */
+declare namespace Logger {
+ /**
+ * Writes message to the log, using specified log prefix.
+ * @param message message to be logged
+ * @param prefix prefix of the message, can be used to filter log
+ * @remarks
+ * It will be writed to `[/D] ` as-is,
+ * where prefix will be **MOD** if it not specified.
+ */
+ function Log(message: string, prefix?: string): void;
+
+ /**
+ * Writes debugging message to log, using specified tag.
+ * @remarks
+ * It will be writed to `[/D] ` as-is.
+ * @since 2.2.0b77
+ */
+ function debug(tag: string, message: string): void;
+
+ /**
+ * Writes information message to log, using specified tag.
+ * @remarks
+ * It will be writed to `[/I] ` as-is.
+ * @since 2.2.0b77
+ */
+ function info(tag: string, message: string): void;
+
+ /**
+ * Writes error message to log, using specified tag.
+ * If it writed before game startup finish, debugging
+ * log with all messages will appear.
+ * @remarks
+ * It will be writed to `[/E] ` as-is.
+ * If error also provided, it will be appended with
+ * same tag above error message.
+ * @since 2.2.0b77
+ */
+ function error(tag: string, message: string, error?: java.lang.Throwable): void;
+
+ /**
+ * Logs java Throwable with full stack trace to.
+ * @param error java Throwable to be logged
+ */
+ function LogError(error: java.lang.Throwable): void;
+
+ /**
+ * Writes logger content to file and clears all buffers.
+ */
+ function Flush(): void;
+}
diff --git a/api/core-engine/LowLevelUtils.d.ts b/api/core-engine/LowLevelUtils.d.ts
new file mode 100644
index 000000000..d93df7059
--- /dev/null
+++ b/api/core-engine/LowLevelUtils.d.ts
@@ -0,0 +1,142 @@
+/**
+ * Specific methods, for the most part, are designed to work
+ * with Inner Core internals and debug various data.
+ * @since 2.2.1b110
+ */
+declare namespace LowLevelUtils {
+ /**
+ * Same as {@link Network} namespace.
+ */
+ function getNetwork(): typeof Network;
+ /**
+ * Same as {@link Game.simulateBackPressed}.
+ */
+ function simulateBackPressed(): void;
+ /**
+ * Same as {@link UI.getContext}.
+ */
+ function getContext(): android.app.Activity;
+ /**
+ * Calls an action in the Android interface thread.
+ * Any unexpected errors here will lead to the closure
+ * of the game, please add `try-catch` blocks to prevent this.
+ */
+ function runAsUi(func: () => void): void;
+ /**
+ * Displays dialog with given message and without title.
+ */
+ function debugStr(message: string): void;
+ /**
+ * Displays dialog with given bitmap image and title
+ * " bitmap \x\".
+ */
+ function debugBmp(bitmap: android.graphics.Bitmap): void;
+ /**
+ * Same as {@link Game.getMinecraftVersion}.
+ */
+ function getMinecraftVersion(): string;
+ /**
+ * @returns `"2.0.0.0"`
+ */
+ function getInnerCoreVersion(): string;
+ /**
+ * @throws Java {@link java.lang.RuntimeException} with specified message.
+ */
+ function throwException(message: string): void;
+ /**
+ * Dumps AdaptedScript API hieracly to log with debug priority.
+ */
+ function debugAPILookUp(): void;
+ /**
+ * Same as {@link runOnMainThread}.
+ */
+ function runOnMainThread(func: () => void): void;
+ /**
+ * Same as {@link runOnClientThread}.
+ */
+ function runOnClientThread(func: () => void): void;
+ /**
+ * Changes bottom label on mod loading screen, it is recommended to use
+ * it for debugging or visualization of long work during startup.
+ */
+ function setLoadingTip(tip: string): void;
+ /**
+ * @deprecated
+ */
+ function setNativeThreadPriority(priority: number): void;
+ /**
+ * Causes a native error, which immediately leads
+ * to the forced closure of the game.
+ */
+ function forceNativeCrash(): void;
+ /**
+ * Same as {@link Game.isActionPrevented}.
+ */
+ function isDefaultPrevented(): boolean;
+ /**
+ * Gets status of server tick, e.g. is tick disabled due to error.
+ * After restarting the world/server, this state is reset.
+ */
+ function isMainThreadStopped(): boolean;
+ /**
+ * Executes any code in the script body of a given object,
+ * the object itself becomes a local list of variables for code execution.
+ * @param code text to evaluate in given scope
+ * @param scope object in which context code is executed
+ * @param name script name for errors, debugging, etc.
+ * @since 2.2.0b76
+ */
+ function evalInScope(code: string, scope: object, name: string): object;
+
+ /**
+ * Creates an empty resource or behavior pack with a manifest
+ * to add content during mod loading. Please use names without
+ * special characters and only with ASCII characters.
+ * @param name pack title to be used for folder and displayed in
+ * pack list; folder will receive "runtime_\" name and title
+ * in interface will be "runtime pack: \"
+ */
+ function addRuntimePack(type: "resource" | "behavior" | "behaviour", name: string): string;
+
+ interface ICustomErrorCallback {
+ /**
+ * @param message html-formatted message of error, what was happened
+ * @param error throwable, that was catched by logger
+ * @param log html-formatted log of error
+ * @param stacktrace html-formatted stacktrace of error
+ * @remarks
+ * At the moment, log is persistent and it generation takes some time.
+ */
+ (message: string, error: Nullable, log: string, stacktrace: Nullable): boolean;
+ }
+
+ /**
+ * Instead of displaying fatal error type in dialog with a log,
+ * the specified function will be called to change this behavior.
+ */
+ function setCustomFatalErrorCallback(callback: ICustomErrorCallback): void;
+ /**
+ * Instead of displaying non-fatal error type in dialog with a log,
+ * the specified function will be called to change this behavior.
+ */
+ function setCustomNonFatalErrorCallback(callback: ICustomErrorCallback): void;
+ /**
+ * Instead of displaying startup error type in dialog with a log,
+ * the specified function will be called to change this behavior.
+ * For startup errors, only message and recent log are available,
+ * all other data will be passed as `null`.
+ */
+ function setCustomStartupErrorCallback(callback: ICustomErrorCallback): void;
+
+ /**
+ * Marking for current thread, unknown thread are used by default
+ * if this thread is not indented to be server or client-side.
+ */
+ type ThreadTypeMarker = "CLIENT" | "SERVER" | "UNKNOWN";
+
+ /**
+ * It can be used to make sure that an action is performed in
+ * intended thread, e.g. sending packet to clients on server.
+ */
+ function getCurrentThreadType(): ThreadTypeMarker;
+}
diff --git a/api/core-engine/ModAPI.d.ts b/api/core-engine/ModAPI.d.ts
new file mode 100644
index 000000000..b6ec727de
--- /dev/null
+++ b/api/core-engine/ModAPI.d.ts
@@ -0,0 +1,182 @@
+/**
+ * Module used to share mods' APIs.
+ */
+declare namespace ModAPI {
+ /**
+ * Collects registered APIs objects, use {@link ModAPI.requireAPI}
+ * to directly access required instance.
+ * @internal
+ */
+ const modAPIs: {
+ [name: string]: { api: string, descr: ModDocumentation }
+ };
+
+ /**
+ * Registers new API for the mod and invokes mod API callback.
+ * @param name API name used to import it in the other mods
+ * @param api object that is shared with the other mods; may contain other
+ * objects, methods, variables, etc.
+ * @param descr simple documentation for the mod API
+ *
+ * @remarks
+ * Sometimes it is useful to provide the
+ * ability to run third party code in your own mod, you can create a method
+ * that provides such possibility:
+ * ```js
+ * requireGlobal(command) {
+ * return eval(command);
+ * }
+ * ```
+ */
+ function registerAPI(name: string, api: object, descr?: {
+ /**
+ * Full name of the API, if not specified, name parameter
+ * value is used.
+ */
+ name?: string,
+ /**
+ * Object containing descriptions of methods and
+ * properties of the API, where keys are methods and properties names and
+ * values are their descriptions.
+ * @deprecated Writing documentation that way is not recommended.
+ */
+ props?: object
+ }): void;
+
+ /**
+ * Gets API by it's name. The best approach is to call this method in the
+ * function passed as the second parameter of {@link ModAPI.addAPICallback}.
+ * @param name API name from {@link ModAPI.registerAPI} call
+ * @returns API object if an API with specified was previously registered,
+ * `null` otherwise.
+ *
+ * @example
+ * Importing API registered by IndustrialCraft PE:
+ * ```js
+ * let ICore = null;
+ * ModAPI.addAPICallback("ICore", function(api) {
+ * ICore = api;
+ * });
+ * ```
+ * When using ICore variable from the example, be sure to check it for `null`
+ * because Industrial Craft PE may not be installed on the user's phone.
+ */
+ function requireAPI(name: string): Nullable;
+
+ /**
+ * Executes string in Core Engine's global context. Can be used to get
+ * functions and objects directly from Adapted Script.
+ * @param name string to be executed in Core Engine's global context
+ * @returns `null` if execution failed or appropriate variable same.
+ */
+ function requireGlobal(name: string): any;
+
+ /**
+ * Objects used to represent mod API documentation.
+ */
+ interface ModDocumentation {
+ /**
+ * Full name of the API.
+ */
+ name: string,
+ /**
+ * Object containing descriptions of methods and properties of the API,
+ * where keys are methods and properties names and values are their descriptions.
+ */
+ props: object
+ }
+
+ /**
+ * @param name API name from {@link ModAPI.registerAPI} call
+ * @returns Documentation for the specified mod API.
+ * @deprecated Writing documentation that way is not recommended.
+ */
+ function requireAPIdoc(name: string): Nullable;
+
+ /**
+ * Fetches information about the method or property of mod API.
+ * @param name API name from {@link ModAPI.registerAPI} call
+ * @param prop property or method name
+ * @returns String description of the method or null if no description was
+ * provided by API vendor.
+ * @deprecated Writing documentation that way is not recommended.
+ */
+ function requireAPIPropertyDoc(name: string, prop: string): Nullable;
+
+ /**
+ * Adds callback for the specified mod API.
+ * @param apiName API name from {@link ModAPI.registerAPI} call
+ * @param func callback that is called when API is loaded
+ */
+ function addAPICallback(apiName: string, func:
+ /**
+ * @param api shared mod API
+ */
+ (api: object) => void
+ ): void;
+
+ /**
+ * Recursively copies (duplicates) the value to the new one.
+ * @param api an object to be copied
+ * @param recursive if `true`, copies the object recursively
+ * @returns A copy of the object.
+ */
+ function cloneAPI(api: T, recursive?: boolean): T;
+
+ /**
+ * Ensures target object has all the properties the source object has, if
+ * not, copies them from source to target object.
+ * @param source object to copy missing values from
+ * @param target object to copy missing values to
+ */
+ function inheritPrototypes
+ (source: K, target: T): K & T;
+
+ /**
+ * Recursively clones object to the new one counting call depth and
+ * interrupting copying after 7th recursion call.
+ * @param source an object to be cloned
+ * @param recursive if `true`, copies the object recursively
+ * @param depth current recursion state, if > 6, recursion stops; default
+ * value is 0
+ * @returns Cloned object, all the properties that are less then 8 in
+ * depth, get copied.
+ */
+ function cloneObject(source: T, recursive?: boolean, depth?: number): T;
+
+ /**
+ * Same as {@link ModAPI.cloneObject}, but if call depth is more then
+ * 6, inserts `"stackoverflow"` string value otherwise.
+ */
+ function debugCloneObject(source: T, recursive?: boolean, depth?: number): T | string;
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function getModByName(modName: string): void;
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function isModLoaded(modName: string): void;
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function addModCallback(modName: string, func: any): void;
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function getModList(): string[];
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function getModPEList(): string[];
+
+ /**
+ * @deprecated No longer supported.
+ */
+ function addTexturePack(path: any): void;
+}
diff --git a/api/core-engine/ModJsAdapter.d.ts b/api/core-engine/ModJsAdapter.d.ts
new file mode 100644
index 000000000..85f0c0e60
--- /dev/null
+++ b/api/core-engine/ModJsAdapter.d.ts
@@ -0,0 +1,159 @@
+declare namespace Mod {
+
+ /**
+ * + 0 - RELEASE
+ * + 1 - DEVELOP
+ */
+ type BuildType = number;
+
+ /**
+ * + 0 - RESOURCE
+ * + 1 - GUI
+ */
+ type ResourceDirType = number;
+
+ /**
+ * + 0 - PRELOADER
+ * + 1 - LAUNCHER
+ * + 2 - MOD
+ * + 3 - CUSTOM
+ * + 4 - LIBRARY
+ */
+ type SourceType = number;
+
+ interface BuildConfig {
+ buildableDirs: java.util.ArrayList;
+ defaultConfig: BuildConfig.DefaultConfig;
+ javaDirectories: java.util.ArrayList;
+ nativeDirectories: java.util.ArrayList;
+ resourceDirs: java.util.ArrayList;
+ sourcesToCompile: java.util.ArrayList;
+
+ save(file: java.io.File): void;
+ save(): void;
+ isValid(): boolean;
+ validate(): void;
+ read(): boolean;
+ getBuildType(): BuildType;
+ getDefaultAPI(): any;
+ getName(): string;
+ getAllSourcesToCompile(useApi: boolean): java.util.ArrayList;
+ findRelatedBuildableDir(source: BuildConfig.Source): BuildConfig.BuildableDir;
+ }
+
+ namespace BuildConfig {
+
+ interface DeclaredDirectory {
+ readonly path: string;
+ readonly version: any;
+
+ getFile(root: java.io.File): java.io.File;
+ }
+
+ interface DefaultConfig {
+ apiInstance: any;
+ behaviorPacksDir: Nullable;
+ buildType: BuildType;
+ readonly gameVersion: any;
+ json: org.json.JSONObject;
+ libDir: Nullable;
+ optimizationLevel: number;
+ resourcePacksDir: Nullable;
+ setupScriptDir: Nullable;
+
+ setAPI(api: any): void;
+ setOptimizationLevel(level: number): void;
+ setBuildType(type: BuildType): void;
+ setLibDir(dir: string): void;
+ setMinecraftResourcePacksDir(dir: string): void;
+ setMinecraftBehaviorPacksDir(dir: string): void;
+ setSetupScriptDir(dir: string): void;
+ }
+
+ interface BuildableDir {
+ dir: string;
+ json: org.json.JSONObject;
+ targetSource: string;
+
+ setDir(dir: string): void;
+ setTargetSource(dir: string): void;
+ isRelatedSource(source: Source): boolean;
+ }
+
+ interface ResourceDir {
+ readonly gameVersion: any;
+ json: org.json.JSONObject;
+ resourceType: ResourceDirType;
+
+ setPath(path: string): void;
+ setResourceType(type: ResourceDirType): void;
+ }
+
+ interface Source {
+ apiInstance: any;
+ readonly gameVersion: any;
+ json: org.json.JSONObject;
+ optimizationLevel: number;
+ path: string;
+ sourceName: string;
+ sourceType: SourceType;
+
+ setPath(path: string): void;
+ setSourceName(sourceName: string): void;
+ setSourceType(type: SourceType): void;
+ setOptimizationLevel(level: number): void;
+ setAPI(api: any): void;
+
+ }
+ }
+
+ interface CompiledSources {
+ saveSourceList(): void;
+ getCompiledSourceFilesFor(name: string): java.io.File[];
+ addCompiledSource(name: string, file: java.io.File, className: string): void;
+ getTargetCompilationFile(sourcePath: string): java.io.File;
+ reset(): void;
+ }
+
+ interface ModJsAdapter {
+ buildConfig: BuildConfig;
+ config: Config;
+ dir: string;
+ isEnabled: boolean;
+ isModRunning: boolean;
+
+ /**
+ * @since 2.2.1b85
+ */
+ setModPackAndLocation(pack: ModPack.ModPack, locationName: string): void;
+ /**
+ * @since 2.2.1b85
+ */
+ getModPack(): ModPack.ModPack;
+ /**
+ * @since 2.2.1b85
+ */
+ getModPackLocationName(): string;
+ getConfig(): Config;
+ createCompiledSources(): CompiledSources;
+ onImport(): void;
+ getBuildType(): BuildType;
+ setBuildType(type: BuildType): void;
+ setBuildType(type: "release" | "develop"): void;
+ getGuiIcon(): string;
+ getName(): string;
+ getVersion(): string;
+ isClientOnly(): boolean;
+ isConfiguredForMultiplayer(): boolean;
+ getMultiplayerName(): string;
+ getMultiplayerVersion(): string;
+ getFormattedAPIName(): string;
+ getInfoProperty(name: string): string;
+ RunPreloaderScripts(): void;
+ RunLauncherScripts(): void;
+ RunMod(additionalScope: any): void;
+ configureMultiplayer(name: string, version: string, isClientOnly: boolean): void;
+ runCustomSource(name: string, additionalScope: any): void;
+ }
+
+}
diff --git a/api/core-engine/ModPackJsAdapter.d.ts b/api/core-engine/ModPackJsAdapter.d.ts
new file mode 100644
index 000000000..ad5f6a653
--- /dev/null
+++ b/api/core-engine/ModPackJsAdapter.d.ts
@@ -0,0 +1,269 @@
+/**
+ * @since 2.2.1b85
+ */
+declare namespace ModPack {
+
+ /**
+ * Crutch to replace ModPackManifest.DeclaredDirectoryType enum:
+ * + 0 - RESOURCE
+ * + 1 - USER_DATA
+ * + 2 - CONFIG
+ * + 3 - CACHE
+ * + 4 - INVALID
+ */
+ type ModPackDeclaredDirectoryType = number;
+
+ /**
+ * Crutch to replace ModPackDirectory.DirectoryType enum:
+ * + 0 - MODS
+ * + 1 - MOD_ASSETS
+ * + 2 - ENGINE
+ * + 3 - CONFIG
+ * + 4 - CACHE
+ * + 5 - RESOURCE_PACKS
+ * + 6 - BEHAVIOR_PACKS
+ * + 7 - TEXTURE_PACKS
+ * + 8 - CUSTOM
+ */
+ type ModPackDirectoryType = number;
+
+ interface ModPack {
+
+ addDirectory(directory: ModPackDirectory): ModPack;
+
+ getRootDirectory(): java.io.File;
+
+ getManifestFile(): java.io.File;
+
+ getIconFile(): java.io.File;
+
+ /**
+ * @since 2.3.1b116
+ */
+ getExternalServersFile(): java.io.File;
+
+ getManifest(): ModPackManifest;
+
+ getPreferences(): ModPackPreferences;
+
+ getJsAdapter(): ModPackJsAdapter;
+
+ reloadAndValidateManifest(): boolean;
+
+ getAllDirectories(): java.util.List;
+
+ getDirectoriesOfType(type: ModPackDirectoryType): java.util.List;
+
+ getDirectoryOfType(type: ModPackDirectoryType): ModPackDirectory;
+
+ getRequestHandler(type: ModPackDirectoryType): DirectorySetRequestHandler;
+
+ }
+
+ interface ModPackManifest {
+
+ loadJson(json: org.json.JSONObject): void;
+
+ loadInputStream(stream: java.io.InputStream): void;
+
+ loadFile(file: java.io.File): void;
+
+ getPackName(): string;
+
+ getDisplayedName(): string;
+
+ getVersionName(): string;
+
+ getVersionCode(): number;
+
+ getDescription(): string;
+
+ getAuthor(): string;
+
+ getDeclaredDirectories(): java.util.List;
+
+ createDeclaredDirectoriesForModPack(pack: ModPack): java.util.List;
+
+ setPackName(name: string): void;
+
+ setDisplayedName(name: string): void;
+
+ setVersionCode(code: number): void;
+
+ setVersionName(name: string): void;
+
+ setAuthor(author: string): void;
+
+ setDescription(descr: string): void;
+
+ edit(): ModPackManifestEditor;
+
+ }
+
+ interface ModPackManifestEditor {
+
+ addIfMissing(key: string, value: any): ModPackManifestEditor;
+
+ put(key: string, value: any): ModPackManifestEditor;
+
+ commit(): void;
+
+ }
+
+ interface ModPackPreferences {
+
+ getModPack(): ModPack;
+
+ getFile(): java.io.File;
+
+ reload(): ModPackPreferences;
+
+ save(): ModPackPreferences;
+
+ getString(key: string, fallback: string): string;
+
+ getInt(key: string, fallback: number): number;
+
+ getLong(key: string, fallback: number): number;
+
+ getDouble(key: string, fallback: number): number;
+
+ getBoolean(key: string, fallback: boolean): boolean;
+
+ setString(key: string, value: string): ModPackPreferences;
+
+ setInt(key: string, value: number): ModPackPreferences;
+
+ setLong(key: string, value: number): ModPackPreferences;
+
+ setDouble(key: string, value: number): ModPackPreferences;
+
+ setBoolean(key: string, value: boolean): ModPackPreferences;
+
+ }
+
+ interface ModPackDirectory {
+
+ assureDirectoryRoot(): boolean;
+
+ assignToModPack(pack: ModPack): void;
+
+ getType(): ModPackDirectoryType;
+
+ getLocation(): java.io.File;
+
+ getPathPattern(): string;
+
+ getPathPatternRegex(): java.util.regex.Pattern;
+
+ getLocalPathFromEntry(entryName: string): string;
+
+ getRequestStrategy(): DirectoryRequestStrategy;
+
+ getUpdateStrategy(): DirectoryUpdateStrategy;
+
+ getExtractStrategy(): DirectoryExtractStrategy;
+
+ }
+
+ interface DirectorySetRequestHandler {
+
+ getDirectories(): java.util.List;
+
+ add(dir: ModPackDirectory): void;
+
+ get(location: string, name: string): java.io.File;
+
+ get(location: string): java.io.File;
+
+ getAllAtLocation(location: string): java.util.List;
+
+ getAllLocations(): java.util.List;
+
+ }
+
+ interface ModPackDeclaredDirectory {
+
+ readonly path: string;
+ readonly type: ModPackDeclaredDirectoryType;
+
+ getPath(): string;
+
+ getType(): ModPackDeclaredDirectoryType;
+
+ }
+
+ interface IDirectoryAssignable {
+
+ assignToDirectory(dir: ModPackDirectory): void;
+
+ getAssignedDirectory(): ModPackDeclaredDirectory;
+
+ }
+
+ interface DirectoryRequestStrategy extends IDirectoryAssignable {
+
+ get(str: string): java.io.File;
+
+ get(str: string, str2: string): java.io.File;
+
+ getAll(str: string): java.util.List;
+
+ getAllLocations(): java.util.List;
+
+ assure(location: string, name: string): java.io.File;
+
+ remove(location: string, name: string): boolean;
+
+ getAllFiles(): java.util.List;
+
+ }
+
+ interface DirectoryUpdateStrategy extends IDirectoryAssignable {
+
+ beginUpdate(): void;
+
+ finishUpdate(): void;
+
+ updateFile(str: string, stream: java.io.InputStream): void;
+
+ }
+
+ interface DirectoryExtractStrategy extends IDirectoryAssignable {
+
+ getEntryName(str: string, file: java.io.File): string;
+
+ getFilesToExtract(): java.util.List;
+
+ getFullEntryName(file: java.io.File): string;
+
+ }
+
+ /**
+ * Interface representing ModPack.
+ */
+ interface ModPackJsAdapter {
+
+ getModPack(): ModPack;
+
+ getRootDirectory(): java.io.File;
+
+ getRootDirectoryPath(): string;
+
+ getModsDirectoryPath(): string;
+
+ getManifest(): ModPackManifest;
+
+ getPreferences(): ModPackPreferences;
+
+ getRequestHandler(type: string): DirectorySetRequestHandler;
+
+ getAllDirectories(): ModPackDirectory[];
+
+ getDirectoriesOfType(type: string): ModPackDirectory[];
+
+ getDirectoryOfType(type: string): ModPackDirectory;
+
+ }
+
+}
diff --git a/api/core-engine/NBT.d.ts b/api/core-engine/NBT.d.ts
new file mode 100644
index 000000000..4667ebbee
--- /dev/null
+++ b/api/core-engine/NBT.d.ts
@@ -0,0 +1,1565 @@
+/**
+ * NBT (Named Binary Tag) is a tag based binary format designed to carry large
+ * amounts of binary data with smaller amounts of additional data.
+ * You can get or set nbt tags of {@link Entity entities},
+ * {@link NativeTileEntity native tile entities (such as chests or beacons)} and
+ * {@link ItemExtraData items}. To get more information about these data structures,
+ * see {@link http://web.archive.org/web/20110723210920/http://www.minecraft.net/docs/NBT.txt this page}.
+ */
+declare namespace NBT {
+ /**
+ * List tags represent NBT map-like data structure (key-value pairs). it's values may
+ * be of any type, so check the type before calling the appropriate getter.
+ */
+ class CompoundTag {
+ /**
+ * Creates a new compound tag.
+ */
+ constructor();
+
+ /**
+ * Creates a copy of specified compound tag.
+ */
+ constructor(tag: CompoundTag);
+
+ /**
+ * Converts compound tag to JavaScript object for easier reading.
+ * @returns Valid JavaScript representation of compound tag.
+ */
+ toScriptable(): Scriptable;
+
+ /**
+ * @returns Java-array containing all the keys of the compound tag.
+ */
+ getAllKeys(): native.Array;
+
+ /**
+ * @returns `true` if specified key exists in compound tag.
+ */
+ contains(key: string): boolean;
+
+ /**
+ * @param key key to verify for the type
+ * @param type tag type to verify for, one of the {@link ENbtDataType} constants
+ * @returns `true` if specified key exists in compound tag and it's value is
+ * of specified type.
+ */
+ containsValueOfType(key: string, type: number): boolean;
+
+ /**
+ * @returns Value type for the specified key. One of the {@link ENbtDataType}
+ * constants.
+ */
+ getValueType(key: string): number;
+
+ /**
+ * @returns NBT tag of byte type by it's key.
+ */
+ getByte(key: string): number;
+
+ /**
+ * @returns NBT tag of short type by it's key.
+ */
+ getShort(key: string): number;
+
+ /**
+ * @returns NBT tag of 32-bit integer type by it's key.
+ */
+ getInt(key: string): number;
+
+ /**
+ * @returns NBT tag of 64-bit integer type by it's key.
+ */
+ getInt64(key: string): number;
+
+ /**
+ * @returns NBT tag of float type by it's key.
+ */
+ getFloat(key: string): number;
+
+ /**
+ * @returns NBT tag of double type by it's key.
+ */
+ getDouble(key: string): number;
+
+ /**
+ * @returns NBT tag of string type by it's key.
+ */
+ getString(key: string): string;
+
+ /**
+ * @returns NBT tag of compound type by it's key. Note that a copy of
+ * existing compound tag is created so you cannot edit it directly. Use
+ * setCompoundTag method to apply changes or use
+ * {@link NBT.CompoundTag.getCompoundTagNoClone getCompoundTagNoClone} to edit it directly.
+ */
+ getCompoundTag(key: string): NBT.CompoundTag;
+
+ /**
+ * @returns Directly editable NBT tag of byte type by it's key. Don't save
+ * reference for future usage since they get destroyed when the parent
+ * object is destroyed.
+ */
+ getCompoundTagNoClone(key: string): NBT.CompoundTag;
+
+ /**
+ * @returns NBT tag of list type by it's key. Note that a copy of
+ * existing list tag is created so you cannot edit it directly. Use
+ * setCompoundTag method to apply changes or use
+ * {@link NBT.CompoundTag.getListTagNoClone getListTagNoClone} to edit it directly.
+ */
+ getListTag(key: string): NBT.ListTag;
+
+ /**
+ * @returns Directly editable NBT tag of byte type by it's key. Don't save
+ * reference for future usage since they get destroyed when the parent
+ * object is destroyed.
+ */
+ getListTagNoClone(key: string): NBT.ListTag;
+
+ /**
+ * Puts value of byte type into compound tag.
+ */
+ putByte(key: string, value: number): void;
+
+ /**
+ * Puts value of short type into compound tag.
+ */
+ putShort(key: string, value: number): void;
+
+ /**
+ * Puts value of 32-bit integer type into compound tag.
+ */
+ putInt(key: string, value: number): void;
+
+ /**
+ * Puts value of 64-bit integer type into compound tag.
+ */
+ putInt64(key: string, value: number): void;
+
+ /**
+ * Puts value of float type into compound tag.
+ */
+ putFloat(key: string, value: number): void;
+
+ /**
+ * Puts value of double type into compound tag.
+ */
+ putDouble(key: string, value: number): void;
+
+ /**
+ * Puts value of string type into compound tag.
+ */
+ putString(key: string, value: string): void;
+
+ /**
+ * Puts value of compound type into compound tag.
+ */
+ putCompoundTag(key: string, value: CompoundTag): void;
+
+ /**
+ * Puts value of list type into compound tag.
+ */
+ putListTag(key: string, value: ListTag): void;
+
+ /**
+ * Removes tag by it's key.
+ */
+ remove(key: string): void;
+
+ /**
+ * Removes all the tags from the compound tags.
+ */
+ clear(): void;
+ }
+
+
+ /**
+ * List tags represent NBT array-like indexed data structure. it's values may
+ * be of any type, so check the type before calling the appropriate getter.
+ */
+ class ListTag {
+ /**
+ * Creates a new list tag.
+ */
+ constructor();
+
+ /**
+ * Creates a copy of specified list tag.
+ */
+ constructor(tag: CompoundTag);
+
+ /**
+ * Converts list tag to JavaScript object for easier reading.
+ * @returns Valid JavaScript representation of list tag.
+ * @since 2.0.5b45
+ */
+ toScriptable(): any[];
+
+ /**
+ * @returns Count of the tags in the list tag.
+ */
+ length(): number;
+
+ /**
+ * @returns Value type for the specified index.
+ * One of the {@link ENbtDataType} constants.
+ */
+ getValueType(index: number): number;
+
+ /**
+ * @returns NBT tag of byte type by it's index.
+ */
+ getByte(index: number): number;
+
+ /**
+ * @returns NBT tag of short type by it's index.
+ */
+ getShort(index: number): number;
+
+ /**
+ * @returns NBT tag of 32-bit integer type by it's index.
+ */
+ getInt(index: number): number;
+
+ /**
+ * @returns NBT tag of 64-bit integer type by it's index.
+ */
+ getInt64(index: number): number;
+
+ /**
+ * @returns NBT tag of float type by it's index.
+ */
+ getFloat(index: number): number;
+
+ /**
+ * @returns NBT tag of double type by it's index.
+ */
+ getDouble(index: number): number;
+
+ /**
+ * @returns NBT tag of string type by it's index.
+ */
+ getString(index: number): string;
+
+ /**
+ * @returns NBT tag of compound type by it's index. Note that a copy of
+ * existing compound tag is created so you cannot edit it directly.
+ * Use setCompoundTag method to apply changes or use
+ * {@link NBT.CompoundTag.getCompoundTagNoClone getCompoundTagNoClone} to edit it directly.
+ */
+ getCompoundTag(index: number): NBT.CompoundTag;
+
+ /**
+ * @returns Directly editable NBT tag of byte type by it's index. Don't save
+ * reference for future usage since they get destroyed when the parent
+ * object is destroyed.
+ */
+ getCompoundTagNoClone(index: number): NBT.CompoundTag;
+
+ /**
+ * @returns NBT tag of list type by it's index. Note that a copy of
+ * existing list tag is created so you cannot edit it directly. Use
+ * setCompoundTag method to apply changes or use
+ * {@link NBT.CompoundTag.getListTagNoClone getListTagNoClone} to edit it directly.
+ */
+ getListTag(index: number): NBT.ListTag;
+
+ /**
+ * @returns Directly editable NBT tag of byte type by it's index. Don't save
+ * reference for future usage since they get destroyed when the parent
+ * object is destroyed.
+ */
+ getListTagNoClone(index: number): NBT.ListTag;
+
+ /**
+ * Puts value of byte type into list tag.
+ */
+ putByte(index: number, value: number): void;
+
+ /**
+ * Puts value of short type into list tag.
+ */
+ putShort(index: number, value: number): void;
+
+ /**
+ * Puts value of 32-bit integer type into list tag.
+ */
+ putInt(index: number, value: number): void;
+
+ /**
+ * Puts value of 64-bit integer type into list tag.
+ */
+ putInt64(index: number, value: number): void;
+
+ /**
+ * Puts value of float type into list tag.
+ */
+ putFloat(index: number, value: number): void;
+
+ /**
+ * Puts value of double type into list tag.
+ */
+ putDouble(index: number, value: number): void;
+
+ /**
+ * Puts value of string type into list tag.
+ */
+ putString(index: number, value: string): void;
+
+ /**
+ * Puts value of compound type into list tag.
+ */
+ putCompoundTag(index: number, value: CompoundTag): void;
+
+ /**
+ * Puts value of list type into list tag.
+ */
+ putListTag(index: number, value: ListTag): void;
+
+ /**
+ * Removes all the tags from the compound tags.
+ */
+ clear(): void;
+ }
+
+ /**
+ * Templates to typofication of resulted {@link CompoundTag.toScriptable},
+ * which is used to determine containment of tags.
+ * Not includes structure `.nbt`, only in-game definitions.
+ * @remarks
+ * Booleans still "bytes", which means it just omitted when
+ * comparing `.property == false` nor `.property === false`.
+ */
+ namespace Templates {
+ interface Block extends Scriptable {
+ name: string;
+ states: BlockState[];
+ /**
+ * Database tracking identifier (in 1.16 equals `17825808`).
+ */
+ version: number;
+ }
+
+ interface BlockState extends Scriptable {
+ }
+
+ interface Item = ItemTag> extends Scriptable {
+ Block?: Block;
+ /**
+ * Amount of item in slot.
+ */
+ Count: number;
+ /**
+ * Dealed damage, when it comes to {@link Item.getMaxDamage} item will be broken.
+ * @default 0 // not damaged at all
+ */
+ Damage: number;
+ /**
+ * Typed identifier, such as `"minecraft:stick"`.
+ */
+ Name: string;
+ /**
+ * Indexed slot, required in containers with more than one slots.
+ */
+ Slot?: number;
+ /**
+ * Picked up by entity, denies despawn it naturally.
+ */
+ WasPickedUp: boolean;
+ /**
+ * Additional data, such as nametags, enchantments, etc.
+ */
+ tag?: T;
+ }
+
+ interface ItemWritableBookTagPage extends Scriptable {
+ /**
+ * Screenshot shotted on server (appears in pause menu), specially based on Education Edition.
+ * @default ""
+ */
+ photoname: string;
+ /**
+ * Text placed on page as-is (with new lines `\n`).
+ */
+ text: string;
+ }
+
+ interface ItemTag extends Scriptable {
+ /**
+ * List of applied enchantments in index-numeral sorting.
+ */
+ ench?: ItemTagEnchantment[];
+ }
+
+ interface ItemFilledMapTag extends ItemTag {
+ /**
+ * Whether map should display compasses for players or not.
+ */
+ map_display_players: boolean;
+ /**
+ * Displayed for players map number, starts with `1`.
+ */
+ map_name_index: number;
+ /**
+ * UID to be taken from world NBT.
+ */
+ map_uuid: number;
+ }
+
+ interface ItemWritableBookTag extends ItemTag {
+ /**
+ * Written book author, assigned when signing book.
+ * @default "Author Unknown"
+ */
+ author?: string;
+ /**
+ * Number of written copy, `0` means original.
+ * @default 0
+ */
+ generation?: number;
+ /**
+ * List of created pages in index-numeral sorting.
+ */
+ pages: ItemWritableBookTagPage[];
+ /**
+ * Written book title, assigned when signing book.
+ */
+ title?: string;
+ /**
+ * Linked teacher book, especially for Education Edition.
+ * @default 0
+ */
+ xuid?: string;
+ }
+
+ interface ItemTagEnchantment extends Scriptable {
+ /**
+ * One of {@link EEnchantment} enum values.
+ */
+ id: number;
+ /**
+ * Level of strength, value between `0` and `255` (more buggy up to `32768`).
+ */
+ lvl: number;
+ }
+
+ interface Entity extends Scriptable {
+ /**
+ * Countdown in ticks before entity become adult.
+ */
+ Age?: number;
+ /**
+ * Countdown in ticks before entity start drowning.
+ */
+ Air: number;
+ /**
+ * Helmet, Chestplate, Leggings, Boots. Accessible by index, not marked with `Slot` property.
+ */
+ Armor: Item[];
+ /**
+ * Last attack tick, determines time between attacks.
+ */
+ AttackTime: number;
+ /**
+ * Entity attributes, such as `"minecraft:health"`, `"minecraft:follow_range"`, etc.
+ */
+ Attributes: EntityAttribute[];
+ /**
+ * Entity body yaw rotation in degrees, with offset of {@link Rotation}.
+ */
+ BodyRot: number;
+ /**
+ * Llama or mule equipped chests.
+ */
+ Chested: boolean;
+ Color: number;
+ Color2: number;
+ /**
+ * Entity is dead, which is required to visualize animation of dying.
+ */
+ Dead: boolean;
+ /**
+ * Tick when entity become dead (health <= 0).
+ */
+ DeathTime: number;
+ /**
+ * Last synchronized distance between ground and entity.
+ */
+ FallDistance: number;
+ /**
+ * Fire ticks before burning stopped, alternative of {@link Entity.setFire}.
+ */
+ Fire: number;
+ HasExecuted: false;
+ HomeDimensionId: number;
+ /**
+ * @default [-2147483648, -2147483648, -2147483648] // when not set
+ */
+ HomePos: number[];
+ /**
+ * Last hurt tick, determines entity panic/attack state.
+ */
+ HurtTime: number;
+ /**
+ * Immune to in-game damage types, such as NPCs and Agents.
+ */
+ Invulnerable: boolean;
+ /**
+ * Normally, entity become angry when attacked.
+ */
+ IsAngry: boolean;
+ /**
+ * Entity can move, alternative of {@link Entity.setMobile}.
+ */
+ IsAutonomous: boolean;
+ /**
+ * Entity is not adult, so when {@link Age} reaches `0` it is not baby.
+ */
+ IsBaby: boolean;
+ /**
+ * Entity is eating {@link Mainhand} item, displays particles around.
+ */
+ IsEating: boolean;
+ /**
+ * Entity is using elytra (to glide).
+ */
+ IsGliding: boolean;
+ IsGlobal: boolean;
+ /**
+ * Patrols of pillagers following their leader.
+ */
+ IsIllagerCaptain: boolean;
+ IsOrphaned: boolean;
+ IsOutOfControl: boolean;
+ /**
+ * Entity breeded and prepared to duplicate itself, such as turtles.
+ */
+ IsPregnant: boolean;
+ IsRoaring: boolean;
+ /**
+ * Entity sees dangerous thing around, such as villagers flee.
+ */
+ IsScared: boolean;
+ IsStunned: boolean;
+ /**
+ * Entity is standing on water.
+ */
+ IsSwimming: boolean;
+ /**
+ * Entity is tamed, such as cats or dogs.
+ */
+ IsTamed: boolean;
+ /**
+ * Entity is trusting player (do not panic when it came),
+ * such as foxes childs breeded by someone.
+ */
+ IsTrusting: boolean;
+ /**
+ * Dimension from entity transfered when is going to portal,
+ * last saved state when loaded into dimension.
+ */
+ LastDimensionId: number;
+ /**
+ * Leashed with knot entity (normally, player).
+ * @default -1
+ */
+ LeasherID: number;
+ /**
+ * Required on first death tick, drops loot again if set to `false`.
+ */
+ LootDropped: boolean;
+ /**
+ * @default 0 // when is not breeded
+ */
+ LoveCause: number;
+ /**
+ * Item set by {@link Entity.setCarriedItem}, entities uses it for attack and other AI-related things.
+ */
+ Mainhand: Item;
+ MarkVariant: number;
+ /**
+ * Velocity of physics in-world, vector of moving target.
+ */
+ Motion: number[];
+ /**
+ * Entity is naturally spawned, not breeded or summoned.
+ */
+ NaturalSpawn: boolean;
+ /**
+ * Item set by {@link Entity.setOffhandItem}, in common cases entities ignores it, but players or extra-powered items (Totem of Undying fully restores non-player entities health) are useful.
+ */
+ Offhand: Item;
+ /**
+ * Entity is standing on landing.
+ */
+ OnGround: boolean;
+ /**
+ * Projectile shooter entity UID.
+ * @default -1
+ */
+ OwnerNew: number;
+ /**
+ * Entity can not be despawned.
+ */
+ Persistent: boolean;
+ /**
+ * Ticks before entity can move through portal again.
+ */
+ PortalCooldown: number;
+ /**
+ * XYZ absolute coordinates, alternative of {@link Entity.setPosition}.
+ */
+ Pos: number[];
+ /**
+ * Yaw (horizontal rotation angle) and pitch (vertical rotation angle) respectively in degrees, alternative of {@link Entity.setLookAngle}.
+ */
+ Rotation: number[];
+ /**
+ * When pig or strider is saddled (excludes horses or not?).
+ */
+ Saddled: boolean;
+ /**
+ * When sheep or snow golem is sheared.
+ */
+ Sheared: boolean;
+ ShowBottom: boolean;
+ /**
+ * Entity is sitting, such as players or foxes.
+ */
+ Sitting: boolean;
+ SkinID: number;
+ Strength: number;
+ StrengthMax: number;
+ Surface: number;
+ Tags: string[];
+ /**
+ * Following, attacking or anything else targeted entity.
+ * @default -1
+ */
+ TargetID: number;
+ /**
+ * Tick when entity is born, used to {@link limitedLife} property.
+ */
+ TimeStamp: number;
+ TradeExperience: number;
+ TradeTier: number;
+ /**
+ * Entity UID, which is passed to Inner Core callbacks.
+ */
+ UniqueID: number;
+ Variant: number;
+ boundX: number;
+ boundY: number;
+ boundZ: number;
+ /**
+ * Entity may equip, take or replace containing item from drop.
+ */
+ canPickupItems: boolean;
+ /**
+ * Set of rules applied (starts with `+`) or excluded (starts with `-`)
+ * from entity; it includes properties, tasks, etc.
+ */
+ definitions: string[];
+ hasBoundOrigin: boolean;
+ hasSetCanPickupItems: boolean;
+ /**
+ * Typed entity identifier without tags, such as `"minecraft:cow"`.
+ */
+ identifier: string;
+ /**
+ * Ticks after {@link TimeStamp} when entity become {@link Dead}.
+ */
+ limitedLife: number;
+ }
+
+ interface EntityAttribute extends Scriptable {
+ Base: number;
+ Current: number;
+ DefaultMax: number;
+ DefaultMin: number;
+ Max: number;
+ Min: number;
+ /**
+ * One of {@link Entity.Attribute} or your custom one.
+ */
+ Name: Entity.Attribute | string;
+ }
+
+ interface IBlockEntity extends Scriptable {
+ /**
+ * Typed identifier, such as `"Chest"`, `"Beacon"`, etc.
+ */
+ id: string;
+ /**
+ * Block Entity will be saved without instantiating new one when transporting (via pistons, commands, etc.).
+ */
+ isMovable: boolean;
+ x: number, y: number, z: number;
+ }
+
+ interface IContainerBlockEntity extends IBlockEntity {
+ /**
+ * Contained slots, which is stored in numeral-index sorting starting with zero.
+ * @remarks
+ * Normally, slot information removes when item became "air" (disappears), so please
+ * be careful when calling via `.Items[]` convention!
+ */
+ Items: Item[];
+ }
+
+ interface ILootableBlockEntity extends IContainerBlockEntity {
+ /**
+ * Exploration map can be pointed here, tract as treasure.
+ * @default false
+ */
+ Findable: boolean;
+ /**
+ * Definition to behavior pack path with extension, such as `"loot_tables/chests/end_city_treasure.json"`.
+ */
+ LootTable?: string;
+ /**
+ * Randomly generated seed to determine containment.
+ */
+ LootTableSeed?: number;
+ }
+
+ /**
+ * **Chest** (Chest / Trapped Chest) with `ID = 0`.
+ */
+ interface ChestBlockEntity extends ILootableBlockEntity {
+ id: "Chest";
+ /**
+ * If there's sometime created connection with double-chest.
+ */
+ pairlead?: boolean;
+ pairx?: number;
+ pairz?: number;
+ }
+
+ interface IFurnaceBlockEntity extends IContainerBlockEntity {
+ /**
+ * Currently burning fuel (appears in slot `1`) total time in ticks (e.g. coal burns in `1600` ticks) before burning completed.
+ * @default 0
+ */
+ BurnDuration: number;
+ /**
+ * Counter to {@link BurnDuration}, when them equals furnace unlit.
+ * @default 0
+ */
+ BurnTime: number;
+ /**
+ * Currently smelting item (appears in slot `0`) progress, result will be presented in slot with index `2`.
+ */
+ CookTime: number;
+ /**
+ * Accumulated experience, it will be dropped when result taken or furnace digged.
+ * @default 0
+ */
+ StoredXPInt: number;
+ }
+
+ /**
+ * **Furnace** with `ID = 1`.
+ */
+ interface FurnaceBlockEntity extends IFurnaceBlockEntity {
+ id: "Furnace";
+ }
+
+ /**
+ * **Hopper** with `ID = 2`.
+ */
+ interface HopperBlockEntity extends IContainerBlockEntity {
+ id: "Hopper";
+ /**
+ * Ticks counter before transfering to watching side or down if hoppers unlocked.
+ * @default 0
+ */
+ TransferCooldown: number;
+ }
+
+ /**
+ * **NetherReactor** (Nether Reactor Core) with `ID = 3`.
+ */
+ interface NetherReactorBlockEntity extends IBlockEntity {
+ id: "NetherReactor";
+ /**
+ * @default false
+ */
+ HasFinished: boolean;
+ /**
+ * @default false
+ */
+ IsInitialized: boolean;
+ /**
+ * @default 0
+ */
+ Progress: number;
+ }
+
+ /**
+ * **Sign** with `ID = 4`.
+ */
+ interface SignBlockEntity extends IBlockEntity {
+ id: "Sign";
+ /**
+ * Written text, delimited with newlines (`\n`, it may be more than 4 lines, but not rendered in-world).
+ */
+ Text: string;
+ /**
+ * No. Owners. Constant.
+ * @default ""
+ */
+ TextOwner: string;
+ /**
+ * Basic text color, {@link EColor.RESET} restores it.
+ */
+ Color?: string;
+ }
+
+ /**
+ * **MobSpawner** (Spawner) with `ID = 5`.
+ */
+ interface MobSpawnerBlockEntity extends IBlockEntity {
+ id: "MobSpawner";
+ /**
+ * Ticks before spawning next entity.
+ */
+ Delay: number;
+ /**
+ * Placeholder animation in spawner height, constant.
+ * @default 1.7999999523162842
+ */
+ DisplayEntityHeight: number;
+ /**
+ * Placeholder animation in spawner size relative to block itself.
+ */
+ DisplayEntityScale: number;
+ /**
+ * Placeholder animation in spawner width, constant.
+ * @default 0.6000000238418579
+ */
+ DisplayEntityWidth: number;
+ /**
+ * Typed entity identifier, such as `"minecraft:enderman"`.
+ * @default ""
+ */
+ EntityIdentifier: string;
+ /**
+ * Maximum containment mobs in {@link SpawnRange}, if here are more
+ * spawner just emitting particles.
+ * @default 6
+ */
+ MaxNearbyEntities: number;
+ /**
+ * Maximum time in ticks between mob spawing.
+ * @default 800
+ */
+ MaxSpawnDelay: number;
+ /**
+ * Minimum time in ticks between mob spawing.
+ * @default 800
+ */
+ MinSpawnDelay: number;
+ /**
+ * Anyone (of players) must be near to spawner, otherwise spawner
+ * hides placeholder animation and stops.
+ * @default 16
+ */
+ RequiredPlayerRange: number;
+ /**
+ * Maximum spawning limit, not everyone may spawned with each other
+ * when place above comes to zero.
+ * @default 4
+ */
+ SpawnCount: number;
+ /**
+ * Ranged AABB box where entities became.
+ * @default 4
+ */
+ SpawnRange: number;
+ }
+
+ /**
+ * **Skull** (Mob Head) with `ID = 6`.
+ */
+ interface SkullBlockEntity extends IBlockEntity {
+ id: "Skull";
+ /**
+ * Whether dragon mouth powered by redstone.
+ * @default 0
+ */
+ MouthMoving: boolean;
+ /**
+ * Cycling time in ticks, between full-cycled move down and up.
+ * @default 0
+ */
+ MouthTickCount: number;
+ /**
+ * Rotation angle in degrees, value between `22.5` and `180` (with in-game step `22.5`).
+ */
+ Rotation: number;
+ /**
+ * `0` means skeleton, `1` wither skeleton, `2` zombie, `3` player, `4` creeper and `5` ender dragon.
+ */
+ SkullType: number;
+ }
+
+ /**
+ * **FlowerPot** (Flower Pot) with `ID = 7`.
+ */
+ interface FlowerPotBlockEntity extends IBlockEntity {
+ id: "FlowerPot";
+ /**
+ * Anything in particular, my cat preferr `"minecraft:brown_mushroom"` (`name` property).
+ */
+ PlantBlock?: Block;
+ }
+
+ /**
+ * **BrewingStand** (Brewing Stand) with `ID = 8`.
+ */
+ interface BrewingStandBlockEntity extends IContainerBlockEntity {
+ id: "BrewingStand";
+ /**
+ * Every potion cooks on same time ticks, counter.
+ * When next ingredient is done, every potion in slots `1`-`3`
+ * obtains tag `"wasJustBrewed" = true`.
+ * @default 0
+ */
+ CookTime: number;
+ /**
+ * Fuel left of {@link FuelTotal} property, when it comes to zero
+ * next charge from slot `4` was used.
+ * @default 0
+ */
+ FuelAmount: number;
+ /**
+ * When fuel was taken from slot changes to it capacity, now availabled
+ * only `"minecraft:blaze_powder"` (`name` property), which sets fuel to `20`.
+ * @default 0
+ */
+ FuelTotal: number;
+ }
+
+ /**
+ * **EnchantTable** (Enchanting Table) with `ID = 9`.
+ */
+ interface EnchantTableBlockEntity extends IBlockEntity {
+ id: "EnchantTable";
+ /**
+ * Rotation angle in radians between `-Math.PI` and `Math.PI`.
+ */
+ rott: number;
+ }
+
+ /**
+ * **DaylightDetector** (Daylight Sensor) with `ID = 10`.
+ */
+ interface DaylightDetectorBlockEntity extends IBlockEntity {
+ id: "DaylightDetector";
+ }
+
+ /**
+ * **Music** (Note Block) with `ID = 11`.
+ */
+ interface MusicBlockEntity extends IBlockEntity {
+ id: "Music";
+ /**
+ * Number between `0` and `24`, which changes note tone.
+ */
+ note: number;
+ }
+
+ /**
+ * **Comparator** (Redstone Comparator) with `ID = 12`.
+ */
+ interface ComparatorBlockEntity extends IBlockEntity {
+ id: "Comparator";
+ /**
+ * Redstone power, value between `0` and `15`.
+ */
+ OutputSignal: number;
+ }
+
+ /**
+ * **Dispenser** with `ID = 13`.
+ */
+ interface DispenserBlockEntity extends IContainerBlockEntity {
+ id: "Dispenser";
+ }
+
+ /**
+ * **Dropper** with `ID = 14`.
+ */
+ interface DropperBlockEntity extends IContainerBlockEntity {
+ id: "Dropper";
+ }
+
+ /**
+ * **Cauldron** with `ID = 16`.
+ * @remarks
+ * Contains {@link Items}, but it intentionally not used.
+ */
+ interface CauldronBlockEntity extends IContainerBlockEntity {
+ id: "Cauldron";
+ /**
+ * One of {@link EPotionEffect} enum values.
+ * But... Maybe try ` - 1`?
+ */
+ PotionId: number;
+ /**
+ * Level of strength, value between `0` and `255` (more buggy to `32768`).
+ * @default -1
+ */
+ PotionType: number;
+ /**
+ * Packed RGB color, one of my favorites is `-75715`.
+ */
+ CustomColor?: number;
+ }
+
+ /**
+ * **ItemFrame** (Item Frame) with `ID = 17`.
+ */
+ interface ItemFrameBlockEntity extends IBlockEntity {
+ id: "ItemFrame";
+ /**
+ * Item to be displayed in frame, tag doesn't exist by default.
+ */
+ Item?: Item;
+ /**
+ * Percent value between `0` and `1`; everything just cool when elytra
+ * drops with chance `0.01`.
+ * @default 1
+ */
+ ItemDropChance?: number;
+ /**
+ * Rotation angle in degress between `0` and `315` (with in-game step `45`).
+ * Also changes comparator strength, triggers observers.
+ */
+ ItemRotation?: number;
+ }
+
+ /**
+ * **PistonArm** (Piston) with `ID = 18`.
+ */
+ interface PistonArmBlockEntity extends IBlockEntity {
+ id: "PistonArm";
+ /**
+ * Blocks attached to piston (excluding head) with slime and honey blocks.
+ */
+ AttachedBlocks: Block[];
+ /**
+ * Blocks prevents piston from moving, such as obsidian.
+ */
+ BreakBlocks: Block[];
+ /**
+ * Latest successfully changed state progress, which determine piston movement.
+ */
+ LastProgress: number;
+ /**
+ * Required by redstone state, if nothing blocking way, piston moves.
+ */
+ NewState: number;
+ /**
+ * Percent between `0` and `1` (with in-game step `0.5`), where `1` means activated.
+ */
+ Progress: number;
+ /**
+ * Currently state, `0` means pulled, `1` moving and `2` pushed.
+ */
+ State: number;
+ /**
+ * Whether piston crafted with slime and can transfer blocks back.
+ */
+ Sticky: boolean;
+ }
+
+ /**
+ * **MovingBlock** (Moving Block) with `ID = 19`.
+ */
+ interface MovingBlockEntity extends IBlockEntity {
+ id: "MovingBlock";
+ /**
+ * Block to be rendered as moving, let give a try with a `"minecraft:cake"` (`name` property).
+ */
+ movingBlock: Block;
+ /**
+ * Block to be rendered as moving above {@link movingBlock}, let give a try with a `"minecraft:flowing_lava"` (`name` property).
+ */
+ movingBlockExtra: Block;
+ /**
+ * If block connected with a sticky piston, it will appears here.
+ * @default 0
+ */
+ pistonPosX: number;
+ /**
+ * If block connected with a sticky piston, it will appears here.
+ * @default 1
+ */
+ pistonPosY: number;
+ /**
+ * If block connected with a sticky piston, it will appears here.
+ * @default 0
+ */
+ pistonPosZ: number;
+ }
+
+
+ /**
+ * **Beacon** with `ID = 21`.
+ * @remarks
+ * Primary effect requires just one-level platform, meanwhile secondary
+ * works only when four-level built, otherwise fallbacks to primary.
+ */
+ interface BeaconBlockEntity extends IBlockEntity {
+ id: "Beacon";
+ /**
+ * `0` means none, `1` speed, `2` haste, `3` resistance, `4` jump boost and `5` strength.
+ * @default 0
+ */
+ primary: number;
+ /**
+ * `0` means none, `1` regeneration and `2` boost {@link primary} effect.
+ * @default 0
+ */
+ secondary: number;
+ }
+
+ /**
+ * **EndPortal** (End Portal) with `ID = 22`.
+ */
+ interface EndPortalBlockEntity extends IBlockEntity {
+ id: "EndPortal";
+ }
+
+ /**
+ * **EnderChest** (Ender Chest) with `ID = 23`.
+ */
+ interface EnderChestBlockEntity extends ILootableBlockEntity {
+ id: "EnderChest";
+ }
+
+ /**
+ * **EndGateway** (End Gateway) with `ID = 24`.
+ */
+ interface EndGatewayBlockEntity extends IBlockEntity {
+ id: "EndGateway";
+ /**
+ * Counter, that drops when entity moves through portal.
+ * Used to display purple beacon in portal for few hundred ticks.
+ */
+ Age: number;
+ /**
+ * XYZ coordinates of place portal transfers to.
+ * @default [0, 0, 0] // so, under world
+ */
+ ExitPortal: number[];
+ }
+
+ /**
+ * **ShulkerBox** (Shulker Box) with `ID = 25`.
+ */
+ interface ShulkerBoxBlockEntity extends ILootableBlockEntity {
+ id: "ShulkerBox";
+ /**
+ * One of {@link EBlockSide} enum values.
+ */
+ facing: number;
+ }
+
+ /**
+ * **CommandBlock** (Command Block) with `ID = 26`.
+ */
+ interface CommandBlockEntity extends IBlockEntity {
+ id: "CommandBlock";
+ /**
+ * Command to be executed here, such as `/playanimation \@e[type=!minecraft:player] animation.humanoid.celebrating null 20`.
+ */
+ Command: string;
+ /**
+ * Like nametag, but above command block; hovering text.
+ */
+ CustomName: string;
+ /**
+ * When {@link LPCommandMode} is set to cycled and conditions are done,
+ * first command executes without {@link TickDelay}.
+ */
+ ExecuteOnFirstTick: boolean;
+ /**
+ * `0` means impulse (single activation), `1` chain (activation when pointed to chain command block executed) and `2` cycled (forever execution between delay with condition checking).
+ */
+ LPCommandMode: number;
+ /**
+ * `0` means statement, `1` doesn't care about result.
+ */
+ LPConditionalMode: number;
+ /**
+ * `0` means always active, `1` requires redstone.
+ */
+ LPRedstoneMode: number;
+ /**
+ * When last execution has been performed.
+ */
+ LastExecution: number;
+ /**
+ * Message recorded with last execution, requires {@link TrackOutput} to be set to `true`.
+ */
+ LastOutput: string;
+ /**
+ * Splitted to command parts without first slash (or symbol if slash is not provided), requires {@link TrackOutput} to be set to `true`.
+ */
+ LastOutputParams: string[];
+ SuccessCount: number;
+ /**
+ * Delay in ticks between executions (cycled blocks) or before starting it.
+ */
+ TickDelay: number;
+ /**
+ * Save last execution command results.
+ */
+ TrackOutput: boolean;
+ /**
+ * Database tracking identifier (in 1.16 equals `13`).
+ */
+ Version: number;
+ auto: number;
+ /**
+ * Condition right now is `true`?
+ */
+ conditionMet: boolean;
+ /**
+ * Redstone signal found?
+ */
+ powered: boolean;
+ }
+
+ /**
+ * **Bed** with `ID = 27`.
+ */
+ interface BedBlockEntity extends IBlockEntity {
+ id: "Bed";
+ /**
+ * Index of bed color, where `0` is white; block palettes are same.
+ * @default 0
+ */
+ color: number;
+ }
+
+ interface BannerPatternEntry extends Scriptable {
+ /**
+ * Index of pattern color, where `0` is white; block palettes are same.
+ * @default 0
+ */
+ Color: number;
+ /**
+ * Pattern shortcut name, such as `"gra"`, `"mc"`, etc.
+ */
+ Pattern: string;
+ }
+
+ /**
+ * **Banner** with `ID = 28`.
+ */
+ interface BannerBlockEntity extends IBlockEntity {
+ id: "Banner";
+ /**
+ * Index of banner color, where `0` is white; block palettes are same.
+ * @default 0
+ */
+ Base: number;
+ /**
+ * @default 0
+ */
+ Type: number;
+ /**
+ * Patterns to be applied on {@link Base} color.
+ */
+ Patterns?: BannerPatternEntry[];
+ }
+
+ /**
+ * **StructureBlock** (Structure Block) with `ID = 32`.
+ */
+ interface StructureBlockEntity extends IBlockEntity {
+ id: "StructureBlock";
+ /**
+ * Mode of structure block; `0` means load, `1` data (consumed by pools), `2` save.
+ */
+ data: number;
+ /**
+ * Metadata to be passed when {@link data} is set to data mode.
+ */
+ dataField: string;
+ /**
+ * Load or save NBT data of entities contained in bounds, existing data will be omitted.
+ */
+ ignoreEntities: boolean;
+ /**
+ * Load or save NBT data of players contained in bounds.
+ */
+ includePlayers: boolean;
+ /**
+ * Lower values destructs more random selected blocks.
+ */
+ integrity: number;
+ /**
+ * Powered by redstone signal?
+ */
+ isPowered: boolean;
+ /**
+ * `0` means no mirroring, `1` mirror above x, `2` mirror above y, `3` mirror above z
+ */
+ mirror: number;
+ /**
+ * `0` means save signal power (lit lamps, redstone itself, etc.), `1` forget (unlit sources will be updated when structure is placed).
+ */
+ redstoneSaveMode: number;
+ /**
+ * Blocks will be merged (with structure air as real air) or pasted as-is.
+ */
+ removeBlocks: boolean;
+ /**
+ * `0` means no rotation, `1` 90 degress, `2` 180 degress, `3` 270 degress.
+ */
+ rotation: number;
+ /**
+ * Seed to be passed when configuring {@link integrity}
+ */
+ seed: number;
+ /**
+ * Display bounds of structure in-world, includes vertex frame above.
+ */
+ showBoundingBox: boolean;
+ /**
+ * Vanilla or behavior pack namespaced (first directory determines namespace, subfolders joined with `.`) relative path to structure, try something like `"minecraft:endcity.ship"`.
+ */
+ structureName: string;
+ xStructureOffset: number, yStructureOffset: number, zStructureOffset: number;
+ xStructureSize: number, yStructureSize: number, zStructureSize: number;
+ }
+
+ /**
+ * **Jukebox** with `ID = 33`.
+ */
+ interface JukeboxBlockEntity extends IBlockEntity {
+ id: "JukeboxBlock";
+ /**
+ * Record disc that will be played, what about `"minecraft:music_disc_strad"` (`name` property).
+ */
+ RecordItem?: Item;
+ }
+
+ /**
+ * **ChemistryTable** (Chemistry Equipment) with `ID = 34`.
+ */
+ interface ChemistryTableBlockEntity extends IBlockEntity {
+ id: "ChemistryTable";
+ /**
+ * Brewing item data, that will be transpiled into materials, such as `17`, etc.
+ */
+ itemAux?: number;
+ /**
+ * Brewing item numeric ID, that will be transpiled into materials, such as `583`, etc.
+ */
+ itemId?: number;
+ /**
+ * Brewing item count, that will be transpiled into materials, such as `1`, etc.
+ */
+ itemStack?: number;
+ }
+
+ /**
+ * **Conduit** with `ID = 35`.
+ */
+ interface ConduitBlockEntity extends IBlockEntity {
+ id: "Conduit";
+ /**
+ * Whether conduit constructed or not, underwater monument blocks come out to help.
+ * @default false
+ */
+ Active: boolean;
+ /**
+ * Entity UID to protect players in water nearest, attacks monsters when fully constructed.
+ */
+ Target: number;
+ }
+
+ /**
+ * **JigsawBlock** (Jigsaw Block) with `ID = 36`.
+ */
+ interface JigsawBlockEntity extends IBlockEntity {
+ id: "JigsawBlock";
+ /**
+ * Typed block identifier (includes state support such as `[facing=east]`) to be replaced when jigsaw activated.
+ * @default "minecraft:air"
+ */
+ final_state: string;
+ /**
+ * Connection between jigsaw nodes, as-is.
+ * @default "rollable"
+ */
+ joint: "rollable" | "aligned";
+ /**
+ * Associated structure name, jigsaw identifier, such as `"template:bundle"`.
+ * @default "minecraft:empty"
+ */
+ name: string;
+ /**
+ * Required structure subset to be aligned with, such as, such as `"template:pipe"`.
+ * @default "minecraft:empty"
+ */
+ target: string;
+ /**
+ * Pool in which jigsaws will be connected with each others, such as `"template:bundle/pipe"`.
+ * @default "minecraft:empty"
+ */
+ target_pool: string;
+ }
+
+ /**
+ * **Lectern** with `ID = 37`.
+ */
+ interface LecternBlockEntity extends IBlockEntity {
+ id: "Lectern";
+ /**
+ * Standing book item, tag determines book placement.
+ */
+ book?: Item;
+ /**
+ * If book is placed, observer detects changed block.
+ */
+ hasBook?: boolean;
+ /**
+ * Index of page opened on lectern, redstone comparator obtains power `page / totalPages * 15`.
+ */
+ page?: number;
+ /**
+ * Total pages counted in {@link book}.
+ */
+ totalPages?: number;
+ }
+
+ /**
+ * **BlastFurnace** (Blast Furnace) with `ID = 38`.
+ */
+ interface BlastFurnaceBlockEntity extends IFurnaceBlockEntity {
+ id: "BlastFurnace";
+ }
+
+ /**
+ * **Smoker** with `ID = 39`.
+ */
+ interface SmokerBlockEntity extends IFurnaceBlockEntity {
+ id: "Smoker";
+ }
+
+ /**
+ * **Bell** with `ID = 40`.
+ */
+ interface BellBlockEntity extends IBlockEntity {
+ id: "Bell";
+ /**
+ * There is 2 surface (such as `1`), 4 on side and 1 at top (`255`) locations.
+ */
+ Direction: number;
+ /**
+ * Whether sound is playing.
+ */
+ Ringing: boolean;
+ /**
+ * Ringing counter, determines animation of bell.
+ */
+ Ticks: number;
+ }
+
+ /**
+ * **Campfire** (Campfire / Soul Campfire) with `ID = 41`.
+ */
+ interface CampfireBlockEntity extends IBlockEntity {
+ id: "Campfire";
+ /**
+ * Ticks counter of smelting item.
+ * @default 0
+ */
+ ItemTime1: number;
+ /**
+ * Item that will be smelted on campfire.
+ */
+ Item1?: Item;
+ /**
+ * {@inheritDoc NBT.Templates.CampfireBlockEntity.ItemTime1}
+ */
+ ItemTime2: number;
+ /**
+ * {@inheritDoc NBT.Templates.CampfireBlockEntity.Item1}
+ */
+ Item2?: Item;
+ /**
+ * {@inheritDoc NBT.Templates.CampfireBlockEntity.ItemTime1}
+ */
+ ItemTime3: number;
+ /**
+ * {@inheritDoc NBT.Templates.CampfireBlockEntity.Item1}
+ */
+ Item3?: Item;
+ /**
+ * {@inheritDoc NBT.Templates.CampfireBlockEntity.ItemTime1}
+ */
+ ItemTime4: number;
+ /**
+ * {@inheritDoc NBT.Templates.CampfireBlockEntity.Item1}
+ */
+ Item4?: Item;
+ }
+
+ /**
+ * **Barrel** with `ID = 42`.
+ */
+ interface BarrelBlockEntity extends ILootableBlockEntity {
+ id: "Barrel";
+ }
+
+ /**
+ * **Beehive** (Beehive / Bee Nest) with `ID = 43`.
+ */
+ interface BeehiveBlockEntity extends IBlockEntity {
+ id: "Beehive";
+ /**
+ * Naturally generated beehives summon bees inside, before player encounters them.
+ * @default false
+ */
+ ShouldSpawnBees: boolean;
+ /**
+ * Bees. Theoretically, any entity may enter and leave onto beehive.
+ */
+ Occupants?: BeehiveBlockEntityOccupant[];
+ }
+
+ interface BeehiveBlockEntityOccupant extends Scriptable {
+ /**
+ * Typed entity identifier with tags, such as `"minecraft:bee<>"`.
+ */
+ ActorIdentifier: string;
+ /**
+ * Entity NBTs; properties, attributes, definitions, etc.
+ */
+ SaveData: Entity;
+ /**
+ * Countdown before entity left beehive in ticks.
+ */
+ TicksLeftToStay: number;
+ }
+ /**
+ * **Lodestone** with `ID = 44`.
+ */
+ interface LodestoneBlockEntity extends IBlockEntity {
+ id: "Lodestone";
+ /**
+ * Compass points to this lodestone.
+ */
+ trackingHandle: boolean;
+ }
+ }
+}
diff --git a/api/core-engine/Native.d.ts b/api/core-engine/Native.d.ts
new file mode 100644
index 000000000..74692e965
--- /dev/null
+++ b/api/core-engine/Native.d.ts
@@ -0,0 +1,578 @@
+/**
+ * Module containing enums that can make user code more readable.
+ * @remarks
+ * Consider specified sub-enum to determine which version
+ * specific rellocation must be used.
+ */
+declare namespace Native {
+ /**
+ * Defines armor type and armor slot index in player's inventory.
+ * @deprecated Use {@link EArmorType} instead.
+ */
+ enum ArmorType {
+ helmet = 0,
+ chestplate = 1,
+ leggings = 2,
+ boots = 3
+ }
+
+ /**
+ * Defines item category in creative inventory.
+ * @deprecated Use {@link EItemCategory} instead.
+ */
+ enum ItemCategory {
+ /**
+ * @since 2.3.0b112
+ */
+ CONSTRUCTION = 1,
+ /**
+ * @since 2.3.0b112
+ */
+ NATURE = 2,
+ DECORATION = 2,
+ /**
+ * @since 2.3.0b112
+ */
+ EQUIPMENT = 3,
+ TOOL = 3,
+ MATERIAL = 4,
+ /**
+ * @since 2.3.0b112
+ */
+ ITEMS = 4,
+ FOOD = 4,
+ INTERNAL = 5,
+ /**
+ * @since 2.3.0b112
+ */
+ COMMAND_ONLY = 5
+ }
+
+ /**
+ * Defines all existing vanilla particles.
+ * @deprecated Use {@link EParticleType} instead.
+ */
+ enum ParticleType {
+ bubble = 1,
+ cloud = 5,
+ smoke = 6,
+ flame = 8,
+ lava = 9,
+ smoke2 = 10,
+ redstone = 11,
+ snowballpoof = 14,
+ hugeexplosion = 15,
+ hugeexplosionSeed = 16,
+ mobFlame = 17,
+ heart = 18,
+ terrain = 19,
+ suspendedTown = 20,
+ portal = 21,
+ rainSplash = 23,
+ dripWater = 24,
+ splash = 25,
+ dripLava = 27,
+ ink = 28,
+ fallingDust = 29,
+ spell3 = 30,
+ spell2 = 31,
+ spell = 32,
+ slime = 34,
+ waterWake = 35,
+ angryVillager = 36,
+ happyVillager = 37,
+ enchantmenttable = 38,
+ note = 40,
+ crit = 41,
+ itemBreak = 42,
+ largeexplode = 61
+ }
+
+ /**
+ * Defines text colors and font styles for chat and tip messages.
+ */
+ enum Color {
+ BEGIN = "§",
+ BLACK = "§0",
+ DARK_BLUE = "§1",
+ DARK_GREEN = "§2",
+ DARK_AQUA = "§3",
+ DARK_RED = "§4",
+ DARK_PURPLE = "§5",
+ GOLD = "§6",
+ GRAY = "§7",
+ DARK_GRAY = "§8",
+ BLUE = "§9",
+ GREEN = "§a",
+ AQUA = "§b",
+ RED = "§c",
+ LIGHT_PURPLE = "§d",
+ YELLOW = "§e",
+ WHITE = "§f",
+ OBFUSCATED = "§k",
+ BOLD = "§l",
+ STRIKETHROUGH = "§m",
+ UNDERLINE = "§n",
+ ITALIC = "§o",
+ RESET = "§r"
+ }
+
+ /**
+ * Defines all vanilla entity type IDs.
+ * @deprecated Use {@link EEntityType} instead.
+ */
+ enum EntityType {
+ CHICKEN = 10,
+ COW = 11,
+ PIG = 12,
+ SHEEP = 13,
+ WOLF = 14,
+ VILLAGER = 15,
+ MUSHROOM_COW = 16,
+ SQUID = 17,
+ RABBIT = 18,
+ BAT = 19,
+ IRON_GOLEM = 20,
+ SNOW_GOLEM = 21,
+ OCELOT = 22,
+ HORSE = 23,
+ DONKEY = 24,
+ MULE = 25,
+ SKELETON_HORSE = 26,
+ ZOMBIE_HORSE = 27,
+ POLAR_BEAR = 28,
+ LLAMA = 29,
+ PARROT = 30,
+ DOLPHIN = 31,
+ ZOMBIE = 32,
+ CREEPER = 33,
+ SKELETON = 34,
+ SPIDER = 35,
+ PIG_ZOMBIE = 36,
+ SLIME = 37,
+ ENDERMAN = 38,
+ SILVERFISH = 39,
+ CAVE_SPIDER = 40,
+ GHAST = 41,
+ LAVA_SLIME = 42,
+ BLAZE = 43,
+ ZOMBIE_VILLAGER = 44,
+ /**
+ * @since 2.3.0b112
+ */
+ WITCH = 45,
+ /**
+ * @deprecated Mistypo.
+ */
+ WHITCH = 45,
+ STRAY = 46,
+ HUSK = 47,
+ /**
+ * @since 2.3.0b112
+ */
+ WITHER_SKELETON = 48,
+ /**
+ * @deprecated Mistypo.
+ */
+ WHITHER_SKELETON = 48,
+ GUARDIAN = 49,
+ /**
+ * @since 2.3.0b112
+ */
+ ELDER_GUARDIAN = 50,
+ /**
+ * @deprecated Mistypo.
+ */
+ ENDER_GUARDIAN = 50,
+ /**
+ * @since 2.3.0b112
+ */
+ WITHER = 52,
+ /**
+ * @deprecated Mistypo.
+ */
+ WHITHER = 52,
+ ENDER_DRAGON = 53,
+ SHULKER = 54,
+ ENDERMITE = 55,
+ VINDICATOR = 57,
+ PHANTOM = 58,
+ RAVAGER = 59,
+ ARMOR_STAND = 61,
+ PLAYER = 63,
+ ITEM = 64,
+ PRIMED_TNT = 65,
+ FALLING_BLOCK = 66,
+ MOVING_BLOCK = 67,
+ EXPERIENCE_POTION = 68,
+ EXPERIENCE_ORB = 69,
+ EYE_OF_ENDER_SIGNAL = 70,
+ ENDER_CRYSTAL = 71,
+ FIREWORKS_ROCKET = 72,
+ THROWN_TRIDENT = 73,
+ TURTLE = 74,
+ CAT = 75,
+ SHULKER_BULLET = 76,
+ FISHING_HOOK = 77,
+ /**
+ * @since 2.3.0b112
+ */
+ DRAGON_FIREBALL = 79,
+ /**
+ * @deprecated Mistypo.
+ */
+ DRAGON_FIREBOLL = 79,
+ ARROW = 80,
+ SNOWBALL = 81,
+ EGG = 82,
+ PAINTING = 83,
+ MINECART = 84,
+ FIREBALL = 85,
+ THROWN_POTION = 86,
+ ENDER_PEARL = 87,
+ LEASH_KNOT = 88,
+ /**
+ * @since 2.3.0b112
+ */
+ WITHER_SKULL = 89,
+ /**
+ * @deprecated Mistypo.
+ */
+ WHITHER_SKULL = 89,
+ BOAT = 90,
+ /**
+ * @since 2.3.0b112
+ */
+ WITHER_SKULL_DANGEROUS = 91,
+ /**
+ * @deprecated Mistypo.
+ */
+ WHITHER_SKULL_DANGEROUS = 91,
+ LIGHTNING_BOLT = 93,
+ SMALL_FIREBALL = 94,
+ AREA_EFFECT_CLOUD = 95,
+ HOPPER_MINECART = 96,
+ TNT_COMMAND = 97,
+ CHEST_MINECART = 98,
+ COMMAND_BLOCK_MINECART = 100,
+ LINGERING_POTION = 101,
+ LLAMA_SPLIT = 102,
+ EVOCATION_FANG = 103,
+ EVOCATION_ILLAGER = 104,
+ VEX = 105,
+ PUFFERFISH = 108,
+ SALMON = 109,
+ DROWNED = 110,
+ TROPICALFISH = 111,
+ COD = 112,
+ PANDA = 113,
+ PILLAGER = 114,
+ VILLAGER_V2 = 115,
+ /**
+ * @since 2.3.0b112
+ */
+ ZOMBIE_VILLAGER_V2 = 116,
+ /**
+ * @deprecated Mistypo.
+ */
+ ZOMBIE_VILLAGE_V2 = 116,
+ SHIELD = 117,
+ WANDERING_TRADER = 118,
+ /**
+ * @since 2.3.0b112
+ */
+ ELDER_GUARDIAN_GHOST = 120,
+ /**
+ * @deprecated Mistypo.
+ */
+ ENDER_GUARDIAN_GHOST = 120
+ }
+
+ /**
+ * Defines vanilla mob render types.
+ * @deprecated Use {@link EMobRenderType} instead.
+ */
+ enum MobRenderType {
+ tnt = 2,
+ human = 3,
+ item = 4,
+ chicken = 5,
+ cow = 6,
+ mushroomCow = 7,
+ pig = 8,
+ sheep = 9,
+ bat = 10,
+ wolf = 11,
+ villager = 12,
+ zombie = 14,
+ zombiePigman = 15,
+ lavaSlime = 16,
+ ghast = 17,
+ blaze = 18,
+ skeleton = 19,
+ spider = 20,
+ silverfish = 21,
+ creeper = 22,
+ slime = 23,
+ enderman = 24,
+ arrow = 25,
+ fishHook = 26,
+ player = 27,
+ egg = 28,
+ snowball = 29,
+ unknownItem = 30,
+ thrownPotion = 31,
+ painting = 32,
+ fallingTile = 33,
+ minecart = 34,
+ boat = 35,
+ squid = 36,
+ fireball = 37,
+ smallFireball = 38,
+ villagerZombie = 39,
+ experienceOrb = 40,
+ lightningBolt = 41,
+ ironGolem = 42,
+ ocelot = 43,
+ snowGolem = 44,
+ expPotion = 45,
+ rabbit = 46,
+ witch = 47,
+ camera = 48,
+ map = 50
+ }
+
+ /**
+ * Defines vanilla potion effects.
+ * @deprecated Use {@link EPotionEffect} instead.
+ */
+ enum PotionEffect {
+ movementSpeed = 1,
+ movementSlowdown = 2,
+ digSpeed = 3,
+ digSlowdown = 4,
+ damageBoost = 5,
+ heal = 6,
+ harm = 7,
+ jump = 8,
+ confusion = 9,
+ regeneration = 10,
+ damageResistance = 11,
+ fireResistance = 12,
+ waterBreathing = 13,
+ invisibility = 14,
+ blindness = 15,
+ nightVision = 16,
+ hunger = 17,
+ weakness = 18,
+ poison = 19,
+ wither = 20,
+ healthBoost = 21,
+ absorption = 22,
+ saturation = 23,
+ levitation = 24,
+ fatal_poison = 25,
+ conduit_power = 26,
+ slow_falling = 27,
+ bad_omen = 28,
+ village_hero = 29
+ }
+
+ /**
+ * Defines the three dimensions currently available for player.
+ * @deprecated Use {@link EDimension} instead.
+ */
+ enum Dimension {
+ NORMAL = 0,
+ /**
+ * @since 2.3.0b112
+ */
+ OVERWORLD = 0,
+ NETHER = 1,
+ END = 2
+ }
+
+ /**
+ * Defines item animation types.
+ * @deprecated Use {@link EItemAnimation} instead.
+ */
+ enum ItemAnimation {
+ normal = 0,
+ bow = 4
+ }
+
+ /**
+ * Defines numeric representation for each block side.
+ * @deprecated Use {@link EBlockSide} instead.
+ */
+ enum BlockSide {
+ DOWN = 0,
+ UP = 1,
+ NORTH = 2,
+ SOUTH = 3,
+ WEST = 4,
+ EAST = 5
+ }
+
+ /**
+ * Defines numeric IDs of all vanilla enchantments.
+ * @deprecated Use {@link EEnchantment} instead.
+ */
+ enum Enchantment {
+ PROTECTION = 0,
+ FIRE_PROTECTION = 1,
+ FEATHER_FALLING = 2,
+ BLAST_PROTECTION = 3,
+ PROJECTILE_PROTECTION = 4,
+ THORNS = 5,
+ RESPIRATION = 6,
+ AQUA_AFFINITY = 7,
+ DEPTH_STRIDER = 8,
+ SHARPNESS = 9,
+ SMITE = 10,
+ BANE_OF_ARTHROPODS = 11,
+ KNOCKBACK = 12,
+ FIRE_ASPECT = 13,
+ LOOTING = 14,
+ EFFICIENCY = 15,
+ SILK_TOUCH = 16,
+ UNBREAKING = 17,
+ FORTUNE = 18,
+ POWER = 19,
+ PUNCH = 20,
+ FLAME = 21,
+ INFINITY = 22,
+ LUCK_OF_THE_SEA = 23,
+ LURE = 24,
+ FROST_WALKER = 25,
+ MENDING = 26,
+ BINDING_CURSE = 27,
+ VANISHING_CURSE = 28,
+ IMPALING = 29,
+ RIPTIDE = 30,
+ LOYALTY = 31,
+ CHANNELING = 32
+ }
+
+ /**
+ * Defines what enchantments can or cannot be applied to every
+ * instrument type.
+ * @deprecated Use {@link EEnchantType} instead.
+ */
+ enum EnchantType {
+ helmet = 1,
+ leggings = 2,
+ boots = 4,
+ chestplate = 8,
+ weapon = 16,
+ bow = 32,
+ hoe = 64,
+ shears = 128,
+ flintAndSteel = 256,
+ axe = 512,
+ pickaxe = 1024,
+ shovel = 2048,
+ fishingRod = 4096,
+ all = 16383,
+ book = 16383
+ }
+
+ /**
+ * Defines possible render layers (display methods) for blocks.
+ * @deprecated Use {@link EBlockRenderLayer} instead.
+ */
+ enum BlockRenderLayer {
+ doubleside = 0,
+ water = 1,
+ blend = 2,
+ opaque = 3,
+ far = opaque,
+ alpha = 4,
+ opaque_seasons = 6,
+ seasons_far = opaque_seasons,
+ alpha_seasons = 7,
+ seasons_far_alpha = alpha_seasons,
+ alpha_single_side = 8
+ }
+
+ /**
+ * Defines possible game difficulty.
+ * @deprecated Use {@link EGameDifficulty} instead.
+ */
+ enum GameDifficulty {
+ PEACEFUL = 0,
+ EASY = 1,
+ NORMAL = 2,
+ HARD = 3
+ }
+
+ /**
+ * Defines possible game modes.
+ * @deprecated Use {@link EGameMode} instead.
+ */
+ enum GameMode {
+ SURVIVAL = 0,
+ CREATIVE = 1,
+ ADVENTURE = 2,
+ SPECTATOR = 3
+ }
+
+ /**
+ * Defines player's abilities.
+ * @deprecated Use {@link EPlayerAbility} instead.
+ */
+ enum PlayerAbility {
+ ATTACK_MOBS = "attackmobs",
+ ATTACK_PLAYERS = "attackplayers",
+ BUILD = "build",
+ DOORS_AND_SWITCHES = "doorsandswitches",
+ FLYING = "flying",
+ FLYSPEED = "flySpeed",
+ INSTABUILD = "instabuild",
+ INVULNERABLE = "invulnerable",
+ LIGHTNING = "lightning",
+ MAYFLY = "mayfly",
+ MINE = "mine",
+ MUTED = "mute",
+ NOCLIP = "noclip",
+ OPERATOR_COMMANDS = "op",
+ OPEN_CONTAINERS = "opencontainers",
+ TELEPORT = "teleport",
+ WALKSPEED = "walkSpeed",
+ WORLDBUILDER = "worldbuilder"
+ }
+
+ /**
+ * @deprecated Use {@link ETileEntityType} instead.
+ */
+ enum TileEntityType {
+ NONE = -1,
+ CHEST = 0,
+ FURNACE = 1,
+ HOPPER = 2,
+ BREWING_STAND = 8,
+ DISPENSER = 13,
+ CAULDRON = 16,
+ BEACON = 21,
+ JUKEBOX = 33,
+ LECTERN = 37
+ }
+
+ /**
+ * @deprecated Use {@link ENbtDataType} instead.
+ */
+ enum NbtDataType {
+ END_TAG = 0,
+ BYTE = 1,
+ SHORT = 2,
+ INT = 3,
+ INT64 = 4,
+ FLOAT = 5,
+ DOUBLE = 6,
+ BYTE_ARRAY = 7,
+ STRING = 8,
+ LIST = 9,
+ COMPOUND = 10,
+ INT_ARRAY = 11
+ }
+}
diff --git a/api/core-engine/NativeTileEntity.d.ts b/api/core-engine/NativeTileEntity.d.ts
new file mode 100644
index 000000000..52b626dce
--- /dev/null
+++ b/api/core-engine/NativeTileEntity.d.ts
@@ -0,0 +1,52 @@
+/**
+ * Interface providing access to native tile entities such as chests, hoppers, furnaces,
+ * smelters, etc.
+ * See full list of supported native tile entities in the {@link ETileEntityType} enum.
+ */
+declare interface NativeTileEntity {
+ /**
+ * @returns NativeTileEntity type constant, one of the {@link ETileEntityType}
+ * constants.
+ */
+ getType(): number;
+
+ /**
+ * @returns Slots count for the specified NativeTileEntity.
+ */
+ getSize(): number;
+
+ /**
+ * @param slot slot number
+ * @returns Item instance in the specified slot of item TE.
+ */
+ getSlot(slot: number): ItemInstance;
+
+ /**
+ * Sets the contents of a native tile entity's slot.
+ * @param slot slot number
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra data
+ */
+ setSlot(slot: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * Sets the contents of a native tile entity's slot.
+ * @param slot slot number
+ * @param item item information
+ */
+ setSlot(slot: number, item: ItemInstance): void;
+
+ /**
+ * @returns CompoundTag associated with specified native tile entity.
+ * @since 2.0.5b44
+ */
+ getCompoundTag(): NBT.CompoundTag;
+
+ /**
+ * Sets compound tag for the specified tile entity.
+ * @since 2.0.5b44
+ */
+ setCompoundTag(tag: NBT.CompoundTag): void;
+}
diff --git a/api/core-engine/Network.d.ts b/api/core-engine/Network.d.ts
new file mode 100644
index 000000000..795ea4f40
--- /dev/null
+++ b/api/core-engine/Network.d.ts
@@ -0,0 +1,64 @@
+/**
+ * Working with client and server packets in multiplayer
+ * and also determine stuff.
+ */
+declare namespace Network {
+ /**
+ * @returns Array containing connected clients.
+ */
+ function getConnectedClients(): native.Array;
+
+ /**
+ * @returns Array containing connected players UIDs.
+ */
+ function getConnectedPlayers(): native.Array;
+
+ /**
+ * @returns Client object for player by player's entity ID.
+ */
+ function getClientForPlayer(player: number): NetworkClient;
+
+ /**
+ * Event that is called when a client receives a packet with given name.
+ * @param name name of the packet
+ */
+ function addClientPacket(name: string, func: (packetData: T) => void): void;
+
+ /**
+ * Event that is called when server receives a packet with the specified name from client.
+ * @param name name of the packet
+ */
+ function addServerPacket(name: string, func: (client: NetworkClient, data: T) => void): void;
+
+ /**
+ * Sends packet object with specified name to all clients.
+ */
+ function sendToAllClients(name: string, packetData: object): void;
+
+ /**
+ * Sends packet object with the specified name from client to server.
+ */
+ function sendToServer(name: string, packetData: object): void;
+
+ /**
+ * Sends message to all players.
+ * @param message text of the message
+ */
+ function sendServerMessage(message: string): void;
+
+ /**
+ * Converts item or block ID from server to local value.
+ */
+ function serverToLocalId(id: string | number): number;
+
+ /**
+ * Converts item or block ID from local to server value.
+ */
+ function localToServerId(id: string | number): number;
+
+ /**
+ * @returns `true` if player connected to remote world.
+ * @since 2.1.0b57
+ */
+ function inRemoteWorld(): boolean;
+}
diff --git a/api/core-engine/NetworkClient.d.ts b/api/core-engine/NetworkClient.d.ts
new file mode 100644
index 000000000..2f29a0bfb
--- /dev/null
+++ b/api/core-engine/NetworkClient.d.ts
@@ -0,0 +1,37 @@
+/**
+ * Class that represents network client.
+ */
+declare class NetworkClient {
+
+ /**
+ * Sends given packet to the following client.
+ * @param name name of the packet to send
+ * @param packetData packet data object
+ */
+ send(name: string, packetData: object): void;
+
+ /**
+ * @returns Unique numeric entity ID of the player.
+ */
+ getPlayerUid(): number;
+
+ getDisconnectCause(): java.io.IOException;
+
+ getDisconnectPacket(): string;
+
+ /**
+ * Sends a packet to the client with a text like a system message.
+ */
+ sendMessage(message: string): void;
+
+ /**
+ * Disconnects player from the server and sends a packet with given reason.
+ */
+ disconnect(reason: string): void;
+
+ /**
+ * Disconnects player from the server with no further information.
+ */
+ disconnect(): void;
+
+}
\ No newline at end of file
diff --git a/api/core-engine/NetworkConnectedClientList.d.ts b/api/core-engine/NetworkConnectedClientList.d.ts
new file mode 100644
index 000000000..e8d687d4b
--- /dev/null
+++ b/api/core-engine/NetworkConnectedClientList.d.ts
@@ -0,0 +1,81 @@
+/**
+ * Class to work with definite couple of clients,
+ * bound by certain conditions.
+ */
+declare class NetworkConnectedClientList {
+ /**
+ * @param addToGlobalRefreshList if true, the object will be added to the
+ * global list for updating periodically, default is true
+ */
+ constructor(addToGlobalRefreshList: boolean);
+ constructor();
+
+ /**
+ * Condition to bound clients to the list.
+ * All clients in a given dimension at a distance
+ * of no more than maxDistance from x, y, z.
+ * @param x X coord of the conditional centre point of the area where clients are located
+ * @param y Y coord of the conditional centre point of the area where clients are located
+ * @param z Z coord of the conditional centre point of the area where clients are located
+ * @param dimensionID numeric ID of the dimension where clients are located
+ * @param maxDistance max distance from the client to the conditional centre, to bound the client to the list
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setupDistancePolicy(x: number, y: number, z: number, dimensionID: number, maxDistance: number): NetworkConnectedClientList;
+
+ /**
+ * Sends packet to all clients from the following list.
+ * @param packetName name of the packet to send
+ * @param packetData packet data object
+ */
+ send(packetName: string, packetData: object): void;
+
+ /**
+ * Adds given client to the list.
+ */
+ add(client: NetworkClient): void;
+
+ /**
+ * Removes given client from the list.
+ */
+ remove(client: NetworkClient): void;
+
+ /**
+ * @returns Whether the list contains given client.
+ */
+ contains(client: NetworkClient): boolean;
+
+ /**
+ * Sets up policy to add all players to the list.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setupAllPlayersPolicy(): NetworkConnectedClientList;
+
+ /**
+ * Sets up policy to add all players to the list.
+ * @param updateRate how many milliseconds will have to pass between list updates
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setupAllPlayersPolicy(updateRate: number): NetworkConnectedClientList;
+
+ /**
+ * Sets up policy to add players from the same given dimension to the list.
+ * @param dimensionID numeric ID of the dimension where the clients have to be located to be included into the list
+ * @param updateRate how many milliseconds will have to pass between list updates
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setupAllInDimensionPolicy(dimensionID: number, updateRate: number): NetworkConnectedClientList;
+
+ /**
+ * Sets up policy to add players from the same given dimension to the list.
+ * @param dimensionID numeric ID of the dimension where the clients have to be located to be included into the list
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setupAllInDimensionPolicy(dimensionID: number): NetworkConnectedClientList;
+
+ /**
+ * @returns Iterator across clients' objects that the list consists of.
+ */
+ iterator(): java.util.Iterator
+
+}
\ No newline at end of file
diff --git a/api/core-engine/NetworkEntity.d.ts b/api/core-engine/NetworkEntity.d.ts
new file mode 100644
index 000000000..3ab00116c
--- /dev/null
+++ b/api/core-engine/NetworkEntity.d.ts
@@ -0,0 +1,30 @@
+declare namespace NetworkEntity {
+ /**
+ * Listener used to handle type events.
+ */
+ interface IPlayerListener {
+ /**
+ * @param client (dis)connected client
+ */
+ (client: NetworkClient): void
+ }
+}
+
+/**
+ * Class that represents network entity of the block, currently is not learned.
+ */
+declare class NetworkEntity {
+ constructor(type: NetworkEntityType, context: any);
+ remove(): void;
+ send(name: string, data: any): void;
+ getClients(): NetworkConnectedClientList;
+ /**
+ * @since 2.3.1b116-3
+ */
+ setConnectionPlayerListener(listener: NetworkEntity.IPlayerListener): void;
+ /**
+ * @since 2.3.1b116-3
+ */
+ setDisconnectionPlayerListener(listener: NetworkEntity.IPlayerListener): void;
+ getType(): NetworkEntityType;
+}
diff --git a/api/core-engine/NetworkEntityType.d.ts b/api/core-engine/NetworkEntityType.d.ts
new file mode 100644
index 000000000..167b74ccf
--- /dev/null
+++ b/api/core-engine/NetworkEntityType.d.ts
@@ -0,0 +1,11 @@
+/**
+ * Class that represents network entity type.
+ */
+declare class NetworkEntityType {
+ constructor(name: string);
+ setClientListSetupListener(action: (list: NetworkConnectedClientList, target: object, entity) => void): this;
+ setClientEntityAddedListener(action: (entity: number, packet: any) => T): this;
+ setClientEntityRemovedListener(action: (target: any, entity: number) => void): this;
+ setClientAddPacketFactory(action: (target: any, entity: number, client: any) => any): this;
+ addClientPacketListener(name: string, action: (target: any, entity: number, packetData: any) => void): this;
+}
\ No newline at end of file
diff --git a/api/core-engine/Particles.d.ts b/api/core-engine/Particles.d.ts
new file mode 100644
index 000000000..9c1a86f74
--- /dev/null
+++ b/api/core-engine/Particles.d.ts
@@ -0,0 +1,472 @@
+/**
+ * Module to work with vanilla and custom particles.
+ */
+declare namespace Particles {
+ /**
+ * Custom particle's animator params object.
+ */
+ interface IAnimatorDescription {
+ /**
+ * Animator's period in ticks, if it's less than zero or not listed,
+ * it'll be particle's lifetime.
+ */
+ period?: number;
+ /**
+ * Appearance moment in the proportions of the period.
+ * @default 0
+ */
+ fadeIn?: number;
+ /**
+ * Disappearance moment in the proportions of the period.
+ * @default 0
+ */
+ fadeOut?: number;
+ }
+
+ /**
+ * {@inheritDoc Particles.IAnimatorDescription}
+ */
+ interface AnimatorDescription extends IAnimatorDescription {
+ /**
+ * Initial value.
+ * @default 0
+ */
+ start?: number;
+ /**
+ * Ending value.
+ * @default 0
+ */
+ end?: number;
+ }
+
+ /**
+ * {@inheritDoc Particles.IAnimatorDescription}
+ */
+ interface ColorAnimatorDescription extends IAnimatorDescription {
+ /**
+ * Initial value.
+ * @default [1, 1, 1, 1]
+ */
+ start?: [number, number, number, number];
+ /**
+ * Ending value.
+ * @default [1, 1, 1, 1]
+ */
+ end?: [number, number, number, number];
+ }
+
+ /**
+ * Custom particle's sub-emitter params object.
+ */
+ interface SubEmitterDescription {
+ /**
+ * Emitted particle's type numeric ID.
+ */
+ type: number;
+ /**
+ * Additional data of the emitted particle.
+ * @default 0
+ */
+ data?: number;
+ /**
+ * Triggering float chance from 0 to 1.
+ * @default 1
+ */
+ chance?: number;
+ /**
+ * Particles count for the single emit time.
+ * @default 1
+ */
+ count?: number;
+ /**
+ * If `true`, the new particle will have the velocity of the particle,
+ * that calls the sub-emitter, at the time of invocation.
+ * @default false
+ */
+ keepVelocity?: boolean;
+ /**
+ * If true, the new particle will save the emitter that was used for it's creation if it had been.
+ * @remarks
+ * In this case we are talking about emitters, not about sub-emitters.
+ */
+ keepEmitter?: boolean;
+ /**
+ * If this value is listed, emitted particles will receive random initial speed,
+ * that isn't more than `value * sqrt(3)`.
+ */
+ randomize?: number;
+ }
+
+ /**
+ * Custom particle type params object.
+ */
+ interface ParticleDescription {
+ /**
+ * Particle's texture name from *\/particle-atlas* resource directory.
+ */
+ texture: string;
+ /**
+ * Minimum and maximum size of the particle.
+ */
+ size: [number, number];
+ /**
+ * Minimum and maximum particle's lifetime in ticks.
+ */
+ lifetime: [number, number];
+ /**
+ * Particle's render type:
+ * + 0 - additive
+ * + 1 - without blending
+ * + 2 - with blending
+ */
+ render?: number;
+ /**
+ * Four component color of the particle (RGBA).
+ * @default [1, 1, 1, 1]
+ */
+ color?: [number, number, number, number];
+ /**
+ * @since 2.0.4b38
+ */
+ color2?: [number, number, number, number];
+ /**
+ * If `true`, particle won't go through blocks. It reduces performance if
+ * there are lots of these particles.
+ * @default false.
+ */
+ collision?: boolean;
+ /**
+ * Particle's initial velocity, if it's spawned without initial speed parameter.
+ * @default [0, 0, 0]
+ */
+ velocity?: [number, number, number];
+ /**
+ * Particle's acceleration, if it's spawned without this parameter.
+ * @default [0, 0, 0]
+ */
+ acceleration?: [number, number, number];
+ /**
+ * Particle's speed modifier in the air and when touching a block.
+ * Usually it's a number between 0 and 1, close to 1, but in fact it can be any value.
+ * Both values are 1 by default.
+ */
+ friction?: {
+ air?: number;
+ /**
+ * @remarks
+ * This value makes sense only if collision param is `true`.
+ */
+ block?: number;
+ }
+ /**
+ * If `false`, particle's speed will be set to zero when touching a block.
+ * If `true`, the speed will be saved.
+ * @remarks
+ * This value makes sense only if collision param is `true`.
+ */
+ keepVelocityAfterImpact?: boolean;
+ /**
+ * Particle will lose given number of ticks from it's maximum lifetime, when touching a block.
+ * @remarks
+ * This value makes sense only if collision param is `true`.
+ * @default 0
+ */
+ addLifetimeAfterImpact?: number;
+ /**
+ * If `true`, the particle will be exposed to the world's lighting.
+ * If `false`, the particle will always have maximum brightness.
+ * Enabling this parameter may reduce the performance when having lots of particles.
+ * @default false.
+ */
+ isUsingBlockLight?: boolean;
+ /**
+ * Animation frame grid size around width.
+ * @since 2.0.4b38
+ */
+ framesX?: number;
+ /**
+ * Animation frame grid size around height.
+ * @since 2.0.4b38
+ */
+ framesY?: number;
+ /**
+ * Time in ticks between particle mesh updates.
+ * @since 2.0.4b38
+ */
+ rebuildDelay?: number;
+ /**
+ * Animators allow to change some properties of the specific particle depending on the time,
+ * each animator is described as an object of definite format and can be not described, if it's not needed.
+ */
+ animators?: {
+ /**
+ * Describes the behavior of particle's size,
+ * for the unit size the size from the type's description is taken.
+ */
+ size?: AnimatorDescription;
+ /**
+ * Describes the particle's opacity, for the unit value
+ * the `alpha` in the `color` parameter from the type's description is taken.
+ */
+ alpha?: AnimatorDescription;
+ /**
+ * Describes the animation frame, if particle supports it.
+ * Must have the value between 0 and 1.
+ * @deprecated Use `icon` instead.
+ */
+ texture?: AnimatorDescription;
+ /**
+ * Describes the animation frame, if particle supports it.
+ * Must have the value between 0 and 1.
+ */
+ icon?: AnimatorDescription;
+ /**
+ * Describes the animated color value, if particle supports it.
+ * Accepts values in RGBA ranges, like `color` property in descriptor.
+ * @since 2.0.4b38
+ */
+ color?: ColorAnimatorDescription;
+ }
+ /**
+ * Sub-emitters (don't confuse with emitters) describe how specific particle
+ * can emit other particles, according to some events, that may happen to it.
+ * Each sub-emitter is described as an object of definite format and
+ * can be not described if it's not needed.
+ */
+ emitters?: {
+ /**
+ * Called every tick.
+ */
+ idle?: SubEmitterDescription;
+ /**
+ * Called when touching a block, makes sense only if collision parameter is `true`.
+ */
+ impact?: SubEmitterDescription;
+ /**
+ * Called at the end of particle's life.
+ */
+ death?: SubEmitterDescription;
+ }
+ }
+
+ /**
+ * Spawns particle of given type on given coords
+ * with given velocity and additional parameters in the world.
+ * @param type particle type's numeric ID; if you want to spawn vanilla particles,
+ * see {@link EParticleType} enums
+ * @param vx velocity for the particle by X-axis
+ * @param vy velocity for the particle by Y-axis
+ * @param vz velocity for the particle by Z-axis
+ * @param data additional params, currently don't know how to use, just put 0
+ * @remarks
+ * Called only on the client side! Use packets to spawn particles for multiple players.
+ */
+ function addParticle(type: number, x: number, y: number, z: number, vx: number, vy: number, vz: number, data?: number): void;
+
+ /**
+ * Same as {@link Particles.addParticle}, but applies `far` shader to the particle.
+ */
+ function addFarParticle(type: number, x: number, y: number, z: number, vx: number, vy: number, vz: number, data?: number): void;
+
+ /**
+ * Spawns {@link EParticleType.ITEM_BREAK} particles at
+ * a given location with a given item in world.
+ * @param id numeric item ID
+ * @param data item data
+ * @remarks
+ * Called only on the client side! Use packets to spawn particles for multiple players.
+ * @since 2.4.0b119
+ */
+ function addBreakingItemParticle(id: number, data: number, x: number, y: number, z: number): void;
+
+ /**
+ * Spawnds particles in line with specified gapness.
+ * @param type particle type's numeric ID; if you want to spawn vanilla particles,
+ * see {@link EParticleType} enums
+ * @param coords1 start location of line
+ * @param coords2 end location of line
+ * @param gap gapness means step of particles, values more than 1
+ * will increase offsets between particles; randomized
+ * @param vel velocity of spawned particles
+ * @param data variant of spawned particles or properties
+ */
+ function line(type: number, coords1: Vector, coords2: Vector, gap?: number, vel?: Vector, data?: number): void;
+
+ /**
+ * Registers new custom particle type of given params object.
+ * @returns Created particle type's numeric ID.
+ */
+ function registerParticleType(descriptor: ParticleDescription): number;
+
+ /**
+ * @returns Object {@link Particles.ParticleType} of the particle by given ID, if it exists.
+ */
+ function getParticleTypeById(id: number): ParticleType;
+
+ /**
+ * Class to create custom particle types.
+ * Mostly for internal use, you can use {@link Particles.registerParticleType} instead.
+ */
+ class ParticleType {
+ /**
+ * Constructs new {@link Particles.ParticleType}
+ * object from given needed params.
+ */
+ constructor(textureName: string, minU: number, minV: number, maxU: number, maxV: number, textureCountHorizontal: number, textureCountVertical: number, isUsingBlockLight: boolean);
+ /**
+ * Constructs new {@link Particles.ParticleType}
+ * object from given needed params (unfinished documentation).
+ */
+ constructor(locationName: string, isUsingBlockLight: boolean, uv: number[], textureCountHorizontal: number, textureCountVertical: number);
+ /**
+ * Constructs new {@link Particles.ParticleType}
+ * object from given descriptor object.
+ */
+ constructor(descriptor: ParticleDescription);
+ /**
+ * @returns Following particle type's numeric ID.
+ */
+ getId(): number;
+ setRenderType(renderType: 0 | 1 | 2): void;
+ setRebuildDelay(delay: number): void;
+ setColor(r: number, g: number, b: number, a: number): void;
+ setColor(r: number, g: number, b: number, a: number, r2: number, g2: number, b2: number, a2: number): void;
+ setCollisionParams(collision: boolean, keepVelocityAfterImpact: boolean, addLifetimeAfterImpact: number): void;
+ setFriction(air: number, block: number): void;
+ setSize(min: number, max: number): void;
+ setLifetime(min: number, max: number): void;
+ setDefaultVelocity(x: number, y: number, z: number): void;
+ setDefaultAcceleration(x: number, y: number, z: number): void;
+ setSubEmitter(name: "idle" | "impact" | "death", emitter: ParticleSubEmitter): void;
+ setAnimator(name: "size" | "icon" | "alpha" | "color", animator: ParticleAnimator): void;
+ }
+
+ /**
+ * Particle emitter allows to change their position after spawn.
+ * It represents a coordinate system, where created particles are located
+ * and which you can move however you want.
+ * @remarks
+ * Emitter can be moved only while being in world,
+ * and it works ONLY for custom particles, not for vanilla!
+ */
+ class ParticleEmitter {
+ /**
+ * Constructs new particle emitter with origin in given coords.
+ */
+ constructor(x: number, y: number, z: number);
+ /**
+ * Moves the coordinate system to given coords,
+ * it will cause all particles' transfer.
+ */
+ move(x: number, y: number, z: number): void;
+ /**
+ * Moves the ORIGIN of the coordinate system to given coords.
+ */
+ moveTo(x: number, y: number, z: number): void;
+ /**
+ * Sets the speed of the coordinate system by each axis in blocks per tick,
+ * it can be stopped with `emitter.stop()` or `emitter.setVelocity(0, 0, 0)`.
+ */
+ setVelocity(x: number, y: number, z: number): void;
+ /**
+ * Binds the origin to the given entity's position,
+ * resets the coordinate system's speed.
+ */
+ attachTo(entity: number): void;
+ /**
+ * Same as `attachTo(entity)`, but adds x, y and z offset to entity's coords.
+ */
+ attachTo(entity: number, x: number, y: number, z: number): void;
+ /**
+ * Detaches the coords system from the entity and leaves it on the current position.
+ */
+ detach(): void;
+ /**
+ * Terminates any movement of the coordinate system.
+ */
+ stop(): void;
+ /**
+ * Performs the finalization of the native object of the following emitter.
+ * It means that you will no longer be able to use the following emitter after calling this method,
+ * and the object itself will be removed from the memory.
+ * Can be used for optimization purposes.
+ */
+ release(): void;
+ /**
+ * @returns Origin's coords in {@link Vector} object.
+ */
+ getPosition(): Vector;
+ /**
+ * @returns Origin's coords in float array of 3 elements.
+ */
+ getPositionArray(): [number, number, number];
+ /**
+ * Default is false. It means that the coords of the particles for the following emitter.
+ * will be specified in the absolute coordinate system, if enabled,
+ * they will need to be set relative to the current position of the emitter.
+ * This can be very convenient if you need to make a system of particles completely isolated from the movement of the emitter.
+ */
+ setEmitRelatively(enable: boolean): void
+ /**
+ * Spawns particle of given and data on given coords,
+ * without specified velocity and acceleration.
+ */
+ emit(type: number, data: number, x: number, y: number, z: number): void;
+ /**
+ * Spawns particle of given and data on given coords,
+ * with specified velocity and without specified acceleration.
+ */
+ emit(type: number, data: number, x: number, y: number, z: number, vx: number, vy: number, vz: number): void;
+ /**
+ * Spawns particle of given and data on given coords,
+ * with specified velocity and acceleration.
+ */
+ emit(type: number, data: number, x: number, y: number, z: number, vx: number, vy: number, vz: number, ax: number, ay: number, az: number): void;
+ }
+ /**
+ * Animators allow to change some properties of the specific particle depending on the time.
+ * Mostly for internal use, put animators' descriptors into `animators` parameter of custom particle type instead.
+ */
+ class ParticleAnimator {
+ /**
+ * Constructs new {@link Particles.ParticleAnimator} object from given needed params.
+ */
+ constructor(period: number, fadeInTime: number, fadeInValue: number, fadeOutTime: number, fadeOutValue: number);
+ /**
+ * Constructs new {@link Particles.ParticleAnimator} object from given descriptor object.
+ */
+ constructor(descriptor: AnimatorDescription);
+ }
+ /**
+ * Sub-emitters describe how specific particle can emit other particles,
+ * according to some events, that may happen to it.
+ * Mostly for internal use, put sub-emitters descriptors into `emitters`.
+ */
+ class ParticleSubEmitter {
+ /**
+ * Constructs new {@link Particles.ParticleSubEmitter}
+ * object from given needed params.
+ */
+ constructor(chance: number, count: number, type: number, data: number);
+ /**
+ * Constructs new {@link Particles.ParticleSubEmitter}
+ * object from given descriptor object.
+ */
+ constructor(descriptor: SubEmitterDescription);
+ /**
+ * Emitted particles will receive random initial speed.
+ */
+ setRandomVelocity(maxRandomVelocity: number): void;
+ /**
+ * @param keepVelocity If true, the new particle will have the velocity of the particle,
+ * that calls the sub-emitter, at the time of invocation; default is false
+ */
+ setKeepVelocity(keepVelocity: boolean): void;
+ /**
+ * @param keepEmitter If true, the new particle will save the emitter that was used for it's creation if it had been.
+ * @remarks
+ * In this case we are talking about emitters, not about sub-emitters.
+ */
+ setKeepEmitter(keepEmitter: boolean): void;
+ }
+}
diff --git a/api/core-engine/Player.d.ts b/api/core-engine/Player.d.ts
new file mode 100644
index 000000000..b2f3762d0
--- /dev/null
+++ b/api/core-engine/Player.d.ts
@@ -0,0 +1,623 @@
+/**
+ * Module used to manipulate local player. Player is also an entity in Minecraft, so
+ * you can use all the functions from {@link Entity} module as well. To get player's
+ * entity uid, call {@link Player.getLocal} or {@link Player.getServer} depends on usage.
+ * Most of the methods are client-side, use {@link PlayerActor} instead.
+ */
+declare namespace Player {
+ /**
+ * Gets server player uid or local one if client connected to
+ * remote server and client uid is available.
+ * @returns `-1` if there is no player, for example, on dedicated servers
+ */
+ function get(): number;
+
+ /**
+ * Gets local player entity uid, which can be used in various
+ * client operations with player, like {@link Player.getPointed}.
+ * @returns `-1` if there is no player, for example, on dedicated servers
+ * @since 2.3.1b115
+ */
+ function getLocal(): number;
+
+ /**
+ * Gets player entity uid, which can be used in various
+ * server operations with player, like {@link Player.addItemToInventory}.
+ * @returns `-1` if there is no player, for example, on dedicated servers
+ * @since 2.3.1b115
+ */
+ function getServer(): number;
+
+ // TODO: Unimplemented methods, at least for b121.
+ // /**
+ // * Returns name for specified entity, which is also known as name tag.
+ // */
+ // function getNameForEnt(entityUid: number): string;
+ // /**
+ // * Returns name for local player, which is also known as name tag.
+ // */
+ // function getName(): void;
+
+ /**
+ * @returns Current dimension numeric uid, one of the {@link EDimension}
+ * values or custom dimension ID.
+ */
+ function getDimension(): number;
+
+ /**
+ * @returns `true` if specified entity is of player type, `false` otherwise.
+ * @deprecated Works only with local player, use {@link Entity.getType} instead.
+ */
+ function isPlayer(entityUid: number): boolean;
+
+ /**
+ * Entity pointed data, which is used in {@link Player.getPointed}.
+ */
+ interface PointedData {
+ /**
+ * Pointed block position.
+ */
+ pos: BlockPosition,
+ /**
+ * Look vector.
+ */
+ vec: Vector,
+ /**
+ * Pointed block data, if player doesn't look at the block,
+ * air block is returned.
+ */
+ block: Tile,
+ /**
+ * Pointed entity, if no entity's pointed, returns `-1`.
+ */
+ entity: number
+ }
+
+ /**
+ * Fetches information about the objects player is currently pointing.
+ */
+ function getPointed(): PointedData;
+
+ /**
+ * Simulates local player rotation by specified delta.
+ * @param deltaX horizontal radians offset
+ * @param deltaY vertical radians offset
+ * @since 2.4.0b120 (implemented in 2.3.1b116)
+ */
+ function localPlayerTurn(deltaX: number, deltaY: number): void;
+
+ /**
+ * @deprecated Consider use {@link Player.getInventorySlot} instead.
+ */
+ function getInventory(loadPart: any, handleEnchant: any, handleNames: any): void;
+
+ /**
+ * Adds items to player's inventory, stacking them if possible.
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ * @param preventDrop if set to false, function drops items that could not be
+ * added to player's inventory, destroys them otherwise
+ * @deprecated Client-side only, use {@link PlayerActor.addItemToInventory} instead.
+ */
+ function addItemToInventory(id: number, count: number, data: number, extra?: ItemExtraData, preventDrop?: boolean): void;
+
+ /**
+ * @returns Item in player's hand.
+ */
+ function getCarriedItem(): ItemInstance;
+
+ /**
+ * Sets item in player's hand.
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ * @deprecated Client-side only, use {@link PlayerActor.setInventorySlot}
+ * or {@link Entity.setCarriedItem} instead.
+ */
+ function setCarriedItem(id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * @returns Player's current offhand item information.
+ */
+ function getOffhandItem(): ItemInstance;
+
+ /**
+ * Sets current offhand item for the player.
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ * @deprecated Client-side only, use {@link Entity.setOffhandItem} instead.
+ */
+ function setOffhandItem(id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * Decreases carried item count by specified number.
+ * @param count amount of items to decrease carried item by,
+ * default value is `1`
+ * @deprecated Client-side only, use {@link PlayerActor.setInventorySlot}
+ * or {@link Entity.setCarriedItem} instead.
+ */
+ function decreaseCarriedItem(count?: number): void;
+
+ /**
+ * @param slot slot ID, from 0 to 36
+ * @returns Information about item in the specified inventory slot.
+ */
+ function getInventorySlot(slot: number): ItemInstance;
+
+ /**
+ * Sets contents of the specified inventory slot.
+ * @param slot slot ID, from 0 to 36
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ * @deprecated Client-side only, use {@link PlayerActor.setInventorySlot} instead.
+ */
+ function setInventorySlot(slot: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * @param slot armor slot ID, should be one of the {@link EArmorType}
+ * values.
+ * @returns Information about item in the specified armor slot.
+ */
+ function getArmorSlot(slot: number): ItemInstance;
+
+ /**
+ * Sets contents of the specified armor slot.
+ * @param slot armor slot ID, should be one of the {@link EArmorType}
+ * values
+ * @param id item ID
+ * @param count item count
+ * @param data item data
+ * @param extra item extra
+ * @deprecated Client-side only, use {@link PlayerActor.setArmor} instead.
+ */
+ function setArmorSlot(slot: number, id: number, count: number, data: number, extra?: ItemExtraData): void;
+
+ /**
+ * @returns Currently selected inventory slot, from 0 to 8.
+ */
+ function getSelectedSlotId(): number;
+
+ /**
+ * Selects currently selected inventory slot.
+ * @param slot slot ID to be selected, from 0 to 8
+ */
+ function setSelectedSlotId(slot: number): void;
+
+ /**
+ * @returns Current player's position.
+ */
+ function getPosition(): Vector;
+
+ /**
+ * Sets specified coordinates as player's position.
+ * @deprecated Client-side only, use {@link Entity.setPosition} instead.
+ */
+ function setPosition(x: number, y: number, z: number): void;
+
+ /**
+ * Changes current player position by specified vector.
+ * @deprecated Client-side only, use {@link Entity.addPosition} instead.
+ */
+ function addPosition(x: number, y: number, z: number): void;
+
+ /**
+ * Get player's velocity.
+ * @returns Currently {@link Vector} containing player's velocity.
+ */
+ function getVelocity(): Vector;
+
+ /**
+ * Set player's velocity using velocity vector.
+ * @param x velocity
+ * @param y velocity
+ * @param z velocity
+ * @deprecated Client-side only, use {@link Entity.setVelocity} instead.
+ */
+ function setVelocity(x: number, y: number, z: number): void;
+
+ /**
+ * Updates current entity's velocity by specified values.
+ * @deprecated Client-side only, use {@link Entity.addVelocity} instead.
+ */
+ function addVelocity(x: number, y: number, z: number): void;
+
+ /**
+ * Interface used to manipulate player's experience.
+ * @deprecated Consider using {@link Player.getExperience},
+ * {@link Player.setExperience}, {@link Player.addExperience}.
+ */
+ interface PlayerExperience {
+ /**
+ * @returns Player's current experience.
+ */
+ get(): number;
+
+ /**
+ * Sets player's experience.
+ * @param exp experience value to be set
+ */
+ set(exp: number): void;
+
+ /**
+ * Adds specified amount of experience to the current value.
+ * @param exp amount to be added
+ */
+ add(exp: number): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player experience.
+ * @deprecated Consider using {@link Player.getExperience},
+ * {@link Player.setExperience}, {@link Player.addExperience}.
+ */
+ function experience(): PlayerExperience;
+
+ /**
+ * @returns Player's current experience.
+ */
+ function getExperience(): number;
+
+ /**
+ * Sets player's experience.
+ * @param exp experience value to be set
+ * @deprecated Client-side only, use {@link PlayerActor.setExperience} instead.
+ */
+ function setExperience(exp: number): void;
+
+ /**
+ * Adds specified amount of experience to the current value.
+ * @param exp amount to be added
+ * @deprecated Client-side only, use {@link PlayerActor.addExperience} instead.
+ */
+ function addExperience(exp: number): void;
+
+ /**
+ * Interface used to manipulate player's level.
+ * @deprecated Consider using {@link Player.getLevel},
+ * {@link Player.setLevel}, {@link Player.addLevel}.
+ */
+ interface PlayerLevel {
+ /**
+ * @returns Player's current level.
+ */
+ get(): number;
+
+ /**
+ * Sets player's level.
+ * @param level level value to be set
+ */
+ set(level: number): void;
+
+ /**
+ * Adds specified amount of level to the current value.
+ * @param level amount to be added
+ */
+ add(level: number): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player level.
+ * @deprecated Consider using {@link Player.getLevel},
+ * {@link Player.setLevel}, {@link Player.addLevel}.
+ */
+ function level(): PlayerLevel;
+
+ /**
+ * @returns Player's current level.
+ */
+ function getLevel(): number;
+
+ /**
+ * Sets player's level.
+ * @param level level value to be set
+ * @deprecated Client-side only, use {@link PlayerActor.setLevel} instead.
+ */
+ function setLevel(level: number): void;
+
+ /**
+ * Adds specified amount of level to the current value.
+ * @param level amount to be added
+ * @deprecated Client-side only, use {@link PlayerActor.setLevel} instead.
+ */
+ function addLevel(level: number): void;
+
+ /**
+ * Interface used to manipulate player's flying ability and state.
+ * @deprecated Consider using {@link Player.getFlyingEnabled},
+ * {@link Player.setFlyingEnabled}, {@link Player.getFlying}
+ * and {@link Player.setFlying}.
+ */
+ interface PlayerFlying {
+ /**
+ * @returns `true` if player is flying, `false` otherwise.
+ */
+ get(): boolean;
+
+ /**
+ * Changes player's current flying state, call {@link Player.PlayerFlying.setEnabled}
+ * to be able to set this property to `true`.
+ * @param enabled whether the player should fly or not
+ */
+ set(enabled: boolean): void;
+
+ /**
+ * @returns `true` if player is allowed to fly, `false` otherwise.
+ */
+ getEnabled(): boolean;
+
+ /**
+ * Enables or disables player's ability to fly.
+ * @param enabled whether the player can fly or not
+ */
+ setEnabled(enabled: boolean): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player flying ability and
+ * state.
+ * @deprecated Consider using {@link Player.getFlyingEnabled},
+ * {@link Player.setFlyingEnabled}, {@link Player.getFlying}, {@link Player.setFlying}.
+ */
+ function flying(): PlayerFlying;
+
+ /**
+ * @returns `true` if player is allowed to fly, `false` otherwise.
+ */
+ function getFlyingEnabled(): boolean;
+
+ /**
+ * Enables or disables player's ability to fly.
+ * @param enabled whether the player can fly or not
+ * @deprecated Client-side only, use {@link PlayerActor.setCanFly} instead.
+ */
+ function setFlyingEnabled(enabled: boolean): void;
+
+ /**
+ * @returns `true` if player is flying, `false` otherwise.
+ */
+ function getFlying(): boolean;
+
+ /**
+ * Changes player's current flying state, call {@link Player.setFlyingEnabled}
+ * to be able to set this property to `true`.
+ * @param enabled whether the player should fly or not
+ */
+ function setFlying(enabled: boolean): void;
+
+ /**
+ * Interface used to manipulate player's exhaustion.
+ * @deprecated Consider using {@link Player.getExhaustion} and
+ * {@link Player.setExhaustion}.
+ */
+ interface PlayerExhaustion {
+ /**
+ * @returns Player's current exhaustion.
+ */
+ get(): number;
+
+ /**
+ * Sets player's exhaustion.
+ * @param value exhaustion value to be set
+ */
+ set(value: number): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player's exhaustion.
+ * @deprecated Consider using {@link Player.getExhaustion} and
+ * {@link Player.setExhaustion}.
+ */
+ function exhaustion(): PlayerExhaustion;
+
+ /**
+ * @returns Player's current exhaustion.
+ */
+ function getExhaustion(): number;
+
+ /**
+ * Sets player's exhaustion.
+ * @param value exhaustion value to be set
+ * @since 2.0.1b17 (not worked before)
+ * @deprecated Client-side only, use {@link PlayerActor.setExhaustion} instead.
+ */
+ function setExhaustion(value: number): void;
+
+ /**
+ * Interface used to manipulate player's hunger.
+ * @deprecated Consider using {@link Player.getHunger} and
+ * {@link Player.setHunger}.
+ */
+ interface PlayerHunger {
+ /**
+ * @returns Player's current hunger.
+ */
+ get(): number;
+
+ /**
+ * Sets player's hunger.
+ * @param value hunger value to be set
+ */
+ set(value: number): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player's exhaustion.
+ * @deprecated Consider using {@link Player.getHunger} and
+ * {@link Player.setHunger}.
+ */
+ function hunger(): PlayerHunger;
+
+ /**
+ * @returns Player's current hunger.
+ */
+ function getHunger(): number;
+
+ /**
+ * Sets player's hunger.
+ * @param value hunger value to be set
+ * @since 2.0.1b17 (not worked before)
+ * @deprecated Client-side only, use {@link PlayerActor.setHunger} instead.
+ */
+ function setHunger(value: number): void;
+
+ /**
+ * Interface used to manipulate player's saturation.
+ * @deprecated Consider using {@link Player.getSaturation} and
+ * {@link Player.setSaturation}.
+ */
+ interface PlayerSaturation {
+ /**
+ * @returns Player's current saturation.
+ */
+ get(): number;
+
+ /**
+ * Sets player's saturation.
+ * @param value saturation value to be set
+ */
+ set(value: number): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player's saturation.
+ * @deprecated Consider using {@link Player.getSaturation} and
+ * {@link Player.setSaturation}.
+ */
+ function saturation(): PlayerSaturation;
+
+ /**
+ * @returns Player's current saturation.
+ */
+ function getSaturation(): number;
+
+ /**
+ * Sets player's saturation.
+ * @param value saturation value to be set
+ * @since 2.0.1b17 (not worked before)
+ * @deprecated Client-side only, use {@link PlayerActor.setSaturation} instead.
+ */
+ function setSaturation(value: number): void;
+
+ /**
+ * Interface used to manipulate player's health.
+ * @deprecated Consider using {@link Player.getHealth} and
+ * {@link Player.setHealth}.
+ */
+ interface PlayerHealth {
+ /**
+ * @returns Player's current health.
+ */
+ get(): number;
+
+ /**
+ * Sets player's health.
+ * @param value health value to be set
+ */
+ set(value: number): void;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player's health.
+ * @deprecated Consider using {@link Player.getHealth} and
+ * {@link Player.setHealth}.
+ */
+ function health(): PlayerHealth;
+
+ /**
+ * @returns Player's current health.
+ */
+ function getHealth(): number;
+
+ /**
+ * Sets player's health.
+ * @param value Health value to be set.
+ * @deprecated Client-side only, use {@link Entity.healEntity}
+ * and {@link Entity.damageEntity} instead.
+ */
+ function setHealth(value: number): void;
+
+ /**
+ * Interface used to manipulate player's score.
+ * @deprecated Consider using {@link Player.getScore}.
+ */
+ interface PlayerScore {
+ /**
+ * @returns Player's current score.
+ */
+ get(): number;
+ }
+
+ /**
+ * @returns An object that allows to manipulate player's score.
+ * @deprecated Consider using {@link Player.getScore}.
+ */
+ function score(): PlayerScore;
+
+ /**
+ * @returns Player's current score.
+ */
+ function getScore(): number;
+
+ /**
+ * Sets view zoom, to reset value call {@link Player.resetFov}.
+ * @param fov view zoom, default zoom is about 70
+ */
+ function setFov(fov: number): void;
+
+ /**
+ * Resets view zoom to the default value.
+ */
+ function resetFov(): void;
+
+ /**
+ * Sets player's camera to the specified entity.
+ * @param entityUid entity uid
+ */
+ function setCameraEntity(entityUid: number): void;
+
+ /**
+ * Resets player's camera if it was previously set to another entity.
+ */
+ function resetCameraEntity(): void;
+
+ /**
+ * Sets some of the player's abilities. If the argument is of type
+ * boolean, sets the ability as the boolean one, otherwise as numeric one.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @param value the value to be set for the ability; can be either boolean
+ * or number, depending on the ability
+ * @since 2.0.3b33
+ * @deprecated Client-side only, use {@link PlayerActor.setPlayerBooleanAbility}
+ * and {@link PlayerActor.setPlayerFloatAbility} instead.
+ */
+ function setAbility(ability: string, value: boolean | number): void;
+
+ /**
+ * Gets one of the player's abilities in a form
+ * of floating-point number.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @returns Current value of the ability in a form
+ * of floating-point number.
+ * @since 2.0.3b33
+ */
+ function getFloatAbility(ability: string): number;
+
+ /**
+ * Gets one of the player's abilities in a boolean form.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @returns Current value of the ability in a boolean form.
+ * @since 2.0.3b33
+ */
+ function getBooleanAbility(ability: string): number;
+
+}
diff --git a/api/core-engine/PlayerActor.d.ts b/api/core-engine/PlayerActor.d.ts
new file mode 100644
index 000000000..82514adab
--- /dev/null
+++ b/api/core-engine/PlayerActor.d.ts
@@ -0,0 +1,249 @@
+
+/**
+ * Class to manipulate with separate players.
+ * @remarks
+ * It is temporary! Most methods works only 1 server tick!
+ */
+declare class PlayerActor {
+ constructor(playerUid: number);
+
+ /**
+ * @returns Player's unique numeric entity ID.
+ */
+ getUid(): number;
+
+ /**
+ * @returns ID of dimension where player is.
+ */
+ getDimension(): number;
+
+ /**
+ * @returns Player's gamemode.
+ */
+ getGameMode(): number;
+
+ /**
+ * Adds item to player's inventory.
+ * @param dropRemaining if true, surplus will be dropped near player
+ */
+ addItemToInventory(id: number, count: number, data: number, extra: ItemExtraData | null, dropRemaining: boolean): void;
+
+ /**
+ * @returns Inventory slot's contents.
+ */
+ getInventorySlot(slot: number): ItemInstance;
+
+ /**
+ * Sets inventory slot's contents.
+ */
+ setInventorySlot(slot: number, id: number, count: number, data: number, extra: ItemExtraData | null): void;
+
+ /**
+ * @returns Armor slot's contents.
+ */
+ getArmor(slot: number): ItemInstance;
+
+ /**
+ * Sets armor slot's contents.
+ */
+ setArmor(slot: number, id: number, count: number, data: number, extra: ItemExtraData | null): void;
+
+ /**
+ * Sets respawn coords for the player.
+ */
+ setRespawnCoords(x: number, y: number, z: number): void;
+
+ /**
+ * Spawns exp on coords.
+ * @param value experience points value
+ */
+ spawnExpOrbs(x: number, y: number, z: number, value: number): void;
+
+ /**
+ * @since 2.2.1b102
+ */
+ getPointer(): number;
+
+ /**
+ * @returns Whether the player is a valid entity.
+ * @since 2.2.0b75 (not working before)
+ */
+ isValid(): boolean;
+
+ /**
+ * @returns Player's selected slot.
+ */
+ getSelectedSlot(): number;
+
+ /**
+ * Sets player's selected slot.
+ */
+ setSelectedSlot(slot: number): void;
+
+ /**
+ * @returns Player's experience.
+ */
+ getExperience(): number;
+
+ /**
+ * Sets player's experience.
+ */
+ setExperience(value: number): void;
+
+ /**
+ * Add experience to player.
+ */
+ addExperience(amount: number): void;
+
+ /**
+ * @returns Player's xp level.
+ */
+ getLevel(): number;
+
+ /**
+ * Sets player's xp level.
+ */
+ setLevel(level: number): void;
+
+ /**
+ * @returns Player's exhaustion.
+ */
+ getExhaustion(): number;
+
+ /**
+ * Sets player's exhaustion.
+ */
+ setExhaustion(value: number): void;
+
+ /**
+ * @returns Player's hunger.
+ */
+ getHunger(): number;
+
+ /**
+ * Sets player's hunger.
+ */
+ setHunger(value: number): void;
+
+ /**
+ * @returns Player's saturation.
+ */
+ getSaturation(): number;
+
+ /**
+ * Sets player's saturation.
+ */
+ setSaturation(value: number): void;
+
+ /**
+ * @returns Player's score.
+ */
+ getScore(): number;
+
+ /**
+ * Sets player's score.
+ */
+ setScore(value: number): void;
+
+ /**
+ * @since 2.2.1b101 (TODO: fix in changelog)
+ */
+ getItemUseDuration(): number;
+
+ /**
+ * @since 2.2.1b101 (TODO: fix in changelog)
+ */
+ getItemUseIntervalProgress(): number;
+
+ /**
+ * @since 2.2.1b101 (TODO: fix in changelog)
+ */
+ getItemUseStartupProgress(): number;
+
+ /**
+ * @returns `true` if player has operator permissions
+ * @since 2.3.1b116
+ */
+ isOperator(): boolean;
+
+ /**
+ * Sets some of the player's abilities.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @param value the value to be set for the ability
+ * @remarks
+ * Server-side analogue of {@link Player.setAbility}.
+ * @since 2.3.1b116
+ */
+ setPlayerBooleanAbility(ability: string, value: boolean): void;
+
+ /**
+ * Sets some of the player's abilities.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @param value the value to be set for the ability
+ * @remarks
+ * Server-side analogue of {@link Player.setAbility}.
+ * @since 2.3.1b116
+ */
+ setPlayerFloatAbility(ability: string, value: number): void;
+
+ /**
+ * Gets one of the player's abilities in a boolean form.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @returns Current value of the ability in a boolean form.
+ * @remarks
+ * Server-side analogue of {@link Player.getBooleanAbility}.
+ * @since 2.3.1b116
+ */
+ getPlayerBooleanAbility(ability: string): boolean;
+
+ /**
+ * Gets one of the player's abilities in a form
+ * of floating-point number.
+ * @param ability ability name constant, should be
+ * one of the {@link EPlayerAbility} constants
+ * @returns Current value of the ability in a form
+ * of floating-point number.
+ * @remarks
+ * Server-side analogue of {@link Player.getFloatAbility}.
+ * @since 2.3.1b116
+ */
+ getPlayerFloatAbility(ability: string): number;
+
+ /**
+ * @returns `true` if player is allowed to fly, `false` otherwise.
+ * @since 2.3.1b116
+ * @remarks
+ * Server-side analogue of {@link Player.getFlyingEnabled}.
+ */
+ canFly(): boolean;
+
+ /**
+ * Enables or disables player's ability to fly.
+ * @param enabled whether the player can fly or not
+ * @since 2.3.1b116
+ * @remarks
+ * Server-side analogue of {@link Player.setFlyingEnabled}.
+ */
+ setCanFly(enabled: boolean): void;
+
+ /**
+ * @returns `true` if player is flying, `false` otherwise.
+ * @since 2.3.1b116
+ * @remarks
+ * Server-side analogue of {@link Player.getFlying}.
+ */
+ isFlying(): boolean;
+
+ /**
+ * Changes player's current flying state, call {@link PlayerActor.setCanFly}
+ * to be able to set this property to `true`.
+ * @param enabled whether the player should fly or not
+ * @since 2.3.1b116
+ * @remarks
+ * Server-side analogue of {@link Player.setFlying}.
+ */
+ setFlying(enabled: boolean): void;
+}
diff --git a/api/core-engine/Recipes.d.ts b/api/core-engine/Recipes.d.ts
new file mode 100644
index 000000000..5aacace1f
--- /dev/null
+++ b/api/core-engine/Recipes.d.ts
@@ -0,0 +1,553 @@
+/**
+ * Module used to manipulate crafting recipes for vanilla and custom workbenches.
+ */
+declare namespace Recipes {
+ /**
+ * Adds new shaped crafting recipe.
+ * @param result recipe result item
+ * @param mask recipe shape, up to three string corresponding to the three
+ * crafting field rows; each character means one item in the field
+ * @param data an array explaining the meaning of each character within
+ * mask. The array should contain three values for each symbol: the symbol
+ * itself, item ID and item data.
+ * @param func function to be called when the craft is processed
+ * @param prefix recipe prefix. Use a non-empty values to register recipes
+ * for custom workbenches
+ *
+ * @example
+ * ```js
+ * Recipes.addShaped({ id: 264, count: 1, data: 0 }, [
+ * "ax",
+ * "xa",
+ * "ax"
+ * ], ['x', 265, 0, 'a', 266, 0]);
+ * ```
+ *
+ * @remarks
+ * Pickaxe recipe should look like this:
+ * ```text
+ * "+++"
+ * " | "
+ * " | "
+ * ```
+ * Do not use empty lines or line endings, if the recipe can be placed
+ * within less then three rows or cols; e.g., to craft plates, you can
+ * use a shape like this:
+ * ```text
+ * "--"
+ * ```
+ */
+ function addShaped(result: ItemInstance, mask: string[], data: (string | number)[], func?: CraftingFunction, prefix?: string): WorkbenchShapedRecipe;
+
+ /**
+ * @see {@link Recipes.addShaped} for details.
+ * @param vanilla should be recipe considered as vanilla,
+ * custom logic callback will be ignored in that case
+ * @since 2.2.1b110
+ */
+ function addShapedGeneric(result: ItemInstance, mask: string[], data: (string | number)[], func?: CraftingFunction, prefix?: string, vanilla?: boolean): WorkbenchShapedRecipe;
+
+ /**
+ * Recipes considered as vanilla completely ignores
+ * custom logic callbacks.
+ * @see {@link Recipes.addShaped} for details.
+ * @since 2.2.1b108
+ */
+ function addShapedVanilla(result: ItemInstance, mask: string[], data: (string | number)[], func?: CraftingFunction, prefix?: string): WorkbenchShapedRecipe;
+
+ /**
+ * Same as {@link Recipes.addShaped}, but you can specify result as three
+ * separate values corresponding to ID, count and data.
+ */
+ function addShaped2(id: number, count: number, aux: number, mask: string[], data: (string | number)[], func?: CraftingFunction, prefix?: string): WorkbenchShapedRecipe;
+
+ /**
+ * Adds new shapeless crafting recipe.
+ * @param result recipe result item
+ * @param data crafting ingredients, an array of objects representing item
+ * ID and data
+ * @param func function to be called when the craft is processed
+ * @param prefix recipe prefix; use a non-empty values to register recipes
+ * for custom workbenches
+ *
+ * @example
+ * ```js
+ * Recipes.addShapeless({ id: 264, count: 1, data: 0 }, [
+ * { id: 265, data: 0 }, { id: 265, data: 0 }, { id: 265, data: 0 },
+ * { id: 266, data: 0 }, { id: 266, data: 0 }, { id: 266, data: 0 }
+ * ]);
+ * ```
+ */
+ function addShapeless(result: ItemInstance, data: { id: number, data: number }[], func?: CraftingFunction, prefix?: string): WorkbenchShapelessRecipe;
+
+ /**
+ * @see {@link Recipes.addShapeless} for details.
+ * @param vanilla should be recipe considered as vanilla,
+ * custom logic callback will be ignored in that case
+ * @since 2.2.1b110
+ */
+ function addShapelessGeneric(result: ItemInstance, data: { id: number, data: number }[], func?: CraftingFunction, prefix?: string, vanilla?: boolean): WorkbenchShapelessRecipe;
+
+ /**
+ * Recipes considered as vanilla completely ignores
+ * custom logic callbacks.
+ * @see {@link Recipes.addShapeless} for details.
+ * @since 2.2.1b108
+ */
+ function addShapelessVanilla(result: ItemInstance, data: { id: number, data: number }[], func?: CraftingFunction, prefix?: string): WorkbenchShapelessRecipe;
+
+ /**
+ * Deletes recipe by it's result.
+ * @param result recipe result
+ */
+ function deleteRecipe(result: ItemInstance): void;
+
+ /**
+ * Removes recipe by result ID, count and data.
+ */
+ function removeWorkbenchRecipe(id: number, count: number, data: number): void;
+
+ /**
+ * Gets all available recipes for the recipe result.
+ * @returns Collection object containing {@link Recipes.WorkbenchRecipe}.
+ */
+ function getWorkbenchRecipesByResult(id: number, count: number, data: number): java.util.Collection;
+
+ /**
+ * Gets all available recipes containing an ingredient.
+ * @returns Collection object containing {@link Recipes.WorkbenchRecipe}.
+ */
+ function getWorkbenchRecipesByIngredient(id: number, data: number): java.util.Collection;
+
+ /**
+ * Gets recipe by the field and prefix.
+ * @param field {@link Recipes.WorkbenchField WorkbenchField} object containing crafting field
+ * information
+ * @param prefix recipe prefix, defaults to empty string (vanilla workbench)
+ * @returns Recipe {@link Recipes.WorkbenchRecipe WorkbenchRecipe} instance, containing useful methods and
+ * recipe information.
+ */
+ function getRecipeByField(field: WorkbenchField, prefix?: string): Nullable;
+
+ /**
+ * Gets recipe result item by the field and recipe prefix.
+ * @param field {@link Recipes.WorkbenchField WorkbenchField} object containing crafting field
+ * information
+ * @param prefix recipe prefix, defaults to empty string (vanilla workbench)
+ */
+ function getRecipeResult(field: WorkbenchField, prefix?: string): Nullable;
+
+ /**
+ * Performs crafting by the field contents and recipe prefix.
+ * @param field {@link Recipes.WorkbenchField WorkbenchField} object containing crafting field
+ * information
+ * @param prefix recipe prefix, defaults to empty string (vanilla workbench)
+ */
+ function provideRecipe(field: WorkbenchField, prefix?: string): Nullable;
+
+ /**
+ * Adds new furnace recipe.
+ * @param sourceId source item ID
+ * @param sourceData source item data
+ * @param resultId resulting item ID
+ * @param resultData resulting item data
+ * @param prefix prefix, used to create recipes for non-vanilla furnaces
+ */
+ function addFurnace(sourceId: number, sourceData: number, resultId: number, resultData: number, prefix?: string): void;
+
+ /**
+ * Adds new furnace recipe with no need to manually specify input item data
+ * (it defaults to -1).
+ * @param sourceId source item ID
+ * @param resultId result item ID
+ * @param resultData resulting item data
+ * @param prefix prefix, used to create recipes for non-vanilla furnaces; if
+ * the prefix is not empty and some recipes for this source exist for
+ * vanilla furnace, they are removed
+ */
+ function addFurnace(sourceId: number, resultId: number, resultData: number, prefix?: string): void
+
+ /**
+ * Removes furnace recipes by source item.
+ * @param sourceId source item ID
+ * @param sourceData source item data
+ */
+ function removeFurnaceRecipe(sourceId: number, sourceData: number): void;
+
+ /**
+ * Adds fuel that can be used in the furnace.
+ * @param id fuel item ID
+ * @param data fuel item data
+ * @param time burning time in ticks
+ */
+ function addFurnaceFuel(id: number, data: number, time: number): void;
+
+ /**
+ * Removes furnace fuel by fuel item ID and data.
+ */
+ function removeFurnaceFuel(id: number, data: number): void;
+
+ /**
+ * @param prefix recipe prefix used for non-vanilla furnaces
+ * @returns Furnace recipe resulting item.
+ */
+ function getFurnaceRecipeResult(id: number, data: number, prefix?: string): ItemInstance;
+
+ /**
+ * @returns Fuel burn duration by fuel item ID and data.
+ */
+ function getFuelBurnDuration(id: number, data: number): number;
+
+ /**
+ * Gets furnace recipes by result and custom prefix.
+ * @param resultId result item ID
+ * @param resultData result item data
+ * @param prefix recipe prefix used for non-vanilla furnaces
+ * @returns Collection object with all furnace recipes found by given params.
+ */
+ function getFurnaceRecipesByResult(resultId: number, resultData: number, prefix: string): java.util.Collection;
+
+ /**
+ * @returns Collection object with all registered workbench recipes.
+ * @since 2.2.1b96
+ */
+ function getAllWorkbenchRecipes(): java.util.Collection;
+
+ /**
+ * @returns Collection object with all registered furnace recipes.
+ * @since 2.2.1b96
+ */
+ function getAllFurnaceRecipes(): java.util.Collection;
+
+ /**
+ * Class used to simplify creation of custom workbenches.
+ */
+ class WorkbenchUIHandler {
+
+ /**
+ * Constructs a new Workbench UI handler.
+ * @param target target {@link UI.WindowContent.elements} section
+ * @param targetCon target container
+ * @param field workbench field
+ */
+ constructor(target: UI.ElementSet, targetCon: UI.Container, field: WorkbenchField);
+
+ /**
+ * Sets custom workbench prefix.
+ * @param prefix custom workbench prefix
+ */
+ setPrefix(prefix: string): void;
+
+ /**
+ * Refreshes all the recipes in the workbench.
+ * @returns Amount of recipes displayed.
+ */
+ refresh(): number;
+
+ /**
+ * Runs recipes refresh in the ticking thread delaying refresh process
+ * for a tick. To get recipes count use {@link Recipes.WorkbenchUIHandler.setOnRefreshListener WorkbenchUIHandler.setOnRefreshListener}.
+ */
+ refreshAsync(): void;
+
+ /**
+ * Registers listener to be notified when some recipe is selected.
+ * @param listener recipe selection listener
+ */
+ setOnSelectionListener(listener: { onRecipeSelected: (recipe: WorkbenchRecipe) => void }): void;
+
+ /**
+ * Registers listener to be notified when the workbench starts and
+ * completes refreshing.
+ * @param listener workbench refresh listener
+ */
+ setOnRefreshListener(listener: { onRefreshCompleted: (count: number) => void, onRefreshStarted: () => void }): void;
+
+ /**
+ * Deselects current recipe (asynchronously).
+ */
+ deselectCurrentRecipe(): void;
+
+ /**
+ * Sets workbench recipes displaying limit.
+ * @param count count of the recipes to show
+ * @default 250
+ */
+ setMaximumRecipesToShow(count: number): void;
+ }
+
+ /**
+ * Object representing workbench recipe.
+ */
+ interface WorkbenchRecipe extends java.lang.Object {
+ /**
+ * @returns `true`, if the recipe is valid, `false` otherwise.
+ */
+ isValid(): boolean;
+
+ /**
+ * @param c recipe entry character
+ * @returns Recipe entry by entry character.
+ */
+ getEntry(c: string): RecipeEntry;
+
+ /**
+ * @returns Resulting item instance.
+ */
+ getResult(): ItemInstance;
+
+ /**
+ * @returns `true` if specified item is recipe's result, `false` otherwise.
+ */
+ isMatchingResult(id: number, count: number, data: number): boolean;
+
+ /**
+ * @returns Recipe unique mask identifier.
+ */
+ getRecipeMask(): string;
+
+ /**
+ * @param field workbench field to compare with
+ * @returns `true` if the field contains this recipe, false` otherwise.
+ */
+ isMatchingField(field: WorkbenchField): boolean;
+
+ /**
+ * @returns All recipe's entries in a java array.
+ */
+ getSortedEntries(): native.Array;
+
+ /**
+ * Tries to fill workbench field with current recipe.
+ * @param field workbench field to fill
+ */
+ putIntoTheField(field: WorkbenchField): void;
+
+ /**
+ * @returns Recipe prefix.
+ * @default ""
+ */
+ getPrefix(): string;
+
+ /**
+ * Sets prefix value for the recipe.
+ * @param prefix new prefix value
+ */
+ setPrefix(prefix: string): void;
+
+ /**
+ * Compares current recipe's prefix with given one.
+ * @param prefix prefix value to compare with
+ * @returns `true`, if current recipe's prefix is the same as given one,
+ * `false` otherwise.
+ */
+ isMatchingPrefix(prefix: string): boolean;
+
+ /**
+ * Sets craft function for the recipe.
+ * @param callback function to be called on item craft
+ */
+ setCallback(callback: CraftingFunction): void;
+
+ /**
+ * @returns Current crafting function or null if no one was specified.
+ */
+ getCallback(): Nullable;
+
+ addToVanillaWorkbench(): void;
+
+ getEntryCodes(): java.util.ArrayList;
+
+ getEntryCollection(): java.util.Collection;
+
+ getRecipeUid(): number;
+
+ isPossibleForInventory(inv: java.util.HashMap): boolean;
+
+ isVanilla(): boolean;
+
+ provideRecipe(field: WorkbenchField): Nullable;
+
+ provideRecipeForPlayer(field: WorkbenchField, player: number): Nullable;
+
+ putIntoTheField(field: WorkbenchField, player: number): void;
+
+ setEntries(entries: java.util.HashMap): void;
+
+ /**
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ setVanilla(isVanilla: boolean): WorkbenchRecipe;
+
+ }
+
+ /**
+ * Object representing workbench shaped recipe.
+ */
+ interface WorkbenchShapedRecipe extends WorkbenchRecipe {
+
+ addVariants(variants: java.util.ArrayList): void;
+
+ setPattern(pattern: string[]): void;
+
+ setPattern(pattern: RecipeEntry[][]): void;
+
+ }
+
+ /**
+ * Object representing workbench shapeless recipe.
+ */
+ interface WorkbenchShapelessRecipe extends WorkbenchRecipe {
+
+ addVariants(variants: java.util.ArrayList): void;
+
+ }
+
+
+ /**
+ * Object representing furnace recipe.
+ */
+ interface FurnaceRecipe extends java.lang.Object {
+
+ readonly inData: number;
+ readonly inId: number;
+ readonly resData: number;
+ readonly resId: number;
+
+ /**
+ * @returns `true`, if the recipe is valid, `false` otherwise.
+ */
+ isValid(): boolean;
+
+ /**
+ * @returns Resulting item instance.
+ */
+ getResult(): ItemInstance;
+
+ /**
+ * @returns Recipe prefix.
+ * @default ""
+ */
+ getPrefix(): string;
+
+ /**
+ * Sets prefix value for the recipe.
+ * @param prefix new prefix value
+ */
+ setPrefix(prefix: string): void;
+
+ /**
+ * Compares current recipe's prefix with given one.
+ * @param prefix prefix value to compare with
+ * @returns `true`, if current recipe's prefix is the same as given one,
+ * `false` otherwise.
+ */
+ isMatchingPrefix(prefix: string): boolean;
+
+ getInputKey(): number;
+
+ }
+
+
+ /**
+ * Function called when the craft is in progress.
+ * @param api object used to perform simple recipe manipulations and to prevent
+ * crafting
+ * @param field array containing all slots of the crafting field
+ * @param result recipe result item instance
+ */
+ interface CraftingFunction {
+ (api: WorkbenchFieldAPI, field: UI.Slot[], result: ItemInstance, player: number): void
+ }
+
+ /**
+ * Object representing workbench field.
+ */
+ interface WorkbenchField {
+ /**
+ * @param slot slot index
+ * @returns Workbench slot instance by slot index.
+ */
+ getFieldSlot(slot: number): UI.AbstractSlot;
+
+ /**
+ * @since 2.2.1b108
+ */
+ getFieldSlot(x: number, y: number): UI.AbstractSlot;
+
+ /**
+ * @returns JS array of all slots.
+ */
+ asScriptableField(): UI.AbstractSlot[];
+
+ /**
+ * @since 2.2.1b106
+ */
+ getWorkbenchFieldSize(): number;
+ }
+
+ /**
+ * Object used to work with workbench field in the craft function.
+ */
+ interface WorkbenchFieldAPI {
+
+ /**
+ * @param slot slot index
+ * @returns Workbench slot instance by slot index.
+ */
+ getFieldSlot(slot: number): UI.Slot;
+
+ /**
+ * Decreases item count in the specified slot, if possible.
+ * @param slot slot index
+ */
+ decreaseFieldSlot(slot: number): void;
+
+ /**
+ * Prevents crafting event.
+ */
+ prevent(): void;
+
+ /**
+ * @returns `true`, if crafting event was prevented, `false` otherwise.
+ */
+ isPrevented(): boolean;
+
+ /**
+ * @since 2.2.1b106
+ */
+ getFieldSize(): number;
+ }
+
+ /**
+ * Crafting recipe entry.
+ */
+ interface RecipeEntry {
+ readonly data: number;
+ readonly id: number;
+
+ getMask(): string;
+ getCodeByItem(id: number, data: number): number;
+ getCode(): number;
+
+ /**
+ * @param slot slot to compare with
+ * @returns `true` if recipe entry matches the slot.
+ */
+ isMatching(slot: UI.AbstractSlot): boolean;
+
+ /**
+ * @param slot slot to compare with
+ * @returns `true` if recipe entry matches the slot.
+ * @since 2.2.1b108
+ */
+ isMatching(slot: Nullable): boolean;
+
+ /**
+ * @param entry entry to compare with
+ * @returns `true` if recipe entry matches another entry.
+ */
+ isMatching(entry: RecipeEntry): boolean;
+ }
+
+}
diff --git a/api/core-engine/Render.d.ts b/api/core-engine/Render.d.ts
new file mode 100644
index 000000000..c2e63eaea
--- /dev/null
+++ b/api/core-engine/Render.d.ts
@@ -0,0 +1,404 @@
+/**
+ * Class that is used to give mobs, animations and blocks custom shape.
+ */
+declare class Render {
+ readonly isEmpty: boolean;
+ readonly isChangeable: boolean;
+ readonly renderer: Nullable;
+ readonly model: Nullable;
+ /**
+ * @internal
+ */
+ readonly parts: { [key: string]: Render.ModelPart };
+ readonly renderId: number;
+
+ /**
+ * Creates a new Render instance with specified parameters.
+ * @param parameters specifies all the
+ * properties of the object. If it is a number, vanilla render ID is used,
+ * if it is a string, used as {@link Render.RenderParameters.name RenderParameters.name} name property
+ */
+ constructor(parameters?: Render.RenderParameters | string | number);
+
+ /**
+ * @returns Render identifier that can be used to set render to the mob,
+ * animation or block.
+ */
+ getID(): number;
+ /**
+ * @returns Render identifier that can be used to set render to the mob,
+ * animation or block.
+ */
+ getRenderType(): number;
+ /**
+ * @returns Render identifier that can be used to set render to the mob,
+ * animation or block.
+ */
+ getId(): number;
+
+ /**
+ * Specifies additional params for the following {@link Render}.
+ * @param params specifies all the
+ * properties of the object. If it is a number, vanilla render ID is used,
+ * if it is a string, used as {@link Render.RenderParameters.name RenderParameters.name} name property
+ */
+ init(params?: Render.RenderParameters | string | number): void
+
+ initModel(): void;
+
+ checkChangeable(): void;
+
+ rebuild(): void;
+
+ /**
+ * @returns Render's model that defines it's visual shape.
+ */
+ getModel(): Render.Model;
+
+ /**
+ * @returns Transform object used to manipulate current render.
+ */
+ transform(): Render.Transform;
+
+ /**
+ * @param partName full name of the part separated by "."
+ * @returns A part of the render by it's full name. By default, there are six
+ * parts available to the user. However, you can create your own parts that
+ * suit your needs and get them by their names.
+ */
+ getPart(partName: string): Render.ModelPart;
+
+ /**
+ * Adds a part to the render by it's full name. The part should be descendent
+ * of one of the six default parts, see {@link Render.ModelPart ModelPart} for details.
+ * @param partName full name of the part separated by "."
+ * @param partParams specifies all the parameters of the part
+ * @returns Newly created part.
+ */
+ addPart(partName: string, partParams?: Render.PartParameters): Render.ModelPart;
+
+ /**
+ * Sets all the properties of the part by it's full name.
+ * @param partName full name of the part separated by "."
+ * @param partParams specifies all the parameters of the part
+ */
+ setPartParams(partName: string, partParams?: Render.PartParameters): void;
+
+ /**
+ * Sets the content and all properties of the part by it's full name.
+ * @param name full name of the part separated by "."
+ * @param data array of part data objects to be applied to the part
+ * @param params specifies all the parameters of the part
+ */
+ setPart(name: string, data: Render.PartElement[], params: Render.PartParameters): void;
+
+ /**
+ * @internal
+ */
+ _setPartRecursive(part: Render.ModelPart, data: Render.PartElement[], coords: Vector): void;
+
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ fromCache(data: Render.Cache): void;
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ toCache(): Render.Cache;
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ saveState(name: string, isLocal: boolean): void;
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ loadState(name: string, isLocal: boolean): void;
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ loadInitialState(name: string): void;
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ saveToNext(name: string, isLocal: boolean): void;
+ /**
+ * @deprecated Does nothing, not required anymore.
+ */
+ setTextureResolution(...params: any): void;
+}
+
+/**
+ * We're meant native renderer, it's not connected with
+ * same class here.
+ */
+declare namespace Render {
+ /**
+ * An interface of the object that is used as {@link Render.constructor} parameter.
+ * */
+ interface RenderParameters {
+ /**
+ * Name of the cached Render object to be used.
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ name?: string;
+ /**
+ * Item ID for Item Sprite render type.
+ */
+ item?: number;
+ /**
+ * Relative path to the texture used by render,
+ * e.g. `"textures/entity/zombie.png"`.
+ */
+ skin?: string;
+ /**
+ * Render scale multiplier.
+ */
+ scale?: number;
+ /**
+ * If set to true, a humanoid render is constructed, empty otherwise.
+ */
+ raw?: boolean;
+ }
+
+ /**
+ * Part's box description specified in {@link Render.setPart} method.
+ */
+ interface PartElement {
+ /**
+ * Box coordinates, relative to part's coordinates.
+ */
+ coords: Vector,
+ /**
+ * Box texture offset.
+ */
+ uv?: { x: number, y: number },
+ /**
+ * Box size.
+ * @param w additional size to be added from all the
+ * six sizes of the box
+ */
+ size: { x: number, y: number, z: number, w?: number },
+ /**
+ * Specifies child elements, using current box coordinates
+ * as base for the child boxes.
+ */
+ children?: PartElement[]
+ }
+
+ /**
+ * @deprecated Unavailable feature, renderers must be saved independently.
+ */
+ interface Cache {
+ renderer: Nullable,
+ renderId: number,
+ model: Nullable,
+ isChangeable: boolean,
+ parts: { [key: string]: ModelPart }
+ }
+
+ /**
+ * Interface used to perform transformation on the specified render object.
+ */
+ interface Transform {
+ /**
+ * Clears all the transformations applied to the render.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ clear(): Transform;
+ /**
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ lock(): Transform;
+ /**
+ * Performs arbitrary matrix transformations on the render.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ matrix(m00: number, m01: number, m02: number, m03: number,
+ m10: number, m11: number, m12: number, m13: number,
+ m20: number, m21: number, m22: number, m23: number,
+ m30: number, m31: number, m32: number, m33: number): Transform;
+ /**
+ * Rotates render along three axes.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ rotate(rotX: number, rotY: number, rotZ: number): Transform;
+ /**
+ * Scales render along the three axes.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ scale(scaleX: number, scaleY: number, scaleZ: number): Transform;
+ /**
+ * Scales the render along all the three axes. Applicable only to the
+ * {@link Animation}'s transformations.
+ * @returns Reference to itself to be used in sequential calls.
+ * @deprecated Consider using {@link Render.Transform.scale} instead.
+ */
+ scaleLegacy(scale: number): Transform;
+ /**
+ * Translates render along three axes.
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ translate(x: number, y: number, z: number): Transform;
+ /**
+ * @returns Reference to itself to be used in sequential calls.
+ */
+ unlock(): Transform;
+ }
+
+ /**
+ * An interface of the object that is used as {@link Render.addPart} parameter.
+ */
+ interface PartParameters {
+ /**
+ * If false or not specified in {@link Render.setPart} call, the part is
+ * cleared, otherwise new parts and params are applied to the existing parts.
+ */
+ add?: boolean,
+ /**
+ * Texture width, use the real texture file width or change it to stretch
+ * texture.
+ */
+ width?: number,
+ /**
+ * Texture height, use the real texture file height or change it to stretch
+ * texture.
+ */
+ height?: number,
+ /**
+ * Texture horizontal offset from left up corner.
+ */
+ u?: number,
+ /**
+ * Texture vertical offset from left up corner.
+ */
+ v?: number,
+ /**
+ * Part center position.
+ */
+ pos?: Vector | [number, number, number];
+ /**
+ * Part rotation.
+ */
+ rotation?: Vector | [number, number, number];
+ }
+
+ interface Model {
+ /**
+ * Clears all parts of the model.
+ */
+ clearAllParts(): void;
+ /**
+ * @param partName part name
+ * @returns Part by it's name or null if part doesn't exist.
+ */
+ getPart(partName: string): Nullable;
+ /**
+ * @param partName part name
+ * @returns `true` if part with specified name exists in the model,
+ * `false` otherwise.
+ */
+ hasPart(partName: string): boolean;
+ /**
+ * Resets the model
+ */
+ reset(): void;
+ }
+
+ interface ModelPart {
+ /**
+ * Adds a new box to the part on the specified coordinates (relative to
+ * the part's coordinates) of the specified size (width, height, length).
+ */
+ addBox(x: number, y: number, z: number, w: number, h: number, l: number): void;
+ /**
+ * Adds a new box to the part on the specified coordinates (relative to
+ * the part's coordinates) of the specified size (width, height, length).
+ * @param add additional size to be added from all the six sizes of the
+ * box
+ */
+ addBox(x: number, y: number, z: number, w: number, h: number, l: number, add: number): void;
+ /**
+ * Creates a new part with specified name. If a part with specified name
+ * already exists, returns the existing part.
+ * @param name name of the part to create or return
+ */
+ addPart(name: string): ModelPart;
+ /**
+ * Clears the contents of the part.
+ */
+ clear(): void;
+ /**
+ * @returns Mesh specified via {@link Render.ModelPart.setMesh} call or `null`,
+ * if this part doesn't contain mesh.
+ */
+ getMesh(): Nullable;
+ /**
+ * Specifies {@link RenderMesh} to be used as a part.
+ */
+ setMesh(mesh: Nullable): void;
+ /**
+ * Specifies part default offset.
+ */
+ setOffset(offsetX: number, offsetY: number, offsetZ: number): void;
+ /**
+ * Specifies part rotation.
+ */
+ setRotation(rotationX: number, rotationY: number, rotationZ: number): void;
+ /**
+ * Specifies texture UV offset.
+ */
+ setTextureOffset(u: number, v: number): void;
+ /**
+ * Specifies texture UV offset.
+ */
+ setTextureOffset(u: number, v: number): void;
+ /**
+ * Specifies texture UV offset.
+ * @param placeholder deprecated boolean parameter
+ * @deprecated Use same method without last parameter.
+ */
+ setTextureOffset(u: number, v: number, placeholder: boolean): void;
+ /**
+ * Specifies texture size size, use the real texture file size or change
+ * it to stretch texture.
+ */
+ setTextureSize(w: number, h: number): void;
+ /**
+ * Specifies texture size size, use the real texture file size or change
+ * it to stretch texture.
+ */
+ setTextureSize(w: number, h: number): void;
+ /**
+ * Specifies texture size size, use the real texture file size or change
+ * it to stretch texture.
+ * @param placeholder deprecated boolean parameter
+ * @deprecated Use same method without last parameter.
+ */
+ setTextureSize(w: number, h: number, placeholder: boolean): void;
+ }
+
+ interface FinalizeCallback {
+ onFinalized(renderer: Renderer): void;
+ }
+ interface FinalizeCallbackJS {
+ (renderer: Renderer): void;
+ }
+
+ interface Renderer {
+ isHumanoid: boolean;
+ transform: Transform;
+ addFinalizeCallback(callback: FinalizeCallback | FinalizeCallbackJS): void;
+ getModel(): Model;
+ getPointer(): number;
+ getRenderType(): number;
+ getScale(): number;
+ release(): void;
+ setFinalizeable(finalizeable: boolean): void;
+ setScale(scale: number): void;
+ setSkin(skin: string): void;
+ }
+
+ namespace Renderer {
+ type Transform = Render.Transform;
+ }
+}
diff --git a/api/core-engine/RenderMesh.d.ts b/api/core-engine/RenderMesh.d.ts
new file mode 100644
index 000000000..2b04f0f22
--- /dev/null
+++ b/api/core-engine/RenderMesh.d.ts
@@ -0,0 +1,231 @@
+/**
+ * Class representing a set of vertices with some other parameters required to
+ * display them correctly. Used as block, entity and item models, in animations
+ * and actually anywhere you need some physical shape.
+ */
+declare class RenderMesh {
+ /**
+ * Creates a new {@link RenderMesh} and initializes it from file.
+ * See {@link RenderMesh.importFromFile} method description for
+ * parameters details.
+ */
+ constructor(path: string, type: string, params: Nullable);
+ /**
+ * Creates a new empty {@link RenderMesh}.
+ */
+ constructor();
+
+ /**
+ * Adds new mesh to the current one on the specified coordinates.
+ * @param mesh {@link RenderMesh} object to be added to current mesh
+ * @since 2.0.2b23
+ */
+ addMesh(mesh: RenderMesh): void;
+ /**
+ * Adds new mesh to the current one on the specified coordinates
+ * with specified offset.
+ * @param mesh {@link RenderMesh} object to be added to current mesh
+ * @since 2.0.2b23
+ */
+ addMesh(mesh: RenderMesh, addX: number, addY: number, addZ: number): void;
+ /**
+ * Adds new mesh to the current one on the specified coordinates
+ * with specified offset and scale.
+ * @param mesh {@link RenderMesh} object to be added to current mesh
+ * @since 2.0.2b23
+ */
+ addMesh(mesh: RenderMesh, addX: number, addY: number, addZ: number, scaleX: number, scaleY: number, scaleZ: number): void;
+ /**
+ * Adds a new vertex on the specified coordinates.
+ */
+ addVertex(x: number, y: number, z: number): void;
+ /**
+ * Adds a new vertex on the specified coordinates.
+ * @param u x texture offset of the vertex
+ * @param v y texture offset of the vertex
+ */
+ addVertex(x: number, y: number, z: number, u: number, v: number): void;
+ /**
+ * Removes all vertices of the mesh.
+ */
+ clear(): void;
+ /**
+ * Creates a copy of current {@link RenderMesh}.
+ * @since 2.0.2b26
+ */
+ clone(): RenderMesh;
+ /**
+ * Scales the mesh to fit into the specified box.
+ * @since 2.0.2b26
+ */
+ fitIn(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number): void;
+ /**
+ * Scales the mesh to fit into the specified box.
+ * @param keepRatio if `true`, the ratio of the dimensions are preserved
+ * @since 2.0.2b26
+ */
+ fitIn(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number, keepRatio: boolean): void;
+ /**
+ * @returns Pointer to the native object instance of the
+ * following {@link RenderMesh}, represented as long number.
+ */
+ getPtr(): number;
+ getReadOnlyVertexData(): RenderMesh.ReadOnlyVertexData;
+ /**
+ * Imports mesh file using specified path.
+ * @param path path to the mesh file. Path should be absolute path or
+ * be relative to the resources folder or to the "models/" folder
+ * @param type file type to read mesh from. The only currently supported mesh file
+ * type is "obj"
+ * @param importParams additional import parameters or null, if not needed
+ */
+ importFromFile(path: string, type: "obj", importParams: Nullable): void;
+ invalidate(): void;
+ newGuiRenderMesh(): RenderMesh.GuiRenderMesh;
+ /**
+ * Forces Minecraft to rebuild specified {@link RenderMesh} object.
+ */
+ rebuild(): void;
+ /**
+ * Resets color applied to the mesh.
+ * @default 0xfff // white
+ */
+ resetColor(): void;
+ /**
+ * Resets texture of the mesh.
+ */
+ resetTexture(): void;
+ /**
+ * Rotates the mesh around the specified coordinates.
+ * @param rotX rotation angle along X axis, in radians
+ * @param rotY rotation angle along Y axis, in radians
+ * @param rotZ rotation angle along Z axis, in radians
+ * @since 2.0.2b26
+ */
+ rotate(x: number, y: number, z: number, rotX: number, rotY: number, rotZ: number): void;
+ /**
+ * Rotates the mesh around the (0, 0, 0) coordinates.
+ * @param rotX rotation angle along X axis, in radians
+ * @param rotY rotation angle along Y axis, in radians
+ * @param rotZ rotation angle along Z axis, in radians
+ */
+ rotate(rotX: number, rotY: number, rotZ: number): void;
+ /**
+ * Scales the whole mesh along the three axis.
+ */
+ scale(x: number, y: number, z: number): void;
+ /**
+ * Specifies block texture to be used by mesh.
+ */
+ setBlockTexture(textureName: string, textureMeta: number): void;
+ /**
+ * Specifies color to be applied to the next vertices. If the color is not white and
+ * the texture is applied to mesh, texture's colors will be affected.
+ */
+ setColor(r: number, g: number, b: number): void;
+ /**
+ * Specifies color to be applied to the next vertices. If the color is not white and
+ * the texture is applied to mesh, texture's colors will be affected.
+ */
+ setColor(r: number, g: number, b: number, a: number): void;
+ /**
+ * Makes specified {@link RenderMesh} foliage tinted.
+ * @since 2.0.2b24
+ */
+ setFoliageTinted(): void;
+ /**
+ * Makes specified {@link RenderMesh} foliage tinted.
+ * @since 2.0.2b25
+ */
+ setFoliageTinted(leavesType: number): void;
+ /**
+ * Makes specified {@link RenderMesh} grass tinted.
+ * @since 2.0.2b24
+ */
+ setGrassTinted(): void;
+ /**
+ * Sets following {@link RenderMesh} light direction.
+ */
+ setLightDir(x: number, y: number, z: number): void;
+ setLightIgnore(ignore: boolean, bool2: boolean): void;
+ setLightParams(float1: number, float2: number, float3: number): void;
+ /**
+ * Sets following {@link RenderMesh} light position.
+ * @since 2.0.2b25
+ */
+ setLightPos(x: number, y: number, z: number): void;
+ /**
+ * Removes any tint from specified {@link RenderMesh}.
+ * @since 2.0.2b24
+ */
+ setNoTint(): void;
+ /**
+ * Specifies the normal vector for the next vertices.
+ */
+ setNormal(x: number, y: number, z: number): void;
+ /**
+ * Makes specified {@link RenderMesh} water tinted.
+ * @since 2.0.2b24
+ */
+ setWaterTinted(): void;
+ /**
+ * Translates the whole mesh along three axis.
+ */
+ translate(x: number, y: number, z: number): void;
+}
+
+declare namespace RenderMesh {
+ interface ReadOnlyVertexData {
+ readonly colors: native.Array;
+ readonly dataSize: number;
+ readonly indices: native.Array;
+ readonly uvs: native.Array;
+ readonly vertices: native.Array;
+ }
+
+ /**
+ * Object used in {@link RenderMesh.importFromFile} and
+ * one of {@link RenderMesh} constructors. Here you can put
+ * some additional parameters, that will be applied to the mesh,
+ * when the file is being imported.
+ */
+ interface ImportParams {
+ /**
+ * If `true`, all existing vertices of the mesh are deleted
+ * before the file is imported.
+ */
+ clear?: boolean,
+ /**
+ * If `true`, vertex of the texture is inverted.
+ */
+ invertV?: boolean,
+ /**
+ * Additional translation along x, y and z axis.
+ */
+ translate?: [number, number, number],
+ /**
+ * Additional scale along x, y and z axis.
+ */
+ scale?: [number, number, number],
+ /**
+ * If `true`, Minecraft won't be forced to rebuild the following
+ * {@link RenderMesh} before the file is imported.
+ */
+ noRebuild?: boolean
+ }
+
+ interface GuiRenderMesh {
+ rx: number;
+ ry: number;
+ rz: number;
+ x: number;
+ y: number;
+ z: number;
+ draw(gl: javax.microedition.khronos.opengles.GL10): void;
+ setVertices(vertices: number[]): void;
+ setIndices(indices: number[]): void;
+ setTextureCoordinates(textureCoords: number[]): void;
+ setColors(colors: number[]): void;
+ loadBitmap(bitmap: android.graphics.Bitmap): void;
+ }
+}
diff --git a/api/core-engine/Resources.d.ts b/api/core-engine/Resources.d.ts
new file mode 100644
index 000000000..da0b85285
--- /dev/null
+++ b/api/core-engine/Resources.d.ts
@@ -0,0 +1,68 @@
+/**
+ * @remarks
+ * Available in preloader scripts only!
+ */
+declare namespace Resources {
+
+ /**
+ * Creatings runtime pack, that will be removed on next
+ * launching game stage. Useful for both: client and server.
+ * @param typeStr one of: **resource** or **behavior**
+ * @param name generated pack name that additionaly hashes
+ * @returns Complete path to generated pack, it might be used
+ * to working with files and directories.
+ */
+ function addRuntimePack(typeStr: string, name: string): string;
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ */
+ function getAllResourceDirectories(): string[];
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ * @since 2.0.2b24
+ */
+ function getAllResourceDirectoriesPaths(): string[];
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ */
+ function searchFilesInDir(result: Array, baseDir: java.io.File, file: java.io.File, regex: string): void;
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ */
+ function getAllMatchingResourcesInDir(directory: Object, regex: string): string[];
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ */
+ function getAllMatchingResourcesInPath(directory: Object, regex: string): string[];
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ * @since 2.0.2b24
+ */
+ function getAllMatchingResources(regex: string): string[];
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ */
+ function getResourcePathNoVariants(path: string): Nullable;
+
+ /**
+ * @remarks
+ * Available in preloader scripts only!
+ * @since 2.0.2b24
+ */
+ function getResourcePath(path: string): Nullable;
+
+}
diff --git a/api/core-engine/Saver.d.ts b/api/core-engine/Saver.d.ts
new file mode 100644
index 000000000..bb1f7d67e
--- /dev/null
+++ b/api/core-engine/Saver.d.ts
@@ -0,0 +1,205 @@
+/**
+ * Module used to save data between world sessions,
+ * different worlds have their own saves.
+ */
+declare namespace Saver {
+ /**
+ * Function that loads data from saves scope.
+ */
+ interface ScopeLoadFunction {
+ /**
+ * @param scope object data from saves
+ */
+ (scope: object): void
+ }
+
+ /**
+ * Function used to save data.
+ */
+ interface ScopeSaveFunction {
+ /**
+ * @returns Object data to be serialized in saves scope.
+ */
+ (): Nullable
+ }
+
+ /**
+ * Creates saves scope, a universal data storage container. This storage
+ * container should be used whenever you need to save some data between
+ * world sessions. If you want to store primitives, use an object to wrap
+ * them.
+ * @param name saves scope name
+ * @param load function used to load saved data
+ * @param save function used to save data
+ *
+ * @example
+ * ```js
+ * let thirst = 20;
+ * Saver.addSavesScope("thirst_library.thirst",
+ * function read(scope) {
+ * thirst = scope ? scope.thirst : 20;
+ * },
+ * function save() {
+ * return { thirst: thirst };
+ * }
+ * );
+ * ```
+ */
+ function addSavesScope(name: string, load: ScopeLoadFunction, save: ScopeSaveFunction): void;
+
+ /**
+ * Function that returns default data to be passed
+ * to {@link ScopeLoadFunction} if there is no previous data.
+ * @since 2.3.1b116-3
+ */
+ interface DefaultSavesFunction {
+ (): Nullable
+ }
+
+ /**
+ * Interface that should be implemented to pass object as
+ * {@link Saver.registerScopeSaver} parameter.
+ */
+ interface IScopeSaver {
+ /**
+ * Function that loads data from saves scope.
+ */
+ read: ScopeLoadFunction,
+ /**
+ * Function used to save data.
+ */
+ save: ScopeSaveFunction,
+ /**
+ * Function that returns default data to be passed
+ * to {@link read} if there is no previous data.
+ * @since 2.3.1b116-3
+ */
+ getDefaultSaves?: DefaultSavesFunction
+ }
+
+ /**
+ * Registers object as scope saver.
+ * @param name saves scope name
+ * @param saver object that implements {@link Saver.IScopeSaver}
+ * interface and can be loaded and saved via it's functions calls
+ */
+ function registerScopeSaver(name: string, saver: IScopeSaver): void;
+
+ interface IHashSaver {
+ getId(): number;
+ setId(id: number): void;
+ }
+
+ type SaveableObjectType = object | org.json.JSONObject | IHashSaver;
+
+ /**
+ * Function that converts serialized data
+ * from saves scope to your object instance.
+ */
+ interface ObjectLoadFunction {
+ /**
+ * @param obj object data from saves
+ * @returns Instance of newly instantiated object.
+ */
+ (obj: object): SaveableObjectType
+ }
+
+ /**
+ * Function used to save serialized data of your object instance.
+ */
+ interface ObjectSaveFunction {
+ /**
+ * @param instance instance of your object to be saved
+ * @returns Object data to be serialized in saves scope.
+ */
+ (instance: SaveableObjectType): object
+ }
+
+ /**
+ * Interface that should be implemented to pass object as
+ * {@link Saver.registerObjectSaver} parameter.
+ */
+ interface IObjectSaver {
+ /**
+ * Function that converts serialized data
+ * from saves scope to your object instance.
+ */
+ read: ObjectLoadFunction,
+ /**
+ * Function used to save serialized data of your object instance.
+ */
+ save: ObjectSaveFunction
+ }
+
+ /**
+ * Registers object as object instance saver.
+ * @param name saves scope name
+ * @param saver object that implements {@link Saver.IObjectSaver}
+ * interface and can be loaded and saved via it's functions calls
+ * @returns Saver identifier of your object instance.
+ *
+ * @example
+ * ```js
+ * function PedestalTile(type) {
+ * this.type = type;
+ * Saver.registerObject(this, PedestalTile.saverId);
+ * }
+ * PedestalTile.saverId = Saver.registerObjectSaver("mystical_agriculture.pedestal", {
+ * read(obj) {
+ * return new PedestalTile(obj.type);
+ * },
+ * save(instance) {
+ * return { type: instance.type };
+ * }
+ * });
+ * ```
+ */
+ function registerObjectSaver(name: string, saver: IObjectSaver): number;
+
+ /**
+ * Registers object to be saved with a given saver
+ * by identifier received from {@link Saver.registerObjectSaver}.
+ * @param obj target object instance
+ * @param saverId to be used on saving
+ */
+ function registerObject(obj: SaveableObjectType, saverId: number): void;
+
+ /**
+ * Changes registered via {@link Saver.registerObject} instance
+ * behavior to object be skippable or not.
+ * @param obj target object instance
+ * @param ignore should be skipped on saving
+ */
+ function setObjectIgnored(obj: object, ignore: boolean): void;
+
+ /**
+ * Converts present object hieracly via registered
+ * {@link Saver.registerScopeSaver} and {@link Saver.registerObjectSaver}
+ * instances recursively to serialized data.
+ * @returns Serialized object hieracly transformed to string.
+ */
+ function serializeToString(obj: any): string;
+
+ /**
+ * Converts present object hieracly via registered
+ * {@link Saver.registerScopeSaver} and {@link Saver.registerObjectSaver}
+ * instances recursively to serialized data.
+ * @returns Serialized object hieracly.
+ */
+ function serialize(obj: any): object;
+
+ /**
+ * Converts present transformed to string serialized object
+ * via registered {@link Saver.registerScopeSaver} and
+ * {@link Saver.registerObjectSaver} recursively to instance hieracly.
+ * @returns Deserialized object instance hieracly.
+ */
+ function deserializeFromString(str: string): any;
+
+ /**
+ * Converts present serialized object via registered {@link Saver.registerScopeSaver}
+ * and {@link Saver.registerObjectSaver} recursively to instance hieracly.
+ * @returns Deserialized object instance hieracly.
+ */
+ function deserialize(obj: object): any;
+}
diff --git a/api/core-engine/ShaderUniformSet.d.ts b/api/core-engine/ShaderUniformSet.d.ts
new file mode 100644
index 000000000..675ba01e8
--- /dev/null
+++ b/api/core-engine/ShaderUniformSet.d.ts
@@ -0,0 +1,9 @@
+/**
+ * @since 2.0.2b20
+ */
+declare class ShaderUniformSet {
+ lock(): ShaderUniformSet;
+ unlock(): ShaderUniformSet;
+ setUniformValueArr(uniformSet: string, uniformName: string, value: number[]): ShaderUniformSet;
+ setUniformValue(uniformSet: string, uniformName: string, ...value: number[]): ShaderUniformSet;
+}
diff --git a/api/core-engine/SyncedNetworkData.d.ts b/api/core-engine/SyncedNetworkData.d.ts
new file mode 100644
index 000000000..0eef0f0e3
--- /dev/null
+++ b/api/core-engine/SyncedNetworkData.d.ts
@@ -0,0 +1,175 @@
+declare namespace SyncedNetworkData {
+ /**
+ * Server synced data validator and transformer, calls for every change.
+ * **Warning!** Please do NOT send changes here, any changes will sent after verifying.
+ * @param key key that was changed
+ * @param value value for this key
+ * @returns transformed value to set, `null` means no change will be performed
+ */
+ interface DataVerifierFunction {
+ (key: string, value: object): Nullable
+ }
+ /**
+ * When data changes (no matter where, it will be applied on both client and server sides),
+ * listener will be called with received or set synced data.
+ * @param data instance of data, there is no way to listener be called from other ones
+ * @param key key that was changed
+ * @param isExternal is change was received from other side (server for client, client for server)
+ */
+ interface OnDataChangedListenerFunction {
+ (data: SyncedNetworkData, key: string, isExternal: boolean): void
+ }
+}
+
+/**
+ * Class to work with values, synchronized between server and all clients.
+ */
+declare class SyncedNetworkData {
+ /**
+ * @returns Registered client synced data by name or null if it was not yet received.
+ */
+ static getClientSyncedData(name: string): Nullable;
+
+ /**
+ * Constructs server network data by specified name, clients will receive
+ * data via instance with same contructor.
+ */
+ constructor(name: string);
+ /**
+ * Constructs server network data with random uuid, name like SND will
+ * be applied (e.g., "SNDe58ed763-928c-4155-bee9-fdbaaadc15f3").
+ */
+ constructor();
+
+ /**
+ * @returns Requested value by key or null if key not found.
+ */
+ getObject(key: string): Nullable;
+ /**
+ * @returns Requested value by key or fallback if key not found.
+ */
+ getInt(key: string, fallback?: number): number;
+ /**
+ * @returns Requested value by key or fallback if key not found.
+ */
+ getLong(key: string, fallback?: number): number;
+ /**
+ * @returns Requested value by key or fallback if key not found.
+ */
+ getFloat(key: string, fallback?: number): number;
+ /**
+ * @returns Requested value by key or fallback if key not found.
+ */
+ getDouble(key: string, fallback?: number): number;
+ /**
+ * @returns Requested value by key or fallback if key not found.
+ */
+ getString(key: string, fallback?: string): string;
+ /**
+ * @returns Requested value by key or fallback if key not found.
+ */
+ getBoolean(key: string, fallback?: boolean): boolean;
+ /**
+ * Sets Object value by key.
+ */
+ putObject(key: string, value: java.lang.Object): void;
+ /**
+ * Sets Integer value by key.
+ */
+ putInt(key: any, value: number): void;
+ /**
+ * Sets Long value by key.
+ */
+ putLong(key: any, value: number): void;
+ /**
+ * Sets Float value by key.
+ */
+ putFloat(key: any, value: number): void;
+ /**
+ * Sets Double value by key.
+ */
+ putDouble(key: any, value: number): void;
+ /**
+ * Sets String value by key.
+ */
+ putString(key: any, value: string): void;
+ /**
+ * Sets Boolean value by key.
+ */
+ putBoolean(key: any, value: boolean): void;
+
+ /**
+ * @returns Name passed in constructor, which one will be used for packets.
+ */
+ getName(): string;
+ /**
+ * @returns `true` if it was server-side data that can be sent to clients.
+ */
+ isServer(): boolean;
+ /**
+ * @returns Connected client list, which receive this data.
+ */
+ getClients(): NetworkConnectedClientList;
+ /**
+ * Overrides connected client list, new one will automatically send server data.
+ */
+ setClients(clients: NetworkConnectedClientList): void;
+ /**
+ * Same as {@link SyncedNetworkData.sendChanges}.
+ */
+ apply(): void;
+ /**
+ * Sends changed data values.
+ */
+ sendChanges(): void;
+ /**
+ * Sends changed data values for specific client (dirty data remains).
+ * @param client connected client to server
+ * @since 2.3.1b116-3
+ */
+ sendChangesForClient(client: NetworkClient): void;
+
+ /**
+ * Adds event that catches changes of any data values on both sides.
+ */
+ addOnDataChangedListener(listener: SyncedNetworkData.OnDataChangedListenerFunction): void;
+ /**
+ * Removes data change event, that was registered by
+ * {@link SyncedNetworkData.addOnDataChangedListener} before.
+ */
+ removeOnDataChangedListener(listener: SyncedNetworkData.OnDataChangedListenerFunction): void;
+ /**
+ * Removes all data change events, that was registered by
+ * {@link SyncedNetworkData.addOnDataChangedListener} before.
+ */
+ removeAllListeners(): void;
+
+ /**
+ * Adds server-side data transformer received from client
+ * to the object by specified key.
+ */
+ addVerifier(key: string, verifier: SyncedNetworkData.DataVerifierFunction): void;
+ /**
+ * Adds server-side data transformer received from client
+ * that will be used if there is no verifier with specified key
+ * registered via {@link SyncedNetworkData.addVerifier}.
+ */
+ setGlobalVerifier(verifier: SyncedNetworkData.DataVerifierFunction): void;
+ /**
+ * Global verifier that was set via {@link SyncedNetworkData.setGlobalVerifier}.
+ */
+ getGlobalVerifier(): SyncedNetworkData.DataVerifierFunction;
+
+ /**
+ * @returns Serialized object data which are in object.
+ * @since 2.3.1b116-3
+ */
+ toJSON(): string;
+
+ /**
+ * Replaces existing data with those that are in given object.
+ * @param json serialized object data
+ * @since 2.3.1b116-3
+ */
+ fromJSON(json: string): void;
+}
diff --git a/api/core-engine/TagRegistry.d.ts b/api/core-engine/TagRegistry.d.ts
new file mode 100644
index 000000000..72a7ad62d
--- /dev/null
+++ b/api/core-engine/TagRegistry.d.ts
@@ -0,0 +1,208 @@
+/**
+ * Tag system allows you to assign tags to objects
+ * and put them into groups for further object search.
+ * @since 2.0.4b38
+ *
+ * @example
+ * Use constant to define group in global scope to reuse/export it:
+ *
+ * ```js
+ * const ENCHANT_TAG_GROUP = TagRegistry.getOrCreateGroup("enchant");
+ *
+ * BlockRegistry.registerDropFunctionForID(BlockID.tin_ore, function(coords, id, data, level, enchant, item, region) {
+ * if (level >= 2) {
+ * // Check item for "smelting" tag, which can be set to obtain smelted result
+ * if (ENCHANT_TAG_GROUP.getTags(item).contains("smelting")) {
+ * ToolAPI.dropOreExp(coords, 2, 2, enchant.experience, blockSource);
+ * return [[ItemID.tin_ingot, 1, 0]];
+ * } else {
+ * // Do default logic otherwise (if no tag has been set)
+ * return [[BlockID.tin_ore, 1, 0]]
+ * }
+ * }
+ * return [];
+ * }, 2);
+ *
+ * // Register tag factory, which are called to obtain tags every iteration
+ * ENCHANT_TAG_GROUP.addTagFactory(function(object, tags) {
+ * // In case if our object is item-like and equals smelting tool
+ * if (object && object.id == ItemID.smelting_multitool) {
+ * // Smelt our BlockID.tin_ore and a few vanilla ones
+ * tags.add("smelting");
+ * }
+ * });
+ * ```
+ *
+ * @example
+ * Obtain tag group automatically via registry:
+ *
+ * ```js
+ * BlockRegistry.registerDropFunctionForID(BlockID.tin_ore, function(coords, id, data, level, enchant, item, region) {
+ * if (level >= 2) {
+ * // Check item for "smelting" tag, which can be set to obtain smelted result
+ * if (TagRegistry.getTagsFor("enchant", item).contains("smelting")) {
+ * ToolAPI.dropOreExp(coords, 2, 2, enchant.experience, blockSource);
+ * return [[ItemID.tin_ingot, 1, 0]];
+ * } else {
+ * // Do default logic otherwise (if no tag has been set)
+ * return [[BlockID.tin_ore, 1, 0]]
+ * }
+ * }
+ * return [];
+ * }, 2);
+ *
+ * // Register tag factory, which are called to obtain tags every iteration
+ * TagRegistry.addTagFactory("enchant", function(object, tags) {
+ * // In case if our object is item-like and equals smelting tool
+ * if (object && object.id == ItemID.smelting_multitool) {
+ * // Smelt our BlockID.tin_ore and a few vanilla ones
+ * tags.add("smelting");
+ * }
+ * });
+ * ```
+ */
+declare namespace TagRegistry {
+ interface TagGroup {
+ readonly name: string;
+ /**
+ * Tag factory determines additional tags, which should
+ * be added for specific object in group.
+ */
+ addTagFactory(factory: TagFactory): void;
+ /**
+ * Appends object to group to use in iterator and
+ * filtering functions like {@link TagGroup.getAllWhere}, etc.
+ * @param tags primary tags to be added for object
+ */
+ addCommonObject(obj: T, ...tags: string[]): void;
+ /**
+ * Removes object from group, so it no longer can
+ * be fetched via {@link TagGroup.getAllWhere}, etc.
+ */
+ removeCommonObject(obj: T): void;
+ /**
+ * Appends primary tags for object; regardless of whether
+ * object is in group or not, tags will be added.
+ * @param tags primary tags to be added for object
+ */
+ addTagsFor(obj: T, ...tags: string[]): void;
+ /**
+ * Fetches object tags and appends it to a present
+ * collection in fixed order: primary tags added via
+ * {@link TagGroup.addTags}, serialized tags from object `_tags`
+ * property, tags added from {@link TagGroup.addTagFactory}.
+ * @param tags collection tor which tags applies
+ */
+ addTags(obj: T, tags: java.util.Collection): void;
+ /**
+ * Removes primary tags from object.
+ * @param tags primary tags to be removed from object
+ */
+ removeTagsFor(obj: T, ...tags: string[]): void;
+ /**
+ * Fetches object tags in fixed order: primary tags added via
+ * {@link TagGroup.addTags}, serialized tags from object `_tags`
+ * property, tags added from {@link TagGroup.addTagFactory}.
+ */
+ getTags(obj: T): java.util.HashSet;
+ /**
+ * Iterates over existing common objects added via
+ * {@link TagGroup.addCommonObject} and collects objects
+ * matched predicate to list.
+ */
+ getAllWhere(predicate: TagPredicate): java.util.List;
+ /**
+ * Fetches objects which have all of presented tags.
+ */
+ getAllWithTags(tags: java.util.Collection): java.util.List;
+ /**
+ * Fetches objects which has presented tag.
+ */
+ getAllWithTag(tag: string): java.util.List;
+ }
+
+ /**
+ * Gets or creates a new tag group to append tags
+ * for any objects.
+ */
+ function getOrCreateGroup(name: string): TagGroup;
+
+ /**
+ * Gets or creates a new tag group to append tags
+ * for any objects with generic type.
+ */
+ function getOrCreateGroup(name: string): TagGroup;
+
+ interface TagFactory {
+ /**
+ * @param obj object from group
+ * @param tags changeable tags collection
+ */
+ (obj: T, tags: java.util.Collection