Unity

Если вы создавали игры в Unity, есть несколько ключевых отличий, которые вам нужно знать, чтобы начать работу в All Out!

---

Если вы переходите с Unity, вам будет привычно сущности + компоненты, иерархия, инспектор, и переиспользуемые префабы. Самое большое изменение мышления состоит в том, что игры All Out — в первую очередь многопользовательские: состояние игрового процесса синхронизируется за вас, и большую часть логики вы пишете так, как будто по умолчанию она сервер-авторитетная.

Кратко: что отличается от Unity

• Мультиплеер по умолчанию: состояние игрового процесса автоматически реплицируется с сервера на клиентов. Обычно вы не пишете RPC, SyncVars или логику спавна Netcode.

• Осознанно выбирайте, где выполняется код:

  • Используйте игровые входные данные/UI, влияющие на состояние, на сервере + локальном клиенте (см. is_local_or_server() паттерны в руководстве по авторингу CSL).

  • Используйте чисто косметическую логику только локально.

• Избегайте глобального состояния singleton: несколько игроков подключаются к одной и той же сессии. Предпочитайте хранить состояние на игроке или в компонентах мира.

• Сначала мобильные устройства: избегайте предположений только о клавиатуре, если только ваша игра явно не ориентирована на ПК.

Сопоставление концепций (Unity → All Out)

Unity	All Out
Сцена	Сцена (мир)
GameObject	Сущность
Transform	Трансформ сущности (позиция/поворот/масштаб)
Компонент / MonoBehaviour	Компонент (класс CSL, производный от Компонент)
Префаб	Артeфакт префаба (создаётся в редакторе)
Окно иерархии	Иерархия
Окно инспектора	Инспектор
Instantiate(prefab)	instantiate(prefab_asset)
Start() / Update()	ao_start / ao_update(dt) жизненный цикл

Структура проекта: где находятся «скрипты» и «ресурсы»

• Скрипты: код вашей игры находится в .csl файлах. Новые проекты начинаются с main.csl который импортирует движок и определяет точки входа жизненного цикла. См. Начало работы с CSL.

• Ресурсы: игровые ресурсы находятся в каталоге /res вашего проекта и на них ссылаются по пути без префикса /res (пример: "ui/button.png"). См. Ресурсы и ресурсы данных.

Импорты (важное отличие)

В Unity каждый скрипт C# компилируется и может использовать собственные директивы using . В All Out держите импорты централизованными:

• Импортируйте "core:ao" в main.csl

• Если вы добавляете папку (например, ui/), импортируйте папку один раз в main.csl

• Избегайте добавления импортов в другие файлы

Пример:

// main.csl
import "core:ao"
import "ui" // необязательно: подхватывает все файлы в /scripts/ui в область видимости

Жизненный цикл: MonoBehaviour → CSL

В Unity обычно вы прикрепляете MonoBehaviour к GameObject и реализуете:

• Start() / Awake()

• Update() / LateUpdate()

• OnDestroy()

В CSL вы обычно используете:

• Глобальные proc в main.csl (для настройки на уровне игры)

• Методы жизненного цикла компонентов в ваших компонентах

Пример компонента:

// orbiter.csl
Orbiter :: class : Component {
    center: v2;
    radius: float;
    speed: float;
    angle: float;

    ao_start :: method() {
        center = entity.local_position;
        радиус = 2.0;
        скорость = 1.0;
        угол = 0.0;
    }

    ao_update :: method(dt: float) {
        angle += speed * dt;
        смещение := v2{cos(angle) * radius, sin(angle) * radius};
        entity->set_local_position(center + offset);
    }
}

Для дополнительного контекста по модели жизненного цикла см. Жизненный цикл игры/кадра.

Префабы: Unity Prefabs → All Out Prefabs

Префабы All Out создаются в редакторе и могут переиспользоваться или создаваться во время выполнения.

• Создать: см. Префабы

• Создать во время выполнения:

spawn_enemy :: proc() {
    prefab := get_asset(Prefab_Asset, "Enemies/BasicEnemy.prefab");
    e := instantiate(prefab);
    e->set_local_position({10, 5});
}

Система префабов находится в стадии развития. См. раздел ограничений в документации по префабам.

«Сериализуемые поля» (переменные, видимые в Inspector)

Unity использует [SerializeField] и публичные поля, чтобы отображать значения в Inspector. В CSL используйте @ao_serialize чтобы показать поле в редакторе.

DamageOnTouch :: class : Component {
    @ao_serialize
    damage: int = 10;
}

Затем добавьте ваш компонент к сущности в Инспектор и настраивайте значения для каждой сущности отдельно.

Создание и поиск: Instantiate/Find → API сцены

Паттерны Unity:

• new GameObject() / Instantiate()

• FindObjectOfType<T>(), GetComponentsInChildren<T>()

Паттерны All Out:

// Создание и уничтожение сущностей
e := Scene.create_entity();
e->set_local_position({0, 0});
e->destroy();

// Итерирование по сущностям (когда вам действительно нужно «всё»)
foreach e2: entity_iterator() {
}

// Итерирование по компонентам определённого типа
foreach player: component_iterator(My_Player) {
}

Столкновения и триггеры: по умолчанию «без колбэков»

Если вы привыкли к OnTriggerEnter / OnCollisionEnter, учтите, что CSL не полагается на колбэки столкновений для игрового скриптинга. Распространённый паттерн — запрашивать близлежащие компоненты и проверять расстояния.

nearby: [..]Pickup;
Scene.get_all_components_in_range(entity.local_position, 2.0, ref nearby);

for p: nearby {
    // проверить расстояние / применить эффект / и т. д.
}

Мышление для мультиплеера: ввод, UI и «где выполняется код»

В Unity вы часто можете предполагать, что «мой клиент владеет моим персонажем». В All Out думайте в терминах server-authoritative:

• Ввод/UI, влияющие на игровой процесс: выполняйте там, где это может влиять на авторитетное состояние (обычно сервер + локальный клиент)

• Косметика: только локально

См. руководство по авторингу CSL с примерами использования is_local_or_server() vs is_local().

Частые подводные камни при переходе с Unity на All Out

• Менеджеры-одиночки: предпочитайте состояние на уровне игрока или сущности вместо глобальных GameManager -подобных singleton.

• Привычки импорта: импортируйте движок и папки из main.csl (не разбрасывайте импорты по многим файлам).

• Предположение о singleplayer: всегда думайте: «что произойдёт, если подключены 10 игроков?»

• Жёстко заданный ввод для десктопа: избегайте обязательного использования клавиатуры/мыши, если это не задумано специально.

Куда двигаться дальше

• Начало работы с CSL

• Иерархия

• Инспектор

• Префабы