原创 - 授权转载 - 娱乐 - BountyHunterZ - 赏金猎人 · 悬赏系统 · PVP悬赏 · 物品悬赏 · 自定义需求 · 死亡掉落自动放弃任务 · 支持NBT物品

版权类型: 原创

插件中文名称: 赏金猎人Z,悬赏Z

插件英文名称: BountyHunterZ

原帖地址: #

支持的核心（服务端）

Spigot

语言支持: 中文（简体）

前置组件: Vault2.0+https://modrinth.com/plugin/vault-2.0-economy-plugins
PlayerPoints+https://www.spigotmc.org/resources/playerpoints.80745

适配版本（Java）

26.x

BountyHunterZ 插件
理论支持核心：Spigot/Paper/Folia/Purpur
理论游戏版本向下兼容：1.16-26.x (JDK16的版本可能会报错，游戏版本不兼容或报错可以评论，收到后会及时修复。)

核心功能

1.物品悬赏

当你拥有该物品但只有几个时可以直接放置悬赏栏中，发布任务后会返还放置的物品。
当你没有该物品时，也支持使用物品名称搜索。

：中文名可以在配置文件itemname.yml中设置，支持插件物品中文名设置匹配。插件物品推荐至config.yml中设置优先级最高。

2.物品/金币/点券结算
当你不想使用金币或点券支付时，可使用物品结算，将物品放置奖励物品栏中，任务发布会自动暂时存放。直到有人完成任务。如果玩家取消任务则自动返还。

：金币/点券名称可在config.yml中自定义设置。

3.PVP悬赏
如果玩家打不过，可通过PVP悬赏进行仇杀，并且可以设定击杀次数。完成击杀次数即可提交任务并获得奖励。任务奖励有玩家发布者设置，设置成功后扣除发布者的账户余额或任务物品。

4.自定义需求
玩家需要建筑房子，定时收割农作物时，可以发布悬赏。
该悬赏需要玩家手动确认任务。如果确认接取任务的玩家完成任务则发放奖励。

5.悬赏背包
玩家获得的悬赏奖励物品以防丢失统一放置在悬赏背包中，需要时取出即可。（点券或金币系统直接发放）

6.我的发布/接取
玩家发布或接取的任务都可以在gui中显示，并取消发布/接取。

7.任务到期时间
玩家可设置任务到期时间，不设置发布则默认30天，任务到期最大时间/默认到期时间，都可在config.yml中设置

数据存储

8.存储方式

方式	说明
SQLite	默认方案，适合小型服务器（单文件）
MySQL	可选方案，适合大型服务器 & 跨服组网（写了，但依然存在Bug。暂不推荐使用）

命令与权限

玩家命令

/bthtz 打开主悬赏系统 GUI
/bthtz open <gui> 以管理员身份打开指定 GUI
/bthtz list [page] 打开悬赏任务列表（物品+PVP）
/bthtz bag 打开悬赏背包
/bthtz create 打开发布悬赏界面

管理员命令
/bthtz reload 重载配置文件
/bthtz delete <id> 强制删除指定悬赏任务
/bthtz clear <player> 清除某玩家的所有悬赏
/bthtz info <id> 查看悬赏任务详情
/bthtz stats <player> 查看玩家悬赏统计数据
/bthtz bagadmin <player> 查看玩家悬赏背包

配置文件介绍：

代码：

# ─────────────────────────────────────────────
# Bounty HunterZ — 主配置文件
# By：ZhouSing
# https://chenzs.cn
# Version：1.0.0
# ─────────────────────────────────────────────
##  开启 true  关闭 false

# 数据库设置
database:
  type: sqlite        # sqlite | mysql
  # MySQL 设置（仅 type: mysql 时生效）
  host: localhost
  port: 3306
  database: bountyhunterz
  username: root
  password: ""
  pool:
    maximum-pool-size: 10
    minimum-idle: 2
    connection-timeout: 30000

# 经济设置
economy:
  # 金币名称（对应gui中设置，各服务器叫法不同，可自定义）
  # currency-name: "金币"
  # Vault 货币名称（对应 Vault 的经济名称，可选）
  vault-currency-name: "悬赏金"
  # 点券显示名称
  points-name: "点券"

# 悬赏任务通用设置
bounty:
  # 悬赏任务最大同时发布数量（每个玩家）
  max-active-bounties-per-player: 10
  # 悬赏任务最大展示页数（0 为不限制）
  max-pages: 20
  # 每页显示的任务数
  tasks-per-page: 28

  # 物品悬赏设置
  item-bounty:
    # 是否启用物品悬赏功能
    enabled: true
    # 提交物品的匹配模式：EXACT(精确) | LOOSE(宽松)
    # EXACT: 匹配 NBT / 附魔 / Lore
    # LOOSE: 仅匹配物品类型和数量
    match-mode: EXACT
    # 是否检查物品的耐久度
    check-durability: true

  # PVP 悬赏设置
  pvp-bounty:
    # 是否启用 PVP 悬赏功能
    enabled: true
    # 最大可设置被击杀次数上限
    max-kills: 100
    # 默认击杀次数
    default-kills: 1

  # 经济相关限制
  economy:
    # 单次悬赏金币最小值
    min-gold: 0
    # 单次悬赏金币最大值（0=不限制）
    max-gold: 0
    # 单次悬赏点券最小值
    min-points: 0
    # 单次悬赏点券最大值（0=不限制）
    max-points: 0

  # 到期时间设置
  expiry:
    # 最大可设置天数（从发布日算起）
    max-days: 365
    # 默认到期天数（如果玩家不设置则使用此值，0=不限制）
    default-days: 30
    # 到期检查间隔（秒）
    check-interval-seconds: 60

  # 玩家死亡后是否自动放弃所有接取的任务
  drop-tasks-on-death: true

# 是否在玩家登录时通知有未完成的悬赏任务
notify-on-join: true

# GUI 设置
gui:
  # GUI 标题前缀
  title-prefix: "§8[§6赏金§8] §7"
  # 装饰物品
  decoration-item: "GRAY_STAINED_GLASS_PANE"
  decoration-name: "§7"

# 自动清理设置
cleanup:
  # 任务完成后保留记录的天数（之后自动删除）
  completed-record-retention-days: 30
  # 过期无人领取任务的保留天数
  expired-retention-days: 7

# 原版物品中文名称映射可在 itemnames.yml，请在那编辑
# 如需自定义覆盖，可在下面添加，优先级高于 itemnames.yml
item-names:
# 示例:"自定义名称"
# ACACIA_WOOD: "金合欢木"
# ACTIVATOR_RAIL: "激活铁轨"
# ALLIUM: "绒球葱"
# 插件物品示例（用物品ID/枚举名匹配）：
# CUSTOM_ITEM_1: "传奇之剑"

代码：

commands:
  bthtz:
    description: "Bounty HunterZ 主命令"
    usage: |
      /<command> - 打开悬赏系统 GUI
      /<command> help - 查看帮助
      /<command> reload - 重载配置 (管理员)
      /<command> delete <id> - 删除指定任务 (管理员)
      /<command> clear <player> - 清除玩家悬赏 (管理员)
    aliases: [bountyz, bhz, bountyhunterz]
    permission: bountyhunterz.use

permissions:
  bountyhunterz.*:
    description: "Bounty HunterZ 全部权限"
    default: op
    children:
      bountyhunterz.use: true
      bountyhunterz.open.gui: true
      bountyhunterz.create: true
      bountyhunterz.create.item: true
      bountyhunterz.create.pvp: true
      bountyhunterz.submit: true
      bountyhunterz.submit.pvp: true
      bountyhunterz.economy.gold: true
      bountyhunterz.economy.points: true
      bountyhunterz.backpack: true
      bountyhunterz.admin: true

  bountyhunterz.use:
    description: "允许使用 /bthtz 主命令"
    default: true

  bountyhunterz.open.gui:
    description: "允许打开 GUI"
    default: true

  bountyhunterz.create:
    description: "允许发布悬赏任务"
    default: true

  bountyhunterz.create.item:
    description: "允许发布物品悬赏"
    default: true

  bountyhunterz.create.pvp:
    description: "允许发布 PVP 悬赏"
    default: true

  bountyhunterz.submit:
    description: "允许提交悬赏任务"
    default: true

  bountyhunterz.submit.pvp:
    description: "允许提交 PVP 悬赏"
    default: true

  bountyhunterz.economy.gold:
    description: "允许使用金币发布悬赏"
    default: true

  bountyhunterz.economy.points:
    description: "允许使用点券发布悬赏"
    default: true

  bountyhunterz.backpack:
    description: "允许使用悬赏背包"
    default: true

  bountyhunterz.admin:
    description: "管理员权限"
    default: op
    children:
      bountyhunterz.reload: true
      bountyhunterz.delete.others: true
      bountyhunterz.clear.others: true

  bountyhunterz.reload:
    description: "重载配置文件"
    default: op

  bountyhunterz.delete.others:
    description: "强制删除他人悬赏任务"
    default: op

  bountyhunterz.clear.others:
    description: "清除他人的悬赏记录"
    default: op