猹件开发组

Appearance

On this page

猹の技能 ​

技能制作 ​

本节将介绍如何创建技能、技能文件的构成方式，以及常用的编排技巧，帮助你更快掌握技能编写逻辑，打造属于你服务器的独特技能体系。

技能构成 ​

每一个技能都是一个独立的 YAML 文件，位于插件目录的 /skill 文件夹下。每个技能配置包含以下核心字段：

字段名说明
id技能的唯一标识，建议使用英文或拼音命名，不能重复
display技能名称（用于界面展示，可使用颜色代码）
permission使用技能所需权限节点
onReady技能准备完成后的触发组件（如 CROUCH_START、CAST 等）
onCast技能实际释放时的执行流程（使用逻辑控件串联组件）
components技能组件池，定义本技能所使用的所有组件（触发器、选择器、效果器、条件等）

一个典型技能的 YAML 结构如下：

yml
id: "heal"
display: "§a回复术§r"
permission: "chaeraskill.回复术"
onReady: "trigger"
onCast: "selector, heal"
components:
  trigger:
    type: "TRIGGER#CAST"
  selector:
    type: "SELECTOR#SELF"
  heal:
    type: "MECHANIC#HEAL"
    value: 5

创建技能 ​

你可以通过以下两种方式创建新技能：

✅ 方式一：使用可视化编辑器（推荐） ​

  1. 启动服务器并加载 `ChaEraSkill` 插件；
  2. 控制台会提示网页编辑器地址（如 `http://localhost:8088`）；
  3. 打开网页进入编辑器，可视化创建技能与组件；
  4. 编辑器支持技能实时保存与加载，左下角可点击“测试技能”。

如需查看编辑器界面说明，请参考：技能编辑器使用文档

✅ 方式二：手动编写 YAML ​

  1. 在 `plugins/ChaEraSkill/skill/` 文件夹中创建 `.yml` 文件；
  2. 按上述格式填写技能内容；
  3. 重启或使用指令 `/ChaEraSkill reload` 即可加载技能。

制作技巧 ​

🎯 常用逻辑控件 ​

控件功能
THEN(A, B, ...)依次顺序执行 A、B等组件
WHEN(A, B，...)同时执行 A、B等组件
IF(condition, A, B)condition 为真执行 A，否则执行 B
FOR(delay, effect).TIMES(5)循环执行子组件 N 次
ITERATOR(selector, effect)遍历 selector 选中的目标，每个目标执行一次

🔄 技能生命周期推荐写法 ​

技能类型推荐 onReady + onCast 写法
一键释放技能onReady: trigger，onCast: THEN:(selector, mechanic)
连锁蓄力技onReady: CROUCH_START，onCast: TIMER + CROUCH_STOP + IF逻辑
连点/组合键技多个 CROUCH + INTERACT 触发器配合使用
范围技选择器使用 AREA 或 CONE，并通过 FOR 或 ITERATOR 多次命中

🔧 实用建议 ​

  • ✅ 编写复杂技能时建议先写最基础版本，逐步调试添加逻辑；
  • ✅ 每个组件建议独立命名，避免命名冲突；
  • ✅ 合理使用变量与冷却机制，提升技能的交互体验；
  • ✅ 搭配 猹のBUFF、猹の技能引导 等插件可解锁更多组合玩法！

示例技能合集 ​

你可以在技能用例中查看多个完整技能案例，包括：

  • ✅ 蓄力跳
  • ⚡ 闪电链
  • 💉 放血疗法
  • 💥 爆裂魔法
  • 🍀 回复术
  • 🎯 射击
  • 👤 隐匿术
  • 🔥 直伤法术

如需详细组件参数说明，请查阅以下组件文档：