Projekte & Assets

Pyxen verwendet ein einfaches dateibasiertes Projektmodell: Deine Projekte sind Dateien auf deinem Gerät. Ein Konto ist optional, und nichts braucht eines.

Das .pyxen-Format

Ein Pyxen-Projekt ist eine .pyxen-Datei. Es ist ein ZIP-Archiv, das deinen Code, Bilder und Sounds enthält. Du kannst:

Weil es ein Standard-ZIP ist, könntest du es sogar auf einem Computer entpacken, um den Inhalt zu inspizieren.

Ein Projekt merkt sich, welches Pyxen es gesichert hat. Ein Projekt aus einem neueren Pyxen lässt sich trotzdem öffnen und starten; beim ersten Öffnen sagt Pyxen einmal, dass das, was die neuere Version hinzugefügt hat, bis zum Update vielleicht nicht angezeigt wird oder nicht funktioniert. Nichts wird abgelehnt.

Wo deine Projekte sind

Pyxen bewahrt die Projekte, die du speicherst, in seinem Ordner auf: iCloud Drive › Pyxen, wenn iCloud Drive für Pyxen eingeschaltet ist, sonst in Pyxens eigenem Ordner auf dem Gerät (Auf meinem Mac › Pyxen auf dem Mac, Auf meinem iPad › Pyxen in der Dateien-App auf dem iPad). Einstellungen › Allgemein › Projekte zeigt, welcher es ist, und Im Finder zeigen (auf dem iPad In Dateien zeigen) öffnet ihn.

Unter Windows bewahrt Pyxen sie in Dokumente › Pyxen auf: Einstellungen › Allgemein › Projekte zeigt es, und Im Datei-Explorer zeigen öffnet den Ordner.

Für das geöffnete Projekt klickst oder tippst du auf seinen Namen in der Titelleiste und wählst Im Finder zeigen (In Dateien zeigen auf dem iPad), oder du wählst Datei › Im Finder zeigen (⌥⌘R). Auf der Startseite steht es im Menü eines Projekts. Die Dateien-App kann keine Datei auswählen, darum öffnet sie auf dem iPad den Ordner, in dem das Projekt liegt. Ein noch nicht gespeichertes Projekt liegt in keinem Ordner: Sein Menü bietet stattdessen Speichern… an.

Unter Windows heißt es Im Datei-Explorer zeigen, an denselben Stellen, oder Datei › Im Datei-Explorer zeigen (Strg+Alt+R).

Ein Projekt, das du woanders gespeichert oder geöffnet hast, bleibt, wo es ist: Pyxen zeigt es unter Weiter und verschiebt es nie. Solange du Pyxen ausprobierst, zählen die Projekte in seinem Ordner.

Ordnerprojekte

Auf dem Mac und unter Windows kann ein Projekt auch ein Ordner mit einfachen Dateien sein statt einer einzelnen .pyxen-Datei: dieselben Dateien, die eine .pyxen enthält, nebeneinander, damit ein Texteditor, git oder eine KI-App direkt mit ihnen arbeiten kann.

Pyxen 26.6 und älter sowie Pyxen auf dem iPad öffnen nur .pyxen-Dateien: Wandle ein Ordnerprojekt für sie oder zum Teilen in eine .pyxen-Datei um.

Assets hinzufügen

Dein Projekt kann enthalten:

Die README.md eines Projekts und ihre Übersetzungen wie README.de.md sind eine einzige Zeile Bitte lesen oben in Dateien, über Skripte. Sie öffnet die Seite in deiner Sprache. Ihr Menü hat die anderen Sprachen (In anderer Sprache öffnen) und Als Text bearbeiten, das die Datei selbst öffnet.

Füge Assets mit Datei › Bilder oder Sounds importieren… hinzu, oder erstelle eines mit Datei › Neues Asset… (dem + in Dateien). Einmal hinzugefügt, referenzierst du sie im Code nach Namen:

Sprite("hero")       # referenziert ein Bild namens "hero"
Sound("jump")        # referenziert einen Sound namens "jump"
Music("overworld")   # referenziert einen Musik-Track namens "overworld"

Eine neue Tilemap

In Datei › Neues Asset… fragt Tilemap, mit welchen Kacheln die Karte bemalt wird. Sie zeigt die Bilder des Projekts, jedes mit der Zahl der Kacheln, die es ergibt, dann die Bilder der Asset-Packs, die das Projekt nutzt, unter dem Namen jedes Packs, und zuletzt Pyxens Kacheln: Boden, Mauern, Fliesen, eine Tür, ein Ziel, Hügel, Wolken, Büsche und eine Kiste, 40 Kacheln zu 16 Pixeln in der Palette des Projekts.

Eine neue Karte beginnt mit den Kacheln, die eine andere Karte des Projekts nutzt, sonst mit einem Bild, dessen Name „tiles“ enthält, sonst mit Pyxens Kacheln. Tileset nennt die Wahl, und die Zeile darunter sagt, was Erstellen tut:

Zellengröße folgt der Wahl, und du kannst sie weiterhin ändern. Karteneinstellungen › Tileset verknüpft die Karte später mit einem anderen Bild.

Pyxens Kacheln werden im Grafikstil des Projekts gezeichnet. Projekteinstellungen › Grafik › Stil ändern… zeichnet tiles.png neu, solange du es nicht geändert hast, und lässt es danach, wie es ist.

Asset-Packs

Pyxen enthält Asset-Packs — Sammlungen von Bildern, Sounds und Kacheln, die du in deinen Projekten verwenden kannst. Asset-Packs verwenden das .pyxenpack-Format (ebenfalls ein ZIP-Archiv).

Einige Packs sind in der App enthalten. Die anderen werden geladen, wenn du sie auswählst: Ihre Karte zeigt Laden und die Größe des Packs, und ein Projekt, das ein Pack nutzt, das auf diesem Gerät noch fehlt, bietet den Download in seiner Dateiliste an. Klappt der Download nicht (etwa offline), sagt Pyxen das, und dein Projekt bleibt, wie es war. Neue Packs können ohne ein Update von Pyxen erscheinen: Pyxen prüft die Liste der Packs beim Start und wenn du Asset-Packs öffnest, und offline zeigt es die zuletzt gesehene Liste.

Die Seite jedes Packs nennt, wer es gemacht hat und wie du es nutzen darfst. Die meisten Packs sind gemeinfrei (CC0): Nutze sie frei, auch in exportierten Spielen. Ein Pack mit Nennung erforderlich verlangt, dass dein Spiel den Urheber nennt. Beim Export schreibt Pyxen die Nennungen aller Packs, die das Spiel nutzt, in licenses.txt und CREDITS.txt; Credit kopieren auf der Seite gibt dir die Zeile für alles Weitere.

Die Dateien eines Packs teilen sich alle Projekte, die es verwenden, deshalb öffnen sie sich schreibgeschützt, mit einer Leiste, die sagt, wem sie gehören. Um eine zu ändern, wähle Kopie bearbeiten in dieser Leiste oder im Menü der Datei in Dateien (Zeichnen darauf öffnet dasselbe Fenster): Die Datei oder der gewählte Frame gehört dann deinem Projekt, und der Code, der sie nennt, verwendet die Kopie, in einem Schritt, den Widerrufen zurücknimmt. Die Kopie behält ihre Nennung. Projekteinstellungen › Credits listet alles in deinem Spiel, was jemand anderes gemacht hat, zeigt Geändert, sobald du eine Kopie änderst, und bewahrt deinen eigenen Dank; CREDITS.txt ansehen zeigt, was ein Export schreibt.

Mechaniken

Mechaniken sind fertige Spielbausteine in Pyxen Script: Plattformer-Bewegung, Leben und Schaden, Dinge zum Einsammeln, ein Punktestand, eine Kamera, die der Spielfigur folgt, und mehr. Öffne sie über Projekteinstellungen › Mechaniken, über Mechaniken… im Menü ⋯ oder mit dem + der Gruppe Mechaniken in Dateien.

Dort sind sie danach geordnet, was sie tun:

Level aus Text baut ein Level aus Zeilen von Buchstaben in deinem Code oder aus einer im Tilemap-Editor gemalten Karte, auf der es jedes Ding an seinem Namen findet.

Jede Mechanik hat eine Seite. Ihre Testszene läuft dort als Demo: Klicke darauf, um sie mit den Tasten zu spielen, und drücke Esc, um die Tasten zurückzugeben. Die Regler ihrer Einstellungen ändern die Demo, während du ziehst, und speichern nichts. So geht’s zeigt die Zeilen, die du schreibst, Code die ganze Datei und Was sie bietet ihre Funktionen, wie die Vervollständigung sie zeigt.

Zum Projekt hinzufügen kopiert die Datei der Mechanik in dein Projekt, ihre Kommentare in deiner Sprache, mit jeder Mechanik, die sie braucht (der Knopf nennt sie). Das ist ein Schritt: Widerrufen nimmt alles zurück. Die Datei gehört dir, zum Lesen und Ändern. Dateien listet sie unter Mechaniken mit ihrer Version und zeigt Geändert, sobald du sie bearbeitest. Entfernen… fragt zuerst und nennt die Mechaniken, die sie brauchen.

Die Einstellungen einer Mechanik sind Zahlen in ihrer Datei, etwa JUMP: tune(2, 16) = 11. Projekteinstellungen › Mechaniken zeigt sie als Regler, ebenso der Tab Mechaniken im Inspektor, während das Spiel läuft: Ziehst du einen, ändert sich das laufende Spiel sofort; lässt du los, wird die Zahl in die Datei geschrieben, ein Schritt für Widerrufen. Alles zurücksetzen stellt die Zahlen einer Mechanik zurück. Ist Automatisch ausführen aus, führt die Engine die Mechanik nicht mehr für dich aus, und die Seite zeigt die Zeile, mit der du sie in deinem update() aufrufst. Auch deine eigenen Skripte können Einstellungen haben: Schreib NAME: tune(1, 10) = 5 # was es tut, dann erscheinen sie unter dem Namen der Datei.

Findet eine Mechanik etwas Falsches daran, wie sie aufgerufen wird, zeigt sich der Fehler an deiner Zeile, in den Worten der Mechanik, mit ihrer eigenen Zeile darunter.

Beispielspiele

Pyxen bringt fertige Spiele mit, mit ihrem ganzen Code und ihren Assets: echte, spielbare Spiele, die du studieren, ändern und von denen du lernen kannst. Du findest sie auf Pyxens Startseite unter Spielen und lesen. Sie öffnen sich, ohne gespeichert zu werden, du kannst also alles ändern; speichere eines, um deine Änderungen zu behalten.

Die Snippets der Startseite sind kurz: je eine Idee, die läuft, meist in zehn Zeilen. Drei sind kleine, ganze Programme zum Auseinandernehmen: Pong, Game of Life und Particles.

Unter einem Beispiel, das aus einem Starter gewachsen ist, steht Ein ähnliches Spiel machen: Es öffnet „Neues Projekt“ mit diesem Starter ausgewählt. Bei Crownwood ist es der Starter Adventure, beim Platformer der Starter Platformer. Solange du noch kein Projekt hast, zeigt „Weiter“ die Starter, die sich als erstes Spiel eignen.

Platformer ist die fertige Form des Platformer-Starters: fünf Level, im Tilemap-Editor gemalt, je eine Idee. Spring Meadow hat Federn, Sky Bridge bewegliche Plattformen, Locked Tower einen Schlüssel und eine Tür, Slime Caves Schleime zum Zerquetschen und drei Herzen, und The Belfry eine große Fledermaus, auf die man dreimal stampft.

Dungeon Survivors sind zehn Minuten im Moonlit Cellar: Gegner kommen in Wellen von allen Seiten, deine Waffen zielen von selbst, und jeder Aufstieg bietet eine Wahl aus drei. Seine fünf Waffen stehen in weapons.py, je eine Funktion, zum Lesen und Ändern. Big Slimes hinterlassen Truhen: Eine lässt eine Waffe sich weiterentwickeln, wenn sie auf Stufe 8 ist und du ihr Passiv behältst. Nach zehn Minuten kommt der Slime King; besiege ihn, und die Nacht ist gewonnen.

Crownwood ist ein Abenteuer mit Schwert über sechs Bildschirme aus Wiese, Wald und Wasser: Finde das Schwert im Dorf, schlag dir einen Weg durch die Büsche, lies die Schilder und folge der Krone nach Osten. Die Kamera gleitet von Bildschirm zu Bildschirm, und das Spiel wird jedes Mal gespeichert, wenn du einen betrittst. Seine Oberwelt ist im Tilemap-Editor gemalt, der Held, die Gegner und die Herzen auf ihrer Ebene Dinge platziert. Im Ostwald führt eine Höhle hinab in den Schleimkeller, sechs Räume: ein Gitterraum, dessen Gitter sich schließen, bis sein letzter Schleim fort ist, ein Schlüssel und eine verschlossene Tür, die Bomben (X, oder der Bomben-Knopf auf einem Touchscreen), die rissige Wände und rissige Felsen für immer öffnen, und der Riesenschleim, dessen Lebenskraft der Balken unten ist; besiegt, lässt er einen Herzcontainer zurück. Auch der Keller ist im Tilemap-Editor gemalt.

Dateien und iCloud

Pyxen verwendet das übliche Dokumentmodell von iPadOS und macOS. Projekte erscheinen auf dem iPad in Dateien und auf dem Mac im Finder, neben deinen anderen Dokumenten. Wenn iCloud aktiviert ist, werden deine Projekte automatisch synchronisiert. Unter Windows sind Projekte Dateien im Datei-Explorer, wie deine anderen Dokumente.

Ein Konto ist optional, und Pyxen sammelt keine Telemetrie. Deine Dateien bleiben, wo du sie ablegst.