CommunityImagemgithub.com

blender-game-kit

Construa modelos prontos para jogos a partir de Python no Blender – kits modulares de nível (paredes, pisos, portas, escadas, plataformas, tetos), props e personagens simples. Converta materiais processuais em texturas, crie cópias LOD baratas e exporte FBX que caem direto na Unity ou em outro motor gráfico. Use sempre que o usuário quiser modelos 3D ou níveis do Blender, disser "Blender MCP", "faça um kit modular", "modele uma sala/masmorra/casa/corredor/props", "exporte para Unity", "muitos triângulos" ou quiser arte que possa regenerar a partir de código em vez de modelar à mão.

O que é blender-game-kit?

Este skill permite que um agente de IA (como Claude Code, Cursor ou Codex) atue como um designer de jogos procedural, construindo modelos 3D completos e prontos para jogos diretamente de scripts Python executados no Blender. Ao contrário de modelar manualmente, o usuário pode descrever o que deseja (como "uma masmorra modular" ou "um kit de peças de cidade") e o agente gera o código que cria o cenário, que pode ser editado e reexecutado em segundos. O skill suporta dois modos de operação: o modo vivo com o add-on Blender MCP para visualização interativa, e o modo headless com o comando `blender -b -P` para exportação repetível e livre de interferências da interface. O fluxo de trabalho é baseado em uma grade rígida de módulos (paredes, pisos, portas, escadas), onde cada módulo é uma única malha com múltiplos slots de material. Os materiais processuais são convertidos (bake) em texturas (BaseColor, Normal, MetalSmooth, Emission) para sobreviver à exportação FBX, que é configurada para os eixos da Unity. O skill também inclui validação automática de contagem de triângulos e limites, além de estratégias de otimização como decimação planar e criação de cópias _Lite para peças distantes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Kit de jogos Blender (modelos a partir de código)

Construa o mundo do jogo a partir de scripts Python executados no Blender. Uma masmorra, uma casa, uma estação espacial, um quarteirão: tudo são módulos em uma grade mais props. Uma alteração é uma edição e uma reexecução, nunca horas de remodulação.

Exemplo (HOLD STILL): toda a fábrica de dois andares (paredes, pisos, portas, escadas, móveis de laboratório, robôs, detritos) veio de cerca de 20 scripts do Blender.

Como o agente executa o Blender

  • Blender vivo (add-on Blender MCP): execute Python no Blender aberto do usuário, visualize a viewport, pesquise e importe assets do Poly Haven / Sketchfab. Melhor para explorar e verificar a aparência.
  • Headless (para a exportação real): blender -b --factory-startup -P build_kit.py. Mesmo resultado a cada execução, sem vazamento de estado da interface. Use isso para qualquer coisa que o jogo distribua.

Consulte os nós de shader pelo tipo, nunca pelo nome (os nomes são traduzidos em outras línguas da interface): next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED").

A grade é o design

Escolha os tamanhos dos módulos primeiro e nunca os quebre. Combine-os com seu personagem: portas um pouco mais largas e altas que a cápsula do jogador, degraus mais baixos que a altura do passo dele. Um bom ponto de partida para um personagem de tamanho humano (estes são os números do HOLD STILL):

PeçaTamanho
Módulo de parede4,0 m de largura, 0,12 m de espessura
Piso ao teto3,2 m
Laje de piso2,0 m
Abertura de porta1,1 m por 2,2 m
Degrau de escada0,18 m de altura (mantenha abaixo da altura do passo do personagem)

Pivô no centro do piso do módulo para que as peças se encaixem em metros inteiros na Unity.

Fluxo de trabalho

  1. Primeiro os auxiliares: box(), cyl(), assign(material), finish() (aplicar transformações, suavizar por ângulo, UVs). Veja scripts/modular_kit.py, um pequeno kit funcional para começar.
  2. Uma função por módulo (build_wall, build_floor, build_doorway). Parâmetros para variantes (com ou sem dreno, faixa de perigo, janela).
  3. Uma malha por módulo, muitos slots de material. Junte as partes. Cada módulo se torna um objeto e um conjunto de texturas: menos chamadas de desenho.
  4. Converta (bake) materiais processuais (ruído, sujeira, bump) para BaseColor, Normal, MetalSmooth (R = metálico, A = suavidade) e Emission. Nós processuais não sobrevivem à exportação FBX; sem a conversão, a Unity vê apenas cores planas.
  5. Exporte FBX com os eixos da Unity: axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'.
  6. Escreva um arquivo de validação após a exportação: por módulo, contagem de triângulos, limites, contagem de materiais. Compare com a execução anterior para que regressões apareçam como números.

Orçamentos de triângulos (o que importou)

  • Conte onde os triângulos vão antes de otimizar. Exemplo: no HOLD STILL, três lajes de teto eram 38,6% de todos os triângulos na cena por causa de chanfros de 2 mm que ninguém vê de 2 m abaixo. Uma decimação planar (dissolver faces quase coplanares, 50 graus, delimitada por costuras UV e material) reduziu-os drasticamente sem alteração visível. Veja references/budgets.md.
  • Chanfros pequenos são para props de herói de perto, não para módulos repetidos.
  • Crie cópias _Lite para peças distantes ou repetidas em vez de editar o kit de origem.

Entrega para a Unity

  • Configurações de importação: gere colisores apenas nas peças que o jogador toca; use colisores de caixa simples para o resto.
  • Vincule as texturas convertidas a um material Lit URP por módulo pelo nome (um pequeno script de editor que lê um materials.json escrito ao lado do FBX).
  • Mantenha o .blend e os scripts no controle de versão. O FBX é um produto de compilação.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas