Server-authoritative mass building for Minecraft Java
Fabric client · Paper/Leaf plugin · command + chat protocol (no custom payload)
English manual · 简体中文手册 · Architecture · Protocol · Configuration
- Radial build menu (hold key, release to select) with place / break by held item
- Server-authoritative shapes — client sends anchors only; server regenerates and validates
- Economy (Vault) + materials (inventory / optional shulker boxes)
- Tool-aware breaking with durability floor and effective-tool checks
- CoreProtect logging under the player name (when the API is available)
- Partial refunds for unfinished per-block / per-area charges
 Single |
 Line |
 Wall |
 Floor |
 Cube |
 D-Line |
 D-Wall |
 Slope |
 Circle |
 Cylinder |
 Sphere |
 Pyramid |
 Cone |
| Module | Role |
|---|---|
maxfastbuild-api |
Platform-neutral contracts |
maxfastbuild-core |
Shapes, billing, protocol, tasks |
maxfastbuild-storage |
SQLite tasks / ledger / escrow |
maxfastbuild-fabric |
Fabric client (26.2 target; + optional server entry) |
maxfastbuild-paper |
Paper/Leaf plugin (api-version 1.21 → 1.21.11+, including 26.2) |
- Java 21+ (25 recommended for 26.2 stacks)
- Server: Paper/Leaf 1.21.11+ (plugin
api-version: 1.21; also loads on newer lines such as 26.2) - Client (optional): Fabric Loader ≥ 0.19.3, Fabric API matching the client game version (e.g. 26.2)
- SQLite: not bundled in the plugin jar — use the server’s JDBC /
sqlite-jdbcon the classpath (Paper often ships libraries; otherwise add the driver) - Soft-depend: Vault, CoreProtect
./gradlew buildArtifacts:
- Release folder (preferred):
release/MaxFastBuild-Paper-<version>.jar,release/MaxFastBuild-Fabric-<version>.jar
Filled automatically by./gradlew build(copyReleaseJars). - Local Leaf test server: if
../test-server-leaf/exists, Paper jar is also copied to
../test-server-leaf/plugins/MaxFastBuild.jar(deployPaperToLeaf, after:maxfastbuild-paper:jar/build). - Module outputs:
maxfastbuild-paper/build/libs/,maxfastbuild-fabric/build/libs/
./gradlew build
# or only plugin + deploy:
./gradlew :maxfastbuild-paper:jar deployPaperToLeaf- Put the Paper plugin jar in the server
plugins/folder. - Put the Fabric client jar (and Fabric API) in the client
mods/folder. - Configure
plugins/MaxFastBuild/config.yml(economy, CoreProtect, shulkers, limits). - Restart the server; join with the client mod.
Player controls and workflows: English / 中文.
| Surface | Files |
|---|---|
| Fabric client UI / HUD / errors | maxfastbuild-fabric/.../lang/en_us.json, zh_cn.json |
| Paper message templates (not loaded yet; protocol keys + hard-coded admin strings) | maxfastbuild-paper/.../messages_en_us.yml, messages_zh_cn.yml |
| Player manuals | docs/USER_MANUAL_en_US.md, docs/USER_MANUAL_zh_CN.md |
Protocol responses use translation keys (e.g. maxfastbuild.task.accepted); the client resolves them with language files.
Client → server (no custom channel):
/__mfb place <mode> x1 y1 z1 x2 y2 z2 hollow material
/__mfb break <mode> x1 y1 z1 x2 y2 z2 hollow
Server → client: system chat marked with U+2063MFB1: + JSON (messageKey + data).
Details: docs/protocol.md.
LGPL-3.0-only — see LICENSE and NOTICE.
Interaction concepts inspired by Effortless Building (Requios) and related work; MaxFastBuild uses a separate transport, billing, persistence, and audit design.
See CONTRIBUTING.md. Please use Conventional Commits.