原创 闭源 娱乐 IceSkill - 一款通过Lore执行MythicMobs技能的插件 1.0.0

# IceSkill 插件使用指南

## 概述

IceSkill 是一个基于 MythicMobs 的高级技能系统插件，允许玩家通过特定的物品 Lore 和动作序列来触发技能。支持多种触发方式，包括点击、攻击、组合键等。

## 功能特性

- **多种触发方式**：右键、左键、潜行、攻击、组合序列
- **装备槽位限制**：可指定技能在特定装备槽位生效
- **冷却系统**：可配置技能冷却时间
- **进度提示**：实时显示技能触发进度
- **序列技能**：支持多动作组合触发
- **自定义消息**：可配置各种状态提示消息

## 安装要求

- Minecraft 服务器 1.21+
- MythicMobs 插件
- Bukkit/Spigot/Paper 服务端

## 安装步骤

1. 将 `IceSkill.jar` 放入服务器的 `plugins` 文件夹
2. 重启服务器
3. 确保已安装 MythicMobs 插件
4. 根据需要编辑 `plugins/IceSkill/config.yml`
5. 使用 `/skillcast reload` 重载配置

## 配置文件详解

### 基础结构

```yaml
skills:
技能标识:
lore: "显示在物品上的Lore文本"
action: "触发动作类型"
frequency: "触发次数/序列"
timeout: "超时时间(秒)"
cooldown: "冷却时间(秒)"
equipment-slot: "装备槽位"
cast-skill: "MythicMobs中的技能名称"
messages:
cast: "释放技能时的消息"
progress: "进度提示消息"
cooldown: "冷却中的提示消息"
```

### 动作类型说明

| 动作类型 | 描述 |
|---------|------|
| `RIGHT_CLICK` | 右键点击 |
| `LEFT_CLICK` | 左键点击 |
| `SHIFT_RIGHT_CLICK` | 潜行+右键 |
| `SHIFT_LEFT_CLICK` | 潜行+左键 |
| `Damage/Attack` | 攻击生物 |
| `动作1 + 动作2 + ...` | 动作序列组合 |

### 装备槽位选项

- `主手` - 主手持有物品时生效
- `副手` - 副手持有物品时生效
- `头盔` - 头盔装备时生效
- `胸甲` - 胸甲装备时生效
- `腿甲` - 腿甲装备时生效
- `靴子` - 靴子装备时生效
- `任何` - 任意槽位都生效

### 消息占位符

- `{skill}` - 技能名称
- `{time}` - 剩余时间
- `{current}` - 当前进度
- `{max}` - 总进度要求
- `{sequence}` - 序列显示

## 使用示例

### 示例1：攻击累计触发
```yaml
berserker_slash:
lore: "狂暴剑气斩"
action: "Damage/Attack"
frequency: 5
timeout: 30
cooldown: 10
equipment-slot: "主手"
cast-skill: "十字斩"
messages:
cast: "&eX &6你释放了 &e{skill} &6技能! &eX"
progress: "&7* 累计触发 &a{current}&7/&e{max} &8({skill})"
cooldown: "&cX 技能冷却中,还需 &e{time} &c秒"
```
**效果**：主手持有该物品时，攻击5次后触发"十字斩"技能

### 示例2：组合键触发
```yaml
heaven_punishment:
lore: "天罚"
action: "RIGHT_CLICK + RIGHT_CLICK + LEFT_CLICK"
frequency: 1
timeout: 10
cooldown: 15
equipment-slot: "主手"
cast-skill: "天罚"
messages:
cast: "&6 天罚降临! "
progress: "&7按键序列: &e{sequence}"
cooldown: "&c天罚技能冷却中"
```
**效果**：快速执行"右键→右键→左键"序列触发天罚技能

### 示例3：装备触发
```yaml
healing_aura:
lore: "治愈光环"
action: "SHIFT_RIGHT_CLICK"
frequency: 1
timeout: 15
cooldown: 20
equipment-slot: "头盔"
cast-skill: "HealingAura"
messages:
cast: "&a 治愈光环已激活！"
progress: "&7蓄力中... &a{current}&7/&e{max}"
cooldown: "&c冷却时间: &e{time}s"
```
**效果**：佩戴该头盔时，潜行+右键触发治愈光环

## 命令列表

### 基础命令
- `/skillcast` - 显示帮助信息
- `/skillcast reload` - 重载配置文件（需要权限：`skillcast.reload`）
- `/skillcast list` - 列出所有已配置技能（需要权限：`skillcast.list`）

### 权限节点
- `skillcast.use` - 使用主命令权限
- `skillcast.reload` - 重载配置权限
- `skillcast.list` - 查看技能列表权限

## 物品配置方法

### 方法1：使用物品编辑器
1. 使用物品编辑器（如MMOItems、ItemsAdder等）
2. 在物品的Lore中添加配置中指定的文本
3. 确保物品在正确的装备槽位

### 方法2：使用命令
```minecraft
/give @p diamond_sword{display:{Lore:['["","狂暴剑气斩"]']}} 1
```

## 故障排除

### 常见问题

1. **技能无法触发**
- 检查物品Lore是否完全匹配配置
- 确认装备槽位是否正确
- 检查MythicMobs技能是否存在

2. **消息不显示**
- 检查消息配置格式
- 确认ActionBar支持

3. **冷却时间异常**
- 检查配置文件中的cooldown值
- 确认时间单位为秒

### 日志检查
- 使用 `/skillcast reload` 查看加载日志
- 检查服务器日志中的错误信息

## 高级功能

### 序列技能
支持复杂的动作序列，如：
- `RIGHT_CLICK + LEFT_CLICK + SHIFT_RIGHT_CLICK`
- 序列必须在超时时间内完成
- 进度会实时显示在ActionBar中

### 多槽位支持
一个技能可以在多个物品上配置，但需要不同的Lore文本

### 条件触发
通过装备槽位限制，可以实现：
- 只有持特定武器时触发攻击技能
- 只有穿戴全套装备时触发套装效果
- 副手持有盾牌时触发防御技能

## 更新日志

### v1.1.1
- 新增装备槽位限制功能
- 优化序列技能触发逻辑
- 修复冷却时间显示问题

### v1.0.0
- 基础技能触发系统
- 支持多种动作类型
- 基础消息系统

## 技术支持

如遇问题，请检查：
1. 配置文件语法是否正确
2. MythicMobs技能配置
3. 服务器日志错误信息
4. 权限设置是否正确

---

**注意**：本插件需要配合MythicMobs使用，所有技能效果均由MythicMobs定义。