# Cadmus

> Практические руководства по геймдеву для веб-разработчиков (TypeScript / React / DOM):
> 3D в Unity 6 и Godot 4.x, 2D в Phaser 4. Каждая глава сравнивает игровой движок
> с привычными веб-концепциями (DOM ↔ Scene Tree, useEffect ↔ Update / _process,
> npm ↔ Asset Store) и даёт рабочие примеры кода.

Энциклопедия состоит из трактов: `/unity/`, `/godot/`, `/phaser/`.
Unity и Godot — параллельные 3D-треки на русском (введение, ~20 глав "3D-разработка",
глоссарий). Phaser — 2D-фреймворк на JS/TS и первый двуязычный тракт: русская версия
под `/phaser/`, английская под `/en/phaser/` (старт, концепции, гайды, запускаемые примеры).

Целевая аудитория: фронтенд/бэкенд JS/TS-разработчики, которые впервые подходят
к gamedev. Стиль: технический, без жаргона, с параллелями к веб-стеку.

## Корневые страницы

- [Главная](https://cadmus.page/): сравнительная таблица движков и точки входа.
- [Unity Encyclopedia (index)](https://cadmus.page/unity/): оглавление трека Unity 6 (C#, URP, Cinemachine, NavMesh, Netcode, Addressables, GPU Resident Drawer, Render Graph).
- [Unity Encyclopedia (index, en)](https://cadmus.page/en/unity/): the same track in English.
- [Godot Encyclopedia (index)](https://cadmus.page/godot/): оглавление трека Godot 4.x (GDScript, PackedScene, Forward+/Mobile/Compatibility, Jolt physics, MultiplayerAPI, gdshader).
- [Godot Encyclopedia (index, en)](https://cadmus.page/en/godot/): the same track in English.
- [Phaser 4 Encyclopedia (index)](https://cadmus.page/phaser/): оглавление трека Phaser 4 (JS/TS, сцены, игровой цикл, Arcade/Matter физика, тайлмапы, твины, шейдеры, песочницы).
- [Phaser 4 Encyclopedia (index, en)](https://cadmus.page/en/phaser/): the same track in English.

## Unity — Введение

- [Зачем веб-разработчику Unity](https://cadmus.page/unity/01-intro/01-zachem/): Что общего и что нового в Unity по сравнению с фронтенд- и бэкенд-разработкой.
- [Стек Unity и его экосистема](https://cadmus.page/unity/01-intro/02-stack/): Версии Unity, языки, рендер-пайплайны, ключевые инструменты и пакеты.

## Unity — 3D-разработка в Unity

- [Unity Editor, сцена и иерархия](https://cadmus.page/unity/02-3d/01-editor-i-iyerarkhiya/): Главные окна редактора, GameObject и Transform — DOM 3D-мира.
- [Скрипты и жизненный цикл MonoBehaviour](https://cadmus.page/unity/02-3d/02-monobehaviour/): Как Unity вызывает ваш код — Awake, Start, Update и всё, что между ними.
- [Ввод — Input System и legacy Input](https://cadmus.page/unity/02-3d/03-input/): Клавиатура, мышь, геймпад и тач — два пути и почему стоит идти новым.
- [Физика — Rigidbody, Collider и столкновения](https://cadmus.page/unity/02-3d/04-physics/): Как двигать объекты физикой и реагировать на столкновения.
- [Камера и Cinemachine](https://cadmus.page/unity/02-3d/05-camera-cinemachine/): Виды от первого/третьего лица, виртуальные камеры и плавный follow без матана.
- [Рендеринг, материалы и шейдеры](https://cadmus.page/unity/02-3d/06-rendering/): URP, Material vs Shader, Shader Graph и почему "разноцветные кубики" дорого.
- [Освещение и тени](https://cadmus.page/unity/02-3d/07-lighting/): Directional, Point, Spot — и почему статичный свет можно "запечь" заранее.
- [Анимация и Animator Controller](https://cadmus.page/unity/02-3d/08-animation/): Animation clips, state machine, blend trees — как персонаж не выглядит куклой.
- [3D-аудио и AudioMixer](https://cadmus.page/unity/02-3d/09-audio/): AudioSource, AudioListener, 3D-затухание и маршрутизация через миксер.
- [UI в 3D-игре — uGUI и UI Toolkit](https://cadmus.page/unity/02-3d/10-ui/): Canvas, RectTransform, EventSystem — и две конкурирующие UI-системы.
- [Prefab и ScriptableObject](https://cadmus.page/unity/02-3d/11-prefabs-scriptables/): Переиспользуемые объекты и data-only ассеты — без них проект разваливается.
- [Практика — контроллер от первого лица](https://cadmus.page/unity/02-3d/12-fps-controller/): Соберём минимальный FPS-персонаж с движением, прыжком и стрельбой raycast.
- [Сборка и оптимизация](https://cadmus.page/unity/02-3d/13-build-optimization/): Build Settings, Profiler, бюджет кадра — от готового прототипа к билду.
- [NavMesh и AI — поиск пути и простой ИИ-противник](https://cadmus.page/unity/02-3d/14-navmesh-ai/): Navigation Mesh, NavMeshAgent, базовая стейт-машина для врага.
- [Particle System и VFX Graph](https://cadmus.page/unity/02-3d/15-particles-vfx/): Две системы спецэффектов — когда выбирать каждую, и базовые приёмы.
- [Timeline и кат-сцены](https://cadmus.page/unity/02-3d/16-timeline/): Многодорожечная режиссура внутри Unity — анимация, звук, эффекты по таймкоду.
- [Мультиплеер — Netcode for GameObjects](https://cadmus.page/unity/02-3d/17-multiplayer-netcode/): NetworkObject, NetworkVariable, ServerRpc/ClientRpc — основы сетевой игры.
- [Addressables — современная загрузка ассетов](https://cadmus.page/unity/02-3d/18-addressables/): Асинхронная загрузка по адресу, замена Resources.Load и AssetBundles.
- [HLSL-шейдеры в Unity подробнее](https://cadmus.page/unity/02-3d/19-hlsl-shaders/): Структура ShaderLab + HLSL, vertex/fragment, custom URP shader.
- [Практика — 3rd-person платформер с NavMesh-врагом](https://cadmus.page/unity/02-3d/20-tps-platformer/): Камера-орбита, физический контроллер, double jump, coyote time, преследующий враг и чекпойнты.
- [Splines и процедурные пути](https://cadmus.page/unity/02-3d/21-splines/): Встроенный Splines package в Unity 6, кривые Безье/B-Spline, Cinemachine SplineDolly и spawning along path.
- [Job System и Burst — параллелизм и SIMD](https://cadmus.page/unity/02-3d/22-jobs-burst/): IJob, IJobParallelFor, Burst-компилятор, NativeArray — рабочий путь к высокой производительности.
- [2D в Unity 6 — Box2D v3 и Hybrid Scenes](https://cadmus.page/unity/02-3d/23-2d-and-box2d/): 2D-pipeline, Box2D v3 в Unity 6.3, multi-threaded physics, Hybrid 2D/3D Scenes.
- [XR / OpenXR — VR-приложения в Unity](https://cadmus.page/unity/02-3d/24-xr-openxr/): XR Interaction Toolkit, OpenXR plugin, базовая VR-сцена с teleport, grab и hand-tracking.
- [Editor Scripting — расширение Unity Editor](https://cadmus.page/unity/02-3d/25-editor-scripting/): Custom Inspectors, EditorWindow, MenuItem, Gizmos, ExecuteAlways — расширение редактора Unity.
- [Sentis — ML inference в Unity](https://cadmus.page/unity/02-3d/26-sentis/): ONNX-модели в реальном времени, IWorker, практический пример классификации изображения.
- [Cinemachine — продвинутые техники](https://cadmus.page/unity/02-3d/27-cinemachine-deep/): Confiner, Impulse, Composer, FreeLook, blending, state-driven cameras — углубление в Cinemachine 3.
- [Animation Rigging — процедурная анимация и IK](https://cadmus.page/unity/02-3d/28-animation-rigging/): TwoBone IK, Aim Constraint, Multi-Parent — наложение процедурных слоёв на готовую анимацию.
- [Save / Load — сохранение прогресса](https://cadmus.page/unity/02-3d/29-save-load/): PlayerPrefs, JSON, бинарная сериализация, шифрование, версионирование сейвов.

## Unity — Глоссарий

- [Глоссарий — Unity термины глазами веб-разработчика](https://cadmus.page/unity/03-glossary/01-terms/): Короткие определения ключевых понятий с веб-аналогами.

## Godot — Введение

- [Зачем веб-разработчику Godot](https://cadmus.page/godot/01-intro/01-zachem/): Open-source движок с другой философией — что это даёт разработчику из мира TS/React.
- [Стек Godot и его экосистема](https://cadmus.page/godot/01-intro/02-stack/): Версии Godot 4.x, GDScript vs C#, рендер-пайплайны и ключевые пакеты.

## Godot — 3D-разработка в Godot

- [Godot Editor, сцена и узлы](https://cadmus.page/godot/02-3d/01-editor-stsena-uzly/): Scene tree, Node3D — фундамент всего в Godot.
- [GDScript, lifecycle и сигналы](https://cadmus.page/godot/02-3d/02-gdscript-lifecycle/): Как Godot вызывает ваш код — _ready, _process, _physics_process, signals, await.
- [Ввод — Input Map и action-based система](https://cadmus.page/godot/02-3d/03-input/): Как читать клавиатуру, мышь, геймпад и тач через единую action-систему.
- [Физика — Bodies, Collision, Jolt](https://cadmus.page/godot/02-3d/04-physics/): StaticBody3D, RigidBody3D, CharacterBody3D, Area3D — и почему с 4.6 физика стала быстрее.
- [Камера и Phantom Camera](https://cadmus.page/godot/02-3d/05-camera/): Camera3D, виды от первого/третьего лица, и плагин-аналог Cinemachine.
- [Рендеринг и материалы](https://cadmus.page/godot/02-3d/06-rendering-materials/): Forward+/Mobile/Compatibility, BaseMaterial3D, gdshader — как Godot рисует кадр.
- [Освещение и тени](https://cadmus.page/godot/02-3d/07-lighting/): DirectionalLight3D, OmniLight3D, SpotLight3D, lightmaps и SDFGI.
- [Анимация — AnimationPlayer и AnimationTree](https://cadmus.page/godot/02-3d/08-animation/): AnimationLibrary, state machine, blend spaces, root motion.
- [3D-аудио и AudioBus](https://cadmus.page/godot/02-3d/09-audio/): AudioStreamPlayer3D, маршрутизация через AudioBus, эффекты.
- [UI — Control-узлы и контейнеры](https://cadmus.page/godot/02-3d/10-ui-control/): Control, anchors, контейнеры, Theme и StyleBox.
- [PackedScene и Resource](https://cadmus.page/godot/02-3d/11-packedscene-resource/): Универсальный контейнер сцены/префаба и data-only ассеты.
- [Практика — контроллер от первого лица](https://cadmus.page/godot/02-3d/12-fps-controller/): CharacterBody3D, move_and_slide, RayCast3D — играбельный FPS-каркас.
- [Навигация — NavigationServer и AI](https://cadmus.page/godot/02-3d/13-navigation/): NavigationRegion3D, NavigationAgent3D — поиск пути и преследующий враг.
- [Частицы — GPUParticles3D и CPUParticles3D](https://cadmus.page/godot/02-3d/14-particles/): ParticleProcessMaterial, эмиттеры, sub-emitters, collision.
- [Мультиплеер — MultiplayerAPI и RPC](https://cadmus.page/godot/02-3d/15-multiplayer/): ENet/WebSocket/WebRTC peers, RPC, MultiplayerSpawner и Synchronizer.
- [Загрузка ресурсов — preload, load, threaded](https://cadmus.page/godot/02-3d/16-resource-loading/): Как Godot загружает ассеты — синхронно, асинхронно, с прогрессом.
- [Сборка и оптимизация](https://cadmus.page/godot/02-3d/17-build-optimization/): Export Presets, Profiler, веб-таргет и WASM, чек-лист релиза.
- [Практика — 3rd-person платформер с NavMesh-врагом](https://cadmus.page/godot/02-3d/18-tps-platformer/): PhantomCamera FreeLook, CharacterBody3D, double jump, coyote time, преследующий враг, чекпойнты.
- [gdshader подробнее — vertex, fragment, light](https://cadmus.page/godot/02-3d/19-gdshader-deep/): Структура spatial-шейдера, встроенные функции, uniforms, варинги, шаги оптимизации.
- [Path3D, PathFollow3D и сплайны](https://cadmus.page/godot/02-3d/20-path-splines/): Curve3D, Path3D, PathFollow3D — движение по сплайну, AI-патрули, кат-сцены камеры.
- [GridMap — модульные уровни](https://cadmus.page/godot/02-3d/21-gridmap/): MeshLibrary + GridMap для сборки локаций из переиспользуемых блоков.
- [Threading — WorkerThreadPool и Thread](https://cadmus.page/godot/02-3d/22-threading/): Параллельные задачи в Godot — генерация карт, обработка данных, длинные операции без фриза UI.
- [Decals — наклейки в 3D](https://cadmus.page/godot/02-3d/23-decals/): Decal-узел для bullet holes, граффити, dirt-масок, footprint'ов и других накладок на геометрию.
- [@tool и EditorPlugin — расширение редактора](https://cadmus.page/godot/02-3d/24-tool-editor-plugin/): Tool-скрипты, custom inspectors, EditorPlugin, добавление узлов и docks к редактору Godot.
- [TileMap (2D) — модульные 2D-уровни](https://cadmus.page/godot/02-3d/25-tilemap-2d/): TileMapLayer, TileSet, terrains, autotile, navigation для 2D-проектов в Godot 4.x.
- [XR / OpenXR — VR-приложения в Godot](https://cadmus.page/godot/02-3d/26-xr-openxr/): XROrigin3D, XRCamera3D, XRController3D — базовая VR-сцена для Meta Quest и SteamVR.
- [GDExtension — нативные плагины на C++ и Rust](https://cadmus.page/godot/02-3d/27-gdextension/): godot-cpp, gdext (Rust), когда нужны нативные расширения, как они работают.
- [C# в Godot — практика и нюансы](https://cadmus.page/godot/02-3d/28-csharp-godot/): Godot .NET edition, отличия от GDScript, миграция, gotcha'и для разработчиков из мира Unity.
- [Save / Load — сохранение прогресса](https://cadmus.page/godot/02-3d/29-save-load/): FileAccess, ConfigFile, ResourceSaver, JSON, encryption, user:// пути.

## Godot — Глоссарий

- [Глоссарий — Godot термины и параллели](https://cadmus.page/godot/03-glossary/01-terms/): Короткие определения с веб-аналогами и параллелями к Unity.

## Phaser — Старт

- [Что такое Phaser 4?](https://cadmus.page/phaser/01-start/what-is-phaser-4/): Знакомство с Phaser 4 — что это такое, чем он не является и чем отличается от Phaser 3.
- [Установка](https://cadmus.page/phaser/01-start/installation/): Установка Phaser 4 через npm или CDN и проверка установки на однострочной сцене.
- [Ваша первая сцена](https://cadmus.page/phaser/01-start/first-scene/): Создание и запуск вашей первой сцены Phaser 4 — прыгающего логотипа — в изолированной песочнице.
- [Настройка проекта](https://cadmus.page/phaser/01-start/project-setup/): Рекомендуемая структура проекта, инструменты сборки и настройки TypeScript для серьёзных проектов на Phaser 4.

## Phaser — Концепции

- [Основные концепции](https://cadmus.page/phaser/02-concepts/00-overview/): Ментальная модель, лежащая в основе Phaser 4 — для чего нужна каждая подсистема и как они сочетаются друг с другом.
- [Игровой цикл](https://cadmus.page/phaser/02-concepts/game-loop/): Как Phaser 4 планирует update и render, что означает delta и как писать код, независимый от частоты кадров.
- [Сцены](https://cadmus.page/phaser/02-concepts/scenes/): Единица «экрана» или «режима» в Phaser — жизненный цикл, параллельные сцены и передача данных.
- [Игровые объекты](https://cadmus.page/phaser/02-concepts/game-objects/): Сохраняемый (retained-mode) список отображения — что такое игровые объекты, как работает иерархия трансформаций и когда какой встроенный тип использовать.
- [Камеры](https://cadmus.page/phaser/02-concepts/cameras/): Вьюпорты, прокрутка, масштабирование, следование и эффекты — как Phaser решает, что и где отрисовывать.
- [Ввод](https://cadmus.page/phaser/02-concepts/input/): Клавиатура, указатель (мышь + касания) и геймпад — и то, как Phaser направляет события игровым объектам.
- [Загрузчик и ресурсы](https://cadmus.page/phaser/02-concepts/loader/): Как работает конвейер ресурсов — постановка в очередь в preload, типизированный кеш и шаблоны для больших игр.

## Phaser — Гайды

- [Гайды](https://cadmus.page/phaser/03-guides/00-overview/): Практические рецепты для систем, которые вы действительно будете использовать — физика, тайлмапы, анимация, аудио, частицы, шейдеры и плагины.
- [Физика Arcade](https://cadmus.page/phaser/03-guides/physics-arcade/): Быстрая AABB-физика для платформеров, шутеров и большинства аркадных игр — тела, столкновения, группы и подводные камни, на которые натыкаются новички.
- [Физика Matter](https://cadmus.page/phaser/03-guides/physics-matter/): Полноценная симуляция твёрдых тел для укладки стопкой, соединений, составных тел и всего, что не может смоделировать Arcade.
- [Тайлмапы](https://cadmus.page/phaser/03-guides/tilemaps/): Загрузка карт Tiled в формате JSON, отрисовка слоёв, построение столкновений и изменение тайлов во время выполнения.
- [Анимация](https://cadmus.page/phaser/03-guides/animation/): Покадровые анимации из спрайт-листов и атласов — определение, воспроизведение, объединение в цепочки и реакция на события анимации.
- [Твины](https://cadmus.page/phaser/03-guides/tweens/): Система твинов Phaser 4 — интерполяция любого числового свойства во времени. Цели, функции плавности (easing), цепочки, твины значений и подводные камни.
- [Аудио](https://cadmus.page/phaser/03-guides/audio/): Интеграция Web Audio в Phaser 4 — музыка против звуковых эффектов, разблокировка по жесту пользователя, микширование и пространственный звук.
- [Частицы](https://cadmus.page/phaser/03-guides/particles/): Эмиттер частиц — типичные эффекты, анатомия конфигурации и компромиссы производительности, которые действительно важны.
- [Шейдеры](https://cadmus.page/phaser/03-guides/shaders/): Собственные WebGL-эффекты в Phaser 4 — встроенная библиотека фильтров (Filter), свой GLSL через игровой объект Shader и место RenderNodes во всём этом.
- [Плагины](https://cadmus.page/phaser/03-guides/plugins/): Создание и использование плагинов Phaser 4 — три формы плагинов (глобальный, сценический, игрового объекта) и разобранный пример системы сохранения.
- [Переходы между сценами](https://cadmus.page/phaser/03-guides/scene-transitions/): API `scene.transition()` — анимированная передача управления между сценами с одновременной работой обеих сцен в момент наложения.

## Phaser — Примеры

- [Примеры](https://cadmus.page/phaser/04-examples/00-overview/): Запускаемые примеры Phaser 4 — каждый представляет собой изолированную песочницу, которую можно прочитать, форкнуть и изменить.
- [Базовый спрайт](https://cadmus.page/phaser/04-examples/basic-sprite/): Минимально возможный пример Phaser 4 — загрузить текстуру и однократно её отрисовать.
- [Движение клавиатурой](https://cadmus.page/phaser/04-examples/keyboard-movement/): Перемещение спрайта на WASD или стрелках с опросом ввода каждый кадр и скоростью на основе delta-time.
- [Переход между сценами](https://cadmus.page/phaser/04-examples/scene-transition/): Затухание между двумя сценами через API fade-out / fade-in камеры.
- [Цепочка твинов](https://cadmus.page/phaser/04-examples/tween-chain/): Выстроить последовательность эффектов-твинов на одном объекте — перемещение, вращение, затухание, сброс, цикл.
- [Реакция на столкновение](https://cadmus.page/phaser/04-examples/collision-response/): Клик в любом месте создаёт физический шарик — шарики сталкиваются друг с другом и с границами мира.
- [Залп частиц](https://cadmus.page/phaser/04-examples/particle-burst/): Клик в любом месте запускает однократный взрыв через режим explode эмиттера частиц.
- [Пересечение в физике (подбираемые предметы)](https://cadmus.page/phaser/04-examples/physics-overlap/): Заходите в звёзды, чтобы собирать их — канонический паттерн «пересечение как триггер» с подсчётом очков.
- [Шейдерный фильтр (Glow)](https://cadmus.page/phaser/04-examples/shader-filter/): Применить встроенный фильтр Glow к спрайту и анимировать его силу твином.

## Phaser — Глоссарий

- [Глоссарий — термины Phaser глазами веб-разработчика](https://cadmus.page/phaser/05-glossary/01-terms/): Короткие определения ключевых понятий Phaser 4 с аналогами из веба и других движков.

## Optional

- [RSS всех глав](https://cadmus.page/rss.xml)
- [RSS Unity](https://cadmus.page/unity/rss.xml)
- [RSS Unity (en)](https://cadmus.page/en/unity/rss.xml)
- [RSS Godot](https://cadmus.page/godot/rss.xml)
- [RSS Godot (en)](https://cadmus.page/en/godot/rss.xml)
- [RSS Phaser](https://cadmus.page/phaser/rss.xml)
- [RSS Phaser (en)](https://cadmus.page/en/phaser/rss.xml)
- [Sitemap](https://cadmus.page/sitemap-index.xml)
- [Полный контент в одном файле для LLM-агентов](https://cadmus.page/llms-full.txt)