LevelTools - RPG Item Leveling - LevelTools - 物品等级系统

LevelTools 是一款为任意物品添加等级系统的插件，通过自定义触发条件让工具、武器甚至任何物品都能在特定行为中获得经验并升级，同时支持升级奖励和动态物品描述。

💡核心特性

• 版本支持: 兼容 Minecraft 1.8 至 1.21 版本。
• 服务器支持: 完美支持 Folia 服务器核心。
• 性能优异: 运行高效，不会造成服务器卡顿。
• 易于开发: 提供简单易用的开发者 API。
• 配置灵活: 采用基于配置文件的模块化系统，可深度自定义。

🎮功能详解

物品升级

• 任何物品都可以通过自定义触发器获得经验并升级。
• 支持在升级时执行命令或附加附魔作为奖励。
• 可对触发升级的方块、实体和物品进行黑名单/白名单管理。
• 升级时通过 ActionBar 发送通知。
• 物品的 Lore 描述会根据等级动态变化。

配置文件系统 (v2.0.0)

v2.0.0 版本引入了模块化的配置文件系统，取代了旧版的硬编码工具类型。现在你可以为任何物品配置升级规则。

• 旧版 (v1.x) 的配置文件会自动备份为 old_config.yml，并迁移至新的配置系统。

默认支持物品

开箱即用，为以下工具提供了预设支持

• 采集工具: 镐、斧、锹（破坏方块）
• 战斗工具: 剑、弓、弩（击杀实体）
• 钓鱼工具: 钓鱼竿（钓鱼）
• 农业工具: 锄头（耕种）

你可以通过创建自定义配置文件，为任何其他物品添加升级系统。

🔧触发器类型

你可以为物品配置多种获得经验的方式

• BLOCK_BREAK: 破坏方块时获得经验。
• ENTITY_KILL: 击杀实体时获得经验。
• FISHING: 钓起物品时获得经验。
• RIGHT_CLICK / LEFT_CLICK: 右键或左键点击时获得经验。
• CONSUME: 消耗物品（如食物）时获得经验。
• FARMING: 耕地或破坏作物时获得经验。

❓配置与扩展

配置文件

详细的配置说明请查阅 Wiki。主要配置文件包括：

• Trigger Profiles: 定义经验获取的触发条件。
• Reward Profiles: 定义升级时给予的奖励（命令、附魔等）。
• Display Profiles: 定义物品 Lore 和通知的显示格式。
• Item Profiles: 将物品、触发器、奖励和显示方案关联起来。

扩展支持

• PlaceholderAPI: 支持 PlaceholderAPI，可在其他插件中使用相关变量。
• 开发者 API: 提供了简单的 API 供其他插件开发者调用，详细用法请见此。

⭐重要链接

• 完整 Wiki 文档: https://github.com/byteful/LevelTools/wiki
• 插件命令: 具体命令列表请在游戏内使用 /leveltools help 查看，或参阅 Wiki。