Mapas de textura e exemplos

Esta referência descreve os arquivos reais da V2 distribuídos em dist/assets/dice-box/themes/ do @erpg/dice3dview 2.6.1. A galeria interativa e o estúdio de temas usam os assets e o renderer V3; seus atlas compatíveis ajudam a comparar a estrutura, mas a prévia não reproduz o renderer V2.

Resumo dos mapas

Parte	Campo em theme.config.json	Exemplo incluído	Efeito
Glifos para corpo escuro	material.diffuseTexture.light	default/diffuse-light.webp	Números claros no atlas UV
Glifos para corpo claro	material.diffuseTexture.dark	default/diffuse-dark.webp	Números escuros no mesmo atlas UV
Relevo	material.bumpTexture	default/normal.webp	Detalhes de iluminação sem alterar a malha
Brilho	material.specularTexture	default/specular.jpg	Regiões refletivas; amostra opcional
Frente da moeda	coin.front.texture	default/coin-1.svg	Arte da face de valor 1
Verso da moeda	coin.back.texture	default/coin-2.svg	Arte da face de valor 2
Símbolos	material.diffuseTexture.light/dark	fate/faces-*.svg	Substituem números pelas artes do sistema

diffuse-light.webp, diffuse-dark.webp e normal.webp constam no manifesto default. specular.jpg acompanha os assets, mas não é referenciado pelo manifesto padrão: inclua specularTexture para usá-lo.

Atlas difuso claro e escuro

O atlas difuso distribui as faces de d4, d6, d8, d10, d12, d20 e d100 em posições UV fixas. No material color, os pixels transparentes deixam aparecer themeColor; a arte opaca preserva números e símbolos. O par light/dark serve ao contraste: a biblioteca escolhe uma variante segundo a luminosidade de themeColor.

Ao criar os seus arquivos, use o mesmo tamanho e as mesmas ilhas UV nas duas variantes. Não alinhe os números por uma grade comum: as posições correspondem à malha incluída, e a ordem aparente no arquivo não é a ordem dos resultados. Para trocar apenas a tipografia, preserve a ilha de cada face e trabalhe sobre uma cópia do atlas original. Use WebP ou PNG com canal alfa; fundos opacos cobrem a cor do corpo.

"material": {
  "type": "color",
  "diffuseTexture": {
    "light": "diffuse-light.webp",
    "dark": "diffuse-dark.webp"
  },
  "diffuseLevel": 1
}

diffuseTexture também aceita uma única string, útil quando a arte tem contraste suficiente em toda a paleta. O material standard usa a cor da textura como cor principal; ele é adequado para ilustrações coloridas, mas themeColor deixa de substituir a cor difusa.

Mapa normal

bumpTexture modifica a resposta à luz e dá aparência de gravação ou relevo. Não acrescenta polígonos, não altera colisores e não muda qual face pousa para cima. O exemplo numérico usa o mesmo layout UV do atlas difuso. Se deslocar um número no difuso, atualize também seu relevo. bumpLevel controla a intensidade; 0 desativa o efeito visual.

"bumpTexture": "normal.webp",
"bumpLevel": 0.5

Os temas simbólicos incluídos não declaram mapa normal numérico; assim não aparece um numeral gravado por baixo de um símbolo novo.

Mapa especular

specularTexture controla onde os brilhos aparecem. O arquivo default/specular.jpg demonstra a forma do mapa e pode ser copiado para um tema próprio. Ele não entra em ação só por estar na pasta: declare-o no manifesto.

"specularTexture": "specular.jpg"

specularPower existe no tipo público, mas não é aplicado pelo renderer 2.6.1. Ajuste a textura e avalie a iluminação em uma integração V2 real; o estúdio interativo usa o renderer V3.

Frente e verso da moeda

A moeda d2 usa geometria procedural e duas texturas independentes. A frente física +Y representa 1; o verso representa 2. O manifesto deve conservar front.value: 1 e back.value: 2, mesmo ao trocar a arte.

"coin": {
  "front": { "value": 1, "texture": "coin-1.svg" },
  "back": { "value": 2, "texture": "coin-2.svg" },
  "colorize": true,
  "diameter": 1,
  "thickness": 0.12
}

Com colorize: true, a transparência deixa themeColor preencher corpo e aro. Para uma moeda com ilustração colorida integral, use colorize: false e defina edgeColor.

Atlas simbólicos

Os temas fate, assimilation, vampire-v5-normal e vampire-v5-hunger incluem faces-light.svg e faces-dark.svg. Eles reutilizam a geometria padrão e colocam glifos nas ilhas UV numéricas. O atlas Fate, por exemplo, representa −1 com faces físicas 1–2, 0 com 3–4 e +1 com 5–6. O Core resolve a regra; o View exibe o símbolo.

O manifesto também pode declarar faceAtlas e faceMetadata para documentar essa correspondência. Esses campos não recalculam o resultado nem a física. Consulte personalizar faces simbólicas para o procedimento completo.

Caminhos e entrega

Texturas relativas são resolvidas a partir da pasta do tema. Também são aceitos caminhos iniciados por /, URLs HTTP(S) e data:. Por exemplo, em themes/my-theme/theme.config.json, "../default/normal.webp" reutiliza o mapa normal já distribuído. Para publicar fora do pacote, hospede a pasta, configure externalThemes e libere CORS para o domínio da aplicação. Teste as respostas HTTP dos assets antes do teste 3D.

Siga Crie um tema 3D para construir, testar e hospedar um tema próprio.