From a042f7be71c861fdab406f9d41da7c5586c445aa Mon Sep 17 00:00:00 2001 From: Telgos Date: Thu, 28 Aug 2025 08:20:35 +0200 Subject: [PATCH] =?UTF-8?q?Docs:=20Disclaimer=20+=20Konsistenz=20(tempor?= =?UTF-8?q?=C3=A4res=20Community-Hilfsskript,=20Anf=C3=A4nger-Fokus,=20kei?= =?UTF-8?q?ne=20zentrale=20Anlaufstelle)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- LICENSE.md | 13 ++++ README.md | 127 ++++++++++++++++++++++++++----- docs/Blues_Addon_Beschreibung.md | 20 ++--- docs/Croc_Vibes_Beschreibung.md | 35 ++++++--- docs/FAQ.md | 63 +++++++++++---- docs/Installation.md | 2 + 6 files changed, 200 insertions(+), 60 deletions(-) diff --git a/LICENSE.md b/LICENSE.md index 482eab7..371cdd6 100644 --- a/LICENSE.md +++ b/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)**. diff --git a/README.md b/README.md index 2704093..143dfd7 100644 --- a/README.md +++ b/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: -- **Labels** für eine klarere Signal-Erkennung -- **Alerts**, um Setups besser verfolgen zu können -- **Speziallogik für offene Blaue**, um diese auch für Einsteiger greifbar zu machen +⚠️ **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. -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). diff --git a/docs/Blues_Addon_Beschreibung.md b/docs/Blues_Addon_Beschreibung.md index b3cd24c..61fc487 100644 --- a/docs/Blues_Addon_Beschreibung.md +++ b/docs/Blues_Addon_Beschreibung.md @@ -1,17 +1,7 @@ ---- -⚠️ **Wichtiger Hinweis** ⚠️ +# Blues Add-on +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 - -Das Blues Add-on ergänzt das Hilfsskript Croc Vibes mit: -- 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. +> ⚠️ **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. +> Bitte die **Kombi-Version (Vibes + Blues)** verwenden. diff --git a/docs/Croc_Vibes_Beschreibung.md b/docs/Croc_Vibes_Beschreibung.md index e0b425c..527856a 100644 --- a/docs/Croc_Vibes_Beschreibung.md +++ b/docs/Croc_Vibes_Beschreibung.md @@ -1,13 +1,30 @@ ---- -⚠️ **Wichtiger Hinweis** ⚠️ -**Croc Vibes** ist ein *temporäres Community-Hilfsskript*, insbesondere für Anfänger. -Es handelt sich nicht um eine zentrale Anlaufstelle, sondern um eine Unterstützung für die Community. ---- +# Croc Vibes – Beschreibung (v3.8.0, Pine v6) +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. -Der Fokus liegt auf **Anfängern**, die mit Labels, Alerts und spezieller Logik für offene Blaue einen leichteren Einstieg erhalten. +## Überblick +**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) diff --git a/docs/FAQ.md b/docs/FAQ.md index 4937d4f..1cd8b5d 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -1,22 +1,55 @@ ---- -⚠️ **Wichtiger Hinweis** ⚠️ +# Croc Vibes – FAQ +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?** -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. +### Warum kann Croc Vibes nicht im Pinescreener verwendet werden? +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?** -- Zusätzliche Labels und Alerts -- Speziallogik für offene Blaue -- Leichterer Einstieg für Anfänger +### Ich sehe in der Auswahl mehrere Werte (z. B. Kerzenfarbe oder Wolke). Woher weiß ich, welcher richtig ist? +Die Croc-Indikatoren liefern mehrere interne Werte (z. B. Kerze 1 = Grün, Kerze 2 = Schwarz, Kerze 3 = Rot). +In der Signal-Auswahl musst du den jeweils passenden Wert **manuell zuordnen**. +**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. diff --git a/docs/Installation.md b/docs/Installation.md index 0cc1b96..ab36066 100644 --- a/docs/Installation.md +++ b/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