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

1. Download the latest SyBountyTask-x.x.x.jar
2. Place the jar file in your server's plugins/ directory
3. Restart your server
4. Edit plugins/SyBountyTask/config.yml as needed
5. 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

1. 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).
2. Claim: A player claims a pending task.
3. 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.
4. 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).
5. Delete: If the publisher deletes an unclaimed (pending) task, the full amount (reward + service fee) is refunded.