Solución de problemas y comentarios

#Reportar un problema

Abrí Help → Report a problem… (o Report a problem en la pantalla Home). PyBlocks guarda un solo archivo zip que nos mandás vos; no se envía nada automáticamente.

1. Contá qué estabas haciendo, qué esperabas y qué pasó en cambio. La descripción es obligatoria.
2. Dejá tildado Attach diagnostics: agrega la versión, la información del sistema y de las pantallas, el final de los logs recientes y el último error de la sesión.
3. Tildá Include the project name o Include project files (scenes and scripts only) solo si te parece bien compartirlos. Los archivos del proyecto son solo de texto (escenas, scripts, animaciones, ajustes); nunca se incluyen imágenes ni audio.
4. Por defecto el zip se guarda en tu Escritorio; hacé clic en Change… para elegir otra carpeta.
5. Hacé clic en Save report (o apretá Ctrl+Enter) y después en Show in folder para encontrar el zip.

En todos los archivos adjuntos tu carpeta de usuario se reemplaza por ~. Copy details copia la versión y los datos del sistema al portapapeles, y Open logs folder abre la carpeta de logs.

#Cuando algo sale mal

• Something went wrong: si PyBlocks encuentra un error inesperado, aparece esta ventana con Open logs folder, Continue y Report a problem…. El editor sigue funcionando; guardá tu trabajo por las dudas.
• Errores en los bloques: el panel Problems lista los diagnósticos de los scripts, y los errores durante el juego aparecen en la Console. Un bucle descontrolado en un script de bloques se frena solo y se informa, en lugar de congelar el editor.
• Cierre inesperado: mientras una escena tiene cambios sin guardar, PyBlocks escribe una copia de recuperación cada dos minutos en <tu proyecto>\.pyblocks\autosave\. Cuando volvés a abrir el proyecto, Recover Unsaved Changes te ofrece Recover, Ignore y Delete Autosave.

#Logs

El editor escribe un log de diagnóstico en %LOCALAPPDATA%\PyBlocks\logs\pyblocks.log. Rota al llegar a 1 MB aproximadamente y conserva los cinco archivos anteriores. pyblocks_fault.log, en la misma carpeta, registra los cierres graves. Help → Open logs folder te abre la carpeta.

Los juegos exportados guardan sus propios logs en %LOCALAPPDATA%\<Developer Name>\<Game Name>\logs (mirá Exportar un juego para Windows).

#Verificar una instalación con el self-test

PyBlocks.exe --self-test <report.json> hace una verificación automática del editor instalado. Abre la ventana, crea un proyecto inicial en una carpeta temporal, abre PyBlocks Lab con Ctrl+Shift+L, juega cada ejemplo incluido durante 120 frames, carga los sonidos de la interfaz, genera un reporte de problema de prueba, exporta Sky Hopper con el player incluido y corre el self-test del propio juego exportado. Después escribe un reporte JSON con un valor passed y una entrada por cada verificación, y termina con código 0 si todo pasó.

Usa ajustes separados, así que no toca tus preferencias ni tus proyectos recientes, y no muestra el Quick tour. Desde una consola (cambiá la primera línea si instalaste PyBlocks en otro lugar; para encontrarlo, hacé clic derecho en el acceso directo de PyBlocks y elegí Abrir ubicación del archivo):

cd /d "%LOCALAPPDATA%\Programs\PyBlocks"
start /wait "" PyBlocks.exe --self-test "%USERPROFILE%\Desktop\pyblocks-self-test.json"
echo %errorlevel%

#Problemas comunes

• `Windows protegió su PC` al instalar o al abrir un juego: los archivos no tienen firma digital. Elegí Más información → Ejecutar de todas formas.
• Desaparecieron paneles o el diseño quedó desordenado: Window → Reset layout. Para mostrar un solo panel, usá Window → Panels.
• La vista Game está en otro lado: Window → Game view placement la devuelve a In the Game workspace.
• Deshacer no hace nada: el historial se pausa mientras el juego corre. Detené el juego primero.
• Ctrl+C / Ctrl+D copian o duplican un objeto en vez de un bloque: mirá los atajos del workspace Blocks.
• Una tecla no hace nada en mi juego: los juegos solo pueden leer las flechas, Espacio, Enter, Esc y W A S D Q E R F Z X C V.
• El botón de exportar está deshabilitado: a la instalación le falta el PyBlocks Player. Reinstalá PyBlocks.
• Export Blocked: corregí los diagnósticos que lista el panel Problems para las escenas incluidas.
• Could not replace the previous export: cerrá el juego exportado y exportá de nuevo.
• Mi fuente se ve distinta en el juego exportado: las fuentes instaladas en tu PC no se exportan. Importá la fuente al proyecto (UI, textos y fuentes).

#Limitaciones conocidas de la beta

• Deshacer cubre las ediciones de la escena y, en el workspace Animate, las de los clips de animación. El editor de Python del Lab usa el deshacer propio del editor de texto. El historial no se conserva al cerrar una escena.
• No hay red, ni 3D, ni exportación a móviles. Los juegos exportados corren solo en Windows.
• Los plugins del Lab ejecutan Python sin restricciones en el hilo del editor, sin sandbox; los bucles de Python no tienen el límite de los bucles de bloques, y las dependencias externas de los plugins no se incluyen al exportar.
• Los proyectos muy grandes (cientos de imágenes grandes o escenas enormes) pueden pausar el editor un momento al cargar.

#Mandar comentarios

Incluí tu versión exacta en cada reporte. Aparece en Help → About PyBlocks (que además tiene un botón Copy version), en el título de la ventana y en el extremo derecho de la barra de estado. Mandá el zip del reporte al canal de comentarios de la beta de PyBlocks que vino con tu descarga.

¡Gracias por probar PyBlocks!