在QClaw中添加自定义技能需编写符合QClawSkill格式的JSON配置文件，包含唯一id、触发条件（按键/状态/事件）、动作序列（移动/特效/伤害）、资源路径及兼容性声明，并将文件置于user/skills/目录后通过编辑器验证加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在QClaw中为角色添加自定义技能，需通过编写QClawSkill格式的技能配置文件并将其正确加载。以下是创建专属技能的具体操作流程：
一、准备技能配置文件结构
QClawSkill技能文件为JSON格式，必须包含基础元数据字段与行为逻辑定义。缺失必要键值将导致技能加载失败或无法触发。
1、新建纯文本文件，扩展名设为“.json”，例如“fireball_skill.json”。
2、在文件首行写入标准头部信息：{"type": "QClawSkill", "version": "1.0"}。
3、在头部后添加name、id、trigger三个必填字段，其中id必须全局唯一且仅含小写字母、数字与下划线。
二、定义技能触发条件与参数
触发器（trigger）决定技能何时被激活，支持按键绑定、状态检测、事件监听三种模式，每种模式对应不同字段组合。
1、若使用按键触发，在trigger对象中设置mode: "key"，并指定key_code（如"Space"或"MouseLeft"）。
2、若依赖角色状态，在trigger中设mode: "state"，并添加require_state: ["on_ground", "is_crouching"]数组。
3、若响应系统事件，在trigger中设mode: "event"，并填写event_name: "on_enemy_hit"。
三、编写技能动作序列
动作序列（actions）是技能执行的核心，由按顺序执行的原子动作对象组成，每个动作必须声明type与对应参数。
1、添加位移动作：插入一个对象，{"type": "move", "direction": "forward", "distance": 80, "speed": 300}。
2、添加特效动作：插入一个对象，{"type": "effect", "asset": "fx_fireball", "offset_x": 24, "offset_y": -16}。
3、添加伤害判定动作：插入一个对象，{"type": "damage", "value": 25, "hitbox": {"w": 40, "h": 40, "x": 32, "y": 0}}。
四、配置技能资源路径与兼容性
所有引用的资源（如特效、音效、动画）路径必须相对于QClaw的resources/根目录声明，且需确保文件实际存在。
1、检查resources/effects/fx_fireball.atlas与.png是否成对存在于对应子目录。
2、在技能配置顶层添加resources字段，列出全部依赖项：{"effects": ["fx_fireball"], "sounds": ["sfx_fireball_launch"]}。
3、添加compatibility字段，明确支持的QClaw主版本号范围：{"min_version": "2.4.0", "max_version": "2.4.*"}。
五、部署与验证配置文件
配置文件需置于特定目录才能被QClaw识别，路径错误将导致技能不显示于编辑器或运行时被跳过。
1、将完成的JSON文件复制到游戏安装目录下的user/skills/子文件夹（若不存在则手动创建）。
2、启动QClaw编辑器，进入“技能管理”面板，点击刷新按钮，确认新技能ID出现在列表中。
3、在角色技能栏中拖拽该技能图标至快捷栏任意位置，保存角色配置后重启测试场景。
