Validación automatizada
En desarrollo
Esta documentación aún se está ampliando y puliendo. Las funciones, capturas y descripciones pueden cambiar hasta el lanzamiento público de Talescape. Si algo no está claro o necesitas ayuda, pregúntalo en el Discord oficial de Talescape. Encantados de aclarar o actualizar las páginas cuando haga falta.
El Sistema de comprobaciones del editor te ayuda a verificar que tu historia esté completa, coherente y lista para publicarse. Escanea automáticamente tu historia en busca de problemas comunes (desde recursos faltantes hasta metadatos incompletos) y te ofrece comentarios detallados sobre qué corregir.
Estas mismas comprobaciones también se usan durante la revisión automatizada que se ejecuta antes de la publicación. Ejecutarlas dentro del editor te permite resolver problemas temprano y evitar el rechazo durante la publicación.
1. Ejecutar comprobaciones
Puedes activar las comprobaciones de dos maneras:
| Alcance | Descripción |
|---|---|
| Comprobación global (Visión general) | Ejecuta todas las validaciones disponibles para toda tu historia. Accesible desde el panel Comprobaciones en la barra lateral. |
| Comprobación local (por elemento) | Ejecuta validaciones para el elemento que estás editando actualmente, como un capítulo, una escena o un diálogo específicos. |
Los resultados se muestran inmediatamente y se agrupan por categoría (p. ej., Marketplace, Capítulos, Escenas, Personajes). Puedes volver a ejecutar las comprobaciones en cualquier momento haciendo clic en Ejecutar comprobaciones.
2. Niveles de severidad
A cada problema se le asigna un nivel de severidad para indicar su importancia:
| Severidad | Descripción | Acción |
|---|---|---|
| Info | Notas informativas o sugerencias. | No requiere acción, pero puede ayudar a mejorar la calidad. |
| Advertencia | Posibles problemas que podrían causar problemas dependiendo del contexto. | Revisa y corrige si procede. |
| Fallo | Errores críticos que impiden que tu historia se publique. | Debe corregirse antes de crear una publicación. |
Los fallos se resaltan claramente. Una historia con cualquier fallo no puede publicarse hasta que se solucionen.
3. Comprobaciones típicas
El sistema cubre tanto validaciones técnicas como estructurales, por ejemplo:
| Categoría | Ejemplos de comprobaciones |
|---|---|
| Marketplace | Longitud de la descripción, advertencias sobre las capturas de pantalla y requisitos de etiquetas. |
| Capítulos | Cada capítulo tiene una escena de inicio y al menos una salida. |
| Escenas | Las escenas son accesibles y los fondos requeridos están presentes antes de la publicación. |
| Diálogos | No hay ramas inalcanzables ni objetivos faltantes. |
| Medios | Todos los recursos referenciados existen y coinciden con los formatos requeridos. |
| Objetos / Fabricación | Recetas, referencias a objetos y los elementos visuales requeridos para el jugador son válidos. |
Cada comprobación muestra su resultado, marca temporal y un mensaje detallado para que sepas exactamente qué ajustar.
4. Comprobaciones locales mientras editas
También puedes ejecutar comprobaciones locales directamente dentro de editores como Escenas, Diálogos o Capítulos.
Estas comprobaciones focalizadas verifican solo el contenido en el que estás trabajando actualmente; perfectas para una validación rápida antes de seguir desarrollando.
Ejemplo: Mientras editas una escena, las comprobaciones locales confirman salidas válidas, uso correcto y cualquier requisito de publicación faltante, como fondos requeridos antes de publicar.
5. Integración en la publicación
El mismo sistema de validación se usa durante la fase de Revisión Automatizada del flujo de publicación. Si ya has solucionado todos los problemas mostrados en el Sistema de comprobaciones del editor, tu historia superará automáticamente la fase de revisión automatizada.
Esto asegura una transición fluida del desarrollo a la publicación.
6. Buenas prácticas
- Ejecuta comprobaciones completas de la historia regularmente, especialmente antes de enviar.
- Corrige todos los fallos y revisa las advertencias para evitar sorpresas durante la revisión.
- Usa las comprobaciones locales con frecuencia mientras editas para detectar problemas temprano.
- Revisa las marcas temporales para seguir cuándo se realizó cada comprobación por última vez.
El Sistema de comprobaciones del editor actúa como tu puerta de calidad interna, asegurando que cada historia publicada en Talescape sea estable, completa y esté lista para que Dreamers la exploren.