pxt arcade

Casual Game -Editor mit Microsoft MakeCode

• Probieren Sie es aus https://arcade.makecode.com
• Forum

Dieses Repo enthält den Arcade -Editor, der mit Microsoft MakeCode (PXT) erstellt wurde.

Erstellen und Bearbeiten eines Pakets

Im Editor finden Sie ein GitHub -Symbol neben dem Speichernsymbol. Verwenden Sie die GitHub -Integration, um ein Bibliothekspaket zu erstellen. Sie müssen den lokalen Entwicklerserver nicht installieren. Alles kann im Herausgeber passieren.

Lokales Server -Setup

Mit diesem Setup erhalten Sie eine lokale Version des Editors und die Möglichkeit, Pakete von Ihrem Computer auszuladen. Dies ist das Setup, um neue Pakete zu entwickeln.

Aufstellen

• Installieren Sie Node.js 8+ (Sie müssen möglicherweise anschließend neu gestartet werden, damit alle Ihre Umgebungsvariablen korrekt angewendet werden)
• Clone https://github.com/microsoft/pxt-arcade zum pxt-arcade ordner. Zum Beispiel aus einer Git -Bash

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

• Gehen Sie zu pxt-arcade und rennen Sie

 cd pxt-arcade
npm install

Vergessen Sie nicht, dass git pull und npm install um die neuesten Änderungen zu erhalten.

 git pull
npm install

Starten des Servers

Dieser Befehl startet einen lokalen Webserver. Beachten Sie, dass dieser Webserver nur für Entwicklungszwecke gedacht ist. Es wurde nicht so konzipiert oder gesichert, um auf einem Webserver ausgeführt zu werden.

 npm run serve

Aktualisieren der Community.md -Datei

Führen Sie diesen Befehl aus, dann beschreiben Sie die Beschreibung, verbessern Sie den Screenshot (oder zeichnen Sie GIFs) bei Bedarf.

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

Dieser Befehl erfordert Imagemagick (https://imagemagick.org/index.php), um in der Befehlszeile als "Magie" zu installieren und verfügbar zu werden.

Aktualisieren von PXT-Arcade-SIM-Version

Wenn Sie die Version von PXT-Arcade-SIM von PXT-Arcade ändern, müssen Sie die Version an drei Stellen ändern:

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

In den beiden YML-Dateien finden Sie die Version im ref -Feld unter dem Schritt, der PXT-Arcade-SIM überprüft.

Aktualisieren Sie die Wiedergabelisten in Markdown

Holen Sie sich einen Google -API -Schlüssel und speichern Sie ihn in den Umgebungsvariablen GOOGLE_API_KEY (Daten aus der App einschalten).

 pxt downloadplaylists

So erstellen Sie Sprite -Packs

Packungen von Bildern können mithilfe von PXT -Paketen dem Editor hinzugefügt werden. So erstellen Sie ein Paket von Bildern.

1. Erstellen Sie ein Paket (siehe Schritte oben)
2. Bereiten Sie Ihre Sprites in einem Spritesheet vor: Alle Sprites in einem Blatt müssen gleich groß sein und in einem Raster ohne Lücken angeordnet sind. Spriteshets müssen PNG -Dateien sein. Ein Beispiel -Spritscher befindet sich hier
3. Erstellen Sie im Paketverzeichnis ein Unterverzeichnis, in dem die Vermögenswerte platziert werden, und kopieren Sie das Spritscher, das Ihre Bilder in sie enthält.
4. Erstellen Sie eine Datei namens meta.json im von Ihnen erstellten Verzeichnis. Ein Beispiel für meta.json finden Sie hier und Dokumentation zu allen Optionen finden Sie hier
5. Erstellen Sie eine andere .json -Datei mit dem gleichen Grundnamen wie das Spritscher.
6. In dieser Datei fügen Sie eine einzelne Eigenschaft namens frames hinzu, die einem Array von Namen für die Sprites kartiert. Indizes beginnen oben links im Blatt und gehen von links nach rechts. Für eine Beispieldatei siehe hier
7. Führen Sie aus der Wurzel Ihres Pakets den Befehl pxt buildsprites SUBDIR aus, wobei SUBDIR der Name des Verzeichnisses mit den Vermögenswerten ist.
8. Zwei Dateien werden im Paketroot generiert, einer mit der Erweiterung .ts und einer mit der Erweiterung .jres . Fügen Sie beide zum pxt.json des Pakets hinzu
9. Du bist fertig! Die Bilder werden in der Bildkategorie angezeigt, wenn das Paket zu einem Projekt hinzugefügt wird

Lokales Entwickler -Setup

Mit diesen Anweisungen können Sie Änderungen an PXT-CORE und PXT-COMMON-PAGES testen. Sie sind mehr involviert, da Sie 3 Repos klonen und verknüpfen müssen.

• Installieren Sie Node.js 8+ (Sie müssen möglicherweise anschließend neu gestartet werden, damit alle Ihre Umgebungsvariablen korrekt angewendet werden)
• (Optional) Installieren Sie den Visual Studio -Code

Automatisiertes Setup

• Laden Sie Setup.cmd auf Ihren lokalen Computer herunter und platzieren Sie ihn in den Ordner, den Sie Ihre Entwicklungsarbeit erledigen möchten
• Führen Sie den folgenden Befehl aus

setup.cmd /firsttime

Dieser Anruf sollte automatisch die im manuellen Setup beschriebenen Schritte ausführen und alle drei Repos klonen und verknüpfen.

Handbuch Setup

• Installieren Sie das PXT -Befehlszeilenwerkzeug

 [sudo] npm install -g pxt

In einem gemeinsamen Ordner,

• Klone https://github.com/microsoft/pxt zum pxt -Ordner
• Klone https://github.com/microsoft/pxt-common-packages zum pxt-common-packages order
• Clone https://github.com/microsoft/pxt-arcade zum pxt-arcade Ordner
• Gehen Sie zu pxt und rennen Sie

 npm install
npm run build

• Gehen Sie zu pxt-common-packages und laufen Sie aus

 npm install
npm link ../pxt

• Gehen Sie zu pxt-arcade und rennen Sie

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

Um den lokalen Server auszuführen

Aus dem Ordner root github,,

 cd pxt-arcade
pxt serve --rebundle

Weitere Anweisungen unter https://github.com/microsoft/pxt#running-a-target-from-localHost

nach Änderungen achten

Um automatisch wieder aufzubauen, wenn Änderungen vorgenommen werden, brauchen wir Schlupf.

Gulp installieren:

 npm install -g gulp

und in einem separaten Terminal vom pxt serve und im PXT/ Ordner rennen Sie:

 gulp watch

Mit setup.cmd

Anstatt zu jedem Repo gehen zu müssen, ziehen Sie sie einzeln und verknüpfen Sie sie einzeln. Sie können jetzt die Datei setup.cmd verwenden. Die Verwendung wird wie folgt mit diesen Optionen umrissen:
/firsttime Einrichtung der Entwicklerumgebung-Will Clone 3 Repos (PXT, PXT-Arcade und PXT-Common-Packages) und dann die Option für Ausführen /Link ausführen
/pull macht einen Git-Zug auf 3 Repos (PXT, PXT-Arcade und PXT-Common-Packages)
/link wird NPM -Installation ausgeführt und die 3 Repos verknüpft
/run reitet einen lokalen Server und Uhren nach Änderungen mit Gulp

Dokumente anzeigen

Dokumente werden auf dem Server gerendert und sind im Empfang vom Browser angezeigt. Es werden spezielle Stile und erweiterte Formatierungen verwendet, die verhindern, dass sie als generalisiertes Markdown ordnungsgemäß gerendert werden. Während Sie sie hier im Repo durchsuchen können, sollen sie nicht als Github -Dokument richtig rendern.

Beitragen

Dieses Projekt hat den Microsoft Open Source -Verhaltenscode übernommen. Weitere Informationen finden Sie im FAQ oder wenden Sie sich an [email protected] mit zusätzlichen Fragen oder Kommentaren.

Marken

Microsoft, Microsoft Logo, MakeCode und MakeCode Arcade sind eingetragene Marken der Microsoft Corporation. Sie können nur für die in und gemäß den Microsoft-Marken- und Markenrichtlinien beschriebenen Zwecke verwendet werden, die unter https://www.microsoft.com/en-us/legal/intellektuelleproperty/trademarks/usage/general.aspx veröffentlicht wurden. Wenn die Verwendung nicht in den veröffentlichten Richtlinien von Microsoft behandelt wird oder Sie sich nicht sicher sind, wenden Sie sich bitte an Ihr Rechtsberater oder Ihr Makecode -Team ([email protected]).