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 (~/.maven/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 лежат отдельно в ~/.maven/gforge.) Готовое 3D можно также сразу вставить в слайды P-Forge.

Советы

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

См. также

• D-Forge
• N-Forge