以下是 BountyHunterExpress 系统的全面、清晰且最新的英文文档。其中包含所有最近的更新、功能以及结构增强内容。
? BountyHunterExpress — 系统文档
本插件允许玩家使用混合聊天和图形用户界面(GUI)系统对其他玩家发布赏金。它支持物品奖励、通过 Vault 实现的现金价格、自定义配置、反作弊日志记录以及过期保护机制。
- 玩家如何创建赏金(逐步指南)
步骤 1:启动命令
玩家在聊天栏输入以下命令以指定目标玩家:
/bounty set <target_player>
? 注意:得益于集成的 Tab-Completer(Tab 补全器),按下 TAB 键会自动补全在线玩家的名称。玩家不能对自己发布赏金;这样做会触发设置中配置的报错信息。
步骤 2:2 行创建 GUI(18 个槽位)
执行命令后,将打开一个包含 18 个槽位(2 行)的自定义屏幕:
槽位 0 到 15(奖励槽位):创建者可以从自己的背包中自由拖拽最多 16 组物品放入这些槽位。插件完全保留自定义名称、附魔、描述和物品属性。
槽位 16(金锭):点击此槽位以指定自定义现金奖励。
槽位 17(绿宝石块):这是确认按钮。
步骤 3:设置现金奖励
玩家点击金锭(槽位 16)。
菜单暂时关闭,并出现聊天提示:请在聊天中输入金额(或输入 'cancel')。
玩家输入一个正数(例如 5000)并按回车键。
系统验证输入,GUI 自动重新打开。金锭的 Lore(描述文本)会实时更新以显示当前金额。
步骤 4:发布或取消
要确认:玩家必须点击绿宝石块(槽位 17)。插件会检查其 Vault 余额。如果资金充足,金钱和物品将被扣除,赏金正式生效,并向全服发送广播。
要取消:如果玩家在不点击绿宝石块的情况下关闭了 GUI(通过 ESC 键),或在聊天中输入 cancel,则过程中止。目前位于 GUI 中的所有物品都会安全地返回到玩家的背包中,如果背包已满则掉落至脚下。
-
可用命令与 GUI 交互
命令 权限 描述
/bounty set <player> 无(默认) 打开 18 槽位创建 GUI,为目标设置物品和现金奖励。
/bounty claimexpired 无(默认) 打开安全的 27 槽位领取终端,以取回已过期赏金中未领取的奖励。
/openbounties <player> bountyhunter.admin (管理员命令)打开主排行榜 GUI,显示活跃赏金。
主排行榜 GUI:以头颅形式显示目标玩家。悬停在头颅上会渲染自定义元数据,包含累计总现金和物品化奖励,完全由您的配置控制。
-
领取赏金与智能 IP 日志记录
当活跃目标被其他玩家击杀时,奖励会立即处理:
发放:击杀者会自动收到总现金奖励,直接存入其 Vault 经济账户,物品奖励则直接放入其背包(溢出物品安全地掉落至地面)。
清除:目标列表从“活跃赏金”配置和排行榜 GUI 中永久清除。
智能 IP 日志记录:如果系统检测到击杀者和受害者拥有完全相同的 IP 地址,它将不会阻止交易。击杀者获得奖励,赏金正常清除,但插件会通过打印一条专门的警报行到 logs/cheaters.log 来静默标记此事,以便工作人员稍后调查手动刷分行为。
- 过期循环(保护机制)
每 5 分钟,一个自动后台任务会扫描活跃列表。如果赏金超过设定的过期阈值(默认:24 小时)仍未成功击杀:
赏金将从活跃列表中删除。
现金和物品会被安全地转移到一个与创建者 UUID 关联的结构化数据库中(expired.yml)。
创建者可以随时输入 /bounty claimexpired 以取回现金并通过安全存储菜单取回物品。
- 结构文件配置
config.yml(完全可自定义布局)
YAML
BountyHunterExpress - 配置文件
GUI 设置
gui:
title: "&4&l通缉令 - 赏金"
size: 54
head-lore-format:
- "&8-------------------"
- "&6现金奖励: &a$%money%"
- "&b物品奖励:"
- "%items%"
- "&8-------------------"
item-list-format: "&f- %item_name% &7x%amount%"
expired-title: "&4&l您的过期奖励"
新的创建 GUI 设置(现为 18 个槽位 - 2 行)
creation-title: "&0设置赏金奖励"
creation-gold-name: "&6&l添加现金奖励"
creation-gold-lore:
- "&7当前金额: &a$%money%"
- ""
- "&e点击此处并在聊天中输入金额"
- "&e!"
确认按钮设置
creation-confirm-name: "&a&l确认赏金"
creation-confirm-lore:
- "&7点击此处以正式发起"
- "&7针对此目标的赏金!"
过期设置
expiration:
time-hours: 24
消息(支持使用 & 的颜色代码)
messages:
no-permission: "&c你没有权限使用此命令。"
player-not-found: "&c未找到玩家或该玩家已离线。"
usage-openbounties: "&c用法:/openbounties <玩家>"
usage-bounty: "&c用法:/bounty set <玩家> 或 /bounty claimexpired"
not-enough-money: "&c你的资金不足以设置此赏金!"
已过期-领取的金钱:"&a从过期的赏金中返还了 $%amount% 到你的余额!"
已过期-GUI打开:"&e正在打开你的过期奖励库存..."
不能悬赏自己:"&c你不能对自己悬赏!"
聊天金钱输入消息
type-money-prompt: "&e&l请在聊天中输入金额(或输入“cancel”):"
invalid-money-amount: "&c无效的数字或小于 0。"
money-added-success: "&a已成功向赏金设置中添加 $%amount%!"
bounty-creation-cancelled: "&c已取消赏金创建,物品已返还。"
Broadcasts
bounty-set-broadcast: "&c&l新的赏金已张贴在 %target% 身上!"
bounty-claimed-broadcast: "&6&l%killer% 击杀了 %target% 并领取了其所有赏金!"
? 依赖要求
⚠️ 重要提示:本插件需要以下依赖项安装在你的服务器上,否则它将在启动时安全地禁用自身:
Vault(以及一个兼容的经济类插件,例如 EssentialsX、EconomyShopGUI 等)
Here is a comprehensive, clear, and up-to-date documentation of the BountyHunterExpress system in English. This includes all the recent updates, features, and structural enhancements.
? BountyHunterExpress — System Documentation
This plugin allows players to place bounties on other players using a hybrid chat and Graphical User Interface (GUI) system. It supports item rewards, monetary cash prices (via Vault), custom configurations, anti-cheat logging, and expiration safeguards.
- How a Player Creates a Bounty (Step-by-Step)
Step 1: Initiation Command
A player types the following command in chat to target another player:
/bounty set <target_player>
? Note: Thanks to the integrated Tab-Completer, pressing TAB automatically completes the names of online players. A player cannot place a bounty on themselves; doing so triggers an error message configured in the settings.
Step 2: The 2-Row Creation GUI (18 Slots)
Upon executing the command, a custom screen containing 18 slots (2 rows) opens:
Slots 0 to 15 (Reward Slots): The creator can freely drag and drop up to 16 item stacks from their personal inventory into these slots. The plugin fully preserves custom names, enchants, descriptions, and item properties.
Slot 16 (Gold Ingot): Click this to specify a custom cash reward.
Slot 17 (Emerald Block): This is the Confirm Button.
Step 3: Setting a Cash Reward
The player clicks the Gold Ingot (Slot 16).
The menu temporarily closes, and a chat prompt appears: Please type the money amount in chat (or type 'cancel').
The player types a positive number (e.g., 5000) and hits Enter.
The system validates the input, and the GUI re-opens automatically. The Gold Ingot's Lore updates in real-time to display the current amount.
Step 4: Launching or Cancelling
To Confirm: The player must click the Emerald Block (Slot 17). The plugin checks their Vault balance. If funds are sufficient, the money and items are deducted, the bounty goes live, and a server-wide broadcast is sent.
To Cancel: If the player closes the GUI (via ESC) without clicking the Emerald Block, or types cancel in chat, the process aborts. All items currently inside the GUI are safely returned to the player's inventory or dropped at their feet if full.
-
Available Commands & GUI Interaction
Command Permission Description
/bounty set <player> None (Default) Opens the 18-slot creation GUI to set item and cash rewards on a target.
/bounty claimexpired None (Default) Opens a safe 27-slot claim terminal to retrieve unclaimed rewards from your expired bounties.
/openbounties <player> bountyhunter.admin (Admin Command) Opens the main leaderboard GUI displaying active bounties.
The Main Leaderboard GUI: Displays target players as skulls. Hovering over a skull renders custom metadata containing total accumulated cash and itemized rewards, completely controlled by your configuration.
-
Claiming Bounties & Smart IP Logging
When an active target is killed by another player, the rewards are processed instantly:
Payouts: The killer automatically receives the total cash reward directly deposited into their Vault economy account, and the item rewards are placed straight into their inventory (overflow items drop safely onto the ground).
Clearance: The target's listing is permanently cleared from the Active Bounties config and leaderboard GUI.
Smart IP Logging: If the system detects that the killer and the victim share the exact same IP address, it will not block the transaction. The killer gets the rewards and the bounty clears as normal, but the plugin silently flags it by printing a specialized alert line into logs/cheaters.log so staff can investigate manual boosting later.
- Expiration Loop (The Safeguard)
Every 5 minutes, an automated background task scans active listings. If a bounty crosses its set expiration threshold (Default: 24 hours) without a successful kill:
The bounty is deleted from the active list.
Cash and items are securely relocated into a structural database associated with the creator's UUID (expired.yml).
The creator can type /bounty claimexpired at any time to claim back their cash and retrieve their items via a secure storage menu.
- Structure File Configs
config.yml (Fully Customizable Layout)
YAML
BountyHunterExpress - Configuration File
GUI Settings
gui:
title: "&4&lWanted List - Bounties"
size: 54
head-lore-format:
- "&8-------------------"
- "&6Money Reward: &a$%money%"
- "&bItem Rewards:"
- "%items%"
- "&8-------------------"
item-list-format: "&f- %item_name% &7x%amount%"
expired-title: "&4&lYour Expired Rewards"
New Creation GUI Settings (Now 18 slots - 2 rows)
creation-title: "&0Set Bounty Rewards"
creation-gold-name: "&6&lAdd Money Reward"
creation-gold-lore:
- "&7Current Money: &a$%money%"
- ""
- "&eClick here to type a money"
- "&eamount in chat!"
Confirm Button Settings
creation-confirm-name: "&a&lCONFIRM BOUNTY"
creation-confirm-lore:
- "&7Click here to officially launch"
- "&7the bounty on this target!"
Expiration Settings
expiration:
time-hours: 24
Messages (Supports Color Codes with &)
messages:
no-permission: "&cYou do not have permission to use this command."
player-not-found: "&cPlayer not found or offline."
usage-openbounties: "&cUsage: /openbounties <player>"
usage-bounty: "&cUsage: /bounty set <player> OR /bounty claimexpired"
not-enough-money: "&cYou do not have enough money to set this bounty!"
expired-claimed-money: "&aReturned $%amount% to your balance from an expired bounty!"
expired-gui-open: "&eOpening your expired rewards inventory..."
cannot-bounty-self: "&cYou cannot place a bounty on yourself!"
Chat Money Input Messages
type-money-prompt: "&e&lPlease type the money amount in chat (or type 'cancel'):"
invalid-money-amount: "&cInvalid number amount or less than 0."
money-added-success: "&aSuccessfully added $%amount% to the bounty setup!"
bounty-creation-cancelled: "&cBounty creation cancelled and items returned."
Broadcasts
bounty-set-broadcast: "&c&lA new bounty has been placed on %target%!"
bounty-claimed-broadcast: "&6&l%killer% has killed %target% and claimed all their bounties!"
? Requirements
⚠️ IMPORTANT NOTICE: This plugin requires the following dependency to be installed on your server, otherwise it will safely disable itself upon startup:
Vault (Along with a compatible Economy plugin like EssentialsX, EconomyShopGUI, etc.)
评论 0
登录后参与评分
还没有评论,来抢沙发吧