Skip to content

Extensions_de

Jump to bottom
Gabriel Thullen edited this page Jul 29, 2026 · 1 revision

Erweiterungen

Startseite | 3D-Ansicht | Vollständige Aktionsreferenz

Eine Erweiterung ist ein eigenständiges Zusatzmodul, das PyGameMaker um Fähigkeiten erweitert, ohne den Kern-Engine zu verändern. Eine Erweiterung kann beisteuern:

  • neue Aktionen (sie erscheinen im Aktionsauswahldialog wie jede eingebaute Aktion),
  • eine neue Art, einen Raum zu zeichnen (ein benutzerdefinierter Renderer), und
  • den passenden Export-Code, sodass Spiele, die sie nutzen, weiterhin nach HTML5 und Kivy/Android exportieren.

Die eingebaute 2.5D-Raycast-Erweiterung (die Funktion 3D-Ansicht) ist das ausgearbeitete Beispiel: Sie fügt vier „3D-Ansicht"-Aktionen und einen First-Person-Renderer hinzu und exportiert in alle drei Ziele.

Aktivieren und deaktivieren

Erweiterungen werden aktiviert ausgeliefert. Sie können eine abschalten (oder eine deaktiviert ausgelieferte aktivieren), ohne Code zu bearbeiten, über den Schlüssel extensions in Ihrer Konfiguration — eine Zuordnung Ordnername → an/aus:

"extensions": { "raycast_2_5d": false }

Ein fehlender Eintrag bedeutet „Standardwert der Erweiterung verwenden", sodass nie etwas verschwindet, weil ein Schlüssel fehlte. Änderungen werden beim nächsten Start wirksam (Aktionen registrieren sich beim Start).

Bei deaktivierter 2.5D-Raycast-Erweiterung stellt ein Raum, der die First-Person-Ansicht aktiviert, einfach die Draufsicht dar.

Wenn ein Projekt eine Erweiterung benötigt

Da eine Erweiterung abgeschaltet werden kann, hilft Ihnen PyGameMaker, böse Überraschungen zu vermeiden:

  • Beim Laden: Nutzt ein Projekt Aktionen aus einer derzeit deaktivierten Erweiterung, zeigt die IDE eine Warnung, die die Erweiterung und die betroffenen Funktionen benennt (damit ein 3D-Spiel nicht stillschweigend als Draufsicht erscheint).
  • Beim Speichern vermerkt das Projekt die Erweiterungen, von denen seine Aktionen abhängen, in project.json (eine Liste requires_extensions) — ein dauerhafter Hinweis, den jeder sehen kann, mit dem Sie das Projekt teilen. Ein Projekt, das keine Erweiterungsaktionen nutzt, lässt das Feld einfach weg.

Erweiterungen und Plugins

Beide fügen Aktionen hinzu; sie unterscheiden sich nur in der Verpackung:

Plugin Erweiterung
Form eine einzelne .py-Datei in plugins/ ein Ordner in extensions/ mit einem Manifest
Ideal für eine kleine Menge von Aktionen eine Funktion über mehrere Dateien und/oder mit Zeichnen/Export
Beispiel die Audio-Aktionen (plugins/audio_actions.py) 2.5D-Raycast (extensions/raycast_2_5d/)

Wie ein Erweiterungsordner aussieht

Für Neugierige (und für jeden, der eine schreibt) ist eine Erweiterung ein lesbarer Ordner:

extensions/raycast_2_5d/
├── extension.json     # Manifest: Name, Version, aktiviert, provides_actions
├── actions.py         # die Aktionsschemas (im Auswahldialog angezeigt)
├── handlers.py        # was die Aktionen zur Laufzeit tun
├── renderer.py        # der benutzerdefinierte Raum-Renderer (der Raycaster)
├── state.py           # der Zustand pro Raum (unter dem Raum abgelegt)
├── hud.py             # die Geometrie-Generatoren für Minikarte / DOOM-Leiste
├── export_html5.js    # der HTML5-Port, in den Web-Export injiziert
├── export_kivy.py     # der Kivy-Port, in den Mobil-/Desktop-Export injiziert
└── README.md          # wie alles zusammenpasst

Die Liste provides_actions im Manifest ist das, was der IDE erlaubt, die genaue Erweiterung zu benennen, wenn ein Projekt eine deaktivierte benötigt.

Siehe auch

Clone this wiki locally