Reportar un error
Cómo puedes reportar un error para que sea revisado y corregido
Si encuentras errores o problemas con el SDK de Decentraland y el Scene Editor en Creator Hub, por favor repórtalos en nuestro repositorio de GitHub aquí.
Antes de reportar un error
Antes de enviar un informe de error, por favor asegúrate de lo siguiente:
Asegúrate de estar usando la versión más reciente del SDK, por si el problema ya ha sido corregido en versiones más nuevas.
Consulta la documentación de la función que intentas usar, para confirmar que debe comportarse como esperas y que no se trata solo de un malentendido.
Descarta que el problema pueda ser causado por cómo está construida tu escena. Ver Depurar en Preview y Depurar en Prod para consejos.
Evita duplicados. Revisa la lista de errores conocidos para evitar crear un duplicado. Si tienes más información para agregar a un issue existente, por favor añade un comentario al issue en lugar de crear uno nuevo.
Cómo reportar un error
Para reportar un error con el SDK, necesitarás una cuenta de GitHub. Sigue estos pasos:
Visita el siguiente enlace: Página de nuevo issue
Haz clic Get Started junto a Bug Report.
Completa todos los campos de la plantilla. La plantilla proporciona instrucciones para cada sección. Cuantos más detalles puedas proporcionar, más rápido nuestros desarrolladores podrán identificar y resolver el problema.
Haz clic Enviar nuevo issue.
Los desarrolladores pueden hacer preguntas de seguimiento en tu ticket si necesitan aclaraciones o información adicional. Recibirás notificaciones por correo electrónico sobre actualizaciones de tu informe de error.
📔 Nota: Para cualquier problema no relacionado con el SDK, por favor contacta al equipo de soporte. Para comunicarte, visita esta página intercom.decentraland.org o envíanos un correo a [email protected]. También puedes encontrarnos en Discord. El equipo está disponible para ayudar de lunes a domingo, de 12:00 a 21:00 UTC y hará su mejor esfuerzo por responder lo antes posible. Puedes esperar una respuesta dentro de 60 minutos en Discord durante el horario indicado y dentro de 24 horas por correo electrónico.
También puedes contactar al equipo de soporte del DAO en el DAO Discord.
Consejos adicionales para los informes de errores:
Crea un issue separado para cada error. Si encuentras múltiples problemas, asegúrate de crear un nuevo issue para cada uno.
Evita explicaciones extensas. Incluye solo la salida relevante de la línea de comandos o la consola o el código de la escena cuando sea necesario.
Adjunta imágenes o videos si es posible. Puedes arrastrarlos y soltarlos fácilmente en el área de texto del issue, y GitHub se encargará de la subida y el enlace.
Uso del Decentraland Playground
Proporcionar fragmentos de código que demuestren el problema es extremadamente útil. La reproducibilidad es crucial. Si no se puede reproducir un error, es difícil diagnosticarlo y corregirlo.
Puedes pegar fragmentos de código dentro del texto de tu issue, pero la mejor manera de proporcionar fragmentos de código es usando el Decentraland Playground. Sigue estos pasos:
Escribe tu fragmento de código a la izquierda y visualiza tu escena en el panel de la derecha.
Haz clic en el Share botón y pega el enlace en tu informe de issue.
Usar el playground simplifica la reproducción del issue y garantiza que cualquiera que abra el enlace pueda ver la misma salida, independientemente de su sistema operativo, versión del SDK, versión de Node, etc. También facilita la iteración rápida para identificar las condiciones afectadas y localizar la causa del problema.
Mantén tu ejemplo lo más conciso posible, mientras aún reproduzcas el problema. Un ejemplo más simple ayuda a eliminar ambigüedades sobre la fuente del problema.
📔 Nota: No es posible importar assets a tu escena en el Playground. Por lo tanto, si reproducir el problema requiere importar un modelo 3D o un archivo de sonido, no será posible mostrarlo allí.
Obtener logs
A menudo es útil obtener los logs del Explorer de Decentraland al reportar un error.
Para obtener tus logs, simplemente abre el chat y escribe /logs. Esto abrirá una nueva ventana con los logs del Explorer de Decentraland. Adjunta el Player.log archivo a tu informe de issue.
Editar la documentación
Si descubres problemas en el contenido del sitio de la Documentación, puedes enviar solicitudes de cambio. Simplemente desplázate hasta el final de la página y haz clic en el Edit this page botón. GitHub te guiará para crear un pull request con tus cambios. El equipo de la fundación revisará tus cambios y los publicará si se consideran útiles.
Solicitudes de características y sugerencias
Si tienes sugerencias para agregar nueva funcionalidad o características en lugar de reportar un problema, por favor únete al Decentraland Discord Server y publica un mensaje en el Creator Hub Channel en lugar de crear un Issue en GitHub.
Última actualización