# MythicItemLoreStats Plugin Documentation
# MythicItemLoreStats 插件文档

## Core Features / 核心功能

### 1. Attribute System / 属性系统
- **Basic Attributes / 基础属性**
- Attack Power (Range) / 攻击力（范围值）
- Random damage between min-max / 在最小-最大值之间随机伤害
- Format: "攻击力: 10-20" / 格式："攻击力: 10-20"

- Defense (Range) / 防御力（范围值）
- Damage reduction range / 伤害减免范围
- Format: "防御力: 5-10" / 格式："防御力: 5-10"

- Critical Stats / 暴击属性
- Critical Chance / 暴击几率
- Percentage chance to deal critical hits / 造成暴击的百分比机会
- Format: "暴击几率: 15%" / 格式："暴击几率: 15%"
- Critical Damage / 暴击伤害
- Extra damage on critical hits / 暴击时的额外伤害
- Format: "暴击伤害: 50%" / 格式："暴击伤害: 50%"

- Health System / 生命系统
- Maximum Health / 生命上限
- Increases max health points / 增加最大生命值
- Format: "生命上限: 20" / 格式："生命上限: 20"
- Life Heal / 生命治愈
- Health points restored per heal / 每次治疗恢复的生命值
- Format: "生命治愈: 10" / 格式："生命治愈: 10"
- Heal Speed / 治愈速度
- Reduces healing interval / 减少治疗间隔
- Format: "治愈速度: 50%" / 格式："治愈速度: 50%"

- Movement Speed / 移动速度
- Increases player movement speed / 提升玩家移动速度
- Format: "移动速度: 10" / 格式："移动速度: 10"

- Dodge Chance / 闪避几率
- Chance to avoid damage / 避免伤害的几率
- Format: "闪避几率: 5%" / 格式："闪避几率: 5%"

### 2. Equipment System / 装备系统
- **Level Requirements / 等级要求**
- Checks player level before applying effects / 应用效果前检查玩家等级
- Customizable level requirement message / 可自定义等级要求提示
- Format: "等级要求: 30" / 格式："等级要求: 30"

- **Equipment Slots / 装备部位**
- Specific slot requirements / 特定部位要求
- Six equipment positions / 六个装备位置:
- Head / 头部
- Chest / 胸部
- Legs / 腿部
- Feet / 脚部
- Main Hand / 主手
- Off Hand / 副手
- Invalid slot warning messages / 错误部位警告提示

### 3. MythicMobs Integration / MythicMobs集成
- **Skill System / 技能系统**
- Trigger chance based on attributes / 基于属性的触发几率
- Custom skill configurations / 自定义技能配置
- Automatic skill validation / 自动技能验证
- Format: "火球术: 15%" / 格式："火球术: 15%"

### 4. Display System / 显示系统
- **Health Display / 血量显示**
- BossBar support / BossBar支持
- Customizable format / 可自定义格式
- Real-time updates / 实时更新
- Health scaling option / 血量缩放选项

- **Combat Messages / 战斗信息**
- Damage dealt messages / 造成伤害提示
- Damage taken messages / 受到伤害提示
- Critical hit notifications / 暴击提示
- All messages customizable / 所有提示可自定义

### 5. Technical Features / 技术特性
- **Event Handling / 事件处理**
- Equipment change detection / 装备变更检测
- Real-time attribute updates / 实时属性更新
- Efficient damage calculation / 高效伤害计算

- **Configuration System / 配置系统**
- Comprehensive config file / 全面的配置文件
- Bilingual comments / 双语注释
- Easy customization / 便捷自定义

- **API Support / API支持**
- MythicMobs integration / MythicMobs集成
- Paper API optimization / Paper API优化
- Adventure API text support / Adventure API文本支持

### 6. Commands & Permissions / 命令与权限
- **Commands / 命令**
- /mils stats - View current stats / 查看当前属性
- /mils reload - Reload configuration / 重载配置
- Tab completion support / Tab补全支持

- **Permissions / 权限**
- mythic.itemlorestats.use - Basic usage / 基础使用权限
- Configurable defaults / 可配置默认值

This plugin provides a comprehensive RPG attribute system with equipment requirements, MythicMobs integration, and detailed customization options. All features are highly configurable and support both Chinese and English.

该插件提供了一个全面的RPG属性系统，包含装备要求、MythicMobs集成和详细的自定义选项。所有功能都高度可配置，并支持中英双语。