Variablen

Variablen speichern Informationen darüber, was in deiner Geschichte passiert ist und was der Spieler getan hat. Sie ermöglichen es dem Spiel, Entscheidungen zu merken, Fortschritt zu verfolgen, zu steuern, wie die Welt reagiert, und optional wichtige dem Spieler sichtbare Werte anzuzeigen.

Variablen sind die Grundlage der Logik in Talescape. Sie werden häufig verwendet, um Dialogoptionen zu steuern, Ereignisse auszulösen, Gegenstände freizuschalten oder zu bestimmen, welche Szenen verfügbar werden.

Variablen können zur gesamten Story, zu einem Kapitel oder zu einer einzelnen Szene gehören. Das hält lokalen Zustand nah an der Stelle, an der er genutzt wird, und erlaubt gleichzeitig, wichtige Werte überall verfügbar zu lassen.

Variablen werden im Variables panel erstellt. Jede Variable enthält die folgenden Einstellungen:

• Name: Ein beschreibendes Label zur Identifikation der Variable im Editor.
• Type: Bestimmt, welche Art von Wert die Variable speichert.
• Scope: Legt fest, ob die Variable zur Story, zu einem Kapitel oder zu einer Szene gehört.
• Starting Value: Der Wert, der beim Start der Geschichte zugewiesen wird.
• Stat Settings (optional): Legt fest, ob die Variable dem Spieler als sichtbarer Stat angezeigt werden soll.

Der Startwert ist optional. Wird kein Wert angegeben, startet die Variable leer oder mit ihrem Standardwert.

Der Scope einer Variable bestimmt, wo die Variable gehört und wo sie normalerweise verwendet werden sollte.

• Story: Verwende das für Werte, die für die gesamte Story wichtig sind, wie Gesundheit, Verstand, Zuneigung oder eine große Entscheidung, die spätere Kapitel beeinflusst.
• Chapter: Verwende das für Werte, die nur innerhalb eines Kapitels relevant sind, wie die Anzahl der in diesem Kapitel gesammelten Dokumente.
• Scene: Verwende das für lokalen Zustand innerhalb einer Szene, wie ob ein Fernseher eingeschaltet ist.

Story-Variablen entsprechen dem bisherigen Verhalten. Kapitel- und Szenenvariablen machen große Projekte leichter lesbar, weil temporäre Schalter nicht mehr neben dem Kern-Story-Zustand stehen müssen.

Choice variables speichern einen einfachen true- oder false-Wert. Sie werden für Ja-/Nein-Entscheidungen verwendet und sind die am häufigsten genutzte Variable.

Typische Verwendungszwecke sind:

• Verfolgen, ob der Spieler eine bestimmte Aktion ausgeführt hat.
• Aufzeichnen von Entscheidungen in Dialogen.
• Freischalten von Ereignissen oder Dialogoptionen.

Beispiele:

• Hat der Spieler die Truhe geöffnet?
• Hat der Spieler dem Fischer geholfen?
• Wird der Höhleneingang bewacht?

Choice-Variablen können über Actions oder Events zwischen true und false umgeschaltet werden.

Number variables speichern numerische Werte. Sie sind nützlich, wenn du Zählungen, Punktestände oder Fortschrittswerte verfolgen musst.

Typische Verwendungszwecke sind:

• Verfolgen gesammelter Ressourcen
• Zählen, wie oft etwas passiert ist
• Verwalten von Währungen oder Punkten

Beispiele:

• Wie viele Schlüssel hat der Spieler?
• Wie viel Geld wurde gesammelt?
• Wie viele Hinweise wurden entdeckt?

Number-Variablen können während des Spiels erhöht, verringert oder auf einen spezifischen Wert gesetzt werden.

Text variables speichern kurze Textstücke. Sie sind nützlich, wenn du Namen, Codes oder vom Spieler getroffene Auswahlen merken musst.

Typische Verwendungszwecke sind:

• Speichern des vom Spieler gewählten Namens
• Aufzeichnen, welche Option gewählt wurde
• Speichern von Codes oder Identifikatoren

Beispiele:

• Spielername
• Gewählte Fraktion
• Eingegebener Türcode

Text-Variablen können aktualisiert werden, wann immer ein neuer Wert gespeichert werden muss.

Calculated variables leiten ihren Wert aus einem Ausdruck ab, statt einen festen Wert zu halten. Der Ausdruck kann einfache Zahlen oder Platzhalter für andere Variablen verwenden.

Unterstützte Operatoren sind *, +, \/, %, - und Klammern.

Berechnete Variablen sind nützlich für Werte wie Schaden nach Rüstung, eine Punktzahl aus mehreren Zählern oder einen Fortschrittswert basierend auf gesammelten Items. Sie halten abgeleitete Logik an einer Stelle, statt mehrere separate Variable-Updates zu benötigen.

Variablen können als interne Story-Logik verborgen bleiben oder als Stats markiert werden, wenn der Spieler den aktuellen Wert während des Spiels verstehen soll.

Stats sind nützlich für Werte wie:

• Gesundheit oder Ausdauer
• Verstand, Misstrauen oder Gefahr
• Beziehungswerte
• Gesammelte Ressourcen
• Kapitel- oder Rätselsfortschritt

Ein Stat kann in unterschiedlichen Formaten angezeigt werden:

• Text: Zeigt den Wert direkt an. Nützlich für Namen, Labels, Zähler oder Werte, bei denen die genaue Formulierung wichtig ist.
• Bar: Zeigt Fortschritt als gefüllte Leiste. Nützlich für Gesundheit, Ausdauer, Verstand oder andere Werte mit klarem Minimum und Maximum.
• Segments: Zeigt Fortschritt als separate Abschnitte. Nützlich für Herzen, Ladungen, Hinweissfortschritt oder begrenzte Ressourcen.

Markiere Variablen nur dann als Stats, wenn der Spieler davon profitiert, sie zu sehen. Variablen, die nur versteckte Bedingungen, Verzweigungen oder internen Story-Zustand steuern, können normale Variablen bleiben.

Variablen können als Platzhalter in unterstützte Textfelder eingefügt werden. Wenn ein Textfeld Platzhalter unterstützt, zeigt der Editor einen Picker, sodass du dir die genauen Variablennamen nicht merken musst.

Das ist nützlich für Spielernamen, gesammelte Item-Anzahlen, gewählte Fraktionen, gemerkte Antworten oder jeden anderen Wert, der im Text erscheinen sollte.

Der gleiche Picker ist auch überall verfügbar, wo Bedingungen und Aktionen einen Variablenwert benötigen. Das hält die Wiederverwendung von Variablen beim Schreiben und in der Logik konsistent.

Variablen werden im gesamten Editor verwendet, um zu steuern, wie sich die Geschichte verhält.

Sie können verwendet werden, um:

• Dialogoptionen anzuzeigen oder zu verbergen
• Trigger und Ereignisse zu aktivieren
• verzweigende Story-Pfade zu steuern
• Szenen, Gegenstände oder Interaktionen freizuschalten
• unterstützte Textfelder mit gespeicherten Werten zu füllen
• Werte aus anderen Variablen zu berechnen

Wann immer sich eine Variable ändert, wird der neue Wert sofort gespeichert und bleibt für den Rest des Durchlaufs aktiv.

Während des Testens kannst du das Debug-Menü öffnen, um Variablen in Echtzeit zu inspizieren und zu ändern.

Das erlaubt dir,:

• alle derzeit in der Story verwendeten Variablen anzusehen
• Werte zu ändern, um alternative Pfade zu testen
• Variablen auf ihre Startwerte zurückzusetzen
• scoped Variablen in der relevanten Szene oder dem relevanten Kapitel zu prüfen

So ist es einfacher, komplexe Verzweigungslogik zu testen, ohne die gesamte Geschichte neu spielen zu müssen.

• Verwende Choice variables für einfache Ja- oder Nein-Entscheidungen.
• Verwende Number variables für Zähler, Ressourcen oder Fortschrittsverfolgung.
• Verwende Text variables nur, wenn du tatsächliche Textwerte speichern musst.
• Verwende Calculated variables für Werte, die aus anderen Variablen abgeleitet werden.
• Halte temporären Zustand in Szene- oder Kapitelvariablen, wenn er nicht überall relevant ist.
• Markiere Variablen nur dann als stats, wenn der Spieler diesen Wert während des Spiels sehen sollte.
• Wähle aussagekräftige Variablennamen, damit sie später leicht zu verstehen sind.
• Entferne ungenutzte Variablen, um dein Projekt organisiert zu halten.

Variablen erlauben Talescape, sich zu merken, was passiert ist und entsprechend zu reagieren. Sie bilden das Rückgrat von conditions, actions und jedem verzweigenden Pfad in deiner Geschichte.