Receitas de cena

Descreva uma cena. Importe um mapa.

Uma receita é um arquivo JSON curto de operações de alto nível. O aplicativo o expande em geometria alinhada à grade: pisos se ladrilham, paredes se encontram nos cantos, aberturas ficam nas arestas. É assim que as cenas iniciais são feitas, e é pequeno o bastante para um assistente de IA escrever a partir de uma frase.

Castle Gate at Dusk: muralhas, uma casa da guarda e um pátio
Castle Gate at Dusk é uma receita.

Como funciona

  1. Peça"Um santuário à beira da estrada num pinheiral ao entardecer, com um ladino esperando junto ao caminho."
  2. O assistente escreve uma receitaUsando os guias incluídos: o esquema de receitas, um guia de construção com checklist de QA e o catálogo de assets com cada id e sua área ocupada.
  3. ImporteArquivo ▸ Importar JSON de cena. Os modelos baixam da biblioteca; o construtor informa qualquer aviso.
  4. Decore e jogueAgora é uma cena normal: pinte, arraste, adicione luzes, aperte Play.

Como é uma receita

Nove operações fazem um mapa jogável. Os retângulos estão em células da grade, os assets são ids da biblioteca e o construtor cuida do resto: as paredes do perímetro ganham cantos corretos, a dispersão evita o santuário, a tocha ilumina o altar.

  • floor preenche retângulos ou segue um caminho, misturando materiais e girando tiles ao acaso para um chão natural.
  • walls percorre uma família de paredes ao redor de um retângulo com vãos para portas, ou ao longo dos lados escolhidos.
  • prop, line, scatter e clutter colocam coisas por célula, ao longo de um caminho ou aleatoriamente evitando áreas.
  • light, effect e mini adicionam tochas, fogo e fumaça, e tokens com PV e anéis.

A pasta ai/ do repositório tem o esquema, o guia de construção e o catálogo completo. Com o Claude Code o fluxo inteiro é um único comando: /create-scene.

{
  "format": "vtt-recipe",
  "name": "Roadside shrine",
  "grid": { "size": 1 },
  "environment": { "preset": "dusk" },
  "ops": [
    { "op": "floor", "asset": ["realistic-surfaces/grass_floor", "realistic-surfaces/grass_patchy_floor"],
      "rect": [0, 0, 19, 15], "randomYaw": true, "blend": 4 },
    { "op": "floor", "asset": "realistic-surfaces/dirt_floor", "path": [[0, 8], [19, 8]], "width": 2 },
    { "op": "floor", "asset": "realistic-surfaces/flagstone_floor", "rect": [8, 3, 11, 5] },
    { "op": "walls", "asset": "realistic-surfaces/stone_wall", "rect": [8, 3, 11, 5], "sides": "NEW" },
    { "op": "prop", "asset": "realistic-surfaces/stone_altar", "at": [9.5, 3.5] },
    { "op": "scatter", "asset": ["realistic-surfaces/fir_tree", "realistic-surfaces/pine_tree"],
      "area": [0, 0, 19, 6], "count": 14, "avoid": [[7, 2, 12, 6]] },
    { "op": "light", "type": "torch", "at": [9.5, 1.2, 4.5], "intensity": 5, "distance": 6 },
    { "op": "effect", "type": "fire", "at": [9.5, 0.6, 4.5] },
    { "op": "mini", "asset": "characters/rogue", "at": [3, 9], "label": "Pip", "ring": "ally" }
  ]
}

Perguntas

Com qual IA isso funciona?

Com qualquer assistente que consiga ler os guias e escrever JSON. Os guias foram escritos para o Claude Code, que tem um comando /create-scene no repositório, mas o formato é simples.

E se a IA usar um asset que não existe?

O construtor valida cada id contra a biblioteca e informa o que está faltando. As cenas iniciais são testadas com zero avisos.

Posso escrever receitas à mão?

Sim, e é mais rápido do que parece: o santuário acima são nove linhas de intenção. Os testes do repositório verificam qualquer receita que você coloque na pasta de exemplos.

Importe sua primeira receita

Cadastre-se, abra a mesa, Arquivo ▸ Importar JSON de cena.