FBO Helper Indicator for MetaTrader 5

نمای کلی

اندیکاتور FBO Helper یک ابزار پیشرفته برای استراتژی Fake Breakout (شکست ساختگی) در متاتریدر 5 است. این اندیکاتور به معامله‌گران کمک می‌کند تا نقاط ورود و خروج را بر اساس شکست‌های ساختگی سطوح کلیدی شناسایی کنند.

ویژگی‌های کلیدی

🎯 رسم خطوط دستی با قابلیت Magnet

• رسم خطوط سقف (High) و کف (Low) با کلیک روی کندل‌ها
• قابلیت Magnetic Drawing: خط به‌طور خودکار به بالاترین High یا پایین‌ترین Low در محدوده مشخص (پیش‌فرض: 5 کندل) می‌چسبد
• میانبرهای کیبورد: H برای High، L برای Low
• قابلیت Undo برای حذف آخرین خط رسم‌شده

📊 تشخیص بریک‌اوت معتبر

• تشخیص خودکار بریک‌اوت‌های معتبر
• هایلایت کردن محدوده بریک‌اوت با باکس رنگی
• تنظیمات قابل تنظیم برای حد بریک‌اوت

📈 رسم فیبوناچی با طول ثابت

• رسم خودکار یا دستی سطوح فیبوناچی
• طول ثابت بدون Ray: فیبوها با طول مشخص (پیش‌فرض: 5 کندل) رسم می‌شوند
• سطوح: Entry (1.0)، SL (0.0)، TP (3.0)، RC.TP (-2.0)
• لیبل‌های قابل تنظیم برای هر سطح
• پشتیبانی از معاملات Buy و Sell
• تغییر رنگ در حالت Recovery:
  • Buy تبدیل به Sell می‌شود (رنگ قرمز)
  • Sell تبدیل به Buy می‌شود (رنگ سبز)

🤖 حالت Auto با State Machine پیشرفته

سیستم Dual-Fibo

• همیشه 2 فیبوناچی به‌طور همزمان روی 2 نزدیک‌ترین خط همنوع رسم می‌شود
• Primary Fibo: روی نزدیک‌ترین خط (offset = 0)
• Secondary Fibo: روی خط بعدی با فاصله قابل تنظیم (پیش‌فرض: 10 کندل)

State Machine (4 حالت)

1. NONE: رسم 2 فیبو روی نزدیک‌ترین خطوط، مانیتورینگ بریک‌اوت
2. BREAKOUT:
   • بریک‌اوت رخ داده، منتظر بازگشت قیمت به Entry
   • اگر خط دوم بشکند قبل از بازگشت قیمت → حذف اولی و promote کردن دومی
3. ACTIVE: معامله فعال، مانیتورینگ SL/TP
4. RECOVERY: معامله ریکاوری فعال، مانیتورینگ SL/TP ریکاوری

رفتار هوشمند

• پس از بریک‌اوت: حذف خطوط و فیبوهای نوع مخالف
• اگر قیمت به Entry برنگردد و خط بعدی بشکند: حذف فیبو/خط/هایلایت قبلی
• خط شکسته‌شده تا زمان شکست خط بعدی باقی می‌ماند

⏱️ تایمر معامله با طراحی جدید

• طراحی جدید: آیکون ⏱ + شمارش معکوس به ثانیه
• رنگ‌بندی هوشمند:
  • 🔴 قرمز: وقتی بیش از 10 ثانیه باقی مانده
  • 🟢 سبز: وقتی 10 ثانیه یا کمتر باقی مانده
• سایز قابل تنظیم: فونت تایمر (پیش‌فرض: 30px)
• موقعیت قابل تنظیم: X و Y
• ریست خودکار پس از SL معامله اول
• قابل فعال/غیرفعال کردن

🎨 رابط کاربری (UI) با طراحی Grid

چیدمان 2×4 (2 ستون × 4 ردیف)

        Timer
┌──────────┬──────────┐
│   High   │  S.Fibo  │
├──────────┼──────────┤
│   Low    │  B.Fibo  │
├──────────┼──────────┤
│  Start   │  Reset   │
├──────────┼──────────┤
│   Undo   │  Clean   │
└──────────┴──────────┘
   Stop loss: X
   Breakout: X

دکمه‌ها

• High / Low: فعال‌سازی حالت رسم خط
• S.Fibo / B.Fibo: رسم دستی فیبوناچی Sell/Buy
• Start: فعال‌سازی حالت Auto
• Reset: ریست کامل اندیکاتور (حذف همه چیز + بازنشانی state)
• Undo: حذف آخرین خط
• Clean: حذف تمام خطوط، باکس‌ها و فیبوها

قابلیت‌های سفارشی‌سازی کامل

• عرض و ارتفاع دکمه‌ها
• فاصله افقی بین ستون‌ها
• فاصله عمودی بین ردیف‌ها
• سایز فونت دکمه‌ها
• رنگ دکمه در حالت‌های مختلف (Normal/Pressed/Active)
• رنگ متن دکمه‌ها

⚙️ تنظیمات اسپرد

• Use Spread for Entry/SL Monitoring (پیش‌فرض: true)
  • true: استفاده از Ask برای Buy و Bid برای Sell (واقع‌گرایانه)
  • false: همه چک‌ها با Bid (بدون در نظر گرفتن اسپرد)

🔔 هشدار تایم‌فریم قابل تنظیم

• متن هشدار قابل تنظیم
• موقعیت X و Y قابل تنظیم
• تایم‌فریم مورد نظر قابل تنظیم

تنظیمات پارامترها

محاسبه SL و Breakout

• Calculation Mode: Auto یا Manual
• Manual Mode: مقادیر ثابت به پوینت
• Auto Mode: محاسبه بر اساس ATR × ضریب
  • ATR Period: 20 کندل (پیش‌فرض)
  • SL Multiplier: 1.5 (پیش‌فرض)
  • Breakout = SL / 3

هایلایت

• تعداد کندل قبل از بریک‌اوت (پیش‌فرض: 1)
• تعداد کندل بعد از بریک‌اوت (پیش‌فرض: 1)
• رنگ باکس هایلایت (پیش‌فرض: Yellow)

خطوط

• رنگ، ضخامت و استایل خطوط High (پیش‌فرض: قرمز)
• رنگ، ضخامت و استایل خطوط Low (پیش‌فرض: آبی)
• محدوده Magnet برای رسم خطوط (پیش‌فرض: 5 کندل)

فیبوناچی

• رنگ فیبو Buy (پیش‌فرض: سبز)
• رنگ فیبو Sell (پیش‌فرض: قرمز)
• رنگ فیبو Recovery Buy→Sell (پیش‌فرض: قرمز)
• رنگ فیبو Recovery Sell→Buy (پیش‌فرض: سبز)
• طول فیبو به کندل (پیش‌فرض: 5)
• فاصله بین فیبوها (پیش‌فرض: 5)
• لیبل‌های قابل تنظیم برای سطوح مختلف
• قابلیت آپدیت لیبل‌ها پس از SL

Auto Mode

• Proximity: فاصله برای رسم فیبو روی خط بعدی (پیش‌فرض: 5000 پوینت)
• Use Spread: استفاده از اسپرد برای مانیتورینگ Entry/SL (پیش‌فرض: true)

تایمر

• فعال/غیرفعال (پیش‌فرض: false)
• مدت زمان به ثانیه (پیش‌فرض: 40)
• موقعیت X (پیش‌فرض: 100)
• موقعیت Y (پیش‌فرض: 100)
• سایز فونت (پیش‌فرض: 30)

هشدار تایم‌فریم

• فعال/غیرفعال (پیش‌فرض: true)
• تایم‌فریم (پیش‌فرض: M5)
• متن هشدار (قابل تنظیم)
• موقعیت X و Y

UI Panel

• موقعیت X و Y پنل
• عرض دکمه (پیش‌فرض: 150)
• ارتفاع دکمه (پیش‌فرض: 30)
• فاصله افقی (پیش‌فرض: 5)
• فاصله عمودی (پیش‌فرض: 5)
• سایز فونت (پیش‌فرض: 8)
• رنگ‌های دکمه (Normal/Pressed/Active)
• رنگ متن

نحوه استفاده

راه‌اندازی اولیه

1. فایل FBO_Helper.mq5 را در پوشه MQL5/Indicators کپی کنید
2. متاتریدر 5 را باز کنید و اندیکاتور را کامپایل کنید
3. اندیکاتور را به چارت اضافه کنید
4. تنظیمات را مطابق نیاز خود تنظیم کنید

گردش کار معمولی

استفاده از حالت Manual

1. دکمه High یا Low را فعال کنید
2. روی کندل‌های مورد نظر کلیک کنید تا خطوط رسم شوند
   • خط به‌طور خودکار به نزدیک‌ترین High/Low می‌چسبد (Magnet)
3. منتظر بریک‌اوت معتبر بمانید (هایلایت زرد رنگ)
4. دکمه B.Fibo (برای شکست کف) یا S.Fibo (برای شکست سقف) را بزنید
5. فیبوناچی روی نزدیک‌ترین خط رسم می‌شود

استفاده از حالت Auto

1. دکمه High یا Low را فعال کنید
2. روی کندل‌های مورد نظر کلیک کنید تا خطوط رسم شوند
3. دکمه Start را بزنید
4. اندیکاتور به‌صورت خودکار:
   • 2 فیبو را روی 2 نزدیک‌ترین خط همنوع رسم می‌کند
   • پس از بریک‌اوت، خطوط مخالف را حذف می‌کند
   • منتظر بازگشت قیمت به Entry می‌ماند
   • اگر خط دوم بشکند قبل از Entry، اولی را حذف و دومی را promote می‌کند
   • پس از فعال‌سازی معامله، SL/TP را مانیتور می‌کند
   • در صورت خوردن SL، وارد حالت Recovery می‌شود و رنگ فیبو تغییر می‌کند

استفاده از دکمه Reset

• برای شروع از صفر از دکمه Reset استفاده کنید
• این دکمه همه چیز را پاک و بازنشانی می‌کند:
  • تمام خطوط، باکس‌ها و فیبوها
  • تمام state های Auto Mode
  • تمام دکمه‌ها به حالت عادی
  • تمام شمارنده‌ها

منطق معامله

State Machine Flow

NONE → رسم 2 فیبو روی نزدیک‌ترین خطوط
   ↓ (بریک‌اوت رخ داد)
BREAKOUT → منتظر بازگشت به Entry یا شکست خط دوم
   ↓ (قیمت به Entry برگشت)
ACTIVE → مانیتور SL/TP معامله اول
   ↓ (SL خورد)
RECOVERY → مانیتور SL/TP معامله ریکاوری (رنگ فیبو تغییر می‌کند)

معامله اول (Counter-Trend)

• Sell: پس از شکست سقف (خلاف جهت شکست)
• Buy: پس از شکست کف (خلاف جهت شکست)

معامله دوم (Recovery)

• در صورت خوردن SL معامله اول
• Entry جدید = SL قبلی
• SL جدید = Entry قبلی
• جهت معامله معکوس می‌شود:
  • Buy اولیه → Sell در Recovery (رنگ قرمز)
  • Sell اولیه → Buy در Recovery (رنگ سبز)

توجهات مهم

⚠️ اسپرد:

• اندیکاتور می‌تواند اسپرد را در محاسبات لحاظ کند
• برای واقع‌گرایی بیشتر Use Spread = true تنظیم کنید
• برای تست بدون اسپرد Use Spread = false تنظیم کنید

⚠️ تایم‌فریم: استفاده از تایم‌فریم M5 توصیه می‌شود

⚠️ State Machine:

• بعد از استفاده از Auto Mode، برای شروع دوباره حتماً دکمه Reset را بزنید
• اگر Auto Mode کار نمی‌کند، از دکمه Reset استفاده کنید

⚠️ مدیریت ریسک: این اندیکاتور فقط نقاط ورود و خروج را نشان می‌دهد. مدیریت ریسک و اجرای معاملات بر عهده معامله‌گر است.

ویژگی‌های پیشرفته

Magnetic Line Drawing

• خط به‌طور خودکار به بالاترین/پایین‌ترین قیمت در محدوده می‌چسبد
• محدوده قابل تنظیم (Magnet Candle Range)

Dual-Fibo System

• همیشه 2 فیبو به‌طور همزمان نمایش داده می‌شود
• فاصله‌گذاری خودکار برای جلوگیری از همپوشانی
• حذف و promote هوشمند بر اساس بریک‌اوت‌ها

پشتیبانی

برای گزارش باگ‌ها یا پیشنهادات، لطفاً یک Issue در ریپازیتوری گیت‌هاب ایجاد کنید.

نسخه

نسخه 1.5.0 - نسخه پیشرفته با State Machine و UI جدید

تغییرات نسخه 1.5.0

• ✅ طراحی جدید تایمر با آیکون و رنگ‌بندی
• ✅ Grid Layout 2×4 برای دکمه‌ها
• ✅ دکمه Reset برای بازنشانی کامل
• ✅ ادغام دکمه‌های Clean
• ✅ State Machine پیشرفته با 4 حالت
• ✅ سیستم Dual-Fibo
• ✅ تغییر رنگ فیبو در حالت Recovery
• ✅ پارامتر Spread قابل تنظیم
• ✅ Warning text قابل تنظیم
• ✅ Spacing افقی و عمودی جداگانه

مجوز

این پروژه تحت مجوز MIT منتشر شده است.

---

یادآوری: این ابزار صرفاً برای مقاصد آموزشی و کمکی طراحی شده است. قبل از استفاده در معاملات واقعی، حتماً آن را در حساب دمو تست کنید.