B2BIndicators/readme.md

# 🇮🇩 Versi Bahasa Indonesia

# B2BIndicator (M1 Hybrid Monitor Panel)

## 📖 Deskripsi
**B2BIndicator** adalah indikator kustom untuk MetaTrader 5 (MQL5) yang dirancang untuk memantau kondisi pasar secara *real-time* dan menghasilkan sinyal trading BUY/SELL yang sangat terfilter. Indikator ini menggabungkan beberapa indikator teknikal populer seperti Bollinger Bands (Multi-Period), Moving Averages, Parabolic SAR, RSI, ADX, dan ATR ke dalam sebuah sistem logika hybrid. 

Selain memberikan sinyal, indikator ini juga menampilkan **Panel Monitor On-Chart** yang sangat informatif, mencakup nilai indikator, sisa waktu candle, harga *Daily Open*, selisih pips, hingga proyeksi jarak *Stop Loss* dan *Take Profit* berdasarkan ATR.

## ✨ Fitur Utama
- **Panel Monitor Lengkap**: Menampilkan status sinyal, nilai BB1 & BB2, EMA, SMA, RSI, ADX, *Daily Open*, *Open Pips*, dan *countdown* candle.
- **Sistem Sinyal 4-Layer (Hybrid)**: Sinyal hanya dianggap valid jika 4 lapisan logika (Trend, Momentum, Volatilitas, dan Cross) terpenuhi secara bersamaan.
- **Proyeksi SL & TP Dinamis**: Menghitung estimasi jarak *Stop Loss* dan *Take Profit* secara otomatis menggunakan indikator ATR (*Average True Range*).
- **Alert Otomatis**: Memberikan notifikasi *pop-up* dan suara ketika sinyal BUY atau SELL yang valid terbentuk di awal candle baru.
- **Multi-Timeframe**: Meskipun dioptimalkan dan dinamai untuk M1, indikator ini dapat digunakan di *timeframe* apa pun.

## ⚙️ Parameter Input
### Risk Settings
- `InpATR_Multiplier_SL` (Default: 2.0): Pengali ATR untuk menghitung jarak *Stop Loss*.
- `InpATR_Multiplier_TP` (Default: 3.0): Pengali ATR untuk menghitung jarak *Take Profit*.

### Indicator Settings
- `InpBB1_Period` & `InpBB1_Deviation` (200, 1.3): Periode dan deviasi untuk Bollinger Bands jangka panjang (VWAP Simulation).
- `InpBB2_Period` & `InpBB2_Deviation` (20, 2.3): Periode dan deviasi untuk Bollinger Bands jangka pendek.
- `InpEMA8_Period`, `InpSMA21_Period`, `InpEMA50_Period`: Periode untuk *Moving Averages*.
- `InpPSAR_Step` & `InpPSAR_Maximum`: Parameter untuk *Parabolic SAR*.
- `InpRSI_Period` & `InpADX_Period`: Periode untuk RSI dan ADX.

## 🧠 Logika Sinyal (Signal Logic)
Indikator ini menggunakan 4 lapisan (*Layer*) untuk memvalidasi sinyal:
1. **L1 - Bollinger Bands Cross**: Terjadi perpotongan (*crossover*) antara garis tengah BB2 terhadap garis *Upper*, *Mid*, atau *Lower* dari BB1.
2. **L2 - Moving Average Trend**: 
   - **BUY**: EMA 8 > SMA 21 dan Harga *Close* > EMA 50.
   - **SELL**: EMA 8 < SMA 21 dan Harga *Close* < EMA 50.
3. **L3 - Parabolic SAR**: 
   - **BUY**: Titik PSAR berada di bawah *Low* candle.
   - **SELL**: Titik PSAR berada di atas *High* candle.
4. **L4 - VWAP Simulation**: 
   - **BUY**: Harga *Close* berada di atas garis tengah BB1 (VWAP Sim).
   - **SELL**: Harga *Close* berada di bawah garis tengah BB1 (VWAP Sim).

**Kondisi Valid**: Sinyal BUY atau SELL hanya akan muncul dan memicu *alert* jika **KEEMPAT** kondisi di atas (L1, L2, L3, dan L4) terpenuhi secara bersamaan.

## 🛠️ Cara Instalasi
1. Buka **MetaEditor** di MetaTrader 5.
2. Buat file baru (Indicator) atau buka file `.mq5` yang sudah ada.
3. Salin seluruh kode `B2BIndicator.mq5` dan tempel ke dalam file tersebut.
4. Klik **Compile** (atau tekan `F7`).
5. Buka MetaTrader 5, temukan indikator `B2BIndicator` di jendela **Navigator**.
6. Tarik (*drag*) indikator ke chart yang diinginkan.

---
---

# 🇬🇧 English Version

# B2BIndicator (M1 Hybrid Monitor Panel)

## 📖 Description
**B2BIndicator** is a custom indicator for MetaTrader 5 (MQL5) designed to monitor market conditions in real-time and generate highly filtered BUY/SELL trading signals. It combines multiple popular technical indicators—such as Multi-Period Bollinger Bands, Moving Averages, Parabolic SAR, RSI, ADX, and ATR—into a comprehensive hybrid logic system.

In addition to generating signals, the indicator features a highly informative **On-Chart Monitor Panel**, displaying indicator values, candle countdown, Daily Open price, pip difference, and dynamic Stop Loss/Take Profit distance projections based on ATR.

## ✨ Key Features
- **Comprehensive Monitor Panel**: Displays signal status, BB1 & BB2 values, EMAs, SMAs, RSI, ADX, Daily Open, Open Pips, and candle countdown.
- **4-Layer Hybrid Signal System**: Signals are only considered valid if 4 layers of logic (Trend, Momentum, Volatility, and Cross) are met simultaneously.
- **Dynamic SL & TP Projection**: Automatically calculates estimated Stop Loss and Take Profit distances using the Average True Range (ATR) indicator.
- **Automated Alerts**: Provides pop-up and sound notifications when a valid BUY or SELL signal forms at the opening of a new candle.
- **Multi-Timeframe Support**: Although optimized and named for M1, the indicator can be applied to any timeframe.

## ⚙️ Input Parameters
### Risk Settings
- `InpATR_Multiplier_SL` (Default: 2.0): ATR multiplier for calculating Stop Loss distance.
- `InpATR_Multiplier_TP` (Default: 3.0): ATR multiplier for calculating Take Profit distance.

### Indicator Settings
- `InpBB1_Period` & `InpBB1_Deviation` (200, 1.3): Period and deviation for the long-term Bollinger Bands (VWAP Simulation).
- `InpBB2_Period` & `InpBB2_Deviation` (20, 2.3): Period and deviation for the short-term Bollinger Bands.
- `InpEMA8_Period`, `InpSMA21_Period`, `InpEMA50_Period`: Periods for the Moving Averages.
- `InpPSAR_Step` & `InpPSAR_Maximum`: Parameters for the Parabolic SAR.
- `InpRSI_Period` & `InpADX_Period`: Periods for RSI and ADX.

## 🧠 Signal Logic
The indicator uses 4 layers to validate a signal:
1. **L1 - Bollinger Bands Cross**: A crossover occurs between the BB2 Middle line and the Upper, Middle, or Lower lines of BB1.
2. **L2 - Moving Average Trend**: 
   - **BUY**: EMA 8 > SMA 21 and Close Price > EMA 50.
   - **SELL**: EMA 8 < SMA 21 and Close Price < EMA 50.
3. **L3 - Parabolic SAR**: 
   - **BUY**: PSAR dots are below the candle Low.
   - **SELL**: PSAR dots are above the candle High.
4. **L4 - VWAP Simulation**: 
   - **BUY**: Close Price is above the BB1 Middle line (VWAP Sim).
   - **SELL**: Close Price is below the BB1 Middle line (VWAP Sim).

**Validation Condition**: A BUY or SELL signal will only appear and trigger an alert if **ALL FOUR** conditions above (L1, L2, L3, and L4) are met simultaneously.

## 🛠️ Installation Guide
1. Open **MetaEditor** in MetaTrader 5.
2. Create a new file (Indicator) or open an existing `.mq5` file.
3. Copy the entire `B2BIndicator.mq5` code and paste it into the file.
4. Click **Compile** (or press `F7`).
5. Open MetaTrader 5, locate the `B2BIndicator` in the **Navigator** window.
6. Drag and drop the indicator onto your desired chart.

---
⚠️ **Disclaimer / Catatan Penting**: 
*Indikator ini hanyalah alat bantu analisis teknikal. Tidak ada indikator yang dapat menjamin keuntungan 100% di pasar finansial. Selalu gunakan manajemen risiko yang baik (money management) dan lakukan pengujian (backtesting/demo) sebelum menggunakan indikator ini pada akun real.*