goldminer

插件

· 作者 weiding

一个金矿矿工小游戏插件,适用于 Purpur 1.21.11 的挖矿小游戏插件,玩家可以在独立的矿区世界中挖矿以赚取金币和经验值,升级镐子、购买物品并组队。

0 本站下载 0 关注 更新于 1 个月前

需要前置:Vault 2.0 economy plugins、Multiverse-Core

最新 2.2.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

适用于 Purpur 1.21.11 的挖矿小游戏插件,玩家可以在独立的矿洞世界中挖矿以赚取金币和经验值,升级镐子、购买物品并组建队伍。


依赖项

插件 必需 描述
Multiverse-Core 是 世界管理
Vault 是 经济系统集成
PlaceholderAPI 否 占位符支持(推荐)

安装与设置

  1. 确保已安装所需的依赖项
  2. 将 GoldMiner.jar 放入服务器的 plugins/ 目录
  3. 重启服务器或运行 /plugman load GoldMiner
  4. 插件将在 plugins/GoldMiner/ 下生成配置文件:
    • config.yml - 主配置
    • lang.yml - 语言/消息
    • block.yml - 矿石定义
    • shop.yml - 商店定价
  5. 根据需要修改配置文件,然后运行 /goldminer reload 重新加载

命令参考

玩家命令

命令 描述
/goldminer join 加入矿洞世界并开始挖矿
/goldminer shop 打开矿洞商店 GUI
/goldminer info 查看矿工信息(等级/金币/暴击率等)
/goldminer suit 切换装备显示/隐藏
/goldminer buy lv <amount> 精确购买指定数量的等级
/goldminer buy lv <amount> confirm 确认购买等级
/goldminer team create 创建队伍
/goldminer team join <team name> 申请加入队伍
/goldminer team accept [player name] 接受入队申请
/goldminer team leave 离开队伍(经验/等级清除)
/goldminer team list 查看队伍列表
/goldminer top 查看排行榜
/goldminer exchange [amount] 将矿洞金币兑换为主世界货币
/goldminer help 查看帮助

管理员命令

命令 描述
/goldminer reload 重新加载所有配置文件
/goldminer reload pool 强制刷新矿池(矿石重新随机化)
/goldminer reload info 刷新玩家数据和矿洞世界信息
/goldminer shop set <key> <price> 热修改商店价格(立即生效)
`/goldminer set exp lv <player> <amount>`
`/goldminer add exp lv <player> <amount>`
`/goldminer remove exp lv <player> <amount>`

PlaceholderAPI

占位符 返回值 描述
%goldminer_reload_time% 整数 矿点刷新间隔(秒)
%goldminer_user_level% 整数 玩家当前等级
%goldminer_user_money% 整数 玩家金币
%goldminer_crit_hit_rate% 百分比字符串 暴击率(例如:"5.0")
%goldminer_crit_magnification% 倍率字符串 暴击倍率(例如:"2.5")
%goldminer_crit_time% 整数 额外暴击倍率的剩余时间(秒)
%goldminer_interlocking_type% 字符串 当前连锁类型("None"/Plane X/Plane Z/Radius/View Direction)
%goldminer_interlocking_time% 整数 连锁试验卡的剩余时间(秒)
%goldminer_nomal_interlocking_time% 整数 普通连锁的剩余时间(秒)

配置文件

config.yml

主配置文件,控制矿点参数、镐子附魔限制、药水效果、暴击系统等。

# 存储设置
storage:
  type: sqlite              # sqlite 或 mysql
  mysql:
    host: localhost
    port: 3306
    database: goldminer
    username: root
    password: password

# 矿点设置
mine:
  world-name: "goldminer_mine"  # 矿点世界名称
  border-size: 2000             # 世界边界大小
  center-size: 100              # 矿点核心区域边长
  refresh-interval: 30          # 自动刷新间隔(秒)

# 暴击系统
crit-system:
  default-crit-rate: 0.005         # 初始暴击率 (0.5%)
  default-crit-magnification: 0.5  # 初始暴击倍率
  bonus-crit-mag-duration: 1800    # 额外暴击倍率持续时间(秒)
  overflow-exp-multiplier: 500.0   # 溢出暴击率转换为经验的乘数

# 踏玻璃
glass-block:
  material: GLASS          # 玻璃方块类型
  name: "&f踏玻璃 &7(无限使用)"
  lore: "&7一种可以无限放置的玻璃方块"

# 镐子附魔限制(按镐子等级区分)
pickaxe-enchant-limits:
  default: {efficiency: 5, fortune: 3, unbreaking: 3}
  iron: {efficiency: 10, ...}
  diamond: {efficiency: 30, fortune: 10, ...}
  netherite: {efficiency: 255, fortune: 15, ...}

lang.yml

语言/消息文件;所有显示文本均可在此配置:

# 挖矿消息
mining:
  coin-earned: "&6+{coin} 金币 &7| &a+{exp} 经验"
  level-up: "&a恭喜!你的矿工等级已提升至 &e{level} &a级!"
  pickaxe-upgrade: "&a你的镐子已升级至 &e{pickaxe}&a!"
  enchant-upgrade: "&a你的镐子附魔已提升!"

# GUI 按钮
gui:
  button:
    return-spawn: {name: "&a返回出生点", ...}
    create-team: {name: "&b创建队伍", ...}

block.yml

矿石定义文件;可以添加或修改矿石及其奖励:

common:
  STONE:        {probability: 15.0, coin: 1, exp: 1}
  COBBLESTONE:  {probability: 15.0, coin: 1, exp: 1}
  ...

rare:
  IRON_ORE:     {probability: 10.0, coin: 10, exp: 5}
  COPPER_ORE:   {probability: 8.0,  coin: 8,  exp: 4}
  ...

epic:
  GOLD_ORE:     {probability: 5.0, coin: 30, exp: 15}
  ...

legendary:
  DIAMOND_ORE:  {probability: 3.0, coin: 100, exp: 50}
  ...
  • probability: 在该品质等级内的相对概率
  • coin: 挖矿时获得的金币数量
  • exp: 挖矿时获得的经验值

shop.yml

商店定价文件;所有价格和消息均可配置:

# 药水商店
potion:
  available-durations: [30, 60, 300, 600, 1800, 3600]  # 可用持续时间(秒)
  max-level: 30
  haste:
    base-price: 30
    level-multiplier: 0.5
    duration-multiplier: 0.3

# 暴击率商店
crit-rate:
  base-price: 300
  tiers:
    0.5pct: 1.0
    1pct: 3.0
    ...

# 连锁试炼卡
# 价格公式:基础价格 × 阶梯乘数^(范围-1)
chain-card:
  duration-seconds: 30
  plane_x: {base-price: 8000, tier-multiplier: 3.0}
  plane_z: {base-price: 8000, tier-multiplier: 3.0}
  radius:  {base-price: 15000, tier-multiplier: 3.5}
  ray:     {base-price: 6000,  tier-multiplier: 2.5}

# 全局连锁
global-chain:
  price: 100
  duration-seconds: 10800    # 3小时

# 商店图标
shop-icons:
  chain-card-plane-x: OAK_PLANKS
  chain-card-plane-z: OAK_PLANKS
  chain-card-radius: STONE
  chain-card-ray: ARROW

功能详情

挖矿系统

  • 一个独立的共享挖矿世界 (goldminer_mine)
  • 矿洞是一个 100×100×100 的立方体;矿石根据品质概率随机生成
  • 品质分布(可在 config.yml 中调整):普通 85%、稀有 8%、史诗 6%、传说 1%
  • 按固定间隔自动刷新(默认 30 秒);刷新时,所有方块重新随机生成
  • 玩家出生在矿洞顶部的安全平台上;装备受到自动保护

进入与退出:

  • 运行 /goldminer join → 传送至矿洞 → 获得木镐 + 菜单星 + 无限踏雪玻璃
  • 退出矿洞世界(传回主世界)→ 自动清除挖矿追踪记录 → 可再次 join

镐子升级

玩家通过挖矿获取经验值 → 逐步升级 → 镐子自动升级:

镐子 升级需求 附魔上限
木镐 初始 效率 5 / 抢夺 3 / 耐久 3
石镐 Lv.2 效率 5 / 抢夺 3 / 耐久 3
铜镐 Lv.22 效率 5 / 抢夺 3 / 耐久 3
金镐 Lv.42 效率 5 / 抢夺 3 / 耐久 3
铁镐 Lv.72 效率 10 / 抢夺 3 / 耐久 3
钻石镐 Lv.102 效率 30 / 抢夺 10 / 耐久 5
下界合金镐 Lv.132 效率 255 / 抢夺 15 / 耐久 10
  • 每级提升附魔等级;达到上限后,镐子进阶至下一阶
  • 进阶时,随机继承一个已满级的附魔
  • 装备随镐子等级自动变化(使用 /goldminer suit 切换可见性)

暴击系统

  • 暴击率:在挖矿时独立判定,初始为 0.5%,最高可购买至 100%
  • 暴击倍率:触发暴击时获得的额外倍率,初始为 0.5 倍
  • 暴击效果:基础金币 + 基础金币 × 暴击倍率(向下取整)
  • 在连锁挖矿期间,每个方块都会进行独立的暴击判定;标题栏会显示暴击方块的次数和额外获得的金币

PAPI 占位符:%goldminer_crit_hit_rate% / %goldminer_crit_magnification%

药水商店

在矿场商店 → 购买增益 → 药水效果:

药水 等级范围 持续时间选项
急迫 (Haste) 1~30 30 秒 ~ 1 小时
速度 (Speed) 1~30 同上
幸运 (Luck) 1~30 同上
  • 购买会覆盖当前同类型的药水效果
  • 价格公式:基础价格 × (1 + 等级 × 等级倍率) × (1 + 持续时间指数 × 持续时间倍率)
  • 所有参数均可在 shop.yml 中调整

暴击率 / 暴击倍率商店

  • 暴击率:永久提升,可选值:+0.5% / 1% / 5% / 10% / 50%
  • 暴击倍率:30 分钟临时提升,可选值:1~20 倍,重复购买可叠加持续时间和倍率
  • 当暴击率达到 100% 后,溢出的购买部分将按 500% 的比例转换为经验值

等级购买

  • 预设选项:购买 1 级 / 5 级 / 10 级
  • 精确指令:/goldminer buy lv <数量> confirm
  • 价格计算公式:(从当前等级升至目标等级所需的总经验值)× 经验单价系数
  • 该公式在图形用户界面中公开显示

连锁试炼卡

在矿山商店 → 连锁试炼卡(在矿洞世界中生效,持续 30 秒):

类型 描述 价格公式
X轴平面链 沿X轴扩展,最多15格 8000 × 3.0^(N-1)
Z轴平面链 沿Z轴扩展,最多15格 8000 × 3.0^(N-1)
半径范围链 球形范围,最大半径15 15000 × 3.5^(N-1)
视线方向链 在视线前方,最多15格 + 15高度 6000 × 2.5^(N-1)
  • 点击进入调整界面:◀ 范围 - / N 格 / ▶ 范围 +
  • 视角方向链额外支持高度调整(◀ 高度 - / N 格 / ▶ 高度 +)
  • 调整时,界面原地刷新,光标位置不变
  • 同类型:叠加范围 + 高度 + 持续时间
  • 不同类型:覆盖旧效果且不退还金币

通用链

在矿店 → 通用链(在非矿世界的全地图范围内生效):

  • 价格:100 金币
  • 持续时间:3 小时(可叠加)
  • 范围:同类型的 9×9×3 区块
  • 在挖掘矿石/木材时自动连锁相邻的同类型方块
  • 连锁掉落受玩家工具附魔影响(如幸运等)
  • 不生效于矿洞世界内(互不干扰)

团队系统

  • /goldminer team create 创建团队(在聊天栏输入名称)
  • /goldminer team join <team name> 申请加入
  • 团队队长使用 /goldminer team accept [player name] 接受申请
  • 退出团队 → 经验/等级/镐子清空(金币保留)
  • 最大成员数:10 人

货币兑换

  • 挖矿币可兑换为主世界货币(需要 Vault)
  • 汇率:1 挖矿币 = X 主世界货币(可在 config.yml 中调整)
  • GUI 提供 10/100/1000 的快速兑换,也支持在聊天栏输入自定义数量

权限节点

权限 说明 默认值
goldminer.join 进入矿洞 true
goldminer.suit 切换装备显示 true
goldminer.team.create 创建队伍 true
goldminer.team.join 加入队伍 true
goldminer.team.accept 接受入队申请 true
goldminer.team.leave 离开队伍 true
goldminer.team.list 查看队伍列表 true
goldminer.top 查看排行榜 true
goldminer.exchange 货币兑换 true
goldminer.admin 管理员权限 op

常见问题

问:进入矿洞后看不到任何矿石?
答:矿洞是一个 100×100×100 的立方体,范围为 y=0 到 y=100。请确认您的位置是否在矿洞区域内。

问:矿洞不会自动刷新?
答:检查 config.yml 中的 mine.refresh-interval 是否设置了有效值。您可以运行 /goldminer reload pool 手动刷新。

问:升级后镐子没有变化?
答:镐子位于快捷栏第一个槽位,升级后会自动替换。如果旧镐子残留,只需重新运行 /goldminer join 即可。

问:连击试炼卡过期后还能继续连击吗?
答:不能。连击试炼卡仅在购买后的 30 秒内有效,之后会自动过期。

问:普通连击在矿洞世界内生效吗?
答:不生效。在矿洞世界中,请购买连击试炼卡。普通连击仅对矿洞外的世界生效。

问:如何修改商店价格?
答:方法 1:直接编辑 shop.yml 然后执行 /goldminer reload。方法 2:使用 /goldminer shop set <key> <price> 立即生效。

问:PAPI 占位符未显示?
答:确保已安装 PlaceholderAPI 插件。当未安装时,占位符会被静默忽略,且不影响插件的运行。

问:服务器重启后矿洞不刷新?
答:插件会自动重建矿洞区块追踪列表,首次刷新后即可恢复正常运作。


作者: 未定awa
版本: 2.1.3
兼容性: Purpur 1.21.11

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源