Repository navigation
Scripts do Projeto
O que há em scripts/, para que serve cada arquivo e onde ele está. Levantado em 10/10/2026: cada script foi
verificado quanto a imports e arquivos que cita e quanto a quem o referencia (código, testes, documentação, CI).
"Blender" quer dizer que roda dentro do Blender (import bpy), não pelo Python do projeto.
No repositório ficaram só os 13 scripts que o jogo, a CI e as ferramentas desta wiki usam (a primeira tabela).
Os outros 58 — pesquisa do encaixe, renderizadores de conferência e exportações antigas — foram para a pasta
backup/, na raiz do projeto, que o git ignora: existem só na máquina de quem os tinha e no histórico do git. Junto
foram os nove módulos experimentais de src/clothing (experimental_*.py, volumetric_cage.py), os treze arquivos
de teste deles (52 testes) e o manequim de referência do Roblox (ClassicMannequin_With-Cages.fbx). O
backup/README.md diz como trazê-los de volta.
Quatro scripts que já não rodavam (importavam módulos de experimento apagados em 06/10/2026) foram removidos de vez:
batch_compare_roblox.py, closeup_compare_roblox.py, compare_variants_roblox.py e sweep_radial_radius_roblox.py.
| Script | Para que serve |
|---|---|
build.py |
Compilação local multiplataforma do jogo (usado pela CI). |
audit_animation_robustness.py |
A [[Bateria de Robustez |
inspect_flagged_regions.py |
Aproxima a câmera do que a bateria marcou (pele furando, buraco), com e sem marcação. |
render_catalog_thumbnails.py |
Miniaturas dos itens e das raças para o editor de personagem. |
study_rest_arm_angle.py |
Estudo de quanto os braços precisam abrir em repouso para livrar cada roupa. |
render_female_tests.py |
Renderização sem janela das imagens de teste; as funções look_at e perspective dele são usadas por vários outros scripts. |
blender_nudred_hair.py (Blender) |
Gera o cabelo nudred e o raspado sobre as cabeças do jogo e exporta no formato de cabelo encaixado. |
build_game_rig.py (Blender) |
Monta o rig do jogo (16 ossos) num corpo aberto no Blender. |
export_rig.py (Blender) |
Exporta o rig do jogo para assets/models/rig_<corpo>.json. |
export_male_body.py (Blender) |
Exporta o corpo masculino e as cages R15 dele ([[Corpo Masculino |
build_male_cage.py |
Constrói a cage R15 masculina a partir da feminina (mesma topologia e UVs). |
import_roblox_clothing.py (Blender) |
Baixa, decodifica e importa roupas do Roblox no Blender. |
blender_client.py |
Cliente TCP para o servidor MCP do Blender; o import_roblox_clothing.py o importa. |
Vieram da fase em que o encaixe por cage foi desenvolvido e validado contra o Roblox. O que se aprendeu com eles
está em Histórico de Experimentos. O mais provável de voltar a ser útil é o
compare_roblox_ground_truth.py: se o encaixe for mexido, é ele que mede de novo a distância para o Roblox Studio.
| Script | Para que serve |
|---|---|
compare_roblox_ground_truth.py |
Compara o nosso encaixe no corpo Blocky com a malha exportada do Roblox Studio ([[Validação com Roblox |
audit_binding_charts.py |
Localiza quebras de borda da roupa entre ilhas de UV da cage. |
audit_blocky_radial_influences.py |
Repete o encaixe congelado do Blocky e mede a influência de cada parte. |
audit_blocky_target_placement.py |
Auditoria estática de posição e folga no Blocky. |
audit_canonical_radial_results.py |
Recalcula a validação a partir de saídas gravadas e localiza falhas por parte da cage. |
audit_outer_cage_clearance.py |
Compara a folga da cage externa original com a transferida. |
audit_radial_frames.py |
Auditoria reprodutível dos referenciais de entrada. |
experimental_wrap_frames.py |
Mapas locais candidatos para a transferência de cage. |
benchmark_wrap_frames.py |
Compara algoritmos de referencial da cage em roupas fixas. |
radial_validation_metrics.py |
Medidas geométricas offline (penetração sem usar o renderizador). |
experiment_canonical_radial.py |
Comparação fixa de seis casos. |
experiment_chart_blend.py |
Mistura nas bordas das ilhas de UV. |
experiment_dual_cage_prism.py |
Ligação por volume entre as faces das cages interna e externa. |
experiment_shell_adaptive.py, experiment_shell_global_affine.py
|
Controles de transporte local contra volume global. |
experiment_synthetic_contact.py, experiment_synthetic_wrap.py, synthetic_wrap_fixture.py
|
Bancadas sintéticas (braço analítico), sem assets reais. |
test_r15_shirt_transfer.py |
Transfere uma camisa do catálogo da cage de referência dela para as cages R15 locais. |
export_r15_reference_cages.py, inspect_classic_mannequin_fbx.py
|
Leem as cages de referência de ClassicMannequin_With-Cages.fbx (que também está em backup/). |
robustness_catalog.py |
Baixa uma amostra do catálogo e passa pelo encaixe feminino. |
Geram folhas de imagens para olhar um aspecto do sistema. Nada os chama; servem para conferir à mão.
| Script | O que renderiza |
|---|---|
render_walk.py |
O ciclo de caminhada dos dois corpos vestidos. |
render_male_outfits.py |
Conjuntos no corpo masculino ao lado do feminino. |
render_layered_outfits.py |
Jaqueta sobre camisa. |
render_shoes.py |
Sapatos, de perto. |
render_hairs.py |
Cada cabelo encaixado, na cabeça. |
render_male_cage.py |
A cage em aramado sobre o corpo, feminino e masculino. |
render_catalog_grid.py |
Todas as roupas que vestiram sem erro no corpo feminino. |
render_hsr_before_after.py, render_hsr_fallback.py
|
A pele escondida: regras antigas contra máscaras do Roblox, e a máscara geométrica de reserva. |
render_runtime_before_after.py, render_new_acceptance.py, render_uv_binding_review.py
|
Antes e depois de etapas do encaixe (prisma radial, validação do WrapLayer, ligação por UV). |
build_catalog_sample.py |
Monta uma amostra do catálogo por tipo de peça. |
Foram usadas para produzir os corpos, as cages e os pacotes que hoje estão em assets/models. Só voltam a ser
necessárias se um corpo ou uma cage for refeito no Blender.
| Script | Para que serviu |
|---|---|
export_apose_for_roblox.py, export_for_roblox_studio.py
|
Exportar o personagem em A-pose ou em repouso para o Roblox Studio. |
export_skinned_roblox.py, export_skinned_apose_roblox.py, export_separated_skinned_roblox.py
|
Variações do FBX com skinning aceito pelo Roblox Studio. |
export_modular_character.py |
Exportar o personagem em partes. |
export_female_apose.py, export_female_assets.py, export_female_cage_data.py, export_perfect_female_cages.py, update_female_cage_from_user_obj.py
|
O corpo feminino e as cages dele. |
export_stage2_clothing_package.py, verify_stage2_clothing_package.py, test_stage2_runtime_clothing.py
|
O pacote "stage 2" (corpo e cages revisados) e a conferência dele. |
build_universal_fit.py, full_universal_cage_pipeline.py
|
A primeira versão do encaixe universal, feita no Blender com shape keys. |
render_female_outfits.py, render_female_poses.py
|
Renderização dos conjuntos e das poses femininas pelo Blender. |
test_canonical_dual_cage.py, test_canonical_dual_cage_apose.py, test_female_dual_cage.py, test_office_wraplayer_mapping.py, verify_jeans_cage_activity.py
|
Verificações pontuais da época do encaixe por duas cages. |
-
backup/(ignorado): o que está descrito acima. Também guarda as exportações antigas para o Roblox Studio que estavam emassets/models(doze.fbxe um.json). -
O que um clone precisa e o
.gitignoreesconde:*.objé ignorado, então as malhas que o jogo abre entram no git à força (git add -f): os corpos (character_female_clean_apose_stage2.obj,character_male_clean_apose.obj), as cages (female_cages_apose_stage2.obj,male_cages_apose.obj,roblox_reference_cages.obj), a cabeça e o corpo de referência dos testes (character_head_rounded.obj,character_clean.obj) e os cabelos padrão, nudred e raspado (clothing/Hair_fitted_*). Conferido em 10/10/2026 com um clone limpo: o jogo abre nos dois corpos. Ao acrescentar uma malha nova que o jogo abre, lembre de adicioná-la à força. -
O catálogo: sem credencial do Roblox (
ROBLOSECURITYno.env, que não vai para o git) o download de roupas responde 401, então um clone só veste o que vem no repositório. Desde 04/11/2026 vai o catálogo inteiro (115 itens: roupas, calçados, cabelos e a katana), cada um com o.rbxm, a textura, a malha de origem (.obj, à força) e os dados de cage e de máscara que ele lê (wrap_cages/*.mesh,hsr/*.bin), e as miniaturas da tela de criação (thumbs/, também à força). Esse é o catálogo fixo, igual para todos. O tipo de cada item (camiseta, calça, vestido...) vem da roupa já encaixada, que é cache; por isso a lista fixa traz os tipos emclothing/catalog_types.json, que é o que um clone usa para separar as seções e que o jogo nunca altera. As roupas já encaixadas (character_native_*) e os cabelos encaixados do catálogo continuam cache local. -
Peças importadas pelo jogador são só dele: o que se baixa com
/skin vestir <id>fica nesta máquina. Os arquivos caem nas mesmas pastas, mas o.gitignoreos esconde, e o tipo delas é anotado emclothing/catalog_types.local.json(ignorado), assim como o cache de pacotes de calçado (shoe_bundles.json). Para promover uma peça ao catálogo fixo: adicione à força o.rbxm, a textura, o.obj, oswrap_cages/*.meshehsr/*.bindela e a miniatura, e acrescente o id e o tipo emcatalog_types.json. - Testes num clone: 664 passam e 1 é pulado (precisa de roupas já encaixadas, que são cache).
-
artifacts/(ignorado): resultados da bateria. Em 10/10/2026 ficaramrobustness_v37(rodada de 07/10),robustness/2026-10-09(rodada completa de referência) erobustness/2026-10-10e2026-10-10b(os dois experimentos do cruzamento tronco/braço).inspecaoé a pasta de saída deinspect_flagged_regions.py; estava cheia de imagens de depuração antigas e foi esvaziada. -
assets/models/character_native_*.obje*_hsr.npz(ignorados): as roupas já encaixadas em cada corpo. São refeitas pelo encaixe quando faltam; reencaixar o catálogo inteiro leva perto de uma hora. -
saves/(ignorado): o personagem salvo do jogador.
🟩 Equipe A — Motor do Mundo
🟦 Equipe B — Motor Interativo
👗 Sistema de Roupas e Customização
- 👗 Sistema de Roupas (WrapLayer & HSR)
- 🧥 Camadas e Sapatos
- 🧑 Corpo Masculino e Cages
- 💇 Cabelos e Acessórios
- 🦴 Animação e Esqueleto
- 💬 Comandos do Chat
- 🧑🎨 Criação de Personagem
- 📌 Pendências e Roadmap
- 🧰 Scripts do Projeto
- 📜 Proposta do Motor Universal de Roupas
🤖 Testes com o Claude
- 🤖 Testes e Verificações com o Claude
- 🗺️ Mapa de Testes e Ajustes
- 🧪 Bateria de Robustez
- 📊 Validação com Roblox Studio
- 🧪 Histórico de Experimentos
🔗 Integração