sanspie
f22242e5aa
ci / release (push) Successful in 5m5s
ci-platforms / build (amd64, windows, windows-2022) (push) Skipped
ci-platforms / build (arm64, darwin, macos-15) (push) Skipped
ci-platforms / build (amd64, darwin, macos-15-intel) (push) Skipped
ci / checks (push) Successful in 4m41s
ci / build (amd64, linux, ubuntu-24.04) (push) Successful in 7m14s
The remaining editor strings and undo step names; component, field, enum, setting, diagnostic and Script API texts under schema.*, enum.*, setting.*, diag.* and api.*; the launcher, the in-game Settings View with a Language setting, the CLI and aego schema show --lang. Every documentation page has a .ru.md translation; the site has a full Russian tree with hreflang, a language switch and ru/llms.txt; aego docs check --lang ru. New doc.tutorial and doc.recipe icons. Fix: an animator restored by a rewind prepares its controller before the replayed step.
66 lines
4.4 KiB
Markdown
66 lines
4.4 KiB
Markdown
---
|
||
id: quickstart
|
||
---
|
||
# Первый проект
|
||
|
||
Десять минут от пустой папки до спрайта, которым вы управляете, — и экспорт в папку, которую можно отправить другу.
|
||
|
||
## 1. Создайте проект
|
||
|
||
Откройте Aego. Нажмите **Новый проект**, выберите **2D**, назовите проект `hello`, выберите, где он будет лежать, и нажмите **Создать**. Редактор откроет главную сцену проекта: камеру и спрайт.
|
||
|
||
## 2. Осмотритесь
|
||
|
||
Слева панель «Иерархия» показывает узлы сцены. Справа «Инспектор» показывает компоненты выбранного узла и их поля. В середине панель «Сцена»: перетаскивайте, чтобы сдвинуть вид, крутите колесо для масштаба, щёлкните узел, чтобы выбрать его. Нажмите **Играть** (или Ctrl+P): панель «Игра» покажет то, что видит игрок. Нажмите **Остановить**, чтобы вернуться.
|
||
|
||
## 3. Заставьте его двигаться
|
||
|
||
В «Ассетах» щёлкните правой кнопкой папку `scripts/game` и выберите **Создать → Скрипт…**. Назовите его `Spinner` и нажмите **Создать**. Откроется редактор скриптов с пустым скриптом; добавьте в него `Update`:
|
||
|
||
```aes
|
||
package game
|
||
|
||
script Spinner {
|
||
func Update(dt float) {
|
||
node.SetRotation(node.Rotation() + dt)
|
||
}
|
||
}
|
||
```
|
||
|
||
Сохраните (Ctrl+S). Выберите спрайт, нажмите **Добавить компонент** в «Инспекторе», наберите `spinner` и выберите **Spinner**. Нажмите «Играть»: спрайт вращается. Замените `dt` на `dt * 3`, пока игра идёт, и сохраните — он закрутится быстрее без перезапуска. Это горячая перезагрузка, она работает для любого скрипта.
|
||
|
||
## 4. Добавьте управление
|
||
|
||
Замените скрипт на версию с вводом:
|
||
|
||
```aes
|
||
package game
|
||
|
||
import "aego/input"
|
||
|
||
script Spinner {
|
||
func Update(dt float) {
|
||
p := node.Position()
|
||
p.X += input.Axis("Move") * 5 * dt
|
||
node.SetPosition(p)
|
||
}
|
||
}
|
||
```
|
||
|
||
`Move` — действие ввода: по умолчанию стрелки и A/D, а если подключён геймпад — его стик. Действия задаются в **Настройках проекта → Ввод**; добавляйте там свои.
|
||
|
||
## 5. Перемотайте её
|
||
|
||
Во время игры нажмите F6, чтобы поставить паузу, и потяните таймлайн внизу панели «Игра». Игра пойдёт назад к выбранному кадру и снова вперёд — каждый кадр ровно так, как он был. F7 делает шаг на один фиксированный тик.
|
||
|
||
## 6. Экспортируйте её
|
||
|
||
**Файл → Экспорт…** открывает панель «Экспорт». Выберите платформу **Веб**, папку вывода и нажмите **Экспорт**. Нажмите **Запустить**: панель раздаст папку через локальный сервер, и игра откроется в браузере. Для нативной сборки выберите **Linux**, **Windows** или **macOS**; для системы, отличной от вашей, нужны Go и исходники движка, см. [Установка Aego](ref:install).
|
||
|
||
## Что дальше
|
||
|
||
- [Платформер с нуля](ref:platformer) — персонаж, камера, яма, монеты и враг, шаг за шагом.
|
||
- [Руководство по редактору](ref:editor) — все панели и сочетания клавиш.
|
||
- [Aego Script](ref:language) — язык за одно чтение.
|
||
- [Работа с агентами](ref:agents) — пусть ИИ-агент собирает и проверяет сцены вместе с вами.
|