Reward

本页有两种语言 · This page is bilingual

中文说明在上半部分，English 在下半部分，两份内容一致，直接往下滚即可； 也可以用页面右侧的「目录 / Contents」面板跳到对应章节（由标题自动生成）。

The description is written twice: 中文 first, English second. Just scroll down for the English part, or use the page's Contents panel to jump straight to a section.

---

中文

把"全服通缉 → 领地保护失效 → 追猎厮杀 → 按劳分配"做成一条完整链路。 不是简单的"击杀给钱"：它自带投票门槛、领地穿透、追猎传送、击杀统计、分配核对与防赖账兜底。

Paper 26.1.2 · Java 25 · 软依赖 Residence / Vault（没装也能跑，对应功能自动降级）

玩法流程

阶段	发生什么
发起	/rd create <目标> <赏金> <人头数> <原因>，赏金从发起人账户托管扣除
公告	全服弹出可点击公告：玩家A 对 B 发起了悬赏 / 主要原因 / 赏金 / 击杀满 N 次即可按劳分配 / [加入悬赏]
同意	点 [加入悬赏] 或 /rd join 算一票，满 3 人同意才正式发布（可配置）
生效	目标常驻发光 + 顶部倒计时 Boss 条 + 禁止一切传送 + 领地保护失效
追猎	猎人 /rd tp 传送到目标 40 格内的随机安全落点，冷却 90 秒
结算	人头打满 → 私聊发起人战报：xxx 击杀了 yyy 3 刀 | 占比 60% | 建议分配 600 金币
分配	发起人 /rd give 分配（设为，可反复改小/清零重算）、add 追加、take 扣减、reset 清空、auto 按击杀整池重算
发放	列出明细 → 发起人输入文字 确认（防误操作）→ 金币真正到账 + 全服公示
防赖账	发起人拖着不分配，超时后由系统自动分配并发放（默认平均分，防止他把大头塞给熟人）

被悬赏者会经历什么

• 常驻发光：发光标志会被写进玩家存档，所以"结算那一刻他不在线"也会被记账，等他上线自动回收，不会永久高亮
• 禁止一切传送：指令、末影珍珠、紫颂果；下界门可按需一起封（默认不封，免得把人困死）
• 领地：默认一个字节都不动，只让"保护"在悬赏期间失效。三种模式可选—— none（不碰）/ suspend（临时挂起保护，悬赏结束原样还原）/ delete（删除，必须显式配置且不可恢复）
• 期间禁用全部领地指令，无法再圈地

猎人会得到什么

• 不需要任何领地权限：插件用权限附件临时挂上绕过权限，进出、破坏、传送全部放行，悬赏结束自动回收
• /rd tp 追猎传送，落点只在不加载新区块的前提下寻找 —— 不会为了传送去生成地形，也不会把人丢在楼顶上
• 每人一条专属进度 Boss 条（进度 / 赏金 / 传送是否就绪）；嫌挡视野可以 /rd hud 只对自己隐藏，关键信息改走聊天栏
• 击杀归因覆盖宠物、坐骑、弹射物与间接击杀（点燃/摔死等），不会出现"我的狼咬死的不算"

经济

• economy.mode: auto → 依次尝试 Vault → XConomy 直连 → 内置金币
• 服务器装了多个经济插件时，会列出全部候选并明确告警，可用 economy.vault-provider 指定用谁
• /rd admin econ test <玩家> 一键验钞：入账一笔再扣回，打印每一步的真实余额
• 后端返回码不可信的场景（如 XConomy 的返回码语义）一律以余额实际变化为准，不做乐观判断
• 所有金额操作先落盘再动钱：崩服不会重复发放，也不会重复退款

指令

主指令 /rd，别名 /bounty、/悬赏。

/rd create <目标> <赏金> <人头数> <原因>   发起悬赏
/rd join [目标]                            同意 / 加入（等于点公告按钮）
/rd leave [目标]                           投票阶段撤回同意
/rd cancel [目标]                          发起人自助取消并退款
/rd list | info | kills | balance          查看悬赏 / 详情 / 战绩 / 金币
/rd tp [目标]                              追猎传送
/rd hud [on|off]                           隐藏或恢复悬赏 Boss 条
/rd give <猎人> <金额>                     设为（覆盖重算）
/rd give add|take <猎人> <金额>            追加 / 扣减
/rd give reset [猎人|*]                    清空某人或全部
/rd auto                                   按击杀比例整池重算
/rd confirm <确认文字>                     输入文字确认发放

管理端（reward.admin）：cancel · force · demo · kill · add|take|set · econ · hud · unglow · diag · reload · history

权限

节点	默认	说明
reward.use	true	发布、参与、查看
reward.tp	true	追猎传送
reward.admin	op	管理指令
reward.bypass	op	被悬赏时无视一切限制

配置与文案

• config.yml 里每个设置项都有中文注释，全部玩家可见文案都是 MiniMessage（颜色、悬停、点击按钮），可以翻译成任何语言
• 换新版本不需要删配置：启动时会把新增的键自动补进你现有的文件，你改过的值、注释、缩进都保留；补全结果写入前会做 YAML 校验，不合法就一个字都不写
• 配置意外损坏时，会自动用 config.yml.bak 恢复
• /rd reload 热重载配置与文案，并把进行中的悬赏按新配置重新同步（不刷屏、不重复动领地）
• 数据文件（bounties.yml / balances.yml）全部原子写入；读档失败时停止写入并另存 .corrupt，绝不用空数据覆盖

环境要求

• 服务端：Paper 26.1.2（api-version: 26.1.2），Java 25
• 软依赖：Residence（领地）、Vault（经济）—— 都不装也能正常运行，对应功能自动跳过

需要提前知道的几点

• 默认文案是中文（MiniMessage，可自由改）
• hunted.void-residence-for-everyone: true 表示悬赏期间目标在谁眼里都没有领地保护；这个实现方式会一并绕过其它保护插件（WorldGuard 等），只想对参与悬赏的人生效就设为 false
• hunted.residence-action 默认 none，不会碰玩家领地；delete 才会删，且不可恢复
• hunted.block-plugin-teleports: true 有风险：会把重生、登录落点一起封掉，可能导致玩家卡在死亡界面，默认关闭
• 换 jar 需要重启服务端（Paper 没有热替换插件类加载器的官方接口）；只改配置/文案用 /rd reload 即可

---

English

A complete loop for Paper: bounty posted → server votes → target exposed → hunters chase → reward split by kills. Not just "kill for cash" — it ships with a voting threshold, Residence bypass, tracking teleports, kill attribution, payout reconciliation, and a timeout that settles the reward if the poster stalls.

Paper 26.1.2 · Java 25 · Optional soft-dependencies: Residence / Vault (works fine without them)

How it works

Stage	What happens
Post	/rd create <target> <reward> <kills> <reason> — the reward is escrowed from the poster's balance
Announce	Server-wide clickable announcement: Player A placed a bounty on B / reason / reward / N kills to split the payout / [Join]
Approve	Clicking [Join] or running /rd join counts as a vote — 3 approvals required before it goes live (configurable)
Live	Target glows permanently + countdown boss bar + all teleports blocked + land protection voided
Hunt	Hunters use /rd tp to teleport to a random safe spot within 40 blocks of the target, 90s cooldown
Settle	Once the kill count is reached, the poster gets a report: xxx killed yyy 3 times | 60% share | suggested 600
Allocate	Poster uses /rd give to set a share (recomputable), plus add, take, reset, and auto (re-split by kills)
Pay out	Full breakdown is shown, then the poster must type the confirmation phrase — money actually moves and the server is notified
Anti-stall	If the poster stalls, the system auto-allocates and pays out on a timeout (even split by default, so they can't hand the bulk to a friend)

What the hunted player gets

• Permanent glow — the glow flag is stored in player data, so if the target is offline when the bounty ends the plugin records it and clears it on their next login. No permanently glowing players.
• All teleports blocked — commands, ender pearls, chorus fruit; nether portals can be blocked too (off by default so nobody gets stranded).
• Land — untouched by default; only the protection is voided during the hunt. Three modes: none (don't touch), suspend (temporarily suspend protection and restore it exactly afterwards), delete (removal — must be explicitly enabled, irreversible).
• All Residence commands disabled during the hunt, so they can't claim new land.

What hunters get

• No Residence permissions needed — the plugin grants a bypass node via a permission attachment; entering, breaking and teleporting all work, and it is revoked when the bounty ends.
• /rd tp tracking that only searches for a landing spot without loading new chunks — it never generates terrain and won't drop you on a roof.
• A personal progress boss bar per hunter (progress / reward / whether /rd tp is ready). If it blocks your view, /rd hud hides it for you only and moves the key info to chat.
• Kill attribution covers pets, mounts, projectiles and indirect kills (fire, fall damage) — your wolf's kill still counts.

Economy

• economy.mode: auto tries Vault → XConomy (direct) → built-in balance, in that order.
• If the server has several economy providers, the plugin lists all candidates and warns loudly; use economy.vault-provider to pick one.
• /rd admin econ test <player> performs a live check: deposit then withdraw, printing the real balance at each step.
• When a backend's return code can't be trusted (e.g. XConomy's polarity), the result is judged by the actual balance change — never optimistically.
• Every money operation persists state before moving funds, so a crash can't double-pay or double-refund.

Commands

Main command /rd, aliases /bounty, /悬赏.

/rd create <target> <reward> <kills> <reason>   Post a bounty
/rd join [target]                               Approve / join (same as the announcement button)
/rd leave [target]                              Withdraw your approval while voting
/rd cancel [target]                             Poster cancels their own bounty and gets refunded
/rd list | info | kills | balance               Browse / details / your kills / balance
/rd tp [target]                                 Tracking teleport
/rd hud [on|off]                                Hide or restore bounty boss bars
/rd give <hunter> <amount>                      Set a share (recomputes, overwrites)
/rd give add|take <hunter> <amount>             Add / subtract
/rd give reset [hunter|*]                       Clear one hunter or all
/rd auto                                        Re-split the whole pool by kill ratio
/rd confirm <phrase>                            Type the phrase to release the payout

Admin (reward.admin): cancel · force · demo · kill · add|take|set · econ · hud · unglow · diag · reload · history

Permissions

Node	Default	Purpose
reward.use	true	Post, join, view
reward.tp	true	Tracking teleport
reward.admin	op	Admin commands
reward.bypass	op	Ignore all restrictions while hunted

Configuration & messages

• Every setting in config.yml is commented, and all player-facing text is MiniMessage (colors, hover, clickable buttons) — translate it into any language.
• Updating never requires deleting your config: new keys are merged into your existing file on startup, keeping your values, comments and indentation. The merge result is YAML-validated before writing — if it isn't valid, nothing is written at all.
• A corrupted config is auto-repaired from config.yml.bak.
• /rd reload hot-reloads settings and messages and re-syncs bounties that are already running, without spamming players or touching land again.
• Data files (bounties.yml / balances.yml) are written atomically; if loading fails the plugin stops writing and keeps a .corrupt copy, so empty data can never overwrite your history.

Requirements

• Server: Paper 26.1.2 (api-version: 26.1.2), Java 25
• Optional: Residence (land), Vault (economy) — everything works without them, those features are skipped automatically

Good to know before you install

• Default messages are in Chinese (MiniMessage — fully customizable).
• hunted.void-residence-for-everyone: true means the target has no land protection from anyone while hunted; this implementation also bypasses other protection plugins (WorldGuard, etc.). Set it to false to affect only participants.
• hunted.residence-action defaults to none — your players' land is never touched. Only delete removes land, and that is irreversible.
• hunted.block-plugin-teleports: true is risky: it also blocks respawns and login placement, which can trap players on the death screen. Off by default.
• Swapping the jar requires a server restart (Paper has no official plugin-classloader reload); config/message changes only need /rd reload.