sapdon 2.0.2 → 3.0.0

package/dist/core/item/itemComponents.d.ts

@@ -0,0 +1,113 @@
+export class ItemComponent {
+    /**
+     * 物品的耐久度组件
+     * @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 {Boolean} doSwingAnimation - 是否使用挥动动画。
+     * @param {Number} launchPowerScale - 投掷力量的缩放比例。
+     * @param {Number} maxDrawDuration - 最大蓄力时间。
+     * @param {Number} maxLaunchPower - 最大投掷力量。
+     * @param {Number} minDrawDuration - 最小蓄力时间。
+     * @param {Boolean} scalePowerByDrawDuration - 投掷力量是否随蓄力时间增加。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setThrowable(doSwingAnimation?: boolean, launchPowerScale?: number, maxDrawDuration?: number, maxLaunchPower?: number, minDrawDuration?: number, scalePowerByDrawDuration?: boolean): Map<any, any>;
+    /**
+     * 设置物品的显示名称。
+     * @param {String} displayName - 显示名称或本地化键。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setDisplayName(displayName: string): Map<any, any>;
+    /**
+     * 设置物品的食物组件。
+     * @param {Boolean} canAlwaysEat - 是否随时可以食用。
+     * @param {Number} nutrition - 营养值。
+     * @param {Number} saturationModifier - 饱和度修正值。
+     * @param {String} [usingConvertsTo] - 食用后转换的目标物品。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setFoodComponent(canAlwaysEat: boolean, nutrition: number, saturationModifier: number, usingConvertsTo?: string): Map<any, any>;
+    /**
+     * 设置物品的燃料组件。
+     * @param {Number} duration - 燃料燃烧的持续时间（秒），最小值为 0.05。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setFuel(duration: number): Map<any, any>;
+    /**
+     * 设置物品的附魔光效组件。
+     * @param {Boolean} hasGlint - 是否显示附魔光效。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setGlint(hasGlint: boolean): Map<any, any>;
+    /**
+     * 设置物品的手持渲染方式组件。
+     * @param {Boolean} isHandEquipped - 是否像工具一样渲染。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setHandEquipped(isHandEquipped: boolean): Map<any, any>;
+    /**
+     * 设置物品的图标组件。
+     * @param {String} texture - 图标纹理名称。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setIcon(texture: string): Map<any, any>;
+    /**
+     * 设置物品的最大堆叠数量组件。
+     * @param {Number} maxStackSize - 最大堆叠数量，默认值为 64。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setMaxStackSize(maxStackSize?: number): Map<any, any>;
+    /**
+     * 设置物品的投射物组件。
+     * @param {Number} [minimumCriticalPower] - 投射物需要蓄力多久才能造成暴击。
+     * @param {String} [projectileEntity] - 作为投射物发射的实体名称。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setProjectile(minimumCriticalPower?: number, projectileEntity?: string): Map<any, any>;
+    /**
+     * 设置物品的使用修饰组件。
+     * @param {Number} [movementModifier] - 使用物品时玩家移动速度的缩放值。
+     * @param {Number} [useDuration] - 物品使用所需的时间（秒）。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setUseModifiers(movementModifier?: number, useDuration?: number): Map<any, any>;
+    /**
+     * 设置物品的可穿戴组件。
+     * @param {Number} [protection=0] - 物品提供的保护值。
+     * @param {String} [slot] - 物品可以穿戴的槽位（如 "head"、"chest" 等）。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setWearable(protection?: number, slot?: string): Map<any, any>;
+    /**
+    * 设置物品的使用动画组件。
+    * @param {String} animation - 物品使用时的动画类型（如 "eat"、"drink" 等）。
+    * @returns {Map} - 新的组件集合。
+    * @throws {Error} - 如果 animation 不是字符串类型。
+    */
+    static setUseAnimation(animation: string): Map<any, any>;
+    /**
+     * 将多个组件集合合并为一个。
+     * @param {...Map} componentMaps - 多个组件集合。
+     * @returns {Map} - 合并后的组件集合。
+     */
+    static combineComponents(...componentMaps: Map<any, any>[]): Map<any, any>;
+    /**
+     * 获取当前组件的 JSON 表示。
+     * @param {Map} components - 组件集合。
+     * @returns {Object} - 组件的 JSON 对象。
+     */
+    static toJSON(components: Map<any, any>): any;
+}

package/dist/core/item/itemComponents.js

@@ -0,0 +1,225 @@
+export class ItemComponent {
+    /**
+     * 物品的耐久度组件
+     * @param {number} max_durability 最大耐久
+     * @param {number} damage_chance_min 损坏最小几率
+     * @param {number} damage_chance_max 损坏最大几率
+     * @returns {ItemComponent}
+     */
+    static setDurability(max_durability, damage_chance_min = 0, damage_chance_max = 100) {
+        return new Map().set("minecraft:durability", {
+            "damage_chance": {
+                "min": damage_chance_min,
+                "max": damage_chance_max
+            },
+            "max_durability": max_durability
+        });
+    }
+    static setBlockPlacer(block, replace_block_item, use_on) {
+        return new Map().set("minecraft:block_placer", {
+            block: block,
+            replace_block_item: replace_block_item,
+            use_on: use_on
+        });
+    }
+    /**
+  *
+  * @param {Array} custom_components
+  * @returns
+  */
+    static setCustomComponents(custom_components) {
+        return new Map().set("minecraft:custom_components", [...custom_components]);
+    }
+    /**
+     * 设置物品的可投掷组件。
+     * @param {Boolean} doSwingAnimation - 是否使用挥动动画。
+     * @param {Number} launchPowerScale - 投掷力量的缩放比例。
+     * @param {Number} maxDrawDuration - 最大蓄力时间。
+     * @param {Number} maxLaunchPower - 最大投掷力量。
+     * @param {Number} minDrawDuration - 最小蓄力时间。
+     * @param {Boolean} scalePowerByDrawDuration - 投掷力量是否随蓄力时间增加。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setThrowable(doSwingAnimation = false, launchPowerScale = 1.0, maxDrawDuration = 0.0, maxLaunchPower = 1.0, minDrawDuration = 0.0, scalePowerByDrawDuration = false) {
+        return new Map().set("minecraft:throwable", {
+            do_swing_animation: doSwingAnimation,
+            launch_power_scale: launchPowerScale,
+            max_draw_duration: maxDrawDuration,
+            max_launch_power: maxLaunchPower,
+            min_draw_duration: minDrawDuration,
+            scale_power_by_draw_duration: scalePowerByDrawDuration,
+        });
+    }
+    /**
+     * 设置物品的显示名称。
+     * @param {String} displayName - 显示名称或本地化键。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setDisplayName(displayName) {
+        if (typeof displayName !== "string") {
+            throw new Error('显示名称必须是字符串类型');
+        }
+        return new Map().set("minecraft:display_name", { value: displayName });
+    }
+    /**
+     * 设置物品的食物组件。
+     * @param {Boolean} canAlwaysEat - 是否随时可以食用。
+     * @param {Number} nutrition - 营养值。
+     * @param {Number} saturationModifier - 饱和度修正值。
+     * @param {String} [usingConvertsTo] - 食用后转换的目标物品。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setFoodComponent(canAlwaysEat, nutrition, saturationModifier, usingConvertsTo) {
+        return new Map().set("minecraft:food", {
+            can_always_eat: canAlwaysEat,
+            nutrition: nutrition || 0,
+            saturation_modifier: saturationModifier || 0.6,
+            using_converts_to: usingConvertsTo || undefined,
+        });
+    }
+    /**
+     * 设置物品的燃料组件。
+     * @param {Number} duration - 燃料燃烧的持续时间（秒），最小值为 0.05。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setFuel(duration) {
+        if (typeof duration !== "number" || duration < 0.05) {
+            throw new Error('燃料持续时间必须是一个大于或等于 0.05 的数字');
+        }
+        return new Map().set("minecraft:fuel", { duration });
+    }
+    /**
+     * 设置物品的附魔光效组件。
+     * @param {Boolean} hasGlint - 是否显示附魔光效。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setGlint(hasGlint) {
+        if (typeof hasGlint !== "boolean") {
+            throw new Error('附魔光效值必须是布尔类型');
+        }
+        return new Map().set("minecraft:glint", hasGlint);
+    }
+    /**
+     * 设置物品的手持渲染方式组件。
+     * @param {Boolean} isHandEquipped - 是否像工具一样渲染。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setHandEquipped(isHandEquipped) {
+        if (typeof isHandEquipped !== "boolean") {
+            throw new Error('手持渲染方式值必须是布尔类型');
+        }
+        return new Map().set("minecraft:hand_equipped", isHandEquipped);
+    }
+    /**
+     * 设置物品的图标组件。
+     * @param {String} texture - 图标纹理名称。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setIcon(texture) {
+        if (typeof texture !== "string") {
+            throw new Error('图标纹理必须是字符串类型');
+        }
+        return new Map().set("minecraft:icon", texture);
+    }
+    /**
+     * 设置物品的最大堆叠数量组件。
+     * @param {Number} maxStackSize - 最大堆叠数量，默认值为 64。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setMaxStackSize(maxStackSize = 64) {
+        if (typeof maxStackSize !== "number" || maxStackSize <= 0 || !Number.isInteger(maxStackSize)) {
+            throw new Error('最大堆叠数量必须是正整数');
+        }
+        return new Map().set("minecraft:max_stack_size", maxStackSize);
+    }
+    /**
+     * 设置物品的投射物组件。
+     * @param {Number} [minimumCriticalPower] - 投射物需要蓄力多久才能造成暴击。
+     * @param {String} [projectileEntity] - 作为投射物发射的实体名称。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setProjectile(minimumCriticalPower, projectileEntity) {
+        const projectileComponent = {};
+        if (minimumCriticalPower !== undefined) {
+            if (typeof minimumCriticalPower !== "number" || minimumCriticalPower < 0) {
+                throw new Error('minimumCriticalPower 必须是非负数');
+            }
+            projectileComponent.minimum_critical_power = minimumCriticalPower;
+        }
+        if (projectileEntity !== undefined) {
+            if (typeof projectileEntity !== "string") {
+                throw new Error('projectileEntity 必须是字符串类型');
+            }
+            projectileComponent.projectile_entity = projectileEntity;
+        }
+        return new Map().set("minecraft:projectile", projectileComponent);
+    }
+    /**
+     * 设置物品的使用修饰组件。
+     * @param {Number} [movementModifier] - 使用物品时玩家移动速度的缩放值。
+     * @param {Number} [useDuration] - 物品使用所需的时间（秒）。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setUseModifiers(movementModifier, useDuration) {
+        const useModifiersComponent = {};
+        if (movementModifier !== undefined) {
+            if (typeof movementModifier !== "number") {
+                throw new Error('movementModifier 必须是数字类型');
+            }
+            useModifiersComponent.movement_modifier = movementModifier;
+        }
+        if (useDuration !== undefined) {
+            if (typeof useDuration !== "number" || useDuration < 0) {
+                throw new Error('useDuration 必须是非负数');
+            }
+            useModifiersComponent.use_duration = useDuration;
+        }
+        return new Map().set("minecraft:use_modifiers", useModifiersComponent);
+    }
+    /**
+     * 设置物品的可穿戴组件。
+     * @param {Number} [protection=0] - 物品提供的保护值。
+     * @param {String} [slot] - 物品可以穿戴的槽位（如 "head"、"chest" 等）。
+     * @returns {Map} - 新的组件集合。
+     */
+    static setWearable(protection = 0, slot) {
+        const wearableComponent = { protection };
+        if (slot !== undefined) {
+            if (typeof slot !== "string") {
+                throw new Error('slot 必须是字符串类型');
+            }
+            wearableComponent.slot = slot;
+        }
+        return new Map().set("minecraft:wearable", wearableComponent);
+    }
+    /**
+    * 设置物品的使用动画组件。
+    * @param {String} animation - 物品使用时的动画类型（如 "eat"、"drink" 等）。
+    * @returns {Map} - 新的组件集合。
+    * @throws {Error} - 如果 animation 不是字符串类型。
+    */
+    static setUseAnimation(animation) {
+        // 检查 animation 是否为字符串
+        if (typeof animation !== "string") {
+            throw new Error('animation 必须是字符串类型');
+        }
+        // 返回包含动画设置的 Map 对象
+        return new Map().set("minecraft:use_animation", animation);
+    }
+    /**
+     * 将多个组件集合合并为一个。
+     * @param {...Map} componentMaps - 多个组件集合。
+     * @returns {Map} - 合并后的组件集合。
+     */
+    static combineComponents(...componentMaps) {
+        return new Map(componentMaps.flatMap(map => [...map]));
+    }
+    /**
+     * 获取当前组件的 JSON 表示。
+     * @param {Map} components - 组件集合。
+     * @returns {Object} - 组件的 JSON 对象。
+     */
+    static toJSON(components) {
+        return Object.fromEntries(components);
+    }
+}

package/dist/core/registry.d.ts

@@ -0,0 +1,12 @@
+export class GRegistry {
+    static dataList: any[];
+    /**
+     * 生成注册器
+     * @param {string} name 文件名字
+     * @param {string} root 根目录，如 "behavior"、"resource" 等
+     * @param {string} path 数据的路径，如 "blocks/"、"items/"、"recipes/" 等
+     * @param {string} data 实例 必须包含 toJson 方法
+     */
+    static register(name: string, root: string, path: string, data: string): void;
+    static getDataList(): any[];
+}

package/dist/core/registry.js

@@ -0,0 +1,16 @@
+export class GRegistry {
+    static dataList = [];
+    /**
+     * 生成注册器
+     * @param {string} name 文件名字
+     * @param {string} root 根目录，如 "behavior"、"resource" 等
+     * @param {string} path 数据的路径，如 "blocks/"、"items/"、"recipes/" 等
+     * @param {string} data 实例 必须包含 toJson 方法
+     */
+    static register(name, root, path, data) {
+        GRegistry.dataList.push({ name, root, path, data });
+    }
+    static getDataList() {
+        return [...GRegistry.dataList];
+    }
+}

package/dist/core/texture.d.ts

@@ -0,0 +1,18 @@
+export class ItemTextureManager {
+    static item_texture_sets: Map<any, any>;
+    static getItemTextureSet(): Map<any, any>;
+    static getItemTextures(): any;
+    static registerTextureData(texture_name: any, texture_data: any): void;
+    static registerTexture(texture_name: any, texture_path: any): void;
+}
+export class terrainTextureManager {
+    static terrain_texture_sets: Map<any, any>;
+    static getTerrainTextureSet(): Map<any, any>;
+    static getTerrainTextures(): any;
+    static registerTextureData(texture_name: any, texture_data: any): void;
+    static registerTexture(texture_name: any, texture_path: any): void;
+}
+export namespace FlipbookTextures {
+    let flipbook_textures: any[];
+    function registerFlipbookTexture(atlas_tile: any, texture: any, ticks_per_frame: any, options?: {}): void;
+}

package/dist/core/texture.js

@@ -0,0 +1,38 @@
+export class ItemTextureManager {
+    static item_texture_sets = new Map();
+    static getItemTextureSet() {
+        return this.item_texture_sets;
+    }
+    static getItemTextures() {
+        return Object.fromEntries(this.item_texture_sets);
+    }
+    static registerTextureData(texture_name, texture_data) {
+        this.item_texture_sets.set(texture_name, texture_data);
+    }
+    static registerTexture(texture_name, texture_path) {
+        this.registerTextureData(texture_name, { textures: texture_path });
+    }
+}
+export class terrainTextureManager {
+    static terrain_texture_sets = new Map();
+    static getTerrainTextureSet() {
+        return this.terrain_texture_sets;
+    }
+    static getTerrainTextures() {
+        return Object.fromEntries(this.terrain_texture_sets);
+    }
+    static registerTextureData(texture_name, texture_data) {
+        this.terrain_texture_sets.set(texture_name, texture_data);
+    }
+    static registerTexture(texture_name, texture_path) {
+        this.registerTextureData(texture_name, { textures: texture_path });
+    }
+}
+export const FlipbookTextures = {
+    flipbook_textures: [],
+    registerFlipbookTexture(atlas_tile, texture, ticks_per_frame, options = {}) {
+        const flipbook_texture = { "atlas_tile": atlas_tile, "flipbook_texture": texture, ticks_per_frame };
+        Object.assign(flipbook_texture, options);
+        this.flipbook_textures.push(flipbook_texture);
+    }
+};

package/dist/core/ui/buttonMapping.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ButtonMapping 类
+ *
+ * 该类表示按钮映射配置，用于定义输入事件的映射关系。
+ *
+ * 属性：
+ * - ignored: boolean - 是否忽略映射（默认值：false）
+ * - from_button_id: string - 触发事件的按钮 ID
+ * - to_button_id: string - 事件触发时执行的按钮 ID
+ * - mapping_type: enum - 映射类型（可能值：global, pressed, double_pressed, focused）
+ * - scope: enum - 映射范围（可能值：view, controller）
+ * - input_mode_condition: enum - 输入模式条件（可能值：not_gaze, not_gamepad, gamepad_and_not_gaze）
+ * - ignore_input_scope: boolean - 是否忽略输入范围
+ * - consume_event: boolean - 是否消耗事件
+ * - handle_select: boolean - 是否处理选择事件
+ * - handle_deselect: boolean - 是否处理取消选择事件
+ * - button_up_right_of_first_refusal: boolean - 是否在首次拒绝后处理按钮释放事件
+ */
+export class ButtonMapping {
+    ignored: boolean;
+    from_button_id: string;
+    to_button_id: string;
+    mapping_type: string;
+    scope: string;
+    input_mode_condition: string;
+    ignore_input_scope: boolean;
+    consume_event: boolean;
+    handle_select: boolean;
+    handle_deselect: boolean;
+    button_up_right_of_first_refusal: boolean;
+    /**
+     * 设置是否忽略映射。
+     * @param {boolean} ignored - 是否忽略映射（默认值：false）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setIgnored(ignored?: boolean): ButtonMapping;
+    /**
+     * 设置触发事件的按钮 ID。
+     * @param {string} fromButtonId - 触发事件的按钮 ID
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setFromButtonId(fromButtonId: string): ButtonMapping;
+    /**
+     * 设置事件触发时执行的按钮 ID。
+     * @param {string} toButtonId - 事件触发时执行的按钮 ID
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setToButtonId(toButtonId: string): ButtonMapping;
+    /**
+     * 设置映射类型。
+     * @param {string} mappingType - 映射类型（可能值：global, pressed, double_pressed, focused）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setMappingType(mappingType: string): ButtonMapping;
+    /**
+     * 设置映射范围。
+     * @param {string} scope - 映射范围（可能值：view, controller）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setScope(scope: string): ButtonMapping;
+    /**
+     * 设置输入模式条件。
+     * @param {string} condition - 输入模式条件（可能值：not_gaze, not_gamepad, gamepad_and_not_gaze）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setInputModeCondition(condition: string): ButtonMapping;
+    /**
+     * 设置是否忽略输入范围。
+     * @param {boolean} ignore - 是否忽略输入范围
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setIgnoreInputScope(ignore?: boolean): ButtonMapping;
+    /**
+     * 设置是否消耗事件。
+     * @param {boolean} consume - 是否消耗事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setConsumeEvent(consume?: boolean): ButtonMapping;
+    /**
+     * 设置是否处理选择事件。
+     * @param {boolean} handle - 是否处理选择事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setHandleSelect(handle?: boolean): ButtonMapping;
+    /**
+     * 设置是否处理取消选择事件。
+     * @param {boolean} handle - 是否处理取消选择事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setHandleDeselect(handle?: boolean): ButtonMapping;
+    /**
+     * 设置是否在首次拒绝后处理按钮释放事件。
+     * @param {boolean} handle - 是否处理按钮释放事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setButtonUpRightOfFirstRefusal(handle?: boolean): ButtonMapping;
+}

package/dist/core/ui/buttonMapping.js

@@ -0,0 +1,132 @@
+/**
+ * ButtonMapping 类
+ *
+ * 该类表示按钮映射配置，用于定义输入事件的映射关系。
+ *
+ * 属性：
+ * - ignored: boolean - 是否忽略映射（默认值：false）
+ * - from_button_id: string - 触发事件的按钮 ID
+ * - to_button_id: string - 事件触发时执行的按钮 ID
+ * - mapping_type: enum - 映射类型（可能值：global, pressed, double_pressed, focused）
+ * - scope: enum - 映射范围（可能值：view, controller）
+ * - input_mode_condition: enum - 输入模式条件（可能值：not_gaze, not_gamepad, gamepad_and_not_gaze）
+ * - ignore_input_scope: boolean - 是否忽略输入范围
+ * - consume_event: boolean - 是否消耗事件
+ * - handle_select: boolean - 是否处理选择事件
+ * - handle_deselect: boolean - 是否处理取消选择事件
+ * - button_up_right_of_first_refusal: boolean - 是否在首次拒绝后处理按钮释放事件
+ */
+export class ButtonMapping {
+    constructor() {
+        this.ignored = false;
+        this.from_button_id = '';
+        this.to_button_id = '';
+        this.mapping_type = null;
+        this.scope = null;
+        this.input_mode_condition = null;
+        this.ignore_input_scope = false;
+        this.consume_event = false;
+        this.handle_select = false;
+        this.handle_deselect = false;
+        this.button_up_right_of_first_refusal = false;
+    }
+    /**
+     * 设置是否忽略映射。
+     * @param {boolean} ignored - 是否忽略映射（默认值：false）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setIgnored(ignored = false) {
+        this.ignored = ignored;
+        return this;
+    }
+    /**
+     * 设置触发事件的按钮 ID。
+     * @param {string} fromButtonId - 触发事件的按钮 ID
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setFromButtonId(fromButtonId) {
+        this.from_button_id = fromButtonId;
+        return this;
+    }
+    /**
+     * 设置事件触发时执行的按钮 ID。
+     * @param {string} toButtonId - 事件触发时执行的按钮 ID
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setToButtonId(toButtonId) {
+        this.to_button_id = toButtonId;
+        return this;
+    }
+    /**
+     * 设置映射类型。
+     * @param {string} mappingType - 映射类型（可能值：global, pressed, double_pressed, focused）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setMappingType(mappingType) {
+        this.mapping_type = mappingType;
+        return this;
+    }
+    /**
+     * 设置映射范围。
+     * @param {string} scope - 映射范围（可能值：view, controller）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setScope(scope) {
+        this.scope = scope;
+        return this;
+    }
+    /**
+     * 设置输入模式条件。
+     * @param {string} condition - 输入模式条件（可能值：not_gaze, not_gamepad, gamepad_and_not_gaze）
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setInputModeCondition(condition) {
+        this.input_mode_condition = condition;
+        return this;
+    }
+    /**
+     * 设置是否忽略输入范围。
+     * @param {boolean} ignore - 是否忽略输入范围
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setIgnoreInputScope(ignore = false) {
+        this.ignore_input_scope = ignore;
+        return this;
+    }
+    /**
+     * 设置是否消耗事件。
+     * @param {boolean} consume - 是否消耗事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setConsumeEvent(consume = false) {
+        this.consume_event = consume;
+        return this;
+    }
+    /**
+     * 设置是否处理选择事件。
+     * @param {boolean} handle - 是否处理选择事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setHandleSelect(handle = false) {
+        this.handle_select = handle;
+        return this;
+    }
+    /**
+     * 设置是否处理取消选择事件。
+     * @param {boolean} handle - 是否处理取消选择事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setHandleDeselect(handle = false) {
+        this.handle_deselect = handle;
+        return this;
+    }
+    /**
+     * 设置是否在首次拒绝后处理按钮释放事件。
+     * @param {boolean} handle - 是否处理按钮释放事件
+     * @returns {ButtonMapping} 返回当前实例以支持链式调用
+     */
+    setButtonUpRightOfFirstRefusal(handle = false) {
+        this.button_up_right_of_first_refusal = handle;
+        return this;
+    }
+}