Astéroric › Handbuch

Astéroric — Handbuch

Studienklon von Asteroids für den Oric-1 48K · EUPL-1.2-Lizenz. Dieses Handbuch führt vom Download zum Spiel und dann zum Bauen aus den Quellen. Funktionen und Technik stehen auf der Seite Funktionen.

Inhalt

1. Herunterladen und starten
2. Die Tasten
3. Der CONTROLS-Bildschirm
4. IJK-Joystick
5. Das Spiel
6. Aus den Quellen bauen
7. Kompatibilität
8. Lizenz und Rechte

1. Herunterladen und starten

Öffnen Sie das neueste GitHub-Release und nehmen Sie asteroric.tap aus den Assets. Dieselbe Datei ist in dist/asteroric.tap versioniert — verwenden Sie in der GitHub-Oberfläche die Schaltfläche Raw / Download, nicht den Link der HTML-Seite (Sie bekämen HTML).
Laden Sie sie auf einem Oric-1 48K (BASIC-1.0-ROM), echt oder emuliert. Die .tap trägt das Autorun-Flag: HIRES-Modus und Spiel starten beim Laden, kein CLOAD oder CALL eintippen.
Der Jingle erklingt, der Titelbildschirm erscheint mit seiner Demo. SPACE startet ein Spiel, K öffnet die Tastenkonfiguration.

Erscheint ILLEGAL QUANTITY ERROR nach einem CALL 1280, wurde der Befehl nach der Autoausführung eingetippt: das Programm ist bereits gelaufen. Laden Sie die .tap einfach neu.

Unter Phosphoric

Laden Sie im Emulator Phosphoric, als Oric-1 mit dem ROM basic10.rom, asteroric.tap mit dem Schnellladen. Aus den Quellen erledigt make run alles; make run-joy leitet die Pfeiltasten und RCTRL/RALT auf den emulierten IJK-Joystick.

2. Die Tasten

Standardbelegung (Pfeiltasten + SPACE). Alle Tasten werden direkt in der Tastaturmatrix gelesen, am ROM vorbei.

Taste	Aktion
←	nach links drehen
→	nach rechts drehen
↑	Schub (thrust)
↓	Hyperraum — zufällige Teleportation, 25 % Todesrisiko
SPACE	Feuer (Dauerfeuer bei Halten); im Titelbildschirm: starten; bei Game Over: erneut spielen
K	im Titelbildschirm: Tastenkonfiguration
ESC	bei Game Over: zurück zu BASIC; in CONTROLS: abbrechen

3. Der CONTROLS-Bildschirm

Die fünf Aktionen neu belegen

Drücken Sie im Titelbildschirm K. Die Aktionen LEFT, RIGHT, THRUST, FIRE, HYPER werden der Reihe nach unterstrichen: drücken Sie die gewünschte Taste, um sie zuzuweisen. Eine bereits belegte Taste oder eine nicht dokumentierte Matrixposition wird abgelehnt (das Spiel erfindet keine Tastennamen). Ein Schussgeräusch bestätigt jede Zuweisung.

Abbrechen

ESC bricht die Eingabe ab und stellt die vorherige Belegung wieder her. Die Belegung lebt im RAM: nach dem Neuladen gelten wieder die Standardtasten. ESC und der Joystick sind nicht neu belegbar.

4. IJK-Joystick

Unterstütztes Interface

Das IJK-Joystick-Interface — das verbreitetste am Oric — wird am Druckerport angeschlossen. Astéroric liest es direkt (VIA-Port A, PB4-Strobe) und erkennt seine Anwesenheit: ohne Interface wird nichts gelesen. Links/rechts drehen, oben gibt Schub, unten geht in den Hyperraum, der Knopf feuert. Tastatur und Joystick sind gleichzeitig aktiv.

Validierung

Das Protokoll wurde nach der Rückmeldung eines Testers an einem physischen Interface neu geschrieben (die erste Version bildete ein ungenaues Emulatormodell nach) und gegen Oricutron validiert; Phosphoric wurde parallel korrigiert.

5. Das Spiel

Ziel

Die Asteroiden zerstören, ohne getroffen zu werden. Ein großer Asteroid zerfällt in drei, jedes Bruchstück wieder in zwei kleinere Größen. Die nächste, größere Welle beginnt, sobald der Bildschirm leer ist.

Untertassen

Die große Untertasse schießt zufällig; die kleine zielt auf das Schiff, mit einer Genauigkeit, die mit dem Punktestand steigt, und wird ab 35.000 Punkten die einzige. Am Wellenende kehrt sie schneller zurück.

Punktestand und Leben

7-Segment-Ziffern oben am Bildschirm, Lebenssymbole (höchstens vier angezeigt), „WAVE n“. Extraleben alle 10.000 Punkte, bis 60.000. Nach dem Tod erscheint das Schiff kurz unverwundbar wieder.

Game Over

Explosion, „GAME OVER“, dann die Tabelle der fünf besten Ergebnisse der Sitzung. Nach 5 s spielt SPACE erneut und ESC kehrt zu BASIC zurück (sauberer Rücksprung über den RESET-Vektor).

6. Aus den Quellen bauen

git clone https://github.com/benedictemarty/oric-asteroids.git
cd oric-asteroids
make            # build/asteroric.tap
make run        # startet unter Phosphoric
make check      # Aufnahme == bitgenaue Referenz
make host-test  # x86-Host-Tests

Voraussetzungen: cc65 ≥ 2.19, Python 3, Phosphoric installiert (Pfad im Makefile). make gen_ship und make gen_shapes erzeugen die Eckpunkttabellen neu; make bench profiliert 25 Millionen Zyklen; make clean räumt auf.

7. Kompatibilität

Maschine	Stand
Echter Oric-1 48K (BASIC 1.0)	läuft — 50-Hz-Video mit einem RGB2HDMI validiert, IJK validiert
Oric-1 unter Phosphoric	nominal (Entwicklungsemulator des Projekts)
Oric-1 unter Oricutron	funktionsfähig
Oric Atmos (BASIC 1.1), echt oder emuliert	läuft nicht — Kompatibilität noch offen

8. Lizenz und Rechte

Originalcode: EUPL 1.2

Darstellungs-Engine, Eingabe, Sound-Engine und nachgebildete Effekte, die Oric-Anpassung der Spielschleife, HUD, Titelbildschirm, Build, Tests und Dokumentation stehen unter der European Union Public Licence v1.2.

Von Atari abgeleitete Elemente: nicht erfasst

Die Spiellogik (Zustandsautomat, Physik, Zerfall, Untertassen-KI, Pseudozufallsgenerator, Punktetabelle) ist aus der Disassemblierung des Arcade-ROM rev 4 adaptiert, die Vektorformen stammen aus den ROM-Daten. An diesen Elementen werden keine Rechte beansprucht (Asteroids, © 1979 Atari, Inc.; Marke von Atari Interactive, Inc.). Nichtkommerzielles Studien- und Bewahrungsprojekt, weder mit Atari verbunden noch von Atari gebilligt — daher der Titel Astéroric. Details: NOTICE.md im Repository.

← Astéroric · Funktionen →