- GUI: custom-rendered Satura screen (sidebar, pages, cards, sliders, status bar); old vanilla-widget screen removed; texts in lang files - Flight: constant height per Y window (default hover 2), eased velocity, flight enabled like a double jump (sends abilities update), pause when flight is unavailable (/fly hint) and auto-resume; default flySpeed 0.5 - Planner offers only cells with contact (below or side); unsupported cells wait - GroundWalk/BaritoneWalk walk to a stand block next to the cell, never off an edge (sneak guard); Baritone goal is a block instead of the target column - Profiles: named profiles, active profile persisted, .build profile, GUI page - MSDF fonts moved to assets/satura/msdf (vanilla tried to parse them as fonts) - Tests for stand finder, edge guard, planner support, flight, profiles |
||
|---|---|---|
| config | ||
| gradle/wrapper | ||
| libs | ||
| src | ||
| .gitignore | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle.kts | ||
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.