Docs: Disclaimer + Konsistenz (temporäres Community-Hilfsskript, Anfänger-Fokus, keine zentrale Anlaufstelle)

LICENSE.md

@@ -1,3 +1,16 @@
+---
+⚠️ **Wichtiger Hinweis** ⚠️
+
+**Croc Vibes** ist ein *temporäres Community-Hilfsskript*, insbesondere für **Anfänger**.
+Es ist **keine temporäres Community-Hilfsskript** und **kein Ersatz** für den offiziellen Indikator.
+
+Der originale **Croc-Indikator** von André ist ein **kommerzielles Produkt** und kann erworben werden.
+Dieses Projekt **verfolgt keine wirtschaftlichen Interessen** – es ist ein **Beitrag von Telgos für die Community**.
+
+Das Hilfsskript stellt zusätzliche **Labels**, **Alerts** sowie eine **Speziallogik für offene Blaue** bereit, um Einstieg und Verständnis zu erleichtern.
+Sobald im Forum das **direkte Teilen von Skripten** möglich ist, wird dieses Hilfsskript eingestellt, damit die Community wieder **geschlossen im Forum** bleibt.
+---
+
 # Lizenz  
 
 Dieses Projekt steht unter der **Mozilla Public License 2.0 (MPL-2.0)**.  

README.md

@@ -1,26 +1,111 @@
 ---
-⚠️ **Wichtiger Hinweis** ⚠️  
-
-**Croc Vibes** ist ein *temporäres Community-Hilfsskript*, vor allem für **Anfänger** gedacht.  
-Es handelt sich **nicht** um eine zentrale Anlaufstelle oder einen Ersatz für den offiziellen Indikator.  
-
-Der originale **Croc-Indikator** von André ist ein **kommerzielles Produkt** und kann erworben werden.  
-Dieses Projekt **verfolgt keine wirtschaftlichen Interessen**.  
-
-Croc Vibes stellt der Community zusätzliche **Labels, Alerts** sowie eine **Speziallogik für offene Blaue** zur Verfügung, um den Einstieg und das Verständnis zu erleichtern.  
-
-👉 Sobald im Forum wieder das direkte Teilen von Skripten möglich ist, wird dieses Hilfsskript eingestellt, sodass die Community gesammelt und geschlossen im Forum bleibt.  
-
-**Croc Vibes ist somit lediglich ein Beitrag von Telgos für die Community.**
----
 
-# Croc Vibes – Community-Hilfsskript
+![Croc Vibes Banner](./docs/img/croc_vibes_banner.png)
 
-Dieses Projekt ist ein *temporäres Hilfsskript* für die Community, insbesondere für Anfänger, die Croc-Signale nachvollziehen wollen.  
+![TradingView](https://img.shields.io/badge/Platform-TradingView-blue?logo=tradingview&logoColor=white)
+![License: MPL-2.0](https://img.shields.io/badge/License-MPL%202.0-green)
+![Status: Community Script](https://img.shields.io/badge/Status-Community%20Script-orange)
 
-Es ergänzt Andrés kommerziellen Indikator nicht, sondern bietet zusätzliche Lernhilfen in Form von:
+⚠️ **Wichtiger Hinweis** ⚠️
-- **Labels** für eine klarere Signal-Erkennung  
+**Croc Vibes** ist ein *temporäres Community-Hilfsskript*, insbesondere für **Anfänger**.  
-- **Alerts**, um Setups besser verfolgen zu können  
+Es ist **keine temporäres Community‑Hilfsskript** und **kein Ersatz** für den offiziellen Indikator.
-- **Speziallogik für offene Blaue**, um diese auch für Einsteiger greifbar zu machen  
+Der originale **Croc‑Indikator** von André ist ein **kommerzielles Produkt** und kann erworben werden.  
+Dieses Projekt **verfolgt keine wirtschaftlichen Interessen** – es ist ein **Beitrag von Telgos für die Community**.
+Das Hilfsskript stellt zusätzliche **Labels**, **Alerts** sowie eine **Speziallogik für offene Blaue** bereit, um Einstieg und Verständnis zu erleichtern.  
+Sobald im Forum das **direkte Teilen von Skripten** möglich ist, wird dieses Hilfsskript eingestellt, damit die Community wieder **geschlossen im Forum** bleibt.
 
-Das Skript kann frei genutzt werden, bis eine direkte Post-Möglichkeit im Forum existiert.
+---
+
+## 📌 Aktuelle Version
+
+➡️ **[Croc Vibes v3.8.0 (Kombi-Version)](./indicators/croc_vibes_3.8.0.pine)**  
+
+- Enthält die Blues-Integration (Start/Aktiv/Erfüllt/Wolkenbruch)  
+- Neue **Alert-Combo** (bis zu 5 Signale, UND/ODER, Auto-ODER bei beiden Blues)  
+- Screener/Backtest-Plots für aktive Blues  
+
+👉 Details zu allen Änderungen siehe [CHANGELOG.md](./docs/CHANGELOG.md)
+
+---
+
+## Community-Hilfsskript  
+
+**Croc Vibes** ist ein *temporäres Community-Hilfsskript*.  
+Es wurde entwickelt, weil der Croc 3.0 nur eine begrenzte Anzahl an Labels ausgibt und wir Anfänger (bin auch erst seit Juli aktiv 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. 🚀  
+
+---
+
+## Komponenten  
+
+Dieses Projekt besteht aus den folgenden Skripten:  
+
+| Script         | Rolle              | Pine | Status |
+|----------------|--------------------|------|--------|
+| Croc Vibes     | Hauptindikator     | v5   | keine Weiterentwicklung |
+| Blues Add-on   | Blaue-Punkt-Addon  | v6   | **deprecated** (ab v3.8.0 integriert) |
+| Vibes + Blues  | Kombi-Version      | v6   | **Basis für Updates – v3.8.0** ✅ |  
+
+* **[Croc Vibes (Hauptindikator)](./docs/Croc_Vibes_Beschreibung.md)**  
+* **[Blues Add-on](./docs/Blues_Addon_Beschreibung.md)** *(deprecated)*  
+* **[Vibes + Blues (Kombi-Version)](./docs/Vibes_Blues_Beschreibung.md)**  
+
+### Warum eine Kombi-Version?  
+TradingView erlaubt - je nach Lizenz - nur eine begrenzte Anzahl an gleichzeitig aktiven Indikatoren.  
+Damit Anwender nicht zwei Slots für Croc Vibes und das Blues Add-on opfern müssen, gibt es zusätzlich eine **Kombi-Version (Vibes + Blues)**.  
+Diese bildet auch die **Basis für Weiterentwicklungen und Fehlerkorrekturen**.  
+
+> **Neu in v3.8.0:** Blues-Logik vollständig integriert (Start/Aktiv/Erfüllt/Wolkenbruch), konfigurierbare **Alert‑Combo** (bis zu 5 Signale, UND/ODER; Auto‑ODER bei beiden Blues), sowie **Screener‑Plots** für aktive Blues.
+
+---
+
+## Installation  
+
+1. Öffne den gewünschten Indikator-Code im Ordner `indicators/`.  
+2. Kopiere den gesamten Code aus der Datei.  
+3. Öffne den **Pine-Editor** in deinem TradingView-Chart.  
+4. Füge den Code ein und klicke auf **"Zum Chart hinzufügen"**.  
+
+👉 Details und Stolpersteine siehe [Installation.md](./docs/Installation.md).  
+
+---
+
+## FAQ  
+
+👉 Häufige Fragen findest du in der [FAQ.md](./docs/FAQ.md).  
+- Warum muss ich meine Variablen nach einem Update neu zuordnen?  
+- Warum kann Croc Vibes nicht im Pinescreener verwendet werden?  
+- Wie funktioniert die **Alert‑Combo**?  
+- Wie ordne ich die **input.source**-Signale korrekt zu?  
+
+---
+
+## Beispiel  
+
+![Beispiel: Croc Vibes mit Blues Add-on](./docs/img/croc_vibes_example.png)  
+
+---
+
+## Video-Anleitung (Schritt 2: Variablen zuweisen)  
+
+Dieses Video zeigt **nur Schritt 2 der Installation** – die **Zuweisung der input.source-Variablen**.  
+
+📺 [Direkt im Browser ansehen](https://share.telgos.de/api/public/dl/6eo9V2cC?inline=true)  
+⬇️ [Download über Share-Link](https://share.telgos.de/share/6eo9V2cC)  
+
+*(Das Video liegt extern, damit das Repository schlank bleibt.)*  
+
+---
+
+## Hinweis zur Nutzung  
+
+Croc Vibes ist ein Community-Hilfsskript und nicht offiziell von André.  
+Es gibt keinen Anspruch auf Vollständigkeit oder Support – jeder nutzt den Code auf eigene Verantwortung.  
+
+---
+
+## Lizenz  
+
+Dieses Projekt steht unter der [Mozilla Public License 2.0](https://mozilla.org/MPL/2.0/).  
+Siehe auch [LICENSE.md](./LICENSE.md).

docs/Blues_Addon_Beschreibung.md

@@ -1,17 +1,7 @@
----
+# Blues Add-on
-⚠️ **Wichtiger Hinweis** ⚠️  
+Dieses Projekt richtet sich **insbesondere an Anfänger** und erleichtert die Nutzung durch zusätzliche Labels, Alerts und eine Speziallogik für offene Blaue.
 
-**Croc Vibes Blues Add-on** ist Teil des *Community-Hilfsskripts* für Anfänger.  
-Keine zentrale Anlaufstelle, sondern eine Lernhilfe.
----
 
-# Blues Add-on – Community-Hilfsskript
+> ⚠️ **Hinweis (deprecated ab v3.8.0):**  
-
+> Das Blues-Add-on ist ab Version **3.8.0** vollständig im Hauptindikator integriert und wird nicht mehr separat weiterentwickelt.  
-Das Blues Add-on ergänzt das Hilfsskript Croc Vibes mit:
+> Bitte die **Kombi-Version (Vibes + Blues)** verwenden.
-- erweiterten Labels,  
-- Alerts,  
-- und einer Logik für offene Blaue,  
-
-um Anfängern die Nutzung und Interpretation der Signale zu erleichtern.  
-
-Auch dieses Add-on ist nur vorübergehend gedacht. Sobald das Forum wieder Skripte unterstützt, wird ausschließlich das Forum genutzt.

docs/Croc_Vibes_Beschreibung.md

@@ -1,13 +1,30 @@
----
-⚠️ **Wichtiger Hinweis** ⚠️  
 
-**Croc Vibes** ist ein *temporäres Community-Hilfsskript*, insbesondere für Anfänger.  
+# Croc Vibes – Beschreibung (v3.8.0, Pine v6)
-Es handelt sich nicht um eine zentrale Anlaufstelle, sondern um eine Unterstützung für die Community.  
+Dieses Projekt richtet sich **insbesondere an Anfänger** und erleichtert die Nutzung durch zusätzliche Labels, Alerts und eine Speziallogik für offene Blaue.
----
 
-# Beschreibung – Croc Vibes Hilfsskript
 
-Croc Vibes bietet der Community eine Möglichkeit, Croc-Signale auch ohne den kommerziellen Indikator von André nachzuvollziehen.  
+## Überblick
-Der Fokus liegt auf **Anfängern**, die mit Labels, Alerts und spezieller Logik für offene Blaue einen leichteren Einstieg erhalten.  
+**Croc Vibes** ist ein Community-Script zum Croc-Trading-System.  
+Ab **v3.8.0** ist die **Blues-Logik** vollständig integriert (inkl. Alerts), zusätzlich gibt es eine **Alert‑Combo** und **Screener‑Plots**.
 
-Es ist kein Ersatz für den offiziellen Indikator. Sobald das Forum direkte Pine-Script-Posts erlaubt, entfällt die Notwendigkeit dieses Hilfsskripts.  
+## Kernfunktionen
+- Pearl Diver, Ulti Rally, Stephan Setup, BGRL, Rotes Kreuz
+- **Blues-Logik mit Referenzlinie** („Ein Hoch/Tief kommt noch“)
+  - Zustände: **Start**, **Aktiv**, **Erfüllt**, **Wolkenbruch**
+  - Linien werden bis zur Erfüllung/Invalidierung rechts fortgeführt
+- **Alert‑Combo Panel**: bis zu **5** Signale frei kombinierbar
+  - UND/ODER schaltbar; **Auto‑ODER**, wenn beide Blues (Long & Short) gewählt sind
+- **Screener/Backtest-Shapes** für „Blues aktiv“ (Long/Short)
+
+## Hinweise zu Blues
+- „**Ein Hoch kommt noch**“ wird **nur in grüner Wolke** markiert.
+- „**Ein Tief kommt noch**“ wird **nur in roter Wolke** markiert.
+
+## Alerts (Auswahl)
+- Pearl Long, Pearl Short, Ulti, Stephan, BGRL, Rotes Kreuz
+- Blues: **Start**, **Aktiv**, **Erfüllt**, **Wolkenbruch**
+- **Alert‑Combo**: eigene Auswahl aus bis zu 5 Signalen (UND/ODER)
+
+## Display
+- Einheitliche Labelgrößen (size: `small`)
+- Zusätzliche `plotshape` für aktive Blues (Screener-Kompatibilität)

docs/FAQ.md

@@ -1,22 +1,55 @@
----
+# Croc Vibes – FAQ
-⚠️ **Wichtiger Hinweis** ⚠️  
+Dieses Projekt richtet sich **insbesondere an Anfänger** und erleichtert die Nutzung durch zusätzliche Labels, Alerts und eine Speziallogik für offene Blaue.
+
+
+Denn die immer wiederkehrenden Fragen kosten viel zu viel *unwiederbringliche Lebenszeit*. 😉
 
-**Croc Vibes** ist ein *temporäres Community-Hilfsskript*, insbesondere für Anfänger.  
-Es ersetzt nicht Andrés kommerziellen Indikator.
 ---
 
-# FAQ – Croc Vibes Community-Hilfsskript
+### 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.
 
-**Ist Croc Vibes der offizielle Croc-Indikator?**  
+---
-Nein. Das ist ein Community-Hilfsskript. Der originale Croc-Indikator von André ist kommerziell erhältlich.  
 
-**Warum gibt es dieses Skript überhaupt?**  
+### Warum kann Croc Vibes nicht im Pinescreener verwendet werden?
-Weil im Forum kein Pine Script direkt gepostet werden kann. Damit Anfänger und Community-Mitglieder trotzdem mit Skripten arbeiten können, wurde Croc Vibes bereitgestellt.  
+Das temporäre Community-Hilfsskript **Croc Vibes** entstand nur, weil der Croc 3.0 eine begrenzte Anzahl an Labels ausgibt und wir Anfänger 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.
 
-**Kann ich Croc Vibes dauerhaft nutzen?**  
+---
-Es ist nur eine Übergangslösung. Sobald das Forum Skripte wieder aufnehmen kann, wird Croc Vibes eingestellt.  
 
-**Welche Vorteile hat das Hilfsskript?**  
+### Ich sehe in der Auswahl mehrere Werte (z. B. Kerzenfarbe oder Wolke). Woher weiß ich, welcher richtig ist?
-- Zusätzliche Labels und Alerts  
+Die Croc-Indikatoren liefern mehrere interne Werte (z. B. Kerze 1 = Grün, Kerze 2 = Schwarz, Kerze 3 = Rot).  
-- Speziallogik für offene Blaue  
+In der Signal-Auswahl musst du den jeweils passenden Wert **manuell zuordnen**.  
-- Leichterer Einstieg für Anfänger  
+**Die Zahl steht für die Reihenfolge von oben** – also der wievielte Parameter zugeordnet werden muss.  
+📖 Siehe den Installations-Guide – im Video zu Schritt 2 wird die Zuweisung gezeigt.
+
+---
+
+### Warum sehe ich „Ein Hoch kommt noch“ / „Ein Tief kommt noch“ nicht immer?
+Aktuelle Regel (ab v3.8.0):
+- „**Ein Hoch kommt noch**“ wird **nur in grüner Wolke** markiert.
+- „**Ein Tief kommt noch**“ wird **nur in roter Wolke** markiert.
+
+---
+
+### Wie richte ich die Alert‑Combo ein?
+Im Eingabe‑Reiter unter **ALERT‑COMBO**:
+- bis zu **5** Signale wählbar
+- **UND/ODER** schaltbar (Häkchen „Signale nicht kombinieren“)
+- **Auto‑ODER**, wenn **beide Blues** (Long & Short) ausgewählt sind
+
+Zusätzlich kannst du einzelne System‑Alerts in TradingView über **„Alarm hinzufügen“** auf die jeweiligen Bedingungen legen (z. B. „Blues: … (Erfüllt)“).
+
+---
+
+### Welche TradingView-Version brauche ich für Croc Vibes?
+
+Das hängt von der Anzahl der gleichzeitig laufenden Indikatoren ab:  
+
+- **Essentials** reicht in der Regel aus, wenn du nur **Croc 3.0 + Croc Vibes** parallel laufen lassen möchtest.  
+- Falls du viele zusätzliche Indikatoren/Setups einbindest, kann ein höherer Plan sinnvoll sein (mehr gleichzeitige Indikatoren-Slots).  
+
+👉 Es geht also **nicht** darum, dass Pine Script nur in der „Professional-Version“ funktioniert – Pine läuft in allen TV-Plänen. Entscheidend ist die maximale Zahl an Indikatoren, die dein Abo erlaubt.

docs/Installation.md

@@ -1,4 +1,6 @@
 # Installation
+Dieses Projekt richtet sich **insbesondere an Anfänger** und erleichtert die Nutzung durch zusätzliche Labels, Alerts und eine Speziallogik für offene Blaue.
+
 
 ## Dateien
 `indicators/` – Pine Scripts