Die Drehbuchvorlageneinträge sind als Liste von scripttemplate-Kindelementen in das scripttemplates-Tag eingebettet.
<scripttemplates>
<scripttemplate product="1" licence_type="1" guid="scripttemplate-random-ron-foodformealtime01">
<title>
<de>${food} zum ${mealtime}</de>
<en>${food} for ${mealtime}</en>
</title>
<description>
<de>...</de>
<en>...</en>
</description>
<variables>
<food>
<de>Kinder|Liebe|Joghurt</de>
<en>Children|Love|Joghurt</en>
</food>
<mealtime>
<de>Frühstück|Mittagessen|Abendessen|Brunch</de>
<en>breakfast|lunch|dinner|brunch</en>
</mealtime>
</variables>
<jobs>
<job index="0" function="1" required="1" />
<job index="1" function="2" required="1" gender="2" />
<job index="2" function="2" required="1" gender="1" />
<!-- there might be up to 2 additional roles without further specifications -->
<job index="3" function="32" required="0" role_guid="script-roles-ron-001" />
<job index="4" function="32" required="0" />
</jobs>
<genres maingenre="15" subgenres="5" />
<blocks min="2" max="3" slope="30" />
<price min="12000" max="17000" slope="60" />
<potential min="50" max="70" slope="45" />
<outcome min="25" max="35" slope="40" />
<review min="45" max="65" slope="40" />
<speed min="35" max="65" slope="50" />
</scripttemplate>Hier soll ein Film (product) als Einzellizenz (licence_type) gedreht werden können; ein Liebesfilm (maingenre) von zwei oder drei Stunden (blocks), der aber auch komödiantische Anteile hat (subgenres).
Der Titel könnte "Liebe zum Abendessen" aber auch "Joghurt zum Frühstück" lauten (title mit Variablen).
Zwingend (required=1) werden ein Regisseur (job index 0), ein weiblicher und ein männlicher Hauptdarsteller benötigt (job index 1,2).
Es könnten aber auch noch zwei Nebendarsteller zum Drehen erforderlich sein; für einen der Nebendarsteller ist eine Filmrolle definiert (role_guid).
Der Preis (price) für das Drehbuch beträgt zwischen 12.000 (min) und 17.000 (max) mit leichter Tendenz zu einem höheren Preis (slope).
Die Bereiche für die Bewertung (Tempo etc.) sind am Ende des Eintrags definiert (durchschnittliche Kritikerbewertung und Tempo, schlechtes kommerzielles Ergebnis).
Aus dieser Vorlage wird vom Spiel dann das eigentliche Drehbuch mit konkreten Werten erzeugt, auf dessen Grundlage dann der Film gedreht werden kann.
Aus einer Vorlage können auch mehrere Drehbücher entstehen.
Wenn die Titel identisch sind, wird dieser um einen Zähler erweitert.
Der entscheidendste inhaltliche Unterschied zwischen Drehbuchvorlagen und "fertigen" Programmen ist die Verwendung von Variablen, um Varianz insb. im Titel zu erzeugen sowie die Definition der Besetzung. Anstatt die Personen anzugeben, die beim Dreh dabei waren, werden die Anforderungen an die Besetzung definiert. Auch werden die Bewertungskategorien (Tempo etc.) oft als Bereich angegeben.
| Name | Art | Beschreibung |
|---|---|---|
| guid | Pflicht | GUID |
| product | Pflicht | Programmtyp |
| licence_type | Pflicht | Lizenztyp |
| index | optional | Reihenfolge bei Serien |
| creator | Metadaten optional | Standardeigenschaft |
| created_by | Metadaten optional | Standardeigenschaft |
| comment | informativ | Standardeigenschaft |
Standardelemente für Titel title und Beschreibung description sind sindvollerweise zu definieren. Häufig werden auch Variablen variables für Titel und Beschreibung eingesetzt. Um die Verfügbarkeit des fertigen Drehbuchs einzuschränken, kann das availability-Element verwendet werden.
(In einer früheren Version der Dokumentation wurde fälschlicherweise beschrieben, dass die Zielgruppen analog Programmen im groups-Knoten definiert werden können.
TVTower hat diesen Knoten allerdings zu keinem Zeitpunkt ausgelesen.
Die Zielgruppen können im data-Knoten angegeben werden.)
Im Knoten genres können ein Hauptgenre (Pflicht) und optional Untergenres (kommasepariert) definiert werden.
Mögliche Werte sind die Genres, die auch für Programme genutzt werden.
Beispiele:
<genres maingenre="4" />Krimi<genres maingenre="13" subgenres="2"/>Monumentalfilm mit Actionelementen<genres maingenre="7" subgenres="5,15"/>komödiantisches Liebesdrama
Im Hauptknoten jobs kann eine Liste von Stellen (job) definiert werden, die für den Dreh besetzt werden müssen.
Folgende Eigenschaften sind pro job definierbar.
| Name | Art | Beschreibung |
|---|---|---|
| index | Pflicht | Reihenfolge in der Liste |
| function | Pflicht | Job |
| required | Pflicht | Wahrheitswert; muss diese Stelle besetzt werden |
| gender | optional | Geschlecht |
| country | optional | Land |
| role_guid | optional | GUID der Rolle die hier besetzt wird |
| random_role | optional | Wahrheitswert |
| person | optional | GUID/Variable vordefinierte Besetzung |
Beispiele:
<job index="0" function="1" required="1" />- Regisseur muss besetzt werden, Geschlecht nicht spezifiziert<job index="1" function="2" gender="2" required="1" />- weibliche Hauptdarstellerin muss besetzt werden<job index="2" function="16" gender="1" required="0" />- männlicher Gast könnte im fertigen Drehbuch dabei sein oder auch nicht
In Titel und Beschreibung kann auf Besetzungsrollen verwiesen werden (z.B. ${.self:"role":1:"firstname"}).
Falls mit role_guid eine feste Rolle definiert ist, werden die entsprechenden Namen verwendet.
Mit dem Flag random_role="1" sichergestellt, dass für jedes Drehbuch konsistent eine neue Rolle erzeugt wird.
Insbesondere bei Serien wird empfohlen, das Flag explizit zu setzen, wenn eine Rollenreferenz verwendet wird.
Die Attribute gender und country werden dann für das Würfeln des Namens herangezogen.
<job index="1" function="2" gender="1" country="it" required="1" />- bei Referenz auf die Rolle wird ein männlicher italienischer Name erzeugt<job index="2" function="2" country="us" required="1" random_role = "1" />- für jedes Dreahbuch wird eine neue Rolle mit einem US-amerikansichen Name erzeugt, das Geschlecht ist nicht festgelegt
Ab Version 0.8.4 kann durch die Datenbank eine Besetzung vordefiniert werden.
Dazu wird im Attribut person die GUID einer Person oder eine Variable, die zu einer GUID aufgelöst wird, angegeben.
Im Supermarkt wird die entsprechende Person dann angezeigt und kann nicht geändert werden.
Damit können z.B. Filme eines bestimmten Regisseurs oder Shows mit einem bestimmten Gastgeber umgesetzt werden (X's Dracula, Die Late-Night-Show mit Y).
| Name | Art | Beschreibung |
|---|---|---|
| flags | optional | definitiv verwendete Programmflags |
| flags_optional | optional | zufällig verwendete Programmflags |
| scriptflags | optional | Flags für diese Vorlage (ScriptFlags siehe unten) |
| production_licence_flags | optional | Lizenzflags |
| production_broadcast_flags | optional | Ausstrahlungsflags |
| production_broadcast_limit | optional | wie oft darf die Sendung ausgestrahlt werden |
| production_limit | optional | wieviele Folgen können produziert werden (z.B. Show ohne spezifizierte Folgen) |
| live_date | optional | Zeit der Ausstrahlung für Livesendungen |
| broadcast_time_slot_start | optional | Frühester Start des ersen Blocks |
| broadcast_time_slot_end | optional | Spätestes Ende des letzten Blocks |
| available | optional | Wahrheitswert - ist die Drehuchvorlage initial verfügbar |
| target_groups | optional | definitiv verwendete Zielgruppe |
| target_groups_optional | optional | möglicherweise verwendete Zielgruppe |
Hier dürften flags und flags_optional sowie target_groups und target_groups_optional für den Einfluss auf das Endergebnis am wichtigsten sein.
Produziert man eine Livesendung, sollte live_date definiert werden oder das Flag "immer live" gesetzt werden.
Definiert man bei Serien flags_optional im Haupteintrag, werden bei der eigentlichen Drehbucherstellung diese Flags einmal ermittelt und dann für alle Serienfolgen verwendet.
Bei einem optionalen Live-Flag sind dann also immer alle Folgen live oder keine.
Natürlich kann man flags_optional auch im data-Knoten eines Einzelfolge (innerhalb von children) definieren.
Der Zufallswert dieser Flags wird dann nur für diese Folge verwendet.
Damit kann man z.B. erreichen, dass nur eine Folge möglicherweise FSK-18 ist und nicht gleich die gesamte Serie.
Ab Version 0.8.2 kann eine Drehuchvorlage initial als nicht verfügbar markiert werden (available="0").
Die Aktivierung erfolgt dann durch einen Effekt (modifyScriptAvailability siehe Effekte), z.B. durch das Erscheinen einer Nachricht oder der Ausstrahlung eines Programms.
Anwendungsfall für dieses Flag wäre z.B. die Definition des Drehbuchs für eine Fortsetzung/Folgestaffel, wobei zunächst das Original ausgestrahlt werden muss.
Für einige Eigenschaften kann ein fester Wert oder ein Bereich für zufällige Ermittlung definiert werden.
Der grundsätzliche Aufbau ist für feste Werte <eigenschaft value="Wert" /> und für Zufallswerte <eigenschaft min="MinWert" max="MaxWert" slope="SlopeWert" />, wobei slope optional ist und der Zufallsverteilung zwischen minimalem und maximalem Wert steuert.
Für die folgenden Eigenschaften ist eine solche Definition möglich.
| Name | Beschreibung |
|---|---|
| blocks | Länge des Programms in Stunden |
| price | Preis des Drehbuchs |
| potential | Potential des Drehbuchs |
| speed | Tempo |
| review | Kritikermeinung |
| outcome | kommerzieller Erfolg |
| studio_size | Größe des benötigten Studios |
| production_time | Basisdrehzeit in Minuten |
| episodes | Anzahl der Folgen bei Serien |
Beispiele:
<blocks value="3" />- das Programm soll dann genau 3 Blöcke (Stunden) lang sein<speed min="20" max="50" />- das Programm soll ein Tempo zwischen 20 und 50 haben<price min="10000" max="20000" slope="20" />- der Preis soll zwischen 10.000 und 20.000 liegen aber zu billiger tendieren
episodes kann in zwei verschiedenen, sich ausschließenden Varianten verwendet werden.
Eine Definition in der Hauptdrehbuchvorlage schränkt die Anzahl der Folgen ein.
Man definiert also z.B. 20 mögliche Kindvorlagen und sagt aber, dass nur 5 bis 8 zu einer Serie gehören sollen.
Die Reihenfolge der Folgen wird beibehalten.
Die erste Vorlage wird standardmäßig immer mit ausgewählt (=Pilotfolge, die immer dabei sein soll - siehe z.B. scripttemplate-ron-visiting in der Datenbank).
Wenn auch die erste Folge zu den zufällig gewählten gehören soll, kann man diese als optional markieren (<episodes min="0" /> für diese Folge).
Der zweite Anwendungsfall ist die Definition von episodes in einer oder mehrerer Kindvorlagen, ohne dass die Folgenzahl in der Hauptdrehbuchvorlage angegeben wird.
Bei der Erstellung des eigentlichen Drehbuchs werden aus der Kindvorlage dann entsprechend viele Folgen (auch 0 ist erlaubt).
Wenn also nicht immer alle der definierten Folgen erzeugt werden sollen, hat man zwei Möglichkeiten: Einschränkung der Gesamtanzahl im Hauptknoten oder Folgen, die weggelassen werden können, mit <episodes min="0" max="1" /> konfigurieren.
Ab Version 0.7.4 können in Drehbuchvorlagen Modifier für das erstellte Programm hinterlegt werden. Im Gegensatz zu den Zufallswerten sind hier keine Bereichsdefinitionen möglich sondern ausschließlich feste Werte.
<programme_data_modifiers>
<!-- erholt sich nach einer Ausstrahlung langsamer als normal -->
<modifier name="topicality::refresh" value="0.5" />
<!-- billiger als normal -->
<modifier name="price" value="0.7" />
</programme_data_modifiers>Die möglichen Modifier sind in den Programmen zu finden.
Ab Version 0.8.1 kann auch für Drehbuchvorlagen die Zielgruppenattraktivität definiert werden. Sie wird unverändert an die entstehenden Programmdaten weitergegeben.
Siehe Standardkindelement.
Im Hauptknoten children kann eine Liste Vorlagen für Folgen ( wieder als scripttemplate-Knoten) definiert werden. Bei diesen muss dann die Eigenschaft index definiert werden.
Ab Version 0.8.2 werden auch für Drehbuchvorlagen Effekte unterstützt.
Die Syntax ist analog zu den Effekten in den Nachrichten (Effekte).
Die definierten Effekte werden an die fertige Produktion weitergegeben.
Insofern werden dieselben Trigger wir für Programme unterstützt (broadcast, broadcastDone, broadcastFirstTime, broadcastFirstTimeDone).
Der typische Anwendungsfall für einen Drehbuchvorlageneffekt dürfte das Freischalten weiterer Vorlagen sein (Staffel zwei zu einer gerade produzierten ersten Staffel).
<effects>
<effect trigger="broadcastFirstTime" type="modifyScriptAvailability" guid="ronny-scripttemplate-seriesX-season2" />
</effects>
| ScriptFlags | Bedeutung |
|---|---|
| 1 | kann gehandelt werden |
| 2 | automatischer Verkauf wenn Produktionslimit erreicht ist |
| 4 | automatische Entfernung wenn Produktionslimit erreicht ist |
| 8 | Produktionslimit wird bei Rückgabe zurückgesetzt |
| 16 | bei Rückgabe werden die Werte für Tempo etc. zufällig verändert |
| 32 | nach Rückgabe kann die Vorlage nicht wieder erworben werden |
(Quellcode: TVTScriptFlag)
<scripttemplate product="3" licence_type="1" guid="scripttemplate-ron-morningshow">
<title>
<de>Goldene Morgenstunden</de>
</title>
<description>
<de>Aufgewacht ...</de>
</description>
<jobs>
<job index="0" function="1" required="1" />
<job index="1" function="8" required="1" />
<job index="2" function="8" required="0" />
<job index="3" function="16" required="0" />
</jobs>
<genres maingenre="103" subgenres="9" />
<blocks value="3" />
<price min="3000" max="5000" slope="60" />
<potential min="40" max="60" slope="45" />
<outcome min="30" max="50" slope="40" />
<review min="40" max="50" slope="40" />
<speed min="45" max="60" slope="50" />
<!-- live whenever first broadcastd -->
<!-- licence flags: 4 + 32 (REMOVE_ON_REACHING_BROADCASTLIMIT + LICENCEPOOL_REMOVES_TRADEABILITY) -->
<data flags="1" broadcast_time_slot_start="5" broadcast_time_slot_end="10" production_limit="4" production_broadcast_limit="1" production_broadcast_flags="512" production_licence_flags="36" />
<targetgroupattractivity unemployed_male="0.1" managers="2" />
</scripttemplate>Der interessante Teil an dieser Show (product) ist der data-Knoten.
Es handelt sich im eine Liveshow (flags), deren Ausstrahlung zwischen 5 Uhr und 10 Uhr stattfinden muss (broadcast_time_slot_X), frühestens am Folgetag (live_date), in diesem Zeitraum aber immer live ist (production_broadcast_flags).
Es können vier Sendungen (production_limit) produziert werden (ohne explizite Definition von children!), aber es darf dann je Sendung nur eine Ausstrahlung geben (production_broadcast_limit).
Danach verschwindet die Show und ist nie wieder verfügbar (production_licence_flags).
Männliche Arbeitslose finden diese Show furchtbar, Manager sind begeistert.
<scripttemplate product="2" licence_type="3" guid="TheRob-script-ser-dram-TVTintern">
<title>
<de>TVTs: ${object} im Hochhaus</de>
<en>TVTs: ${object} In A Skyscraper</en>
</title>
<description>
<de>Serie über ${object} im TV Tower Hochhaus</de>
<en>Series about ${object} In The TV Tower Skyscraper</en>
</description>
<children>
<scripttemplate index="0" product="2" licence_type="2" guid="TheRob-script-ser-dram-TVTintern-Ep1">
<title>
<de>TVTs Pilot</de>
<en>TVTs Pilot</en>
</title>
<blocks min="2" max="4" />
</scripttemplate>
...
<scripttemplate index="2" product="2" licence_type="2" guid="TheRob-script-ser-dram-TVTintern-Ep3">
<title>
<de>${attribute} macht eine Party</de>
<en>${attribute} Invites To the Party</en>
</title>
</scripttemplate>
...
</children>
<variables>
<attribute>
<de>Die FR Duban|Die VR Duban</de>
<en>The FR Duban|The VR Duban</en>
</attribute>
<object>
<de>Intrigen|Hinterhalte|Wettkämpfe|...</de>
<en>Intrigues|Ambushes|Competitions|...</en>
</object>
</variables>
<jobs>
<job index="0" function="1" required="1" />
<job index="1" function="2" required="1" gender="2" />
...
<job index="5" function="32" required="0" />
...
</jobs>
<data flags="8" flags_optional="50" />
<genres maingenre="7" subgenres="9" />
<episodes min="9" max="12" />
<blocks value="1" />
<price min="95000" max="99000" />
<potential min="50" max="90" slope="45" />
<outcome min="75" max="95" slope="40" />
<review min="45" max="85" slope="55" />
<speed min="35" max="85" slope="50" />
</scripttemplate>Diese Serie (product und licence_type im Hauptelement) hat mehrere Folgen (children mit anderem licence_type!).
Es ist eine Dramaserie, kann aber als Untergenre auch eine Familienserie sein.
Es ist eine Kultserie (flags), kann aber auch B-Movie/Trash/Animation sein (flags_optional).
Die Folgen können abweichende Attribute definieren (blocks im Pilotfilm).
Ansonsten erben sie die Daten des Hauptknotens.
(Eine Sonderstellung nimmt hier flags_optional ein.
Hier erbt die Folge nicht welche Flags optional sein können, sondern tatsächlich den final ermittelten zufälligen Flag-Wert.
Damit soll erreicht werden, dass die Serie konsistent ist - alle Folgen live oder Trash.
Möchte man unterschiedliche Werte für die Folgen erreichen, definiert man flags_optional für die Einzelfolgen.)
Die Folgen können unterschiedliche Besetzungen haben (job reqired="0").
Mit einem Preis von 95.000-99.000 pro Folge ist das Drehbuch nicht gerade preiswert, dafür liegen die Bewertungen auch vergleichsweise hoch.
Aus den vorhandenen Kindvorlagen (children) werden 9 bis 12 für das Drehbuch ausgewählt, wobei die erste Folge immer dabei ist (episodes).
TODO
- im Code werden in script-data noch
keywords,live_time,production_time_modeingelesen; (nicht in DB verwendet, noch nicht in Grammatik) - episodes-Anzahl auswerten (Serie ohne children definieren und Episodenanzahl angeben)