Godot Encyclopedia

Зачем веб-разработчику Godot

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Если Unity ощущается как корпоративная IDE с подпиской (потому что так и есть), то Godot — это нечто другое. MIT-лицензия, 0% роялти, ~100 МБ редактор, который запускается быстрее, чем VS Code. Своя экосистема, свой язык, и для веб-разработчика — местами куда более интуитивная модель.

Эта энциклопедия параллельна Unity-энциклопедии: те же концепции, тот же подход "через веб-аналоги", но движок другой. Можно читать обе, можно одну.

Что Godot делает иначе

Главное архитектурное отличие от Unity: в Godot одна сцена — это и есть префаб. Любой объект, сделанный в редакторе как сцена, можно инстан…

Стек Godot и его экосистема

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Godot работает в ветке 4.x с 2023 года (релиз 4.0 — март 2023). На май 2026:

Godot 4.6.3 — текущий stable (вышел 20 мая 2026). Минорная ветка 4.6 релизнута в январе 2026, патчи 4.6.1 (фев), 4.6.2 (апр), 4.6.3 (май) — стабилизация Jolt physics, фиксы редактора. Главные новинки 4.6: Jolt стал default-физикой для 3D, IK вернулся как нодовая система (TwoBoneIK3D, FABRIK3D, и ещё 5 солверов), новая editor theme (Modern), unified docking, переписанный SSR, LibGodot (движок как embedded-библиотека). Godot 4.7 — в beta с апреля 2026, stable ожидается летом 2026. HDR-output на десктопе/iOS, AreaL…

Godot Editor, сцена и узлы

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Godot Editor — это IDE для контента. Главные доки (можно перетаскивать как в Unity):

3D Viewport — окно сцены, в котором летаете и расставляете узлы. Переключатели: 2D / 3D / Script / AssetLib. Scene (слева сверху) — дерево узлов текущей сцены. Аналог Unity Hierarchy. FileSystem (слева снизу) — файлы проекта. Аналог Unity Project. Inspector (справа) — свойства выбранного узла или ресурса. Node (справа сверху) — вкладка для просмотра/подключения сигналов этого узла. Это отдельная штука относительно Unity. Output / Debugger / Search — снизу.

GDScript, lifecycle и сигналы

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

GDScript-файл () обычно начинается с , указывая, от какого узла наследуется:

Главные методы, которые Godot вызывает сам:

* — конструктор объекта, ещё до того как узел добавлен в дерево. — узел добавлен в scene tree. Родитель → дети (top-down). — все дети тоже готовы. Дети → родитель (bottom-up). Здесь делают инициализацию, которая зависит от детей. / — каждое input-событие. — фиксированный тик. По умолчанию 60 Hz (Project Settings → Physics → Common → Physics Ticks Per Second). — каждый кадр (variable timestep, как Unity Update). — узел удалён из дерева (включая при выходе из сцены). — низ…

Ввод — Input Map и action-based система

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot ввод — единая система: вы описываете actions в Project Settings и обращаетесь к ним из любого скрипта. Нет двух конкурирующих API как в Unity (legacy Input vs Input System).

Project → Project Settings → Input Map. Создаёте action (например, ), привязываете к нему любое количество клавиш / кнопок геймпада / мышь / touch:

Это и есть единственная конфигурация — больше ничего настраивать не нужно.

Опрос ввода через Input

В скрипте читаете action через глобальный (singleton):

input(event) и unhandledinput(event)

Физика — Bodies, Collision, Jolt

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

С Godot 4.6 физикой по умолчанию для 3D стал Jolt — высокопроизводительный движок, используемый в Death Stranding 2 и других AAA-играх. Старый Godot Physics остался как опция и продолжает быть default для 2D.

Это значит: предсказуемая, масштабируемая 3D-физика из коробки. Никаких сторонних движков интегрировать не нужно.

Узлы-наследники , образующие физический объект:

Area3D — невидимая область с триггерами /. Аналог Unity Collider с . PhysicalBone3D — для рэгдоллов внутри Skeleton3D. SoftBody3D — мягкие тела (ткань, флаги, простые желейные объекты). Использует mesh-based soft-body simula…

Камера и Phantom Camera

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Camera3D — главный узел

Camera3D — узел, который "смотрит" в сцену. Только одна Camera3D активна в любой момент (если не используете отдельные viewports). У сцены может быть несколько камер; активная — та, у которой , или которая стала активной через .

* — (3D, с перспективой) или (без, для изометрии/2.5D). — поле зрения в градусах по вертикали. Стандарт FPS — 60–90°. , — clipping planes. Большой разброс портит точность Z-buffer (Z-fighting). — битмаска: какие visual layers рендерит эта камера.

Аналог Unity-варианта со SmoothDamp. В Godot нет встроенной , но есть :

Рендеринг и материалы

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Godot выбирает рендерер при создании проекта (можно сменить позже, но материалы могут требовать адаптации):

Project → Project Settings → Rendering → Renderer → Rendering Method.

Forward+ + Vulkan — десктоп, серьёзные 3D-проекты, hi-end visuals. Mobile + Vulkan/Metal — телефоны. Compatibility + WebGL 2 — браузер (это единственный путь для веб-таргета, который работает везде без COOP/COEP-заголовков).

Compatibility объявлен feature-complete с 4.3: lights, shadows, GI (lightmaps), GPU particles — всё доступно, с некоторыми ограничениями.

Mesh, Material, Shader

Та же триада, что и в Unity:

Освещение и тени

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Три встроенных типа света (плюс грядущий AreaLight3D в 4.7):

DirectionalLight3D — солнце. Параллельные лучи, бесконечно далёкие. Один на сцену обычно. OmniLight3D — точечный (Unity Point Light). От точки во все стороны с радиусом затухания. SpotLight3D — конус из точки с углом и радиусом. AreaLight3D — area-light (с 4.7). Прямоугольный/дисковый источник.

Главные свойства каждого: * — яркость. — цвет. — множитель для непрямого света от этого источника (в GI). — рисовать тени. , — настройки артефактов теней. — / (baked) / (real-time GI). В Inspector показано как Disabled/Static/Dynamic, но в к…

Анимация — AnimationPlayer и AnimationTree

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

AnimationPlayer — главный узел

хранит AnimationLibrary с набором -ресурсов и проигрывает их. Уникальная особенность Godot — можно анимировать любое свойство любого узла (или даже ресурса), не только Transform и Material:

Transform (position, rotation, scale) Любое property (alpha sprite, , числа, цвета) Shader uniforms — через property path Метод-вызовы (по таймеру в треке вызвать функцию) Audio (запустить AudioStreamPlayer) Вложенные анимации других AnimationPlayer

Запись анимации в редакторе

Выберите AnimationPlayer в сцене → внизу появится Animation editor. Кнопка "Animation" → New → и…

3D-аудио и AudioBus

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot аудио — отдельный сервер () с маршрутизацией через AudioBus. У сцены — несколько узлов-плееров, у проекта — единый микшер.

AudioStreamPlayer — без позиционирования. Музыка, UI-звуки, диалоги. AudioStreamPlayer2D — позиционный для 2D-сцен (громкость по дистанции к слушателю). AudioStreamPlayer3D — 3D-позиционный с attenuation, Doppler, area reverb.

Главные свойства AudioStreamPlayer3D:

* — -ресурс (AudioStreamOggVorbis, AudioStreamMP3, AudioStreamWAV). — громкость в децибелах. 0 — оригинал, -10 — тише, -80 — почти тишина. — множитель скорости/высоты. — фактор затухания (default ). Че…

UI — Control-узлы и контейнеры

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot UI — это Control-узлы. Это отдельная иерархия наследников , со своим layout-движком, anchors, событиями. В отличие от Unity uGUI / UI Toolkit — здесь одна UI-система, встроенная.

Все Control-узлы имеют: position + size — позиция и размер в пикселях. anchors + offsets — привязки к родителю (как Unity uGUI anchors или CSS absolute). sizeflagshorizontal / sizeflagsvertical — поведение внутри контейнера (, , , ...). theme + themeoverrides — стилизация.

Anchor — точка на родителе, к которой "приклеена" сторона текущего Control. Четыре float'а (top, left, bottom, right) в диапазоне 0..1.…

PackedScene и Resource

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

PackedScene — сцена и префаб в одном

Главная архитектурная особенность Godot: сцена и префаб — одна и та же сущность. Файл хранит дерево узлов; этот файл можно открыть как корневую сцену проекта или инстанциировать как ребёнка в другую сцену. Внутри Engine оба варианта — -ресурс.

В Inspector у те же узлы и компоненты, что и у . Любая сцена — это шаблон, который можно встраивать.

В редакторе: правый клик на узел → Instantiate Child Scene → выбрать . Или drag-and-drop из FileSystem в Scene.

создаёт корневой узел сцены и все её дети. загружает на этапе компиляции скрипта (статично), — в runt…

Практика — контроллер от первого лица

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Собираем играбельного FPS-персонажа: ходит, смотрит мышью, прыгает, стреляет лучом. Используем CharacterBody3D (аналог Unity CharacterController, только с более фичастым ).

Разделение Head ↔ Player важно: yaw (горизонтальный поворот) применяется к Player'у (двигает всё тело и направление движения), pitch (вертикаль) — только к Head (чтобы коллайдер не наклонялся).

В Project Settings → Input Map создайте: (W, ↑) (S, ↓) (A, ←) (D, →) (Space) (Mouse Left) (Escape) — обычно уже есть по умолчанию

player.gd — главный скрипт

health.gd — получатель урона

Простой компонент здоровья на любом узле:

Навигация — NavigationServer и AI

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Navigation в Godot 4 — это NavigationServer3D (низкоуровневый сервер) и три высокоуровневых узла: NavigationRegion3D, NavigationAgent3D, NavigationLink3D.

NavigationMesh — упрощённая полигональная "карта проходимости". Запекается из коллизий сцены. Агенты ищут путь по этой карте (A под капотом).

Запекание NavigationMesh

Соберите статичную геометрию. Добавьте узел NavigationRegion3D на сцену. В Inspector создайте новый ресурс NavigationMesh на этом узле. Кнопка Bake NavigationMesh в верхней панели → запекание.

В Geometry → Source Geometry Mode на NavigationMesh выбирается, из чего собирать…

Частицы — GPUParticles3D и CPUParticles3D

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot два узла для частиц с похожим API:

GPUParticles3D — на GPU, до миллионов частиц. CPUParticles3D — на CPU, fallback для слабого железа и веба.

Грубое правило: GPU где можно, CPU где обязательно.

ParticleProcessMaterial

Главное отличие от Unity Particle System: поведение частиц задаётся не в инспекторе узла, а в отдельном ресурсе . Это удобно — можно сохранить, переиспользовать, override в инстансах.

Главные секции ParticleProcessMaterial:

Direction + spread — направление выброса. Initial Velocity (min/max) — стартовая скорость. Gravity — на каждую частицу. Linear / Angular / Radia…

Мультиплеер — MultiplayerAPI и RPC

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Godot имеет встроенный high-level мультиплеер: MultiplayerAPI + транспорты + узлы Spawner/Synchronizer. Это аналог Unity Netcode for GameObjects.

работает поверх . Транспорты:

ENetMultiplayerPeer — UDP, основной для нативных платформ. WebSocketMultiplayerPeer — TCP/WebSocket, единственный путь для веб-таргета. WebRTCMultiplayerPeer — peer-to-peer, NAT traversal через STUN/TURN. OfflineMultiplayerPeer — заглушка для single-player.

Стандартная модель — authoritative server: один peer ID=1 (сервер), остальные — клиенты с ID >= 2.

Старт сервера и клиента

Загрузка ресурсов — preload, load, threaded

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot нет отдельной системы вроде Unity Addressables — встроенный механизм покрывает большинство сценариев через несколько API.

preload — статичная, на этапе парсинга

— это директива компилятора GDScript. Ресурс загружается, когда сам скрипт загружается (один раз, кешируется). Самый быстрый способ при инстанцировании.

Плюс: ноль пауз в рантайме. Минус: ассет всегда в памяти, пока скрипт жив. Не подходит для тяжёлой геометрии, которая нужна не всегда.

load — динамическая, синхронная

блокирует поток, пока не загрузит. Подходит для лёгких ресурсов в моменты, где пауза не заметна.

Сборка и оптимизация

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot сборка — это Export Preset (конфиг для платформы) + Export Template (бинарь движка без редактора). Платформы first-party: Windows, macOS, Linux, Android, iOS, Web, visionOS (с 4.5).

открывает окно с конфигами. Добавьте preset для нужной платформы:

Platform (Windows Desktop, Android, Web, ...). Bundle Identifier / Package Name (для mobile/Mac/iOS). Icon и Splash. Permissions (Android — camera, location и т.д.). Encryption — зашифровать pack-файл. Export Mode — All resources / Resources from group / By files. Debug / Release — release делает оптимизированный билд без debugger.

Практика — 3rd-person платформер с NavMesh-врагом

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Второй практический капстон Godot — параллель Unity TPS-главы. Собираем платформер от третьего лица: персонаж бегает, прыгает (с double jump и coyote time), его преследует AI-враг по NavMesh, при смерти игрок респаунится на чекпойнте.

Используем то, что разбирали раньше: CharacterBody3D с , NavigationAgent3D, Phantom Camera плагин для third-person вида, Resource как ScriptableObject-аналог.

playermotor.gd — контроллер

Phantom Camera для 3rd-person

Установите плагин Phantom Camera (AssetLib → "Phantom Camera" → Install → активировать в Project Settings → Plugins).

gdshader подробнее — vertex, fragment, light

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В главе про рендеринг видели базовый ShaderMaterial. Здесь — подробнее: устройство 3D-шейдера, что такое vertex/fragment/light-функции и как писать своё освещение.

Полная структура spatial-шейдера

Что внутри: * — это для 3D mesh'а. Для 2D — , для skybox — , и т.д. — флаги: (transparency), (отбраковка), (Z-буфер), (модель диффузного освещения), (зеркальная), (без света). — параметр, видимый в Inspector материала и доступный из кода через . — переменная, передаваемая из vertex в fragment (интерполируется по треугольнику). — модифицирует вершины перед растеризацией. — считает свойства поверхн…

Path3D, PathFollow3D и сплайны

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot есть встроенные Path3D и PathFollow3D для движения по сплайну. Кривая хранится в ресурсе . Не нужно ставить плагины — это часть core engine.

Path3D — узел-контейнер с ресурсом . Описывает кривую в пространстве. PathFollow3D — дочерний узел Path3D. Содержит свойство или , по которому Godot вычисляет позицию вдоль кривой. Всё, что лежит внутри PathFollow3D, едет вдоль сплайна. Curve3D — ресурс с массивом точек, у каждой — позиция + in/out tangents (для Bezier).

Создание Path3D в редакторе

Добавьте на сцену Path3D. В Inspector создайте новый (если ещё нет). В Scene view выберите Path…

GridMap — модульные уровни

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

GridMap — встроенный Godot узел для сборки уровней из модульных блоков на 3D-сетке. Думайте: Minecraft, Dungeon Crawler, Cities Skylines — где мир состоит из переиспользуемых "кирпичиков" размером с тайл.

Сделайте MeshLibrary-ресурс — набор mesh'ей с заранее заданными CollisionShape3D. Положите его на узел GridMap. В Scene View рисуете "кистью" по 3D-сетке — каждая клетка получает выбранный из библиотеки mesh. Godot рендерит весь GridMap одним вызовом на тип меша (внутреннее instancing).

Это и быстрее, и компактнее, чем десять тысяч отдельных -узлов.

Threading — WorkerThreadPool и Thread

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot main-thread обрабатывает рендер, физику, скрипты. Если в процедурно сгенерировать карту мира — игра зависнет на секунду-две. Threading — способ вынести тяжёлую работу в фоновые потоки.

Три уровня инструментов

появился в Godot 4 и — главный путь. Он управляет потоками за вас, вы только submit-ите задачи.

WorkerThreadPool — базовый пример

Задача: процедурно сгенерировать heightmap 1024×1024.

Главные методы : — submit, возвращает . — проверить готовность. — заблокировать main, пока не закончится (вызывается после для cleanup). — параллельное "for each".

Decals — наклейки в 3D

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Decal — узел в Godot, который проецирует текстуру на поверхности под собой. Это классический приём для:

Дырок от пуль на стене Грязи на полу, лужи Граффити, постеров Следов от шин Cracks, кровь, scorch marks от взрывов

Реализовано как отдельный render pass, не лежит на геометрии — поэтому можно "клеить" поверх любой поверхности без модификации mesh'ей.

Базовое использование

Добавьте на сцену узел Decal. В Inspector задайте * — основная текстура. (Опционально) — карта нормалей для рельефа. (Опционально) — Occlusion/Roughness/Metallic mask. Поверните и масштабируйте узел: bounding box decal'…

@tool и EditorPlugin — расширение редактора

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Godot полностью написан на собственном языке для UI — это значит, что сам редактор может быть расширен GDScript-кодом. Никаких C++-плагинов, никаких пересборок.

Два уровня расширения: -скрипты — обычные узлы с поведением в редакторе. Например, скрипт, который автоматически расставляет деревья по сплайну. EditorPlugin — настоящий плагин: добавляет узлы, кастомные docks, инспекторы, gizmos.

@tool — скрипт работает в редакторе

Обычный GDScript исполняется только в Play Mode. Добавьте в первой строке — и скрипт будет работать прямо в Scene View.

TileMap (2D) — модульные 2D-уровни

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Эта энциклопедия про 3D, но Godot имеет первоклассный 2D-pipeline, и TileMap — главный инструмент для модульных уровней (платформеры, top-down RPG, dungeon crawlers, city builders).

Архитектура TileMap в Godot 4.x

С Godot 4.3 произошло важное изменение: классический -узел deprecated в пользу *-узлов.

В новом проекте используйте . Один узел = один слой (например, фон → детали → объекты).

TileSet — со списком всех доступных тайлов (sprite + collision + nav-data). TileMapLayer — , который рисует тайлы из TileSet на координатной сетке. Tile — ячейка TileSet'а: sprite-источник + collision-shape…

XR / OpenXR — VR-приложения в Godot

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Godot имеет встроенную поддержку OpenXR прямо в core, без отдельных пакетов. На фоне Unity это особенно приятно: запуск VR-проекта в Godot — буквально несколько узлов.

OpenXR в Godot — встроено

OpenXR — открытый стандарт Khronos Group для VR/AR. Заменяет SDK от Oculus, SteamVR, Vive Wave. В Godot 4.x OpenXR — часть engine, активируется в Project Settings → XR.

Project Settings → XR → OpenXR → Enabled = true. Выберите interaction profiles: Oculus Touch, Khronos Simple, Valve Index. По умолчанию включены основные. Для Android (Quest): Build Profile → Android, в Export preset включите XR-perm…

GDExtension — нативные плагины на C++ и Rust

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

GDScript хорош для большинства gameplay-логики, но иногда нужно опуститься ниже: Воксельный движок с миллионами блоков Custom shading в реальном времени с сложной CPU-математикой Интеграция со существующей C/C++ библиотекой (физика, NN inference, audio DSP) Performance hot path, где даже static-typed GDScript не справляется

GDExtension — современный способ расширять Godot на нативном уровне. Заменил GDNative с Godot 4.0.

Вы пишете код в C++ (через ) или Rust (через ). Компилируете в dynamic library ( / / ). Создаёте манифест , который Godot загружает при старте. В редакторе ваши классы появл…

C# в Godot — практика и нюансы

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

GDScript — отличный язык, но если вы пришли из Unity (или серьёзного .NET-проекта), хочется работать на C#. Godot поддерживает это через отдельную сборку — Godot .NET edition.

Чем .NET edition отличается

Скачайте .NET-вариант с godotengine.org/download. В Steam-версии есть отдельный SKU "Godot Engine (.NET)".

Ключевые отличия от Unity:

* — обязательно (генератор кода добавляет код для signals). вместо — атрибут видимости в Inspector. вместо — другой синтаксис. — сигналы декларируются как делегаты с суффиксом. , (PascalCase) — а не , . — нужно явно кастовать в float если используете с Vecto…

Save / Load — сохранение прогресса

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

В Godot есть несколько встроенных способов сохранять прогресс. Каждый подходит под свою задачу.

Пути и user:// schema

В Godot для всех пользовательских данных есть специальный путь — *. На разных платформах он указывает в правильное место:

Windows: macOS: Linux: Android: iOS: Web: через виртуальную ФС

Главное правило: никогда не пишите в (это read-only после билда). Всё пользовательское идёт в .

ConfigFile — для настроек

сохраняет в INI-формате (как .ini-файлы Windows). Идеально для player-config'а: громкость, разрешение, бинды клавиш.

Глоссарий — Godot термины и параллели

Konstantin Ryzhov — Tue, 26 May 2026 00:00:00 GMT

Сводный список ключевых терминов Godot, упомянутых в энциклопедии. В скобках — Unity-аналог, если он есть.

Node — базовый класс всего в дереве сцены. Унаследованные классы: , , , . (Unity: GameObject, но без stack of components — один скрипт на узел.)

Node3D (раньше Spatial) — узел с 3D-трансформом. (Unity: GameObject + Transform.)

Control — базовый класс UI-узлов. С anchors, offsets, layout. (Unity: RectTransform / Control в uGUI.)

Scene Tree — иерархия живых узлов в работающей игре. Доступ через .

PackedScene — сериализованная сцена-. (Unity: Scene + Prefab в одном.)