EasyBuild (委托插件)

由OceanStudio开发

插件简介(中文)

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

依赖插件：必须安装 Vault；可选安装 XConomy（若安装则优先通过命令结算）。 经济插件：任意与 Vault 兼容的经济实现（例如 EssentialsX Economy、CMIEconomy 等），或直接使用 XConomy。 放置插件：将 easybuild-<platform>-<mcversion>.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_<lang>.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-<platform>-<mcversion>.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 <commissionId> Show details: status, coords, duration, reward; includes teleport button. wttp <commissionId> Teleport to the commission area center safely. wtadd <playerName> 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> <name> <days> <reward> <description> 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 <name> Management menu: interactive status change or duration extension. wtdel <name> 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_<lang>.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.