Validação Automática
Em andamento
Esta documentação ainda está sendo expandida e refinada. Recursos, capturas de tela e descrições podem mudar até o lançamento público do Talescape. Se algo estiver confuso ou você precisar de ajuda, pergunte no Discord oficial do Talescape. Temos prazer em esclarecer ou atualizar as páginas quando necessário.
O Sistema de Verificações do Editor ajuda você a verificar se sua história está completa, consistente e pronta para publicação. Ele escaneia automaticamente sua história em busca de problemas comuns (de ativos faltantes a metadados incompletos) e fornece feedback detalhado sobre o que corrigir.
Essas mesmas verificações também são usadas durante a revisão automatizada que roda antes da publicação. Executá-las dentro do editor permite resolver problemas cedo e evitar rejeições durante a publicação.
1. Executando Verificações
Você pode acionar verificações de duas maneiras:
| Escopo | Descrição |
|---|---|
| Verificação Global (Visão Geral) | Executa todas as validações disponíveis para toda a sua história. Acessível pelo painel Verificações na barra lateral. |
| Verificação Local (Por Elemento) | Executa validações para o elemento que você está editando no momento, como um capítulo, cena ou diálogo específico. |
Os resultados são exibidos imediatamente e agrupados por categoria (por exemplo, Marketplace, Capítulos, Cenas, Personagens). Você pode executar as verificações novamente a qualquer momento clicando em Executar Verificações.
2. Níveis de Gravidade
Cada problema recebe um nível de gravidade para indicar sua importância:
| Gravidade | Descrição | Ação |
|---|---|---|
| Info | Observações informativas ou sugestões. | Nenhuma ação necessária, mas pode ajudar a melhorar a qualidade. |
| Aviso | Questões potenciais que podem causar problemas dependendo do contexto. | Revise e corrija se relevante. |
| Falha | Erros críticos que impedem sua história de ser publicada. | Devem ser corrigidos antes de criar uma publicação. |
Falhas são destacadas claramente. Uma história com qualquer falha não pode ser publicada até que sejam resolvidas.
3. Verificações Típicas
O sistema cobre validações técnicas e estruturais, como:
| Categoria | Exemplos de Verificações |
|---|---|
| Marketplace | Comprimento da descrição, avisos sobre capturas de tela e requisitos de tags. |
| Capítulos | Cada capítulo tem uma cena inicial e pelo menos uma saída. |
| Cenas | As cenas são alcançáveis e os fundos obrigatórios estão presentes antes da publicação. |
| Diálogos | Sem ramos inacessíveis ou alvos ausentes. |
| Mídia | Todos os ativos referenciados existem e estão no formato exigido. |
| Itens / Crafting | Receitas, referências de itens e os visuais voltados ao jogador exigidos são válidos. |
Cada verificação exibe seu resultado, carimbo de data/hora e uma mensagem detalhada para que você saiba exatamente o que ajustar.
4. Verificações Locais Durante a Edição
Você também pode executar verificações locais diretamente dentro de editores como Cenas, Diálogos ou Capítulos.
Essas verificações focadas verificam apenas o conteúdo no qual você está trabalhando no momento, perfeitas para validação rápida antes de continuar o desenvolvimento.
Exemplo: Enquanto você edita uma cena, as verificações locais confirmam saídas válidas, uso e quaisquer requisitos de publicação faltantes, como fundos obrigatórios.
5. Integração com a Publicação
O mesmo sistema de validação é usado durante a fase de Revisão Automatizada do fluxo de publicação. Se você já corrigiu todos os problemas mostrados no Sistema de Verificações do Editor, sua história passará automaticamente pela etapa de revisão automatizada.
Isso garante uma transição tranquila do desenvolvimento para a publicação.
6. Boas Práticas
- Execute verificações completas da história regularmente, especialmente antes do envio.
- Corrija todas as Falhas e revise os Avisos para evitar surpresas durante a revisão.
- Use verificações locais com frequência enquanto edita para detectar problemas cedo.
- Revise os carimbos de data/hora para acompanhar quando cada verificação foi realizada pela última vez.
O Sistema de Verificações do Editor funciona como seu portão interno de qualidade, garantindo que toda história lançada no Talescape seja estável, completa e pronta para os Dreamers explorarem.