pxt arcade

使用MicrosoftMakeCode的休闲游戏编辑器

• 尝试https://arcade.makecode.com
• 论坛

此存储库包含使用MicrosoftMakeCode（PXT）构建的街机编辑器。

创建和编辑包裹

在编辑器中，您将在保存图标旁边找到一个github图标。使用GitHub集成来构建库包。您无需安装本地开发服务器；一切都可以在编辑中发生。

本地服务器设置

此设置为您提供了本地版本的编辑器以及从计算机加载软件包的能力。这是开发新软件包的设置。

设置

• 安装Node.js 8+（您可能需要重新启动，以便正确应用所有环境变量）
• 克隆https://github.com/microsoft/pxt-arcade to pxt-arcade文件夹。例如，来自git bash

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

• 去pxt-arcade跑步

 cd pxt-arcade
npm install

不要忘记定期git pull和npm install以进行最新更改。

 git pull
npm install

启动服务器

该命令启动本地Web服务器。请注意，该Web服务器仅用于开发目的。它不是设计或确保用于在Web服务器上运行的。

 npm run serve

刷新社区.md文件

在必要时运行此命令，然后进行修补描述，改进屏幕截图（或记录GIF）。

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

此命令要求将ImageMagick（https://imagemagick.org/index.php）安装，并在命令行中以“ magick”提供。

更新PXT-Arcade-SIM版本

在更改PXT-Arcade引用的PXT-Arcade-SIM版本时，您需要在三个位置更改该版本：

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

在两个YML文件中，您将在检查PXT-Arcade-SIM的步骤中找到ref字段中的版本。

更新Markdown中的播放列表

获取Google API键并将其存储在GOOGLE_API_KEY环境变量（从应用程序中打开数据）。

 pxt downloadplaylists

如何创建精灵包

可以使用PXT软件包将图像包添加到编辑器中。创建图像包。

1. 创建一个软件包（请参阅上面的步骤）
2. 在喷雾片中准备小精灵：床单中的所有精灵必须相同，并在没有间隙的网格中排列。 SPRITESHEET必须是PNG文件。一个示例Spritesheet在这里
3. 在包装目录中，创建一个子目录，将资产放置并复制包含图像的spriteSheet。
4. 在您创建的目录中创建一个名为meta.json的文件。可以在此处找到一个示例meta.json
5. 创建另一个.json文件，带有与SpriteSheet相同的Basename。
6. 在该文件中，添加了一个称为frames单个属性，该属性将其映射到Sprites的名称数组。索引从纸张的左上角开始，然后从左向右行驶。对于示例文件，请参见此处
7. 从软件包的根中，运行命令pxt buildsprites SUBDIR其中SUBDIR是包含资产的目录的名称。
8. 包根将生成两个文件，一个文件带有Extenstion .ts ，一个带有扩展名.jres 。将两个添加到包装的pxt.json
9. 你完成了！将软件包添加到项目中时，图像将显示在图像类别中

本地开发设置

这些说明使您可以测试对PXT核心和PXT-Common包装的更改。由于您需要克隆和链接3个存储库，因此他们更加参与。

• 安装Node.js 8+（您可能需要重新启动，以便正确应用所有环境变量）
• （可选）安装Visual Studio代码

自动设置

• 下载setup.cmd到您的本地机器，然后将其放在您想完成开发工作的文件夹上
• 运行以下命令

setup.cmd /firsttime

此调用应自动执行手动设置中概述的步骤，并将克隆并链接所有三个存储库。

手动设置

• 安装PXT命令行工具

 [sudo] npm install -g pxt

在公共文件夹中，

• 克隆https://github.com/microsoft/pxt到pxt文件夹
• 克隆https://github.com/microsoft/pxt-common packages to pxt-common-packages文件夹
• 克隆https://github.com/microsoft/pxt-arcade to pxt-arcade文件夹
• 去pxt并运行

 npm install
npm run build

• 转到pxt-common-packages并运行

 npm install
npm link ../pxt

• 去pxt-arcade跑步

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

运行本地服务器

从root github文件夹中，

 cd pxt-arcade
pxt serve --rebundle

https://github.com/microsoft/pxt#Running-a-a-target-from-localhost上的更多说明

注意变化

要在更改时自动重建，我们需要大口。

安装gulp：

 npm install -g gulp

在距pxt serve和PXT/文件夹中的单独终端中，运行：

 gulp watch

使用setup.cmd

而不是必须转到每个存储库，而是单独拉并链接每个仓库，您现在可以使用setup.cmd文件。用法如下概述了以下内容：
/firsttime设置开发人员环境 - 将克隆3个仓库（PXT，PXT-ARCADE和PXT-COMMON包装），然后运行 ​​/链接选项
/pull对3个存储库进行git Pull（PXT，PXT-ARCADE和PXT-COMMON包装）
/link运行NPM安装并链接3个存储库
/run本地服务器并手表使用GULP进行更改

查看文档

文档是在服务器上渲染的，浏览器收到时可查看。使用特殊样式和扩展格式，以防止它们作为广义降价正确渲染。虽然您可以在存储库中浏览它们，但它们并不是要像GitHub文档一样正确地渲染。

贡献

该项目采用了Microsoft开源的行为代码。有关更多信息，请参见《行为守则常见问题守则》或与其他问题或评论联系[email protected]。

商标

Microsoft，Microsoft徽标，Makecode和Makecode Arcade是Microsoft Corporation的注册商标。它们只能按照Microsoft的商标和品牌准则在https://www.microsoft.com/en-us/legal/legal/intellectalectualproperty/trademarks/usage/usage/general.aspx上发表。如果Microsoft已发布的准则未涵盖使用，或者您不确定，请咨询您的法律顾问或Makecode团队（[email protected]）。