satura/README.md
loki5512344 e2bdf031a8
Add GUI tabs, strategy presets and Baritone bridge wiring
- GUI: three tabs (Build / Placement / Supply placeholder)
- Presets max/safe/custom: BuildSettings.applyPreset, `.build preset`
- BaritoneBridge implements Walker and is passed to BuilderFeature.create
- Tests for the preset subcommand
2026-10-31 18:35:25 +01:00

6.8 KiB
Raw Blame History

Satura — авто-билдер для Minecraft (Fabric)

Клиентский мод: выделяешь область — мод сам ходит/летает и строит заданную форму. GUI-меню, команды .pos1/.pos2/.sel/.build, навигация через Baritone (Aethereal), инкрементальный подсчёт прогресса, ремонтные проходы по дырам.

Что Версия
Minecraft 1.21.11
Fabric Loader 0.20.1
Fabric API 0.141.6+1.21.11
Yarn mappings 1.21.11+build.6
Loom 1.18.4 (нужна JVM 25 для запуска Gradle)
Java 21 (target), 25 (JVM сборки)

Сборка и запуск

./gradlew build        # jar в build/libs/satura-<версия>.jar
./gradlew check        # тесты + checkstyle + pmd (гейт проекта)
./gradlew runClient    # dev-запуск игры с модом

Gradle запускается на JVM 25: если дефолтная JVM другой версии, укажи её в gradle.properties (org.gradle.java.home) или ключом -Dorg.gradle.java.home=.... Для dev-запуска с Baritone положи aethereal-1.21.11.jar в libs/.

Использование

Клавиши (настраиваются в ванильных «Управлении», категория Satura)

Клавиша Действие
Right Shift открыть/закрыть меню билдера
P макрос: пауза / продолжить текущий билд

Команды (префикс .)

Команда Действие
.pos1 / .pos2 задать углы области по позиции ног
.sel clear сбросить выделение
.build start / pause / resume / stop / status управление стройкой
.build block <id> блок (stone, minecraft:glass или hand — блок из руки)
.build shape box|checker|walls форма застройки области
.build layers 1..3 слоёв за один проход колонны
.build strategy <id> стратегия постановки (см. таблицу ниже)
.build preset max|safe|custom пресет: «макс» (S1+S2, задержка 0) или «безопасный» (S3+S5, задержка 150 мс)
.build set <ключ> <знач> параметр стратегии (delayMs, reach, hover, flySpeed, bandLayers, burst)

GUI (Right Shift)

Экран из трёх вкладок.

Стройка — Pos1/Pos2 (позиция ног), Старт/Пауза/Стоп, форма, тема (оранжевый/белый/мятный/песочный акцент, выбор сохраняется в config/satura/render.json), ID блока (Enter — применить).

Постановка — стратегия (циклическая кнопка — панель параметров выбранной стратегии перестраивается автоматически), пресеты одним кликом: max (S1+S2, задержка 0 мс), safe (S3+S5, задержка 150 мс — для серверов с анти-читом), custom (текущие значения); слайдеры параметров стратегии.

Снабжение — появится в фазе 11 (маршруты до сундуков, телепорты, авто-подбор).

Внизу — живой статус: этап, прогресс, блоков/с, дыры. Во время стройки тот же статус раз в секунду дублируется над хотбаром.

Стратегии постановки

id Что делает Референс
band_stack (дефолт) полёт над слоем, 1–3 слоя за визит колонны, клик под собой yatwinkle
column_drop то же, но по одному слою за визит yatwinkle
precise хавер над колонной + точный выбор опоры (UP → бока → DOWN), LOS-проверка, до 12 ретраев на ячейку pveclient
fly_hover полёт к точке стояния (клик + нормаль × 2.4), скорость min(0.34k, max(0.08k, dist·0.35k)) pveclient FLY
ground_walk ходьба фейк-клавишами + пиллар-прыжки с постановкой под себя — для серверов без полёта AutoBuild
baritone_walk Baritone только ходит (GoalXZ, allowBreak/Place=false), ставим по подходе (precise) AutoBuild
hold_rmb ставит только пока зажата ПКМ (ручной контроль) yatwinkle HOLD_RMB
burst несколько кликов за тик (1–8), pending-сет с TTL 3 тика, AIMD сам снижает burst/растит задержку при отказах свой

Для серверов с анти-читом: band_stack/column_drop/burst шлют клики без доворота камеры и летят через setVelocity — их могут флагать; безопасный дефолт — precise или ground_walk (меньший delayMs, наземное перемещение).

Настройки хранятся в config/satura/default.json и применяются при старте.

Архитектура

Слои зависимостей направлены строго вниз, циклы запрещены:

mixin → feature → interaction → core → util
gui → feature (только через фасад BuilderFeature)
  • core — событие/команды/конфиг, ничего не знает о фичах;
  • feature/builder — селекция, план (формы), скан (ColumnCache), движок, Baritone-мост;
  • interaction — «руки»: постановка блоков (8 стратегий), инвентарь, движение;
  • gui — экран и виджеты, общается с фичей только через фасад;
  • render — GUI-рендер (rect/blur/outline/MSDF-текст), палитры Theme и рамка выделения в мире.

Правила кода: максимум 250 строк на .java-файл, максимум 4 файла на пакет, магические числа — в константы, гейт сборки — ./gradlew check (Checkstyle + PMD). Подробный план развития — todo.md.

Лицензия

GPL-3.0-only, см. LICENSE.