راهنمای مدیریت سرور Berno Factions (ادمین)

راهنمای مدیریت سرور Berno Factions

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

---

بخش ۱: مقدمه و مسئولیت‌های ادمین

تیم مدیریت یعنی چی؟

تیم مدیریت (Staff) سرور Berno Factions مسئول اینه که تجربه‌ی بازی برای همه‌ی فکشن‌ها منصفانه، امن و رقابتی بمونه. این مسئولیت شامل کارهای فنی (مثل تنظیم پلاگین‌ها، اقتصاد و مناطق امن) و کارهای اجتماعی (مثل رسیدگی به تخلفات بین فکشن‌ها و میانجی‌گری در اختلافات) می‌شه.

سلسله‌مراتب رتبه‌های مدیریتی

رتبه	حوزه‌ی مسئولیت
Helper	پاسخ به سوالات پلیرها، گزارش تخلفات به رتبه‌های بالاتر، مانیتور کردن چت
Moderator	اجرای مجازات‌ها (میوت/کیک/بن موقت)، رسیدگی به ادعاهای گریف و تقلب بین فکشن‌ها
Admin	مدیریت فنی سرور، تنظیم مناطق امن و اقتصاد، دسترسی کامل به پلاگین‌ها و دستورات ادمین فکشن
Owner	مدیریت کلی سرور، تصمیم‌گیری نهایی، مدیریت تیم ادمین

⚠️ نکته‌ی مهم: هر رتبه فقط باید در چارچوب اختیارات خودش عمل کنه. اگه با مشکلی مواجه شدی که خارج از حوزه‌ی مسئولیتته، حتماً به رتبه‌ی بالاتر گزارش بده؛ به‌جای اینکه خودسرانه دست به اقدام بزنی — مخصوصاً درباره‌ی دخالت مستقیم توی جنگ یا اقتصاد فکشن‌ها که می‌تونه به‌شدت روی تعادل بازی اثر بذاره.

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

---

بخش ۲: دسترسی‌ها و مدیریت رتبه‌ها (LuckPerms)

سرور از پلاگین LuckPerms برای مدیریت گروه‌ها، رتبه‌ها و پرمیشن‌ها استفاده می‌کنه. داده‌ها توی یه دیتابیس داخلی (H2) ذخیره می‌شن، پس تغییرات از طریق دستورات درون‌بازی یا وب‌ادیتور اعمال می‌شن — نیازی به دست‌زدن مستقیم به فایل دیتابیس نیست.

دستورات پایه‌ای مدیریت رتبه

دستور	کاربرد
/lp user <نام‌کاربری> parent add <گروه>	افزودن یه پلیر به یه گروه/رتبه
/lp user <نام‌کاربری> parent remove <گروه>	حذف پلیر از یه گروه
/lp user <نام‌کاربری> parent set <گروه>	جایگزین کردن رتبه‌ی فعلی پلیر با یه رتبه‌ی جدید (رتبه‌ی قبلی حذف می‌شه)
/lp user <نام‌کاربری> parent addtemp <گروه> <مدت>	افزودن رتبه‌ی موقت (مثلاً برای پاداش ساعتی/روزانه/هفتگی)
/lp user <نام‌کاربری> info	نمایش اطلاعات کامل یه پلیر شامل گروه‌ها و پرمیشن‌های مستقیمش
/lp group <گروه> permission set <پرمیشن> true/false	دادن یا گرفتن یه پرمیشن خاص از یه گروه
/lp editor	باز کردن وب‌ادیتور LuckPerms برای مدیریت بصری و راحت‌تر گروه‌ها و پرمیشن‌ها

رتبه‌های موقت (Temporary Ranks)

همون‌طور که توی راهنمای پلیرها هم اشاره شد، سرور از رتبه‌های موقت برای پاداش‌ها استفاده می‌کنه (گروه‌های hourly، daily و weekly که با ادعای پاداش‌های دوره‌ای به‌صورت خودکار به پلیر اضافه می‌شن و بعد از مدت مشخص خودشون رو حذف می‌کنن). این گروه‌ها معمولاً از طریق پلاگین دیگه‌ای (مثل سیستم پاداش روزانه) به LuckPerms دستور اضافه/حذف می‌دن، نه با دخالت دستی ادمین.

⚠️ نکته‌ی امنیتی مهم: هیچ‌وقت گروه Admin یا هر گروه با پرمیشن‌های حساس (مخصوصاً دستورات ادمین فکشن که در بخش ۳ توضیح داده می‌شن) رو به پلیر عادی، حتی به‌صورت موقت یا آزمایشی، نده. یه ادمین با دسترسی /f power set یا /f admin می‌تونه به‌سادگی تعادل کل بازی رو به‌هم بزنه.

ساخت یه گروه جدید

/lp creategroup <نام گروه>

بعد از ساخت گروه، باید پرمیشن‌های لازم رو با permission set یا از طریق وب‌ادیتور بهش اضافه کنی، و در صورت نیاز با parent بهش وراثت (inheritance) از گروه‌های دیگه بدی.

💡 توصیه: قبل از هرگونه تغییر بزرگ توی ساختار پرمیشن‌ها (مثلاً حذف یا ادغام گروه‌ها)، حتماً با /lp export یه نسخه‌ی پشتیبان از تنظیمات فعلی بگیر تا در صورت بروز مشکل بتونی برگردونیش.

---

بخش ۳: مدیریت فکشن‌ها (Admin Commands)

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

حالت بای‌پس ادمین (Admin Bypass)

/f admin

این دستور حالت بای‌پس رو برات فعال/غیرفعال می‌کنه. وقتی فعاله:

• می‌تونی داخل قلمرو هر فکشنی (حتی بدون عضویت) ساخت‌وساز کنی یا بلاک بشکنی.
• محدودیت‌های حفاظتی فکشن‌ها روت اعمال نمی‌شه.

⚠️ نکته‌ی مهم: همیشه بعد از اتمام کارت (مثلاً بعد از رفع یه مشکل خاص داخل قلمرو یه فکشن)، حتماً دوباره /f admin رو بزن تا بای‌پس غیرفعال بشه. فراموش کردن این کار می‌تونه به‌طور اتفاقی باعث خرابی ساختارهای پلیرها بشه.

مدیریت مستقیم پاور فکشن‌ها

دستور	کاربرد
/f power <نام‌کاربری> set <عدد>	تنظیم مستقیم پاور یه پلیر خاص به یه مقدار مشخص
/f power <نام‌کاربری> add <عدد>	افزودن مقدار مشخصی به پاور فعلی پلیر

💡 کاربرد رایج: اگه یه پلیر به‌خاطر باگ پلاگین یا کرش سرور پاورش رو ناعادلانه از دست داد، می‌تونی با این دستور جبرانش کنی.

انحلال و حذف فکشن

دستور	کاربرد
/f disband <نام فکشن>	انحلال اجباری یه فکشن (مثلاً برای فکشن‌هایی که برای اهداف مخرب یا تقلب ساخته شدن)
/f rename <نام فکشن> <نام جدید>	تغییر اجباری نام یه فکشن (مثلاً اگه نامش شامل کلمات نامناسب باشه)

مدیریت اعضا و رهبری

دستور	کاربرد
/f leader <نام فکشن> <نام‌کاربری>	تغییر اجباری رهبر فکشن (مثلاً وقتی رهبر قبلی حساب رو رها کرده یا بن دائم شده)
/f join <نام فکشن> <نام‌کاربری>	اضافه کردن اجباری یه پلیر به یه فکشن (به‌عنوان ادمین)
/f kick <نام‌کاربری> (با پرمیشن ادمین)	اخراج اجباری یه پلیر از فکشنش، صرف‌نظر از نقشش

مدیریت کلایم زمین

در حالت بای‌پس، دستورات عادی کلایم (/f claim، /f unclaim) هم روی قلمرو هر فکشنی کار می‌کنن. این برای رفع مشکلاتی مثل کلایم‌های اشتباه یا رها‌شده مفیده.

⚠️ نکته‌ی مهم: قبل از هر اقدام مستقیم روی یه فکشن (انحلال، تغییر پاور، اخراج اجباری)، حتماً مطمئن شو مستنداتت کافیه (لاگ، گزارش، شواهد). این دستورات به‌راحتی قابل بازگشت نیستن و می‌تونن باعث نارضایتی شدید پلیرها بشن اگه بی‌دلیل استفاده بشن.

---

بخش ۴: مدیریت مناطق امن (Safezone/Warzone)

سرور از ترکیب سیستم داخلی SaberFactions و پلاگین WorldGuard برای مدیریت مناطق امن و محدودیت‌های PvP استفاده می‌کنه.

تنظیم منطقه‌ی امن با SaberFactions

دستور	کاربرد
/f setsafezone	تبدیل چانک فعلی به منطقه‌ی امن (Safezone) — PvP و معمولاً ساخت‌وساز غیرمجاز غیرفعال می‌شه
/f setwarzone	تبدیل چانک فعلی به منطقه‌ی جنگ (Warzone) — معمولاً یه منطقه‌ی خنثی با قوانین PvP خاص برای همه
/f setwilderness	بازگردوندن یه چانک کلایم‌شده به حالت بی‌سرزمین (مثلاً برای پاک کردن یه کلایم قدیمی یا مشکل‌ساز)

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

تنظیم دقیق‌تر با WorldGuard

برای کنترل دقیق‌تر روی مناطق حساس (مثل جلوگیری از build حتی برای اعضای فکشن‌های خاص، یا تنظیم فلگ‌های پیچیده‌تر)، از ریجن‌های WorldGuard استفاده کن:

دستور	کاربرد
/rg define <نام ریجن>	ساخت یه ریجن جدید بر اساس انتخاب wand
/rg flag <نام ریجن> pvp deny	غیرفعال کردن PvP توی این ریجن
/rg flag <نام ریجن> build deny	جلوگیری از ساخت/شکستن بلاک توسط پلیرهای عادی
/rg flag <نام ریجن> tnt deny	غیرفعال کردن انفجار TNT توی این ریجن (حیاتی برای مناطق امن)
/rg info <نام ریجن>	نمایش اطلاعات کامل یه ریجن (محدوده، فلگ‌ها، اعضا)

⚠️ نکته‌ی مهم: برای منطقه‌ی اسپاون، حتماً فلگ‌های pvp، build و tnt رو روی deny بذار. فراموش کردن فلگ TNT یعنی حتی توی منطقه‌ی "امن" ممکنه یه پلیر بدخواه بتونه با TNT به ساختارهای اسپاون یا فروشگاه آسیب بزنه.

تعامل بین SaberFactions و WorldGuard

وقتی هر دو سیستم روی یه منطقه فعالن، معمولاً محدودکننده‌ترین قانون اعمال می‌شه. برای جلوگیری از تداخل و رفتار غیرمنتظره:

• مناطق کاملاً ثابت و حساس (اسپاون، لابی، فروشگاه) رو با WorldGuard مدیریت کن تا کنترل دقیق‌تری داشته باشی.
• مناطق پویا و مرتبط با گیم‌پلی فکشنی (safezone موقت، warzone) رو با دستورات خودِ SaberFactions مدیریت کن.

💡 توصیه: بعد از هر تغییر توی مناطق امن، حتماً با یه اکانت تست (نه اکانت ادمین که معمولاً بای‌پس داره) وارد اون منطقه بشو و مطمئن شو محدودیت‌ها واقعاً اعمال می‌شن.

---

بخش ۵: مدیریت اقتصاد سرور

سرور دو اقتصاد موازی داره: پول Vault (که بانک فکشن و اقتصاد عمومی باهاش کار می‌کنن) و Coins (که از طریق CoinsEngine مدیریت می‌شه و برای فروشگاه/کریت استفاده می‌شه). مدیریت درست هر دو برای جلوگیری از تورم و حفظ تعادل رقابتی حیاتیه.

مدیریت موجودی پول (Vault)

دستور	کاربرد
/eco give <نام‌کاربری> <مبلغ>	اضافه کردن سکه به حساب یه پلیر
/eco take <نام‌کاربری> <مبلغ>	کسر سکه از حساب یه پلیر
/eco set <نام‌کاربری> <مبلغ>	تنظیم مستقیم موجودی حساب یه پلیر به یه عدد مشخص
/balancetop	نمایش لیست پولدارترین پلیرهای سرور

مدیریت بانک فکشن

چون بانک فکشن هم روی همون سیستم اقتصادی Vault کار می‌کنه، معمولاً از طریق ابزارهای مدیریتی خود SaberFactions (نه مستقیماً eco) بررسیش می‌کنی:

/f balance <نام فکشن>

این دستور موجودی بانک هر فکشنی رو (نه فقط فکشن خودت) نشونت می‌ده — برای بررسی وضعیت اقتصادی کلی سرور یا رسیدگی به شکایات مالی مفیده.

مدیریت Coins (CoinsEngine)

دستور	کاربرد
/coinsengine give <نام‌کاربری> <مبلغ>	اضافه کردن Coins به حساب یه پلیر (مثلاً برای جبران خرید ناموفق یا جایزه‌ی مسابقه)
/coinsengine take <نام‌کاربری> <مبلغ>	کسر Coins از حساب یه پلیر
/coinsengine set <نام‌کاربری> <مبلغ>	تنظیم مستقیم موجودی Coins یه پلیر

⚠️ نکته‌ی مهم: استفاده از دستورات give باید محدود و مستند باشه. دادن پول یا Coins بی‌رویه به تورم اقتصاد سرور منجر می‌شه — این تورم توی سرورهای Factions مخصوصاً خطرناکه چون مستقیم روی توانایی فکشن‌ها برای خرید تجهیزات جنگی و رقابت اثر می‌ذاره.

بررسی دوره‌ای وضعیت اقتصاد

هر از چندگاهی (مثلاً هفتگی) پیشنهاد می‌شه:

• با /balancetop وضعیت کلی اقتصاد رو بررسی کنی — اگه یه پلیر یا فکشن خاص یهو موجودی غیرعادی بالایی داشت، ممکنه نشونه‌ی سوءاستفاده از یه باگ اقتصادی باشه.
• تراکنش‌های بزرگ و غیرعادی بانک فکشن‌ها رو (از طریق سیستم لاگ‌گیری که در بخش ۷ توضیح داده می‌شه) بررسی کنی.

---

بخش ۶: مدیریت کریت‌ها و پاداش‌ها

سیستم کریت سرور با پلاگین ExcellentCrates اداره می‌شه. این بخش نحوه‌ی مدیریت کریت‌ها، کلیدها و جوایز رو توضیح می‌ده.

ساختار کریت‌ها

هر کریت از چند بخش تشکیل شده:

• Crate (خود صندوق): شیء فیزیکی یا مجازی که پلیر باهاش تعامل می‌کنه.
• Key (کلید): آیتمی که برای باز کردن کریت لازمه.
• Rarity (نایابی): سطح‌بندی جوایز (مثلاً معمولی، کمیاب، افسانه‌ای).
• Opening (روند باز شدن): نوع انیمیشن/رفتار باز شدن کریت (مثلاً چرخشی یا فوری).

دستورات مدیریتی کریت

دستور	کاربرد
/crates give <نام‌کاربری> <نام کریت> <تعداد>	دادن یه کلید کریت مستقیم به پلیر (بدون نیاز به خرید یا رأی)
/crates reload	بارگذاری مجدد کانفیگ کریت‌ها بعد از تغییر دستی فایل‌ها
/crates editor	باز کردن ادیتور گرافیکی (در صورت پشتیبانی نسخه) برای ویرایش راحت‌تر جوایز و شانس‌ها

ویرایش شانس جوایز

هر جایزه‌ی داخل کریت یه وزن (Weight) داره که شانس دریافتش رو تعیین می‌کنه — وزن بالاتر یعنی احتمال بیشتر. فایل‌های مربوطه رو می‌تونی توی مسیر plugins/ExcellentCrates/ پیدا کنی.

⚠️ نکته‌ی مهم: قبل از تغییر وزن جوایز، به تعادل اقتصادی فکر کن. اگه جایزه‌های خیلی قدرتمند (مثل ابزار افسانه‌ای یا مقدار زیاد پول) شانس بالایی داشته باشن، ممکنه فکشن‌هایی که بیشتر کریت باز می‌کنن یه مزیت غیرمنصفانه پیدا کنن.

رویدادهای پاداش‌دهی دوره‌ای (CrazyEnvoys)

سرور از پلاگین CrazyEnvoys برای رویدادهای «Envoy» استفاده می‌کنه — یه صندوق پاداش که در زمان مشخصی از آسمون سقوط می‌کنه و پلیرها/فکشن‌ها برای رسیدن بهش با هم رقابت می‌کنن ( «There is an envoy event happening in 10m»).

دستور	کاربرد
/envoy start <تایر>	شروع دستی یه رویداد envoy با سطح جایزه‌ی مشخص (Tier1 تا Tier5)
/envoy stop	متوقف کردن رویداد envoy در حال اجرا

💡 توصیه: رویدادهای Envoy رو در ساعت‌های پرترافیک سرور برنامه‌ریزی کن تا بیشترین تعداد فکشن‌ها بتونن شرکت کنن و رقابت جذاب‌تر بشه. همچنین سطح‌های بالاتر (Tier4، Tier5) رو برای مناسبت‌های خاص (مثل جشن سالگرد سرور) نگه دار تا ارزششون حفظ بشه.

---

بخش ۷: ابزارهای نظارتی و برخورد با تخلف

این بخش دستورات پرکاربرد برای مدیریت رفتار پلیرها و رسیدگی به تخلفات، مخصوصاً اختلافات بین‌فکشنی که توی سرورهای Factions خیلی رایج هستن، رو پوشش می‌ده.

دستورات پایه‌ای مجازات

دستور	کاربرد
/kick <نام‌کاربری> <دلیل>	اخراج فوری پلیر از سرور
/mute <نام‌کاربری> <مدت> <دلیل>	سکوت موقت پلیر در چت
/ban <نام‌کاربری> <دلیل>	بن دائمی پلیر از سرور
/tempban <نام‌کاربری> <مدت> <دلیل>	بن موقت (مثلاً برای تخلفات متوسط مثل تقلب سبک)
/unban <نام‌کاربری>	لغو بن یه پلیر
/warn <نام‌کاربری> <دلیل>	ثبت یه اخطار رسمی برای پلیر

ابزارهای نظارت بی‌صدا

دستور	کاربرد
/vanish	مخفی شدن ادمین از دید بقیه‌ی پلیرها؛ برای نظارت بی‌طرفانه روی درگیری‌های PvP بدون جلب توجه
/socialspy	دیدن پیام‌های خصوصی (msg) رد و بدل‌شده بین پلیرها؛ برای بررسی گزارش آزار یا تبانی مشکوک بین فکشن‌ها
/tp <نام‌کاربری>	تله‌پورت مستقیم به یه پلیر (برای بررسی موقعیت یا نظارت میدانی روی صحنه‌ی یه درگیری)

بررسی تاریخچه‌ی تخریب/ساخت بلاک

سرور یه سیستم لاگ‌گیری کامل بلاک داره که تمام تغییرات دنیا (گذاشتن بلاک، شکستن، برداشتن آیتم از چست و...) رو با جزئیات ثبت می‌کنه. از این ابزار برای بررسی ادعاهای رایج زیر استفاده کن:

• «فکشن X با exploit وارد قلمرو ما شد و تخته‌سنگمون رو دزدید» — می‌شه دقیقاً دید کی، کِی و چه بلاکی رو شکسته/برداشته.
• «یکی از پلیرهای فکشن ما پول از بانک مشترک دزدیده» — از سیستم ممیزی فکشن (بخش ۹ راهنمای پلیر) در کنار لاگ بلاک استفاده کن.
• بازگردوندن (Rollback) تغییرات ناشی از یه گریف یا exploit ثابت‌شده.

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

رسیدگی به شکایات دیپلماتیک بین فکشن‌ها

خیلی از "شکایات" توی سرورهای Factions در واقع بخشی از گیم‌پلی عادین (جنگ، حمله، دزدی از دشمن) و نیازی به دخالت ادمین ندارن. قبل از دخالت، این چک‌لیست رو بررسی کن:

1. آیا دو فکشن رابطه‌ی دشمن یا جنگ داشتن؟ اگه بله، درگیری و حتی دزدی از قلمروشون معمولاً بخشی از قوانین عادی بازیه.
2. آیا از یه exploit یا باگ استفاده شده، یا صرفاً استراتژی هوشمندانه بوده؟
3. آیا شواهد کافی (لاگ، اسکرین‌شات) برای اثبات ادعا وجود داره؟

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

---

بخش ۸: مدیریت هولوگرام و نمایش اطلاعات (DecentHolograms)

پلاگین DecentHolograms برای نمایش متن‌های شناور سه‌بعدی (هولوگرام) توی لابی و اسپاون استفاده می‌شه؛ مثلاً برای نمایش لیدربرد فکشن‌های برتر، تابلوهای اطلاع‌رسانی یا راهنمای فروشگاه.

دستورات پایه‌ای

دستور	کاربرد
/dh create <نام هولوگرام>	ساخت یه هولوگرام جدید در محل فعلی ایستادنت
/dh addline <نام هولوگرام> <متن>	افزودن یه خط متن جدید به هولوگرام
/dh setline <نام هولوگرام> <شماره خط> <متن جدید>	ویرایش یه خط مشخص از هولوگرام
/dh movehere <نام هولوگرام>	جابه‌جا کردن هولوگرام به محل فعلی ایستادنت
/dh delete <نام هولوگرام>	حذف کامل هولوگرام

کاربردهای رایج روی سرور Berno Factions

• لیدربرد فکشن‌های برتر: نمایش فکشن‌هایی که بیشترین پاور، بیشترین زمین کلایم‌شده، یا بیشترین پول رو دارن — با کمک ajLeaderboards که برای همین منظور روی سرور نصبه.
• تابلوی مناطق امن: نمایش قوانین منطقه‌ی اسپاون یا راهنمای ورود به مناطق مختلف.
• تابلوی اطلاع‌رسانی رویدادها: اعلان زمان رویدادهای Envoy، مسابقات یا تخفیف‌های فروشگاه.

لیدربرد فکشن‌ها با ajLeaderboards

پلاگین ajLeaderboards برای ساخت لیدربردهای پویا (که خودکار به‌روزرسانی می‌شن) کنار هولوگرام استفاده می‌شه. برای مدیریتش:

دستور	کاربرد
/ajlb create <نام برد>	ساخت یه لیدربرد جدید (مثلاً بر اساس پاور فکشن یا موجودی)
/ajlb reload	بارگذاری مجدد تنظیمات لیدربردها بعد از تغییر کانفیگ

💡 نکته‌ی فنی: برای نمایش رتبه‌بندی فکشن‌ها، از placeholder های PlaceholderAPI متصل به دیتای SaberFactions استفاده می‌شه (مثل placeholder های موجود تحت expansion factionsuuid که در لاگ سرور دیدیم به‌عنوان PlaceholderAPI ثبت شده). این‌ها امکان نمایش زنده‌ی پاور، تعداد اعضا و رتبه‌ی هر فکشن رو فراهم می‌کنن.

⚠️ نکته‌ی مهم: هولوگرام‌های زیاد و متن طولانی می‌تونن روی عملکرد کلاینت پلیرهای با سیستم ضعیف‌تر اثر بذارن؛ سعی کن هولوگرام‌ها رو محدود و هدفمند نگه داری.

---

بخش ۹: مانیتورینگ عملکرد سرور (spark)

پلاگین spark یه ابزار حرفه‌ای برای پروفایل‌گیری (Profiling) و بررسی علت لگ سرور است. وقتی سرور دچار افت TPS (تعداد تیک در ثانیه) یا لگ محسوس می‌شه — که توی سرورهای Factions معمولاً وسط نبردهای بزرگ چند فکشنی یا موقع محاصره‌ها (Siege) با TNT زیاد اتفاق می‌افته — این ابزار کمکت می‌کنه دقیقاً بفهمی مشکل از کجاست.

بررسی سریع وضعیت سرور

دستور	کاربرد
/spark tps	نمایش TPS فعلی سرور (عدد ایده‌آل: ۲۰). افت زیر ۱۸-۱۹ نشونه‌ی مشکل جدیه
/spark healthreport	گزارش کلی سلامت سرور شامل TPS، مصرف CPU، مصرف RAM و وضعیت GC
/spark tickmonitor	مانیتور کردن زنده‌ی تیک‌های سرور برای پیدا کردن تیک‌های کند

پروفایل‌گیری برای پیدا کردن علت دقیق لگ

/spark profiler start

این دستور شروع به ضبط دقیق فعالیت سرور می‌کنه. بذار چند دقیقه (مخصوصاً وقتی چند فکشن هم‌زمان درگیر نبرد یا محاصره‌ن) ادامه پیدا کنه، بعد با دستور زیر متوقفش کن:

/spark profiler stop

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

سناریوهای رایج و راه‌حل

علامت	اقدام پیشنهادی
افت شدید TPS موقع نبرد چند فکشنی با TNT زیاد	بررسی تعداد entity های انفجار و به‌روزرسانی‌های فیزیک بلاک با spark profiler؛ در صورت نیاز محدود کردن تعداد TNT قابل‌انفجار هم‌زمان از طریق تنظیمات سرور
افت TPS در مناطقی با کلایم زیاد و ساخت‌وساز سنگین	بررسی سهم WorldGuard و SaberFactions در پردازش هر تیک، مخصوصاً موقع بررسی محدوده‌ی کلایم‌ها
افت مصرف RAM به‌مرور زمان (Memory Leak احتمالی)	بررسی healthreport بعد از چند ساعت آپ‌تایم؛ در صورت رشد غیرعادی، بررسی به‌روزرسانی پلاگین‌های مشکوک (طبق تجربه‌ی قبلی سرور، FastAsyncWorldEdit و چند پلاگین دیگه به‌روزرسانی معوق داشتن)
لگ لحظه‌ای شدید (Freeze کوتاه)	بررسی tickmonitor برای پیدا کردن تیک‌های خیلی کند و زمان دقیق وقوعشون

💡 توصیه: یه گزارش healthreport رو در حالت عادی (بدون نبرد بزرگ) هم بگیر و نگه دار تا به‌عنوان مبنای مقایسه، هروقت وسط یه نبرد بزرگ لگ پیش اومد، سریع بفهمی چه چیزی غیرعادیه.

---

بخش ۱۰: بک‌آپ‌گیری و نگهداری سرور

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

چه چیزهایی باید بک‌آپ بگیریم؟

مورد	اهمیت
دنیای اصلی بازی (overworld/nether/end)	بالا — از دست رفتنش یعنی از دست رفتن تمام کلایم‌ها و ساخت‌وسازهای فکشن‌ها
پوشه plugins/ (شامل تمام کانفیگ‌ها)	بالا — شامل کانفیگ SaberFactions، تنظیمات LuckPerms، کریت‌ها و...
دیتابیس اقتصاد (Vault) و Coins	بحرانی — از دست رفتنش یعنی از دست رفتن موجودی شخصی و بانک تمام فکشن‌ها
دیتابیس فکشن‌ها (SaberFactions)	بحرانی — شامل تمام اطلاعات فکشن‌ها (اعضا، پاور، کلایم، روابط دیپلماتیک)؛ از دست رفتنش عملاً یعنی شروع مجدد کل سرور از صفر
دیتابیس LuckPerms	بالا — از دست رفتنش یعنی همه به گروه پیش‌فرض برمی‌گردن

زمان‌بندی پیشنهادی بک‌آپ

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

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

ری‌استارت امن سرور

1. قبل از ری‌استارت، یه پیام هشدار توی چت به همه‌ی پلیرها بده.
2. مطمئن شو هیچ محاصره یا نبرد بزرگ فعالی در حال وقوع نیست؛ در صورت امکان صبر کن تا درگیری‌های حساس تموم بشن — ری‌استارت وسط یه محاصره می‌تونه باعث اختلاف نظر و شکایت شدید بین فکشن‌ها بشه.
3. با دستور /save-all مطمئن شو تمام تغییرات دنیا ذخیره شدن.
4. سرور رو ری‌استارت کن و بعد از بالا اومدن، بررسی کن پلاگین‌های اصلی (به‌خصوص SaberFactions و اقتصاد) درست بارگذاری شدن.

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

💡 توصیه: هیچ‌وقت پلاگین اصلی (مثل SaberFactions یا WorldGuard) رو مستقیم روی سرور اصلی و بدون تست آپدیت نکن. ابتدا نسخه‌ی جدید رو روی یه سرور تست (Staging) امتحان کن، مطمئن شو کانفیگ‌های فعلی باهاش سازگارن ، بعد روی سرور اصلی اعمالش کن.

همیشه قبل از هر آپدیت پلاگین:

• changelog نسخه‌ی جدید رو بخون تا از تغییرات ساختار کانفیگ مطلع بشی.
• از فایل‌های کانفیگ فعلی همون پلاگین یه بک‌آپ جدا بگیر.
• در ساعت کم‌ترافیک آپدیت رو انجام بده.

---

بخش ۱۱: رأی‌گیری و رشد سرور (Votifier)

پلاگین Votifier امکان اتصال سرور به سایت‌های لیست سرور ماینکرفت رو فراهم می‌کنه. وقتی یه پلیر توی یکی از این سایت‌ها به سرور رأی می‌ده، Votifier اون رأی رو دریافت و به سرور اعلام می‌کنه تا بشه پاداشی بهش داد. سرور از پلاگین SuperbVote هم برای مدیریت راحت‌تر رأی‌ها و پاداش‌ها استفاده می‌کنه.

اتصال به یه سایت لیست سرور جدید

1. توی سایت لیست سرور موردنظر، سرور رو ثبت کن و آدرس IP و پورت Votifier (پیش‌فرض 8192، همون‌طور که توی لاگ‌های سرور هم دیدیم: Votifier enabled on socket ... :8192) رو بهش بده.
2. مطمئن شو پورت Votifier روی فایروال سرور باز باشه.
3. کلید رمزنگاری عمومی (Public Key) که Votifier می‌سازه رو توی همون سایت وارد کن تا ارتباط امن برقرار بشه.

⚠️ نکته‌ی مهم: کلید خصوصی Votifier (Private Key) رو هیچ‌وقت جایی به اشتراک نذار — این کلید فقط باید روی خودِ سرور بمونه.

تنظیم پاداش رأی با SuperbVote

دستور	کاربرد
/superbvote reload	بارگذاری مجدد کانفیگ بعد از تغییر دستی فایل پاداش‌ها
/vote	نمایش لینک‌های رأی‌گیری به پلیر (این دستور در اختیار خودِ پلیرهاست)

از طریق فایل کانفیگ SuperbVote می‌تونی دقیقاً مشخص کنی هر رأی چه پاداشی (سکه، Coins، کلید کریت یا حتی یه آیتم خاص) به پلیر بده. با توجه به این‌که ExcellentCrates هم روی سرور نصبه، پیشنهاد می‌شه پاداش رأی رو به یه کلید کریت معمولی وصل کنی — این هم انگیزه‌ی رأی دادن رو بالا می‌بره و هم پلیر رو با سیستم کریت آشنا می‌کنه.

💡 توصیه: پاداش رأی رو متناسب با ارزش اقتصاد سرور تنظیم کن — نه اونقدر کم که کسی انگیزه‌ی رأی دادن نداشته باشه، نه اونقدر زیاد که باعث تورم اقتصاد بشه (بخش ۵ رو ببین).

بررسی وضعیت رأی‌ها

SuperbVote آماری از تعداد رأی‌های روزانه/هفتگی/ماهانه و لیدربرد رأی‌دهندگان برتر ارائه می‌ده. بررسی دوره‌ای این آمار به تیم مدیریت کمک می‌کنه بفهمه کدوم سایت‌های لیست سرور بیشترین بازدید و رأی‌دهی رو براتون میارن، تا روی همون‌ها بیشتر سرمایه‌گذاری کنید.

---

بخش ۱۲: رویه‌ی اضطراری و رسیدگی به مشکلات فنی

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

مشکلات ناسازگاری نسخه و پلاگین‌ها

• پلاگین‌هایی که موقع فعال‌سازی کرش می‌کنن ولی روی شبکه هوک می‌زنن (مثل ForcePack و Themis روی نسخه‌ی نامناسب): این پلاگین‌ها می‌تونن باعث بشن هیچ پلیری نتونه وصل بشه، حتی اگه خودِ سرور «Done!» نشون بده. علامت مشخصه‌شون خطای zip file closed یا zip file error توی لاگ، دقیقاً وقتی یه پلیر تلاش می‌کنه وصل بشه.
• دو نسخه از یه پلاگین هم‌زمان نصب : باعث خطای «Ambiguous plugin name» می‌شه و رفتار پلاگین غیرقابل‌پیش‌بینی می‌کنه.
• پلاگینی که با نسخه‌ی سرور سازگار نیست (مثل Citizens که با پیام «not compatible with your version of Minecraft» خودش رو غیرفعال میکنه): این نوع مشکل معمولاً کل سرور رو خراب نمی‌کنه، فقط همون قابلیت از کار می‌افته.

چک‌لیست سریع عیب‌یابی

1. لاگ کنسول رو از بالا به پایین بخون و دنبال کلمات ERROR، WARN و Disabling بگرد.
2. اگه سرور بالا اومده ولی پلیرها نمی‌تونن وصل بشن، دنبال خطاهایی بگرد که دقیقاً هم‌زمان با تلاش پلیر برای اتصال ظاهر می‌شن (نه خطاهای مربوط به مرحله‌ی startup).
3. مشخص کن کدوم پلاگین مقصره (اسمش معمولاً توی خط خطا مشخصه) و فایل jarش رو موقت جابه‌جا/حذف کن.
4. سرور رو ری‌استارت کن و دوباره تست بگیر.

کرش کامل سرور

1. خونسرد باش — قبل از هر اقدامی، لاگ آخرین خطوط کنسول سرور (یا فایل logs/latest.log) رو بررسی کن تا علت کرش مشخص بشه.
2. اگه علت یه پلاگین خاص بود، همون پلاگین رو موقتاً غیرفعال کن و دوباره سرور رو بالا بیار.
3. اگه علت نامشخص بود یا فایل‌های دنیا خراب شده بودن، از آخرین بک‌آپ سالم (بخش ۱۰) استفاده کن.
4. بعد از بازگشت سرور، توی چند دقیقه‌ی اول عملکرد رو با /spark healthreport بررسی کن.

حمله یا سوءاستفاده‌ی جدی

1. در صورت مشکوک بودن به نفوذ (مثل تغییرات ناگهانی و غیرمجاز توی کانفیگ‌ها، رتبه‌ها یا پاور/کلایم یه فکشن)، فوراً دسترسی پنل و رمزهای مدیریتی رو تغییر بده.
2. بررسی کن آیا رتبه‌ی Admin/Owner یا دسترسی /f admin به‌صورت غیرمجاز به کسی داده شده — در صورت وجود، فوراً پسش بگیر.
3. موضوع رو به کل تیم مدیریت اطلاع بده تا هماهنگ عمل کنید.
4. در صورت لزوم، سرور رو موقتاً ببند (Whitelist On) تا وضعیت کاملاً بررسی و امن بشه.

⚠️ نکته‌ی مهم: در هر شرایط اضطراری، اولویت اول امنیت داده‌های پلیرها و فکشن‌ها (اقتصاد، کلایم، روابط دیپلماتیک) است، نه سرعت بازگشت سرور. بهتره چند دقیقه بیشتر طول بکشه ولی مطمئن بشی داده‌ای از دست نرفته — به‌خصوص چون بازسازی رابطه‌های دیپلماتیک و پاور فکشن‌ها به‌سادگی بک‌آپ بلاک ممکن نیست.

چک‌لیست سریع پیش از تماس با تیم فنی/توسعه‌دهنده

• لاگ کامل خطا یا کرش رو ذخیره کن
• زمان دقیق وقوع مشکل رو یادداشت کن
• لیست هرگونه تغییر اخیر (آپدیت پلاگین، تغییر کانفیگ، نصب پلاگین جدید) رو آماده کن
• در صورت وجود، اسکرین‌شات یا ویدیو از رفتار غیرعادی بگیر

---

پایان راهنما

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

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