Godot Pipeline: спеціальний міст між Blender і Godot 4

Експорт сцен із повними дотичними glTF, автоматичними допоміжними файлами .import, іменуванням, безпечним для кирилиці, UV2 для lightmap, пакетним експортом за колекціями та пресетами для мобільних пристроїв / вебу / ПК.

---

Чому Godot Pipeline

Вбудований експортер glTF у Blender доводить вас майже до Godot 4. Залишається набір параметрів експорту, налаштування імпорту, імена файлів і вузлів, імена колізій та матеріали: Godot Pipeline налаштовує їх з однієї панелі.

Godot Pipeline - це спеціальний міст: він встановлює параметри glTF, записує допоміжні файли .import поруч із кожним .glb, транслітерує імена файлів і вузлів, що містять не-ASCII символи, та іменує об'єкти колізій із суфіксами -col / -rigid / -area.

---

Можливості

Безпечний запис у папку вашого проєкту

Папка, до якої ви експортуєте, - це ваш проєкт Godot, а імена файлів походять від імен ваших об'єктів, тож ім'я може бути вже зайняте. Кожен файл (.glb, .tscn, .tres, .import) записується поруч зі своїм місцем призначення та переміщується на місце за один крок, тому перерваний запис ніколи не залишає обрізаний файл там, де був справний. Якщо експорт зривається на півдорозі, очищення видаляє лише файли, створені цим запуском; усе, що вже було в папці, залишається недоторканим.

Експорт сцени в .tscn + .glb

Ієрархія Node3D зі збереженням підпорядкування та імен. Кожна сітка експортується як окремий .glb з усіма аргументами glTF для Godot 4: export_tangents (коректне затінення normal map), export_extras (користувацькі властивості → метадані Godot), export_morph, export_skins, export_animations, export_cameras, export_lights.

Автоматично створювані допоміжні файли .import

Кожен .glb постачається з файлом .import для Godot 4: дотичні ввімкнено, генерацію LOD ввімкнено, генерацію тіней сітки ввімкнено, режим запікання освітлення залежить від обраної цілі.

Пресет Mobile / Web / Desktop

• Mobile і Desktop: статичне запікання освітлення ввімкнено
• Web (HTML5): запікання освітлення вимкнено
• Стиснення текстур не записується у файл .import: Godot використовує для цього власне налаштування імпорту

Об'єднання в MultiMeshInstance3D

Необов'язково. Групи з 3 і більше пов'язаних дублікатів об'єктів, що мають однакову сітку та набір матеріалів, записуються як _multimesh.tscn із вузлом MultiMeshInstance3D; його сітка записується поруч як .obj, а сцена MultiMesh розміщується в головній сцені. Перевірено завантаженням сцени в Godot 4.7.2.

Іменування, безпечне для кирилиці

Імена сцен, сіток, вузлів, матеріалів і дій, що використовуються для файлів і вузлів, транслітеруються в ASCII (а→a, ш→sh, ї→yi, …) замість того, щоб перетворюватися на порожні рядки. Імена кісток не змінюються.

Фільтрація прихованого рендеру

hide_render, hide_viewport та hide_render на рівні колекції враховуються і під час експорту сцени, і під час генерації колізій. Невидима геометрія не потрапляє до збірки.

UV-канал 2 для lightmap

Необов'язковий Lightmap Pack (запасний варіант - Smart UV Project) на другому UV-шарі перед експортом, для сіток, що мають лише один UV-шар. Сітка, яка вже має два, залишається як є.

Пакетний експорт за колекціями

Кожна колекція верхнього рівня, не прихована від рендеру, експортується у власну підпапку: один .tscn, по одному .glb на сітку та їхні файли .import. Зручно для модульних бібліотек ресурсів.

Форми колізій

Об'єкт колізії іменується із суфіксом, який ви оберете: -col, -colonly, -rigid, -area, -vehicle або -navmesh. Те, що Godot створює з кожного суфікса, визначає імпортер Godot.

Перетворення матеріалів у .tres

StandardMaterial3D з Albedo, Metallic, Roughness, Normal, Emission та Alpha. Посилання на файли текстур залишаються відносними до розташування .tres.

Експорт анімації

Доріжки кісток (position_3d / rotation_3d / scale_3d) із коректним групуванням компонентів. Розділення смуг NLA з попередженнями про виявлення перекриттів.

MeshLibrary для GridMap

Автоматично центровані тайли, перевірені на відповідність розміру клітинки: просто перетягніть їх у вузол GridMap у Godot.

Очищення після часткового експорту

Якщо експорт аварійно завершується на півдорозі, наполовину записані файли .glb / .import видаляються. Жодних осиротілих файлів у вашому проєкті.

---

Сумісність

• Blender: 4.2 LTS і новіші (перевірено на 4.2.9 та 5.2.0)
• ОС: Windows / macOS / Linux
• Godot: орієнтовано на Godot 4

---

Що ви отримаєте

• Додаток Godot Pipeline (лише Python, без DLL)
• README з повним посібником швидкого старту
• Підтримка через повідомлення на маркетплейсі

---

Встановлення

Edit → Preferences → Add-ons → кнопка зі стрілкою у правому верхньому куті → Install from Disk → виберіть zip-архів додатка → увімкніть. Бічна вкладка Godot з'явиться у 3D Viewport (натисніть N).

---

Ліцензія

GPL-3.0. Стандарт для додатків Blender.

v1.0.2: експорт більше не видаляє файли, яких не створював. Папка, до якої ви експортуєте, - це ваш проєкт Godot, а імена файлів походять від імен ваших об'єктів, тож ім'я може бути вже зайняте; якщо експорт зривався на півдорозі, його очищення видаляло кожен шлях, у який він записував, зокрема файли, що були там раніше й лише оновлені цим запуском. Тепер очищення видаляє лише файли, створені цим запуском, а кожен файл, який записує додаток, ставиться на місце за один крок, тому перерваний запис не може обрізати наявний файл. Експортований результат не змінився.

v1.0.1: експорт анімації у форматі .tres знову працює в Blender 4.4 і новіших. Експортер читав криві через action.fcurves, який у 5.x прибрали, тож уся операція завершувалася помилкою «Animation export failed: 'Action' object has no attribute 'fcurves'»: один із двох заявлених форматів експорту не робив нічого. Перевірено на ригованому анімованому персонажі: ресурс .tres із 28 доріжками. Шлях glTF це не зачепило, він не змінився.