星露谷道具 StardewValleyItems

📝 插件介绍
StardewValleyItems是一款为Minecraft服务器添加星露谷风格特殊道具的插件。这些道具拥有独特的效果，灵感来自于热门游戏《星露谷物语》，可以极大地丰富玩家的游戏体验。插件提供了多种类型的特殊道具，包括挖矿类、生存类、战斗类、PVP类等，每种道具都有独特的使用效果和冷却时间。

✨ 主要功能
- 🧰 提供47种已实现的特殊道具，分为8个不同类别
- ⏱️ 道具使用冷却时间控制，平衡游戏体验
- 🔄 使用后物品会被消耗，需要重新获取
- 📋 详细的配置选项，可自定义道具属性
- 🌍 可配置允许使用道具的世界列表
- 🎮 全中文界面，易于使用和理解
- 🎨 支持自定义模型数据，可配合资源包使用

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/svi give <道具名> [玩家名] [数量]` | 给予指定玩家一定数量的道具 | stardewvalleyitems.command.give |
| `/svi list` | 列出所有可用道具 | stardewvalleyitems.command.list |
| `/svi reload` | 重新加载配置文件 | stardewvalleyitems.command.reload |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `stardewvalleyitems.command` | 使用/svi命令的基础权限 | op |
| `stardewvalleyitems.command.give` | 给予道具的权限 | op |
| `stardewvalleyitems.command.list` | 查看道具列表的权限 | op |
| `stardewvalleyitems.command.reload` | 重载配置的权限 | op |

📋 已实现的道具

挖矿类道具:
- 矿脉探测器 - 高亮显示周围的矿石，持续30秒
- 瞬间挖掘药水 - 获得急迫效果，持续30秒
- 地心引导石 - 指引玩家找到最近的钻石矿，持续5分钟
- 矿工午餐盒 - 恢复饥饿和生命值，并提升挖掘速度，持续2分钟
- 矿物磁铁 - 吸引周围10格范围内的掉落矿物

生存类道具:
- 紧急传送卷轴 - 传送玩家到出生点
- 生命之泉 - 恢复生命值并清除负面效果
- 天气控制器 - 改变当前天气
- 动物召唤笛 - 召唤和平动物
- 驱魔铃铛 - 驱散周围的幻翼
- 生存指南针 - 指引玩家找到最近的村庄
- 农作物催熟剂 - 使周围作物立即成熟
- 时间加速器 - 加速游戏时间流逝

战斗类道具:
- 怪物诱饵 - 持续拉扯敌对生物
- 闪电召唤符 - 在目标位置召唤闪电
- 爆炸箭筒 - 使射出的箭产生爆炸
- 恐慌烟雾弹 - 使敌对生物随机逃跑
- 末影陷阱 - 将踩到的生物传送到随机位置
- 反弹护盾 - 反弹一次远程攻击
- 生物冰冻器 - 冻结周围的敌对生物
- 虚弱诅咒卷轴 - 使周围敌对生物获得虚弱效果
- 灵魂束缚锁链 - 将敌对生物束缚在原地
- 元素箭袋 - 使射出的箭带有随机元素效果

PVP类道具:
- 位置交换符 - 与最近的玩家交换位置
- 紧急护甲修复剂 - 立即修复身上所有装备的耐久度
- 失重气球 - 使命中区域内的所有玩家获得漂浮效果
- 视野干扰烟雾 - 使命中区域内的所有玩家获得失明效果
- 道具封印符 - 使范围内所有玩家无法使用道具
- 反向控制药水 - 使范围内所有玩家移动方向相反
- 能量屏障 - 创建一个阻挡所有玩家通过的屏障
- 战术闪现 - 向视线方向瞬间移动一段距离
- 战场迷雾 - 在周围创造一片浓雾，只有使用者能看清
- 传送阻断器 - 阻止范围内的所有玩家使用末影珍珠

实用工具:
- 物品分类器 - 自动整理背包中的物品
- 经验收集瓶 - 吸收周围的所有经验
- 区域清理器 - 清除范围内的所有非固体方块
- 自动钓鱼器 - 自动钓鱼一段时间

特殊道具:
- 次元裂缝 - 将玩家传送到远处的随机位置
- 生物驯服符 - 立即将任何可驯服生物驯服
- 资源复制器 - 有小概率复制一个同样的物品

创意道具:
- 重力反转器 - 使范围内的所有生物短暂向上漂浮
- 音乐盒 - 在周围播放随机音乐
- 烟花发射器 - 发射连续爆炸烟花
- 幸运硬币 - 获得短暂的幸运效果

恶搞道具:
- 随机传送魔杖 - 将点击的玩家传送到随机位置
- 声音模拟器 - 在目标位置播放怪物的声音
- 假钻石矿 - 放置看起来像钻石矿但挖掘时会爆炸的方块
- 随机效果药水 - 给命中的玩家施加随机状态效果
- 音量放大器 - 使目标玩家听到的游戏音效变得非常大

稀有道具:
- 元素核心：火 - 使周围的敌对生物燃烧

🔧 配置文件

config.yml - 基础配置
- whitelistworld: 可以使用道具的世界列表
- debug: 调试模式开关

tools.yml - 道具配置
每个道具的配置包括:
- base: 基础物品属性(材质、自定义模型数据、名称、描述文本)
- cooldown: 冷却时间(秒)
- duration: 效果持续时间(秒)
- consumable: 是否消耗物品

🔄 使用方法

管理员使用:
1. 安装插件后，配置文件会自动生成
2. 使用 `/svi list` 查看所有可用道具
3. 使用 `/svi give <道具名> [玩家名] [数量]` 给予玩家道具
4. 如需修改配置，编辑config.yml和tools.yml后使用 `/svi reload` 重载

玩家使用:
1. 获得道具后，手持道具右键使用
2. 道具会根据其特性产生相应效果
3. 使用后道具会被消耗
4. 道具有冷却时间，需要等待冷却结束才能再次使用同类道具

💻 技术信息
- 支持版本: Paper 1.20.1+
- API版本: 1.20
- 使用Java 17开发
- 不依赖其他插件

📊 统计信息
- 已实现道具: 47个
- 挖矿类: 5个 (完成率100%)
- 生存类: 8个 (完成率100%)
- 战斗类: 10个 (完成率100%)
- PVP类: 10个 (完成率100%)
- 实用工具: 4个 (完成率100%)
- 特殊道具: 3个 (完成率100%)
- 创意道具: 4个 (完成率100%)
- 恶搞道具: 5个 (完成率100%)
- 稀有道具: 1个 (完成率17%)

🔮 未来计划
- 元素核心系列道具的完善(水、风、地、雷)
- 命运骰子等稀有道具的实现
- 更多创意道具的开发

---
感谢您选择 StardewValleyItems 插件！如有任何问题或建议，请随时联系我们。