این راهنما شما را در اتصال به سرور Minecraft میزبانی شده در Legion Hosting راهنمایی می‌کند. Java Edition، Bedrock Edition و سرورهای مادشده را پوشش می‌دهد — از جمله اقداماتی که در صورت شکست اتصال باید انجام دهید.

پیش‌نیازها

• یک سرور Minecraft فعال در Legion Hosting
• آدرس IP و پورت سرور از GPanel (در gpanel.legionhosting.net وارد شوید، روی سرور خود کلیک کنید و IP:Port نشان داده شده در صفحه Console را یادداشت کنید)
• سرور شما باید قبل از اتصال هر کسی در وضعیت Running باشد
• برای سرورهای مادشده: همان بارگذار ماد (Forge یا Fabric) و همان مادها باید روی کلاینت نصب شده باشند

مرحله ۱ — تأیید اینکه سرور در حال اجراست

1. به GPanel وارد شوید و روی سرور خود کلیک کنید.
2. در تب Console، نشانگر وضعیت در ناحیه بالا-راست پنل را بررسی کنید.
3. باید Running نشان دهد. اگر Offline نشان می‌دهد، روی Start کلیک کنید و منتظر بمانید تا سرور بارگذاری را تمام کند — این معمولاً برای سرور ونیلا ۳۰ تا ۹۰ ثانیه و برای سرور مادشده بیشتر طول می‌کشد.
4. آدرس کامل IP:Port نشان داده شده در بالای صفحه Console را کپی کنید (مثلاً 192.0.2.10:25565).

مرحله ۲ — اتصال از Java Edition

1. لانچر Minecraft را باز کنید و Minecraft: Java Edition را شروع کنید.
2. از منوی اصلی، روی Multiplayer کلیک کنید.
3. روی Add Server کلیک کنید.
4. در فیلد Server Name، هر برچسبی که دوست دارید وارد کنید (مثلاً My Legion Server).
5. در فیلد Server Address، آدرس کامل IP:Port از GPanel را بچسبانید — مثلاً 192.0.2.10:25565.
6. روی Done کلیک کنید. سرور در لیست شما ظاهر می‌شود.
7. روی ورودی سرور دوبار کلیک کنید (یا آن را انتخاب کنید و روی Join Server کلیک کنید) تا متصل شوید.

مرحله ۳ — اتصال از Bedrock Edition

Bedrock Edition از روند کمی متفاوت استفاده می‌کند و IP و پورت را در دو فیلد جداگانه قرار می‌دهد.

1. Minecraft: Bedrock Edition (نسخه Windows 10/11، موبایل، کنسول و غیره) را باز کنید.
2. از منوی اصلی، روی Play کلیک یا ضربه بزنید.
3. تب Servers را در بالای صفحه انتخاب کنید.
4. به انتهای لیست سرور پیمایش کنید و روی Add Server کلیک کنید.
5. در فیلد Server Name، هر برچسبی که دوست دارید وارد کنید.
6. در فیلد Server Address، فقط بخش IP را وارد کنید (همه چیز قبل از دو نقطه)، مثلاً 192.0.2.10.
7. در فیلد Port، فقط عدد بعد از دو نقطه را وارد کنید، مثلاً 19132. پورت پیش‌فرض Bedrock 19132 است، اما سرور شما ممکن است از پورت متفاوتی استفاده کند — GPanel را بررسی کنید.
8. روی Save کلیک کنید، سپس روی ورودی سرور کلیک کنید تا متصل شوید.

مرحله ۴ — اتصال به سرور مادشده (Forge / Fabric)

سرورهای مادشده نیاز به تنظیمات مطابق در سمت کلاینت دارند. فرآیند اتصال خود مانند Java Edition ونیلا است، اما کلاینت ابتدا باید به درستی آماده شود.

نصب همان بارگذار ماد

1. مشخص کنید سرور شما از کدام بارگذار ماد استفاده می‌کند — Forge یا Fabric — و شماره نسخه دقیق. می‌توانید این را در GPanel در صفحه Console ببینید یا از کسی که سرور را راه‌اندازی کرده بپرسید.
2. نصب‌کننده بارگذار مطابق را دانلود کنید:
   • Forge: files.minecraftforge.net
   • Fabric: fabricmc.net/use/installer
3. نصب‌کننده را اجرا کنید. یک پروفایل جدید به لانچر Minecraft اضافه می‌شود.
4. لانچر Minecraft را باز کنید و پروفایل جدید Forge یا Fabric را از منوی کشویی پروفایل قبل از اجرا انتخاب کنید.

نصب همان مادها

1. دقیقاً همان فایل‌های ماد نصب شده روی سرور را تهیه کنید. نام، نسخه و نسخه Minecraft مادها باید همه مطابقت داشته باشند.
2. پوشه مادهای Minecraft خود را باز کنید:
   • Windows: Win + R را فشار دهید، %appdata%\.minecraft\mods را تایپ کنید و Enter بزنید.
   • macOS: Finder را باز کنید، Cmd + Shift + G را فشار دهید و ~/Library/Application Support/minecraft/mods را وارد کنید.
3. فایل‌های .jar ماد را در پوشه mods کپی کنید.
4. Minecraft را با پروفایل Forge یا Fabric اجرا کنید، سپس با همان مراحل مرحله ۲ به سرور متصل شوید.

تأیید

پس از دنبال کردن مراحل بالا، تأیید کنید اتصال به درستی کار می‌کند:

1. باید ظرف چند ثانیه پس از کلیک روی Join Server در دنیای بازی ظاهر شوید.
2. لیست بازیکنان درون بازی را باز کنید (کلید پیش‌فرض: Tab) — نام کاربری شما باید ظاهر شود.
3. برای سرورهای مادشده، فعال بودن مادها را با بررسی آیتم‌ها، بلاک‌ها یا گزینه‌های منوی مخصوص ماد در بازی تأیید کنید.
4. اگر ادمین سرور هستید، به GPanel برگردید و تب Console را بررسی کنید — باید خط لاگی مانند [Server thread/INFO]: YourUsername joined the game ببینید.

عیب‌یابی

اتصال زمان‌بر شد یا رد شد

• تأیید کنید وضعیت سرور در GPanel Running نشان می‌دهد. اگر در حال شروع است، منتظر بمانید تا کاملاً بارگذاری شود.
• بررسی کنید که IP:Port کامل شامل شماره پورت را کپی کرده‌اید و فاصله اضافی وجود ندارد.
• سرور را از لیست چندنفره حذف و دوباره اضافه کنید تا آدرس کش‌شده اشتباه را رد کنید.
• اگر سرور تازه شروع یا راه‌اندازی مجدد شده، ۱ تا ۲ دقیقه صبر کنید و دوباره امتحان کنید.

"Can't connect to server" در لیست چندنفره

این پیام زمانی ظاهر می‌شود که کلاینت اصلاً نمی‌تواند به سرور دسترسی پیدا کند. دلایل رایج:

• سرور آفلاین است — آن را از GPanel شروع کنید.
• شماره پورت اشتباه است — پورت دقیق را در تب Network GPanel تأیید کنید.
• تلاش می‌کنید با Bedrock به سرور Java متصل شوید (یا بالعکس) — آنها سازگار نیستند.

با پیام "You are not whitelisted on this server" اخراج شدید

سرور حالت whitelist فعال دارد. ادمین سرور باید نام کاربری Minecraft شما را به whitelist اضافه کند. در GPanel، به تب Console بروید و دستور /whitelist add YourUsername را اجرا کنید. همچنین می‌توانید whitelist را کاملاً با /whitelist off غیرفعال کنید.

خطای عدم تطابق ماد در صفحه اتصال

Minecraft لیستی از مادهایی که روی سرور هستند اما در کلاینت شما نیستند، یا مادهایی که شما دارید اما سرور ندارد نمایش می‌دهد. این را با موارد زیر رفع کنید:

1. مقایسه پوشه مادهای کلاینت با پوشه مادهای سرور (از طریق SFTP در GPanel قابل مشاهده است).
2. اضافه کردن مادهای ناموجود به کلاینت یا حذف مادهای اضافی.
3. اطمینان از مطابقت دقیق نسخه بارگذار ماد در کلاینت با سرور.

خطای نسخه بازی اشتباه

Minecraft نیاز دارد کلاینت و سرور همان نسخه بازی را اجرا کنند. نسخه‌ای که سرور اجرا می‌کند را در GPanel بررسی کنید (در لاگ‌های راه‌اندازی Console یا نام egg سرور قابل مشاهده است)، سپس همان پروفایل نسخه را در لانچر Minecraft قبل از اتصال انتخاب کنید.

بازیکنان Bedrock نمی‌توانند سرور را در تب Friends ببینند

تب Friends در Bedrock فقط Realms و سرورهای LAN کشف شده محلی را نشان می‌دهد. برای سرور میزبانی شده، بازیکنان باید همیشه از روند دستی Add Server توضیح داده شده در مرحله ۳ استفاده کنند. سرور به صورت خودکار ظاهر نمی‌شود.