sapdon 3.3.3 → 3.4.0

package/prod/core/index.d.ts

@@ -248,7 +248,7 @@ declare class AddonAttachable {
     format_version: string;
     definitions: AddonAttachableDefinition;
     constructor(format_version: string, definitions: AddonAttachableDefinition);
-    toObject(): Record<string, any>;
+    toObject(): Record<string, unknown>;
 }
 declare class AddonAttachableDefinition {
     description: AddonAttachableDescription;
@@ -262,8 +262,8 @@ declare class AddonAttachableDescription {
     animations?: Record<string, string>;
     animation_controllers?: Record<string, string>[];
     render_controllers?: string[];
-    locators?: Record<string, any>;
-    scripts?: Record<string, any>;
+    locators?: Record<string, unknown>;
+    scripts?: Record<string, unknown>;
     constructor(identifier: string);
     addMaterial(name: string, material: string): this;
     addTexture(name: string, texture: string): this;
@@ -271,25 +271,25 @@ declare class AddonAttachableDescription {
     addAnimation(name: string, animation: string): this;
     addAnimationController(name: string, controller: string): this;
     addRenderController(controller: string): this;
-    addLocator(name: string, locator: any): this;
-    setScript(key: string, value: string): this;
+    addLocator(name: string, locator: unknown): this;
+    setScript(key: string, value: unknown): this;
 }
 
 declare class AddonItem {
     format_version: string;
     definitions: AddonItemDefinition;
     constructor(format_version: string, definitions: AddonItemDefinition);
-    toObject(): Record<string, any>;
+    toObject(): Record<string, unknown>;
 }
 declare class AddonItemDefinition {
     description: AddonItemDescription;
-    components: Record<string, any>;
-    constructor(description: AddonItemDescription, components: Record<string, any>);
+    components: Record<string, unknown>;
+    constructor(description: AddonItemDescription, components: Record<string, unknown>);
 }
 declare class AddonItemDescription {
     identifier: string;
-    menu_category: any;
-    constructor(identifier: string, menu_category: any);
+    menu_category: AddonMenuCategory;
+    constructor(identifier: string, menu_category: AddonMenuCategory);
 }
 
 declare class AddonRecipe {
@@ -455,9 +455,9 @@ declare class BasicBlock {
     /**
      * 添加方块变体
      * @param {string} condition 变体条件
-     * @param {Map} componentMap 组件 Map
+     * @param {Map|Object} component 组件 Map 或普通对象
      */
-    addPermutation(condition: string, componentMap: Map<any, any>): this;
+    addPermutation(condition: string, component: Map<any, any> | Object): this;
     /**
      * 将方块对象转换为 JSON 格式
      * @returns {Object} JSON 格式的方块对象
@@ -497,38 +497,37 @@ declare class Block extends BasicBlock {
     #private;
 }
 
-declare class BlockComponent {
+/** @template T */
+declare class BlockComponent<T> {
     /**
-     *
-     * @param {string} texture
-     * @param {string?} tint_method
-     * @returns
+     * @param {string} texture - 纹理短名
+     * @param {Object|string} [options] - 可选参数对象，或旧版 tint_method 字符串
+     * @param {number} [options.particle_count] - 粒子数量 (0-255，默认 100)
+     * @param {string} [options.tint_method] - 染色方法（如 "grass"）
+     * @returns {Map<string, any>}
      */
-    static setDestructionParticles(texture: string, tint_method: string | null): Map<string, {
-        texture: string;
-        tint_method: string | null;
-    }>;
+    static setDestructionParticles(texture: string, options?: Object | string): Map<string, any>;
     /**
      * 自定义方块组件
      * [warning] 需要 Scripting V2.0.0
      * @param {string} component_id 组件标识符
      * @param {object} params 自定义参数接口对象
-     * @returns {Map} 物品组件Map
+     * @returns {Map<string, any>} 物品组件Map
      */
-    static setCustomComponentV2(component_id: string, params: object): Map<any, any>;
+    static setCustomComponentV2(component_id: string, params: object): Map<string, any>;
     /**
      *
      * @param {Array} interval_range
      * @param {boolean} looping
-     * @returns
-     */
-    static setTick(interval_range: any[], looping: boolean): Map<any, any>;
+      * @returns {Map<string, any>}
+      */
+    static setTick(interval_range: any[], looping: boolean): Map<string, any>;
     /**
      *
-     * @param {Array} custom_components
-     * @returns
-     */
-    static setCustomComponents(custom_components: any[]): Map<any, any>;
+      * @param {Array} custom_components
+      * @returns {Map<string, any>}
+      */
+    static setCustomComponents(custom_components: any[]): Map<string, any>;
     /**
    * 创建一个用于 Minecraft 方块的变换对象，并返回一个 Map。
    * @param {number[]} [translation=[0, 0, 0]] - 平移向量 [x, y, z]。
@@ -536,177 +535,299 @@ declare class BlockComponent {
    * @param {number[]} [scale_pivot=[0, 0, 0]] - 缩放的枢轴点 [x, y, z]。
    * @param {number[]} [rotation=[0, 0, 0]] - 旋转向量（角度）[x, y, z]。
    * @param {number[]} [rotation_pivot=[0, 0, 0]] - 旋转的枢轴点 [x, y, z]。
-   * @returns {Map} - 一个包含变换数据的 Map 对象。
+   * @returns {Map<string, any>} - 一个包含变换数据的 Map 对象。
    * @throws {Error} - 如果任何参数无效，则抛出错误。
    */
-    static setTransformation(translation?: number[], scale?: number[], scale_pivot?: number[], rotation?: number[], rotation_pivot?: number[]): Map<any, any>;
+    static setTransformation(translation?: number[], scale?: number[], scale_pivot?: number[], rotation?: number[], rotation_pivot?: number[]): Map<string, any>;
     /**
      * 设置方块的呼吸行为。
      * @param {String} value - 呼吸行为，可选值为 "solid" 或 "air"。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setBreathability(value: string): Map<any, any>;
+    static setBreathability(value: string): Map<string, any>;
     /**
      * 启用或禁用方块的碰撞箱。
      * @param {Boolean} enabled - 是否启用碰撞箱。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setCollisionBoxEnabled(enabled: boolean): Map<any, any>;
+    static setCollisionBoxEnabled(enabled: boolean): Map<string, any>;
     /**
      * 设置自定义的碰撞箱。
      * @param {Array} origin - 碰撞箱的起点坐标 [x, y, z]。
      * @param {Array} size - 碰撞箱的大小 [width, height, depth]。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setCollisionBoxCustom(origin: any[], size: any[]): Map<any, any>;
+    static setCollisionBoxCustom(origin: any[], size: any[]): Map<string, any>;
     /**
      * 设置方块的合成台属性。
      * @param {Array} craftingTags - 合成标签。
      * @param {String} tableName - 合成台名称。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setCraftingTable(craftingTags: any[], tableName: string): Map<any, any>;
+    static setCraftingTable(craftingTags: any[], tableName: string): Map<string, any>;
     /**
      * 启用或禁用方块的爆炸抗性。
      * @param {Boolean} enabled - 是否启用爆炸抗性。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setDestructibleByExplosionEnabled(enabled: boolean): Map<any, any>;
+    static setDestructibleByExplosionEnabled(enabled: boolean): Map<string, any>;
     /**
      * 设置自定义的爆炸抗性。
      * @param {Number} explosionResistance - 爆炸抗性值。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setDestructibleByExplosionCustom(explosionResistance: number): Map<any, any>;
+    static setDestructibleByExplosionCustom(explosionResistance: number): Map<string, any>;
     /**
      * 启用或禁用方块的挖掘抗性。
      * @param {Boolean} enabled - 是否启用挖掘抗性。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setDestructibleByMiningEnabled(enabled: boolean): Map<any, any>;
+    static setDestructibleByMiningEnabled(enabled: boolean): Map<string, any>;
     /**
      * 设置自定义的挖掘抗性。
      * @param {Number} secondsToDestroy - 破坏所需时间（秒）。
      * @param {Array} itemSpecificSpeeds - 特定工具的挖掘速度。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setDestructibleByMiningCustom(secondsToDestroy: number, itemSpecificSpeeds: any[]): Map<any, any>;
+    static setDestructibleByMiningCustom(secondsToDestroy: number, itemSpecificSpeeds: any[]): Map<string, any>;
     /**
      * 设置方块的显示名称。
      * @param {String} displayName - 显示名称。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setDisplayName(displayName: string): Map<any, any>;
+    static setDisplayName(displayName: string): Map<string, any>;
     /**
      * 启用或禁用方块的易燃性。
      * @param {Boolean} enabled - 是否启用易燃性。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setFlammableEnabled(enabled: boolean): Map<any, any>;
+    static setFlammableEnabled(enabled: boolean): Map<string, any>;
     /**
      * 设置自定义的易燃性。
      * @param {Number} catchChanceModifier - 着火概率。
      * @param {Number} destroyChanceModifier - 被火焰摧毁的概率。
-     * @returns {Map} - 新的组件集合。
+     * @param {String} [lava_flammable] - 岩浆能否点燃该方块 ("always"|"never"，默认 "never")
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setFlammableCustom(catchChanceModifier: number, destroyChanceModifier: number): Map<any, any>;
+    static setFlammableCustom(catchChanceModifier: number, destroyChanceModifier: number, lava_flammable?: string): Map<string, any>;
     /**
      * 设置方块的摩擦力。
      * @param {Number} value - 摩擦力值，范围为 0.0 到 0.9。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setFriction(value: number): Map<any, any>;
+    static setFriction(value: number): Map<string, any>;
     /**
      * 设置方块的几何模型。
      * @param {String} identifier - 几何模型标识符。
-     * @param {Object} bone_visibility - 骨骼可见性配置。
-     * @returns {Map} - 新的组件集合。
-     */
-    static setGeometry(identifier: string, bone_visibility: Object): Map<any, any>;
+     * @param {Object} [options] - 可选参数。
+     * @param {Object} [options.bone_visibility] - 骨骼可见性配置。
+     * @param {String} [options.culling] - 裁剪规则标识符（格式: <namespace>:culling.<name>）。
+     * @param {String} [options.culling_layer] - 裁剪层标识符（如 "minecraft:culling_layer.leaves"）。
+     * @param {String} [options.culling_shape] - 体素形状（仅支持 "minecraft:unit_cube"）。
+     * @param {Boolean|String[]} [options.uv_lock] - 是否锁定 UV 旋转，或指定骨骼名称数组。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setGeometry(identifier: string, options?: {
+        bone_visibility?: Object | undefined;
+        culling?: string | undefined;
+        culling_layer?: string | undefined;
+        culling_shape?: string | undefined;
+        uv_lock?: boolean | string[] | undefined;
+    }): Map<string, any>;
     /**
      * 设置方块的骨骼可见性。
      * @param {Object} bone_visibility - 骨骼可见性配置。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setBoneVisibility(bone_visibility: Object): Map<any, any>;
+    static setBoneVisibility(bone_visibility: Object): Map<string, any>;
     /**
      * 设置方块的物品视觉属性。
      * @param {String} geometry - 几何模型标识符。
      * @param {Object} materialInstances - 材质实例配置。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setItemVisual(geometry: string, materialInstances: Object): Map<any, any>;
+    static setItemVisual(geometry: string, materialInstances: Object): Map<string, any>;
     /**
      * 设置方块的光衰减值。
      * @param {Number} value - 光的衰减值，范围为 0 到 15。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setLightDampening(value: number): Map<any, any>;
+    static setLightDampening(value: number): Map<string, any>;
     /**
      * 设置方块的光照强度。
      * @param {Number} value - 光照强度，范围为 0 到 15。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setLightEmission(value: number): Map<any, any>;
+    static setLightEmission(value: number): Map<string, any>;
     /**
      * 设置方块的液体检测属性。
-     * @param {Boolean} canContainLiquid - 是否可以包含液体。
-     * @param {String} liquidType - 液体类型。
-     * @param {String} onLiquidTouches - 对液体的反应方式。
-     * @param {Array} stopsLiquidFlowingFromDirection - 阻止液体流动的方向。
-     * @returns {Map} - 新的组件集合。
+     * @param {Boolean|Object} canContainLiquid - 是否可容纳液体，或是完整选项对象
+     * @param {String} [liquidType] - 液体类型
+     * @param {String} [onLiquidTouches] - 对液体的反应方式
+     * @param {Array} [stopsLiquidFlowingFromDirection] - 阻止液体流动的方向
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setLiquidDetection(canContainLiquid: boolean, liquidType: string, onLiquidTouches: string, stopsLiquidFlowingFromDirection: any[]): Map<any, any>;
+    static setLiquidDetection(canContainLiquid: boolean | Object, liquidType?: string, onLiquidTouches?: string, stopsLiquidFlowingFromDirection?: any[]): Map<string, any>;
     /**
      * 设置方块的战利品表路径。
      * @param {String} path - 战利品表路径。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setLoot(path: string): Map<any, any>;
+    static setLoot(path: string): Map<string, any>;
     /**
      * 设置方块的地图颜色。
-     * @param {String|Array} value - 地图颜色，可以是十六进制字符串或 RGB 数组。
-     * @returns {Map} - 新的组件集合。
+     * @param {String|Array|Object} value - 地图颜色，可以是十六进制字符串、RGB 数组或对象格式。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setMapColor(value: string | any[]): Map<any, any>;
+    static setMapColor(value: string | any[] | Object): Map<string, any>;
     /**
      * 设置方块的材质实例。
      * @param {Object} instances - 材质实例配置。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setMaterialInstances(instances: Object): Map<any, any>;
+    static setMaterialInstances(instances: Object): Map<string, any>;
     /**
      * 设置方块的放置过滤条件。
      * @param {Array} conditions - 放置条件列表。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setPlacementFilter(conditions: any[]): Map<any, any>;
+    static setPlacementFilter(conditions: any[]): Map<string, any>;
     /**
      * 设置方块的红石导电性。
      * @param {Boolean} allowsWireToStepDown - 是否允许红石线向下阶梯连接。
      * @param {Boolean} redstoneConductor - 方块是否可以被红石信号激活。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setRedstoneConductivity(allowsWireToStepDown: boolean, redstoneConductor: boolean): Map<any, any>;
+    static setRedstoneConductivity(allowsWireToStepDown: boolean, redstoneConductor: boolean): Map<string, any>;
     /**
      * 启用或禁用方块的选择框。
      * @param {Boolean} enabled - 是否启用选择框。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setSelectionBoxEnabled(enabled: boolean): Map<any, any>;
+    static setSelectionBoxEnabled(enabled: boolean): Map<string, any>;
     /**
      * 设置自定义的选择框。
      * @param {Array} origin - 选择框的起点坐标 [x, y, z]。
      * @param {Array} size - 选择框的大小 [width, height, depth]。
-     * @returns {Map} - 新的组件集合。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setSelectionBoxCustom(origin: any[], size: any[]): Map<string, any>;
+    /**
+     * 设置方块实体（Block Entity，实验性功能，需开启 Upcoming Creator Features）。
+     * @param {Boolean} [dynamic_properties=false] - 是否启用动态属性存储。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setBlockEntity(dynamic_properties?: boolean): Map<string, any>;
+    /**
+     * 设置方块的活塞移动行为。
+     * @param {String} movement_type - 移动类型: "immovable" | "popped" | "push" | "push_pull"。
+     * @param {String} [sticky] - 黏性行为: "same" 可复制黏液块/蜂蜜块功能。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setMovable(movement_type: string, sticky?: string): Map<string, any>;
+    /**
+     * 设置方块的监听红石信号行为（配合自定义组件 onRedstoneUpdate 使用）。
+     * @param {Number} min_power - 最小触发红石信号强度 (0-15)。
+     * @param {Boolean} [propagates_power] - 是否传导红石信号。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setRedstoneConsumer(min_power: number, propagates_power?: boolean): Map<string, any>;
+    /**
+     * 设置方块产生红石信号。
+     * @param {Number} power - 信号强度 (0-15)。
+     * @param {String} strongly_powered_face - 强充能方向: "up" | "down" | "north" | "south" | "east" | "west"。
+     * @param {String[]} [connected_faces] - 连接的方向数组。
+     * @param {Boolean} [transform_relative] - 面方向是否相对于变换组件的旋转。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setRedstoneProducer(power: number, strongly_powered_face: string, connected_faces?: string[], transform_relative?: boolean): Map<string, any>;
+    /**
+     * 设置方块可被替换（放置其他方块时替换此方块）。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setReplaceable(): Map<string, any>;
+    /**
+     * 设置方块的支撑形状。
+     * @param {String} shape - 支撑形状: "fence" | "stair"。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setSupport(shape: string): Map<string, any>;
+    /**
+     * 设置方块标签。
+     * @param {String[]} tags - 标签数组。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setTags(tags: string[]): Map<string, any>;
+    /**
+     * 设置方块可被拴绳拴住（类似栅栏）。
+     * @param {Number[]} [offset=[0, 12, 0]] - 拴绳结位置偏移 [x, y, z]。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setLeashable(offset?: number[]): Map<string, any>;
+    /**
+     * 设置方块对实体坠落事件的触发。
+     * @param {Number} min_fall_distance - 最小坠落距离（方块数）。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setEntityFallOn(min_fall_distance: number): Map<string, any>;
+    /**
+     * 设置方块可放入花盆（配合 setEmbeddedVisual 使用）。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setFlowerPottable(): Map<string, any>;
+    /**
+     * 设置方块与降水（雨/雪）的交互行为。
+     * @param {String} behavior - 降水行为: "obstruct_rain_accumulate_snow" | "obstruct_rain" | "snowlogging" | "none"。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setPrecipitationInteractions(behavior: string): Map<string, any>;
+    /**
+     * 设置方块的随机偏移（碰撞箱/选择框/几何）。
+     * @param {Object} axis_config - 每个轴的偏移配置。
+     * @param {Object} [axis_config.x] - X 轴配置。
+     * @param {Object} [axis_config.y] - Y 轴配置。
+     * @param {Object} [axis_config.z] - Z 轴配置。
+     * @param {Object} axis_config.x.range - 范围 {min, max}。
+     * @param {Number} [axis_config.x.steps=0] - 步数（0=任意值）。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setRandomOffset(axis_config: {
+        x?: Object | undefined;
+        y?: Object | undefined;
+        z?: Object | undefined;
+    }): Map<string, any>;
+    /**
+     * 设置方块对箱子开启的遮挡行为。
+     * @param {String} rule - 遮挡规则: "always" | "never" | "shape"。
+     * @returns {Map<string, any>} - 新的组件集合。
      */
-    static setSelectionBoxCustom(origin: any[], size: any[]): Map<any, any>;
+    static setChestObstruction(rule: string): Map<string, any>;
+    /**
+     * 设置方块在花盆中的显示外观。
+     * @param {String|Object} geometry - 几何标识符或几何对象。
+     * @param {Object} material_instances - 材质实例。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setEmbeddedVisual(geometry: string | Object, material_instances: Object): Map<string, any>;
+    /**
+     * 设置方块与栅栏/墙等方块的连接规则。
+     * @param {String} [accepts_from="all"] - 连接来源: "all" | "only_fences" | "none"。
+     * @param {String[]} [enabled_directions] - 允许连接的方向数组。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setConnectionRule(accepts_from?: string, enabled_directions?: string[]): Map<string, any>;
+    /**
+     * 设置方块的声音。
+     * @param {String} sound - 声音名称。
+     * @returns {Map<string, any>} - 新的组件集合。
+     */
+    static setSound(sound: string): Map<string, any>;
     /**
      * 将多个组件集合合并为一个。
      * @param {...Map} componentMaps - 多个组件集合。
-     * @returns {Map} - 合并后的组件集合。
+     * @returns {Map<string, any>} - 合并后的组件集合。
      */
-    static combineComponents(...componentMaps: Map<any, any>[]): Map<any, any>;
+    static combineComponents(...componentMaps: Map<any, any>[]): Map<string, any>;
     /**
      * 获取当前组件的 JSON 表示。
      * @param {Map} components - 组件集合。
@@ -715,6 +836,144 @@ declare class BlockComponent {
     static toJSON(components: Map<any, any>): Object;
 }
 
+interface BeforeOnPlayerPlaceEvent {
+    block: any;
+    cancel: boolean;
+    dimension: any;
+    face: string;
+    permutationToPlace: any;
+    player?: any;
+}
+interface OnBlockStateChangeEvent {
+    block: any;
+    dimension: any;
+    previousPermutation: any;
+}
+interface OnBreakEvent {
+    block: any;
+    dimension: any;
+    blockDestructionSource?: any;
+    brokenBlockPermutation: any;
+    entitySource?: any;
+}
+interface OnEntityEvent {
+    block: any;
+    blockPermutation: any;
+    dimension: any;
+    entitySource: any;
+    name: string;
+}
+interface OnEntityFallOnEvent {
+    block: any;
+    dimension: any;
+    entity?: any;
+    fallDistance: number;
+}
+interface OnPlaceEvent {
+    block: any;
+    dimension: any;
+    previousBlock: any;
+}
+interface OnPlayerBreakEvent {
+    block: any;
+    brokenBlockPermutation: any;
+    dimension: any;
+    player?: any;
+}
+interface OnPlayerInteractEvent {
+    block: any;
+    dimension: any;
+    face: string;
+    faceLocation: any;
+    player?: any;
+}
+interface OnRandomTickEvent {
+    block: any;
+    dimension: any;
+}
+interface OnRedstoneUpdateEvent {
+    block: any;
+    dimension: any;
+    power: number;
+}
+interface OnStepOffEvent {
+    block: any;
+    dimension: any;
+    entity?: any;
+}
+interface OnStepOnEvent {
+    block: any;
+    dimension: any;
+    entity?: any;
+}
+interface OnTickEvent {
+    block: any;
+    dimension: any;
+}
+interface BlockCustomComponentHandlers {
+    beforeOnPlayerPlace?: (event: BeforeOnPlayerPlaceEvent) => void;
+    onBlockStateChange?: (event: OnBlockStateChangeEvent) => void;
+    onBreak?: (event: OnBreakEvent) => void;
+    onEntity?: (event: OnEntityEvent) => void;
+    onEntityFallOn?: (event: OnEntityFallOnEvent) => void;
+    onPlace?: (event: OnPlaceEvent) => void;
+    onPlayerBreak?: (event: OnPlayerBreakEvent) => void;
+    onPlayerInteract?: (event: OnPlayerInteractEvent) => void;
+    onRandomTick?: (event: OnRandomTickEvent) => void;
+    onRedstoneUpdate?: (event: OnRedstoneUpdateEvent) => void;
+    onStepOff?: (event: OnStepOffEvent) => void;
+    onStepOn?: (event: OnStepOnEvent) => void;
+    onTick?: (event: OnTickEvent) => void;
+}
+/**
+ * 块自定义组件构建器 - 提供流式 API 定义块事件处理器，
+ * 并提供类型安全的事件参数绑定。
+ *
+ * @example
+ * ```ts
+ * const comp = new BlockCustomComponentBuilder('wiki:my_comp')
+ *   .onTick()                        // 只声明事件类型，生成骨架代码
+ *   .onPlayerInteract(({ player }) => { ... })  // 带完整 handler
+ *
+ * // 在 block JSON 中注册组件 ID
+ * block.addComponent(BlockComponent.setCustomComponents([comp.id()]))
+ * ```
+ */
+declare class BlockCustomComponentBuilder {
+    private static allInstances;
+    private componentId;
+    private handlers;
+    private declaredEvents;
+    constructor(componentId: string);
+    /** 返回所有已创建的构建器实例 */
+    static getAllInstances(): BlockCustomComponentBuilder[];
+    /** 重置实例列表（用于测试/热重载） */
+    static resetInstances(): void;
+    /** 返回组件标识符，用于 setCustomComponents */
+    id(): string;
+    /** 返回已声明（含 handler）的事件名称列表 */
+    declaredEventNames(): string[];
+    /** 返回已注册的事件处理器数量 */
+    handlerCount(): number;
+    beforeOnPlayerPlace(handler?: (event: BeforeOnPlayerPlaceEvent) => void): this;
+    onBlockStateChange(handler?: (event: OnBlockStateChangeEvent) => void): this;
+    onBreak(handler?: (event: OnBreakEvent) => void): this;
+    onEntity(handler?: (event: OnEntityEvent) => void): this;
+    onEntityFallOn(handler?: (event: OnEntityFallOnEvent) => void): this;
+    onPlace(handler?: (event: OnPlaceEvent) => void): this;
+    onPlayerBreak(handler?: (event: OnPlayerBreakEvent) => void): this;
+    onPlayerInteract(handler?: (event: OnPlayerInteractEvent) => void): this;
+    onRandomTick(handler?: (event: OnRandomTickEvent) => void): this;
+    onRedstoneUpdate(handler?: (event: OnRedstoneUpdateEvent) => void): this;
+    onStepOff(handler?: (event: OnStepOffEvent) => void): this;
+    onStepOn(handler?: (event: OnStepOnEvent) => void): this;
+    onTick(handler?: (event: OnTickEvent) => void): this;
+    /** 构建处理器对象，可用于 runtime 的 registerCustomComponent */
+    build(): BlockCustomComponentHandlers;
+    /** 生成 runtime 脚本模块源码 */
+    generateRuntimeCode(): string;
+}
+
 declare class CropBlock extends Block {
     stageNum: number;
 }
@@ -855,9 +1114,8 @@ declare class FeatureRule {
     toObject(): any;
 }
 
-declare class OreBlock {
+declare class OreBlock extends BasicBlock {
     constructor(identifier: any, category: any, textures_arr: any, options?: {});
-    block: BasicBlock;
     feature: OreFeature;
     feature_rules: FeatureRule;
 }
@@ -878,7 +1136,7 @@ declare class RotatableBlock extends BasicBlock {
      * @param {string} options.group 分组，默认为 "construction"
      * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
      * @param {string} options.rotationType 旋转类型，默认为 "cardinal"
-     * @param {number} options.yRotationOffset 初始旋转偏移量，默认为 180
+     * @param {number} options.yRotationOffset 初始旋转偏移量，默认为 0
      */
     constructor(identifier: string, category: string, textures_arr: any[], options?: {
         group: string;
@@ -1060,6 +1318,71 @@ declare class TileBlock {
     setScript(key: any, value: any): void;
 }
 
+declare class GlassBlock extends BasicBlock {
+    constructor(identifier: any, category: any, texture: any, options?: {});
+}
+
+declare class HeadBlock extends BasicBlock {
+    constructor(identifier: any, category: any, texture: any, options?: {});
+    #private;
+}
+
+declare class FenceBlock extends BasicBlock {
+    constructor(identifier: any, category: any, textures_arr: any, options?: {});
+}
+
+declare class StairBlock extends BasicBlock {
+    constructor(identifier: any, category: any, textures_arr: any, options?: {});
+    #private;
+}
+
+declare class TrapdoorBlock extends BasicBlock {
+    constructor(identifier: any, category: any, texture: any, options?: {});
+    #private;
+}
+
+declare const TintMethod: {
+    readonly GRASS: "grass";
+    readonly WATER: "water";
+    readonly DEFAULT_FOLIAGE: "default_foliage";
+    readonly EVERGREEN_FOLIAGE: "evergreen_foliage";
+    readonly DRY_FOLIAGE: "dry_foliage";
+    readonly BIRCH_FOLIAGE: "birch_foliage";
+};
+type TintMethod = (typeof TintMethod)[keyof typeof TintMethod];
+
+interface FlipbookEntry {
+    flipbook_texture: string;
+    atlas_tile?: string;
+    ticks_per_frame?: number;
+    blend_frames?: boolean;
+    replicate?: number;
+}
+declare class FlipbookTextureConfig {
+    private entries;
+    addEntry(entry: FlipbookEntry): this;
+    addEntries(entries: FlipbookEntry[]): this;
+    toObject(): {
+        flipbook_textures: FlipbookEntry[];
+    };
+}
+
+interface TextureVariation {
+    path: string;
+    weight?: number;
+}
+interface TextureEntry {
+    textures: string | TextureVariation[];
+}
+declare class TextureVariationConfig {
+    private textureData;
+    addTexture(name: string, path: string): this;
+    addTextureWithVariations(name: string, variations: TextureVariation[]): this;
+    toObject(): {
+        texture_data: Record<string, TextureEntry>;
+    };
+}
+
 declare class DummyEntity extends Entity {
     constructor(identifier: any, texture: any, options: {} | undefined, behData: any, resData: any);
 }
@@ -1306,6 +1629,62 @@ declare class PickupItemsBehavior {
     toObject(): Map<string, object>;
 }
 
+declare class MoveTowardsHomeRestrictionBehavior {
+    /**
+     * 创建 minecraft:behavior.move_towards_home_restriction 组件。
+     * @param {number} priority 行为的优先级
+     */
+    constructor(priority: number);
+    priority: number;
+    speed_multiplier: number;
+    /**
+     * 设置移动速度倍数。
+     * @param {number} speedMultiplier 移动速度倍数
+     * @returns {MoveTowardsHomeRestrictionBehavior} 返回当前实例以支持链式调用
+     */
+    setSpeedMultiplier(speedMultiplier: number): MoveTowardsHomeRestrictionBehavior;
+    /**
+     * 将组件转换为 JSON 对象。
+     * @returns {Object} minecraft:behavior.move_towards_home_restriction 组件的 JSON 对象
+     */
+    toObject(): Object;
+}
+
+declare class GoHomeBehavior {
+    /**
+     * 创建 minecraft:behavior.go_home 组件。
+     * @param {number} priority 行为的优先级
+     */
+    constructor(priority: number);
+    priority: number;
+    speed_multiplier: number;
+    goal_radius: number;
+    interval: number;
+    /**
+     * 设置移动速度倍数。
+     * @param {number} speedMultiplier 移动速度倍数
+     * @returns {GoHomeBehavior} 返回当前实例以支持链式调用
+     */
+    setSpeedMultiplier(speedMultiplier: number): GoHomeBehavior;
+    /**
+     * 设置回家目标判定半径。
+     * @param {number} goalRadius 判定半径（方块格）
+     * @returns {GoHomeBehavior} 返回当前实例以支持链式调用
+     */
+    setGoalRadius(goalRadius: number): GoHomeBehavior;
+    /**
+     * 设置回家行为执行的间隔时间（游戏刻）。
+     * @param {number} interval 间隔时间（游戏刻）
+     * @returns {GoHomeBehavior} 返回当前实例以支持链式调用
+     */
+    setInterval(interval: number): GoHomeBehavior;
+    /**
+     * 将组件转换为 JSON 对象。
+     * @returns {Object} minecraft:behavior.go_home 组件的 JSON 对象
+     */
+    toObject(): Object;
+}
+
 declare class BasicBundle {
     /**
      * 添加组件到捆绑包
@@ -1807,6 +2186,53 @@ declare class EntityComponent {
         uncertaintyBase: number;
         uncertaintyMultiplier: number;
     }): Map<any, any>;
+    /**
+     * 设置实体的家（工作站点）组件，用于限制实体的活动范围。
+     * @param {Object} [options] - 配置选项
+     * @param {number} [options.restriction_radius=16] - 限制半径（方块格）
+     * @param {string[]} [options.home_block_list=["minecraft:chest"]] - 可绑定为家的方块列表
+     * @param {string} [options.restriction_type] - 限制类型（可选，如 "limited"），需 format_version >= 1.21.40
+     * @returns {Map} 返回 Minecraft home 组件
+     *
+     * @example // 基础用法 - 16格半径，箱子作为家
+     * const home = EntityComponent.setHome();
+     *
+     * @example // 自定义配置
+     * const customHome = EntityComponent.setHome({
+     *   restriction_radius: 32,
+     *   home_block_list: ["minecraft:chest", "minecraft:barrel"],
+     *   restriction_type: "limited"
+     * });
+     */
+    static setHome({ restriction_radius, home_block_list, restriction_type }?: {
+        restriction_radius?: number | undefined;
+        home_block_list?: string[] | undefined;
+        restriction_type?: string | undefined;
+    }): Map<any, any>;
+    /**
+     * 设置可分享物品列表（该实体感兴趣并会主动拾取的物品）
+     * 与 minecraft:behavior.pickup_items 配合使用
+     * @param {Object} [options] - 配置选项
+     * @param {Array<Object>} [options.items=[]] - 物品条目列表
+     * @param {string} options.items[].item - 物品ID
+     * @param {number} [options.items[].want_amount] - 想要保留的数量
+     * @param {number} [options.items[].surplus_amount] - 溢出阈值（超出此数量可分享给玩家）
+     * @param {number} [options.items[].priority] - 优先级（数值越小优先级越高）
+     * @param {number} [options.items[].max_amount] - 最大持有数
+     * @param {number} [options.items[].pickup_limit] - 单次拾取数限制
+     * @param {boolean} [options.items[].pickup_only] - 是否只拾取不分享
+     * @param {boolean} [options.items[].stored_in_inventory] - 是否存入库存
+     * @param {boolean} [options.items[].consume_item] - 是否消耗物品
+     * @param {Object} [options.items[].admire] - 欣赏物品行为
+     * @param {Object} [options.items[].barter] - 以物易物配置
+     * @param {Object} [options.items[].craft_into] - 合成转换配置
+     * @param {boolean} [options.all_items=false] - 是否接受任意物品
+     * @param {boolean} [options.singular_pickup=false] - 是否一次只拾取一个
+     * @returns {Map} 返回 Minecraft shareables 组件
+     */
+    static setShareables({ items, all_items, singular_pickup }?: {
+        items?: Object[] | undefined;
+    }): Map<any, any>;
 }
 
 type BehaviorLiterals = 'beh' | 'behavior' | 'behaviour';
@@ -1866,13 +2292,18 @@ declare namespace BlockAPI {
     }): RotatableBlock;
     function createGeometryBlock(identifier: any, category: any, geometry: any, material_instances: any, options?: {}): GeometryBlock;
     function createOreBlock(identifier: any, category: any, textures_arr: any, options?: {}): OreBlock;
-    function createCropBlock(identifier: string, category: string, variantDatas: any[], options?: {
+    function createHeadBlock(identifier: string, category: string, texture: any, options?: {
         group: string;
         hide_in_command: boolean;
         ambient_occlusion: boolean;
         face_dimming: boolean;
         render_method: string;
     }): CropBlock;
+    function createGlassBlock(identifier: any, category: any, texture: any, options?: {}): GlassBlock;
+    function createFenceBlock(identifier: any, category: any, textures_arr: any, options?: {}): FenceBlock;
+    function createStairBlock(identifier: any, category: any, textures_arr: any, options?: {}): StairBlock;
+    function createTrapdoorBlock(identifier: any, category: any, texture: any, options?: {}): TrapdoorBlock;
+    function createCropBlock(identifier: any, category: any, variantDatas: any, options?: {}): CropBlock;
 }
 
 declare function registerEntity(behData: any, resData: any): void;
@@ -1900,6 +2331,10 @@ declare namespace FeatureAPI {
     function createFeatureRules(identifier: any, places_feature: any): FeatureRule;
 }
 
+/**
+ * 物品菜单栏分类枚举
+ * 用于 Item / Food / FlipbookItem 及 ItemAPI 的 category 参数
+ */
 declare enum ItemCategory {
     Commands = "commands",
     Construction = "construction",
@@ -1908,90 +2343,395 @@ declare enum ItemCategory {
     Items = "items",
     None = "none"
 }
-
-declare class Item {
+/**
+ * 物品组件 Map：以 Minecraft 组件名为 key
+ */
+type ItemComponentMap = Map<string, unknown>;
+/**
+ * 物品选项
+ * snake_case（对应 Minecraft JSON 字段）与 camelCase 互为别名，camelCase 优先
+ */
+interface ItemOptions {
+    group?: string;
+    hide_in_command?: boolean;
+    hideInCommand?: boolean;
+    max_stack_size?: number;
+    maxStackSize?: number;
+    format_version?: string;
+    formatVersion?: string;
     /**
-     * 物品类
-     * @param {string} identifier 物品唯一标识符
-     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
-     * @param {string} texture 物品纹理
-     * @param {Object?} options 可选参数
-     * @param {string|undefined} options.group 分组
-     * @param {boolean|undefined} options.hide_in_command 是否在命令中隐藏，默认为 false
+     * 图标纹理名称；传 null 表示不添加 minecraft:icon 组件
+     */
+    icon?: string | null;
+    displayName?: string;
+}
+/**
+ * 3D 手持物品骨骼变换（动画中的 position/rotation/scale）
+ */
+interface ModelBoneTransform {
+    position?: [number, number, number];
+    rotation?: [number, number, number];
+    scale?: number | [number, number, number];
+}
+/**
+ * 3D 手持物品选项（Method 2：model binding）
+ */
+interface CreateModelItemOptions extends ItemOptions {
+    /**
+     * 几何根骨骼名，内置动画将作用于该骨骼；必须与用户 geometry 中带
+     * binding（q.item_slot_to_bone_name）的骨骼名一致。默认 "rightitem"。
+     */
+    boneName?: string;
+    /**
+     * 默认材质。默认 "entity"（不透明，同官方示例）；
+     * 模型含透明像素时可用 "entity_alphatest"。
+     */
+    material?: string;
+    /**
+     * 覆盖内置第一人称握持姿态（默认参照官方示例）
      */
-    constructor(identifier: string, category: string, texture: string, options?: Object | null);
+    holdFirstPerson?: ModelBoneTransform;
+    /**
+     * 覆盖内置第三人称握持姿态（默认参照官方示例）
+     */
+    holdThirdPerson?: ModelBoneTransform;
+}
+/**
+ * 食物选项
+ */
+interface FoodOptions extends ItemOptions {
+    animation?: string;
+    movement?: number;
+    useDuration?: number;
+    canAlwaysEat?: boolean;
+    nutrition?: number;
+    saturationModifier?: number;
+    /**
+     * 是否为肉类（自动追加 minecraft:is_meat 标签）
+     */
+    isMeat?: boolean;
+    /**
+     * 是否为鱼类（自动追加 minecraft:is_fish 标签）
+     */
+    isFish?: boolean;
+    /**
+     * 是否为熟食（自动追加 minecraft:is_cooked 标签）
+     */
+    isCooked?: boolean;
+}
+/**
+ * 可投掷组件选项
+ */
+interface ThrowableOptions {
+    doSwingAnimation?: boolean;
+    launchPowerScale?: number;
+    maxDrawDuration?: number;
+    maxLaunchPower?: number;
+    minDrawDuration?: number;
+    scalePowerByDrawDuration?: boolean;
+}
+/**
+ * 食物组件选项
+ */
+interface FoodComponentOptions {
+    nutrition?: number;
+    saturationModifier?: number;
+    canAlwaysEat?: boolean;
+    usingConvertsTo?: string;
+}
+/**
+ * 方块描述符：字符串、带状态的名称对象或标签 Molang 查询对象
+ */
+type BlockDescriptor = string | {
+    name: string;
+    states?: Record<string, unknown>;
+} | {
+    tags: string;
+};
+/**
+ * 数值范围
+ */
+interface Range {
+    min: number;
+    max: number;
+}
+/**
+ * 物品稀有度
+ */
+type ItemRarity = 'common' | 'uncommon' | 'rare' | 'epic';
+/**
+ * 放置方块组件选项
+ */
+interface BlockPlacerOptions {
+    replaceBlockItem?: boolean;
+    alignedPlacement?: boolean;
+    useOn?: BlockDescriptor[];
+}
+/**
+ * 使用修饰组件选项
+ */
+interface UseModifiersOptions {
+    movementModifier?: number;
+    useDuration?: number;
+    emitVibrations?: boolean;
+    startSound?: string;
+    startUsing?: 'always' | 'if_first';
+}
+/**
+ * 图标纹理（对象格式）
+ */
+interface IconTextures {
+    default: string;
+    dyed?: string;
+    iconTrim?: string;
+    bundleOpenBack?: string;
+    bundleOpenFront?: string;
+}
+/**
+ * 冷却组件选项
+ */
+interface CooldownOptions {
+    category: string;
+    duration: number;
+    type?: 'use' | 'attack';
+}
+/**
+ * 挖掘组件选项
+ */
+interface DiggerOptions {
+    destroySpeeds: {
+        block: BlockDescriptor;
+        speed: number;
+    }[];
+    useEfficiency?: boolean;
+}
+/**
+ * 耐久传感器阈值
+ */
+interface DurabilityThreshold {
+    durability: number;
+    particleType?: string;
+    soundEvent?: string;
+}
+/**
+ * 耐久传感器组件选项
+ */
+interface DurabilitySensorOptions {
+    durabilityThresholds: DurabilityThreshold[];
+}
+/**
+ * 放置实体组件选项
+ */
+interface EntityPlacerOptions {
+    dispenseOn?: BlockDescriptor[];
+    useOn?: BlockDescriptor[];
+}
+/**
+ * 动能武器组件选项
+ */
+interface KineticWeaponOptions {
+    delay: number;
+    hitboxMargin?: number;
+    reach?: Range;
+    creativeReach?: Range;
+    damageMultiplier?: number;
+    damageModifier?: number;
+    damageConditions?: Record<string, unknown>;
+    dismountConditions?: Record<string, unknown>;
+    knockbackConditions?: Record<string, unknown>;
+}
+/**
+ * 穿刺武器组件选项
+ */
+interface PiercingWeaponOptions {
+    hitboxMargin?: number;
+    reach?: Range;
+    creativeReach?: Range;
+}
+/**
+ * 唱片组件选项
+ */
+interface RecordOptions {
+    comparatorSignal: number;
+    duration: number;
+    soundEvent: string;
+}
+/**
+ * 修复条目
+ */
+interface RepairItem {
+    items: (string | {
+        tags: string;
+    })[];
+    repairAmount?: number | string;
+}
+/**
+ * 射击组件弹药
+ */
+interface ShooterAmmunition {
+    item: string;
+    searchInventory?: boolean;
+    useInCreative?: boolean;
+    useOffhand?: boolean;
+}
+/**
+ * 射击组件选项
+ */
+interface ShooterOptions {
+    ammunition: ShooterAmmunition[];
+    chargeOnDraw?: boolean;
+    maxDrawDuration?: number;
+    scalePowerByDrawDuration?: boolean;
+}
+/**
+ * 容器物品组件选项
+ */
+interface StorageItemOptions {
+    maxSlots: number;
+    allowNestedStorageItems: boolean;
+    allowedItems?: string[];
+    bannedItems?: string[];
+}
+/**
+ * 挥砍音效组件选项
+ */
+interface SwingSoundsOptions {
+    attackMiss?: string;
+    attackHit?: string;
+    attackCriticalHit?: string;
+}
+
+declare class Attachable extends AddonAttachableDescription {
+    #private;
+    constructor(identifier: string, formatVersion?: string);
+    getId(): string;
+    toObject(): Record<string, any>;
+}
+
+declare class Item {
     identifier: string;
     category: string;
     texture: string;
-    group: any;
-    hide_in_command: any;
-    format_version: any;
-    components: Map<any, any>;
+    group?: string;
+    hide_in_command: boolean;
+    format_version: string;
+    components: ItemComponentMap;
+    attachable?: Attachable;
+    /**
+     * 物品类
+     * @param identifier 物品唯一标识符
+     * @param category 菜单栏分类，见 {@link ItemCategory}
+     * @param texture 物品纹理
+     * @param options 可选参数
+     */
+    constructor(identifier: string, category: ItemCategory, texture: string, options?: ItemOptions);
     /**
      * 添加组件
-     * @param {Map} componentMap 组件 Map
+     * @param componentMap 组件 Map
      */
-    addComponent(componentMap: Map<any, any>): this;
+    addComponent(componentMap: ItemComponentMap): this;
     /**
      * 移除组件
-     * @param {string} key 组件名称
+     * @param key 组件名称
      */
     removeComponent(key: string): this;
+    getAttachable(): Attachable | undefined;
     /**
      * 将物品转换为 JSON 格式
-     * @returns {Object} JSON 格式的物品对象
+     * @returns JSON 格式的物品对象
      */
-    toObject(): Object;
+    toObject(): Record<string, any>;
 }
 
-declare class Food extends Item {
+/**
+ * 盔甲类型枚举
+ */
+declare enum ArmorType {
+    Chestplate = "chestplate",
+    Helmet = "helmet",
+    Boots = "boots",
+    Leggings = "leggings"
+}
+/**
+ * 盔甲类型规格
+ * 参考 Bedrock Wiki "Custom Armor"：https://wiki.bedrock.dev/items/custom-armor
+ */
+interface ArmorSpec {
+    group: string;
+    geometry: string;
+    script: string;
+    protection: number;
+    slot: string;
+    enchantSlot: string;
+    maxDurability: number;
+    displayName: string;
+}
+/**
+ * 盔甲选项
+ * 参考 Bedrock Wiki "Custom Armor"：https://wiki.bedrock.dev/items/custom-armor
+ */
+interface ArmorOptions extends ItemOptions {
+    displayName?: string;
     /**
-     * 物品类
-     * @param {string} identifier 物品唯一标识符
-     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
-     * @param {string} texture 物品纹理
-     * @param {Object} options 可选参数
-     * @param {string} options.group 分组
-     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
-     * @param {string} options.animation 使用动画，默认为 "eat"
-     * @param {boolean} options.canAlwaysEat 是否总是可以食用，默认为 false
-     * @param {number} options.nutrition 营养价值，默认为 0
-     * @param {number} options.saturationModifier 饱和度修正值，默认为 1
+     * 附魔槽位与等级（参考 wiki 规范，默认 { slot: 按部位, value: 10 }）
      */
-    constructor(identifier: string, category: string, texture: string, options?: {
-        group: string;
-        hide_in_command: boolean;
-        animation: string;
-        canAlwaysEat: boolean;
-        nutrition: number;
-        saturationModifier: number;
-    });
-}
-
-declare class Attachable extends AddonAttachableDescription {
-    constructor(identifier: any);
-    getId(): string;
-    toObject(): any;
+    enchantable?: {
+        slot: string;
+        value?: number;
+    };
+    /**
+     * 最大耐久（参考 wiki 规范，默认按部位：头盔 363 / 胸甲 528 / 护腿 495 / 靴子 429）
+     */
+    maxDurability?: number;
+    /**
+     * 修复条目（参考 wiki 规范，默认木棍，每次恢复 25% 最大耐久）
+     */
+    repairItems?: RepairItem[];
+    /**
+     * 附加标签（参考 wiki 规范，默认 ["minecraft:is_armor", "minecraft:trimmable_armors"]）
+     */
+    tags?: string[];
+    /**
+     * 渲染控制器，默认 "controller.render.armor"（兼容旧版），可传 "controller.render.armor.v2"
+     */
+    renderController?: string;
 }
-
+/**
+ * 盔甲类
+ * 由 ArmorType 数据表驱动，同时生成物品（Item）与可附着物（Attachable）
+ */
 declare class Armor {
-    constructor(identifier: any, category: any, item_texture: any, texture_path: any, options?: {});
-    identifier: any;
+    type: ArmorType;
+    identifier: string;
     item: Item;
     attachable: Attachable;
-    setArrachableGeometry(key: any, geometry: any): this;
-}
-declare class Chestplate extends Armor {
-    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
-}
-declare class Boot extends Armor {
-    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
-}
-declare class Leggings extends Armor {
-    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
+    constructor(identifier: string, item_texture: string, texture_path: string, type?: ArmorType, options?: ArmorOptions);
+    /**
+     * 设置可附着物的几何模型
+     * @param key 几何模型名称
+     * @param geometry 几何模型标识符
+     * @returns 当前实例，支持链式调用
+     */
+    setAttachableGeometry(key: string, geometry: string): this;
+    /**
+     * 获取行为包与资源包的 JSON 表示
+     * @returns { behavior, resource } 两个包的注册内容
+     */
+    toObject(): {
+        behavior: Record<string, any>;
+        resource: Record<string, any>;
+    };
 }
-declare class Helmet extends Armor {
-    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
+
+declare class Food extends Item {
+    /**
+     * 食物类
+     * @param identifier 物品唯一标识符
+     * @param category 菜单栏分类，见 {@link ItemCategory}
+     * @param texture 物品纹理
+     * @param options 可选参数
+     */
+    constructor(identifier: string, category: ItemCategory, texture: string, options?: FoodOptions);
 }
 
 /**
@@ -2031,6 +2771,11 @@ interface FlipbookItemOptions {
      * @default "1.20.0" - 默认使用最新版本
      */
     format_version?: string;
+    /**
+     * 翻书纹理文件的完整路径（不含 .png 后缀）。
+     * @default `"textures/blocks/${texture}"` - 默认使用方块纹理目录
+     */
+    texture_path?: string;
 }
 /**
  * 翻书物品类
@@ -2056,31 +2801,163 @@ declare class FlipbookItem extends Item {
      * @param options.max_stack_size - 物品的最大堆叠数量
      * @param options.format_version - 格式版本号
      */
-    constructor(identifier: string, category: string, texture: string, options?: FlipbookItemOptions);
+    constructor(identifier: string, category: ItemCategory, texture: string, options?: FlipbookItemOptions);
 }
 
-declare namespace ItemAPI {
-    function createItem(identifier: string, category: string, texture: string, options?: {
-        group: string;
-        hight_resolution: boolean;
-        hide_in_command: boolean;
-    }): Item;
-    function createFood(identifier: string, category: string, texture: string, options?: {
-        group: string;
-        hide_in_command: boolean;
-        animation: string;
-        canAlwaysEat: boolean;
-        nutrition: number;
-        saturationModifier: number;
-    }): Food;
-    function createAttachable(identifier: string, texture: string, material: string, options?: Object): Attachable;
-    function createChestplateArmor(identifier: any, item_texture: any, texture_path: any, options?: {}): Chestplate;
-    function createHelmetArmor(identifier: any, item_texture: any, texture_path: any, options?: {}): Helmet;
-    function createBootArmor(identifier: any, item_texture: any, texture_path: any, options?: {}): Boot;
-    function createLeggingsArmor(identifier: any, item_texture: any, texture_path: any, options?: {}): Leggings;
-    function createFlipbookItem(identifier: string, category: string, texture: string, options?: Object | null): FlipbookItem;
+/**
+ * 物品目录分类
+ * 参考 Bedrock Wiki Item Catalog：仅支持 construction / equipment / items / nature 四类
+ */
+type ItemCatalogCategory = 'construction' | 'equipment' | 'items' | 'nature';
+/**
+ * 可展开分组配置
+ */
+interface ItemCatalogGroupOptions {
+    /**
+     * 分组图标使用的物品
+     */
+    icon?: string;
+    /**
+     * 分组的本地化键，如 "wiki:itemGroup.name.ore"；同时可用作物品/方块的 menu_category.group
+     */
+    name?: string;
+}
+/**
+ * 物品目录
+ * 生成 BP/item_catalog/crafting_item_catalog.json，
+ * 用于指定物品在创造菜单与配方手册中的分组位置。
+ */
+declare class ItemCatalog {
+    format_version: string;
+    private categories;
+    /**
+     * @param format_version 格式版本，默认 "1.26.30"
+     */
+    constructor(format_version?: string);
+    /**
+     * 添加一组物品到指定分类
+     * @param category 创造菜单分类（construction/equipment/items/nature）
+     * @param items 物品标识符列表
+     * @param options 可展开分组配置
+     * @returns 当前实例，支持链式调用
+     */
+    addGroup(category: ItemCatalogCategory, items: string[], options?: ItemCatalogGroupOptions): this;
+    /**
+     * 添加单个物品到指定分类
+     * @param category 创造菜单分类（construction/equipment/items/nature）
+     * @param item 物品标识符
+     * @param options 可展开分组配置
+     * @returns 当前实例，支持链式调用
+     */
+    addItem(category: ItemCatalogCategory, item: string, options?: ItemCatalogGroupOptions): this;
+    /**
+     * 注册到行为包的 item_catalog/ 目录
+     * @returns 当前实例
+     */
+    register(): this;
+    /**
+     * 将物品目录转换为 JSON 格式
+     * @returns JSON 格式的物品目录对象
+     */
+    toObject(): Record<string, any>;
 }
 
+declare const ItemAPI: {
+    /**
+     * 创建一个普通物品。
+     * @param identifier 物品的唯一标识符。
+     * @param category 物品在创造菜单中的分类，见 {@link ItemCategory}。
+     * @param texture 物品的纹理。
+     * @param options 额外选项。
+     * @returns 创建的物品。
+     */
+    createItem(identifier: string, category: ItemCategory, texture: string, options?: ItemOptions): Item;
+    /**
+     * 创建一个大型物品（Item + Attachable）。
+     * 用于在手持时显示为大型 3D 模型（如部分 3D 物品）。
+     * @param identifier 物品的唯一标识符。
+     * @param category 物品在创造菜单中的分类，见 {@link ItemCategory}。
+     * @param texture 物品的纹理。
+     * @param options 额外选项。
+     * @returns 创建的物品。
+     */
+    createLargeItem(identifier: string, category: ItemCategory, texture: string, options?: ItemOptions): Item;
+    /**
+     * 创建一个 3D 手持物品（Item + Attachable + 内置默认握持动画）。
+     * 采用 Bedrock Wiki "Attachables" 的 Method 2（model binding）：attachable 使用
+     * scripts.animate 按 context.is_first_person 切换首/第三人称动画，并搭配
+     * controller.render.item_default 渲染控制器。内置动画姿态参照官方示例
+     * （首/第三人称各用固定值），骨骼名须与用户 geometry 中的根骨骼一致。
+     * 用户需自行将几何模型放入 RP（geometry 根骨骼应使用
+     * "q.item_slot_to_bone_name(c.item_slot)" 绑定槽位）。
+     * @param identifier 物品的唯一标识符（如 "my_mod:model_sword"）。
+     * @param category 物品在创造菜单中的分类，见 {@link ItemCategory}。
+     * @param icon 物品图标（创造菜单/物品栏显示的短名，需登记在 item_texture.json）。
+     *             与 texture 相互独立，可分别指定。
+     * @param texture attachable 的 3D 贴图路径。传完整路径（如 "textures/entity/skeleton/skeleton"）
+     *                将直接用作贴图；传短名（如 "amethyst_shard"）则自动拼接 "textures/items/" 前缀。
+     * @param geometry 用户几何标识符（如 "geometry.my_model"）。
+     * @param options 额外选项，见 {@link CreateModelItemOptions}。
+     * @returns 创建的物品。
+     */
+    createModelItem(identifier: string, category: ItemCategory, icon: string, texture: string, geometry: string, options?: CreateModelItemOptions): Item;
+    /**
+     * 创建一个食物物品。
+     * @param identifier 食物的唯一标识符。
+     * @param category 食物在创造菜单中的分类，见 {@link ItemCategory}。
+     * @param texture 食物的纹理。
+     * @param options 额外选项。
+     * @returns 创建的食物物品。
+     */
+    createFood(identifier: string, category: ItemCategory, texture: string, options?: FoodOptions): Food;
+    /**
+     * 创建一个可附着物品。
+     * @param identifier 可附着物品的唯一标识符。
+     * @param texture 可附着物品的纹理。
+     * @param material 可附着物品的材质。
+     * @param options 额外选项。
+     * @returns 创建的可附着物品。
+     */
+    createAttachable(identifier: string, texture: string, material: string, options?: ItemOptions): Attachable;
+    /**
+     * 创建一个胸甲（Item + Attachable）。
+     * @param identifier 物品的唯一标识符。
+     * @param item_texture 物品图标纹理名称。
+     * @param texture_path 盔甲模型纹理路径。
+     * @param options 额外选项。
+     * @returns 创建的盔甲实例。
+     */
+    createChestplateArmor(identifier: string, item_texture: string, texture_path: string, options?: ItemOptions): Armor;
+    /**
+     * 创建一个头盔（Item + Attachable）。
+     */
+    createHelmetArmor(identifier: string, item_texture: string, texture_path: string, options?: ItemOptions): Armor;
+    /**
+     * 创建一个靴子（Item + Attachable）。
+     */
+    createBootArmor(identifier: string, item_texture: string, texture_path: string, options?: ItemOptions): Armor;
+    /**
+     * 创建一个护腿（Item + Attachable）。
+     */
+    createLeggingsArmor(identifier: string, item_texture: string, texture_path: string, options?: ItemOptions): Armor;
+    /**
+     * 创建并注册翻书物品。
+     * @param identifier 物品的唯一标识符（如："my_mod:flipbook_item"）。
+     * @param category 物品所属的分类，见 {@link ItemCategory}。
+     * @param texture 纹理名称（不包含路径和后缀，如："my_flipbook_texture"）。
+     * @param options 可选的配置参数对象。
+     * @returns 创建的翻书物品。
+     */
+    createFlipbookItem(identifier: string, category: ItemCategory, texture: string, options?: FlipbookItemOptions): FlipbookItem;
+    /**
+     * 创建物品目录（生成 BP/item_catalog/crafting_item_catalog.json）。
+     * 用于指定物品在创造菜单与配方手册中的分组位置。
+     * @param formatVersion 格式版本，默认 "1.26.30"
+     * @returns 物品目录实例
+     */
+    createItemCatalog(formatVersion?: string): ItemCatalog;
+};
+
 declare const RecipeAPI: RecipeRegistry;
 declare class RecipeRegistry {
     /**
@@ -2870,129 +3747,354 @@ declare namespace UiAPI {
 declare class ItemComponent {
     /**
      * 设置交互按钮
-     * @param {string} interact_text 交互文本
+     * @param interact_text 交互文本；传 true 使用通用 "Use Item" 文案，传 false 不显示
      * @returns 交互按钮组件
      */
-    static setInteractButton(interact_text: string): Map<string, string>;
+    static setInteractButton(interact_text: string | boolean): ItemComponentMap;
     /**
      * 自定义物品组件
      * [warning] 需要物品格式版本 format_version >1.21.90 and Scripting V2.0.0
-     * @param {string} component_id 组件标识符
-     * @param {object} params 自定义参数接口对象
-     * @returns {Map} 物品组件Map
+     * @param component_id 组件标识符
+     * @param params 自定义参数接口对象
+     * @returns 物品组件 Map
      */
-    static setCustomComponentV2(component_id: string, params: object): Map<any, any>;
+    static setCustomComponentV2(component_id: string, params: object): ItemComponentMap;
     /**
      * 物品的耐久度组件
-     * @param {number} max_durability 最大耐久
-     * @param {number} damage_chance_min 损坏最小几率
-     * @param {number} damage_chance_max 损坏最大几率
-     * @returns {ItemComponent}
-     */
-    static setDurability(max_durability: number, damage_chance_min?: number, damage_chance_max?: number): ItemComponent;
-    static setBlockPlacer(block: any, replace_block_item: any, use_on: any): Map<any, any>;
-    /**
-  *
-  * @param {Array} custom_components
-  * @returns
-  */
-    static setCustomComponents(custom_components: any[]): Map<any, any>;
+     * @param max_durability 最大耐久
+     * @param damage_chance_min 损坏最小几率
+     * @param damage_chance_max 损坏最大几率
+     * @returns 耐久度组件 Map
+     */
+    static setDurability(max_durability: number, damage_chance_min?: number, damage_chance_max?: number): ItemComponentMap;
+    /**
+     * 设置放置方块组件
+     * @param block 被放置的方块标识符
+     * @param options 放置配置
+     * @param options.replaceBlockItem 是否替换原方块物品
+     * @param options.alignedPlacement 是否启用对齐放置
+     * @param options.useOn 允许放置的目标方块描述符列表；省略则可放置于任何方块
+     * @returns 组件 Map
+     */
+    static setBlockPlacer(block: string, options?: BlockPlacerOptions): ItemComponentMap;
+    /**
+   * 设置自定义组件列表
+   * @param custom_components 自定义组件 ID 数组
+   * @returns 组件 Map
+   */
+    static setCustomComponents(custom_components: string[]): ItemComponentMap;
     /**
      * 设置物品的可投掷组件。
-     * @param {Boolean} doSwingAnimation - 是否使用挥动动画。
-     * @param {Number} launchPowerScale - 投掷力量的缩放比例。
-     * @param {Number} maxDrawDuration - 最大蓄力时间。
-     * @param {Number} maxLaunchPower - 最大投掷力量。
-     * @param {Number} minDrawDuration - 最小蓄力时间。
-     * @param {Boolean} scalePowerByDrawDuration - 投掷力量是否随蓄力时间增加。
-     * @returns {Map} - 新的组件集合。
+     * @param doSwingAnimation 是否使用挥动动画。
+     * @param launchPowerScale 投掷力量的缩放比例。
+     * @param maxDrawDuration 最大蓄力时间。
+     * @param maxLaunchPower 最大投掷力量。
+     * @param minDrawDuration 最小蓄力时间。
+     * @param scalePowerByDrawDuration 投掷力量是否随蓄力时间增加。
+     * @returns 新的组件集合。
      */
-    static setThrowable(doSwingAnimation?: boolean, launchPowerScale?: number, maxDrawDuration?: number, maxLaunchPower?: number, minDrawDuration?: number, scalePowerByDrawDuration?: boolean): Map<any, any>;
+    static setThrowable(doSwingAnimation?: boolean, launchPowerScale?: number, maxDrawDuration?: number, maxLaunchPower?: number, minDrawDuration?: number, scalePowerByDrawDuration?: boolean): ItemComponentMap;
     /**
      * 设置物品的显示名称。
-     * @param {String} displayName - 显示名称或本地化键。
-     * @returns {Map} - 新的组件集合。
+     * @param displayName 显示名称或本地化键。
+     * @returns 新的组件集合。
      */
-    static setDisplayName(displayName: string): Map<any, any>;
+    static setDisplayName(displayName: string): ItemComponentMap;
     /**
      * 设置物品的食物组件。
-     * @param {Boolean} canAlwaysEat - 是否随时可以食用。
-     * @param {Number} nutrition - 营养值。
-     * @param {Number} saturationModifier - 饱和度修正值。
-     * @param {String} [usingConvertsTo] - 食用后转换的目标物品。
-     * @returns {Map} - 新的组件集合。
+     * @param options 食物组件配置。
+     * @param options.canAlwaysEat 是否随时可以食用。
+     * @param options.nutrition 营养值。
+     * @param options.saturationModifier 饱和度修正值。
+     * @param options.usingConvertsTo 食用后转换的目标物品。
+     * @returns 新的组件集合。
      */
-    static setFoodComponent(canAlwaysEat: boolean, nutrition: number, saturationModifier: number, usingConvertsTo?: string): Map<any, any>;
+    static setFoodComponent(options?: FoodComponentOptions): ItemComponentMap;
     /**
      * 设置物品的燃料组件。
-     * @param {Number} duration - 燃料燃烧的持续时间（秒），最小值为 0.05。
-     * @returns {Map} - 新的组件集合。
+     * @param duration 燃料燃烧的持续时间（秒），最小值为 0.05。
+     * @returns 新的组件集合。
      */
-    static setFuel(duration: number): Map<any, any>;
+    static setFuel(duration: number): ItemComponentMap;
     /**
      * 设置物品的附魔光效组件。
-     * @param {Boolean} hasGlint - 是否显示附魔光效。
-     * @returns {Map} - 新的组件集合。
+     * @param hasGlint 是否显示附魔光效。
+     * @returns 新的组件集合。
      */
-    static setGlint(hasGlint: boolean): Map<any, any>;
+    static setGlint(hasGlint: boolean): ItemComponentMap;
     /**
      * 设置物品的手持渲染方式组件。
-     * @param {Boolean} isHandEquipped - 是否像工具一样渲染。
-     * @returns {Map} - 新的组件集合。
+     * @param isHandEquipped 是否像工具一样渲染。
+     * @returns 新的组件集合。
      */
-    static setHandEquipped(isHandEquipped: boolean): Map<any, any>;
+    static setHandEquipped(isHandEquipped: boolean): ItemComponentMap;
     /**
      * 设置物品的图标组件。
-     * @param {String} texture - 图标纹理名称。
-     * @returns {Map} - 新的组件集合。
+     * 支持字符串（default 纹理）或对象（多纹理）两种格式。
+     * @param texture 图标纹理名称，或包含 default/dyed/iconTrim 等纹理的对象。
+     * @returns 新的组件集合。
      */
-    static setIcon(texture: string): Map<any, any>;
+    static setIcon(texture: string | IconTextures): ItemComponentMap;
     /**
      * 设置物品的最大堆叠数量组件。
-     * @param {Number} maxStackSize - 最大堆叠数量，默认值为 64。
-     * @returns {Map} - 新的组件集合。
+     * @param maxStackSize 最大堆叠数量，默认值为 64。
+     * @returns 新的组件集合。
      */
-    static setMaxStackSize(maxStackSize?: number): Map<any, any>;
+    static setMaxStackSize(maxStackSize?: number): ItemComponentMap;
     /**
      * 设置物品的投射物组件。
-     * @param {Number} [minimumCriticalPower] - 投射物需要蓄力多久才能造成暴击。
-     * @param {String} [projectileEntity] - 作为投射物发射的实体名称。
-     * @returns {Map} - 新的组件集合。
+     * @param minimumCriticalPower 投射物需要蓄力多久才能造成暴击。
+     * @param projectileEntity 作为投射物发射的实体名称。
+     * @returns 新的组件集合。
      */
-    static setProjectile(minimumCriticalPower?: number, projectileEntity?: string): Map<any, any>;
+    static setProjectile(minimumCriticalPower?: number, projectileEntity?: string): ItemComponentMap;
     /**
      * 设置物品的使用修饰组件。
-     * @param {Number} [movementModifier] - 使用物品时玩家移动速度的缩放值。
-     * @param {Number} [useDuration] - 物品使用所需的时间（秒）。
-     * @returns {Map} - 新的组件集合。
+     * @param options 使用修饰配置。
+     * @param options.movementModifier 使用物品时玩家移动速度的缩放值（0.0-1.0）。
+     * @param options.useDuration 物品使用所需的时间（秒）。
+     * @param options.emitVibrations 是否在开始/停止使用时发出振动。
+     * @param options.startSound 开始使用时触发的音效。
+     * @param options.startUsing 使用修饰生效的时机（"always" 或 "if_first"）。
+     * @returns 新的组件集合。
      */
-    static setUseModifiers(movementModifier?: number, useDuration?: number): Map<any, any>;
+    static setUseModifiers(options?: UseModifiersOptions): ItemComponentMap;
     /**
      * 设置物品的可穿戴组件。
-     * @param {Number} [protection=0] - 物品提供的保护值。
-     * @param {String} [slot] - 物品可以穿戴的槽位（如 "head"、"chest" 等）。
-     * @returns {Map} - 新的组件集合。
+     * @param protection 物品提供的保护值。
+     * @param slot 物品可以穿戴的槽位（如 "slot.armor.head"、"slot.weapon.offhand" 等）。
+     * @param hidesPlayerLocation 穿戴时是否从定位栏与定位地图中隐藏。
+     * @returns 新的组件集合。
      */
-    static setWearable(protection?: number, slot?: string): Map<any, any>;
+    static setWearable(protection?: number, slot?: string, hidesPlayerLocation?: boolean): ItemComponentMap;
     /**
-    * 设置物品的使用动画组件。
-    * @param {String} animation - 物品使用时的动画类型（如 "eat"、"drink" 等）。
-    * @returns {Map} - 新的组件集合。
-    * @throws {Error} - 如果 animation 不是字符串类型。
-    */
-    static setUseAnimation(animation: string): Map<any, any>;
+     * 设置物品的使用动画组件。
+     * @param animation 物品使用时的动画类型（如 "eat"、"drink" 等）。
+     * @returns 新的组件集合。
+     */
+    static setUseAnimation(animation: string): ItemComponentMap;
+    /**
+     * 设置物品是否可装备至副手。
+     * @param allowed 是否允许装备至副手。
+     * @returns 新的组件集合。
+     */
+    static setAllowOffHand(allowed: boolean): ItemComponentMap;
+    /**
+     * 设置 Bundle 交互组件（需要同时具备 storage_item 组件）。
+     * @param numViewableSlots 可查看的槽位数量（1-64）。
+     * @returns 新的组件集合。
+     */
+    static setBundleInteraction(numViewableSlots: number): ItemComponentMap;
+    /**
+     * 设置创造模式下能否破坏方块。
+     * @param canDestroy 是否可破坏。
+     * @returns 新的组件集合。
+     */
+    static setCanDestroyInCreative(canDestroy: boolean): ItemComponentMap;
+    /**
+     * 设置堆肥组件。
+     * @param compostingChance 堆肥等级增加的概率（0-100）。
+     * @returns 新的组件集合。
+     */
+    static setCompostable(compostingChance: number): ItemComponentMap;
+    /**
+     * 设置物品的冷却组件。
+     * @param options 冷却配置。
+     * @param options.category 冷却分类，相同分类的物品共享冷却。
+     * @param options.duration 冷却时长（秒），负数会使物品无法使用。
+     * @param options.type 冷却影响的输入类型（"use" 或 "attack"）。
+     * @returns 新的组件集合。
+     */
+    static setCooldown(options: CooldownOptions): ItemComponentMap;
+    /**
+     * 设置物品的伤害组件。
+     * @param damage 额外伤害值（0-32767）。
+     * @returns 新的组件集合。
+     */
+    static setDamage(damage: number): ItemComponentMap;
+    /**
+     * 设置伤害吸收组件（需要同时具备 durability 组件并装备于盔甲槽位）。
+     * @param absorbableCauses 可被吸收的伤害原因列表，如 ["all"]。
+     * @returns 新的组件集合。
+     */
+    static setDamageAbsorption(absorbableCauses: string[]): ItemComponentMap;
+    /**
+     * 设置挖掘组件。
+     * @param options 挖掘配置。
+     * @param options.destroySpeeds 破坏速度列表，speed 为 0 表示无法破坏该方块。
+     * @param options.useEfficiency 效率附魔是否能影响破坏速度。
+     * @returns 新的组件集合。
+     */
+    static setDigger(options: DiggerOptions): ItemComponentMap;
+    /**
+     * 设置耐久传感器组件。
+     * @param options 耐久传感器配置。
+     * @param options.durabilityThresholds 耐久阈值列表，达到阈值时触发粒子或音效。
+     * @returns 新的组件集合。
+     */
+    static setDurabilitySensor(options: DurabilitySensorOptions): ItemComponentMap;
+    /**
+     * 设置可染色组件。
+     * @param defaultColor 默认颜色，如 "#ffffff"。
+     * @returns 新的组件集合。
+     */
+    static setDyeable(defaultColor: string): ItemComponentMap;
+    /**
+     * 设置可附魔组件。
+     * @param slot 可应用的附魔槽位，如 "sword"、"bow"。
+     * @param value 附魔质量与数量（0-255）。
+     * @returns 新的组件集合。
+     */
+    static setEnchantable(slot: string, value: number): ItemComponentMap;
+    /**
+     * 设置放置实体组件。
+     * @param entity 被放置的实体标识符，可带出生事件如 "wiki:entity<wiki:event>"。
+     * @param options 放置配置。
+     * @param options.dispenseOn 允许发射器放置的目标方块列表。
+     * @param options.useOn 允许放置的目标方块列表。
+     * @returns 新的组件集合。
+     */
+    static setEntityPlacer(entity: string, options?: EntityPlacerOptions): ItemComponentMap;
+    /**
+     * 设置防火组件。
+     * @param value 是否防火。
+     * @returns 新的组件集合。
+     */
+    static setFireResistant(value: boolean): ItemComponentMap;
+    /**
+     * 设置物品名颜色组件。
+     * @param color 颜色名称，如 "minecoin_gold"。
+     * @returns 新的组件集合。
+     */
+    static setHoverTextColor(color: string): ItemComponentMap;
+    /**
+     * 设置动能武器组件。
+     * @param options 动能武器配置。
+     * @param options.delay 动能伤害开始生效前的延迟（tick）。
+     * @param options.hitboxMargin 命中箱额外边距（格）。
+     * @param options.reach 生效距离范围（格）。
+     * @param options.creativeReach 创造模式下生效距离范围（格）。
+     * @param options.damageMultiplier 基础伤害倍率。
+     * @param options.damageModifier 附加伤害。
+     * @param options.damageConditions 造成伤害的条件。
+     * @param options.dismountConditions 解除骑乘的条件。
+     * @param options.knockbackConditions 造成击退的条件。
+     * @returns 新的组件集合。
+     */
+    static setKineticWeapon(options: KineticWeaponOptions): ItemComponentMap;
+    /**
+     * 设置物品是否与液体方块交互。
+     * @param clipped 是否在液体内部交互。
+     * @returns 新的组件集合。
+     */
+    static setLiquidClipped(clipped: boolean): ItemComponentMap;
+    /**
+     * 设置穿刺武器组件。
+     * @param options 穿刺武器配置。
+     * @param options.hitboxMargin 命中箱额外边距（格）。
+     * @param options.reach 生效距离范围（格）。
+     * @param options.creativeReach 创造模式下生效距离范围（格）。
+     * @returns 新的组件集合。
+     */
+    static setPiercingWeapon(options?: PiercingWeaponOptions): ItemComponentMap;
+    /**
+     * 设置物品稀有度组件（会被 hover_text_color 覆盖）。
+     * @param rarity 稀有度："common"、"uncommon"、"rare"、"epic"。
+     * @returns 新的组件集合。
+     */
+    static setRarity(rarity: ItemRarity): ItemComponentMap;
+    /**
+     * 设置唱片组件。
+     * @param options 唱片配置。
+     * @param options.comparatorSignal 比较器信号强度（0-15）。
+     * @param options.duration 播放时长（秒）。
+     * @param options.soundEvent 播放的原版音效事件。
+     * @returns 新的组件集合。
+     */
+    static setRecord(options: RecordOptions): ItemComponentMap;
+    /**
+     * 设置可修复组件。
+     * @param repairItems 修复条目列表；repair_amount 可为数字或 Molang 表达式字符串。
+     * @returns 新的组件集合。
+     */
+    static setRepairable(repairItems: RepairItem[]): ItemComponentMap;
+    /**
+     * 设置射击组件（需要同时具备 use_modifiers 组件）。
+     * @param options 射击配置。
+     * @param options.ammunition 弹药列表，item 必须具有 projectile 组件。
+     * @param options.chargeOnDraw 是否在拉弓时上弹（如弩）。
+     * @param options.maxDrawDuration 自动发射前的最大拉弓时长（秒）。
+     * @param options.scalePowerByDrawDuration 发射威力是否随拉弓时长增加。
+     * @returns 新的组件集合。
+     */
+    static setShooter(options: ShooterOptions): ItemComponentMap;
+    /**
+     * 设置是否应该消失组件。
+     * @param shouldDespawn 掉落物是否最终消失。
+     * @returns 新的组件集合。
+     */
+    static setShouldDespawn(shouldDespawn: boolean): ItemComponentMap;
+    /**
+     * 设置按数据堆叠组件。
+     * @param stackedByData 不同数据值的同种物品是否分开堆叠。
+     * @returns 新的组件集合。
+     */
+    static setStackedByData(stackedByData: boolean): ItemComponentMap;
+    /**
+     * 设置容器物品组件（需要 max_stack_size 为 1）。
+     * @param options 容器配置。
+     * @param options.maxSlots 容器槽位数量（1-64）。
+     * @param options.allowNestedStorageItems 是否允许嵌套其他容器物品。
+     * @param options.allowedItems 仅允许存入的物品列表。
+     * @param options.bannedItems 禁止存入的物品列表。
+     * @returns 新的组件集合。
+     */
+    static setStorageItem(options: StorageItemOptions): ItemComponentMap;
+    /**
+     * 设置容器重量上限组件（需要同时具备 storage_item 组件）。
+     * @param maxWeightLimit 容器内物品总重量上限。
+     * @returns 新的组件集合。
+     */
+    static setStorageWeightLimit(maxWeightLimit: number): ItemComponentMap;
+    /**
+     * 设置容器重量修正组件（0 表示不允许放入其他容器）。
+     * @param weightInStorageItem 该物品放入容器时占用的重量（0-64）。
+     * @returns 新的组件集合。
+     */
+    static setStorageWeightModifier(weightInStorageItem: number): ItemComponentMap;
+    /**
+     * 设置挥动时长组件。
+     * @param value 基础挥动时长（秒）。
+     * @returns 新的组件集合。
+     */
+    static setSwingDuration(value: number): ItemComponentMap;
+    /**
+     * 设置挥砍音效组件。
+     * @param options 音效配置。
+     * @param options.attackMiss 未命中时播放的原版音效。
+     * @param options.attackHit 普通命中时播放的原版音效。
+     * @param options.attackCriticalHit 暴击命中时播放的原版音效。
+     * @returns 新的组件集合。
+     */
+    static setSwingSounds(options?: SwingSoundsOptions): ItemComponentMap;
+    /**
+     * 设置物品标签组件。
+     * @param tags 标签列表。
+     * @returns 新的组件集合。
+     */
+    static setTags(tags: string[]): ItemComponentMap;
     /**
      * 将多个组件集合合并为一个。
-     * @param {...Map} componentMaps - 多个组件集合。
-     * @returns {Map} - 合并后的组件集合。
+     * @param componentMaps 多个组件集合。
+     * @returns 合并后的组件集合。
      */
-    static combineComponents(...componentMaps: Map<any, any>[]): Map<any, any>;
+    static combineComponents(...componentMaps: ItemComponentMap[]): ItemComponentMap;
     /**
      * 获取当前组件的 JSON 表示。
-     * @param {Map} components - 组件集合。
-     * @returns {Object} - 组件的 JSON 对象。
+     * @param components 组件集合。
+     * @returns 组件的 JSON 对象。
      */
-    static toJSON(components: Map<any, any>): Object;
+    static toJSON(components: ItemComponentMap): Record<string, unknown>;
 }
 
 /**
@@ -3665,68 +4767,120 @@ declare class Guidebook {
     #private;
 }
 
-declare class UISystemRegistry {
-    static "__#private@#ui_system_map": {};
-    static "__#private@#ui_def_list": any[];
-    static registerUISystem(ui_system: any): void;
-    static addOuterUIdefs(ui_defs: any): void;
-}
-
+type CustomButtonConfig = {
+    id: string;
+    position: "bottom_left" | "bottom_right" | "bottom_middle" | "top_left" | "top_right";
+    offset: [number, number];
+    size: [number | string, number | string];
+    defaultTexture: string;
+    hoverTexture: string;
+    pressedTexture: string;
+    bindingButtonName: string;
+};
+type ButtonTextures = {
+    prevDefault?: string;
+    prevHover?: string;
+    prevPressed?: string;
+    nextDefault?: string;
+    nextHover?: string;
+    nextPressed?: string;
+    homeDefault?: string;
+    homeHover?: string;
+    homePressed?: string;
+    closeDefault?: string;
+    closeHover?: string;
+    closePressed?: string;
+};
+type NeoGuidebookOptions = {
+    size?: [number, number];
+    background?: string;
+    debug?: boolean;
+    buttons?: {
+        prev?: {
+            visible?: boolean;
+        };
+        next?: {
+            visible?: boolean;
+        };
+        home?: {
+            visible?: boolean;
+        };
+        close?: {
+            visible?: boolean;
+        };
+    };
+    textures?: ButtonTextures;
+};
 declare class NeoGuidebook {
-    private identifer;
+    private identifier;
     private book_pages;
     private size;
     private background_image;
     private debug_mode;
     private system;
-    private root_panel_id;
-    private root_panel_name;
+    private content_panel_name;
+    private content_panel_id;
+    private buttons_panel_name;
+    private buttons_panel_id;
     private root_panel_elements;
-    /**
-     * @param {string} identifer - UI唯一标识符（格式 "命名空间:名称"）
-     * @param {string} path - UI路径 例如"ui/"
-     * @param {[number, number]} size - 面板尺寸 [宽, 高]
-     */
-    constructor(identifer: string, path: string, size?: [number, number]);
-    /**添加单页书面 */
+    private custom_buttons;
+    private button_visibility;
+    private textures;
+    private dirty;
+    constructor(identifier: string, path: string, size?: [number, number], options?: NeoGuidebookOptions);
+    getPageIds(): string[];
+    getPageCount(): number;
+    addCustomButton(config: CustomButtonConfig): this;
     addSinglePageStack(page_id: string, page_content: Panel): void;
-    /**添加双页书面 */
-    addDoublePageStack(page_id: string, left_page: Panel, right_page: Panel): void;
+    addDoublePageStack(page_id: string, left_page: Panel, right_page: Panel, ratio?: [string, string]): void;
+    private flush;
     private createPagesPanel;
     private initUI;
-    private updataUI;
-    /** 创建关闭按钮 */
+    private createNavButtons;
+    private createCustomButtons;
+    private updateUI;
+    private tex;
     private createCloseButton;
-    /** 创建翻页按钮（通用方法） */
     private createPageButton;
-    /**创建返回章节目录按键 */
     private createHomeButton;
-    /**创建书页 */
     private createBookPage;
-    /**创建调试数据内容文本 */
     private createDebugText;
-    /**
-     * 向系统注册一个元素
-     * @param {UIElement} element
-     */
     registerElement(element: UIElement): this;
-    /**
-     * 向根面板添加元素
-     */
     addRootElement(element: UIElement): this;
-    /**
-    * 向根面板添加多个元素
-    * @param {Array} elements
-    */
     addRootElements(elements: UIElement[]): this;
 }
 
+/**
+ * SapdonButton：sapdon 页面壳内的表单按钮。
+ * 默认模板固定为 server_form.form_button（集合按钮，吃 form_buttons 数据）。
+ */
+declare class SapdonButton extends UIElement {
+    constructor(id: string);
+    /** 设置锚点对齐（如 bottom_left / bottom_right / top_right），默认尺寸 32×32 */
+    setAnchor(anchor: string): this;
+}
+/**
+ * SapdonTexturedButton：sapdon 页面壳内的纹理按钮。
+ * 默认模板固定为 server_form.sapdon_textured_button（三态纹理 + binding_button_text 门控）。
+ */
+declare class SapdonTexturedButton extends UIElement {
+    constructor(id: string, bindingButtonName?: string);
+    setDefaultTexture(texture: string): this;
+    setHoverTexture(texture: string): this;
+    setPressedTexture(texture: string): this;
+    /** 设置锚点对齐 */
+    setAnchor(anchor: string, size?: [number | string, number | string]): this;
+}
+
 declare class EmptySpace extends Panel {
     constructor(id: string, size?: [string, string]);
 }
 declare class BookTitle extends Label {
     constructor(id: string, title: string, size?: [string, string]);
 }
+declare class BookText extends Label {
+    constructor(id: string, text: string, size?: [string, string]);
+}
 declare class BookTitleBar extends Panel {
     private size;
     constructor(id: string, text: string, size?: [string, string]);
@@ -3735,7 +4889,7 @@ declare class BookTitleBar extends Panel {
 declare class Divider extends StackPanel {
     constructor(id: string, size?: [string, string]);
 }
-declare class BookButton extends ServerFormButton {
+declare class BookButton extends SapdonTexturedButton {
     constructor(id: string, texture: string, size?: [string, string]);
 }
 declare class BookImage extends Image {
@@ -3751,7 +4905,7 @@ declare class BookRecipeGrid extends StackPanel {
     constructor(id: string, row: number, col: number, items: string[]);
 }
 declare class ChapterItem extends Panel {
-    constructor(index: number, chapterName: string, texture: string);
+    constructor(index: number, chapterName: string, texture: string, prefix?: string);
 }
 declare class NeoGuidebookPage {
     private panel;
@@ -3773,11 +4927,122 @@ declare class NeoGuidebookPage {
         chapter_name: string;
         chapter_texture: string;
     }>): this;
-    buildChapterList(): this;
+    buildChapterList(prefix?: string): this;
+    addControl(control: UIElement): this;
+    addStack(size: [string, string], control: UIElement, debug?: boolean): this;
     getPanel(): StackPanel;
     clear(): this;
 }
 
+/**
+ * sapdon_ui: 页面壳路由系统（生成 server_form.json）
+ *
+ * 结构：
+ *   third_party_server_screen@common.base_screen (type:screen)
+ *     └─ $screen_content = custom_full_screen
+ *          ├─ native_form@main_screen_content        (title 含 'sapdon_ui:' ? 隐藏 : 显示)
+ *          └─ sapdon_custom_full@sapdon_screen_content (title 含 'sapdon_ui:' 显示)
+ *               └─ (页面各自) @server_form.custom_panel_content (panel_id 精确匹配)
+ *                    ├─ content@$user_content_panel   (下)
+ *                    └─ buttons@$user_buttons_panel   (上)
+ */
+interface SapdonPageRegistration {
+    panelId: string;
+    contentPanel: UIElement | string;
+    buttonsPanel?: UIElement | string;
+    /** 页面控件�?默认 pageN) */
+    name?: string;
+}
+declare class SapdonServerUI {
+    static readonly MARKER = "sapdon_ui:";
+    static readonly NS = "server_form";
+    private static _system;
+    private static _screenContent;
+    private static _pageCount;
+    /** 框架侧固定提供的按钮项模�?form_button@common_buttons.light_text_button */
+    static createFormButtonTemplate(): UIElement;
+    /** 框架侧固定提供的纹理按钮模板 sapdon_textured_button@common.button（三态纹理 + 门控） */
+    static createTexturedButtonTemplate(): UIElement;
+    /** 通用页面壳 custom_panel_content: panel_id 精确匹配 + 内容(下)/按键(上) */
+    static createPanelContentShell(): UIElement;
+    private static _ensureBuilt;
+    /** 注册一个自定义页面到 sapdon_screen_content */
+    static registerPage(reg: SapdonPageRegistration): void;
+    static getSystem(): UISystem | null;
+}
+
+/**
+ * SapdonPanel：一个自定义页面 = 一个 UI 文件(text_ui_xxx.json)
+ * 由「内容面板 + 按键面板」两个元素组成。
+ */
+declare class SapdonPanel {
+    private system;
+    constructor(namespace: string);
+    /** 设置内容面板元素 */
+    setContent(content: UIElement): this;
+    /** 设置按键面板元素 */
+    setButtons(buttons: UIElement): this;
+    build(): UISystem;
+}
+
+/**
+ * SapdonButtonPanel：按键网格面板。
+ * 内部造一个 Grid（collection_name 注入 form_buttons），
+ * 通过 place() 逐个把 form_button 内容按 pos_wrap 摆到指定格。
+ */
+declare class SapdonButtonPanel {
+    private grid;
+    constructor(gridId: string);
+    /** 网格尺寸 [列, 行] */
+    setDimensions([cols, rows]: [number, number]): this;
+    setSize(size: [number | string, number | string]): this;
+    /** 注入按钮集合 */
+    setCollection(collectionName: string): this;
+    /** 摆一个按钮(内部会生成带 grid_position 的 pos_wrap 面板包裹) */
+    place(gridPosition: [number, number], content: UIElement): this;
+    build(): Grid;
+}
+
+declare class UISystemRegistry {
+    static "__#private@#ui_system_map": {};
+    static "__#private@#ui_def_list": any[];
+    static registerUISystem(ui_system: any): void;
+    static addOuterUIdefs(ui_defs: any): void;
+}
+
+interface ProgressBarLayer {
+    color: [number, number, number];
+    clipRatio: number;
+}
+interface HudProgressBarOptions {
+    id: string;
+    texture: string;
+    uv?: [number, number];
+    uvSize?: [number, number];
+    barSize?: [string | number, string | number];
+    layers: ProgressBarLayer[];
+    states: number;
+    fillColor?: [number, number, number];
+    fillUv?: [number, number];
+    segments?: {
+        count: number;
+        color: [number, number, number];
+    };
+    hudSize?: [string | number, string | number];
+    anchorFrom?: string;
+    anchorTo?: string;
+    offset?: [number, number];
+    clipDirection?: string;
+}
+declare class HudProgressBar {
+    private panel;
+    private options;
+    constructor(options: HudProgressBarOptions);
+    private build;
+    getPanel(): Panel;
+    mountToHud(): void;
+}
+
 declare namespace HudUISystem {
     /**
      * 获取HUD UI系统实例
@@ -3846,13 +5111,6 @@ interface ISerializer {
 declare function jsonEncoderReplacer(_: string, v: any): any;
 declare const defaultSerializer: ISerializer;
 declare function Serializable(serializer?: ISerializer): (_: any, ctx: DecoratorContext) => void;
-/**
- * 只能应用一个 Serializer
- *
- * 重复的 Serializer 会被覆盖
- * @param target
- * @param ctx
- */
 declare const Serializer: MethodDecorator;
 declare function serialize<R, T extends object>(inst: T): R;
 declare const jsonEncodeDecoder: EncodeDecoder<any, string>;
@@ -3881,5 +5139,5 @@ declare namespace registry {
     function submit(): void;
 }
 
-export { AddonAnimationController, AddonAnimationStateMachine, AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription, AddonBiome, AddonBiomeDefinition, AddonBiomeDescription, AddonBlock, AddonBlockDefinition, AddonBlockDescription, AddonClientEntity, AddonClientEntityDefinition, AddonClientEntityDescription, AddonEntity, AddonEntityDefinition, AddonEntityDescription, AddonFeatureRule, AddonFeatureRuleDecription, AddonFeatureRuleDenifition, AddonItem, AddonItemDefinition, AddonItemDescription, AddonManifest, AddonManifestDependency, AddonManifestHeader, AddonManifestMetadata, AddonManifestModule, AddonMenuCategory, AddonOreFeature, AddonOreFeatureDefinition, AddonOreFeatureDescription, AddonRecipe, AddonRecipeFurnace, AddonRecipeFurnace_1_12, AddonRecipeFurnace_1_17, AddonRecipeShaped, AddonRecipeShaped_1_12, AddonRecipeShaped_1_17, AddonRecipeShaped_1_19, AddonRecipeShaped_1_20, AddonRecipeShapeless, AddonRecipeShapeless_1_12, AddonRecipeShapeless_1_17, AddonRenderController, AddonRenderControllerGroup, AddonSemanticVersion, Armor, Attachable, BasicBlock, BasicBundle, BasicEntity, BasicMovementBundle, Biome, BiomeAPI, BiomeComponent, BiomeFilter, Block, BlockAPI, BlockComponent, BookButton, BookCategoryGrid, BookImage, BookRecipeGrid, BookTitle, BookTitleBar, Boot, Button, ButtonMapping$1 as ButtonMapping, ChapterItem, ChestUISystem, Chestplate, ClientEntity, CollectionPanel, ContainerUISystem, Control, CoordinateDistribution, CropBlock, DataBinding, DataBindingObject, Divider, DummyEntity, EmptySpace, Entity, EntityAPI, EntityComponent, Factory, FeatureAPI, FeatureConditions, FeatureDistribution, FeatureRule, FlipbookItem, FlipbookTextures, FollowMobBehavior, FollowParentBehavior, Food, GeometryBlock, Grid, GridProp, Guidebook, Helmet, HudStatePanel, HudUISystem, Image, Input, Item, ItemAPI, ItemCategory, ItemComponent, ItemTextureManager, Label, Layout, Leggings, Modifications, NativeEntity, NativeEntityData, Navigation, NearestAttackableTargetBehavor, NeoGuidebook, NeoGuidebookPage, NonNullMap, OreBlock, OreFeature, Panel, PickupItemsBehavior, Projectile, RandomStrollBehavior, RecipeAPI, RecipeInputTags, RecipeTags, RecipeTypes, RotatableBlock, RotationTypes, ScrollView, ScrollingPanel, Serializable, Serializer, ServerFormButton, ServerFormSystem, ServerUISystem, Sound, Sprite, StackPanel, TemptBehavior, TerrainTextureManager, Text, TileBlock, UIElement, UISystem, UISystemRegistry, UiAPI, decode, defaultSerializer, encode, f64, form_button_panel, getMetadata, getOrCreateMetadata, isRawJSON, jsonEncodeDecoder, jsonEncoderReplacer, mixin, registerBlock, registerEntity, registry, serialize };
-export type { ConstructorOf, EncodeDecoder, FlipbookItemOptions, FloatLiteral, ISerializer, RawType };
+export { AddonAnimationController, AddonAnimationStateMachine, AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription, AddonBiome, AddonBiomeDefinition, AddonBiomeDescription, AddonBlock, AddonBlockDefinition, AddonBlockDescription, AddonClientEntity, AddonClientEntityDefinition, AddonClientEntityDescription, AddonEntity, AddonEntityDefinition, AddonEntityDescription, AddonFeatureRule, AddonFeatureRuleDecription, AddonFeatureRuleDenifition, AddonItem, AddonItemDefinition, AddonItemDescription, AddonManifest, AddonManifestDependency, AddonManifestHeader, AddonManifestMetadata, AddonManifestModule, AddonMenuCategory, AddonOreFeature, AddonOreFeatureDefinition, AddonOreFeatureDescription, AddonRecipe, AddonRecipeFurnace, AddonRecipeFurnace_1_12, AddonRecipeFurnace_1_17, AddonRecipeShaped, AddonRecipeShaped_1_12, AddonRecipeShaped_1_17, AddonRecipeShaped_1_19, AddonRecipeShaped_1_20, AddonRecipeShapeless, AddonRecipeShapeless_1_12, AddonRecipeShapeless_1_17, AddonRenderController, AddonRenderControllerGroup, AddonSemanticVersion, Armor, ArmorType, Attachable, BasicBlock, BasicBundle, BasicEntity, BasicMovementBundle, Biome, BiomeAPI, BiomeComponent, BiomeFilter, Block, BlockAPI, BlockComponent, BlockCustomComponentBuilder, BookButton, BookCategoryGrid, BookImage, BookRecipeGrid, BookText, BookTitle, BookTitleBar, Button, ButtonMapping$1 as ButtonMapping, ChapterItem, ChestUISystem, ClientEntity, CollectionPanel, ContainerUISystem, Control, CoordinateDistribution, CropBlock, DataBinding, DataBindingObject, Divider, DummyEntity, EmptySpace, Entity, EntityAPI, EntityComponent, Factory, FeatureAPI, FeatureConditions, FeatureDistribution, FeatureRule, FenceBlock, FlipbookItem, FlipbookTextureConfig, FlipbookTextures, FollowMobBehavior, FollowParentBehavior, Food, GeometryBlock, GlassBlock, GoHomeBehavior, Grid, GridProp, Guidebook, HeadBlock, HudProgressBar, HudStatePanel, HudUISystem, Image, Input, Item, ItemAPI, ItemCatalog, ItemCategory, ItemComponent, ItemTextureManager, Label, Layout, Modifications, MoveTowardsHomeRestrictionBehavior, NativeEntity, NativeEntityData, Navigation, NearestAttackableTargetBehavor, NeoGuidebook, NeoGuidebookPage, NonNullMap, OreBlock, OreFeature, Panel, PickupItemsBehavior, Projectile, RandomStrollBehavior, RecipeAPI, RecipeInputTags, RecipeTags, RecipeTypes, RotatableBlock, RotationTypes, SapdonButton, SapdonButtonPanel, SapdonPanel, SapdonServerUI, SapdonTexturedButton, ScrollView, ScrollingPanel, Serializable, Serializer, ServerFormButton, ServerFormSystem, ServerUISystem, Sound, Sprite, StackPanel, StairBlock, TemptBehavior, TerrainTextureManager, Text, TextureVariationConfig, TileBlock, TintMethod, TrapdoorBlock, UIElement, UISystem, UISystemRegistry, UiAPI, decode, defaultSerializer, encode, f64, form_button_panel, getMetadata, getOrCreateMetadata, isRawJSON, jsonEncodeDecoder, jsonEncoderReplacer, mixin, registerBlock, registerEntity, registry, serialize };
+export type { ArmorOptions, ArmorSpec, BeforeOnPlayerPlaceEvent, BlockCustomComponentHandlers, BlockDescriptor, BlockPlacerOptions, ConstructorOf, CooldownOptions, CreateModelItemOptions, DiggerOptions, DurabilitySensorOptions, DurabilityThreshold, EncodeDecoder, EntityPlacerOptions, FlipbookEntry, FlipbookItemOptions, FloatLiteral, FoodComponentOptions, FoodOptions, ISerializer, IconTextures, ItemCatalogCategory, ItemCatalogGroupOptions, ItemComponentMap, ItemOptions, ItemRarity, KineticWeaponOptions, ModelBoneTransform, OnBlockStateChangeEvent, OnBreakEvent, OnEntityEvent, OnEntityFallOnEvent, OnPlaceEvent, OnPlayerBreakEvent, OnPlayerInteractEvent, OnRandomTickEvent, OnRedstoneUpdateEvent, OnStepOffEvent, OnStepOnEvent, OnTickEvent, PiercingWeaponOptions, Range, RawType, RecordOptions, RepairItem, SapdonPageRegistration, ShooterAmmunition, ShooterOptions, StorageItemOptions, SwingSoundsOptions, TextureEntry, TextureVariation, ThrowableOptions, UseModifiersOptions };