# Cauldron 2026 — Halloween Edition — Projekt / Project / Projet

## Deutsch

Das ZIP enthält das komplette **Halloween 2026-Projekt**, die DSK, den ausführbaren Editor als JAR und seine Java-Quellen. Ohne historische Builds oder Testdateien.

### Spiel kompilieren

- Windows: `Build.bat` (Python 3 erforderlich).
- macOS/Linux: `sh Build.sh` (Python 3 und C-Compiler erforderlich). macOS: Command Line Tools über `xcode-select --install`; Debian/Ubuntu: Python 3 und build-essential.
- Ergebnis: `disk/Cauldron_2026.dsk`. Start auf dem CPC mit `RUN"DISC"`.
- Der native RASM wird beim ersten Unix-Build aus `tools/rasm_src` erzeugt. Die Spielquellen brauchen keine externen Cruncher. RASM: MIT-Lizenz, Edouard Berge; Lizenz liegt bei.

### Editor

- Start Windows: `Start_Editor.bat`.
- Start macOS/Linux: `sh Start_Editor.sh`.
- Oder: `java -jar CauldronGraphicsEditor.jar "/pfad/zum/projekt"`.
- Start erfordert Java 8 oder neuer. Neukompilieren erfordert ein JDK 8 oder neuer: `graphics_editor/build_editor.bat` oder `sh graphics_editor/build_editor.sh`.
- Der Editor bearbeitet Enhanced-Grafik und Karten; Titel und Musik werden ebenfalls unterstützt. Classic dient als Referenz. **Save and build game** baut das ausgewählte Projekt und erhält die Halloween 2026-Routinen, die Beschleunigung und das abgestimmte Tempo.
- Vorschau für Räume und das komplette Spiel wird aus dem Halloween 2026-Code in einem temporären Verzeichnis gebaut. Auf macOS/Linux benötigt die erste Vorschau ebenfalls einen C-Compiler für RASM. Der integrierte JEMU läuft in Java.
- Backups liegen unter `graphics_editor/backups`; die erste Ausgangskopie der editierbaren Daten unter `restore_data` wird beim Öffnen angelegt.
- **Save and export HTML** benötigt zusätzlich Node.js (empfohlen: 18 oder neuer) und Python 3. Der Export enthält die JAMSI-Kerne und den neu gebauten Spielcode. Alle Dateien gemeinsam auf einen Webserver laden; lokal per HTTP testen.
- Details: `graphics_editor/README.md`. Spielanleitung: `Anleitung.md`. Änderungen seit 1985: `Changelog.md`.

Windows-Build und Halloween 2026-Vorschau werden hier geprüft. Ein echter macOS-/Linux-Lauf ist auf dem Windows-Entwicklungsrechner nicht möglich; die Unix-Skripte und die plattformabhängigen Aufrufe werden separat geprüft.

## English

The ZIP contains the complete **Halloween 2026 project**, DSK, executable editor JAR and Java sources. Historical builds and test files are excluded.

### Build the game

- Windows: `Build.bat` (Python 3).
- macOS/Linux: `sh Build.sh` (Python 3 and a C compiler). On macOS install Command Line Tools with `xcode-select --install`; on Debian/Ubuntu install Python 3 and build-essential.
- Output: `disk/Cauldron_2026.dsk`. Type `RUN"DISC"` on the CPC.
- Unix builds compile native RASM from `tools/rasm_src` on first use. No external crunchers are required by the game sources. RASM is MIT-licensed by Edouard Berge; the licence is included.

### Editor

- Windows: `Start_Editor.bat`; macOS/Linux: `sh Start_Editor.sh`.
- Alternatively: `java -jar CauldronGraphicsEditor.jar "/path/to/project"`.
- Running requires Java 8 or later. Rebuilding requires a JDK 8 or later: `graphics_editor/build_editor.bat` or `sh graphics_editor/build_editor.sh`.
- The editor changes Enhanced graphics and maps; title and music editing are supported. Classic is the reference. **Save and build game** compiles the selected project while preserving Halloween 2026 rendering, acceleration and the tuned game pace.
- Room and full-game previews are assembled from Halloween 2026 sources in a temporary directory. The first macOS/Linux preview also needs a C compiler for RASM. The embedded JEMU runs in Java.
- Backups are in `graphics_editor/backups`; the initial editable-data baseline in `restore_data` is created when opening the project.
- **Save and export HTML** additionally requires Node.js (18 or newer recommended) and Python 3. Exports include JAMSI cores and newly built game data. Upload all exported files together and test locally over HTTP.
- Details: `graphics_editor/README.md`. Instructions: `Anleitung.md`. Changes since 1985: `Changelog.md`.

Windows builds and Halloween 2026 previews are checked here. A real macOS/Linux run is not available on this Windows development machine; Unix scripts and platform selection are checked separately.

## Français

Le ZIP contient le projet **Halloween 2026 complet**, le DSK, l’éditeur JAR exécutable et ses sources Java. Les anciennes compilations et les fichiers de test sont exclus.

### Compiler le jeu

- Windows : `Build.bat` (Python 3).
- macOS/Linux : `sh Build.sh` (Python 3 et compilateur C). Sur macOS : Command Line Tools avec `xcode-select --install` ; sur Debian/Ubuntu : Python 3 et build-essential.
- Résultat : `disk/Cauldron_2026.dsk`. Saisir `RUN"DISC"` sur le CPC.
- RASM natif est compilé depuis `tools/rasm_src` au premier lancement Unix. Les sources du jeu n’utilisent pas de compresseur externe. RASM est sous licence MIT par Edouard Berge ; licence incluse.

### Éditeur

- Windows : `Start_Editor.bat` ; macOS/Linux : `sh Start_Editor.sh`.
- Autre possibilité : `java -jar CauldronGraphicsEditor.jar "/chemin/du/projet"`.
- Java 8 ou plus récent pour lancer. JDK 8 ou plus récent pour recompiler : `graphics_editor/build_editor.bat` ou `sh graphics_editor/build_editor.sh`.
- L’éditeur modifie les graphismes et cartes Enhanced ; titre et musique sont aussi éditables. Classic sert de référence. **Save and build game** compile le projet choisi en conservant les routines Halloween 2026, l’accélération et le rythme ajusté.
- Les aperçus des salles et du jeu complet sont assemblés depuis les sources Halloween 2026 dans un dossier temporaire. Le premier aperçu macOS/Linux nécessite aussi un compilateur C pour RASM. JEMU intégré fonctionne en Java.
- Backups : `graphics_editor/backups`. L’état initial des données éditables est enregistré dans `restore_data` lors de l’ouverture.
- **Save and export HTML** nécessite également Node.js (18 ou plus récent conseillé) et Python 3. L’export inclut JAMSI et le code du jeu nouvellement compilé. Charger tous les fichiers ensemble sur le serveur ; tester localement par HTTP.
- Détails : `graphics_editor/README.md`. Manuel : `Anleitung.md`. Nouveautés depuis 1985 : `Changelog.md`.

Les compilations Windows et les aperçus Halloween 2026 sont vérifiés ici. Aucun environnement macOS/Linux réel n’est disponible sur ce PC Windows ; les scripts Unix et les choix de plateforme sont vérifiés séparément.