EasyBuild (委托插件)

由OceanStudio开发

插件简介(中文)

EasyBuild 是一个“委托建筑”管理插件，让管理员发布建筑任务，玩家在指定区域承包、施工、提交验收，并自动发放经济奖励。
支持进入/建造权限控制、合作伙伴、工期与奖励、可点击消息与GUI、可视化列表、传送与详情查看。
安装要求

依赖插件：必须安装 Vault；可选安装 XConomy（若安装则优先通过命令结算）。
经济插件：任意与 Vault 兼容的经济实现（例如 EssentialsX Economy、CMIEconomy 等），或直接使用 XConomy。
放置插件：将 easybuild--.jar 放到 plugins/，重启服务。

快速开始

确认控制台出现“已连接到Vault经济系统”或“检测到XConomy插件”提示。
管理员用命令创建委托区域与参数。
玩家进入委托区域用命令承包并开始施工。
完工后玩家提交验收，管理员在区域内执行验收决定，系统自动发放奖励并通知相关玩家。
主要命令（玩家）

cbwt 承包委托：站在委托区域内执行，承包后状态变为“建设中”。
wtwg 提交完工：将状态设为“已完工”，等待管理员验收。
fcwt 放弃委托：释放当前承包，使其回到“未承包”。
wt 查看委托列表：可点击打开详情。
wtinfo <委托ID> 查看委托详情：显示状态、坐标、工期、奖励等，并提供传送按钮。
wttp <委托ID> 传送到委托位置：传送到区域中心的安全位置。
wtadd <玩家名> 添加合作伙伴：承包人可添加1名合作伙伴共同施工。
wtqx 权限管理菜单：在区域内打开GUI，设置进入/建造权限为“关闭/开启/自定义白名单”。
主要命令（管理员/OP，需 easybuild.admin）

wtcj <x1,y1,z1> <x2,y2,z2> <名称> <工期天数> <报酬> <描述> 创建委托区域与任务。
示例：/wtcj 100,64,200 150,100,250 小店建设 7 1000 请建造一个小商店
坐标格式为数字三元组 x,y,z，世界取执行者当前世界。
yswt <y/n> 在委托区域内验收“已完工”委托：
y 通过：弹出可点击按钮进行“确认发放奖励/修改奖金金额/设置验收成功语句”。
n 未通过：弹出可点击按钮进行“结束建设并发送原因/延期建设/设置未通过语句”。
wtset <委托名称> 管理菜单：交互式设置状态或延长工期。
wtdel <委托名字> 删除委托：直接移除指定委托。
内部按钮命令（仅通过可点击按钮触发）：confirm_review、modify_reward、terminate_commission、extend_commission、set_approval_message、set_rejection_message。
权限与区域保护

进入与建造限制仅在“建设中”状态生效；“未承包”和“已完工”不限制。
权限模式：
进入权限：OPEN 所有人；CLOSED 仅建设者（承包人+合作伙伴）；CUSTOM 建设者 + 指定白名单。
建造权限：同上模式，单独设置。
在区域内执行 wtqx 打开权限GUI，选择关闭/开启或输入白名单玩家名（支持多个，空格分隔）。
经济与验收

奖励发放采用“承包人与合作伙伴平分”（总额 ÷ 人数）。
经济结算优先使用 XConomy 命令；失败则使用 Vault API；格式化金额采用经济插件格式。
验收通过后会自动向承包人和合作伙伴发送消息；玩家上线会收到未读消息提醒。
管理员可在验收界面修改发放金额或设置验收成功/未通过的自定义语句。
数据与配置

数据目录：plugins/EasyBuild/
commissions.yml 委托数据（区域、状态、工期、奖励、权限白名单、验收消息等）。
messages.yml 玩家通知消息（加入时推送未读）。
config.yml 基础配置，包含 language。
多语言：内置 zh_CN, en_US, ru_RU, ja_JP, ko_KR，从 JAR 的 lang/messages_.yml 读取；缺失时回退 zh_CN。
修改语言：在 config.yml 设置 language: en_US 等，重启服务器生效。
常见问题

“不在任何委托区域内”：需要站在管理员创建的坐标范围内。
“已承包无法承接其他委托”：同一玩家同时仅能承包一个“建设中”委托。
“经济功能不可用”：安装并启用 Vault + 经济插件或 XConomy，检查控制台初始化日志。
“坐标格式错误”：请严格使用 x,y,z 三段数字，勿含空格与其他字符。
兼容性说明

——

Overview

EasyBuild is a “commissioned building” plugin: admins define a build area and task, players contract it on-site, build, submit for review, and receive automatic payouts.
Includes entry/build permission control, partners, duration and rewards, clickable chat/UI, list view, teleport, and detailed info.
Requirements

Dependencies: Vault is required; XConomy is optional (used first if present).
Economy: Any Vault-compatible economy (EssentialsX Economy, CMIEconomy, etc), or XConomy.
Install: Drop easybuild--.jar into plugins/, then restart.

Quick Start

Check console for “Connected to Vault” or “Detected XConomy”.
Admin creates a commission with region and parameters.
Player enters the area, contracts, and starts building.
When done, player submits completion; admin reviews inside the region; system pays out and notifies.
Player Commands

cbwt Contract commission: run inside the area; sets status to “In Progress”.
wtwg Submit completion: moves to “Completed”, awaiting admin review.
fcwt Abandon commission: releases current contract back to “Uncontracted”.
wt List commissions: clickable entries to open details.
wtinfo Show details: status, coords, duration, reward; includes teleport button.
wttp Teleport to the commission area center safely.
wtadd Add a partner: contractor can add up to one partner.
wtqx Permission GUI: open in-area to set entry/build modes “Closed/Open/Custom whitelist”.
Admin Commands (easybuild.admin)

wtcj <x1,y1,z1> <x2,y2,z2>
Example: /wtcj 100,64,200 150,100,250 ShopBuild 7 1000 Build a small store
yswt <y/n> Review inside the area:
y approve: clickable actions for “confirm payout/modify reward/set approval message”.
n reject: clickable actions for “terminate with reason/extend duration/set rejection message”.
wtset Management menu: interactive status change or duration extension.
wtdel Delete a commission immediately.
Internal button commands: confirm_review, modify_reward, terminate_commission, extend_commission, set_approval_message, set_rejection_message.
Permissions & Protection

Entry/build restrictions apply only in “In Progress”; “Uncontracted/Completed” are unrestricted.
Modes:
Entry: OPEN everyone; CLOSED builders only; CUSTOM builders + whitelist.
Build: same modes independently.
Use wtqx inside the area to open GUI and set modes or input whitelist player names.
Economy & Review

Rewards split evenly among contractor and partner(s).
Settlement first tries XConomy commands; falls back to Vault API; amounts formatted via the economy plugin.
Approved reviews send messages to contractor/partners; unread messages display on player join.
Admin can modify payout or set custom approval/rejection messages.
Data & Configuration

Directory: plugins/EasyBuild/
commissions.yml commission data (region, status, duration, reward, permission lists, messages).
messages.yml player notifications (pushed on join).
config.yml contains language.
Languages: zh_CN, en_US, ru_RU, ja_JP, ko_KR via lang/messages_.yml inside JAR; fallback to zh_CN.
Change language in config.yml with language: en_US and restart.
FAQ

“Not in any commission area”: stand within an admin-defined region.
“Already contracted another commission”: one active “In Progress” commission per player.
“Economy not available”: install and enable Vault + economy or XConomy; check console init logs.
“Coordinate format error”: strictly use x,y,z triplets without spaces.
Compatibility

Designed for Bukkit/Spigot API platforms (Spigot/Paper/Purpur/Folia/Bukkit).
Proxy (Velocity/BungeeCord/Waterfall) and mod platforms (Forge/NeoForge/Fabric/Quilt) require separate adaptation; provided JARs there are archival builds and not fully functional today.