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