README: Bannerbild hinzugefügt

- Neues Banner (croc_vibes_banner.png) erstellt und unter docs/img/ abgelegt
- Banner wird nun ganz oben in der README angezeigt
- Optische Aufwertung und klarer Projekt-Header

docs/Blues_Addon_Beschreibung.md

@@ -0,0 +1,51 @@
+# Blues Add-on  
+
+Das **Blues v0.1.0** Skript ist ein optionaler Zusatzindikator für das Croc-Vibes-System.  
+Es bietet eine erweiterte Logik zur Handhabung der "Blauen Punkte"-Signale.  
+
+---
+
+## Zweck des Add-ons  
+
+Anstatt ein "Blauer Punkt"-Signal sofort als Einstieg zu werten, behandelt dieser Indikator es als **Vorbereitung für einen potenziellen Trade**.  
+Das eigentliche Einstiegssignal wird erst generiert, wenn der Kurs ein relevantes technisches Niveau durchbricht.  
+
+---
+
+## Funktionsweise  
+
+1. **Signalerkennung:**  
+   Der Indikator wartet auf ein "Blauer Punkt"-Signal (Long oder Short), das innerhalb einer aktiven Wolkenzone (grün für Long, rot für Short) auftritt.  
+
+2. **Referenzniveau setzen:**  
+   Sobald ein Signal erkannt wird, zeichnet der Indikator eine horizontale Linie auf dem Niveau des **vorherigen Hochs** (für Long-Setups) oder **Tiefs** (für Short-Setups) dieser Zone.  
+
+3. **Warten auf Ausbruch (Erfüllung):**  
+   Das Setup bleibt *wartend* (pending), bis der Kurs diese Linie durchbricht.  
+   - Bei einem Long-Setup muss der Kurs über das vorherige Hoch steigen.  
+   - Bei einem Short-Setup muss der Kurs unter das vorherige Tief fallen.  
+
+4. **Signalauflösung:**  
+   Das Setup wird beendet, wenn:  
+   - der Ausbruch erfolgt (*Erfüllung*), oder  
+   - die Wolke ihre Farbe ändert (*Wolkenbruch*), bevor der Ausbruch stattgefunden hat.  
+
+---
+
+## Beispiel  
+
+![Beispiel: Croc Vibes mit Blues Add-on](./img/croc_vibes_example.png)  
+
+---
+
+## Anwendung  
+
+Um diesen Indikator korrekt zu verwenden, sind zwei Schritte notwendig:  
+
+1. Füge den **Blues v0.1.0** Indikator zu deinem Chart hinzu.  
+2. Öffne die Einstellungen des Hauptindikators (*Croc Vibes*) und **deaktiviere** die Option *"Blaue Punkte Labels anzeigen"*, um doppelte Anzeigen zu vermeiden.  
+
+---
+
+**Wichtiger Hinweis:** Dieses Skript wird ohne Support bereitgestellt.  
+Jeder nutzt den Code auf eigene Verantwortung.  

docs/Croc_Vibes_Beschreibung.md

@@ -0,0 +1,53 @@
+# Croc Vibes – Hauptindikator  
+
+Der **Croc Vibes by Telgos** ist ein fortschrittlicher Indikator für TradingView (Pine Script® v5), der speziell für das Croc-Trading-System entwickelt wurde.  
+Er dient der visuellen und analytischen Darstellung verschiedener Long-Setups.  
+
+**Wichtiger Hinweis:** Dieses Skript wird ohne Support zur Verfügung gestellt. Es ist als Basis gedacht, die von Nutzern nach eigenem Ermessen angepasst und erweitert werden kann.  
+
+---
+
+## Kernfunktionen  
+
+- **Visuelle Darstellung:** Der Indikator nutzt eine Kombination aus Original-Lochstreifen-Indikatoren, Wolkenfarben, Kerzenfarben und MSI-Werten, um Handelssignale direkt im Chart zu visualisieren.  
+- **Setup-Erkennung:** Erkennung und Anzeige bekannter Setups wie:  
+  - Pearl Diver  
+  - Stephan Setup  
+  - Ulti Rally  
+- **Swing-Analyse:** Integrierte Swing-Analyse zur Validierung von Punkten und zur Erhöhung der Signalqualität.  
+- **Dynamische SL/TP-Marken:** Automatische Visualisierung von Stop-Loss- und Take-Profit-Niveaus auf Basis der Average True Range (ATR).  
+- **Alarmfunktionen:** Vorbereitete `alertcondition()`-Blöcke ermöglichen die einfache Einrichtung von Alarmen für verschiedene Handelssignale, was die Nutzung in Screenern oder mit externen Bots erleichtert.  
+
+---
+
+## Eingaben (Inputs)  
+
+Die Einstellungen des Indikators sind in drei Hauptbereiche unterteilt:  
+
+1. **Chart-Signale:** Hier werden die grundlegenden Signale wie die "blauen Punkte" und andere Kerzensignale mit dem Indikator verbunden.  
+2. **Lochstreifen (Punch Tape):** Anbindung der externen Konnektor-Indikatoren, die den Zustand der Wolken, Farben und des MSI übermitteln.  
+3. **Allgemeine Einstellungen:** Anpassungen für die visuelle Darstellung, wie z. B. die Abstände von Labels und Linien.  
+
+---
+
+## Strategien im Detail  
+
+### Pearl Diver  
+Dieses Setup basiert auf einer strengen Kombination von Farben und wird durch eine Swing-basierte Logik bestätigt, um die Zuverlässigkeit zu erhöhen.  
+
+### Stephan Setup  
+Hierbei handelt es sich um ein Setup, das auf spezifischen MSI-Levels in Kombination mit bestimmten Farbbedingungen basiert.  
+
+### Blue Dot (Blaue Punkte)  
+Die Erkennung von blauen Punkten wird ebenfalls durch eine Swing-Validierung verfeinert, um potenzielle Trendwenden zu identifizieren.  
+
+---
+
+## Beispiel  
+
+![Beispiel: Croc Vibes](./img/croc_vibes_example.png)  
+
+---
+
+**Hinweis:** Dieser Indikator ist ein reines Visualisierungswerkzeug und führt keine automatisierten Trades aus.  
+Für Backtesting muss eine separate Pine-Strategie-Datei erstellt werden.  

docs/FAQ.md

@@ -0,0 +1,24 @@
+# Croc Vibes – FAQ  
+
+Denn die immer wiederkehrenden Fragen kosten viel zu viel *unwiederbringliche Lebenszeit*. 😉  
+
+---
+
+### Warum muss ich meine Variablen nach einem Update neu zuordnen?  
+Wenn der Original-Indikator entfernt oder aktualisiert wird – oder wenn du am Code selbst etwas änderst – behandelt TradingView den Indikator wie ein neues Script.  
+
+Das bedeutet, dass alle zuvor gemachten Eingaben und Variablen-Zuordnungen zurückgesetzt werden.  
+So ist die Plattform konzipiert – es handelt sich also nicht um einen Fehler, sondern um ein Verhalten **„by design“**.  
+
+Leider gibt es keine Möglichkeit, dieses Verhalten zu umgehen. Wer also am Script arbeitet oder externe Indikatoren als Quelle einbindet, muss damit rechnen, die Zuordnungen nach einer Änderung erneut vorzunehmen.  
+
+---
+
+### Warum kann Croc Vibes nicht im Pinescreener verwendet werden?  
+Das temporäre Community-Hilfsscript **Croc Vibes** entstand nur, weil der Croc 3.0 eine begrenzte Anzahl an Labels ausgibt und wir Anfänger (bin auch erst seit Juli dabei) von ein paar zusätzlichen Labels profitieren.  
+
+Da der Croc ständig weiterentwickelt wird, hoffen wir, dass in künftigen Versionen mehr Labels direkt enthalten sind und Croc Vibes nicht mehr benötigt wird. 🚀  
+
+Mir persönlich reichen die Setups von André und der Community locker aus 👍. Eher muss ich mich entscheiden, welches Setup für mich am besten aussieht – weil mein Kapital 💸 niemals für alle Community-Setups ausreicht.  
+
+---

docs/Installation.md

@@ -0,0 +1,109 @@
+# 📈 Croc Vibes – Installations- & Nutzungshinweise
+
+Dieses Skript erkennt diverse Long-Signale im Croc 3.0 System und zeigt sie direkt im TradingView-Chart – inklusive Labels, Marken und automatischer Alerts.  
+Ziel: **visuelles Feedback, wann ein valider Einstieg vorliegt**, z. B. „Pearl Diver“, „Ulti Rally“, „Stephan Setup“ oder „Black Green Rocket Long (BGRL)“.
+
+---
+
+## 🧭 Voraussetzungen
+
+- Kostenloser Account bei [tradingview.com](https://www.tradingview.com)
+- Alle benötigten **Croc-Indikatoren** müssen dem Chart hinzugefügt sein (Lochstreifen, MSI, Cloud etc.)
+- Du brauchst das Pine Skript `Croc Vibes by Telgos` in der aktuellen Version (unter Mozilla Public License 2.0)
+
+---
+
+## ✨ Schritt 1: Skript in TradingView einfügen
+
+1. Öffne deinen TradingView-Chart (z. B. S&P 500, Nasdaq, BTC …)
+2. Öffne unten den Reiter **„Pine Editor“**
+3. Füge das vollständige Skript `Croc Vibes by Telgos` ein
+4. Klicke oben auf **„Speichern“** → gib dem Skript einen Namen
+5. Klicke auf **„Zum Chart hinzufügen“**
+
+Du siehst nun je nach Marktlage **bunte Labels, Punkte, Marken und Signale** direkt im Chart.
+
+---
+
+## 🧩 Schritt 2: Eingaben korrekt zuweisen (Pflicht)
+
+Ohne diesen Schritt **funktioniert das Skript nicht** – du siehst keine Signale.
+
+### 🔧 So geht’s:
+
+1. Bewege die Maus über den Skript-Namen im Chart  
+2. Klicke auf das ⚙️ **Zahnrad-Symbol** → gehe zum Reiter **„Eingaben“**
+3. Dort siehst du 4 Gruppen:
+
+| Gruppe                  | Bedeutung                                                                |
+|-------------------------|---------------------------------------------------------------------------|
+| **Chart-Signale**        | Verknüpfung zu Croc-Punkten wie Cloud, Pearl, BGRL usw.                  |
+| **Lochstreifen**         | Status, Trend, Welle, Kerzenfarbe → die Zahl in Klammern = Plot-Nummer   |
+| **MSI**                  | Bedingungen für Stephan Setup                                            |
+| **Allgemeine Einstellungen** | Steuerung von Labels, Marken, Abständen                            |
+
+> 📌 **Beispiel:** „Trend (3) Grün“ → ist der **dritte Plot** des „Trend“-Indikators.  
+> Wichtig: Die Croc-Indikatoren **müssen auf dem Chart liegen**, sonst erscheinen sie nicht zur Auswahl.
+> Hier ein Link auf Video zur Zuweisung der Variablen: https://git.cygos.synology.me/Telgos/Croc_Vibes/raw/branch/main/Schritt2.mp4
+---
+
+## ⚙️ Schritt 3: Konfiguration (optional)
+
+Im Reiter **„Allgemeine Einstellungen“** kannst du das Verhalten des Skripts anpassen:
+
+| Option                              | Wirkung                                                                 |
+|-------------------------------------|-------------------------------------------------------------------------|
+| ✅ **Blaue Punkte Labels anzeigen**  | Aktiviert Hinweise wie „Ein Hoch kommt noch“ oder „Tief verpasst“      |
+| 🔢 **Swing-Lookback**                | Bestimmt, wie viele Kerzen zurück für Swing-Bewertungen geschaut wird   |
+| 📐 **Label Abstand (ATR Multiplikator)** | Beeinflusst vertikalen Abstand der Labels zu den Kerzen               |
+
+---
+
+## 🔔 Schritt 4: Alerts einrichten (empfohlen)
+
+1. Klicke im Chart oben auf das Glocken-Symbol 🔔
+2. Wähle dein Skript als Bedingung aus
+3. Wähle z. B. **„Pearl Long“** oder **„Stephan Setup“**
+4. Definiere deine Nachricht (z. B. „🚀 Croc Long-Signal aktiv!“)
+5. Lege Benachrichtigungsmethode fest (Push, E-Mail, Webhook …)
+6. Speichern ✅
+
+---
+
+## ✅ Enthaltene Signale (Auswahl)
+
+| Signaltyp           | Bedeutung / Logik                                                                 |
+|---------------------|------------------------------------------------------------------------------------|
+| **Pearl Diver**      | Basissignal bei roten Bedingungen + Kerzenfarbe-Kombi                             |
+| **Oyster Farmer**    | Gegenstück für Short                                                              |
+| **Ulti Rally**       | Starker bullischer Ausbruch mit Cloud & Setup                                     |
+| **Stephan Setup**    | Kombi aus MSI‑Filter + Cloud‑Komponenten (z. B. BGRL, Red Devil, Rocket etc.)     |
+| **BGRL**             | Black Green Rocket Long (Lochstreifen + grüner Punkt bei schwarzer Kerze)         |
+| **Blauer Punkt erfüllt** | Bestätigung von offenen Punkten basierend auf Swing-Bedingungen              |
+
+---
+
+## 🧾 Lizenz (Mozilla Public License 2.0)
+
+Der Code unterliegt der [MPL 2.0](https://mozilla.org/MPL/2.0/).
+
+| Du darfst …                           | Du musst …                                            |
+|--------------------------------------|-------------------------------------------------------|
+| ✅ frei nutzen, verändern, veröffentlichen | ⚠️ Lizenztext erhalten                                |
+| ✅ auch kommerziell verwenden         | ⚠️ Änderungen ebenfalls unter MPL 2.0 stellen         |
+| ✅ Teile in eigene Projekte einbauen  | 🔒 Nur der Script-Teil muss offengelegt werden         |
+
+---
+
+## 🧠 Tipp zum Schluss
+
+Wenn du beim ersten Setup keine Signale siehst:
+- Prüfe, ob **alle Quellen korrekt zugewiesen** sind
+- Achte auf **identische Timeframes**
+- Nutze **normale Candles**, kein Heikin Ashi (verändert Setup-Verhalten)
+- Aktiviere im Zweifel **nur einzelne Gruppen (z. B. nur Pearl)** zur Fehlersuche
+
+---
+
+by Telgos – bereitgestellt ohne Support  
+Für Feedback, Erweiterungen oder Bugfixes: bitte eigene Forks nutzen oder melden.

docs/Vibes_Blues_Beschreibung.md

@@ -0,0 +1,45 @@
+# Vibes + Blues (Kombi-Version)  
+
+Die **Kombi-Version** fasst den Hauptindikator *Croc Vibes* und das *Blues Add-on* in einem einzigen Script zusammen.  
+
+---
+
+## Hintergrund  
+
+TradingView erlaubt nur eine begrenzte Anzahl an gleichzeitig aktiven Indikatoren.  
+Damit nicht zwei Slots für Croc Vibes und das Blues Add-on belegt werden, wurde eine kombinierte Version erstellt.  
+
+---
+
+## Inhalt  
+
+Die Kombi-Version enthält:  
+- Alle Funktionen des Hauptindikators **Croc Vibes**  
+- Alle Funktionen des **Blues Add-ons**  
+
+Da das Blues Add-on in **Pine v6** geschrieben ist, basiert auch die Kombi-Version technisch auf Pine v6.  
+Diese Kombi-Version bildet künftig die **Basis für Weiterentwicklungen und Fehlerkorrekturen**, da es sonst zu aufwendig wäre, mehrere parallele Varianten zu pflegen.  
+
+---
+
+## Beispiel  
+
+![Beispiel: Vibes + Blues Kombi](./img/croc_vibes_example.png)  
+
+---
+
+## Installation  
+
+1. Öffne den Code der Kombi-Version.  
+2. Kopiere den gesamten Code.  
+3. Öffne den **Pine-Editor** in deinem TradingView-Chart.  
+4. Füge den Code ein und klicke auf **"Zum Chart hinzufügen"**.  
+
+---
+
+## Hinweis  
+
+Die Kombi-Version wird nur gepflegt, solange die Indikatoren-Limitierung in TradingView ein Thema ist.  
+Sollte André im Croc 3.0 selbst mehr Label- und Signaloptionen integrieren, ist diese Variante möglicherweise nicht mehr notwendig. 🚀  
+
+**Wichtiger Hinweis:** Dieses Skript wird ohne Support bereitgestellt. Jeder nutzt den Code auf eigene Verantwortung.