arcade-ai 0.1.0 → 0.2.0

package/README.md

@@ -1,30 +1,154 @@
 # arcade-ai
 
-AI-driven scaffold and live studio for Microsoft MakeCode Arcade games.
-
-## 安装与集成方式 (Installation & Integration)
-
-### 1. Claude Code 插件市场 (Claude Code plugin marketplace)
-你可以在 Claude Code plugin marketplace 中搜索并安装 `arcade-ai`。安装后即可在与 AI 对话时使用对应的技能，帮助生成和实时验证 MakeCode Arcade 游戏代码。
-
-### 2. Trae 智能辅助工具 (.trae)
-如果你使用 Trae，请将技能配置添加到 `.trae` 相关的规则路径中。初始化脚手架时通过指定 `--tool trae` 会在项目根目录下自动创建 `.trae/project_rules.md`。
-
-### 3. AI 代理常规配置 (AGENTS.md)
-对于通用的 AI 代理（如 Cline 或 Cursor 等），会在初始化时生成 `AGENTS.md` 文件。该文件定义了只修改 `game/main.ts`、严守 MakeCode Arcade 的 4 个约束、不可臆造 API 等核心规则，请确保将此规则导入你的 AI Agent 配置中。
-
-## 使用方法 (Usage)
-
-1. **项目初始化**：
-   ```bash
-   npx aca init <your-game-dir> [--tool claude|trae|agents]
-   ```
-2. **启动本地 Studio 双向实时预览服务**：
-   ```bash
-   cd <your-game-dir>
-   npx aca dev
-   ```
-3. **自检 postMessage 协议状态**：
-   ```bash
-   npx aca check
-   ```
+AI-driven scaffold and live studio for Microsoft MakeCode Arcade games. It ships as:
+
+- a reusable skill (`SKILL.md` + `reference/`) that tells an AI agent how to build Arcade games safely;
+- an npm CLI (`aca`) that creates projects, runs a local live studio, and checks the MakeCode editor protocol.
+
+## What It Does
+
+- Generates a pure TypeScript MakeCode Arcade project.
+- Adds the right AI rule file for your tool: `CLAUDE.md`, `.trae/project_rules.md`, or `AGENTS.md`.
+- Starts a local studio that embeds the official MakeCode Arcade editor.
+- Keeps `game/main.ts` and Arcade resource files synchronized with the editor.
+- Provides an offline reference for Arcade APIs, limits, project format, and known pitfalls.
+
+## Install The CLI
+
+Use it directly with `npx`:
+
+```bash
+npx arcade-ai init my-game --tool agents
+cd my-game
+npx aca dev
+```
+
+If the npm package has not been published yet, run it from GitHub:
+
+```bash
+npx --yes github:guolin/arcade-ai init my-game --tool agents
+cd my-game
+npx --yes github:guolin/arcade-ai dev
+```
+
+Or install it in a project:
+
+```bash
+npm install -D arcade-ai
+npx aca init my-game --tool claude
+```
+
+## Commands
+
+```bash
+aca init [dir] [--tool claude|trae|agents]
+aca dev [--port 8080]
+aca check [--url <makecode-url>]
+```
+
+- `aca init` creates the Arcade project, copies `reference/`, and writes the tool-specific rule file.
+- `aca dev` runs the local studio with live preview and editor-to-disk synchronization.
+- `aca check` verifies the MakeCode editor handshake and rendering path. This needs network access and Puppeteer.
+
+## Install The Skill
+
+The skill is the repo root: `SKILL.md` plus the `reference/` directory. Keep those together when installing.
+
+### Workbudy
+
+Workbudy should start from the dedicated guide, not only the repository homepage:
+
+```text
+https://github.com/guolin/arcade-ai/blob/main/WORKBUDDY.md
+```
+
+That page points Workbudy to the raw `SKILL.md` and every file under `reference/`. It also gives a prompt you can paste directly into Workbudy.
+
+Until the npm package is published, create projects from GitHub:
+
+```bash
+npx --yes github:guolin/arcade-ai init my-game --tool agents
+```
+
+After npm publishing, this shorter command is equivalent:
+
+```bash
+npx arcade-ai init my-game --tool agents
+```
+
+Then make sure Workbudy reads:
+
+- `my-game/AGENTS.md`
+- `my-game/reference/`
+
+In Workbudy prompts, ask it to follow `AGENTS.md` and use `reference/` before writing Arcade APIs it is unsure about. Run the studio with:
+
+```bash
+cd my-game
+npx aca dev
+```
+
+### Codex
+
+For Codex, install the skill into your Codex skills directory:
+
+```bash
+mkdir -p ~/.codex/skills
+git clone <this-repo-url> ~/.codex/skills/arcade-ai
+```
+
+Restart Codex after installation so it can discover the new skill. To create a project with Codex-friendly rules:
+
+```bash
+npx arcade-ai init my-game --tool agents
+```
+
+Codex should then read `AGENTS.md` in the generated project and use the installed `arcade-ai` skill whenever you ask it to build or modify a MakeCode Arcade game.
+
+### Claude Code
+
+Use the Claude Code plugin marketplace when this repo is published as a plugin:
+
+```text
+/plugin marketplace
+```
+
+Search for `arcade-ai`, install it, then restart or open a new Claude Code session if prompted.
+
+For a manual local install, copy or clone this repo as a skill:
+
+```bash
+mkdir -p ~/.claude/skills
+git clone <this-repo-url> ~/.claude/skills/arcade-ai
+```
+
+Create Claude-specific project rules with:
+
+```bash
+npx arcade-ai init my-game --tool claude
+```
+
+Claude Code will use `CLAUDE.md` in the generated project plus the installed `arcade-ai` skill.
+
+## Typical Workflow
+
+```bash
+npx arcade-ai init space-runner --tool claude
+cd space-runner
+npx aca dev
+```
+
+Then ask your AI agent to edit `game/main.ts`. Keep the studio open while the agent works; preview refreshes automatically.
+
+## Rules For AI Agents
+
+- Only write game code in `game/main.ts`.
+- Store resources in `game/assets.json`; do not inline large art assets into JavaScript.
+- Keep the project TypeScript-only: do not add `main.blocks`.
+- Use named tilemaps or built-in tiles for maps.
+- Read `reference/arcade-api.md`, `reference/limits.md`, and `reference/pitfalls.md` when unsure.
+- Do not invent MakeCode Arcade APIs.
+
+## License
+
+MIT

package/SKILL.md

@@ -12,12 +12,27 @@ description: Use when building or modifying a Microsoft MakeCode Arcade game —
 - 用户想做 / 改 arcade 游戏、像素小游戏、makecode 游戏时。
 
 ## 怎么用（三个命令）
-1. 起项目：`npx arcade-ai init <dir> [--tool claude|trae|agents]`
-   —— 生成纯 TS 脚手架，并把规则文件与 `reference/` 一并拷进项目。
+1. 起项目：`npx arcade-ai init <dir> [--template blank|platformer|flappy] [--tool claude|trae|agents]`
+
+   **执行 init 前，先问用户想做哪种游戏，根据回答选模板：**
+   - `--template blank`（**默认**）：空白项目，只有最简单的精灵和地图引用，适合从零开始。
+   - `--template platformer`：横版平台跳跃，含地图、敌人、重力跳跃，推荐有明确玩法时选。
+   - `--template flappy`：Flappy Bird 风格，管道障碍 + 重力下坠，推荐单一机制练习。
+
+   生成纯 TS 脚手架，并把规则文件与 `reference/` 一并拷进项目。
 2. 起 studio：在项目目录 `npx aca dev` —— 浏览器实时预览，AI 改 `game/main.ts` 自动刷新；
    在编辑器里改代码/画精灵也会回写磁盘（双向）。
 3. 协议自检：`npx aca check` —— 验证官方编辑器握手 + 代码真渲染（联网，需 puppeteer）。
 
+## 接手项目时必须先读文档
+拿到一个 arcade 项目（或准备写代码）时，**第一步读以下文件，不要跳过**：
+- `reference/arcade-api.md` —— 有哪些 API、怎么用
+- `reference/pitfalls.md` —— 哪些写法会翻车（踩坑成本极高）
+- `reference/limits.md` —— 内存/尺寸/功能硬限制
+- `reference/project-format.md` —— 文件格式约定（pxt.json / assets.json）
+
+读完再动手，遇到不确认的 API 回来查，不要靠记忆臆造。
+
 ## 写代码硬约束（违反会翻车）
 - 代码只写 `game/main.ts`；资源（精灵/地图，4-bit 16 色）走 `game/assets.json`，不内联大图到 JS。
 - **纯 TS 项目**：`game/` 里不要 `main.blocks`，`pxt.json` 的 `files` 也不列它，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcade-ai",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI-driven scaffold and live studio for Microsoft MakeCode Arcade games",
   "keywords": [
     "makecode",

package/reference/arcade-api.md

@@ -85,6 +85,8 @@
 ## 6. 游戏信息 (Info)
 处理分数、生命值和计时器。
 
+> **重要**：以下 API 调用后，Arcade HUD 会**自动在屏幕角落渲染分数、心形血条、倒计时**，无需写任何显示代码。不要用 `game.showLongText` 或自定义 sprite 手搓 UI——那是重复造轮子。
+
 - **设置/修改分数**：
   `info.setScore(0)`
   `info.changeScoreBy(10)`
@@ -95,6 +97,23 @@
   `info.startCountdown(30)` (30秒)
   `info.onCountdownEnd(function() { game.over(false) })`
 
+## 6b. 持久化存储与历史最高分 (Settings)
+MakeCode Arcade 提供 `settings` 命名空间，数据持久化到设备 flash（浏览器模拟器对应 localStorage）。
+
+```typescript
+// 历史最高分示例
+const best = settings.readNumber("highScore") || 0;
+if (info.score() > best) {
+    settings.writeNumber("highScore", info.score());
+}
+```
+
+- `settings.writeNumber(key, value)` / `settings.readNumber(key)`
+- `settings.writeString(key, value)` / `settings.readString(key)`
+- `settings.exists(key)` / `settings.remove(key)`
+
+> **没有内置排行榜 UI**：`settings` 只是 key-value 存储，多名玩家排行榜需要自己用 sprite/text 实现显示逻辑。
+
 ## 7. 地图 Tilemap（两条可靠路线，外加一个会崩的禁区）
 
 > ⚠️ **禁区**：`tiles.createTilemap(hex`...`, img`...`, [内联 img tile], ...)` —— **把内联 `img` 当图块会让官方编辑器崩溃**（Oops 重载循环）。编辑器的 tilemap 解析器只接受“命名图块资源”，不接受随手写的内联 img。已实测确认。详见 pitfalls 坑5。

package/src/cli.js

@@ -9,6 +9,7 @@ export function parseArgs(argv) {
     strict: false,
     options: {
       tool: { type: 'string' },
+      template: { type: 'string' },
       port: { type: 'string' },
       url: { type: 'string' },
     },
@@ -19,9 +20,9 @@ export function parseArgs(argv) {
 
 const HELP = `arcade-ai (aca)
 用法:
-  aca init [dir] [--tool claude|trae|agents]   起脚手架
-  aca dev  [--port 8080]                        起本地 studio
-  aca check [--url <makecode-url>]              自检 postMessage 协议`;
+  aca init [dir] [--template blank|platformer|flappy] [--tool claude|trae|agents]   起脚手架（默认: blank）
+  aca dev  [--port 8080]                                                        起本地 studio
+  aca check [--url <makecode-url>]                                              自检 postMessage 协议`;
 
 export async function run(argv) {
   const { command, positionals, options } = parseArgs(argv);

package/src/commands/init.js

@@ -21,14 +21,25 @@ function writeRules(dest, tool) {
   writeFileSync(target, content, 'utf8');
 }
 
+const TEMPLATES = ['platformer', 'flappy', 'blank'];
+const DEFAULT_TEMPLATE = 'blank';
+
 export default async function init(ctx) {
   const dest = ctx.positionals[0] || 'arcade-game';
+  const tpl = ctx.options.template || DEFAULT_TEMPLATE;
+
+  if (!TEMPLATES.includes(tpl)) {
+    console.error(`未知模板: ${tpl}，可选: ${TEMPLATES.join(', ')}`);
+    return 1;
+  }
+
   mkdirSync(dest, { recursive: true });
-  cpSync(join(templateDir, 'game'), join(dest, 'game'), { recursive: true });
+  // 每个模板是完整的 game/ 目录，直接拷贝
+  cpSync(join(templateDir, tpl, 'game'), join(dest, 'game'), { recursive: true });
   copyFileSync(join(templateDir, 'package.json'), join(dest, 'package.json'));
   // 把知识库拷进项目，使其自包含、跨工具可查（Trae/其它 AI 裸读项目也能用）
   cpSync(referenceDir, join(dest, 'reference'), { recursive: true });
   writeRules(dest, ctx.options.tool);
-  console.log(`✅ 已创建 ${dest}\n  cd ${dest} && npx aca dev`);
+  console.log(`✅ 已创建 ${dest}（模板: ${tpl}）\n  cd ${dest} && npx aca dev`);
   return 0;
 }

package/src/studio/server.js

@@ -1,11 +1,22 @@
 import { createServer } from 'node:http';
+import { createHash } from 'node:crypto';
 import { readFileSync } from 'node:fs';
 import { readProject, writeProject } from '../project-io.js';
 import { createWatcher } from './watcher.js';
 
+function hashFiles(files) {
+  const h = createHash('sha1');
+  for (const k of Object.keys(files).sort()) h.update(k + '\0' + (files[k] ?? ''));
+  return h.digest('hex');
+}
+
 export function startStudio({ gameDir, port = 0, hostHtmlPath }) {
   const clients = new Set();
+  let lastAiWriteAt = 0;   // AI 写盘时刻
+  let lastPushedHash = ''; // 最后一次推给编辑器的内容 hash
+
   const watcher = createWatcher(gameDir, () => {
+    lastAiWriteAt = Date.now();
     for (const res of clients) res.write('data: changed\n\n');
   });
 
@@ -15,16 +26,38 @@ export function startStudio({ gameDir, port = 0, hostHtmlPath }) {
       res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
       res.end(readFileSync(hostHtmlPath));
     } else if (req.method === 'GET' && url === '/api/project') {
+      const files = readProject(gameDir);
+      lastPushedHash = hashFiles(files);
       res.writeHead(200, { 'content-type': 'application/json' });
-      res.end(JSON.stringify({ files: readProject(gameDir) }));
+      res.end(JSON.stringify({ files }));
     } else if (req.method === 'POST' && url === '/api/save') {
       let body = '';
       req.on('data', (c) => (body += c));
       req.on('end', () => {
         try {
           const { files } = JSON.parse(body || '{}');
+
+          // 时间层：AI 写盘后 2 秒内的 save 是旧 iframe 临死前的遗留，丢弃
+          const msSinceAiWrite = Date.now() - lastAiWriteAt;
+          if (lastAiWriteAt > 0 && msSinceAiWrite < 2000) {
+            console.log(`[save] 忽略（AI 写盘后 ${msSinceAiWrite}ms，旧 iframe 遗留）`);
+            res.writeHead(200, { 'content-type': 'application/json' });
+            res.end(JSON.stringify({ success: true }));
+            return;
+          }
+
+          // 内容层：编辑器把我们推出去的内容原样还回来（echo），跳过落盘
+          const incomingHash = hashFiles(files || {});
+          if (incomingHash === lastPushedHash) {
+            console.log('[save] 忽略（内容与上次推送一致，echo）');
+            res.writeHead(200, { 'content-type': 'application/json' });
+            res.end(JSON.stringify({ success: true }));
+            return;
+          }
+
           watcher.pause(600);
           const written = writeProject(gameDir, files);
+          lastPushedHash = incomingHash;
           const incoming = Object.keys(files || {});
           const dropped = incoming.filter((f) => !written.includes(f));
           console.log(`[save] 收到 ${incoming.length} 文件，落盘 ${written.length}`);

package/src/template/blank/game/README.md

@@ -0,0 +1 @@
+# Blank Game

package/src/template/flappy/game/README.md

@@ -0,0 +1 @@
+# Flappy Bird Game

package/src/template/flappy/game/images.g.jres

@@ -0,0 +1,18 @@
+{
+    "myImages.image1": {
+        "id": "myImages.image1",
+        "data": "hwQQABAAAAAAAAAAu8sMAAAAAAC93csAAAAAAN3c3QwAAAAAXcXdywAAsLtb1dzNAAC7VVtV3M0AsFtVvVXbzQCw1dFVvdXNALAV/1VVVc2wu/W/RVVVxVu8VdVEVVXFtbBV3URVVbULANtERFVVuwAA8ExEW9ULAAAAALSwuwAAAAAACwAAAA==",
+        "dataEncoding": "base64",
+        "namespace": "myImages.",
+        "mimeType": "image/x-mkcd-f4",
+        "displayName": "playerImage"
+    },
+    "anim1": {
+        "id": "anim1",
+        "data": "YzgwMDEwMDAxMDAwMDYwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDBiMDU1MGIwMDAwMDAwMGJiYmJiYjAwMDAwMDAwYjA1YjU1NTUwYjAwYjBiYmJiNTU1NTU1YjUwMGIwNWQ1YjU1NTU1NWI1MDAwMDViYjVkNWYxZDVmNDAwMDBkYjU1MWJmZjQ1YzQwMGJiYmQ1NWQ1YmY0NDQ0MGJkYmNkNWRiNTQ1NDQ0NGI0ZGNkZGNjNWI1NTU1NTUwYmJjZGRkZDVkNTU1NTU1MGJjMGRkZGRkZDU1NTVkNTBiMDBiY2RkZGQ1ZDU1YmIwMDAwYzBjY2NjY2NiYzBiMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDViMGIwMDAwMDAwMDAwYjBiNTAwMDAwMDAwMDBiYmJiYmIwMDAwMDAwMGIwNWI1NTU1MGIwMGIwYmJiYjU1NTU1NWI1MDBiMDVkNWI1NTU1NTViNTAwMDA1YmI1ZDVmMWQ1ZjQwMDAwZGI1NTFiZmY0NWM0MDBiYmJkNTVkNWJmNDQ0NGI0ZGJjZDVkYjU0NTQ0NDQwYmRjZGRjYzViNTU1NTU1MGJiY2RkZGQ1ZDU1NTU1NTBiYzBkZGRkZGQ1NTU1ZDUwYjAwYmNkZGRkNWQ1NWJiMDAwMGMwY2NjY2NjYmMwYjAwMDAwMDAwMDAwMDViMGIwMDAwMDAwMDAwYjBiNTAwMDAwMDAwMDAwMGIwMGMwMDAwMDAwMDAwYmJiYmJiMDAwMDAwMDBiMDViNTU1NTBiMDAwMDAwYmJkNWYxNTVmZDAwMDAwMDViMTVmZmQ1YzQwMDAwMDA1YmQ1YmZkZDQ0MDBkYmRkYmI1ZDU1NDQ0NGI0YmI1ZDU1NWI0NTQ0NDQwYmRiNWM1NWQ1NTU1NWI1MDBkY2NkNWRiNTU1NTU1NTBiYmNkZGNjNWI1NTU1NTUwYmMwZGRkZGRkNTU1NWQ1MGIwMGJjZGRkZDVkNTViYjAwMDBjMGNjY2NjY2JjMGIwMDAwMDAwMDAwMDA1YjBiMDAwMDAwMDAwMGIwYjUwMDAwMDAwMDAwYmJiYmJiMDAwMDAwMDBiMDViNTU1NTBiMDAwMDAwYmJkNWYxZDVjNDAwMDAwMDViMTVmZmRkNDRiNDAwMDA1YmQ1YmY0NDQ0MGIwMGIwNWQ1NTQ1NDRiNDAwMDBkYjVkNTU1NTU1YjUwMGIwZGRkZDU1NTU1NTU1MGJkYmRkYmI1YjU1NTU1NTBiZGNiZDU1Y2Q1NTU1NTUwYmJjZGJkNWRjNTU1NTU1MGJiMDU1Y2JkZDU1NTVkNTBiYmJjY2RjZGQ1ZDU1YmIwMDAwYzBjY2NjY2NiYzBiMDAwMDAwMDAwMDAwNWIwYjAwMDAwMDAwMDBiMGI1MDAwMDAwMDAwMGJiYmJiYjAwMDAwMDAwYjA1YjU1NTUwYjAwMDAwMGJiZDVmMWQ1YzQwMDAwMDA1YjE1ZmZkZDQ0YjQwMDAwNWJkNWJmNDQ0NDBiMDBiMDVkNTU0NTQ0YjQwMGIwZGJkZDU1NTU1NWI1MDBkYmRkYmI1YjU1NTU1NTBiZGNiZDU1Y2Q1NTU1NTUwYmJjZGJkNWRjNTU1NTU1MGJiYzU1Y2JkZDU1NTU1NTBiYmJjY2RjZGQ1NTU1ZDUwYjAwMDBjY2RkNWQ1NWJiMDAwMDAwMDBjY2NjYmMwYjAwMDAwMDAwMDAwMDViMGIwMDAwMDAwMDAwYjBiNTAwMDAwMDAwMDBiYmJiYmIwMDAwMDAwMGIwNWI1NTU1MGIwMDAwMDBiYmQ1ZjE1NWZkMDAwMDAwNWIxNWZmZDVjNDAwMDAwMDViZDViZmRkNDQwMGIwYmI1ZDU1NTU0NDQ0YjRkYmRkYmI1ZDQ1NDQ0NDBiYmI1ZDU1NWI1NTU1YjUwMGRjNWM1NWQ1NTU1NTU1MGJiY2NkNWRiNTU1NTU1NTBiYzBkZGNjZGI1NTU1ZDUwYjAwYmNkZGRkNWQ1NWJiMDAwMGMwY2NjY2NjYmMwYjAwMDAwMDAwMDAwMDAwMDAwMA==",
+        "dataEncoding": "base64",
+        "namespace": "myAnimations.",
+        "mimeType": "application/mkcd-animation",
+        "displayName": "playerAnimation"
+    }
+}

package/src/template/flappy/game/images.g.ts

@@ -0,0 +1,160 @@
+// Auto-generated code. Do not edit.
+namespace myImages {
+
+    helpers._registerFactory("image", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+            case "image1":
+            case "playerImage":return img`
+. . . . . . . . . . b 5 b . . . 
+. . . . . . . . . b 5 b . . . . 
+. . . . . . . . . b c . . . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. . . . b b 5 d 1 f 5 5 d f . . 
+. . . . b 5 5 1 f f 5 d 4 c . . 
+. . . . b 5 5 d f b d d 4 4 . . 
+b d d d b b d 5 5 5 4 4 4 4 4 b 
+b b d 5 5 5 b 5 5 4 4 4 4 4 b . 
+b d c 5 5 5 5 d 5 5 5 5 5 b . . 
+c d d c d 5 5 b 5 5 5 5 5 5 b . 
+c b d d c c b 5 5 5 5 5 5 5 b . 
+. c d d d d d d 5 5 5 5 5 d b . 
+. . c b d d d d d 5 5 5 b b . . 
+. . . c c c c c c c c b b . . . 
+`;
+        }
+        return null;
+    })
+
+    helpers._registerFactory("animation", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+            case "playerAnimation":
+            case "anim1":return [img`
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . b 5 5 b . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. b b b b b 5 5 5 5 5 5 5 b . . 
+. b d 5 b 5 5 5 5 5 5 5 5 b . . 
+. . b 5 5 b 5 d 1 f 5 d 4 f . . 
+. . b d 5 5 b 1 f f 5 4 4 c . . 
+b b d b 5 5 5 d f b 4 4 4 4 b . 
+b d d c d 5 5 b 5 4 4 4 4 4 4 b 
+c d d d c c b 5 5 5 5 5 5 5 b . 
+c b d d d d d 5 5 5 5 5 5 5 b . 
+. c d d d d d d 5 5 5 5 5 d b . 
+. . c b d d d d d 5 5 5 b b . . 
+. . . c c c c c c c c b b . . . 
+`, img`
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . b 5 b . . . 
+. . . . . . . . . b 5 b . . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. b b b b b 5 5 5 5 5 5 5 b . . 
+. b d 5 b 5 5 5 5 5 5 5 5 b . . 
+. . b 5 5 b 5 d 1 f 5 d 4 f . . 
+. . b d 5 5 b 1 f f 5 4 4 c . . 
+b b d b 5 5 5 d f b 4 4 4 4 4 b 
+b d d c d 5 5 b 5 4 4 4 4 4 b . 
+c d d d c c b 5 5 5 5 5 5 5 b . 
+c b d d d d d 5 5 5 5 5 5 5 b . 
+. c d d d d d d 5 5 5 5 5 d b . 
+. . c b d d d d d 5 5 5 b b . . 
+. . . c c c c c c c c b b . . . 
+`, img`
+. . . . . . . . . . b 5 b . . . 
+. . . . . . . . . b 5 b . . . . 
+. . . . . . . . . b c . . . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. . . . b b 5 d 1 f 5 5 d f . . 
+. . . . b 5 5 1 f f 5 d 4 c . . 
+. . . . b 5 5 d f b d d 4 4 . . 
+b d d d b b d 5 5 5 4 4 4 4 4 b 
+b b d 5 5 5 b 5 5 4 4 4 4 4 b . 
+b d c 5 5 5 5 d 5 5 5 5 5 b . . 
+c d d c d 5 5 b 5 5 5 5 5 5 b . 
+c b d d c c b 5 5 5 5 5 5 5 b . 
+. c d d d d d d 5 5 5 5 5 d b . 
+. . c b d d d d d 5 5 5 b b . . 
+. . . c c c c c c c c b b . . . 
+`, img`
+. . . . . . . . . . b 5 b . . . 
+. . . . . . . . . b 5 b . . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. . . . b b 5 d 1 f 5 d 4 c . . 
+. . . . b 5 5 1 f f d d 4 4 4 b 
+. . . . b 5 5 d f b 4 4 4 4 b . 
+. . . b d 5 5 5 5 4 4 4 4 b . . 
+. . b d d 5 5 5 5 5 5 5 5 b . . 
+. b d d d d 5 5 5 5 5 5 5 5 b . 
+b d d d b b b 5 5 5 5 5 5 5 b . 
+c d d b 5 5 d c 5 5 5 5 5 5 b . 
+c b b d 5 d c d 5 5 5 5 5 5 b . 
+. b 5 5 b c d d 5 5 5 5 5 d b . 
+b b c c c d d d d 5 5 5 b b . . 
+. . . c c c c c c c c b b . . . 
+`, img`
+. . . . . . . . . . b 5 b . . . 
+. . . . . . . . . b 5 b . . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. . . . b b 5 d 1 f 5 d 4 c . . 
+. . . . b 5 5 1 f f d d 4 4 4 b 
+. . . . b 5 5 d f b 4 4 4 4 b . 
+. . . b d 5 5 5 5 4 4 4 4 b . . 
+. b b d d d 5 5 5 5 5 5 5 b . . 
+b d d d b b b 5 5 5 5 5 5 5 b . 
+c d d b 5 5 d c 5 5 5 5 5 5 b . 
+c b b d 5 d c d 5 5 5 5 5 5 b . 
+c b 5 5 b c d d 5 5 5 5 5 5 b . 
+b b c c c d d d 5 5 5 5 5 d b . 
+. . . . c c d d d 5 5 5 b b . . 
+. . . . . . c c c c c b b . . . 
+`, img`
+. . . . . . . . . . b 5 b . . . 
+. . . . . . . . . b 5 b . . . . 
+. . . . . . b b b b b b . . . . 
+. . . . . b b 5 5 5 5 5 b . . . 
+. . . . b b 5 d 1 f 5 5 d f . . 
+. . . . b 5 5 1 f f 5 d 4 c . . 
+. . . . b 5 5 d f b d d 4 4 . . 
+. b b b d 5 5 5 5 5 4 4 4 4 4 b 
+b d d d b b d 5 5 4 4 4 4 4 b . 
+b b d 5 5 5 b 5 5 5 5 5 5 b . . 
+c d c 5 5 5 5 d 5 5 5 5 5 5 b . 
+c b d c d 5 5 b 5 5 5 5 5 5 b . 
+. c d d c c b d 5 5 5 5 5 d b . 
+. . c b d d d d d 5 5 5 b b . . 
+. . . c c c c c c c c b b . . . 
+. . . . . . . . . . . . . . . . 
+`];
+        }
+        return null;
+    })
+
+    helpers._registerFactory("song", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+    helpers._registerFactory("json", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+}
+// Auto-generated code. Do not edit.
+
+// Auto-generated code. Do not edit.
+namespace myTiles {
+
+}
+// Auto-generated code. Do not edit.

package/src/template/flappy/game/main.ts

@@ -0,0 +1,61 @@
+// Use SpriteKind.create() to create a unique kind for each Sprite
+const GateKind = SpriteKind.create();
+const PlayerKind = SpriteKind.create();
+
+scene.setBackgroundColor(9);
+showControls();
+startGame();
+
+function showControls() {
+    // showLongText automatically pauses until A is pressed
+    game.showLongText("Press A to jump\n \nTry to avoid the gates!", DialogLayout.Center);
+}
+
+function startGame() {
+    // Create the player sprite using the "playerImage" asset
+    const mySprite = sprites.create(assets.image`playerImage`, PlayerKind);
+    mySprite.left = 4;
+    mySprite.setFlag(SpriteFlag.StayInScreen, true);
+    mySprite.ay = 500;
+
+    // When A is pressed, make the player sprite jump and play a flapping animation
+    controller.A.onEvent(ControllerButtonEvent.Pressed, () => {
+        mySprite.vy = -100;
+        animation.runImageAnimation(mySprite, assets.animation`playerAnimation`, 50)
+    });
+
+    // Spawn a gate every 2 seconds
+    game.onUpdateInterval(2000, () => {
+        // Create a gate with an empty image that spans the height of the screen
+        const gate = sprites.create(image.create(12, screen.height), GateKind);
+
+        // Select a y value for our gate opening to start
+        const gapHeight = 50;
+        const gapStart = randint(0, screen.height - gapHeight);
+
+        // Draw the gate on the empty image
+        gate.image.fillRect(2, 0, 8, screen.height, 6);
+        gate.image.fillRect(2, gapStart, 8, 50, 0);
+        gate.image.fillRect(0, gapStart - 5, 12, 5, 6);
+        gate.image.fillRect(0, gapStart + gapHeight, 12, 5, 6);
+
+        // Move the gate to the right side of the screen and give it velocity
+        gate.left = screen.width;
+        gate.vx = -50;
+
+        // Turn on the AutoDestroy flag so that gates are automatically destroyed
+        // when they leave the screen
+        gate.setFlag(SpriteFlag.AutoDestroy, true);
+    });
+
+    // End the game when the player overlaps a gate
+    sprites.onOverlap(PlayerKind, GateKind, (sprite, otherSprite) => {
+        game.over();
+    });
+
+    // When a gate is auto destroyed, increase our score by 1
+    sprites.onDestroyed(GateKind, () => {
+        info.changeScoreBy(1);
+    });
+}
+

package/src/template/flappy/game/pxt.json

@@ -0,0 +1,18 @@
+{
+    "name": "flappy-game",
+    "description": "Flappy Bird style game template",
+    "dependencies": {
+        "device": "*"
+    },
+    "files": [
+        "main.ts",
+        "README.md",
+        "assets.json",
+        "images.g.jres",
+        "images.g.ts"
+    ],
+    "supportedTargets": [
+        "arcade"
+    ],
+    "preferredEditor": "tsprj"
+}

package/src/template/platformer/game/README.md

@@ -0,0 +1 @@
+# Platformer Game

package/src/template/platformer/game/assets.json

@@ -0,0 +1 @@
+{}

package/src/template/platformer/game/images.g.jres

@@ -0,0 +1,18 @@
+{
+    "myImages.image1": {
+        "id": "myImages.image1",
+        "data": "hwQOAA4AAAAAAAD7/w8AAAAAAN/d+wAAAAAA+//9AAAAAAAA8Pv/AM7M7/6/2/0A3jvb3bLdDwDevdPfLb0PAMDd3f0t3f0AAL/d3Svd/wAA393dK90PAMDd3f0t3Q8A3r3T3y3b/QDeO9vd+///AM7M7/4PAAAA",
+        "dataEncoding": "base64",
+        "namespace": "myImages.",
+        "mimeType": "image/x-mkcd-f4",
+        "displayName": "playerImage"
+    },
+    "myImages.image2": {
+        "id": "myImages.image2",
+        "data": "hwQQABAAAAAAAAAAAPD/AAAAAAAAwLEAAAD//w8f+wAA/929/B+xAPAbEd29H/sA8BERvRzM8Q8fERHxH73/Dx8REdER+///HxER0RGx//8fERHxH/v///AREb0czbEP8BsR3b0f+wAA/929/B+xAAAA//8PH/sAAAAAAADPsQAAAAAAAPD/AA==",
+        "dataEncoding": "base64",
+        "namespace": "myImages.",
+        "mimeType": "image/x-mkcd-f4",
+        "displayName": "enemyImage"
+    }
+}

package/src/template/platformer/game/images.g.ts

@@ -0,0 +1,74 @@
+// Auto-generated code. Do not edit.
+namespace myImages {
+
+    helpers._registerFactory("image", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+            case "image1":
+            case "playerImage":return img`
+. . . . e e e . . . . e e e 
+. . . . c d d c . . c d d c 
+. . . . c b d d f f d d b c 
+. . . . c 3 b d b d d b 3 c 
+. . . . f b 3 d d d d 3 b f 
+. . . . e d d d d d d d d e 
+b f b . e d f d d d d f d e 
+f d f . f d d f d d f d d f 
+f d f . f 2 d d b b d d b f 
+f d f f b b 2 2 2 2 2 2 f . 
+f b d b b d d d d d d b f . 
+. f f f d d b d d d d d f . 
+. . . f d f f d f f f d f . 
+. . . f f . . f f . . f f . 
+`;
+            case "image2":
+            case "enemyImage":return img`
+. . . . . . f f f f . . . . . . 
+. . . . f f 1 1 1 1 f f . . . . 
+. . . f b 1 1 1 1 1 1 b f . . . 
+. . . f 1 1 1 1 1 1 1 1 f . . . 
+. . f d 1 1 1 1 1 1 1 1 d f . . 
+. . f d 1 1 1 1 1 1 1 1 d f . . 
+. . f d d d 1 1 1 1 d d d f . . 
+. . f b d b f d d f b d b f . . 
+. . f c d c f 1 1 f c d c f . . 
+. . . f b 1 1 1 1 1 1 b f . . . 
+. . f f f c d b 1 b d f f f f . 
+f c 1 1 1 c b f b f c 1 1 1 c f 
+f 1 b 1 b 1 f f f f 1 b 1 b 1 f 
+f b f b f f f f f f b f b f b f 
+. . . . . f f f f f f . . . . . 
+. . . . . . . f f f . . . . . . 
+`;
+        }
+        return null;
+    })
+
+    helpers._registerFactory("animation", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+    helpers._registerFactory("song", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+    helpers._registerFactory("json", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+}
+// Auto-generated code. Do not edit.
+
+// Auto-generated code. Do not edit.
+namespace myTiles {
+
+}
+// Auto-generated code. Do not edit.

package/src/template/platformer/game/main.ts

@@ -0,0 +1,141 @@
+// Use SpriteKind.create() to create a unique kind for each sprite
+const PlayerKind = SpriteKind.create();
+const EnemyKind = SpriteKind.create();
+
+// The Y acceleration of the player and enemies in pixel/second^2
+const GRAVITY = 1000;
+
+// The move speed of the player in pixels/second
+const MOVE_SPEED = 100;
+
+// The jump height in pixels
+const JUMP_HEIGHT = 32;
+
+// The height the player bounces when they jump on an enemy
+const BOUNCE_HEIGHT = 16;
+
+// The move speed of enemies in pixels/second
+const ENEMY_SPEED = 50;
+
+let player: Sprite;
+startGame();
+
+function startGame() {
+    // Set the background color to cyan
+    scene.setBackgroundColor(9);
+
+    loadTilemap();
+    createPlayer();
+    registerEvents();
+}
+
+function loadTilemap () {
+    // Load the tilemap asset
+    scene.setTileMapLevel(assets.tilemap`level`);
+    
+    // Loop over all enemySpawn tiles and create enemy sprites at
+    // those locations
+    for (let location of tiles.getTilesByType(assets.tile`enemySpawn`)) {
+        const enemy = sprites.create(assets.image`enemyImage`, EnemyKind);
+        enemy.x = location.x;
+        enemy.y = location.y;
+        enemy.ay = GRAVITY;
+        
+        // Hide the enemy spawn tile
+        tiles.setTileAt(location, assets.tile`transparency16`);
+        
+        // Randomly make the enemy move left or right
+        if (Math.percentChance(50)) {
+            enemy.vx = ENEMY_SPEED;
+        } else {
+            enemy.vx = 0 - ENEMY_SPEED;
+        }
+    }
+}
+
+function createPlayer() {
+    // Create the player sprite using the playerImage asset
+    player = sprites.create(assets.image`playerImage`, PlayerKind);
+
+    // Set the acceleration in the Y direction equal to our gravity
+    player.ay = GRAVITY;
+
+    // Move the sprite with buttons, but only in the X direction
+    controller.moveSprite(player, MOVE_SPEED, 0);
+
+    // Follow the player with the camera. The camera is automatically
+    // boxed within the tilemap
+    scene.cameraFollowSprite(player);
+
+    // Place the player on top of the playerSpawn tile
+    tiles.placeOnRandomTile(player, assets.tile`playerSpawn`);
+
+    // Hide the player spawn tile
+    tiles.setTileAt(player.tilemapLocation(), assets.tile`transparency16`);
+}
+
+function registerEvents () {
+    // Jump on A button press
+    controller.A.onEvent(ControllerButtonEvent.Pressed, () => {
+        // First make sure the player is on the ground
+        if (player.isHittingTile(CollisionDirection.Bottom)) {
+            doJump(player, JUMP_HEIGHT);
+        }
+    });
+    
+    // When the player overlaps lava, end the game
+    scene.onOverlapTile(PlayerKind, assets.tile`lava`, (sprite, location) => {
+        onPlayerDied();
+    });
+    
+    // When the player overlaps the treasure chest, win the game
+    scene.onOverlapTile(PlayerKind, assets.tile`treasureChest`, (sprite, location) => {
+        game.over(true);
+    });
+
+    // Handle player overlapping with an enemy
+    sprites.onOverlap(PlayerKind, EnemyKind, (sprite, otherSprite) => {
+        // Check to see if the player is jumping on the enemy
+        if (sprite.vy > 0 && sprite.bottom < otherSprite.top + 8) {
+            // Destroy the enemy and bounce the player
+            otherSprite.destroy();
+            doJump(sprite, BOUNCE_HEIGHT);
+        }
+        else {
+            // If the player isn't jumping on top of the enemy, take damage
+            onPlayerDied();
+        }
+    });
+
+    // Bounce enemies off of each other when they overlap
+    sprites.onOverlap(EnemyKind, EnemyKind, (sprite, otherSprite) => {
+        if (sprite.x < otherSprite.x) {
+            sprite.right = otherSprite.left;
+            sprite.vx = -ENEMY_SPEED;
+            otherSprite.vx = ENEMY_SPEED;
+        }
+        else {
+            otherSprite.right = sprite.left;
+            otherSprite.vx = -ENEMY_SPEED;
+            sprite.vx = ENEMY_SPEED;
+        }
+    });
+
+    // Also bounce enemies off of walls
+    scene.onHitWall(EnemyKind, (sprite, location) => {
+        if (sprite.isHittingTile(CollisionDirection.Left)) {
+            sprite.vx = ENEMY_SPEED;
+        }
+        else if (sprite.isHittingTile(CollisionDirection.Right)) {
+            sprite.vx = -ENEMY_SPEED;
+        }
+    });
+}
+
+function doJump (sprite: Sprite, height: number) {
+    sprite.vy = -Math.sqrt(2 * height * GRAVITY);
+}
+
+function onPlayerDied () {
+    game.reset();
+}

package/src/template/platformer/game/pxt.json

@@ -0,0 +1,21 @@
+{
+    "name": "platformer-game",
+    "description": "Platform game template with tilemap, enemies, and player",
+    "dependencies": {
+        "device": "*",
+        "color-coded-tilemap": "*"
+    },
+    "files": [
+        "main.ts",
+        "README.md",
+        "assets.json",
+        "images.g.jres",
+        "images.g.ts",
+        "tilemap.g.jres",
+        "tilemap.g.ts"
+    ],
+    "supportedTargets": [
+        "arcade"
+    ],
+    "preferredEditor": "tsprj"
+}

package/src/template/platformer/game/tilemap.g.jres

@@ -0,0 +1,71 @@
+{
+    "myTiles.transparency16": {
+        "id": "myTiles.transparency16",
+        "data": "hwQQABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true
+    },
+    "myTiles.tile1": {
+        "id": "myTiles.tile1",
+        "data": "hwQQABAAAADdHd0d3R3dHRER3R0REd0d3R3dHd0d3R3dHd0d3R3dHd0d3R3dHd0d3R0REd0dERHdHd0d3R3dHd0d3R3dHd0d3R3dHd0d3R0REd0dERHdHd0d3R3dHd0d3R3dHd0d3R3dHd0d3R3dHd0dERHdHRER3R3dHd0d3R3dHd0d3R3dHQ==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "brick"
+    },
+    "myTiles.tile2": {
+        "id": "myTiles.tile2",
+        "data": "hwQQABAAAAAAu7u7y7y7C7Du7u677M6760Tk7rvs7rtLRETuu+zuC0tERO677O4LS0RE7rvs7gtLRETuu8vuC0tERO7NvO4LS0RE7s287gtLRETuu8vuC0tERO677O4LS0RE7rvs7gtLRETuu+zuC+tE5O677O67sO7u7rvszrsAu7u7y7y7Cw==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "treasureChest"
+    },
+    "myTiles.tile3": {
+        "id": "myTiles.tile3",
+        "data": "hwQQABAAAABVJERCRVREREUiREJVVVVVJCIiVEVFVVUiJERVRCJURCJCVEQiQiJFIkRFJCIkJEUiVEUiJEIiRUJUJCIiIkJFREUkIiIiQkVCRSJEIiRCRUJFIkQiIlJFQlVEIiJCVCRCRVVFRFRVJERVRFVVVUQiVEREVEVVJEJVRCJCRVQkQg==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "lava"
+    },
+    "myTiles.tile4": {
+        "id": "myTiles.tile4",
+        "data": "hwQQABAAAAAAAAAAAAAAAAAAAAD7/w8AAAAAAN/d+wAAAAAA+//9AAAAAAAA8Pv/AM7M7/6/2/0A3jvb3bLdDwDevdPfLb0PAMDd3f0t3f0AAL/d3Svd/wAA393dK90PAMDd3f0t3Q8A3r3T3y3b/QDeO9vd+///AM7M7/4PAAAAAAAAAAAAAA==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "playerSpawn"
+    },
+    "myTiles.tile5": {
+        "id": "myTiles.tile5",
+        "data": "hwQQABAAAAAAAAAAAPD/AAAAAAAAwLEAAAD//w8f+wAA/929/B+xAPAbEd29H/sA8BERvRzM8Q8fERHxH73/Dx8REdER+///HxER0RGx//8fERHxH/v///AREb0czbEP8BsR3b0f+wAA/929/B+xAAAA//8PH/sAAAAAAADPsQAAAAAAAPD/AA==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "enemySpawn"
+    },
+    "level1": {
+        "id": "level1",
+        "data": "MTAyYTAwMDgwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDIwMDAwMDAwMDAwMDAwMDAwMDEwMTAwMDAwMTAxMDEwMDAwMDEwMTAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAxMDEwMTAwMDAwNDAwMDAwMDAxMDEwMTAwMDAwMDAwMDAwMDAwMDEwMTAxMDAwMDAwMDAwNTAwMDAwMDAxMDEwMDAwMDUwMDAwMDUwMDAwMDAwMTAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAzMDMwMzAzMDMwMzAzMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMTAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDIwMDIyMDIyMDAyMjAwMDAwMDAwMDAwMDAwMDAwMDAwMjAyMjAwMDAwMDIyMDIwMDAwMDAyMjAyMDAwMDAwMjAwMjAwMDAwMDAwMjIyMjIyMjIyMjIyMDIwMDAwMDAyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMg==",
+        "dataEncoding": "base64",
+        "namespace": "myTiles.",
+        "mimeType": "application/mkcd-tilemap",
+        "displayName": "level",
+        "tileset": [
+            "myTiles.transparency16",
+            "myTiles.tile1",
+            "myTiles.tile2",
+            "myTiles.tile3",
+            "myTiles.tile4",
+            "myTiles.tile5"
+        ]
+    }
+}

package/src/template/platformer/game/tilemap.g.ts

@@ -0,0 +1,197 @@
+// Auto-generated code. Do not edit.
+namespace myImages {
+
+    helpers._registerFactory("image", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+            case "myTiles.transparency16":return img`
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+`;
+            case "myTiles.tile1":
+            case "brick":return img`
+d 1 d d d d d d d 1 d d d d d d 
+d 1 d d d d d d d 1 d d d d d d 
+d 1 d d d d d d d 1 d d d d d d 
+1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
+d d d d d 1 d d d d d d d 1 d d 
+d d d d d 1 d d d d d d d 1 d d 
+d d d d d 1 d d d d d d d 1 d d 
+1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
+d 1 d d d d d d d 1 d d d d d d 
+d 1 d d d d d d d 1 d d d d d d 
+d 1 d d d d d d d 1 d d d d d d 
+1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
+d d d d d 1 d d d d d d d 1 d d 
+d d d d d 1 d d d d d d d 1 d d 
+d d d d d 1 d d d d d d d 1 d d 
+1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
+`;
+            case "myTiles.tile2":
+            case "treasureChest":return img`
+. . b b b b b b b b b b b b . . 
+. b e 4 4 4 4 4 4 4 4 4 4 e b . 
+b e 4 4 4 4 4 4 4 4 4 4 4 4 e b 
+b e 4 4 4 4 4 4 4 4 4 4 4 4 e b 
+b e 4 4 4 4 4 4 4 4 4 4 4 4 e b 
+b e e 4 4 4 4 4 4 4 4 4 4 e e b 
+b e e e e e e e e e e e e e e b 
+b e e e e e e e e e e e e e e b 
+b b b b b b b d d b b b b b b b 
+c b b b b b b c c b b b b b b c 
+c c c c c c b c c b c c c c c c 
+b e e e e e c b b c e e e e e b 
+b e e e e e e e e e e e e e e b 
+b c e e e e e e e e e e e e c b 
+b b b b b b b b b b b b b b b b 
+. b b . . . . . . . . . . b b . 
+`;
+            case "myTiles.tile3":
+            case "lava":return img`
+5 5 4 2 2 2 2 2 4 2 2 2 2 4 4 5 
+5 4 2 2 2 2 2 4 4 4 4 4 4 4 5 5 
+4 2 2 4 2 4 4 4 5 5 5 5 5 5 4 4 
+2 2 2 2 4 4 5 5 4 4 4 5 4 5 4 4 
+4 4 2 4 4 5 5 4 4 2 2 4 5 4 4 2 
+4 4 2 4 5 4 4 2 2 2 2 4 5 4 4 2 
+2 2 4 5 4 4 2 2 2 4 4 2 5 5 4 2 
+4 4 5 5 4 2 2 2 2 4 4 2 4 5 5 4 
+5 5 5 4 2 2 4 2 2 2 2 2 4 5 5 5 
+4 5 4 4 2 2 2 2 2 2 2 2 4 5 4 4 
+4 5 5 2 2 4 2 2 2 4 2 2 4 5 5 4 
+5 5 4 2 4 2 4 2 2 2 2 4 5 5 5 5 
+4 5 5 4 2 4 2 2 2 2 2 4 5 4 4 4 
+4 5 5 5 2 2 2 4 4 4 5 5 5 4 2 2 
+4 5 5 4 5 5 5 5 5 5 5 4 4 2 2 2 
+4 5 5 4 4 4 4 4 4 4 4 2 2 2 4 4 
+`;
+            case "myTiles.tile4":
+            case "playerSpawn":return img`
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . e e e . . . . e e e . 
+. . . . . c d d c . . c d d c . 
+. . . . . c b d d f f d d b c . 
+. . . . . c 3 b d b d d b 3 c . 
+. . . . . f b 3 d d d d 3 b f . 
+. . . . . e d d d d d d d d e . 
+. b f b . e d f d d d d f d e . 
+. f d f . f d d f d d f d d f . 
+. f d f . f 2 d d b b d d b f . 
+. f d f f b b 2 2 2 2 2 2 f . . 
+. f b d b b d d d d d d b f . . 
+. . f f f d d b d d d d d f . . 
+. . . . f d f f d f f f d f . . 
+. . . . f f . . f f . . f f . . 
+`;
+            case "myTiles.tile5":
+            case "enemySpawn":return img`
+. . . . . . f f f f . . . . . . 
+. . . . f f 1 1 1 1 f f . . . . 
+. . . f b 1 1 1 1 1 1 b f . . . 
+. . . f 1 1 1 1 1 1 1 1 f . . . 
+. . f d 1 1 1 1 1 1 1 1 d f . . 
+. . f d 1 1 1 1 1 1 1 1 d f . . 
+. . f d d d 1 1 1 1 d d d f . . 
+. . f b d b f d d f b d b f . . 
+. . f c d c f 1 1 f c d c f . . 
+. . . f b 1 1 1 1 1 1 b f . . . 
+. . f f f c d b 1 b d f f f f . 
+f c 1 1 1 c b f b f c 1 1 1 c f 
+f 1 b 1 b 1 f f f f 1 b 1 b 1 f 
+f b f b f f f f f f b f b f b f 
+. . . . . f f f f f f . . . . . 
+. . . . . . . f f f . . . . . . 
+`;
+        }
+        return null;
+    })
+
+    helpers._registerFactory("animation", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+    helpers._registerFactory("song", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+    helpers._registerFactory("json", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+
+        }
+        return null;
+    })
+
+}
+// Auto-generated code. Do not edit.
+
+// Auto-generated code. Do not edit.
+namespace myTiles {
+    //% fixedInstance jres blockIdentity=images._tile
+    export const transparency16 = image.ofBuffer(hex``);
+    //% fixedInstance jres blockIdentity=images._tile
+    export const tile1 = image.ofBuffer(hex``);
+    //% fixedInstance jres blockIdentity=images._tile
+    export const tile2 = image.ofBuffer(hex``);
+    //% fixedInstance jres blockIdentity=images._tile
+    export const tile3 = image.ofBuffer(hex``);
+    //% fixedInstance jres blockIdentity=images._tile
+    export const tile4 = image.ofBuffer(hex``);
+    //% fixedInstance jres blockIdentity=images._tile
+    export const tile5 = image.ofBuffer(hex``);
+
+    helpers._registerFactory("tilemap", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+            case "level":
+            case "level1":return tiles.createTilemap(hex`2a000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000101000001010100000101000000000000000000000000000000000000000000010101000004000000010101000000000000000101010000000005000000010100000500000500000001010101010101010101010101030303030303030101010101010101010101010101010101010101010101010101`, img`
+..........................................
+..........................................
+..........................................
+..........................................
+..........................................
+.......22..222..22.....................222
+......222.......222........22.........2222
+222222222.......22222222222222222222222222
+`, [myTiles.transparency16,myTiles.tile1,myTiles.tile2,myTiles.tile3,myTiles.tile4,myTiles.tile5], TileScale.Sixteen);
+        }
+        return null;
+    })
+
+    helpers._registerFactory("tile", function(name: string) {
+        switch(helpers.stringTrim(name)) {
+            case "transparency16":return myTiles.transparency16;
+            case "brick":
+            case "tile1":return myTiles.tile1;
+            case "treasureChest":
+            case "tile2":return myTiles.tile2;
+            case "lava":
+            case "tile3":return myTiles.tile3;
+            case "playerSpawn":
+            case "tile4":return myTiles.tile4;
+            case "enemySpawn":
+            case "tile5":return myTiles.tile5;
+        }
+        return null;
+    })
+
+}
+// Auto-generated code. Do not edit.

package/src/template/game/README.md

@@ -1,2 +0,0 @@
-# Arcade Game
-由 arcade-ai 脚手架生成。用 AI 修改 `main.ts`，`aca dev` 实时预览。