goldminer

#黄金矿工

格式遵循 Keep a Changelog， 版本号遵循 语义化版本。

---

[2.1.3] - 2026-08-15

适用于 Purpur 1.21.11 的挖矿小游戏插件。

✨ 新增

矿场系统

• 所有玩家共享的独立矿场世界（goldminer_mine），借助 Multiverse 创建与管理
• 100×100×100 地面矿场，矿物按品质概率随机生成（默认 普通85% / 稀有8% / 史诗6% / 传奇1%）
• 定时自动刷新（默认 30 秒），刷新时全部矿物完全重新随机
• 刷新后安全检测：仅当玩家被方块卡住时才传送到安全平台
• 矿场世界终为白昼、无敌对生物、2000 边界

挖掘与计分

• 矿场内矿物挖掘给予金币与经验，Title/ActionBar 实时显示奖励
• 矿场外方块按原版掉落逻辑正常挖掘，全部方块可自由放置
• 四档品质矿物：普通 / 稀有 / 史诗 / 传奇，奖励与概率完全可配置（block.yml）
• 下界合金块价值最高：66666 金币 + 99999 经验

镐子进化系统

• 7 级进化线：木镐 → 石镐 → 铜镐 → 金镐 → 铁镐 → 钻石镐 → 下界合金镐
• 等级门槛逐级晋升（Lv.2 / 22 / 42 / 72 / 102 / 132）
• 效率/时运/耐久逐级附魔，晋升时随机继承一个满级附魔
• 铁镐解锁效率上限 10，钻石镐 30，下界合金镐 255；时运上限最高 15
• 经验需求随等级平方增长（等级² × 3），前期快后期慢

装备系统

• 装备随镐子等级自动更换：新手矿工 → 入门矿工 → 炼铜矿工 → 黄金矿工 → 八级矿工 → 寰宇矿工 → 无尽矿工
• 四件套齐全，全套最大等级附魔（含冰霜行者、迅捷潜行、水下呼吸等）
• 自带锻造模板纹路（ArmorTrim，各等级不同纹饰）
• /goldminer suit 切换装备显示；未卸下但缺失时自动重穿

矿工体验

• 快捷栏 3 格保护物品：镐子 / 下界之星菜单 / 无限垫脚玻璃（不可移动、丢弃、死亡不掉落）
• 矿场内永久生命回复 / 饱食 / 抗性效果
• BossBar 以血量条样式显示等级与经验进度（经验值：当前/最大）

小队系统

• 创建 / 申请加入 / 接受申请 / 退出 / 列表
• 等级与经验共享（取成员最大值），金币独立
• 队长离线时入队申请暂存，上线后通知
• 退出小队清空经验、等级、镐子与装备（金币保留）

GUI 菜单

• 下界之星右键打开：返回主城 / 创建小队 / 申请加入 / 排行榜 / 货币兑换 / 退出小队 / 装备切换
• 所有按钮名称、Lore 均可在 lang.yml 配置

货币系统

• 独立矿场金币，可通过 Vault 兑换为主世界货币（默认 1:100）
• GUI 快捷兑换 10/100/1000 + 自定义数量

暴击系统

• 独立暴击判定（初始 0.5%），暴击额外倍率收益
• 暴击率可永久购买至 100%，溢出部分自动按 500% 转经验

矿场商店

• 药水商店：急迫 / 速度 / 幸运（1~30 级，30 秒~1 小时）
• 暴击率与暴击倍率商店
• 等级购买：预设与精确购买，价格公式公开
• 连锁体验卡：平面X / 平面Z / 半径 / 视角方向 四种连锁（矿场内生效）
• 一般连锁：矿场外全地图 9×9×3 连锁（3 小时）

管理功能

• /goldminer set|add|remove exp|lv <玩家> <数量> 经验/等级管理（自动同步装备）
• /goldminer reload 即时重载（刷新间隔等配置立即生效）
• /goldminer shop set <key> <价格> 商店价格热修改
• SQLite / MySQL 双存储（HikariCP 连接池）

PlaceholderAPI 支持

• %goldminer_reload_time% 矿场刷新间隔
• %goldminer_user_level% 玩家等级
• %goldminer_user_money% 玩家金币
• %goldminer_crit_hit_rate% / %goldminer_crit_magnification% 暴击率/倍率
• %goldminer_interlocking_type% 等连锁相关占位符

🛠 依赖

• Multiverse-Core（必需）
• Vault（必需，货币兑换）
• PlaceholderAPI（可选，占位符）

---