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

| 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) |

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-<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

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)

| 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.

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.