
⚔️ ApxBounty — 下一代 Minecraft 赏金系统
ApxBounty 是一款简洁、现代且高度优化的玩家赏金插件,专为现代化的 Paper、Purpur 和 Spigot 服务器打造。它通过交互式 GUI 菜单、详细统计数据、自动排行榜以及零延迟体验,引入了一种身临其境的赏金猎人玩法。
? 主要功能
? 经济系统集成
- 完全支持 Vault,兼容任何经济类插件(如 EssentialsX、CMI 等)。
- 创建或提高赏金时可设置可选的放置费用。
- 领取赏金时可设置可选的税收扣除比例。
- 支持自定义货币符号和格式(例如
$1,000、1k、2.5m)。
?️ 交互式 GUI 系统
- 赏金浏览器:查看活跃赏金,显示目标玩家头颅、赏金金额及日期。
- 智能排序:即时按最高赏金、最低赏金、最新或最旧进行排序。
- 搜索功能:直接在 GUI 内快速搜索任意玩家的赏金。
- 分页导航:为拥有数十个活跃赏金的服务器提供流畅的多页导航。
- 统计与历史菜单:专用的图形化菜单,用于检查玩家的狩猎记录。
?️ 漏洞与滥用防护
- 防止自杀击杀:完全阻止自杀 / 自我伤害漏洞(箭矢、末影水晶、跌落标签等)。
- 禁止自设赏金:玩家无法对自己设置赏金。
- 安全死亡监听:只有当其他独立玩家通过合法的 PvP 击杀时,才会发放赏金。
- 过期退款:可选的过期计时器,若赏金未被领取,则安全地退还给玩家。
? 统计、历史与排行榜
- 本地高性能 SQLite 数据库 (
bounties.db),无需外部数据库设置。
- 追踪数据包括:
- 设置的赏金总数
- 领取的赏金总数
- 赏金 PvP 击杀数
- 总花费金额
- 总收入金额
- 定期更新的自动缓存排行榜,不影响 TPS。
? 沉浸式通知与音效
- 美观视觉效果:用于消息和 GUI 元素的精致小号字体排版。
- 标题与副标题:当赏金被设置或领取时,显示电影般的屏幕警报。
- 动作栏提示:清晰的浮动消息。
- 可配置音效:完全自定义 Minecraft 音效,适用于设置、领取、点击和错误场景。
? 自动 Modrinth 更新检查器
- 在启动时及每 6 小时自动检查官方 Modrinth API。
- 纯异步执行确保主服务器线程永远不会被阻塞。
- 专用管理员权限 (
apxbounty.admin.update) 用于通知工作人员。
? 命令与权限
? 玩家命令
| 命令 |
描述 |
权限 |
默认值 |
/bounty |
打开交互式赏金菜单 |
apxbounty.use |
所有人 (true) |
/bounty <player> <amount> |
设置新赏金或提高现有赏金 |
apxbounty.place |
所有人 (true) |
/bounty search <player> |
搜索玩家当前的活跃赏金 |
apxbounty.search |
所有人 (true) |
/bounty stats [player] |
显示自己或其他玩家的赏金狩猎统计 |
apxbounty.stats |
所有人 (true) |
/bounty top |
打开赏金排行榜菜单 |
apxbounty.top |
所有人 (true) |
/bounty history [player] |
查看过去的赏金领取历史 |
apxbounty.history |
所有人 (true) |
?️ 管理员命令
| 命令 |
描述 |
权限 |
默认值 |
/bountyadmin reload |
重新加载 config.yml、gui.yml 和 messages.yml |
apxbounty.admin |
仅限 OP |
/bountyadmin set <player> <amount> |
直接设置精确的赏金金额 |
apxbounty.admin |
仅限 OP |
/bountyadmin remove <player> |
移除活跃赏金且不退款 |
apxbounty.admin |
仅限 OP |
/bountyadmin clearall |
移除服务器上所有活跃赏金 |
apxbounty.admin |
仅限 OP |
/bountyadmin debug |
切换控制台调试日志 |
apxbounty.admin |
仅限 OP |
? 额外权限
apxbounty.admin.update — 当 Modrinth 上发布新版本时,接收游戏内更新通知(默认为 OP)。
? PlaceholderAPI 支持
ApxBounty 内置了 PlaceholderAPI 扩展支持:
%apxbounty_bounty% — 玩家头上的活跃赏金(已格式化)。
%apxbounty_bounty_raw% — 原始数值赏金金额。
%apxbounty_claimed% — 玩家领取的赏金数量。
%apxbounty_kills% — 赏金 PvP 击杀总数。
%apxbounty_placed% — 玩家设置的赏金总数。
%apxbounty_spent% — 在赏金上花费的总金额。
%apxbounty_earned% — 通过领取赏金获得的总金额。
%apxbounty_top_target_<1-10>% — 排名前 1-10 位的玩家名称。
%apxbounty_top_amount_<1-10>% — 排名前 1-10 位的赏金金额。
⚙️ 安装与要求
- 要求:
- Java 17 或更高版本。
- Minecraft 服务器:Paper、Folia 或 Spigot (1.20 - 1.21.11+)。
- Vault 插件 + 一个兼容 Vault 的经济插件(例如 EssentialsX)。
- 安装:
- 下载
ApxBounty-1.1.0.jar。
- 将 JAR 文件拖放到服务器的
plugins/ 目录中。
- 重启服务器(或使用插件管理器加载)。
- 所有配置文件(
config.yml、gui.yml、messages.yml)和数据库(bounties.db)将自动生成!
? 支持与反馈
发现问题或有功能建议?请在我们的问题跟踪器或 Modrinth 讨论页面上报告!

⚔️ ApxBounty — Next-Gen Minecraft Bounty System
ApxBounty is a clean, modern, and highly-optimized player bounty plugin built specifically for modern Paper, Purpur, and Spigot servers. It introduces an immersive target bounty hunting experience with interactive GUI menus, detailed statistics, automated leaderboards, and zero lag.
? Key Features
? Economy Integration
- Full Vault support compatible with any economy plugin (EssentialsX, CMI, etc.).
- Optional placement fee when creating or increasing bounties.
- Optional tax deduction percentage on bounty claims.
- Custom currency symbol and formatting support (e.g.
$1,000, 1k, 2.5m).
?️ Interactive GUI System
- Bounty Browser: View active bounties with target player heads, amounts, and dates.
- Smart Sorting: Instantly sort by Highest Bounty, Lowest Bounty, Newest, or Oldest.
- Search Functionality: Quickly search for any player's bounty directly inside the GUI.
- Pagination: Smooth multi-page navigation for servers with dozens of active bounties.
- Stats & History Menus: Dedicated graphical menus to inspect player hunting records.
?️ Exploit & Abuse Protection
- Self-Kill Prevention: Completely blocks suicide / self-damage exploits (arrows, crystals, fall tags).
- Self-Bounty Block: Players cannot place bounties on themselves.
- Safe Death Listener: Bounties are only awarded upon legitimate PvP elimination by another distinct player.
- Refund on Expiration: Optional expiration timer that safely refunds players if a bounty goes unclaimed.
? Statistics, History & Leaderboards
- Local high-performance SQLite database (
bounties.db) with zero external database setup required.
- Tracks:
- Total bounties placed
- Total bounties claimed
- Bounty PvP kills
- Total money spent
- Total money earned
- Automated cached leaderboards updated periodically without impacting TPS.
? Immersive Notifications & Audio
- Aesthetic Visuals: Sleek small-font typography for messages and GUI elements.
- Titles & Subtitles: Cinematic screen alerts when a bounty is placed or claimed.
- Action Bar Alerts: Clean floating messages.
- Configurable Sound Effects: Fully customizable Minecraft sounds for placement, claims, clicks, and errors.
? Automatic Modrinth Update Checker
- Automatically checks the official Modrinth API on startup and every 6 hours.
- Pure asynchronous execution ensures the main server thread is never blocked.
- Dedicated admin permission (
apxbounty.admin.update) to notify staff members.
? Commands & Permissions
? Player Commands
| Command |
Description |
Permission |
Default |
/bounty |
Opens the interactive bounty menu |
apxbounty.use |
Everyone (true) |
/bounty <player> <amount> |
Places a new bounty or increases an existing one |
apxbounty.place |
Everyone (true) |
/bounty search <player> |
Searches for an active bounty on a player |
apxbounty.search |
Everyone (true) |
/bounty stats [player] |
Displays bounty hunting stats for yourself or another player |
apxbounty.stats |
Everyone (true) |
/bounty top |
Opens the bounty leaderboards menu |
apxbounty.top |
Everyone (true) |
/bounty history [player] |
Views past bounty claim history |
apxbounty.history |
Everyone (true) |
?️ Admin Commands
| Command |
Description |
Permission |
Default |
/bountyadmin reload |
Reloads config.yml, gui.yml, and messages.yml |
apxbounty.admin |
OP only |
/bountyadmin set <player> <amount> |
Sets an exact bounty amount directly |
apxbounty.admin |
OP only |
/bountyadmin remove <player> |
Removes an active bounty without refund |
apxbounty.admin |
OP only |
/bountyadmin clearall |
Removes all active bounties across the server |
apxbounty.admin |
OP only |
/bountyadmin debug |
Toggles console debug logs |
apxbounty.admin |
OP only |
? Additional Permissions
apxbounty.admin.update — Receive in-game update notifications when a new version is released on Modrinth (Defaults to OP).
? PlaceholderAPI Support
ApxBounty includes built-in PlaceholderAPI expansion support:
%apxbounty_bounty% — The active bounty on the player's head (formatted).
%apxbounty_bounty_raw% — The raw numeric bounty amount.
%apxbounty_claimed% — Number of bounties claimed by the player.
%apxbounty_kills% — Total bounty PvP kills.
%apxbounty_placed% — Total bounties placed by the player.
%apxbounty_spent% — Total money spent on bounties.
%apxbounty_earned% — Total money earned from claiming bounties.
%apxbounty_top_target_<1-10>% — Name of player at top rank.
%apxbounty_top_amount_<1-10>% — Bounty amount of top rank.
⚙️ Installation & Requirements
- Requirements:
- Java 17 or newer.
- Minecraft Server: Paper, Folia or Spigot (1.20 - 1.21.11+).
- Vault plugin + a Vault-compatible economy plugin (e.g. EssentialsX).
- Installation:
- Download
ApxBounty-1.1.0.jar.
- Drag and drop the JAR into your server's
plugins/ directory.
- Restart your server (or load with a plugin manager).
- All configuration files (
config.yml, gui.yml, messages.yml) and database (bounties.db) will generate automatically!
? Support & Feedback
Found an issue or have a feature suggestion? Report it on our issue tracker or Modrinth discussion page!
评论 0
登录后参与评分
还没有评论,来抢沙发吧