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.

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.

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.

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.

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.

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 haben je zehn Zeilen: eine Idee, die läuft.

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.

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.

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