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