> For the complete documentation index, see [llms.txt](https://liyi2015.gitbook.io/magicgem/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://liyi2015.gitbook.io/magicgem/advance/skills.md). # 宝石技能 技能配置方法 ## **基本配置** * 宝石技能保存在配置文件夹的skills目录下 * 以yml形式储存，**一段一个技能，段名就是技能名** * 识别方式：支持四种识别方式 1. 不做任何配置：用宝石奖励SkillAdd打在装备上的技能，默认是NBT识别 2. Lore：填写要识别的Lore，武器上有这个Lore时就能够放技能 * **注意，识别无视颜色且只识别前缀** * 也就是说，如果一个Lore是 技能I，另一个是 技能II * 则技能II总是会被识别为技能I，因为 * 技能II = 技能I + I * **总而言之，技能的识别Lore文字不能互为前缀，否则只识别短的那个技能。** * **这一设计是因为药水BUFF的同一个Lore前缀对应多个等级的药水的缘故，还请理解** 3. Display：装备显示名 * 支持颜色代码& 4. MythicType：识别MMC武器 * 这个标签是MythicCrucible自动加在装备上的标签 * MM版本4.13以下，需要在MM武器上写一个空的Skills，才会产生这个标签 * Slot：字符串或字符串列表，限制技能只能在哪些槽位上发动。 * 槽位的写法与宝石FastUse格式完全相同 * Success：技能发动成功率**表达式**，与宝石成功率写法完全相同 * SuccessTip：技能发动成功的提示信息，与宝石提示信息写法完全相同。如果不写就没有信息 * FailTip：技能发动失败的提示信息，同上 * Cooldown：技能冷却时间，单位为秒 * CooldownTip：冷却时间提示，格式为 * ``` 位置{p=提示前缀;s=提示后缀;empty=空进度格子样式;full=满进度格子样式;length=进度条长度} ``` * 其中位置同样可以选择ActionBar（动作栏）、Chat（聊天框）、Title（标题） * **提示后缀必须要包含浮点数占位符%.nf** * 例如，如下配置会在玩家动作栏显示 * 技能冷却时间:||||||||||||||||||| x.xx秒 * ``` CooldownTip: ActionBar{p=&a技能冷却时间;s=&a%.2fs;empty=&f|;full=&a|;length=75} ``` * Duration：**持续时间技能专用**，指定这项后，技能中必须要有TimeStartSkill来启动持续时间。单位为秒。 * Skills：字符串列表，与MythicMobs技能类似，一行一个技能 * Conditions：字符串列表，技能施法者条件，与MythicMobs条件类似，一行一个条件 * TriggerConditions：字符串列表，技能触发者条件，与MythicMobs条件类似，一行一个条件 * TargetConditions：字符串列表，技能目标条件，与MythicMobs条件类似，一行一个条件 * **本插件完全兼容MM技能。你可以直接把技能挪到宝石装备库中** ## **触发器** * 宝石技能有54个触发器，并且支持复合触发信息 * 与MythicMobs一样，触发器均以短波浪线+on开头，跟在技能后面 * **复合触发信息的使用方式为\~on触发器:可触发信息1;可触发信息2;...** * 用冒号紧跟触发器，不要加空格 * 用分号分隔每个触发信息 * 例如\~onKill:PIG;COW 触发器就能被杀死猪或者牛触发 * 下面是每个触发器和详细说明 | 触发器 | 触发事件 | 复合触发信息 | | ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------------- | | Jump | 跳跃 | | | Signal | 指令/mgem signal | 信号名 | | Counter | 计数技能发动 | 计数技能tag | | ShiftSwing | Shift+左键 | | | ShiftUse | Shift+右键使用物品 | | | ShiftRightClick | Shift+右键空地 | | | KillEntity | 杀死实体 | 杀死的生物类型 | | KillMythicMobs | 杀死MythicMobs怪物 | MythicMobs怪物名 | | DamagedProjectile | 被投射物打伤 | 射箭生物类型 | | DamagedBlock | 被方块弄伤 | 伤害类型， [详见网址](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html) | | DamagedEntity | 被实体攻击受伤 | 攻击者生物类型 | | Drop | 丢物品 | 物品材料名 | | TridentHit | 三叉戟**落地** | | | Hit | 投射物**落地** | 投射物类型 | | BowHit | 弓箭打伤生物 | 目标生物类型 | | TridentAttack | 三叉戟打伤生物 | 目标生物类型 | | SnowballAttack | 雪球打伤生物 | 目标生物类型 | | FireballAttack | 火焰弹打伤生物 | 目标生物类型 | | ProjectileAttack | 投射物打伤生物 | 目标生物类型 | | Combat | 战斗（攻击、受伤） | 涉及的生物类型 | | Teleport | 传送触发 | | | Block | 放置方块 | | | TridentThrow | 投掷三叉戟 | | | Despawn | 死亡或退出游戏 | | | Tame | 驯服生物 | 驯服的生物类型 | | Attack | 攻击 | 目标生物类型 | | Shoot | 射箭 | | | BlockPlace | 放置方块 | | | BlockBreak | 破坏方块 | 破坏的方块类型 | | Consume | 食用/消耗物品 | | | Crouch | 蹲下 | | | Uncrouch | 起身 | | | Damaged | 受伤 | 攻击者生物类型或伤害类型 | | Death | 死亡 | | | Interact | 与实体交互 | 目标实体类型 | | Kill | 杀死生物 | 目标生物类型 | | KillPlayer | 杀死玩家 | | | Spawn | 玩家进入游戏或复活 | | | SplashPotion | 投扔喷溅或滞留药水 | | | Swing | 左键 | | | Use | 右键使用 | | | RightClick | 右键空地 | | | Timer | 定时技能 | 每多少Ticks触发一次 | | Fish | 一切钓鱼事件 | 钓到东西的种类（如果有的话） | | FishBite | 鱼或者实体咬钩 | 钓到东西的种类（如果有的话） | | FishCatchFish | 钓起鱼 | 钓到东西的种类（如果有的话） | | FishCatchEntity | 钓起实体 | 钓到东西的种类（如果有的话） | | FishGround | 钓钩命中方块 | | | FishReel | 收回空钩 | | | FishFail | 有鱼咬钩但没钓到 | | | ArmorEquip | 穿上装备 | | | ArmorUnequip | 脱下装备 | | ## **内置技能** * **注意1：内置技能必须写在宝石技能库中** * **注意2：MM目标选择器对内置技能无效，内置技能有它自己的目标** 1. **宝石奖励** 套娃一切宝石奖励 ``` - Reward{宝石奖励} ``` * 宝石奖励与前面的写法完全一致 * 物品奖励会打在发动技能的装备上 * 玩家奖励会施加给发动技能的玩家 2. **切换技能** 为同一个装备切换不同技能 ``` - Switch{技能1;技能2;技能3} ``` * 只会对触发技能的装备生效 * 每触发一次，就会切换到下一个技能，原先的技能失效。循环往复。 * 只能切换NBT识别的（用宝石SkillAdd打上去的）技能，不能切换Lore识别的技能 3. **可切换奖励** 配合切换技能使用，切换到这个技能组时执行奖励，切走的时候执行拆卸 ``` - RewardSwitch{宝石奖励} ``` * 只会对触发技能的装备生效 * 例如 - RewardSwitch{Enchant{name=DAMAGE\_ALL;level=10}} * 则用 - Switch切换到这个技能组时，武器锋利+10；切出时武器锋利-10 4. **药水技能** 给玩家持续性的原版药水Buff ``` - PotionBuff{type=药水名;level=等级表达式;duration=持续时间秒数表达式;refresh=刷新时间秒数;roman=罗马数字识别} $世界名1:上限1 $世界名2:上限2 @目标 ``` * type有别名potion，p，name * level有别名l，duration有别名d * roman为true时识别罗马数字 * 药水BUFF只能有两种目标：@self 和 @target * 触发器推荐用onTimer * 相比用MM制作药水BUFF，使用这个技能有如下的显著优势： 1. 可以根据装备上的Lore动态读取药水buff等级，无需每种等级写一个技能 2. 可以设置刷新时间，如果剩余的时间高于这个时间就不刷新 * 避免反复的伤害吸收、频繁的生命提升 3. 可以正确处理覆盖，低等级BUFF不会覆盖高等级药水 4. 可以设置世界药水限制，在指定的世界药水等级自动被压制到某一等级 5. 异步生效，不卡服 5. **闪现技能** 顾名思义，瞬移到目标地点 ``` - Blink{distance=距离上限表达式} @目标 ``` * 目标有九种可选 | **@entity** | **闪现到命中的实体** | **@down** | **向下闪现** | | ------------- | ------------ | ---------- | -------- | | **@location** | **闪现到目标地点** | **@left** | **向左闪现** | | **@foward** | **向前闪现** | **@right** | **向右闪现** | | **@backward** | **向后闪现** | **@bed** | **向床闪现** | | **@up** | **向上闪现** | | | * 其中location和forward最常用 * 相比MM技能，本技能可以**一行写闪现** 6. **持续时间技能** * **当且仅当技能指定了Duration时有效** * 在未开始计时的时候，整个技能都不可使用 * 你必须写一个开始计时技能才能启动整个技能 ``` - TimeStart{tip=技能开始的提示} ``` * 技能开始提示也支持ActionBar 、Chat、Title，格式和宝石奖励的一样 * 持续时间技能一旦开始，技能组里的其它技能都变得可用且没有冷却 * 技能一旦开始，持续时间内不能再次开始 * 你可以再写一个技能来**增加持续时间** ``` - TimeAdd{time=要增加的秒数表达式;tip=提示信息} ``` * 从而做到杀人杀怪增加持续时间 * 持续时间结束后技能继续冷却 * 注意，**持续时间内技能的冷却也在计算**，因此加的太多，技能就没有冷却了 * 相比用MM计分板，本技能的好处在于可以**方便地增加时长** 7. **DEBUFF技能** 给目标玩家或者生物加上Debuff ``` - Debuff{type=类型;duration=持续时间秒数表达式} @目标 ``` * 目标只能是@self和@target * type类型有十一种可以选择 | 名称 | 作用 | 名称 | 作用 | | ------- | --------- | ---------- | -------- | | USE | 禁止使用物品 | ATTACK | 禁止造成伤害 | | SHOOT | 禁止射箭 | JUMP | 禁止跳跃 | | FLY | 禁飞 | MOVE | 禁止移动 | | BREAK | 禁止破坏方块 | PLACE | 禁止放置 | | HEAL | 禁止生命恢复 | TELEPORT | 禁止传送 | | SKILL | 禁止使用宝石技能 | POTIONBUFF | 禁止药水效果刷新 | | CONSUME | 禁止食用或消耗物品 | | | * 所有Debuff对玩家有效 * Attack，Shoot，Heal，Teleport对生物有效 * Paper系列端1.16.以上，Jump对生物也有效 8. **吸血技能** 百分比吸血 ``` - BloodSuck{factor=吸血系数表达式} ``` * factor有别名f，k * 必须是有伤害的事件才能附带吸血，因此请使用\~onAttack之类的触发器 * 吸血系数表达式计算出的系数会被直接乘到伤害上。 * 如 BlookSuck{k=0.1} \~onAttack 代表一切攻击附带10%吸血 * 相比MM吸血技能，**本技能不会给玩家额外的MCMMO经验** 9. **计数技能** 记录触发器触发的次数，次数满足一定条件则触发技能 ``` - Counter{condition=逻辑公式;dynamic=变量表达式;persist=是否永久计数;tag=计数器名称;allslot=是否触发全身格子的计数技能} ``` * condition有别名c，dynamic有别名d，persist有别名p * 逻辑公式是一个为true或为false的表达式，**其中必须有变量v**，代表触发的次数 * 如 v%3==0 表示判断v对3取余数，余数为0 * 逻辑公式里面可以使用变量d，d是物品变量公式，由dynamic指定 * 如condition=v%(10-d)==0,dynaminc=$LORE:技能等级?0$ * 意思是，武器上的技能等级为0时，每10次触发一次；为1时，每9次触发一次... * persist为true或false，默认为false * 为true时，计数会以NBT形式保存在武器上 * 为false时，计数会存在内存里，服务器重启刷新 * tag为计数器名。配合触发器\~onCounter使用 * allslot为true或false，默认为false * 为true时，会触发全身的onCounter技能 * 为false时，只会触发当前装备的onCounter技能 * 示例：每五下暴击一下 ``` Skills: - Counter{c=v%5==0;tag=暴击计数} ~onAttack - Damage{amount=10} @targetentity ~onCounter:暴击计数 ``` * 相比MM计分板，使用本技能的显著优势是**节省工作量** 10. **取消事件** 取消触发技能的事件 ``` - CancelEvent ``` * 本技能与MM相应技能的作用完全相同，**但兼容性更好** * 配合复合触发信息，你可以取消更细致的事件。比如 * 使玩家免疫掉落伤害 ``` - CancelEvent ~onDamagedBlock:FALL ``` * 请注意，在Skills中，取消事件技能的前面 * 不能存在异步技能（需专门指定技能的sync=true） * 不能存在延时技能 * 上述两种情况都会使得取消事件失效 ## **MythicMobs兼容** **技能兼容** * 宝石技能完全兼容MythicMobs技能， * 宝石技能库中的技能可以指向任意MythicMobs技能。 * MythicMobs、MythicArtifacts、MythicCrucible也可以用宝石技能库中的技能，**但是宝石特色功能将失效** * 宝石内置技能，冷却时间显示，持续时间 **掉落物** * 可以将宝石作为MythicMobs掉落物 * **只需在怪物配置中加入** ``` Drops: - Gem{name=宝石名称} ``` * 其它写法与MythicMobs掉落物一致 ## MythicMobs附加 宝石插件提供了以下MM附加条件和技能 ### **附加条件** 1. NoArmorStand 阻止技能对盔甲架触发。用法：在技能中加上 ``` TargetConditions: - NoArmorStand ``` 2. PvPManager 只选取开启了PvP的玩家。需要PvPManager支持。建议同时筛选发动者和目标 ``` TargetConditions: - PvPManager Conditions: - PvPManager ``` 3. ResidenceFlag 判断领地条件。需要Residence支持 ``` Conditions: - RedidenseFlag{f=要判断的标志} ``` ### **附加技能** 1. SheildDamage 对护盾（黄心）造成伤害，但不影响玩家真实血条 ``` - ShieldDamage{d=伤害量} ```