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

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

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

---

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

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

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

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

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

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

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

---

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

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

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

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

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

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

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

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

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

---

بخش ۳: ساخت و مدیریت آرنای BedWars (MBedwars)

موتور اصلی گیم‌پلی سرور پلاگین MBedwars است. این بخش مراحل کلی ساخت یه نقشه‌ی جدید و مدیریت آرناهای موجود رو پوشش می‌ده. برای ساخت آرنا نیاز داری با دسترسی ادمین و توی گیم‌مود Creative روی دنیای مخصوص همون نقشه کار کنی.

ساخت آرنای جدید

دستور	کاربرد
/mbedwars arena create <نام آرنا>	ساخت یه آرنای خالی جدید با نام مشخص
/mbedwars arena wand	دریافت ابزار wand برای انتخاب محدوده و نقاط مهم نقشه (مثل انتخاب دو گوشه‌ی محدوده‌ی بازی)
/mbedwars arena setboundary <نام آرنا>	تنظیم محدوده‌ی کلی نقشه بر اساس انتخاب wand
/mbedwars arena setlobby <نام آرنا>	تنظیم نقطه‌ی لابی انتظار مخصوص همون آرنا
/mbedwars arena setspec <نام آرنا>	تنظیم نقطه‌ی اسپاون حالت اسپکتیتور

تنظیم تیم‌ها

برای هر تیمی که می‌خوای توی نقشه فعال باشه (مثلاً قرمز، آبی، سبز، زرد)، باید مراحل زیر رو تکرار کنی:

1. ساخت/فعال‌سازی تیم با /mbedwars arena addteam <نام آرنا> <رنگ تیم>
2. ایستادن روی محل تخت مدنظر و اجرای /mbedwars arena setbed <نام آرنا> <رنگ تیم>
3. ایستادن روی نقطه‌ی اسپاون تیم و اجرای /mbedwars arena setspawn <نام آرنا> <رنگ تیم>
4. تعیین حداکثر تعداد پلیر هر تیم با /mbedwars arena setmaxplayers <نام آرنا> <عدد>

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

تنظیم جنریتورهای منابع

برای هر نوع جنریتور (آیرون، گلد، دیاموند، امرالد)، باید روی نقطه‌ی موردنظر بایستی و دستور مناسب رو بزنی:

دستور	کاربرد
/mbedwars arena addspawner <نام آرنا> iron	افزودن جنریتور آیرون در محل فعلی (معمولاً کنار هر تخت)
/mbedwars arena addspawner <نام آرنا> gold	افزودن جنریتور گلد (معمولاً کنار هر تخت)
/mbedwars arena addspawner <نام آرنا> diamond	افزودن جنریتور دیاموند (معمولاً وسط نقشه یا نقاط مشترک)
/mbedwars arena addspawner <نام آرنا> emerald	افزودن جنریتور امرالد (معمولاً وسط نقشه یا نقاط مشترک)

سرعت پیش‌فرض تولید این جنریتورها از فایل spawners.yml خونده می‌شه (آیرون هر ۱ ثانیه، گلد هر ۴ ثانیه، دیاموند هر ۳۰ ثانیه، امرالد هر ۵۰ ثانیه)؛ برای تغییر این مقادیر می‌تونی مستقیم فایل رو ویرایش و سرور رو ری‌لود کنی.

فعال‌سازی و تست آرنا

دستور	کاربرد
/mbedwars arena setstate <نام آرنا> enabled	فعال کردن آرنا تا پلیرها بتونن واردش بشن
/mbedwars arena setstate <نام آرنا> disabled	غیرفعال کردن آرنا (مثلاً برای بازسازی یا رفع باگ)
/mbedwars arena forcestart <نام آرنا>	شروع اجباری بازی برای تست، بدون نیاز به رسیدن به حداقل تعداد پلیر
/mbedwars arena join <نام آرنا>	ورود مستقیم ادمین به یه آرنای مشخص برای تست

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

حذف یا بازسازی یه آرنا

/mbedwars arena delete <نام آرنا>

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

---

بخش ۴: مدیریت فروشگاه‌ها و ارتقاها

هر دو فروشگاه بازی (Shop) و فروشگاه ارتقای تیمی (Upgrade Shop) از طریق فایل‌های کانفیگ پلاگین MBedwars قابل ویرایش هستن. این فایل‌ها رو می‌تونی هم دستی (با ویرایشگر متن) و هم از طریق GUI درون‌بازی ویرایش کنی.

مسیر فایل‌های مربوطه

فایل	محتوا
plugins/MBedwars/shop.yml	آیتم‌های فروشگاه عادی بازی (بلاک، غذا، زره، شمشیر/کمان، کلنگ، معجون، آیتم‌های ویژه)
plugins/MBedwars/upgrade-shop.yml	ارتقاهای تیمی (Sharpness، Protection، Haste، Generator Multiplier، Heal Pool) و تله‌ها

ویرایش از طریق GUI درون‌بازی

/mbedwars shopeditor

این دستور یه رابط گرافیکی باز می‌کنه که می‌تونی مستقیم توش:

• آیتم جدید به یه دسته اضافه کنی (فقط کافیه آیتم موردنظر رو توی دستت بگیری و توی GUI قرارش بدی)
• قیمت یه آیتم موجود رو تغییر بدی
• یه آیتم رو کامل از فروشگاه حذف کنی
• ترتیب نمایش دسته‌ها و آیتم‌ها رو جابه‌جا کنی

💡 استفاده از GUI برای تغییرات کوچیک و سریع (مثل تغییر قیمت یه آیتم) خیلی راحت‌تر و کم‌خطرتر از ویرایش دستی فایل YAML هست، چون خطای سینتکسی (Syntax Error) نمی‌ده.

ویرایش دستی فایل YAML

برای تغییرات بزرگ‌تر (مثل افزودن یه دسته‌ی کاملاً جدید یا تغییر ساختار) بهتره مستقیم فایل رو ویرایش کنی. ساختار کلی هر آیتم توی shop.yml این شکلیه:

material: نوع بلاک/آیتم ماینکرفتی  |  amount: تعداد دریافتی  |  cost: قیمت و نوع منبع (آیرون/گلد/دیاموند/امرالد)

و برای upgrade-shop.yml، هر ارتقا شامل سطوح مختلف (levels) با قیمت جداگانه برای هر سطح است.

⚠️ نکته‌ی مهم: فایل‌های YAML به تورفتگی (indentation) خیلی حساس هستن. قبل از ویرایش دستی، حتماً یه نسخه‌ی پشتیبان از فایل بگیر، و بعد از هر تغییر با یه ویرایشگر آنلاین YAML سینتکس رو چک کن.

اعمال تغییرات بدون ری‌استارت سرور

/mbedwars reload

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

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

---

بخش ۵: مدیریت دستاوردها (Achievements)

لیست دستاوردهای بازی توی فایل plugins/MBedwars/achievements.yml تعریف شده. هر دستاورد یه شناسه‌ی یکتا (مثل bedwars:win_round) و یه مقدار enabled داره که مشخص می‌کنه فعاله یا نه.

فعال یا غیرفعال کردن یه دستاورد

برای غیرفعال کردن یه دستاورد خاص (مثلاً اگه به‌خاطر باگ یا سوءاستفاده تصمیم گرفتید موقتاً خاموشش کنید)، کافیه توی فایل achievements.yml مقدار enabled اون دستاورد رو از true به false تغییر بدی و بعد دستور /mbedwars reload رو بزنی.

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

افزودن پاداش به دستاوردها

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

• اتصال با EconomyBridge/Vault: از طریق تنظیمات پلاگین اقتصادی، میشه روی رویداد کسب دستاورد (Achievement Event) یه واکنش خودکار (مثل واریز سکه) تعریف کرد.
• استفاده از skUtilities (اسکریپت): چون سرور skUtilities نصب داره، میشه یه اسکریپت ساده نوشت که وقتی یه پلیر دستاورد خاصی رو می‌گیره، مقدار مشخصی سکه بهش پاداش بده. این کار نیاز به دانش ابتدایی Skript داره.

💡 توصیه: اگه قصد دارید سیستم پاداش برای دستاوردها راه بندازید، بهتره اول با تیم فنی هماهنگ کنید تا مطمئن بشید اقتصاد سرور (بخش ۷ رو ببینید) با تورم بی‌مورد به‌هم نمی‌خوره.

افزودن دستاورد جدید

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

⚠️ نکته‌ی مهم: قبل از هرگونه تغییر توی achievements.yml، حتماً یه نسخه‌ی پشتیبان از فایل بگیر — ساختار ID دستاوردها باید دقیقاً مطابق مستندات رسمی پلاگین باشه، وگرنه ممکنه هنگام بارگذاری خطا بگیری.

---

بخش ۶: مدیریت مناطق و محافظت (WorldGuard)

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

ساخت یه ریجن جدید

1. با یه wand انتخاب (پیش‌فرض: تبر چوبی) دو گوشه‌ی محدوده‌ی موردنظر رو با راست‌کلیک و چپ‌کلیک مشخص کن.
2. دستور /rg define <نام ریجن> رو بزن تا ریجن ساخته بشه.

دستورات پرکاربرد مدیریت ریجن

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

فلگ‌های پیشنهادی برای لابی اصلی

فلگ	مقدار پیشنهادی	دلیل
build	deny	جلوگیری از گریف و ساخت‌وساز غیرمجاز در لابی
pvp	deny	لابی باید فضای امن و بدون نبرد باشه
mob-spawning	deny	جلوگیری از اسپاون موجودات مزاحم توی لابی
item-drop / item-pickup	deny	جلوگیری از پخش شدن آیتم‌های اضافی روی زمین لابی

⚠️ نکته‌ی مهم: قبل از تنظیم فلگ entry deny روی هر ریجنی، حتماً مطمئن شو خودت (یا گروه Admin) با /rg addmember یا پرمیشن bypass، از این محدودیت مستثنی هستید؛ وگرنه ممکنه خودتون هم دیگه نتونید واردش بشید.

بررسی سریع علت مسدود شدن یه اقدام

/rg flag <نام ریجن>

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

---

بخش ۷: مدیریت اقتصاد سرور (Vault / EconomyBridge)

اقتصاد سکه‌ای سرور (همونی که پلیرها با /balance و /pay باهاش کار می‌کنن) از طریق Vault به‌عنوان API واسط، و EconomyBridge به‌عنوان موتور اصلی مدیریت اقتصاد، اداره می‌شه. یادت باشه این اقتصاد کاملاً مجزا از منابع داخل آرنا (آیرون/گلد/دیاموند/امرالد) است که فقط داخل یه بازی معتبرن.

دستورات مدیریت موجودی پلیرها

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

⚠️ نکته‌ی مهم: استفاده از /eco give باید محدود و مستند باشه (مثلاً برای جبران یه باگ یا جایزه‌ی مسابقه). دادن سکه‌ی بی‌رویه به تورم اقتصاد سرور منجر می‌شه و ارزش سکه رو برای همه پایین می‌آره.

تنظیم موجودی اولیه‌ی پلیرهای جدید

مبلغ ۵۰۰ سکه‌ای که هر پلیر جدید هنگام اولین ورود دریافت می‌کنه، از طریق تنظیمات EconomyBridge یا اسکریپت مربوط به رویداد اولین ورود (First Join) کنترل می‌شه. برای تغییر این مقدار، باید فایل کانفیگ مربوط به همین رویداد رو پیدا و ویرایش کنی و بعد سرور یا حداقل پلاگین مربوطه رو ری‌لود کنی.

مدیریت فروشگاه سرور

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

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

---

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

این بخش دستورات پرکاربرد برای مدیریت رفتار پلیرها و رسیدگی به تخلفات رو پوشش می‌ده. این دستورات معمولاً از طریق EssentialsX/CMI و ابزارهای مدیریتی پایه‌ی سرور در دسترسن.

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

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

⚠️ نکته‌ی مهم: همیشه دلیل مجازات رو دقیق و مشخص بنویس (مثلاً «استفاده از X-Ray در آرنای Skyline» به‌جای فقط «تقلب»). این کار هم برای شفافیت با خودِ پلیر لازمه، هم برای بررسی احتمالی توسط رتبه‌های بالاتر.

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

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

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

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

• بررسی اینکه چه کسی یه بلاک خاص (مثلاً یه تخت) رو شکسته و کِی
• برگردوندن (Rollback) تغییرات ناشی از یه گریف یا exploit
• بررسی سابقه‌ی فعالیت یه پلیر خاص توی یه محدوده‌ی مشخص

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

رسیدگی به گزارش‌های تقلب توی آرنای BedWars

1. از پلیر گزارش‌دهنده بخواه اسم دقیق مظنون و زمان تقریبی اتفاق رو بگه.
2. در صورت امکان، با /vanish وارد همون آرنا شو و رفتار مظنون رو از نزدیک زیر نظر بگیر.
3. اگه سیستم ضد تقلب هشدار داده، لاگ هشدارها رو بررسی کن.
4. در صورت اطمینان از تخلف، طبق شدت تخلف از /warn، /tempban یا /ban استفاده کن.

---

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

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

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

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

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

• لیدربرد پلیرهای برتر: نمایش رتبه‌ی پلیرها بر اساس تعداد برد یا نسبت کشتن/مرگ (K/D) — معمولاً با کمک placeholder های آماری متصل به دیتای MBedwars.
• تابلوی راهنمای آرناها: نمایش لیست آرناهای فعال، تعداد پلیر هر کدوم و وضعیت (در انتظار / در حال اجرا) کنار NPC یا نشانه‌ی ورود به بازی.
• تابلوی اطلاع‌رسانی: اعلان رویدادها، تخفیف‌های فروشگاه سرور یا قوانین مهم.

💡 نکته‌ی فنی: برای نمایش داده‌ی زنده (مثل تعداد پلیر آنلاین یا رتبه‌ها) داخل متن هولوگرام، از placeholder ها (مثلاً از طریق PlaceholderAPI در صورت نصب) استفاده می‌شه. متن‌های ثابت مثل قوانین یا تبلیغات نیازی به placeholder ندارن.

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

---

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

پلاگین spark یه ابزار حرفه‌ای برای پروفایل‌گیری (Profiling) و بررسی علت لگ سرور است. وقتی سرور دچار افت TPS (تعداد تیک در ثانیه) یا لگ محسوس می‌شه، این ابزار کمکت می‌کنه دقیقاً بفهمی کدوم بخش (پلاگین خاص، یه تابع سنگین، یا خودِ دنیا) مقصره.

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

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

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

/spark profiler start

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

/spark profiler stop

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

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

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

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

---

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

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

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

مورد	اهمیت
دنیای لابی و دنیای هر آرنا	بالا — از دست رفتنش یعنی از دست رفتن کل ساخت‌وساز نقشه‌ها
پوشه plugins/ (شامل تمام کانفیگ‌ها)	بالا — شامل shop.yml، upgrade-shop.yml، achievements.yml، تنظیمات LuckPerms و...
دیتابیس اقتصاد و پیشرفت پلیرها	بحرانی — از دست رفتنش یعنی از دست رفتن موجودی و پیشرفت همه‌ی پلیرها
دیتابیس LuckPerms (luckperms-h2-v2.mv.db)	بالا — از دست رفتنش یعنی همه به گروه پیش‌فرض برمی‌گردن

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

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

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

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

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

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

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

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

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

---

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

پلاگین Votifier امکان اتصال سرور به سایت‌های لیست سرور ماینکرفت (مثل سایت‌های Server-List) رو فراهم می‌کنه. وقتی یه پلیر توی یکی از این سایت‌ها به سرور رأی می‌ده، Votifier اون رأی رو دریافت و به سرور اعلام می‌کنه تا بشه پاداشی بهش داد. این کار هم به دیده‌شدن بیشتر سرور کمک می‌کنه و هم انگیزه‌ی اضافه برای پلیرها ایجاد می‌کنه.

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

1. توی سایت لیست سرور موردنظر، سرور رو ثبت کن و آدرس IP و پورت Votifier (که توی کانفیگ Votifier مشخص شده) رو بهش بده.
2. مطمئن شو پورت Votifier (پیش‌فرض معمولاً ۸۱۹۲) روی فایروال سرور باز باشه.
3. کلید رمزنگاری عمومی (Public Key) که Votifier می‌سازه رو توی همون سایت وارد کن تا ارتباط امن برقرار بشه.

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

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

برای اینکه پلیرها بعد از رأی دادن یه پاداش (مثل سکه یا آیتم) بگیرن، معمولاً به یکی از این دو روش عمل می‌شه:

• پلاگین واسط رأی (مثل VotingPlugin): اگه چنین پلاگینی نصب باشه، می‌تونی از طریق کانفیگش دقیقاً مشخص کنی هر رأی چه پاداشی (سکه، کیت، یا حتی منابع مخصوص) به پلیر بده.
• اسکریپت با skUtilities: در نبود پلاگین واسط، می‌شه یه اسکریپت ساده نوشت که وقتی رویداد رأی (Vote Event) از Votifier دریافت می‌شه، به پلیر پاداش بده.

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

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

بیشتر پلاگین‌های واسط رأی، آماری از تعداد رأی‌های روزانه/هفتگی/ماهانه و لیدربرد رأی‌دهندگان برتر ارائه می‌دن. بررسی دوره‌ای این آمار به تیم مدیریت کمک می‌کنه بفهمه کدوم سایت‌های لیست سرور بیشترین بازدید و رأی‌دهی رو براتون میارن، تا روی همون‌ها بیشتر سرمایه‌گذاری (مثل خرید جایگاه برتر توی سایت) کنید.

---

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

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

کرش کامل سرور

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

خطای پلاگین یا رفتار غیرمنتظره

• اگه یه قابلیت خاص (مثلاً فروشگاه یه آرنا) درست کار نمی‌کنه، اول با /mbedwars reload یا ری‌لود همون پلاگین خاص امتحان کن.
• اگه مشکل حل نشد، آخرین تغییری که قبل از بروز مشکل توی کانفیگ اعمال شده رو پیدا و بررسی کن — اکثر مشکلات از یه تغییر اخیر (دستی یا آپدیت) میان.
• در صورت نیاز، از بک‌آپ کانفیگ سالم (قبل از تغییر مشکل‌ساز) استفاده کن.

حمله یا سوءاستفاده‌ی جدی (مثل حمله‌ی DDoS یا نفوذ)

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

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

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

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

این اطلاعات کمک می‌کنه تیم فنی خیلی سریع‌تر بتونه مشکل رو تشخیص بده و برطرف کنه.

---

پایان راهنما

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

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