pxt arcade

Editor de juegos casual usando Microsoft Makecode

• Pruébelo https://arcade.makecode.com
• Foro

Este repositorio contiene el editor Arcade construido con Microsoft Makecode (PXT).

Creación y edición de un paquete

En el editor, encontrará un icono GitHub junto al icono Guardar. Use la integración de GitHub para construir un paquete de biblioteca. No necesita instalar el servidor de desarrollo local; Todo puede suceder en el editor.

Configuración del servidor local

Esta configuración le brinda una versión local del editor y la capacidad de cargar paquetes de su máquina. Esta es la configuración para desarrollar nuevos paquetes.

Configuración

• Instale Node.js 8+ (es posible que necesite reiniciar después para que todas sus variables de entorno se apliquen correctamente)
• Clone https://github.com/microsoft/pxt-Arcade a la carpeta pxt-arcade . Por ejemplo, de una fiesta de git

 git clone https://github.com/microsoft/pxt-arcade

• ir a pxt-arcade y ejecutar

 cd pxt-arcade
npm install

No olvides git pull e npm install para obtener los últimos cambios.

 git pull
npm install

Lanzamiento del servidor

Este comando inicia un servidor web local. Tenga en cuenta que este servidor web está destinado solo a fines de desarrollo. No fue diseñado ni asegurado para ejecutarse en un servidor web.

 npm run serve

Actualizar el archivo Community.MD

Ejecute este comando, luego parche la descripción, mejore la captura de pantalla (o grabe GIF) si es necesario.

 pxt ddt featured-game --md docs/community.md

Este comando requiere imagemagick (https://imagemagick.org/index.php) para instalar y estar disponible en la línea de comando como "magia".

Actualización de la versión PXT-Arcade-SIM

Al cambiar la versión de PXT-Arcade-SIM referenciada por PXT-Arcade, debe cambiar la versión en tres lugares:

1. package.json
2. .github/workflows/pxt-buildmain.yml
3. .github/workflows/pxt-buildpush.yml

En los dos archivos YML, encontrará la versión en el campo ref en el paso que verifica PXT-Arcade-SIM.

Actualizar listas de reproducción en Markdown

Obtenga una clave de Google API y guárdela en las variables de entorno GOOGLE_API_KEY (active los datos de la aplicación).

 pxt downloadplaylists

Cómo crear paquetes de sprites

Se pueden agregar paquetes de imágenes al editor utilizando paquetes PXT. Para crear un paquete de imágenes.

1. Crea un paquete (ver pasos anteriores)
2. Prepare sus sprites en una hoja de sprits: todos los sprites en una hoja deben ser del mismo tamaño y dispuestos en una cuadrícula sin huecos. Las hojas de sprits deben ser archivos PNG. Un ejemplo de hoja de sprits se encuentra aquí
3. Dentro del directorio del paquete, cree un subdirectorio donde se colocarán los activos y copie la hoja de sprits que contiene sus imágenes.
4. Cree un archivo llamado meta.json en el directorio que creó. Se puede encontrar un ejemplo de meta.json y la documentación sobre todas las opciones se puede encontrar aquí
5. Cree otro archivo .json con el mismo nombre de base que el spritheet.
6. Dentro de ese archivo, agregue una sola propiedad llamada frames que se mapea a una variedad de nombres para los sprites. Los índices comienzan en la parte superior izquierda de la hoja y continúan de izquierda a derecha. Para un archivo de muestra, ver aquí
7. Desde la raíz de su paquete, ejecute el comando pxt buildsprites SUBDIR donde SUBDIR es el nombre del directorio que contiene los activos.
8. Se generarán dos archivos en la raíz del paquete, uno con la extensión .ts y otro con la extensión .jres . Agregue ambos al paquete pxt.json
9. ¡Ya terminaste! Las imágenes se mostrarán en la categoría de imagen cuando el paquete se agrega a un proyecto

Configuración de desarrollo local

Estas instrucciones le permiten probar los cambios en PXT-Core y PXT-Common-Packages. Están más involucrados ya que necesitas clonar y vincular 3 repos.

• Instale Node.js 8+ (es posible que necesite reiniciar después para que todas sus variables de entorno se apliquen correctamente)
• (Opcional) Instale el código Visual Studio

Configuración automatizada

• Descargue setup.cmd en su máquina local y colóquela en la carpeta que desea hacer su trabajo de desarrollo
• Ejecutar el siguiente comando

setup.cmd /firsttime

Esta llamada debe hacer automáticamente los pasos descritos en la configuración del manual y clonará y vinculará los tres repos.

Configuración manual

• Instale la herramienta de línea de comandos PXT

 [sudo] npm install -g pxt

En una carpeta común,

• clon https://github.com/microsoft/pxt a la carpeta pxt
• clon https://github.com/microsoft/pxt-common-packages a la carpeta de pxt-common-packages
• clon https://github.com/microsoft/pxt-abrade a la carpeta pxt-arcade
• ir a pxt y ejecutar

 npm install
npm run build

• Vaya a pxt-common-packages y ejecute

 npm install
npm link ../pxt

• ir a pxt-arcade y ejecutar

 npm install
npm link ../pxt
npm link ../pxt-common-packages

Para ejecutar el servidor local

De la carpeta de Root Github,

 cd pxt-arcade
pxt serve --rebundle

Más instrucciones en https://github.com/microsoft/pxt#running-a-target-from-localhost

Para observar los cambios

Para reconstruir automáticamente cuando se realizan cambios, necesitamos trago.

Instalar trago:

 npm install -g gulp

y en un terminal separado del pxt serve y en la carpeta PXT, ejecute:

 gulp watch

Usando setup.cmd

En lugar de tener que ir a cada repositorio, extra y vincular cada uno individualmente, ahora puede usar el archivo setup.cmd . El uso se describe de la siguiente manera con estas opciones:
/firsttime : Will Clone 3 Repos (PXT, PXT-Arcade y PXT-Common-Packages) y luego ejecutar /Link Opción
/pull hace un tirar de 3 repos (PXT, PXT-Arcade y PXT-Common-Packages)
/link ejecuta la instalación de NPM y los enlaces los 3 repositorios
/run ejecuta el servidor local y los relojes para los cambios usando GULP

Ver documentos

Los documentos se representan en el servidor y se pueden ver cuando el navegador recibe. Se utilizan estilos especiales y formateo extendido que les impiden hacer que se rinden correctamente como reducción generalizada. Si bien puede navegarlos aquí en el repositorio, no están destinados a renderizar adecuadamente como documento GitHub.

Que contribuye

Este proyecto ha adoptado el Código de Conducta Open Open Microsoft. Para obtener más información, consulte el Código de Conducta Preguntas frecuentes o comuníquese con [email protected] con cualquier pregunta o comentario adicional.

Marcas registradas

Microsoft, el logotipo de Microsoft, Makecode y Makecode Arcade son marcas registradas de Microsoft Corporation. Solo se pueden utilizar para los fines descritos en y de acuerdo con las pautas de marca y marca de Microsoft publicadas en https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Si el uso no está cubierto en las pautas publicadas de Microsoft o usted no está seguro, consulte a su asesor legal o equipo de Makecode ([email protected]).