MaxFastBuild

MaxFastBuild

Серверный массовый строитель для Minecraft Java
Fabric-клиент · плагин Paper/Leaf · протокол команд и чата (без кастомных payload)

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

--- ## Возможности - Радиальное меню постройки (зажмите клавишу, отпустите для выбора) с установкой / разрушением предметом в руке - Серверные фигуры — клиент отправляет только опорные точки; сервер пересчитывает и проверяет - Экономика (Vault) + материалы (инвентарь / опционально шалкеры) - Учёт инструментов при разрушении с запасом прочности и проверкой подходящего инструмента - Логирование CoreProtect под именем игрока (при наличии API) - Частичный возврат за незавершённые поблочные / пообластные списания ### Режимы постройки | | | | | |:---:|:---:|:---:|:---:| | Single | Line | Wall | Floor | | Cube | Arc | Array | Slope | | Circle | Cylinder | Sphere | Pyramid | | Cone | | | | ## Модули | Модуль | Роль | |--------|------| | maxfastbuild-api | Платформонезависимые контракты | | maxfastbuild-core | Фигуры, биллинг, протокол, задачи | | maxfastbuild-storage | SQLite задачи / журнал / эскроу | | maxfastbuild-fabric | Fabric-клиент (цель 26.2; + опциональный серверный вход) | | maxfastbuild-paper | Плагин Paper/Leaf (api-version 1.21 → 1.21.11+, включая 26.2) | ## Требования - Java 21+ (рекомендуется 25 для стеков 26.2) - Сервер: Paper/Leaf 1.21.11+ (плагин api-version: 1.21; также загружается на более новых линейках, например 26.2) - Клиент (опционально): Fabric Loader ≥ 0.19.3, Fabric API, соответствующий версии игры клиента (например, 26.2) - SQLite: не входит в jar плагина — используйте JDBC сервера / sqlite-jdbc в classpath (Paper часто поставляет библиотеки; иначе добавьте драйвер) - Soft-depend: Vault, CoreProtect ## Сборка bash ./gradlew build Артефакты: - Папка релиза (предпочтительно): `release/MaxFastBuild-Paper-.jar, release/MaxFastBuild-Fabric-.jar Заполняется автоматически при./gradlew build (copyReleaseJars). - **Локальный тестовый сервер Leaf:** если существует ../test-server-leaf/, jar Paper также копируется в ../test-server-leaf/plugins/MaxFastBuild.jar (deployPaperToLeaf, после :maxfastbuild-paper:jar/build). - Вывод модулей: maxfastbuild-paper/build/libs/, maxfastbuild-fabric/build/libs/ ```powershell ./gradlew build # or only plugin + deploy: ./gradlew :maxfastbuild-paper:jar deployPaperToLeaf ``` ## Установка (кратко) 1. Поместите jar **плагина Paper** в папку plugins/сервера. 2. Поместите jar **Fabric-клиента** (и Fabric API) в папкуmods/клиента. 3. Настройтеplugins/MaxFastBuild/config.yml(экономика, CoreProtect, шалкеры, лимиты). 4. Перезапустите сервер; заходите с клиентским модом. Управление и сценарии: [English](docs/USER_MANUAL_en_US.md) / [中文](docs/USER_MANUAL_zh_CN.md). ## Интернационализация (i18n) | Поверхность | Файлы | |---------|--------| | UI / HUD / ошибки Fabric-клиента |maxfastbuild-fabric/.../lang/en_us.json, zh_cn.json| | Шаблоны сообщений Paper (пока не загружаются; ключи протокола + жёстко прописанные админские строки) |maxfastbuild-paper/.../messages_en_us.yml, messages_zh_cn.yml| | Руководства игрока |docs/USER_MANUAL_en_US.md, docs/USER_MANUAL_zh_CN.md| Ответы протокола используют ключи перевода (например,maxfastbuild.task.accepted`); клиент разрешает их с помощью языковых файлов. ## Протокол (кратко) Клиент → сервер (без кастомного канала): ```text /__mfb place x1 y1 z1 x2 y2 z2 hollow material /__mfb break x1 y1 z1 x2 y2 z2 hollow `` Сервер → клиент: системный чат с меткой U+2063MFB1: + JSON (messageKey+data`). Подробности: docs/protocol.md. ## Лицензия LGPL-3.0-only — см. LICENSE и NOTICE. Концепции взаимодействия вдохновлены Effortless Building (Requios) и связанными работами; MaxFastBuild использует отдельный транспорт, биллинг, хранение и аудит. ## Участие в разработке См. CONTRIBUTING.md. Пожалуйста, используйте Conventional Commits.