Szenarien

Szenarien sind die Spielwelten, die der Spieler im Menüsystem auswählen und starten kann. Über die einzelnen Komponenten kann der Szenarien-Designer von der Landschaft über Spielmodus und -regeln über benutzte Objekte, Materialien, die Landschaft, usw. bis hin zum Aussehen im Menüsystem alles frei einstellen.

Inhalt

Scenario.txt
Enthält die meisten Szenarioeinstellungen.
Script.c
Das Szenarioscript.
Map.bmp
Statische Landkarten werden um den in Scenario.txt enthaltenen Faktor MapZoom auf die tatsächliche Spiellandschaft vergrößert. Die in Map.bmp enthaltenen Farbindizes entsprechen den in TexMap.txt zugeordneten Materialien und Texturen.
MapFg.bmp / MapBg.bmp
Same as Map.bmp as defined above, except that foreground and background materials can be drawn separately. In Map.bmp, color indices greater than 127 will result in underground materials. In MapFg.bmp and MapBg.bmp, all color indices up to 255 can be used, and undergroup materials are simply specified by tunnel material in the background map.
Landscape.txt
Besonders fortgeschrittene Spieler können über diese Datei komplexe Zufallslandschaften definieren. Dafür sind allerdings mathematisches und logisches Verständnis sowie viel Geduld unumgänglich.
Map.c
Script for dynamic generation of map. See map script documentation.

Titel, Beschreibung und Bebilderung

Title.txt
Für sprachabhängige Titel sollte eine Title.txt erstellt werden die den Namen des Szenarios in verschiedenen Sprachen angibt:
DE:Angriff der Killerwipfe
US:Attack of the Killer Wipfs
Wichtig: Es sollten keine Anführungszeichen oder Sonderzeichen verwendet werden.
Title.png
Das Titelbild des Szenarios im Format PNG. Größe: 200x150 Pixel.
Icon.png
Das Icon des Szenarios im Format PNG. Größe 24x24 Pixel.
Desc__.txt
The description of the scenario. '__' must be replaced by the two digit language code, e.g. DE for German and US for American English. Multiple descriptions for several languages can be contained in a scenario file of which the game will automatically load the one appropriate for the configured language.
The first line of the file will be used as a heading.

Zusätzlicher Inhalt

ParameterDefs.txt
Contains custom scenario parameters that players can adjust like e.g. difficulty settings.
Teams.txt
Enthält Teameinstellungen für Mehrspielerszenarien.
*.ocd
Szenarien können lokale Objektdefinitionen enthalten, die dann nur im entsprechenden Szenario verfügbar sind.
Die Engine durchsucht auch alle übergeordneten Rundenordner (ocf) des Szenarios nach Objektdefinitionen. Dadurch kann ein Rundenordner Objektdefinitionen enthalten, die dann in allen untergeordneten Szenarien verfügbar sind.
Sound.ocg
Szenarien können beliebig viele lokale Sounds (*.ogg oder *.wav) enthalten. Diese können per Script während des Spiels abgespielt werden. Szenariolokale Sounds werden dynamisch und erst bei Bedarf geladen, was bei großen Szenariodateien zu Verzögerungen führen kann. Die Sounds sollten in einer lokalen Sound-Gruppe abgelegt werden.
Just like the global sound file, scenario local Sound.ocg groups may contain any subfolders with .ocg extension to define sound namespaces. For example, a file Sound.ocg/Animals.ocg/Growl.ogg can be played back using Sound("Animals::Growl").
Music.ocg
Wenn das Szenario lokale Musikdateien (*.ogg) enthält, werden diese während der Runde in zufälliger Reihenfolge abgespielt. Siehe auch Script-Funktion Music().
Material.ocg
Szenarien können lokale Materialdefinitionen enthalten. Es gelten die Überladungsregeln.
Graphics.ocg
Szenarien können einzelne Dateien in der globalen Graphics.ocg-Gruppe überladen oder auch neuen Inhalt wie ein Himmels-Hintergrundbild oder einen Loader hinzufügen. Himmelsgrafiken sollten kachelbar sein oder so groß dass sie selbst nicht gekachelt dargestellt werden wenn der Spieler weit herauszoomt. Loader sind Grafiken, die beim Starten der Runde angezeigt werden. Sind mehrere Dateien vorhanden (Loader1.png, Loader2.png, Loader3.png...), wird per Zufall eine ausgewählt, wobei über eine optional im Scenario.txt vorhandene Loader-Spezifikation die Auswahl noch weiter vorgegeben werden kann. Auch Grafiken aus einem übergeordneten Ordner werden geladen.
System.ocg
Scenarios can contain any number of script files (*.c). These can define or modify global functions, or append to loaded definitions. See overloading rules.
Names.txt
Diese Namen werden für während der Runde neu erzeugte Clonks verwendet.
Info.txt
Hier kann der Autor zusätzliche Informationen über den Entwicklungsstand seines Szenarios, seine Kontaktadresse oder sonstige Informationen angeben, die er anderen Entwicklern mitteilen möchte.

Zusätzliche Dateien von gespeicherten Runden oder Szenarios

MatMap.txt
Enthält die Anordnung der in diesem Szenario verwendeten Materialien. Die hier aufgeführten Materialien werden von der exakten Landkarte verwendet und müssen beim Start der Runde in der zu ladenden Datei Material.ocg vorhanden sein.
Game.txt
Diese Komponente wird von der Engine erzeugt und enthält die Laufzeitobjektdaten eines abgespeicherten Szenarios.
Objects.c
This component is generated by the engine if the game is stored as a scenario. Contains an InitializeObjects() function to recreate all objects placed during editing before. See Object saving.

Überladungsregeln

Diverse Systemkomponenten (Graphics, Loader, Material, Musik und Objekte) können in Szenarien überladen werden. Dabei werden auch übergeordnete Rundenordner (OCF) durchsucht. Hierbei steigt die Überladungspriorität mit der Ordnertiefe. Bei einem Szenario, das sich in die Ordnerstruktur Ordner.ocf\Unterordner.ocf\Szenario.ocs einordnet, würden Komponenten aus Unterordner.ocf also gleiche Komponenten aus Ordner.ocf überladen (respektive Szenario.ocf Komponenten aus Unterordner.ocf und Ordner.ocf).
Sven2, 2002-04
matthes, 2004-06
Marky, 2019-04