CommunityImagemgithub.com

modelagem-ps1

Use ao modelar, refinar ou revisar um personagem ou props low-poly estilo PS1/PSX no Blender — um asset de jogo retrô, um retrato low-poly a partir de uma referência de rotatividade, uma malha de cabelo facetado, ou qualquer coisa que precise corresponder ao orçamento de polígonos e às convenções de assets do PlayStation 1. Abrange o fluxo de trabalho de script procedural, a biblioteca loft, medição de referência para proporções, orçamentos e os modos de falha que mais custam tempo.

O que é modelagem-ps1?

Esta habilidade oferece um fluxo de trabalho completo para modelagem low-poly no estilo PS1/PSX dentro do Blender, usando scripts Python procedurais. Ela é essencial para desenvolvedores de jogos retrô, artistas 3D e entusiastas que desejam criar assets que respeitem rigorosamente as convenções visuais e técnicas do PlayStation original, como orçamentos reduzidos de polígonos (tipicamente 500-1500 vértices para um personagem completo) e o uso de um único atlas de textura pintada. A habilidade fornece uma API de script robusta (psx_build.py) com funções como `ring()` para criar seções transversais superelípticas e `Build.loft()` para gerar volumes a partir de anéis, além de ferramentas de medição e comparação para garantir que as proporções da referência sejam seguidas com precisão. Ela cobre desde a configuração do ambiente e a construção da malha até a revisão final, alertando sobre armadilhas comuns como cruzamentos de shells, tampas mal posicionadas e problemas de topologia que podem custar horas de retrabalho. Suporta a verificação rigorosa da malha (vértices soltos, faces de área zero) e a comparação direta com modelos de referência exportados em FBX/OBJ, garantindo que o asset final esteja dentro do orçamento e das convenções do estilo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IAmTheParsifal/Low-Poly-Modeling-Skill/tree/HEAD

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

Modelagem low-poly PS1 / PSX

O que é o estilo

Estilo PS1 = pequeno orçamento de polígonos + um atlas de textura pintado. Não é sombreamento flat. O corpo é sombreado suave; apenas cabelo e props duros permanecem facetados. Sombreamento flat em todo o modelo parece low-poly de 2005, não de 1997. O detalhe está na textura, então a malha é julgada pela silhueta e pelo fluxo de arestas — nunca pelo detalhe de superfície.

Convenções (medidas de modelos reais da era PS1, não adivinhadas)

  • +Z para cima, personagem de frente para −Y, pés em Z=0, metros.
  • Um objeto, um material, um atlas de textura. As roupas são a malha; não há objetos de vestuário separados.
  • 100% sombreamento suave, exceto cabelo e props de superfície dura.
  • Sem mapas de normais, sem PBR, sem shape keys.
  • Sem vértices soltos, sem arestas soltas, sem faces de área zero, sem lixo não-manifold.
  • Quads para cascas do corpo, triângulos apenas onde a forma precisar deles (pontas, tampas).

Orçamentos de três modelos de referência enviados:

modelovertstrisnotas
basemesh masculino rigado772154084 ossos, atlas 256², pose A, 1,98 m
Walking (PSXProp)349645todos tris, atlas 512², pose T, 1,77 m
LE0GAR5489439 objetos, um atlas 256², Rigify, 2,4 m

Isso é um corpo nu rigado. Volume de cabelo e acessórios legitimamente ultrapassam isso — um personagem de 1225 v / 2294 tri com uma juba completa, óculos, cinto e botas ainda é um personagem PS1. Nunca corte a silhueta para atingir um número derivado de um corpo nu.

Configuração

scripts/psx_build.py é a biblioteca; os dois harnesses são scripts config-no-topo.

scripts/psx_build.py           ring / ring_dir / Build / finish / check / report
scripts/preview.py             renders clay ortográficos, takes derivados do bbox
scripts/compare.py             tabela de estatísticas + lado a lado contra modelos FBX/OBJ de referência
scripts/measure_silhouette.py  varredura largura-vs-altura de um PNG de referência

Coloque scripts/ no sys.path e importe, ou copie um harness ao lado do seu script de construção. Tudo roda dentro do Blender:

import sys
sys.path.insert(0, r"…/scripts")
from psx_build import Build, ring, finish

A API

ring(cx, cy, cz, rx, ry, n=12, e=2.0, axis="Z", phase=0.0, yoff=None)

Uma seção transversal fechada. e é o expoente da superelipse: 2 = círculo, maior = mais quadrado. Útil: 2,1 membros e cabeça, 2,2 pernas, 2,3 tronco e cinto, 2,6 palma. axis="X" coloca o anel em YZ para membros ao longo de X. yoff={index: dy} empurra vértices individuais — é assim que um volume de busto, curva lombar ou assento é feito sem adicionar anéis.

Build.loft(rings, cap_start=..., cap_end=..., flat=..., part="…")
Build.tube(path, rx, ry, n=4, e=2.0, caps=True, part="…")
Build.box(cx, cy, cz, sx, sy, sz, flat=True, part="…")
Build.add(verts, faces, flat=..., part="…")
Build.mark() → passar para Build.mirror_x(mark)

tube() aceita um caminho de pontos e orienta cada anel ao longo da tangente local — use para correntes, dedos e qualquer coisa varrida. rx/ry podem ser listas, uma por ponto, para afunilamento.

finish(name, *builds, material=..., color=..., uv=True)
check(ob)    # a verificação: vértices soltos / arestas soltas / faces de área zero devem ser 0
report(ob)   # verts, faces, tris, bbox, altura

finish() mescla um ou mais Builds em um único objeto, aplica flags smooth por face, cria o material, recalcula normais, adiciona UVs placeholder e imprime o relatório da construção. Substitui qualquer objeto existente com o mesmo nome, então um script de construção é seguro para reexecutar.

Fluxo de trabalho

  1. Meça a referência antes de modelar. Execute scripts/measure_silhouette.py na rotatividade: ele imprime a largura da silhueta a cada 3% da altura. Anote a tabela. Avaliar proporções a olho é a maior fonte única de rodadas perdidas — uma cintura 2 cm fora não parece "ligeiramente errada", parece um personagem diferente.
  2. Bloqueie com lofts. Um Build, partes em ordem: tronco → pernas → pés → braços → mãos → espelhar → cabeça → cabelo → acessórios. Leia o log PARTS impresso após cada construção; ele informa qual parte está consumindo polígonos.
  3. Renderize clay, não sombreado. preview.py, fundo cinza, sem texturas. Julgue apenas a silhueta e a quebra de sombreamento onde as superfícies se encontram.
  4. Compare contra modelos de referência, não apenas a imagem. compare.py escala tudo para uma altura e imprime verts/tris lado a lado. Ele detecta braços curtos e profundidade chata mais rápido que olhar.
  5. Verificação. check() limpo, pés em Z=0, contagem de tri dentro do orçamento.
  6. Salve uma cópia. bpy.ops.wm.save_as_mainfile(filepath=…, copy=True) escreve o arquivo sem sequestrar o caminho de arquivo atual da sessão.

Armadilhas — cada uma destas custou pelo menos uma iteração

  1. Cascas separadas sempre se cruzam. Dois lofts de raio similar produzem uma costura irregular onde suas superfícies se intersectam, e nenhuma quantidade de ajuste a esconde. Deixe a roupa externa ser dona da junta: as calças formam os quadris, o tronco afunila para uma pequena tampa enterrada dentro delas, e o cruzamento fica escondido sob o cinto (cinto mais largo que o corpo). Mesmo truque no braço→ombro e barra-da-calça→bota.
  2. Uma tampa que aparece parece uma borda rasgada. Uma tampa compartilhando um Z com outra casca cria um anel irregular visível. Mantenha as tampas estritamente dentro da outra casca, ou não tampe.
  3. Preencha a virilha. Dois tubos de perna sobrepostos deixam um vale profundo em x=0. Ponteie com um cone de tronco estreito cuja frente esteja nivelada com as calças. Muito fino e você obtém um sulco preto; muito largo e obtém uma fralda.
  4. Cabelo: não corte o slot do rosto da casca. Para cada fileira, colunas dentro do slot recebem uma escala radial em torno de 0,45 mais um pequeno empurrão +Y, aumentando para o raio completo aproximadamente 10° após o semi-ângulo do slot (26–34° por fileira). O quad saindo da cabeça então sai na bochecha em vez de atravessar o rosto. Uma rampa de 30° coloca cabelo sobre todo o rosto; encolher sem o empurrão deixa uma grande parede interna pálida ao lado da bochecha.
  5. Nunca alterne uma franja por paridade de coluna. j % 2 em uma contagem par de colunas coloca um entalhe profundo no centro. Use uma função suave do ângulo da coluna.
  6. Cabelo é um volume loftado fechado, não cards — ex. 20 colunas × 11 fileiras, sombreado flat, com oscilação por vértice para o visual cortado. Varra as fileiras inferiores para trás ou o perfil parece um capuz.
  7. Correntes flutuam. Mantenha um arco de colar a alguns milímetros da superfície do peito ou ele parece um fio pendurado no espaço em vistas de três quartos.
  8. Normalize todo vetor de direção antes de escalar por um comprimento. Um não normalizado produziu um polegar de 1 m.
  9. mirror_x recebe (len(v), len(f)) de mark(), e faces espelhadas precisam de enrolamento reverso. Passar índices de vértice corrompe a malha silenciosamente.
  10. Nunca join() sem desselecionar tudo primeiro. Um cubo padrão esquecido pode ser absorvido no personagem. Filtre a seleção pelo nome do objeto.
  11. Importações FBX de referência precisam de parent_clear(type="CLEAR_KEEP_TRANSFORM") antes de a armação ser deletada — rigs são comumente escala 0,01 com uma malha de escala 100 parentada a eles. Então aplique transformações e centralize no centro do bbox, não no mínimo do bbox, ou os modelos nunca se alinham.
  12. Câmeras de pré-visualização elevadas: o deslocamento horizontal deve escalar por cos(elev), ou o take enquadra fundo vazio.
  13. Execute a verificação na geometria, não no render. Um quad degenerado pode parecer bom em uma vista frontal e destruir o wireframe. check() existe para isso.

Passo de revisão

preview.py fornece quatro vistas de corpo inteiro mais dois close-ups, todos derivados do bbox do objeto. Procure por: cruzamentos de cascas irregulares, tampas aparecendo como bordas planas, a virilha, juntas de vestuário, se o perfil do cabelo é cabelo ou um capuz, se o slot do rosto está claro.

Verificação final:

from psx_build import check
check(ob)   # vértices soltos, arestas soltas, faces de área zero → tudo 0

mais: bbox z.min == 0, altura, contagem de tri, flags smooth corretas.

Exemplo trabalhado — um personagem real

Uma garota gótica de 1,744 m, pose T, apenas malha, construída com esta biblioteca: 1225 verts / 1079 faces / 2294 tris, 26 n-gons (tampas), 4 triângulos, todo o resto quads; pés em 0; um material, um mapa UV placeholder.

Larguras medidas de sua folha de referência (z → largura da silhueta em metros), que é o que as tabelas do corpo foram construídas:

zlargurazlargura
1,660,2451,050,242
1,5750,3220,960,295
1,490,3490,8750,314
1,400,4030,610,330
1,2250,2650,260,452
1,140,1800,05250,449

Os números importam menos que o método: uma tabela, uma passada de lofts, então correções numéricas orientadas por renders. Naquela construção, o comprimento do braço foi a única coisa que precisou dos modelos de referência em vez da imagem — os braços da imagem caem ~20°, então sua amplitude horizontal (1,457 m) subestima o comprimento real do braço. Compare contra um modelo de referência em pose T para qualquer coisa medida em um ângulo.

Fora do escopo aqui

Texturização, rigging e exportação. UVs placeholder de smart_project são ilhas, não um atlas real. Quando a texturização começar: um atlas 256² ou 512², mantenha as superfícies internas do cabelo em uma região escura para que as bordas da casca pareçam profundidade, e pinte o rosto — a malha permanece uma máscara.

Habilidades Relacionadas