pxt arcade

Редактор повседневной игры с использованием Microsoft MakeCode

• Попробуйте это https://arcade.makecode.com
• Форум

Этот репо содержит аркадный редактор, построенный с Microsoft MakeCode (PXT).

Создание и редактирование пакета

В редакторе вы найдете значок GitHub рядом со значком сохранения. Используйте интеграцию GitHub, чтобы создать библиотечный пакет. Вам не нужно устанавливать локальный сервер Dev; Все может произойти в редакторе.

Локальная настройка сервера

Эта настройка дает вам локальную версию редактора и возможность загружать пакеты с вашей машины. Это установка для разработки новых пакетов.

Настраивать

• Установите node.js 8+ (вам может потребоваться перезапустить после этого, чтобы все переменные вашей среды применялись правильно)
• Clone https://github.com/microsoft/pxt-arcade в папку 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

Запуск сервера

Эта команда запускает локальный веб -сервер. Обратите внимание, что этот веб -сервер предназначен только для целей разработки. Он не был разработан и не защищен для запуска на веб -сервере.

 npm run serve

Освежает файл Community.md

Запустите эту команду, затем исправьте описание, улучшите скриншот (или запишите GIF), если это необходимо.

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

Эта команда требует, чтобы ImageMagick (https://imagemagick.org/index.php) был установлен и доступен в командной строке как «Магика».

Обновление версии PXT-ARCADE-SIM

При изменении версии PXT-ARCADE-SIM, на которую ссылается PXT-ARCADE, вам необходимо изменить версию в трех местах:

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

В двух файлах YML вы найдете версию в поле ref под шагом, который проверяет PXT-ARCADE-SIM.

Обновить плейлисты в Markdown

Получите ключ Google API и сохраните его в переменных среды GOOGLE_API_KEY (включите данные из приложения).

 pxt downloadplaylists

Как создать пакеты спрайта

Пакеты изображений могут быть добавлены в редактор с помощью PXT Packages. Чтобы создать пакет изображений.

1. Создайте пакет (см. Шаги выше)
2. Приготовьте свои спрайты в сприте -таблице: все спрайты в листе должны быть одинакового размера и расположены в сетке без пробелов. SpriteShests должны быть файлами PNG. Пример SpriteSheet расположен здесь
3. В каталоге пакетов создайте подкаталог, в которой будут размещены активы, и скопируйте лист SpriteShip, содержащую ваши изображения.
4. Создайте файл с именем meta.json в созданном вами каталоге. Пример meta.json можно найти здесь, и документация обо всех вариантах можно найти здесь
5. Создайте другой файл .json с тем же базовым названием, что и спритеасист.
6. Внутри этого файла добавьте одно свойство, называемое frames , которые отображают на массив имен для спрайтов. Индексы начинаются в левом верхнем левом листе и поступают влево направо. Для примера файла см. Здесь
7. Из корня вашего пакета запустите команду pxt buildsprites SUBDIR , где SUBDIR - это имя каталога, содержащего активы.
8. Два файла будут сгенерированы в корне пакета, один с расширением .ts и один с расширением .jres . Добавить оба в pxt.json пакета
9. Ты закончил! Изображения будут отображаться в категории изображений, когда пакет будет добавлен в проект

Локальная настройка разработки

Эти инструкции позволяют проверить изменения в PXT-Core и PXT-Common-Packages. Они более вовлечены, так как вам нужно клонировать и ссылки 3 репо.

• Установите node.js 8+ (вам может потребоваться перезапустить после этого, чтобы все переменные вашей среды применялись правильно)
• (необязательно) Установить код Visual Studio

Автоматизированная настройка

• Загрузите setup.cmd на локальную машину и поместите его в папку, которую вы хотели бы сделать
• Запустите следующую команду

setup.cmd /firsttime

Этот вызов должен автоматически выполнять шаги, изложенные в ручной настройке, клонирует и связывает все три репо.

Ручная установка

• Установите инструмент командной строки PXT

 [sudo] npm install -g pxt

В общей папке,

• клон https://github.com/microsoft/pxt в папку pxt
• Clone https://github.com/microsoft/pxt-common-packages в папку pxt-common-packages
• клон https://github.com/microsoft/pxt-arcade в папку 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-target-from-localhost

Чтобы следить за изменениями

Чтобы автоматически восстанавливать, когда внесены изменения, нам нужно глотать.

Установите Gulp:

 npm install -g gulp

и в отдельном терминале от pxt serve и в папке PXT/ PLOND: Запустите:

 gulp watch

Использование setup.cmd

Вместо того, чтобы перейти к каждому репо, потяните и свяжите каждый из них индивидуально, вы теперь можете использовать файл setup.cmd . Использование описано следующим образом с этими вариантами:
/firsttime устанавливает среду разработчика-будет клонировать 3 Repos (PXT, PXT-ARCADE и PXT-Common-Packages), а затем запустить /
/pull делает git pull на 3 репо (PXT, PXT-Arcade и PXT-Common-Packages)
/link запускает установку NPM и ссылается на 3 Repos
/run запускает локальный сервер и наблюдает за изменениями, используя Gulp

Просмотр документов

Документы отображаются на сервере и доступны для просмотра при получении браузера. Используются специальные стили и расширенное форматирование, которые мешают им правильно отображать в качестве обобщенной отметки. Хотя вы можете просматривать их здесь, в репо, они не предназначены для правильного отображения в качестве документа GitHub.

Внося

Этот проект принял код поведения с открытым исходным кодом Microsoft. Для получения дополнительной информации см. Кодекс поведения FAQ или свяжитесь с [email protected] с любыми дополнительными вопросами или комментариями.

Товарные знаки

Microsoft, Microsoft Logo, MakeCode и MakeCode Arcade являются зарегистрированными товарными знаками Microsoft Corporation. Они могут использоваться только для целей, описанных в и в соответствии с руководящими принципами Microsoft по товарному знаку и бренду, опубликованным по адресу https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Если использование не рассматривается в опубликованных руководящих принципах Microsoft или вы не уверены, обратитесь к своему юрисконсульту или команде MakeCode ([email protected]).