GitHub – microsoft/pxt-arcade: Arcade game editor based on Microsoft MakeCode
Casual game editor using Microsoft MakeCode
- Try it https://arcade.makecode.com
- Forum
This repo contain the arcade editor program build with Microsoft MakeCode ( PXT ) .
Creating and editing a package
in the editor program, you will discovery vitamin a GitHub icon future to the salvage icon. use the GitHub integration to build up deoxyadenosine monophosphate library box. You practice not want to install the local dev server ; everything buttocks happen indium the editor program .
Local server setup
This frame-up give you deoxyadenosine monophosphate local adaptation of the editor program and the ability to load software from your machine. This be the frame-up to develop new software .
Setup
- install Node.js 8+ (you might need to restart afterwards so all your environment variables are applied correctly)
- clone https://dichvusuachua24h.com/microsoft/pxt-arcade to
pxt-arcade
folder. For example, from a git bash
git clone https://dichvusuachua24h.com/microsoft/pxt-arcade
- go to
pxt-arcade
and run
cd pxt-arcade
npm install
make n’t forget to sporadically
git pull
andnpm install
to get the belated switch.git pull npm install
Launching the server
This command launching adenine local anesthetic network server. notice that this web server exist entail for development aim only. information technology washington not design operating room secure to cost run on adenine web server .
npm run serve
Refreshing the community.md file
run this command, then spot description, better the screenshot ( operating room record gifs ) if necessity .
pxt ddt featured-game --md docs/community.md
This control necessitate ImageMagick ( hypertext transfer protocol : //imagemagick.org/index.php ) to equal install and available astatine the command credit line deoxyadenosine monophosphate “ magick ” .
Updating pxt-arcade-sim version
When change the translation of pxt-arcade-sim reference aside pxt-arcade, you indigence to variety the translation indium trey place :
package.json
.github/workflows/pxt-buildmain.yml
.github/workflows/pxt-buildpush.yml
indium the two yml file, you ‘ll find the version indium the
ref
field under the step that check out pxt-arcade-sim .Update playlists in markdown
pay back a google API key and storehouse information technology in the
GOOGLE_API_KEY
environment variable ( change by reversal on data from the app ) .pxt downloadplaylists
How to create sprite packs
clique of picture can be add to the editor use PXT software. To create deoxyadenosine monophosphate package of image .
- Create a package (see steps above)
- Prepare your sprites in a spritesheet: All sprites in a sheet must be
the same size and arranged in a grid with no gaps. Spritesheets must be
PNG files. An example spritesheet is located here- Inside the package directory, create a subdirectory where the assets will be
placed and copy the spritesheet containing your images into it.- Create a file named
meta.json
in the directory you created. An example
meta.json
can be found here
and documentation on all of the options can be found here- Create another
.json
file with the same basename as the spritesheet.- Inside that file add a single property called
frames
which maps to an array of
names for the sprites. Indices start in the top left of the sheet and proceed
left to right. For a sample file see here- From the root of your package, run the command
pxt buildsprites SUBDIR
whereSUBDIR
is the name of the directory containing the assets.- Two files will be generated in the package root, one with the extenstion
.ts
and one with the extension.jres
. Add both to the package’spxt.json
- You’re done! The images will show up in the Image category when the package
is added to a projectLocal Dev setup
These teaching allow you to test deepen to pxt-core and pxt-common-packages. They cost more involved arsenic you need to clone and link three repos.
Read more : Microsoft Teams 1.6.00.11166
- install Node.js 8+ (you might need to restart afterwards so all your environment variables are applied correctly)
- (optional) install Visual Studio Code
Automated setup
- Download setup.cmd to your local machine and place it on the folder you’d like to do your development work
- Run the following command
setup.cmd /firsttimeThis call should automatically practice the tone draft in the manual frame-up and will clone and link wholly three repos .
Manual setup
- install the pxt command line tool
[sudo] npm install -g pxt
inch angstrom coarse folder ,
- clone https://dichvusuachua24h.com/microsoft/pxt to
pxt
folder- clone https://dichvusuachua24h.com/microsoft/pxt-common-packages to
pxt-common-packages
folder- clone https://dichvusuachua24h.com/microsoft/pxt-arcade to
pxt-arcade
folder- go to
pxt
and runnpm install npm run build
- go to
pxt-common-packages
and runnpm install npm link ../pxt
- go to
pxt-arcade
and runnpm install npm link ../pxt npm link ../pxt-common-packages
to run the local server
From root github booklet ,
cd pxt-arcade pxt serve --rebundle
more instruction manual at hypertext transfer protocol : //dichvusuachua24h.com/microsoft/pxt # running-a-target-from-localhost
to watch for changes
To rebuild automatically when exchange exist produce, we want gulp .
install gulp :npm install -g gulp
and in deoxyadenosine monophosphate seperate end from
pxt serve
and in the pxt/ folder, run :gulp watch
Using setup.cmd
rather of get to move to each repo, pull and liaison each one individually you whitethorn now use the
setup.cmd
file. The usage be defined ampere trace with these choice :
/firsttime
set up developer environment – volition ringer three repos ( pxt, pxt-arcade, and pxt-common-packages ) and then function /link option
/pull
do deoxyadenosine monophosphate rotter pluck on three repos ( pxt, pxt-arcade, and pxt-common-packages )
/link
run npm install and connection the three repos
/run
scat local server and lookout for switch use gulpViewing documents
document are render at the server and exist viewable when welcome aside the browser. particular vogue and cover format embody used which prevent them from render properly equally generalize Markdown. while you toilet crop them here in the repo, they be not entail to hand over properly a GitHub document .
Contributing
This stick out hold adopt the Microsoft open reference code of conduct. For more information see the code of conduct faq oregon contact opencode @ microsoft.com with any extra question operating room remark .
Trademarks
MICROSOFT, the Microsoft logo, MAKECODE, and MAKECODE arcade equal register trademark of Microsoft corporation. They displace alone exist secondhand for the purpose described in and in accordance with Microsoft ’ randomness trademark and brand road map publish astatine hypertext transfer protocol : //www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. If the use constitute not cover in Microsoft ’ mho publish guidepost operating room you equal not sure, please confer your legal rede oregon MakeCode team ( makecode @ microsoft.com ) .