AirDef: drones and air defence for a Horizon fork
build / mod (push) Failing after 5m36s
build / game-linux (push) Has been skipped
build / game-macos (push) Has been cancelled
build / game-windows (push) Has been cancelled
build / release (push) Has been cancelled

The mod (airdef-mod/), its generated models and sounds, the fork's patches
over upstream Horizon (horizon-patches/, HORIZON_COMMIT), a cross-platform
build/install/run script (tools/airdef.py), CI that builds and releases on
every push (.gitea/workflows/build.yml) and a setup guide (docs/INSTALL.md).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-28 19:16:52 +03:00
commit a6a13003c2
543 changed files with 31555 additions and 0 deletions
+93
View File
@@ -0,0 +1,93 @@
# AirDef: запуск с нуля (Windows и macOS)
AirDef работает на своей сборке (форке) Horizon: в ней есть API 3D-моделей, звуков и шейдеров, которого нет
в обычном Horizon. Сама игра и её ресурсы берутся из твоего Minecraft — без лицензионного Minecraft Java 26.3
ничего не заработает.
## 1. Общее для обоих способов
1. Купленный **Minecraft: Java Edition** (версия 26.3).
2. **Лаунчер Horizon** — https://playhorizon.dev (раздел Install). Установи его, поставь в нём последнюю версию
и **один раз запусти игру**: лаунчер подготовит ресурсы игры из твоего Minecraft. Форк AirDef берёт их оттуда.
Где что лежит (обычно ничего трогать не нужно):
| | Windows | macOS |
|---|---|---|
| Папка игры (миры, моды, настройки) | `%APPDATA%\horizon` | `~/Library/Application Support/horizon` |
| Ресурсы из лаунчера | `%APPDATA%\horizon-launcher\versions\…\.local\horizon-client\26.3` | `~/Library/Application Support/horizon-launcher/versions/…/.local/horizon-client/26.3` |
## 2а. Готовая сборка из релиза (проще)
В репозитории → **Releases** → последний `build-N`. Там лежат:
- `airdef.hmod` — сам мод;
- `airdef-windows-x86_64.zip`, `airdef-macos-arm64.tar.gz`, `airdef-linux-x86_64.tar.gz` — игра-форк + мод +
скрипт запуска (сборки для Windows и macOS появляются, только если в CI подключены такие раннеры;
иначе — способ 2б).
**Windows:** распакуй zip куда угодно и запусти `play.bat`. Он положит мод в папку игры, включит его и запустит
игру. Конкретный мир: `play.bat --world "Имя мира"` (в командной строке, из папки архива).
Если SmartScreen ругается — «Подробнее → Выполнить в любом случае» (сборка не подписана).
**macOS:** распакуй архив, в Терминале:
```sh
cd ~/Downloads/airdef-macos-arm64
./play.sh # или ./play.sh --world "Имя мира"
```
Скрипт сам снимает карантин с файлов. Если macOS всё же блокирует запуск — «Системные настройки →
Конфиденциальность и безопасность → Всё равно открыть».
## 2б. Сборка из исходников
Нужно: **Git**, **Python 3**, **Rust** (https://rustup.rs). Сборка игры занимает ~5–15 минут и ~5 ГБ на диске.
### Windows
1. Поставь **Git** (https://git-scm.com), **Python 3** (https://python.org, галочка «Add to PATH»),
**Visual Studio Build Tools** с компонентом «Разработка классических приложений на C++»
(https://visualstudio.microsoft.com/visual-cpp-build-tools/), затем **Rust** (`rustup-init.exe` с rustup.rs).
2. В PowerShell:
```powershell
rustup target add wasm32-unknown-unknown
git clone ssh://git@gitea.maoniao.team:2222/chexit/airdef.git
cd airdef
py tools\airdef.py all # форк Horizon + сборка игры + мод + установка мода
py tools\airdef.py play # запуск; мир: py tools\airdef.py play --world "Имя мира"
```
### macOS
1. Инструменты разработчика: `xcode-select --install`, затем Rust:
`curl -sSf https://sh.rustup.rs | sh` (перезапусти Терминал).
2. В Терминале:
```sh
rustup target add wasm32-unknown-unknown
git clone ssh://git@gitea.maoniao.team:2222/chexit/airdef.git
cd airdef
python3 tools/airdef.py all
python3 tools/airdef.py play # или: python3 tools/airdef.py play --world "Имя мира"
```
Шаги по отдельности: `fork` (скачать Horizon и наложить патчи `horizon-patches/`), `game` (собрать игру),
`mod` (собрать `airdef.hmod`), `install` (положить мод в папку игры и включить), `play`.
## 3. В игре
- Создай мир с читами (или включи их через «Открыть для сети»): мод выдаёт пульты и взрывы командами.
- `/airdef give` — пульты, **N** — командный пункт (роли ПВО), **K** — монитор комплекса,
`/airdef wave mix 20` — налёт. Подробнее — README.
- Мод в списке «Настройки → Моды» должен быть включён (скрипты включают его сами).
## Если что-то не так
- **«Не найдены ресурсы игры»** — запусти Horizon из лаунчера хотя бы раз; либо укажи путь вручную:
`HORIZON_RESOURCES=…/.local/horizon-client/26.3` (Windows: `set HORIZON_RESOURCES=…`).
- **Мод в списке, но красный: «made for a newer Horizon»** — игра запущена из лаунчера (обычный Horizon),
а нужен форк: запускай через `play.bat` / `play.sh` / `airdef.py play`.
- **Нет звука или моделей после обновления мода** — перезапусти игру: ресурсы мода грузятся при старте.
- **Тормозит** — `/airdef shader off` (эффекты) и `/airdef damage off` (разрушения).