MaxFastBuild

MaxFastBuild

Server-authoritative mass building for Minecraft Java
Fabric client · Paper/Leaf plugin · command + chat protocol (no custom payload)

English manual · 简体中文手册 · Architecture · Protocol · Configuration

Features

• 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

Build modes

Single	Line	Wall	Floor
Cube	Arc	Array	Slope
Circle	Cylinder	Sphere	Pyramid
Cone

Modules

Requirements

• 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-jdbc on the classpath (Paper often ships libraries; otherwise add the driver)
• Soft-depend: Vault, CoreProtect

Build

./gradlew build

Artifacts:

• Release folder (preferred): `release/MaxFastBuild-Paper-.jar, release/MaxFastBuild-Fabric-.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

Install (quick)

1. Put the Paper plugin jar in the server plugins/ folder.
2. Put the Fabric client jar (and Fabric API) in the client mods/ folder.
3. Configure plugins/MaxFastBuild/config.yml (economy, CoreProtect, shulkers, limits).
4. Restart the server; join with the client mod.

Player controls and workflows: English / 中文.

Internationalization (i18n)

Protocol responses use translation keys (e.g. maxfastbuild.task.accepted); the client resolves them with language files.

Protocol (summary)

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.

License

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.

Contributing

See CONTRIBUTING.md. Please use Conventional Commits.