G-Forge

G-Forge — это 3D-студия для игровых и продуктовых ассетов по адресу /g-forge. Она генерирует меши по промпту, риггует их, применяет движения и пропускает результат через проверку качества, прежде чем вы его используете.

Назначение

Производить пригодные 3D-ассеты от начала до конца: сгенерировать меш по текстовому промпту, сделать риг и применить движения (680 встроенных), затем проверить качество через шлюз QA мешей — проверки замкнутости (watertight), масштаба и числа полигонов через trimesh — и сразу вставить готовое 3D в слайды P-Forge.

Ключевые функции

• Генерация мешей — генерация мешей по промпту.
• Риггинг и движение — риг сгенерированных мешей и применение любого из 680 встроенных движений.
• Шлюз QA мешей — проверки замкнутости, масштаба и числа полигонов через trimesh. Без trimesh шлюз не может проверять меши, но генерация всё равно работает.
• Профили движков — три целевых рантайма: Godot, Unity и Unreal. Godot и Unity экспортируют GLB в метрах с масштабом 0.01; Unreal экспортирует FBX в сантиметрах с масштабом 1. Поддерживаемые форматы экспорта в целом: glb, obj, fbx, stl, usdz, 3mf.
• Предпросмотр в приложении — 3D-предпросмотр работает на @google/model-viewer (поставляется в комплекте).

Генерация изображений

Генерация изображений и 3D идёт исключительно через Meshy (MESHY_API_KEY); ключи fal и kie намеренно не открываются для G-Forge. Предлагаемые движки 2D-концептов (все через Meshy) — Nano Banana (по умолчанию), Nano Banana 2, Nano Banana Pro и GPT Image 2.

Установка и зависимости

• 3D-движки — разворачиваются скриптом scripts/setup-3d-engines.sh; сервисный юнит g-forge (scripts/setup-gforge-service.sh) держит их прогретыми. Разворачиваются по умолчанию.
• trimesh — шлюз QA; подключён к общему venv coursegen, разворачивается по умолчанию через scripts/setup-free-engines.sh (~/.erebros/coursegen/venv).
• @google/model-viewer — 3D-предпросмотр в приложении, в комплекте.
• MESHY_API_KEY — бэкенд для всей генерации изображений и 3D (G-Forge работает только через Meshy).

Куда попадает результат

Сгенерированные 3D-ассеты записываются в хранилище (vault) по пути <vault>/G-Forge/<project>/assets/<task>/<name>.<ext>, с файлом library.json на каждый проект. (Временные файлы загрузок Meshy лежат отдельно в ~/.erebros/gforge.) Готовое 3D можно также сразу вставить в слайды P-Forge.

Советы

• Шлюз QA носит рекомендательный характер: генерация работает и без trimesh, но вы теряете проверки замкнутости / масштаба / полигонов — установите его, чтобы отлавливать плохие меши до того, как они попадут на слайд.
• Если провайдеры изображений fal и kie исчерпаны, задайте MESHY_API_KEY, чтобы продолжать генерацию на годовом плане.

См. также

• D-Forge
• N-Forge