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:
- Es umbenennen, duplizieren oder in der Dateien-App verschieben
- Es in iCloud speichern und von mehreren Geräten darauf zugreifen
- Es per AirDrop, E-Mail oder jeder Dateifreigabe-Methode teilen
- Es sichern, indem du die Datei kopierst
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.
- Auf dem Mac öffnet Ablage › Ordner öffnen… einen Projektordner (einen Ordner mit einer
settings.pyxenprojdarin) dort, wo er liegt. Unter Windows zeigt die Startseite die Ordnerprojekte in Pyxens Ordner: Öffne eines von dort. - In Ordner umwandeln macht aus der geöffneten
.pyxenein Ordnerprojekt daneben; In .pyxen-Datei umwandeln macht aus einem Ordnerprojekt eine einzelne Datei. Beide stehen im Menü Ablage, im Menü, das sich mit einem Klick auf den Projektnamen in der Titelleiste öffnet, und im Menü eines Projekts in der Übersicht. Das Umgewandelte bleibt, wie es war; ist sein Name schon vergeben, heißt das neue „Cave Jump 2“. Ein Ordnerprojekt zeigt Ordner neben seinem Namen in der Titelleiste. - Sichern… fragt, wie ein neues Projekt aufbewahrt wird: Datei (.pyxen) oder Ordner.
- Pyxen schreibt deine Änderungen beim Arbeiten in die Dateien des Ordners. Auf dem Mac gilt: Ändert sich eine Datei außerhalb von Pyxen, erscheint die Änderung sofort in Pyxen; Widerrufen holt zurück, was vorher da war. Hast du dieselbe Datei auch in Pyxen geändert und sind diese Änderungen noch nicht geschrieben, fragt Pyxen, welche Version bleiben soll; die andere kommt in den Papierkorb. Unter Windows schreibt Pyxen nur die Dateien, die du geändert hast, und lässt eine außerhalb von Pyxen geänderte Datei, wie sie ist: Schließe das Projekt und öffne es erneut, um die Änderung zu sehen. Eine gelöschte Datei kommt in den Papierkorb.
- Ein Projektordner in iCloud Drive, dessen Dateien noch nicht auf diesem Mac sind, zeigt Wird geladen…; Pyxen fordert sie bei iCloud an und öffnet das Projekt, sobald alle da sind.
- Ein Ordnerprojekt zählt als ein Projekt, wie eine
.pyxen.
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:
- Bilder — PNG-Dateien für Sprites und Kachel-Sheets
- Sounds — WAV-Dateien für Soundeffekte
- Musik — OGG-Vorbis-, MIDI- und Tracker-Module (MOD, XM, IT, S3M) für Hintergrundmusik
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:
- Mit einem Bild des Projekts oder eines Packs nutzt die Karte es, wie es ist. Sonst wird nichts hinzugefügt.
- Mit Pyxens Kacheln fügt Erstellen auch
tiles.pngzum Projekt hinzu (tiles2.png, wenn der Name vergeben ist), und die Karte ist bereit zum Malen. Das Bild gehört dir, zum Neuzeichnen, und Widerrufen nimmt Karte und Kacheln in einem Schritt zurück.
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:
- Bewegung: Jump-‘n’-Run-Bewegung, Bewegung von oben, Rasterzüge, Abprallen
- Kampf: Leben und Schaden, Gegner, Schlag, Wellen
- Sammeln: Aufsammeln, Upgrades
- Oberfläche: Steuerung, Bildschirme, Punkte und Bestenliste, Timer, Dialogfenster, Stufenaufstieg, Partikelstoß
- Kamera: Kamera folgt
- Welt: Level aus Text, Bewegliche Plattformen, Scroller
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.