# WeaponSystem 插件
一个为 Minecraft 服务器添加高级武器机制、双持能力和增强战斗功能的综合性武器系统插件。
## 特性
### 🗡️ 武器标记系统
- **双手武器**: 需要双手使用的武器，自动清空空手槽
- **空手武器**: 特殊武器，可以在空手槽中使用，用于双持
- **标记管理**: 易于使用的基于命令的系统，用于标记武器的特殊属性
### ⚔️ 增强的战斗机制
- **攻击速度系统**: 基于武器类型和属性的现实武器冷却时间
- **伤害计算**: 高级伤害计算，包括：
- 武器基础伤害
- 附魔奖励（锋利、暴击、对关节动物的伤害）
- 暴击机制
- 属性修改器
- **击退系统**: 基于武器属性的可定制击退效果
- **着火效果**: 适当的火焰伤害应用，并进行免疫检测
### 🎯 视觉反馈
- **冷却指示器**: 显示武器准备状态的动画冷却条
- **可定制的 UI**: 可配置的冷却符号和颜色
- **攻击效果**: 不同类型攻击的视觉和音频反馈
### 🛡️ 物品栏管理
- **智能物品处理**: 为双手武器自动管理空手槽
- **掉落保护**: 切换武器时防止意外丢失物品
- **物品栏验证**: 确保正确的武器放置和使用
## 命令
```
/weapontag twohanded [remove] - 使物品成为双手武器或移除标签
/weapontag offhanded [remove] - 允许物品在空手中使用或移除标签
/weapontag clear - 移除所有武器标签
/weapontag check - 显示当前武器标签
```
## 权限
- `weaponsystem.tags` - 访问武器标记命令
- `weaponsystem.use` - 基本命令访问（默认：op）
## 配置
该插件包含一个 `config.yml` 文件，用于自定义：
- 冷却动画帧
- 冷却指示器颜色
- 武器行为设置
## 技术细节
- **Minecraft 版本**: 1.21+
- **API 版本**: 1.21
- **Java 版本**: 21
- **依赖**: Paper API
## 安装
1. 下载插件 JAR 文件
2. 将其放在服务器的 “plugins” 文件夹中
3. 重启服务器
4. 通过 `config.yml` 配置插件
## 开发
该插件使用 Gradle 和 Paper API 构建，为 Minecraft 服务器上的高级武器机制提供了坚实的基础。