Minecraft · Guide

چگونه پلاگین‌ها را روی سرور Minecraft نصب کنیم (Paper و Spigot)

به‌روزرسانی شده July 26, 2026 10 دقیقه مطالعه

در این صفحه
  1. پلاگین در مقابل مود: تفاوت چیست؟
  2. قبل از شروع: Paper یا Spigot را اجرا کنید
  3. چگونه یک پلاگین را قدم‌به‌قدم نصب کنیم
  4. پلاگین‌های ضروری که ارزش نصب اول را دارند
  5. به‌روزرسانی و حذف پلاگین‌ها
  6. پلاگین بارگذاری نمی‌شود؟ چگونه رفعش کنیم
  7. سوالات متداول

پلاگین‌ها سریع‌ترین راه برای تبدیل یک دنیای survival ساده به یک سرور واقعی هستند — رنک‌ها، مالکیت زمین، خانه‌ها، محافظت در برابر خراب‌کاری و مینی‌گیم‌ها. بهترین بخش در Paper و Spigot این است که همه‌چیز سمت سرور اجرا می‌شود: پلاگین را یک‌بار نصب می‌کنید و بازیکنانتان با کلاینت اصلی و بدون تغییر Minecraft وارد می‌شوند و چیزی دانلود نمی‌کنند.

این راهنما کل فرآیند را از ابتدا تا انتها پوشش می‌دهد: از کجا با خیال راحت پلاگین تهیه کنید، چگونه یک پلاگین را در عرض چند دقیقه روی سرور Minecraft نصب کنید، پلاگین‌های ضروری که اکثر سرورها استفاده می‌کنند، و چگونگی به‌روزرسانی، حذف و رفع مشکل زمانی که چیزی بارگذاری نمی‌شود.

پلاگین در مقابل مود: تفاوت چیست؟

قبل از دانلود هرچیزی، مطمئن شوید که واقعاً به یک پلاگین نیاز دارید. مردم اغلب کلمات پلاگین و مود را به‌جای هم استفاده می‌کنند، اما در سرور این دو، دو چیز کاملاً متفاوت هستند.

 پلاگین‌هامودها
اجرا رویPaper، Spigot، Purpur (Bukkit API)Forge، Fabric، NeoForge
بازیکنان چیزی نصب می‌کنند؟خیر — فقط سمت سروربله — هر بازیکن باید همان مودها را داشته باشد
خود بازی را تغییر می‌دهد؟به‌ندرت — قابلیت و قوانین اضافه می‌کندبله — بلوک‌ها، موجودات و بعدهای جدید
کاربرد معمولرنک، مالکیت زمین، مینی‌گیم، ضد خراب‌کاریمودپک‌های فناوری، جادو و اکتشاف

پلاگین‌ها به Bukkit API که Paper و Spigot در اختیار می‌گذارند متصل می‌شوند. آن‌ها کاملاً روی سرور قرار دارند، بنابراین بازیکنان شما با کلاینت استاندارد Minecraft وصل می‌شوند و هرگز فایلی دانلود نمی‌کنند — دقیقاً به همین دلیل است که راه‌اندازی و رشد سرورهای پلاگینی این‌قدر آسان است.

مودها دنیای کاملاً متفاوتی هستند: آن‌ها خود کلاینت بازی را تغییر می‌دهند، پس سرور و تک‌تک بازیکنان باید همان لودر و همان فهرست مود را اجرا کنند، که معمولاً به‌صورت یک مودپک با هم عرضه می‌شوند. اگر دنبال این هستید، این راهنمای درستی نیست — به چگونگی ساخت سرور Minecraft مودی مراجعه کنید. برای مقایسه کامل لودرها و کاربرد هرکدام، بهترین نرم‌افزار سرور Minecraft را ببینید.

قبل از شروع: Paper یا Spigot را اجرا کنید

پلاگین‌ها فقط روی سروری که Bukkit API را پشتیبانی می‌کند بارگذاری می‌شوند. server.jar اصلی از Mojang این کار را نمی‌کند — پلاگینی کنارش بگذارید، هیچ اتفاقی نمی‌افتد. به یکی از این‌ها نیاز دارید:

  • Paper — انتخاب استاندارد. سریع‌ترین این خانواده، به‌طور فعال نگهداری می‌شود، و با اکوسیستم عظیم پلاگین Bukkit/Spigot سازگار است. از اینجا شروع کنید.
  • Spigot — پایه قدیمی‌تری که هنوز اکثر پلاگین‌ها روی آن ساخته و تست می‌شوند. Paper یک ابرمجموعه مستقیم آن است، پس پلاگینی که برچسب «برای Spigot» دارد روی Paper هم اجرا می‌شود.
  • Purpur — فورکی از Paper با تنظیمات گیم‌پلی اضافی. همان پلاگین‌ها، چند گزینه بیشتر.

اگر هنوز روی نسخه اصلی (vanilla) هستید، تعویض سریع است. در پلن Minecraft هایت‌هاست، پنل GameCP یک تعویض‌کننده نسخه داخلی دارد: Paper (یا Spigot/Purpur) و نسخه Minecraft را انتخاب کنید، یک‌بار کلیک کنید، و نسخه صحیح خودش نصب می‌شود — دنیای شما دست‌نخورده باقی می‌ماند. خودتان میزبانی می‌کنید؟ jar مربوط به Paper را دانلود کرده و به‌جای نسخه اصلی اجرا کنید. برای کمک در انتخاب بین vanilla، Paper، Forge و Fabric، بهترین نرم‌افزار سرور Minecraft را بخوانید؛ اگر هنوز سروری نساخته‌اید، با چگونگی ساخت سرور Minecraft شروع کنید.

نسخه Minecraft خود را یادداشت کنید. تعویض‌کننده نسخه دقیقاً نشان می‌دهد سرور شما روی کدام نسخه Minecraft اجرا می‌شود. آن را یادداشت کنید — در مرحله بعد پلاگین‌هایی برای همان نسخه دانلود خواهید کرد، و درست‌کردن این موضوع از ابتدا از بیشتر دردسرهای «بارگذاری نمی‌شود» جلوگیری می‌کند.

چگونه یک پلاگین را قدم‌به‌قدم نصب کنیم

با اجرای Paper یا Spigot، نصب یک پلاگین چند قدم کوتاه است. کل کار چند دقیقه طول می‌کشد.

  1. فایل JAR پلاگین را از منبعی معتبر دانلود کنید. منابع معتبر برای پلاگین‌ها SpigotMC، Modrinth و Hangar (PaperMC) هستند. فایل .jar را دانلود کنید و مطمئن شوید صفحه پشتیبانی از نسخه Minecraft شما را ذکر کرده — پلاگینی که برای 1.20 ساخته شده معمولاً روی 1.21 بارگذاری نمی‌شود.
  2. آن را در پوشه plugins آپلود کنید. تب Files پنل را باز کنید، وارد پوشه plugins شوید، و فایل JAR را آپلود کنید — کشیدن و رها کردن هم کار می‌کند. چند پلاگین را یک‌جا نصب می‌کنید؟ با اطلاعات پنل خود از طریق SFTP وصل شوید و مستقیماً در plugins کپی کنید. خودتان میزبانی می‌کنید؟ پوشه plugins کنار server.jar شما قرار دارد.
  3. سرور را ری‌استارت کنید. پلاگین‌ها فقط هنگام راه‌اندازی بارگذاری می‌شوند، پس در پنل روی Restart بزنید — یک reload ساده پلاگین کاملاً جدید را تشخیص نمی‌دهد. کنسول را هنگام بالا آمدن تماشا کنید: هر پلاگین هنگام فعال‌شدن خودش را اعلام می‌کند.
  4. بررسی کنید بارگذاری شده است. در جعبه دستور کنسول، /plugins را تایپ کنید (یا فرم کوتاه /pl). پلاگین جدید شما باید در فهرست، با رنگ سبز نمایش داده شود. سبز یعنی بارگذاری شده و در حال اجراست؛ قرمز یعنی خطا داشته — اگر آن را دیدید به رفع اشکال بروید.
  5. آن را پیکربندی کنید. اولین راه‌اندازی موفق plugins/<PluginName>/config.yml را می‌سازد. این فایل را در مدیر فایل ویرایش کنید تا پلاگین را تنظیم کنید، سپس دستور reload آن را اجرا کنید یا ری‌استارت کنید. YAML نسبت به فاصله‌گذاری حساس است — با فاصله تورفتگی ایجاد کنید، هرگز با تب، وگرنه فایل تجزیه نمی‌شود.
تب Console در پنل HytHost GameCP که لاگ زنده راه‌اندازی یک سرور Paper و جعبه ورودی دستور را نشان می‌دهد، با تب‌های Files و Version در بالا و آمار زنده زمان کارکرد، پردازنده و حافظه در کنار آن
کنسول GameCP: سرور را ری‌استارت کنید، فعال‌شدن هر پلاگین را در لاگ ببینید، سپس /plugins را در جعبه دستور تایپ کنید تا بارگذاری آن را تأیید کنید. تب Files کنارش جایی است که فایل JAR را در پوشه plugins قرار می‌دهید.
فقط از منابع معتبر پلاگین نصب کنید. پلاگین کدی اجرایی است که روی سرور شما با دسترسی کامل به دنیا و کنسول اجرا می‌شود. پلاگین‌های «کرک‌شده»، بدون لایسنس یا آپلود مجدد از نسخه‌های پولی، راهی کلاسیک برای قاچاق بدافزار، درب پشتی و ماینر سکه هستند. به SpigotMC، Modrinth و Hangar پایبند بمانید — و هرگز فایل JAR‌ای که نسخه Minecraft ذکرشده در آن با سرورتان مطابقت ندارد نصب نکنید، چون عدم‌تطابق نسخه رایج‌ترین دلیل بارگذاری‌نشدن پلاگین یا خراب‌شدن دنیاست.

حدس‌زدن را کنار بگذارید — سرور Paper هایت‌هاست مدیر فایل، SFTP و بکاپ تک‌کلیکی می‌دهد تا پلاگین‌ها را در چند دقیقه نصب کنید.

مشاهده پلن‌های Minecraft

پلاگین‌های ضروری که ارزش نصب اول را دارند

می‌توانید یک آخر هفته کامل را صرف مرور پلاگین‌ها کنید، اما تقریباً هر سرور survival یا SMP خوب‌مدیریت‌شده روی همان فهرست کوتاه ساخته شده است. این‌ها را اول نصب کنید:

  • EssentialsX — چاقوی سوئیسی: /home، /spawn، /tpa، کیت، وارپ، یک اقتصاد ابتدایی و ده‌ها دستور روزمره. اگر فقط یک پلاگین نصب می‌کنید، همین باشد.
  • LuckPerms — مدیر مجوزها. تعیین می‌کند چه کسی می‌تواند چه دستوراتی را اجرا کند و رنک و گروه در اختیارتان می‌گذارد. بیشتر پلاگین‌های دیگر به آن متصل می‌شوند، پس به‌محض داشتن بیش از یک مدیر عملاً ضروری است.
  • WorldEdit + WorldGuard — WorldEdit اجازه می‌دهد زمین را سریع بسازید و ویرایش کنید؛ WorldGuard مناطق (اسپاون، مغازه‌ها، آرنا) را در برابر خراب‌کاری محافظت کرده و مناطق PvP را کنترل می‌کند. این دو با هم می‌آیند.
  • Vault — یک پلاگین پل ساکت که به پلاگین‌های اقتصاد، مجوز و چت اجازه می‌دهد با یکدیگر ارتباط برقرار کنند. چند پلاگین آن را به‌عنوان وابستگی ذکر می‌کنند؛ نصبش کنید و فراموشش کنید.
  • CoreProtect — ثبت بلوک و بازگردانی. وقتی خراب‌کاری‌کننده‌ای به اسپاون شما حمله می‌کند، CoreProtect دقیقاً نشان می‌دهد چه کسی چه کاری کرده و در چند ثانیه آن را برمی‌گرداند. قبل از نیاز پیدا کردن نصبش کنید.

نکته‌ای درباره مجوزها: بلافاصله بعد از نصب، اکثر پلاگین‌های دستوری فقط به اپراتورهای سرور پاسخ می‌دهند. برای اینکه یک رنک عادی بتواند از چیزی مثل /home استفاده کند، باید نود مجوز مربوطه (اینجا essentials.home) را در LuckPerms به گروهش بدهید. تقریباً همه یک‌بار در این تله می‌افتند — وقتی دستوری برای یک بازیکن عادی «هیچ‌کاری نمی‌کند»، تقریباً همیشه مجوز گم‌شده است، نه پلاگین خراب.

هر پلاگینی که اضافه می‌کنید کمی حافظه مصرف می‌کند، پس یک سرور پلاگینی شلوغ به فضای بیشتری نسبت به vanilla خالص نیاز دارد — برای سرور Paper که پلاگین‌های ضروری بالا را اجرا می‌کند ۴ تا ۶ گیگابایت در نظر بگیرید. اگر مطمئن نیستید چقدر باید اختصاص دهید، راهنمای ما درباره چقدر RAM سرور Minecraft نیاز دارد آن را بر اساس تعداد بازیکن و پیکربندی تفکیک کرده است.

به‌روزرسانی و حذف پلاگین‌ها

پلاگین‌ها فقط فایل‌هایی در یک پوشه هستند، که نگهداری را ساده می‌کند.

به‌روزرسانی یک پلاگین

نسخه جدید را دانلود کنید، JAR قدیمی را از پوشه plugins حذف کنید (پوشه تنظیمات پلاگین را دست‌نخورده بگذارید تا تنظیمات شما باقی بماند)، JAR جدید را آپلود کنید و ری‌استارت کنید. به‌روز نگه‌داشتن پلاگین‌ها مهم است: پلاگین قدیمی معمولاً مقصر اصلی زمانی است که سرور بلافاصله پس از ارتقای نسخه Minecraft خراب می‌شود، پس هر بار نسخه Minecraft را تغییر می‌دهید پلاگین‌هایتان را هم به‌روزرسانی کنید.

حذف یک پلاگین

سرور را ری‌استارت یا متوقف کنید، JAR پلاگین را از plugins حذف کنید، و در راه‌اندازی بعدی از بین می‌رود. پوشه تنظیمات آن زیر plugins/<PluginName> باقی می‌ماند مگر اینکه آن را هم حذف کنید — باقی‌گذاشتنش بی‌ضرر است، اما اگر برای همیشه از آن پلاگین دست کشیده‌اید، پاک‌کردنش مرتب‌تر است.

قبل از هر تغییری پشتیبان بگیرید. قبل از افزودن، به‌روزرسانی یا حذف یک پلاگین، در پنل یک بکاپ تک‌کلیکی بگیرید. اگر نسخه جدید بدرفتاری کرد، در چند ثانیه بازیابی می‌کنید به‌جای اینکه دنیای خراب را زیر و رو کنید. اول عکس فوری، بعد آزمایش.

پلاگین بارگذاری نمی‌شود؟ چگونه رفعش کنیم

وقتی پلاگینی در /plugins قرمز نشان داده می‌شود یا اصلاً کاری نمی‌کند، دلیل تقریباً همیشه یکی از چند مورد است. به ترتیب بررسی کنید:

  1. عدم تطابق نسخه. دلیل شماره یک. صفحه پلاگین را با نسخه Minecraft سرور خود مقایسه کنید — JAR ساخته‌شده برای 1.20 اغلب روی 1.21 فعال نمی‌شود، و برعکس آن هم درست است. نسخه‌ای که مطابقت دارد را دانلود کنید، یا نسخه سرور خود را تغییر دهید تا با پلاگین همخوانی داشته باشد.
  2. وابستگی گم‌شده. بسیاری از پلاگین‌ها به یک کمک‌پلاگین نیاز دارند که کنارشان نصب شود — Vault برای پلاگین‌های اقتصاد، یک پلاگین اقتصاد برای مغازه، یک کتابخانه خاص. کنسول نامش را به شما می‌گوید: به‌دنبال خطی مثل Unknown/missing dependency plugins: [Vault] بگردید. آنچه را می‌خواهد نصب کنید و ری‌استارت کنید.
  3. نوع سرور اشتباه. اگر اصلاً هیچ‌چیز بارگذاری نمی‌شود، مطمئن شوید واقعاً روی Paper یا Spigot هستید، نه vanilla — پلاگین‌ها به Bukkit API نیاز دارند. تعویض‌کننده نسخه نشان می‌دهد چه چیزی را اجرا می‌کنید.
  4. پیکربندی خراب. یک خط با تورفتگی اشتباه در config.yml می‌تواند پلاگین را کاملاً متوقف کند. خطای کنسول معمولاً به خط و ستون اشاره می‌کند. YAML را تصحیح کنید (فاصله، هرگز تب)، یا فایل تنظیمات را حذف کنید و بگذارید پلاگین در راه‌اندازی بعدی یک نسخه تمیز بسازد.

کنسول اینجا بهترین دوست شماست. هرچه شکست خورده باشد، سرور دلیل را هنگام راه‌اندازی چاپ می‌کند — یک خط قرمز ERROR یا WARN که نام پلاگین و مشکل را ذکر می‌کند. از بالا به پایین بخوانید؛ اولین خطا معمولاً واقعی است.

هنوز گیر کرده‌اید؟ خط دقیق خطا را از کنسول کپی کرده و آن را جستجو کنید — تقریباً مطمئناً کسی قبل از شما با همان پیام مواجه شده است. در پلن هایت‌هاست می‌توانید همچنین از ساعت ۸ صبح تا ۱۱ شب (به‌وقت کیشیناو) به چت زنده دسترسی داشته باشید، و هر سرور پشت محافظت DDoS ووکسیلیتی روی سخت‌افزار NVMe SSD قرار دارد، پس «کند بودن» به‌ندرت تقصیر پلاگین است. اگر شک دارید، بکاپ قبل از تغییر را بازیابی کنید و پلاگین‌ها را یکی‌یکی دوباره اضافه کنید تا مقصر خودش را نشان دهد.
سوالات متداول

سوالات متداول

پلاگین فقط روی سرور اجرا می‌شود. روی Paper، Spigot یا Purpur به Bukkit API متصل می‌شود، قابلیت‌هایی مثل رنک و مالکیت زمین اضافه می‌کند، و بازیکنان شما با کلاینت معمولی Minecraft وارد می‌شوند و چیزی دانلود نمی‌کنند. مود خود بازی را تغییر می‌دهد، پس سرور و هر بازیکن باید همان لودر (Forge یا Fabric) و همان فهرست مود را اجرا کنند — برای این مسیر چگونگی ساخت سرور Minecraft مودی را ببینید.

در پوشه plugins، که کنار jar سرور قرار دارد. فایل JAR پلاگین را از طریق مدیر فایل پنل یا SFTP آنجا آپلود کنید، سپس سرور را ری‌استارت کنید — پلاگین‌ها فقط هنگام راه‌اندازی بارگذاری می‌شوند، پس یک JAR جدید تا ری‌استارت هیچ کاری نمی‌کند.

خیر. سرور vanilla هیچ پشتیبانی از پلاگین ندارد، پس هر JAR‌ای که بگذارید نادیده گرفته می‌شود. به Paper، Spigot یا Purpur نیاز دارید که API پلاگین Bukkit را در اختیار می‌گذارند. تعویض یک کلیک در تعویض‌کننده نسخه GameCP است، و دنیای شما منتقل می‌شود — برای مقایسه بهترین نرم‌افزار سرور Minecraft را ببینید.

خیر، و این کل جذابیت پلاگین‌هاست. آن‌ها فقط سمت سرور اجرا می‌شوند، پس بازیکنان شما با کلاینت بدون تغییر Minecraft وصل می‌شوند و چیز اضافه‌ای دانلود نمی‌کنند. نیاز هر بازیکن به نصب فایل‌های مطابق همان چیزی است که مود را از پلاگین جدا می‌کند.

تقریباً همیشه یکی از سه چیز: پلاگین برای نسخه دیگری از Minecraft ساخته شده، وابستگی مورد نیازش (اغلب Vault) گم شده، یا سرور هنوز vanilla است و نه Paper یا Spigot. کنسول دلیل را هنگام راه‌اندازی چاپ می‌کند — اول آن خطا را بخوانید. مراحل رفع اشکال بالا هر مورد را توضیح می‌دهد.

بله، وقتی از منابع معتبر مثل SpigotMC، Modrinth و Hangar دانلود کنید. پلاگین کدی است با دسترسی کامل به سرور شما، پس از پلاگین‌های کرک‌شده یا پولی آپلود مجدد شده که راهی رایج برای پنهان‌کردن بدافزار هستند دوری کنید. قبل از افزودن پلاگین جدید یک بکاپ تک‌کلیکی بگیرید تا در صورت بدرفتاری همیشه بتوانید برگردید.

آماده‌اید یک سرور پلاگینی راه‌اندازی کنید؟

یک سرور Paper روی هایت‌هاست راه‌اندازی کنید، پلاگین‌هایتان را از پنل قرار دهید، و در چند دقیقه آنلاین باشید — مدیر فایل، SFTP، بکاپ تک‌کلیکی و محافظت DDoS ووکسیلیتی همه شامل می‌شود. دنیای موجودی دارید؟ انتقال رایگان است.

Live chat 8 AM – 11 PM (Chișinău time) · tickets answered during business hours