ربات تلگرام مأموریت‌های فورتنایتSave the World

رباتی برای فورتنایت Save the World که ماموریت‌های وی‌باکس، پاور ۱۶۰، ونچر ۱۴۰، بهترین ماموریت‌های روز، جایزه هفتگی و تایمر سیزن‌ها را دنبال می‌کند. به فارسی یا انگلیسی جواب می‌دهد، به صورت متن یا عکس آماده.

سرور ندارید؟ از نمونه من استفاده کنید — قول نمی‌دهم تا کی فعال بماند. فقط برای استفاده شخصی، نه برای فروش. سلب مسئولیت

ریست روزانه بعدیاعلان‌ها ساعت ۰۰:۰۱ UTC ارسال می‌شوند
--:--:--
Fortnite Missionsbot

🌍 Hexsylvania Venture Zone

🎯 Trap the Storm

⚡ Power 140

🗺 Haunted Forest

🎁 Alert rewards:

  • Survivor (Epic) x1
  • Frost-Up! (Common) x280
  • Venture Xp (Common) x18000
یک اعلان روزانه در حالت متن، همان‌طور که در تلگرام می‌رسد

⚖️ شرایط استفاده

این ربات رایگان و متن‌باز است و فقط برای استفاده شخصی ساخته شده. برای فروش نیست و نباید فروخته یا تجاری استفاده شود.

نام، آیکن‌ها و تصاویر فورتنایت تحت انحصار و مالکیت Epic Games هستند و این پروژه هیچ ارتباطی با Epic Games ندارد و مورد تأیید آن نیست.

مسئولیت نصب و استفاده کاملاً با خودتان است. نصب‌کننده قبل از نصب، پذیرش این شرایط را از شما می‌پرسد.

📋 امکانات

  • 💎
    ماموریت‌های وی‌باکسهمه ماموریت‌های روزانه‌ای که وی‌باکس می‌دهند، همراه با مقدار و پاور.
  • ⚡
    ماموریت‌های پاور ۱۶۰ماموریت‌های اندگیم با لیست کامل جوایز آلرت و پایه.
  • 🌴
    ماموریت‌های ونچر ۱۴۰فقط ماموریت‌های ونچر با پاور ۱۴۰. دانجن‌ها حذف می‌شوند.
  • 🔥
    ماموریت‌های برتربهترین ماموریت‌های هر زون بر اساس ارزش: وی‌باکس، X-Ray، آیتم‌های Mythic و Legendary، Perk-Up و Flux لجندری.
  • 🔎
    جستجوی جایزهجستجو در همه زون‌ها بر اساس نوع جایزه، کمیابی و زونی که انتخاب می‌کنید.
  • 🖼
    حالت عکسلیست‌ها به صورت عکس مرتب با آیکن ماموریت و جایزه، ۵ تا ۶ ماموریت در هر عکس، ارسال به صورت آلبوم. یا حالت متن ساده.
  • 🛠
    جایزه هفتگیاینکه ریست این هفته چه سوپرچارجر یا Core RE-PERK می‌دهد، با امکان اصلاح دستی توسط ادمین اگر منبع عقب باشد.
  • ⏱
    تایمر سیزن‌هاشمارش معکوس بتل‌پس و ونچر همراه با نوار پیشرفت.
  • 🔔
    اعلان خودکاراعلان روزانه ۱ دقیقه بعد از ریست و اعلان هفتگی ۲ دقیقه بعد از آن. هر کاربر می‌تواند خاموشش کند.
  • 🌐
    دوزبانهرابط کامل فارسی و انگلیسی، قابل تغییر برای هر کاربر.
  • 👑
    پنل مدیریتآمار، پیام همگانی، مسدودسازی، خروجی و بازگردانی CSV، پاک کردن کش، اصلاح جایزه هفتگی، بررسی آپدیت.
  • 🎨
    پک آرتهمه آیکن‌ها و پس‌زمینه را می‌توانید با PNGهای خودتان عوض کنید.

📱 اپ (اندروید / آیفون) — v2.0.0

همان ماموریت‌ها، ماموریت‌های برتر، جستجوی جایزه، جایزه هفتگی و تایمر سیزن‌های ربات، به صورت اپ — بدون نیاز به تلگرام:

  • هر گوشی یا مرورگری: آدرس plus98ir.github.io/Fortnite_Missions/app را باز کنید و Add to Home screen را بزنید (اندروید: منوی Chrome · آیفون: دکمه اشتراک Safari). بعد از آن تمام‌صفحه باز می‌شود و آفلاین هم کار می‌کند.
  • فایل APK اندروید: فایل FortniteMissions-v2.0.0.apk را از ریلیز اپ دانلود و نصب کنید (یک بار اجازه «نصب برنامه‌های ناشناس» را بدهید).

داده‌ها هر روز بلافاصله بعد از ریست ۰۰:۰۰ UTC با GitHub Actions و با همان کد ربات ساخته می‌شوند، پس اپ و ربات همیشه لیست‌های یکسان نشان می‌دهند. اپ در اولین اجرا پذیرش شرایط استفاده را می‌پرسد.

🚀 نصب

  1. دریافت توکن ربات

    1. تلگرام را باز کنید و @BotFather را جستجو کنید.
    2. دستور /newbot را بفرستید.
    3. یک نام نمایشی برای ربات انتخاب کنید.
    4. یک نام کاربری یکتا که به bot یا _bot ختم شود انتخاب کنید (مثلاً FortniteAlertsBot).
    5. توکن HTTP API را کپی کنید.

    همچنین به آیدی عددی حساب ادمین نیاز دارید — به @userinfobot پیام /start بدهید تا آن را بگیرید.

    ⚠️ توکن را محرمانه نگه دارید. هرگز آن را کامیت یا منتشر نکنید. اگر لو رفت، فوراً با /revoke در BotFather باطلش کنید.

  2. اجرای نصب‌کننده

    روی یک سرور دبیان یا اوبونتو، با کاربر روت:

    bash <(curl -fsSL https://github.com/Plus98ir/Fortnite_Missions/releases/latest/download/install_fortnite_bot.sh)

    از bash <(curl ...) استفاده کنید، نه curl ... | bash. نصب‌کننده سؤال می‌پرسد و با pipe جواب‌های شما گم می‌شود.

  3. پذیرش شرایط و جواب سؤال‌ها

    نصب‌کننده اول شرایط استفاده را نشان می‌دهد و فقط اگر yes تایپ کنید ادامه می‌دهد. بعد توکن، آیدی ادمین و (به‌صورت اختیاری) پروکسی را می‌پرسد و بقیه کارها را خودش انجام می‌دهد: نصب پکیج‌ها، ساخت کاربر سرویس اختصاصی، محیط مجازی پایتون، فایل پیکربندی، پک آرت و سرویس systemd سندباکس‌شده.

    قبل از استارت سرویس، اتصال به تلگرام را تست می‌کند تا فوراً بفهمید مشکل از توکن است یا از شبکه.

    برای آپدیت دستور fnbot update را بزنید (یا دکمه به‌روزرسانی در پنل ادمین). کانفیگ، کاربران و آرت‌های خودتان حفظ می‌شوند.

🖥 مدیریت ربات

دستور کمکی fnbot نصب می‌شود:

دستورکارکرد
fnbot statusآیا در حال اجراست؟
fnbot logsمشاهده زنده لاگ
fnbot errorsفقط خطوط خطا
fnbot testتست اتصال تلگرام، مستقیم و با پروکسی
fnbot configویرایش کانفیگ و ری‌استارت خودکار
fnbot updateنصب آخرین نسخه، کانفیگ و کاربران حفظ می‌شوند
fnbot art [--force]دانلود دوباره پک آرت
fnbot versionنسخه نصب‌شده
fnbot restartری‌استارت سرویس
fnbot uninstallحذف سرویس (کانفیگ و کاربران باقی می‌مانند)

🔧 پیکربندی

همه چیز در /etc/fortnite_bot/bot.env است (پرمیشن 0640). با fnbot config ویرایشش کنید؛ بعد از ذخیره، سرویس خودش ری‌استارت می‌شود.

تنظیمپیش‌فرضتوضیح
BOT_TOKEN—توکن BotFather.
ADMIN_CHAT_ID—آیدی عددی ادمین.
PROXY_URLخالیمثل socks5://user:[email protected]:1080. برای اتصال مستقیم خالی بگذارید.
MAX_USERS۲۰۰سقف ظرفیت. اگر کاربر زیاد دارید بالا ببرید.
DEFAULT_LANGenen یا fa.
IMAGE_MIN_CARDS۵حداقل ماموریت در هر عکس؛ ماموریت‌ها مساوی پخش می‌شوند (۵+۵، نه ۴+۱).
IMAGE_MAX_CARDS۱۰سقف نرم تعداد ماموریت در هر عکس.
TOP_PER_ZONE۵تعداد ماموریت هر زون در 🔥 ماموریت‌های برتر.
ART_DIR/opt/fortnite_bot/artپوشه آیکن‌ها و پس‌زمینه خودتان.
ART_URLart.zip ریلیزپک آرتی که موقع نصب/آپدیت دانلود می‌شود. "" = خاموش.
WEEKLY_URL2خالیمنبع دوم اختیاری برای جایزه هفتگی.
DAILY_RESET_UTC00:01زمان اعلان روزانه (۱ دقیقه بعد از ریست شاپ).
WEEKLY_RESET_UTC00:02زمان اعلان هفتگی (۲ دقیقه بعد از ریست).
WEEKLY_RESET_WEEKDAY۳۰ = دوشنبه … ۳ = پنجشنبه.
SEASON_START_UTC—شروع سیزن جاری، فرمت ISO.
SEASON_END_UTC—تاریخ پایان جایگزین، اگر دریافت زنده شکست بخورد.
CACHE_SETTLE_MINUTES۲۰چند دقیقه بعد از ریست همچنان دنبال داده تازه بگردد.
CACHE_SETTLE_TTL۳۰۰فاصله بررسی مجدد (ثانیه) در همان بازه.
LOG_LEVELINFOبرای لاگ کامل‌تر DEBUG بگذارید.

📅 مقادیر SEASON_START_UTC و SEASON_END_UTC را هر سیزن یک بار به‌روز کنید. ربات تلاش می‌کند تاریخ پایان را زنده بخواند، ولی این‌ها پشتیبان هستند.

🎨 پک آرت

عکس‌ها از PNGهای داخل ART_DIR ساخته می‌شوند؛ هر چه نباشد را خود ربات می‌کشد. ساختار: background.png در ریشه، آیکن ماموریت‌ها در scenes/، آیکن جوایز در rewards/، جوایز هفتگی در weekly/ و آیکن زون‌ها در zone/. اسم‌ها انعطاف‌پذیرند (V-Bucks.png = v_bucks.png = vbucks.png)؛ لیست کامل در توضیح بالای ART_DIR در bot.env است.

  • fnbot art --force فایل ART_URL را دوباره دانلود و باز می‌کند.
  • PNGهایی که خودتان دستی عوض کرده‌اید هیچ‌وقت بازنویسی نمی‌شوند.
  • عکس‌هایی که پک قدیمی نصب کرده و در پک جدید نیستند پاک می‌شوند.

آیکن‌های پیش‌فرض، آیتم‌های فورتنایت را نشان می‌دهند و متعلق به Epic Games هستند. فقط برای اینکه ربات در استفاده شخصی قابل استفاده باشد همراهش آمده‌اند.

⚙️ فیلترهای کاربر

هر کاربر ⚙️ فیلترهای من (یا /filters) را باز می‌کند و زون‌ها و نوع جوایز (V-Bucks، Survivor، Hero، Defender، Schematic، Trap، Evo Mat، Perk-Up، Gold، XP) و کمیابی (Legendary، Epic) را انتخاب می‌کند؛ کمیابی و نوع باید هر دو روی یک جایزه صدق کنند. این فیلترها فقط در 🔎 جستجوی جایزه استفاده می‌شوند؛ لیست‌های معمولی و اعلان روزانه همیشه همه چیز را نشان می‌دهند.

👑 پنل مدیریت

دکمه 👑 Admin را بزنید، یا مستقیم از دستورها استفاده کنید:

دستورکارکرد
/statsتعداد کاربران، مشترکان، مسدودها و کاربران دارای فیلتر.
/broadcast متنارسال به همه مشترکان. اول پیش‌نمایش با دکمه تأیید/لغو نشان داده می‌شود.
/cancelلغو پیام همگانی در انتظار.
/ban آیدی و /unban آیدیمسدود یا آزاد کردن کاربر. کاربر مسدود بی‌صدا نادیده گرفته می‌شود.
/bannedلیست حساب‌های مسدود.
/exportدانلود فایل CSV از همه کاربران و تنظیماتشان.
/importبازگرداندن کاربران — کافی است همان CSV یا یک users.json را برای ربات بفرستید.
/refreshپاک کردن کش و دریافت مجدد در درخواست بعدی.
/setweekly نوعثبت دستی جایزه این هفته وقتی منبع اشتباه است (weapon، hero، survivor، trap، defender، core، auto).
/updateبررسی و نصب نسخه جدید.

بازگردانی به صورت ادغام است: کاربران موجود به‌روز می‌شوند، جدیدها اضافه می‌شوند و هیچ‌کس حذف نمی‌شود.

🗂 کش

ماموریت‌ها فقط سر ریست عوض می‌شوند، پس کش تا ریست بعدی معتبر است، نه یک مدت ثابت:

دادهمعتبر تاروی دیسک
ماموریت‌ها، لیست‌های فیلترشده، عکس‌ها۰۰:۰۰ UTC بعدی✅ (ماموریت‌ها)
جایزه هفتگیریست هفتگی بعدی✅
تاریخ پایان سیزنروز بعددر حافظه

اولین درخواست روز داده را می‌گیرد و بقیه بلافاصله جواب می‌گیرند. اگر دریافت شکست بخورد، به جای خطا همان داده قبلی نمایش داده می‌شود.

🔒 امنیت

  • با کاربر سیستمی بدون دسترسی fnbot اجرا می‌شود، نه روت.
  • توکن هیچ‌وقت وارد فایل‌های سورس نمی‌شود — فقط در فایل کانفیگ (0640 و root:fnbot) قرار دارد.
  • یوزر و پسورد پروکسی URL-encode می‌شوند و از همه لاگ‌ها حذف می‌شوند.
  • یونیت systemd سندباکس شده است: ProtectSystem=strict، NoNewPrivileges، مجموعه capability خالی و فیلتر syscall.
  • همه خروجی تلگرام HTML-escape می‌شود، پس نام ماموریت‌های دریافتی نمی‌توانند پیام را خراب کنند یا چیزی تزریق کنند.
  • پک آرت امن باز می‌شود: فقط عکس، بدون خروج از مسیر، با محدودیت حجم.

🌐 پروکسی — اصلاً لازم است؟

فقط اگر سرورتان نتواند مستقیم به api.telegram.org برسد، که عملاً یعنی سرور داخل ایران. سرورهای خارج باید PROXY_URL را خالی بگذارند.

پروکسی باید از خود سرور قابل دسترس باشد. 127.0.0.1 یعنی همان ماشین، نه کامپیوتر شخصی شما. با این دستورها چک کنید:

ss -ltnp | grep <port>
fnbot test

❓ رفع اشکال

نشانهعلت و راه‌حل
httpx.ConnectErrorتلگرام در دسترس نیست. fnbot test بزنید؛ اگر اتصال مستقیم کار کرد، PROXY_URL را خالی کنید.
بعد از آپدیت آیکن‌های قدیمی دیده می‌شوندfnbot art --force را اجرا کنید.
تایمر بتل‌پس خطا می‌دهددریافت زنده تاریخ سیزن شکست خورده. SEASON_END_UTC را در کانفیگ تنظیم کنید.
جایزه هفتگی اشتباه استمنبع عقب است. با /setweekly جایزه درست را ثبت کنید.
سرویس در حلقه ری‌استارت می‌افتدfnbot errors دلیل واقعی را در چند خط آخر نشان می‌دهد.

⚖️ سلب مسئولیت

  • این ربات برای استفاده شخصی است و برای فروش نیست.
  • فورتنایت و همه نام‌ها، آیکن‌ها و تصاویر مرتبط با آن، علامت تجاری و تحت انحصار Epic Games, Inc. هستند. این پروژه غیررسمی است و هیچ ارتباط، حمایت یا تأییدی از طرف Epic Games ندارد.
  • داده ماموریت‌ها از سایت‌های جامعه کاربری (seebot.dev، fortnitedb.com، fortnite.gg) گرفته می‌شود و ممکن است دیر یا اشتباه باشد.
  • نرم‌افزار «همان‌طور که هست» و بدون هیچ ضمانتی ارائه می‌شود. مسئولیت نصب و استفاده از آن کاملاً با خودتان است.

سرور ندارید؟ می‌توانید از نمونه من استفاده کنید: @plus98vbucks_bot — قول نمی‌دهم تا کی فعال بماند.