pxt arcade

Editor de jogos casual usando o Microsoft Makecode

• Experimente https://arcade.makecode.com
• Fórum

Este repo contém o editor de arcade construído com o Microsoft Makecode (PXT).

Criando e editando um pacote

No editor, você encontrará um ícone do GitHub ao lado do ícone Save. Use a integração do GitHub para criar um pacote de biblioteca. Você não precisa instalar o servidor de desenvolvimento local; Tudo pode acontecer no editor.

Configuração do servidor local

Essa configuração oferece uma versão local do editor e a capacidade de carregar pacotes da sua máquina. Esta é a configuração para desenvolver novos pacotes.

Configurar

• Instale o Node.js 8+ (pode ser necessário reiniciar depois para que todas as suas variáveis ​​de ambiente sejam aplicadas corretamente)
• Clone https://github.com/microsoft/pxt-arcade para pxt-arcade cart. Por exemplo, de uma festa git

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

• vá para pxt-arcade e corra

 cd pxt-arcade
npm install

Não se esqueça de git pull e npm install para obter as últimas alterações.

 git pull
npm install

Iniciando o servidor

Este comando inicia um servidor da web local. Observe que este servidor da Web é destinado apenas a fins de desenvolvimento. Não foi projetado ou protegido para ser executado em um servidor da Web.

 npm run serve

Refrescando o arquivo comunitário.md

Execute este comando e, em seguida, patch descrição, melhore a captura de tela (ou registre GIFs), se necessário.

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

Este comando requer imagemagick (https://imagemagick.org/index.php) a ser instalado e disponível na linha de comando como "magick".

Atualizando a versão pxt-arcade-sim

Ao alterar a versão do pxt-arcade-sim referenciada pela pxt-arcade, você precisa alterar a versão em três lugares:

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

Nos dois arquivos YML, você encontrará a versão no campo ref sob a etapa que verifica o pxt-arcade-sim.

Atualize listas de reprodução em Markdown

Obtenha uma chave da API do Google e armazene -a nas variáveis ​​do ambiente GOOGLE_API_KEY (ligue os dados do aplicativo).

 pxt downloadplaylists

Como criar pacotes de sprite

Pacotes de imagens podem ser adicionados ao editor usando pacotes PXT. Para criar um pacote de imagens.

1. Crie um pacote (veja as etapas acima)
2. Prepare seus sprites em uma folha de spritete: todos os sprites em uma folha devem ter o mesmo tamanho e dispostos em uma grade sem lacunas. A SpriteSheets deve ser arquivos PNG. Um exemplo de spriteSheet está localizado aqui
3. Dentro do diretório do pacote, crie um subdiretório em que os ativos serão colocados e copie a folha de sprites que contém suas imagens nele.
4. Crie um arquivo chamado meta.json no diretório que você criou. Um exemplo meta.json pode ser encontrado aqui e a documentação sobre todas as opções pode ser encontrada aqui
5. Crie outro arquivo .json com o mesmo nome de base que a folha de spriteS.
6. Dentro desse arquivo, adicione uma única propriedade chamada frames que mapeiam uma variedade de nomes para os sprites. Os índices começam no canto superior esquerdo da folha e prossiga para a esquerda para a direita. Para um arquivo de amostra, veja aqui
7. A partir da raiz do seu pacote, execute o comando pxt buildsprites SUBDIR , onde SUBDIR é o nome do diretório que contém os ativos.
8. Dois arquivos serão gerados na raiz do pacote, um com a extensão .ts e outra com a extensão .jres . Adicione os dois ao pxt.json do pacote
9. Você terminou! As imagens serão exibidas na categoria de imagem quando o pacote for adicionado a um projeto

Configuração do desenvolvedor local

Essas instruções permitem testar as alterações nos packages PXT-Core e PXT-Common. Eles estão mais envolvidos, pois você precisa clonar e vincular 3 repositórios.

• Instale o Node.js 8+ (pode ser necessário reiniciar depois para que todas as suas variáveis ​​de ambiente sejam aplicadas corretamente)
• (Opcional) Instale o código do Visual Studio

Configuração automatizada

• Faça o download do setup.cmd para sua máquina local e coloque -a na pasta que você gostaria de fazer seu trabalho de desenvolvimento
• Execute o seguinte comando

setup.cmd /firsttime

Esta chamada deve executar automaticamente as etapas descritas na configuração manual e clonará e vinculará os três repositórios.

Configuração manual

• Instale a ferramenta de linha de comando PXT

 [sudo] npm install -g pxt

Em uma pasta comum,

• clone https://github.com/microsoft/pxt to pxt pasta
• clone https://github.com/microsoft/pxt-common-packages para pxt-common-packages pasta
• Clone https://github.com/microsoft/pxt-arcade para pxt-arcade
• Vá para pxt e corra

 npm install
npm run build

• Vá para pxt-common-packages e corra

 npm install
npm link ../pxt

• vá para pxt-arcade e corra

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

Para executar o servidor local

Da pasta root github,

 cd pxt-arcade
pxt serve --rebundle

Mais instruções em https://github.com/microsoft/pxt#running-a-target-from-localhost

Para procurar mudanças

Para reconstruir automaticamente quando as alterações são feitas, precisamos de gole.

Instale Gulp:

 npm install -g gulp

E em um terminal separado do pxt serve e na pasta PXT/ Run: Execute:

 gulp watch

Usando setup.cmd

Em vez de ter que ir a cada repo, puxar e vincular cada um individualmente, agora você pode usar o arquivo setup.cmd . O uso é descrito o seguinte com estas opções:
/firsttime configura o ambiente do desenvolvedor-clonará 3 repositórios (PXT, PXT-arcade e PXT-Common-Packages) e depois executar /link opção
/pull faz uma tração git em 3 repositórios (pxt, pxt-arcela e pxt-common-packages)
/link executa o NPM Instale e vincula os 3 repositórios
/run Executa o servidor local e observa as alterações usando gole

Visualizando documentos

Os documentos são renderizados no servidor e são visualizados quando recebidos pelo navegador. Estilos especiais e formatação prolongada são usados, o que os impedem de renderizar adequadamente como marcação generalizada. Embora você possa navegá -los aqui no repositório, eles não devem renderizar corretamente como documento do GitHub.

Contribuindo

Este projeto adotou o Código de Conduta Open Microsoft. Para obter mais informações, consulte o Código de Conduta Perguntas frequentes ou entre em contato com [email protected] com quaisquer perguntas ou comentários adicionais.

Marcas comerciais

Microsoft, o logotipo da Microsoft, Makecode e Makecode Arcade são marcas registradas da Microsoft Corporation. Eles só podem ser usados ​​para os propósitos descritos em e de acordo com as diretrizes de marca registrada da Microsoft e publicadas em https://www.microsoft.com/en-us/legal/intelectualproperty/trademarks/usage/gener.aspx. Se o uso não for coberto nas diretrizes publicadas da Microsoft ou você não tiver certeza, consulte seu consultor jurídico ou equipe do Makecode ([email protected]).