# Traffic Tool Essentials

**Traffic Tool Essentials**<span> (TTE) ist eine zur Verkehrsoptimierung erdachte Modifikation für </span>***Cities: Skylines II***

# Einführung

Willkommen und erste Informationen zum Einstieg in Traffic Tool Essentials :)

Danke, dass du da bist!

# Allgemeine Informationen

<p class="callout info align-left">**Vorwort**</p>

> **Traffic Tool Essentials** entsprang ursprünglich aus der Not heraus und basiert im Kern auf dem Gerüst, das slyh dankbarerweise bereits gebaut hat:
> 
> "*Traffic Lights Enhancement*" - eine Mod, seinerzeit entwickelt von "slyh" (im Forum und auf Paradox unter dem Accountnamen "C2VMTLE" veröffentlicht), wurde zurückgelassen und mit ihr viele abhängige Nutzer, unter anderem ich. Mein Verkehrsnetz war ohne konfigurierbare Kreuzungen nahezu sinnlos - und nachdem über mehrere Monate hinweg, seit der Spiel-Version 1.3.3, kein Update und keine Bewegung in Sicht war, habe ich einen Fork der TLE Mod erstellt, der schon von Anfang an umfangreicher wurde als zunächst angenommen, weswegen auch direkt ein Renaming durch mich vorgenommen wurde.
> 
> Mittlerweile ist um das Grundgerüst der ursprünglichen Mod, rund um das reine bearbeiten von Phasen und Phasenzyklen ein System gewachsen, das wesentlich komplexer ist und hoffentlich jeden Verkehrs-Nerd, wie mich, mit der Zeit immer besser zufrieden stellen kann.
> 
> Viele schlaflose Nächte stecken bereits in diesem Projekt und sicher wird noch die ein oder andere hinzukommen. Es macht sehr viel Spaß, mit euch gemeinsam diese Reise zu beschreiten und ich werd' mein bestes tun, euch nicht zu enttäuschen!

<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">**Schön, dass du da bist und dass du dich vielleicht für TTE entscheiden willst, oder bereits entschieden hast :)**</span></span>

## **Das ist TTE**

Traffic Tool Essentials ist gedacht als eine sinnvolle Erweiterung des Spiels an Stellen, an denen das Spiel an sich keine Lösungen für vorhandene Probleme bietet. Mit aktuell mehr als 1800 Spielstunden glaube ich, ein gutes Gespür zu haben für das, was nützlich und hilfreich sein kann - schlicht, weil ich es selbst gebrauchen kann.

<p class="callout success">**Aktuell erwarten dich bereits folgende Features:**</p>

## ✍🏻 Phasen-Editor

- **Individuelle Ampelphasen:** Erstelle maßgeschneiderte Signalpläne für jede beliebige Kreuzung.
- **Sequenzieller/Legacy Modus:** Die Ampeln durchlaufen die Phasen entweder in fester Reihenfolge oder gewichtet nach wartenden Fahrzeugen.
- **Kopieren &amp; Einfügen:** Übertrage Phasen-Einstellungen mühelos zwischen verschiedenen Kreuzungen.
- **Löschbestätigung:** Verhindert das versehentliche Löschen von Phasen.

## 💚Grüne💚Welle💚

- **Gruppensteuerung:** Fasst mehrere Kreuzungen für eine synchronisierte Zeitplanung zusammen.
- **Individuelle Offsets:** Stelle präzise Zeitversatze zwischen den Kreuzungen ein.
- **Echtzeit-Status:** Synchronisations-Status direkt im Dashboard einsehbar.
- **Automatische Resynchronisierung:** Korrigiert Zeitabweichungen sofort und automatisch.

## 🚗 Verkehrs-Dashboard

- **24-Stunden-Historie:** Verkehrsverlauf visualisiert als Sparkline-Graph.
- **Echtzeit-Fahrzeugzählung:** Präzise Daten statt nur Schätzwerte!
- **Spitzenzeiten-Analyse:** Anzeige der Hauptverkehrszeiten und der maximalen Fahrzeuge pro Stunde.
- **Warteschlangen-Zähler:** Behalte die Anzahl der wartenden Fahrzeuge im Blick.
- **Dauerhafte Daten:** Alle Statistiken bleiben auch nach dem Speichern und Laden erhalten.

## 📈 Statistiken

- **Timer-Anzeige:** Aktuelle Phasenlaufzeiten im Überblick.
- **Prioritäts-Informationen:** Details zur Vorrangschaltung.
- **Verkehrsfluss-Überwachung:** Analysiere den Durchfluss in Echtzeit.
- **Spurauslastung:** Verfolge die Belegung der einzelnen Fahrspuren.

<p class="callout warning">***🏗️ Kommende Features (In Arbeit)***</p>

🚉 Mobility Hubs

- **Multimodale Knotenpunkte:** Erschließe das volle Potenzial deines Verkehrsnetzes.
- **Park &amp; Ride Integration:** Ermögliche Pendlern den nahtlosen Umstieg vom Auto auf den ÖPNV, um die Innenstädte zu entlasten.
- **Zentralisierte Umstiegspunkte:** Optimiere die Wegeführung zwischen Bus, Bahn und Individualverkehr.

🏢 Zentrale Verkehrsleitstelle (TMC, Traffic Management Center)

- **Ganzheitlicher Überblick:** Überwache den Individualverkehr und den ÖPNV
- **Echtzeit-Netzwerkanalyse:** Identifiziere Infos und Probleme des Verkehrsnetzes im gesamten Stadtgebiet auf einen Blick
- **Flottenmanagement:** Verfolge die Pünktlichkeit deiner öffentlichen Verkehrsmittel live.

⚡ Quick-Cycle Templates

- **Phasen-Vorlagen:** Nutze vordefinierte Standard-Zyklen für gängige Kreuzungstypen.
- **One-Click Setup:** Wende komplexe Ampelphasen mit nur einem Klick auf jede beliebige Kreuzung an.
- **Bibliothek-System:** Erstelle eigene Best-Practice-Vorlagen und rolle sie stadtweit aus.

# Konfiguration von Kreuzungen

Erfahre in diesem Kapitel alles über die Konfiguration von Kreuzungen und lerne, wie man den Phaseneditor bestmöglich für sich nutzen kann!

# Der Anfang

### <span style="text-decoration: underline;">**Wie du loslegst/Menü öffnen**</span>

![image.png](https://shelf.zessons.de/uploads/images/gallery/2025-12/scaled-1680-/jyIRFeBt08nxQ0g9-image.png)

- Sobald du im Spiel auf das **Ampel-Symbol** klickst, in der **linken, oberen Ecke** des Spiels in deiner **Symbolleiste**, öffnet sich das **Hauptmenü** von TTE. Das sieht folgendermaßen aus.
- Um jetzt **Konfigurationen** an Kreuzungen **vorzunehmen**, klicke auf den **entsprechenden Button**.

<p class="callout info">**Hauptmenü**  
  
*- Sei nicht verwirrt über "*Mobility Hub*", du findest diese Funktion* in deiner Mod-Version noch nicht *- sie befindet sich in der* Anfangsphase der Entwicklung. </p>

---

### <span style="text-decoration: underline;">**Eine Kreuzung auswählen**</span>

![image.png](https://shelf.zessons.de/uploads/images/gallery/2025-12/scaled-1680-/zWmAXiZyWNRgfOJT-image.png)

- Wähle im geöffneten TTE-Menü "**Kreuzungsphasen bearbeiten**".
- Das **Auswahlwerkzeug ist jetzt aktiviert** und du kannst nun nur noch Kreuzungen anklicken.
- **ESC**, um das Auswahlwerkzeug zu **verlassen**.

<p class="callout info">**Auswahlwerkzeug**  
  
Hovere mit dem Auswahlwerkzeug mit der Maus über die gewünschte Kreuzung und klicke mit der linken Maustaste. Damit gelangst du in den Editor der jeweiligen Kreuzung.</p>

---

### **<span style="text-decoration: underline;">Eine Kreuzung bearbeiten</span>[![kreuzung_vanilla.png](https://shelf.zessons.de/uploads/images/gallery/2025-12/scaled-1680-/AMjorhkrklwrSuDC-kreuzung-vanilla.png)](https://shelf.zessons.de/uploads/images/gallery/2025-12/AMjorhkrklwrSuDC-kreuzung-vanilla.png)**

Sobald du auf eine **Kreuzung geklickt** hast, gelangst du direkt in den **Editor** der jeweiligen Kreuzung.  
Es gibt vordefinierte **Schnellwahl-Phasentemplates**, wie "Aufgeteilte Phase", oder "Erweiterte, aufgeteilte Phase".

<p class="callout info align-left">**Kreuzungs-Editor** - Im Editor hast du direkt einen groben Überblick zu Daten deiner ausgewählten Kreuzung  
- Du hast **zusätzlich Optionen**, bspw. **"Abbiegen bei rot"** oder "**Exklusive Fußgängerphase**", um deine Kreuzung besser an die Gegebenheiten anzupassen</p>

# Vordefinierte Einstellungsmöglichkeiten

### **<span style="text-decoration: underline;">Vordefinierte Modi</span>**

Die Mod bringt einige, vordefinierte Modi mit, die in einigen Situationen ausreichen können, um die Performance einer Kreuzung erheblich zu verbessern. Dazu gehören die Folgenden - und was sie tun:

- **Vanilla:**   
    \- Geradeaus/Abbiegen geschützt, eine Abbiegeseite gewährt Vorrang (LHT: Rechtsabbieger / RHT: Linksabbieger)
- **Aufgeteilte Phase:**  
    \- Nur eine auf die Kreuzung zulaufende Straße hat gleichzeitig Grün
- **Erweiterte Aufgeteilte Phase:**  
    \- Wie Aufgeteilte Phase, aber zusätzlich mit geschützten Abbiegespuren für die Querstraße
- **Geschütztes Linksabbiegen/Rechtsabbiegen:** - Zuerst schaltet die Abbiegespur (LHT: Links / RHT: Rechts), danach folgt der reguläre Verkehrsfluss für Geradeaus/Gegenrichtung

<p class="callout info align-left">Für erweiterte **Details** und **reale Zählung von Fahrzeugen, belegte Fahrspuren, wartende Fahrzeuge etc.** ist ein **benutzerdefinierter Phasenzyklus** erforderlich  
  
Für **komplizierte Kreuzungen** ist jederzeit empfohlen, **eigene Phasenzyklen** zu entwerfen um die **beste Leistung** und den meisten Spaß an den Funktionen der Mod zu erfahren  
</p>

---

### <span style="text-decoration: underline;">**Vordefinierte Optionen**</span>

Die Mod bringt einige, vordefinierte Optionen mit, mit denen du die vordefinierten Modi erweitern kannst, was somit erneut die Performance einer Kreuzung erheblich verbessern kann. Dazu gehören die Folgenden - und was sie tun:

- **Erlaube Abbiegen bei rot:**   
    \- Erlaubt das Abbiegen (LHT: Links / RHT: Rechts) trotz roter Ampel
- **Vorfahrt für entgegenkommende Fahrzeuge (Nur Vanilla):**  
    \- Fahrzeuge müssen beim Abbiegen auf den Gegenverkehr achten  
    (Hohes Verkehrsaufkommen kann die Effektivität senken, wenn Fahrer aggressiv "drängeln")
- **Exklusive Fußgängerphase:**  
    \- Alle Fahrzeuge halten; eine eigene Phase nur für Fußgänger wird aktiv 
    - **Dauer der Fußgängerphase:** Legt die Grünphase für Fußgänger fest.
    - *Hinweis: Nur aktiv bei "Exklusiver Fußgängerphase". Die Ampeln sind nicht "smart" und verlängern sich nicht automatisch*

<p class="callout info align-left">**Parameterbeschreibung**  
  
**- Minimale Dauer:** Die Phase muss mindestens so lange laufen, völlig unabhängig, ob gerade viel oder wenig Verkehr auf ihr lastet  
**- Maximale Dauer:** Die Phase darf maximal so lang aktiv sein (bspw. auf verkehrsärmeren Armen die Phasendauer aktiv zu verringern, um Hauptverkehrsrichtungen zu bevorzugen  
**- Zieldauer:** Beeinflusst (als einer von zwei Faktoren) die Dauer der Grünphase. 2x = Doppelt so lang, etc.  
**- Fahrspurbelegung:** Beeinflusst (als zweiter von zwei Faktoren) die Dauer der Grünphase, allerdings zielgesteuert, nicht prinzipiell wie bei der Zieldauer, sondern NUR wenn die Spur auch tatsächlich durch Vehikel belegt ist  
**- Interval Exponent:** Fahrzeuge und Phasen, die lange warten müssten, werden im Prioritäts-Modus bevorzugt, um sie nicht "verhungern" zu lassen. Dies kann allerdings mit der moderneren Variante (Sequentieller Modus) eleganter geregelt werden</p>

# Benutzerdefinierte Phasenzyklen

---

### **<span style="text-decoration: underline;">Phaseneditor-Basis-Menü (PBM) öffnen</span>**

![KnVTRU4ypEkOmvF6-xhty0acaq1svfwx1-jymzcs0eeuiful7n-fvtojw9ahw8zgshy-ylotdf1gpeoic3mk-menu-dropdown-trafficoverview.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/QD2eAigGh0rIfc9c-knvtru4ypekomvf6-xhty0acaq1svfwx1-jymzcs0eeuiful7n-fvtojw9ahw8zgshy-ylotdf1gpeoic3mk-menu-dropdown-trafficoverview.png)

- Im **Dropdown Menü** stelle den **Phasenmodus** auf "**Benutzerdefinierte Phase**"
- Klicke dann auf "**Eigene Phasen programmieren**"
- Es **öffnet** sich das **Basis Menü** des Phasen Editors
- Du kannst hier auch die **Methode ändern**, auf welche Weise **durch Phasen geschalten** werden soll  
    \- **Priorität (*Standard*)**, Wechselt anhand des vorhandenen Verkehrsaufkommens  
    \- **Sequentiell (*TTE Modus*),** wechselt der Reihenfolge nach durch die Phasen

[![i0zgirZAGXMfDWdX-ivv0fyvitqkprojh-phaseeditor-standard.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/Ik4wGppxX9OGTCdm-i0zgirzagxmfdwdx-ivv0fyvitqkprojh-phaseeditor-standard.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/Ik4wGppxX9OGTCdm-i0zgirzagxmfdwdx-ivv0fyvitqkprojh-phaseeditor-standard.png)

<p class="callout info align-left">**Phasen Editor (Basis Menü)** Hier kannst du deine Phasen verwalten, also:   
Phasen **erstellen**, Phasen **verschieben**, Phasen **bearbeiten**, Phasen **löschen,** Phasen **kopieren** und Phasen **einfügen**  
</p>

---

### <span style="text-decoration: underline;">**Phase hinzufügen**</span>

![b07gaLY0qIubLWHi-phaseeditor-phaseedit-zoom.png](https://shelf.zessons.de/uploads/images/gallery/2025-12/scaled-1680-/QuLvqFYwkTfMG44N-b07galy0qiublwhi-phaseeditor-phaseedit-zoom.png)

- Klicke auf "**Phase hinzufügen**", sofort darauf öffnet sich das Phasen-Menü
- Stelle **Parameter der jeweiligen Phase** nach deinen Wünschen und den Bedürfnissen vor Ort ein
- Stelle hier auch ein, **welche Verkehrsteilnehmer** in einer Phase **bevorzugt werden** sollen.  
    Wenn sich in einer Phase bspw. Straßenbahn- und Individualspur kreuzen und du hast eingestellt, den ÖPNV zu priorisieren, wartet der Verkehr, bis die Straßenbahn die Kreuzung passiert hat

[![phaseeditor_phaseedit.png](https://shelf.zessons.de/uploads/images/gallery/2025-12/2uQ1IGGJuBk9QEUi-phaseeditor-phaseedit.png)](https://shelf.zessons.de/uploads/images/gallery/2025-12/Yl2pjNWrdylUAIil-ox6ivitf5aiusoii-phaseeditor-phaseedit-phase1.png)

<p class="callout info align-left">**Parameterbeschreibung**  
  
**- Minimale Dauer:** Die Phase muss mindestens so lange laufen, völlig unabhängig, ob gerade viel oder wenig Verkehr auf ihr lastet  
**- Maximale Dauer:** Die Phase darf maximal so lang aktiv sein (bspw. auf verkehrsärmeren Armen die Phasendauer aktiv zu verringern, um Hauptverkehrsrichtungen zu bevorzugen  
**- Zieldauer:** Beeinflusst (als einer von zwei Faktoren) die Dauer der Grünphase. 2x = Doppelt so lang, etc.  
**- Fahrspurbelegung:** Beeinflusst (als zweiter von zwei Faktoren) die Dauer der Grünphase, allerdings zielgesteuert, nicht prinzipiell wie bei der Zieldauer, sondern NUR wenn die Spur auch tatsächlich durch Vehikel belegt ist  
**- Interval Exponent:** Fahrzeuge und Phasen, die lange warten müssten, werden im Prioritäts-Modus bevorzugt, um sie nicht "verhungern" zu lassen. Dies kann allerdings mit der moderneren Variante (Sequentieller Modus) eleganter geregelt werden</p>

---

### **<span style="text-decoration: underline;">Spurenfreigabe der Phase einstellen  
</span>**

**Erstelle nach dieser Art und Weise jetzt mehrere Phasen und erschaffe quasi einen individuellen Herzschlag für jede deiner wichtigen Kreuzungen.**

- **Erstelle** nach und nach **so viele Phasen du brauchst**, um an deiner jeweiligen Kreuzung **alle Kreuzungsarme und Abbieger abzudecken**
- Klicke auf das **rote Icon** des gewünschten **Verkehrsteilnehmers** (Autos/Fahhräder, ÖPNV, Fußgänger), um die entsprechende Ampel von **rot auf grün** zu schalten
- **Klicke erneut** auf das selbe Symbol und die Farbe **wechselt zu blau**, das bedeutet, dass
- **Klicke** ein **drittes Mal**, um das Symbol wieder in die **Ausgangslage** zu versetzen **(ROT)**

[![Yl2pjNWrdylUAIil-ox6ivitf5aiusoii-phaseeditor-phaseedit-phase1.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/LUyoCc4QZllxqT1k-yl2pjnwrdyluaiil-ox6ivitf5aiusoii-phaseeditor-phaseedit-phase1.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/LUyoCc4QZllxqT1k-yl2pjnwrdyluaiil-ox6ivitf5aiusoii-phaseeditor-phaseedit-phase1.png)

<p class="callout info align-left">**TIPPS  
  
1.:** Erstelle eine separate Fußgängerphase an Kreuzungen großer Verkehrsadern, an denen auch viele Fußgänger auftreten (sehr wahrscheinlich in der Innenstadt, oder an nachträglich beplanten, großen Umgehungsstraßen etc.)  
  
**2.:** ***Wichtig für "Grüne Welle**"*:   
Die <span style="text-decoration: underline;">*letzte Phase im Gesamtzyklus*</span> sollte (**<span style="color: rgb(45, 194, 107);">ist nur von Belang bei Verwendung der "Grünen Welle" Funktion</span>**) eine ZUSÄTZLICHE "<span style="text-decoration: underline;">*nützliche Phase*</span>" sein - also eine Phase, die Verkehr auf <span style="text-decoration: underline;">*wichtigen Strecken*</span> transferiert, da die letzte Phase vom Sync-System als <span style="text-decoration: underline;">*Puffer zum synchronisieren*</span> genutzt wird, wenn Gesamtzykluslängen von Kreuzungen in einer Gruppe stark von einander abweichen bzw. sich die Anzahl der Phasen der einzelnen Kreuzungen zu sehr unterscheiden.</p>

---

### <span style="text-decoration: underline;">**Phasen kopieren und einfügen**</span>

- **Klicke** auf die **Checkbox** **"Alle auswählen"** im PBM, **links oben bei den 3 Button**
- **Passe** deine **Auswahl** bei Bedarf **an**
- **Klicke** auf den **"Kopieren"** Button
- **Wechsle** dann **in** das **PBM der anderen Kreuzung**, welcher du die **Phasen hinzufügen** willst
- **Klicke** auf den **"Einfügen"** Button, *den mittigen der 3 Button*

[![phaseeditor_standard_copynpaste_complete.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/EXzi2L8aw38Yum7j-phaseeditor-standard-copynpaste-complete.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/EXzi2L8aw38Yum7j-phaseeditor-standard-copynpaste-complete.png)

<p class="callout info align-left">**Kopieren/Einfügen Werkzeug  
  
-** Das **Werkzeug kann nicht zaubern**. Bei <span style="text-decoration: underline;">*nicht baugleichen Kreuzungen*</span> wird das System versuchen, beim kopieren <span style="text-decoration: underline;">*möglichst viele Ampelschaltungen*</span> zu übernehmen, du solltest sie <span style="text-decoration: underline;">*allerdings nochmal überprüfen*</span> und gegebenenfalls <span style="text-decoration: underline;">*anpassen.* </span>  
**-** Beim Synchronisieren von Kreuzungen, <span style="color: rgb(45, 194, 107);">**bei Nutzung der "Grüne Welle" Funktion**</span>, kann man das System am besten optimieren, wenn gruppierte Kreuzungen mithilfe des Tools, bezogen auf Timing-Einstellungen, also Min. Laufzeit, Max. Laufzeit, etc., perfekt auf einander angeglichen werden  
</p>

# Erweiterte Funktionen und Werkzeuge

# "Grüne Welle" Werkzeug

### **<span style="text-decoration: underline;">Einleitung</span>**

***Das "<span style="color: rgb(22, 145, 121);">Grüne Welle</span>"-Werkzeug bietet dir ab sofort die Möglichkeit, im Spiel Ampelphasen verschiedener Kreuzungen zu koordinierten Streckenzügen zu synchronisieren.***

Beispielsweise im ***Innenstadtgebiet*** kann es häufig dazu kommen, dass mehrere ***Querstraßen*** hintereinander die ***Hauptverkehrsachse kreuzen***.   
Um den ***Verkehr*** dennoch bestmöglich der ***Hauptverkehrsachse entlang*** über die jeweiligen Kreuzungen zu leiten, kann man mit diesem Werkzeug ***einzelne Kreuzungen in Gruppen*** zusammenfassen.

In diesen ***Streckenzug-Gruppen*** kann dann eine ***Referenzkreuzung*** definiert werden, an der die ***weiteren Kreuzungen*** der Gruppe ***ausgerichtet*** werden.

Gibt man weiteren ***Kreuzungen*** in der Gruppe nun jeweils einen "Offset", also ***Versatzzeitraum*** in Bezug auf die ***Referenzkreuzung,*** kann man definieren, in welchem ***zeitlichen Versatz*** die jeweilige Kreuzung ***nach der Referenzkreuzung*** in Phase 1 schaltet.   
  
Mit etwas tüfteln und/oder guter Planung schalten deine Ampeln entlang des Streckenzugs dann idealerweise kurz vor eintreffen der Anfahrenden Fahrzeuge auf Grün (um Fahrzeuge, die den früheren Phasenlauf verpasst haben noch abgeführt werden können, bevor neuer Verkehr eintrifft)

---

### **<span style="text-decoration: underline;">Grüne Welle vorbereiten  
</span>**

**Um das <span style="color: rgb(22, 145, 121);">Werkzeug</span> für die Grüne Welle <span style="color: rgb(22, 145, 121);">verwenden</span> zu können [![menu_customphase.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/rqnf9QbOTwhOFAPS-menu-customphase.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/rqnf9QbOTwhOFAPS-menu-customphase.png)ist es <span style="color: rgb(22, 145, 121);">unabdingbar,</span> dass du <span style="color: rgb(22, 145, 121);">benutzerdefinierte Phasenzyklen</span> an den jeweiligen Kreuzungen verwendest und <span style="color: rgb(230, 126, 35);">keine der vordefinierten Optionen.</span>**

Um dir Arbeit zu ersparen, könntest du den Phasenzyklus bspw. der Referenzkreuzung kopieren und bei von der Grünen Welle betroffenen Kreuzungen einfügen.

- Falls noch nicht geschehen: Stelle den **Phasenmodus** im Dropdown Menü auf **"Eigene Phase"** und **erstelle** benötigte **Phasen** in der Kreuzung bzw. **kopiere Phasen** aus anderen Kreuzungen
- Danach kannst du bereits auf den erscheinenden "**Grüne Welle**" Button drücken

 [![greenwave_group_created.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/j2Pis6eQwHqfq5Zu-greenwave-group-created.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/j2Pis6eQwHqfq5Zu-greenwave-group-created.png)

<p class="callout info">**Usecase Demonstration (Beispiel)** <span style="text-decoration: underline;">*Inklusive der markierten Referenzkreuzung*</span></p>

[![greenwave_tutorial_reference.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/DtQHMMwvF2X4ACn2-greenwave-tutorial-reference.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/DtQHMMwvF2X4ACn2-greenwave-tutorial-reference.png)

<p class="callout info">**<span style="color: rgb(52, 73, 94);">Algorithmus Design </span>** <span style="text-decoration: underline;">(Systemarchitektur der Grünen Welle)</span>  
  
Für eine funktionierende "**Grüne Welle**" muss die <span style="text-decoration: underline;">**erste Phase**</span> (P1) jedes **Phasenzyklus <span style="color: rgb(224, 62, 45);">zwingend</span>** die Verkehrsrichtung/en priorisieren, in die die Welle geleitet werden soll.   
  
**<span style="text-decoration: underline;">Beachte also:</span>  
  
Die erste Phase eines Gesamtzyklus** muss die Phase sein, die die Richtung der grünen Welle vorgibt. Das System synchronisiert alle Kreuzungen so, dass sie zur richtigen Zeit bereit sind, in Phase 1 zu wechseln, sobald sie an der Reihe sind.  
  
**Die zweite Phase eines Gesamtzyklus** sollte eine "***nützliche Phase***" sein. Das bedeutet: Das *System* muss bei zu stark *abweichender Gesamtzyklusdauer* der einzelnen Kreuzungen (weil nicht gut auf einander angeglichen) oder einer zu stark *abweichenden* Anzahl von *Phasen* an den Kreuzungen (≥2 Phasen Unterschied zwischen mindestens einer Kreuzung zu den anderen/einer anderen) die *letzte Phase* nutzen, um etwaiges *Ungleichgewicht auszugleichen.*   
<span style="text-decoration: underline;">Die letzte Phase von Kreuzungen wird also hin und wieder gestreckt werden, um das System synchron zu halten.</span> Um querende Straßen nicht "verhungern" zu lassen, also deren Phasenlänge zu stauchen, damit die Kreuzung aufholen kann, habe ich mich dazu entschieden, lieber die letzte Phase im Notfall lang zu halten und zu warten, bis die Kreuzung durch ihren Zyklus gehen konnte. Es gibt auch einen Rush Mode, diesen setzt das System beim Force Release ein.  
  
**\****Der <span style="text-decoration: underline;">Force Release</span> ist in der <span style="text-decoration: underline;">Version 2.2.2</span> hin und wieder aufgefallen durch <span style="text-decoration: underline;">teils rabiates Eingreifen</span>. Im anstehenden Versions-Update werden auch diese Systeme noch einmal adjustiert. In den meisten Use-Cases sollte das allerdings nicht zum Problem werden und kann durch eigene Aktionen auch wieder umgangen werden. Etwas tüfteln ist dann nötig. (Ich beeile mich, die Stabilität dieses Systems zu verbessern)*<svg aria-hidden="true" direction="ltr" height="0.853em" viewbox="0 -0.676 1.351 0.853" width="1.351em" xmlns="http://www.w3.org/2000/svg"><text fill="#FFFFFF" transform="translate(0,0)">(</text><text fill="#FFFFFF" transform="translate(0.333,0)">≥</text><text fill="#FFFFFF" transform="translate(1.018,0)">)</text></svg>**<span class="mTEjhd"></span>**</p>

---

### <span style="text-decoration: underline;">**Erstelle eine Streckenzug-Gruppe**</span>

- Klicke jetzt auf "**Neue Gruppe**", daraufhin wird diese erstellt
- Wähle im Dropdown Menü die soeben erstellte Gruppe, die noch "Neue Gruppe" heißt, und/oder benenne sie (vorzugsweise im dafür vorgesehenen Tab "Gruppen") um 
    - Die erste, hinzugefügte Kreuzung ist in den meisten Fällen auch als Referenzkreuzung gedacht. Die Referenzkreuzung wird mit dem Offset 0s bestimmt. Oder es wird automatisch die Kreuzung zur Referenzkreuzung, dessen Offset am niedrigsten ist.
- Füge nun eine weitere Kreuzung hinzu, im Idealfall direkt die auf die Referenzkreuzung folgende Kreuzung, dann die darauf folgende - und immer so weiter
- Die Kreuzungen lassen sich jederzeit ganz einfach via Offset-Einstellung in der Reihenfolge priorisieren 
    - Der Offset Rechner kann dir vielleicht eine erste Hilfestellung sein, um in etwa die Werte einzuschätzen, die du einstellen musst. Mit zunehmender Größe einer Stadt und zunehmender Verlangsamung der Simulation sind 12 eingestellte Sekunden natürlich nicht mehr genau 12s. Im Backend werden Frames in menschlich verständliche Werte umgesetzt und dann ans Frontend übermittelt.

[![greenwave_group_select.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/bdD2X9t8elcK4jhA-greenwave-group-select.png)](https://shelf.zessons.de/uploads/images/gallery/2025-12/Yl2pjNWrdylUAIil-ox6ivitf5aiusoii-phaseeditor-phaseedit-phase1.png)[![greenwave_offset_zoom.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/DuybqMQQYjkUb5kM-greenwave-offset-zoom.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/DuybqMQQYjkUb5kM-greenwave-offset-zoom.png)[![greenwave_tutorial_secondjunction.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/6uPiPauRlyQFUYoo-greenwave-tutorial-secondjunction.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/6uPiPauRlyQFUYoo-greenwave-tutorial-secondjunction.png)

<p class="callout info align-left"><span style="text-decoration: underline;">**Systemarchitektur &amp; Referenzlogik** (zusammengefasst)</span>  
*Um die Synchronität über verschiedene Kreuzungstypen hinweg zu gewährleisten, etabliert das System eine **dynamische Referenzsteuerung**. Für einen stabilen Betrieb gelten folgende Logik-Regeln:*  
  
**-** **P1-Priorisierung:** Die erste Phase (**P1**) eines Zyklus definiert die Richtung der „Grünen Welle“. Das System taktet alle Kreuzungen basierend auf ihrem individuellen Offset so, dass sie pünktlich zum errechneten Zeitpunkt in Phase 1 initialisieren  
  
**- Sequentieller Phasenwechsel:** Für den Betrieb einer Grünen Phase ist es unerlässlich, dass die Phasen nach dem neuen, mit TTE etablierten Wechselmodus "Sequentieller Modus" durch ihre Phasen wechseln, da sich der Wechsel von Phasen im Legacy Mode von TLE nicht vorhersagen und somit nicht synchronisieren lässt. Nirgendwo auf der Welt würde auf diese Weise eine Grüne Welle programmiert werden, so auch nicht in diesem Fall. Um den Legacy Mode wieder zu nutzen, musst du die betroffene Kreuzung aus der jeweiligen Streckenzug-Gruppe entfernen  
  
**- Dynamischer Drift-Ausgleich:** Bei unterschiedlichen Gesamtzykluslängen einzelner Kreuzungen oder stark abweichender Phasenanzahl (Differenz ≥<span class="math-inline" data-index-in-node="112" data-math="\ge 2">2</span>) schützt das System den Querverkehr vor dem "verhungern". Statt Phasen zu stauchen, wird die **letzte Phase** des Zyklus einer Kreuzung bei Bedarf gestreckt, um Ungleichgewichte auszugleichen und auf den globalen Takt der Referenzkreuzung zu warten  
  
**- Referenz-Anker (Offset 0s):** Die Kreuzung mit dem niedrigsten Offset (idealerweise 0s) fungiert als Taktgeber. Alle weiteren Offsets müssen **relativ zur Referenzkreuzung** berechnet werden – nicht zur jeweils vorherigen Kreuzung  
</p>

---

### **<span style="text-decoration: underline;">Gruppen-Panel  
</span>**

**<span style="text-decoration: underline;">[![greenwave_grouptab_rename.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/vonNsUr9h8XeavBU-greenwave-grouptab-rename.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/vonNsUr9h8XeavBU-greenwave-grouptab-rename.png)</span>**

Im Tab **„Groups“** verwaltest du die logischen Einheiten deiner Streckenzüge. Hier definierst du das Grundgerüst, bevor du in die Feinjustierung der einzelnen Kreuzungen gehst.

- **Zentrales Management:** Erstelle neue Gruppen mit einem Klick, benenne sie für eine bessere Übersicht um (z. B. nach Hauptverkehrsachsen wie „B1 / Potsdamer Str.“) oder lösche nicht mehr benötigte Verbünde
- ****ECS-Logik:**** Das System arbeitet ressourcenschonend. Dank der Architektur des *Entity Component Systems (ECS)* werden leere Gruppen, in denen keine Daten hinterlegt sind, automatisch nicht dauerhaft gespeichert. Du musst dich also nicht um das „Aufräumen“ verwaister, leerer Gruppen kümmern – das System erledigt das im Backend für dich
- **Status-Feedback:** Direkt im Panel siehst du auf einen Blick, wie viele Kreuzungen einer Gruppe bereits zugewiesen sind und ob die Gruppe initialisiert wurde (erkennbar am grünen Punkt/Status).

<p class="callout info">Benenne deine Gruppen erst um, **nachdem** du die gewünschten Kreuzungen im „Kreuzung“-Tab zugewiesen hast. Dies beugt zunächst einfach Edge-Cases bei der Daten-Synchronisation vor, falls du komplexe Änderungen an der Gruppenstruktur vornimmst</p>

---

### <span style="text-decoration: underline;">**Dashboard**</span>

Das Dashboard ist dein Kontrollzentrum. Hier siehst du in Echtzeit, ob deine Planung in der Spielwelt aufgeht.  
  
Wenn du signifikante Änderungen an einer Streckenzuggruppe vornimmst, kann es mitunter vorkommen, dass du chaotisches Verhalten bemerkst - ist abhängig von den Differenzen der jeweiligen Kreuzungen

- **Der SYNC-Status:** \* Leuchtet das **SYNC-Icon** grün, ist die Kreuzung erfolgreich im globalen Takt der Gruppe verankert. 
    - Sollte eine Kreuzung aus dem Takt geraten (z. B. durch manuelle Eingriffe oder extreme Simulations-Lags), siehst du hier, wie die **Force Release Logik** oder der **Rush Mode** versucht, die Synchronität wiederherzustellen.
- **Phasen-Fortschrittsbalken:** Der grüne Balken unter „Phase X / Y“ zeigt dir exakt, an welchem Punkt des Zyklus sich die Kreuzung befindet.
    
    
    - **Wichtig:** Da das System bei Ungleichgewicht teilweise die **letzte Phase streckt**, wirst du hier beobachten können, wie der Balken am Ende des Zyklus manchmal „wartet“. Das ist kein Bug, sondern der **Dynamische Drift-Ausgleich** in Aktion
- **Zyklus-Varianz:** Hier siehst du auch die Gesamtdauer eines Durchlaufs in Sekunden. Achte darauf, dass diese Werte bei allen Kreuzungen einer Gruppe möglichst nah beieinander liegen (harmlos: z.B. 476s zu 472s im Screenshot). Je größer die Differenz, desto massiver muss das System eingreifen

<span style="text-decoration: underline;">[![greenwave_dashboard_pt1.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/nWAy6fD5crwYewPT-greenwave-dashboard-pt1.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/nWAy6fD5crwYewPT-greenwave-dashboard-pt1.png)[![greenwave_dashboard_pt2.png](https://shelf.zessons.de/uploads/images/gallery/2026-01/scaled-1680-/ifKjv7c77pTrrNMY-greenwave-dashboard-pt2.png)](https://shelf.zessons.de/uploads/images/gallery/2026-01/ifKjv7c77pTrrNMY-greenwave-dashboard-pt2.png)</span>

<p class="callout info align-left">**Den "perfekten" Offset finden** - Nutze das Dashboard, um den realen Verkehrsfluss zu beobachten. Wenn du siehst, dass Fahrzeuge an Kreuzung #2 ankommen, der Balken aber erst bei 10% von Phase 1 steht, ist dein Offset zu hoch. Ziel ist es, dass Phase 1 dann startet (Balken beginnt zu laufen), wenn die Fahrzeugkolonne der Referenzkreuzung die Haltelinie erreicht, oder vielleicht auch etwas früher, um zuvor durch eventuell eine Straßenbahn aufgehaltene Grüne Welle. Du hast völlige Freiheit! **Bekanntes Problem** - Beim erstellen und Einrichten von Gruppen kann es dazu kommen, dass im Dashboard alle Kreuzungen bei P1 hängen und nichts tun. Das ist wirklich nicht schön, aber du kannst es umschiffen. Entferne alle Kreuzungen aus der betroffenen Gruppe, lösche diese Gruppe sobald sie keine Kreuzungen mehr enthält, erstelle eine neue Gruppe und benenne diese auch erst um, wenn gewünschte Kreuzungen drin sind und laufen. Danach sollte es nicht mehr zu Problemen kommen, egal welche Änderungen du vornimmst. Wenn alle Phasenzyklen der Kreuzungen identisch lang sind, kann das System manchmal in einen Edge-Case rennen, in dem die Force Release Logik gar nicht aufgerufen wird, die in solchen Fällen greifen sollte.  
</p>