SyBountyTask
一个适用于 Paper/Purpur 1.21.x 服务器的 Minecraft 悬赏任务插件,支持通过 Vault 集成经济系统。
功能特性
- 三种任务类型:材料收集、建造和怪物猎杀任务
- 托管支付系统:发布者创建任务时需预付资金(报酬 + 服务费)。资金由平台托管,仅在发布者确认任务完成后才释放给认领者
- 服务费:在报酬基础上收取可配置比例的服务费(由平台保留)
- 违禁词过滤:标题或详情中包含违禁词的任务将被拦截。列表可在
config.yml 中完全自定义,并通过 /sybt reload 实时生效。匹配前会去除颜色代码和分隔符(空格、下划线、连字符等),因此类似 外 挂 或 f-u-c-k 的规避手段无法生效
- GUI 发布任务:通过游戏内 GUI 创建任务。材料任务需在专用槽位放置所需物品并输入数量;放置的物品不会被扣除,且无法从 GUI 中提取任何内容
- 每日发布限制:限制玩家每天可发布的任务数量(默认:2)
- 任务广播:发布者可将待处理任务广播给所有在线玩家,附带可点击的认领链接
- GUI 菜单:游戏内 GUI,可按类型浏览任务、查看自己的任务以及翻页导航
- 自动清理:在可配置天数后自动删除旧的待处理/已认领任务
- SQLite 存储:所有任务均持久化存储在本地 SQLite 数据库中
- 全额退款:删除未认领的任务时,向发布者退还全部金额(报酬 + 服务费)
依赖要求
- Java 21
- Paper/Purpur 1.21.x
- Vault(需搭配兼容的经济插件)
安装步骤
- 下载最新的
SyBountyTask-x.x.x.jar
- 将 jar 文件放入服务器的
plugins/ 目录
- 重启服务器
- 根据需要编辑
plugins/SyBountyTask/config.yml
- 使用
/sybt reload 应用配置更改,无需重启服务器
命令
| 命令 |
描述 |
/sybt open |
打开悬赏任务中心 GUI |
/sybt create |
打开任务创建 GUI(推荐) |
/sybt task <type> <title> <details> <reward> |
通过命令发布任务(仅限建造/怪物,类型为 2/3) |
/sybt get <taskID> |
认领任务 |
/sybt br <taskID> |
向所有在线玩家广播你的待处理任务 |
/sybt complete <taskID> |
提交任务以供审核(仅限认领者) |
/sybt submit <taskID> |
确认材料提交(仅限材料任务) |
/sybt confirm <taskID> |
确认任务完成并释放报酬(仅限发布者) |
/sybt delete <taskID> |
删除未认领的任务(全额退款) |
/sybt reload |
重载配置(仅限管理员) |
材料任务必须通过 GUI 发布以选择所需物品;命令行路径不再支持材料任务。
任务类型
| ID |
类型 |
描述 |
| 1 |
材料 |
认领者提交注册数量的指定物品;发布者在确认后收集材料 |
| 2 |
建造 |
建筑/建造任务,由发布者验证 |
| 3 |
怪物 |
怪物猎杀任务,由发布者验证 |
权限
| 权限节点 |
描述 |
默认值 |
sybt.use |
访问基础 SyBountyTask 命令 |
true |
sybt.admin |
访问管理命令(重载) |
op |
配置说明
# 服务费率 (0.0 - 1.0,例如,0.05 = 5%)
service-fee: 0.05
# 玩家每天可发布的最大任务数
max-daily-tasks: 2
# 超过 X 天的任务自动删除
auto-delete-days: 7
# 数据库文件名
database-file: "tasks.db"
# 文本长度限制
max-title-length: 50
max-details-length: 200
# 材料任务可请求的最大物品数量
max-item-amount: 2304
# 任务标题和详情的违禁词(不区分大小写,可自由编辑)
banned-words:
- "外挂"
- "作弊"
- "刷钱"
- "诈骗"
- "广告"
- "shit"
- "fuck"
# 消息(支持 & 颜色代码)
messages:
prefix: "&6[悬赏任务] &r"
task-created: "&a任务创建成功!任务ID: &e%id%"
task-deleted: "&c任务已删除!"
task-claimed: "&a你已成功认领任务: &e%title%"
task-completed: "&a任务已完成,等待发布者验收..."
task-confirmed: "&a任务验收完成,报酬已发放!"
task-not-found: "&c任务不存在!"
task-already-claimed: "&c该任务已被认领!"
task-not-yours: "&c这不是你的任务!"
not-enough-money: "&c你的余额不足!需要: &e%amount%"
max-tasks-reached: "&c你今天发布的任务数量已达上限!"
banned-word-detected: "&c任务标题或详情包含违禁词,请修改后重试!"
broadcast-format: "&6[任务广播] &e%player% &f发布了一个新任务: &a%title% &7(ID: %id%)"
material-complete: "&a玩家 &e%player% &a已完成物资任务,请点击下方按钮领取物资!"
build-complete: "&a玩家 &e%player% &a已完成建造任务,请前往验收!"
monster-complete: "&a玩家 &e%player% &a已完成打怪任务,请确认验收!"
received-material: "&a你已成功领取物资!"
received-reward: "&a你已获得报酬: &e%amount%&a!"
item-not-set: "&c请先在发布界面的物品槽中放入一个需要的物品!"
item-amount-not-set: "&c请先设置需要的物品数量!"
title-not-set: "&c请先设置任务标题!"
details-not-set: "&c请先设置任务详情!"
reward-not-set: "&c请先设置任务报酬!"
material-not-enough: "&c物资不足!需要 &e%amount%x %item%&c,当前只有 &e%has%&c。"
material-command-blocked: "&c物资任务需要在GUI中发布,请使用 &e/sybt open &c后点击“发布任务”。"
task-cost-charged: "&7发布任务已扣除: &6%total% &7(报酬: &6%reward% &7+ 服务费: &6%fee%&7)"
工作原理
托管支付流程
- 发布:发布者预付
奖励 + 服务费;资金由平台托管。对于物资任务,所需物品模板和数量在 GUI 中设置(放置的物品不会从玩家处扣除)。
- 认领:玩家认领一个待处理的任务。
- 完成:认领者提交已完成的任务以供审核。物资任务会从认领者的背包中扣除已登记的物品和数量;如有短缺,则报告差额。
- 确认:发布者验证工作并确认。平台将奖励发放给认领者;服务费由平台保留。对于物资任务,材料会交付给发布者(如果其背包已满,则掉落至脚下)。
- 删除:如果发布者删除了一个未被认领(待处理)的任务,全额款项(奖励 + 服务费)将被退还。
SyBountyTask
A Minecraft bounty task plugin with Vault economy integration for Paper/Purpur 1.21.x servers.
Features
- Three Task Types: Material collection, building, and monster hunting tasks
- Escrow Payment System: Publishers pay upfront (reward + service fee) when creating a task. The funds are held by the platform and released to the claimer only after the publisher confirms task completion
- Service Fee: Configurable service fee rate charged on top of the reward (kept by the platform)
- Banned Words Filter: Tasks with banned words in the title or details are blocked. The list is fully configurable in
config.yml and applied live via /sybt reload. Color codes and separators (spaces, underscores, dashes, etc.) are stripped before matching, so tricks like 外 挂 or f-u-c-k can't slip through
- GUI Task Creation: Create tasks through an in-game GUI. Material tasks require placing the requested item in a dedicated slot and entering the amount; the placed item is never taken from the player, and nothing can be extracted from the GUI
- Daily Publish Limit: Limit how many tasks a player can publish per day (default: 2)
- Task Broadcast: Publishers can broadcast their pending tasks to all online players with a clickable claim link
- GUI Menu: In-game GUI for browsing tasks by type, viewing your own tasks, and navigating pages
- Auto Cleanup: Automatically delete old pending/claimed tasks after a configurable number of days
- SQLite Storage: All tasks are persisted in a local SQLite database
- Full Refund: Deleting an unclaimed task refunds the full amount (reward + service fee) to the publisher
Requirements
- Java 21
- Paper/Purpur 1.21.x
- Vault (with a compatible economy plugin)
Installation
- Download the latest
SyBountyTask-x.x.x.jar
- Place the jar file in your server's
plugins/ directory
- Restart your server
- Edit
plugins/SyBountyTask/config.yml as needed
- Use
/sybt reload to apply config changes without restarting
Commands
| Command |
Description |
/sybt open |
Open the bounty task center GUI |
/sybt create |
Open the task creation GUI (recommended) |
/sybt task <type> <title> <details> <reward> |
Publish a task via command (build/monster only, types 2/3) |
/sybt get <taskID> |
Claim a task |
/sybt br <taskID> |
Broadcast your pending task to all online players |
/sybt complete <taskID> |
Submit a task for review (claimers only) |
/sybt submit <taskID> |
Confirm material submission (material tasks only) |
/sybt confirm <taskID> |
Confirm task completion and release the reward (publishers only) |
/sybt delete <taskID> |
Delete an unclaimed task (full refund) |
/sybt reload |
Reload the config (admin only) |
Material tasks must be published through the GUI to select the required item; the command path no longer supports material tasks.
Task Types
| ID |
Type |
Description |
| 1 |
Material |
Claimer submits the registered item in the registered amount; the publisher collects the materials after confirmation |
| 2 |
Build |
Building/construction task, verified by the publisher |
| 3 |
Monster |
Monster hunting task, verified by the publisher |
Permissions
| Permission |
Description |
Default |
sybt.use |
Access to basic SyBountyTask commands |
true |
sybt.admin |
Access to admin commands (reload) |
op |
Configuration
# Service fee rate (0.0 - 1.0, e.g., 0.05 = 5%)
service-fee: 0.05
# Maximum tasks a player can publish per day
max-daily-tasks: 2
# Auto-delete tasks older than X days
auto-delete-days: 7
# Database file name
database-file: "tasks.db"
# Text length limits
max-title-length: 50
max-details-length: 200
# Maximum item amount that can be requested by a material task
max-item-amount: 2304
# Banned words for task title and details (case-insensitive, freely editable)
banned-words:
- "外挂"
- "作弊"
- "刷钱"
- "诈骗"
- "广告"
- "shit"
- "fuck"
# Messages (supports & color codes)
messages:
prefix: "&6[悬赏任务] &r"
task-created: "&a任务创建成功!任务ID: &e%id%"
task-deleted: "&c任务已删除!"
task-claimed: "&a你已成功认领任务: &e%title%"
task-completed: "&a任务已完成,等待发布者验收..."
task-confirmed: "&a任务验收完成,报酬已发放!"
task-not-found: "&c任务不存在!"
task-already-claimed: "&c该任务已被认领!"
task-not-yours: "&c这不是你的任务!"
not-enough-money: "&c你的余额不足!需要: &e%amount%"
max-tasks-reached: "&c你今天发布的任务数量已达上限!"
banned-word-detected: "&c任务标题或详情包含违禁词,请修改后重试!"
broadcast-format: "&6[任务广播] &e%player% &f发布了一个新任务: &a%title% &7(ID: %id%)"
material-complete: "&a玩家 &e%player% &a已完成物资任务,请点击下方按钮领取物资!"
build-complete: "&a玩家 &e%player% &a已完成建造任务,请前往验收!"
monster-complete: "&a玩家 &e%player% &a已完成打怪任务,请确认验收!"
received-material: "&a你已成功领取物资!"
received-reward: "&a你已获得报酬: &e%amount%&a!"
item-not-set: "&c请先在发布界面的物品槽中放入一个需要的物品!"
item-amount-not-set: "&c请先设置需要的物品数量!"
title-not-set: "&c请先设置任务标题!"
details-not-set: "&c请先设置任务详情!"
reward-not-set: "&c请先设置任务报酬!"
material-not-enough: "&c物资不足!需要 &e%amount%x %item%&c,当前只有 &e%has%&c。"
material-command-blocked: "&c物资任务需要在GUI中发布,请使用 &e/sybt open &c后点击“发布任务”。"
task-cost-charged: "&7发布任务已扣除: &6%total% &7(报酬: &6%reward% &7+ 服务费: &6%fee%&7)"
How It Works
Escrow Payment Flow
- Publish: The publisher pays
reward + service fee upfront; the funds are held by the platform. For material tasks, the requested item template and amount are set in the GUI (the placed item is never taken from the player).
- Claim: A player claims a pending task.
- Complete: The claimer submits the completed task for review. Material tasks deduct the registered item and amount from the claimer's inventory; a shortfall is reported with the difference.
- Confirm: The publisher verifies the work and confirms. The platform releases the reward to the claimer; the service fee is kept by the platform. For material tasks, the materials are delivered to the publisher (dropped at their feet if their inventory is full).
- Delete: If the publisher deletes an unclaimed (pending) task, the full amount (reward + service fee) is refunded.
评论 0
登录后参与评分
还没有评论,来抢沙发吧