آموزش دستورات سرور آماده prison برای ادمین ها
نویسنده: تیم برنو
راهنمای مدیریت سرور Berno Prison
مرجع کامل برای تیم مدیریت: از دسترسی به سرور و پرمیشنها تا اقتصاد، رفع مشکلات EdPrison و روال ایمن اعمال تغییرات. این سند برای ادمین/مدیریت نوشته شده، نه بازیکن عادی.
دسترسی به سرور
سه راه برای رسیدن به فایلها و کنسول سرور.
| روش | برای چی استفاده میشه |
|---|---|
| پنل هاست (Pelican) | کنسول زنده، استارت/استاپ، فایلمنیجر وب، مشاهدهی مصرف منابع |
| FTP (مثل FileZilla) | آپلود/دانلود دستهای فایلهای کانفیگ و دیتا |
| کنسول درونبازی | دستورات ادمین روزمره (op، give، rankup و...) |
روشن/خاموش کردن سرور
stop قبل از خاموش شدن دنیاها و دیتای پلاگینها رو سیو میکنه؛ Kill کردن میتونه باعث خراب شدن چانک یا از دست رفتن دیتای ذخیرهنشده بشه.مسیر اصلی فایلها
نقشهی کلی پلاگینها
۵۷ پلاگین نصبه؛ اینها مهمترینها به تفکیک نقش.
هسته و زیرساخت
Vault PlaceholderAPI LuckPerms ProtocolLib NBTAPI ViaVersion / ViaBackwards / ViaRewind EssentialsX
پریزن و پیشرفت
Prison EdPrison TokenManager (خراب — بخش ۵) CoinsEngine ExcellentCrates ajLeaderboards
دنیا و ساختوساز
WorldGuard WorldGuardExtraFlags FastAsyncWorldEdit Multiverse-Core PlotSquared
اجتماعی و سرگرمی
Citizens DecentHolograms DeluxeMenus DeluxeTags UltraCosmetics Minepacks PlayerAuctions Lottery ChatGames KoTH AuraSkills InteractiveChat
مدیریت و امنیت
AdvancedBan Badword CombatLogX EasyCommandBlocker
plugins — سبز یعنی فعال، قرمز یعنی کرش کرده یا غیرفعاله.پرمیشن و رنکها با LuckPerms
همهی رنکبندی سرور از اینجا کنترل میشه.
سرور سه «مسیر» (Track) موازی داره:
| مسیر | گروهها (از پایین به بالا) | کاربرد |
|---|---|---|
rank | default, knight, lord, paladin, duke, king, youtuber, streamer, helper, builder, mod, srmod, admin, dev, manager, owner | رتبهی نمایشی/تیم سرور |
prisonranks | a تا z | رنک معدنکاری (بخش ۸) |
prisonprestiges | p0 تا p7 | پلهی پرستیژ |
/lp استفاده کن.مدیریت اقتصاد سرور
۵ ارز فعال؛ اکثرشون از CoinsEngine میان.
| ارز | منبع فعلی | وضعیت |
|---|---|---|
| Money | EssentialsX / Vault | سالم |
| Coins | CoinsEngine | سالم |
| Tokens | CoinsEngine (currencies/tokens.yml) | سالم — جایگزین EdPrison شد |
| Gems / Crystals | EdPrison | خراب — بخش ۵ |
افزودن ارز جدید به CoinsEngine
- سرور رو Stop کن (تغییر Command Aliases فقط موقع بوت لود میشه).
- یک فایل جدید توی
plugins/CoinsEngine/currencies/بساز — از روی یکی از فایلهای موجود (مثلاًcoins.yml) کپی کن. - مقادیر
Name,Command_Aliases,Column_Name,Prefixرو برای ارز جدید تغییر بده. - سرور رو Start کن؛ توی لاگ باید ببینی:
Currency registered: '<اسم>'
/tokens)، فقط یکیشون واقعاً جواب میده. بعد از هر ارز جدید حتماً با /<اسم> give تست کن که پیام موفقیت واقعی میگیری، نه سکوت.مشکل شناختهشدهی EdPrison
این پلاگین رو با احتیاط دست بزن — نسخهی فعلی سالم نیست.
EdPrison-3.6.jar نصبشده احتمالاً یک نسخهی کرک/نالشدهست — رشتهی BRANCHLOCK_DOT_NET_DEMO (مال یه ابزار ضدکرک) داخل بایتکدش پیدا شده که نشون میده رمزگشایی رشتههای داخلی پلاگین (اسم دستورها، پیامها) خراب شده.علائمی که میبینی
- دستورات
tokens give/gems give/crystals giveبدون هیچ پیام موفقیت یا خطا اجرا نمیشن (سکوت کامل). - پلیسهولدرهایی مثل
%edprison_currency_tokens%یا%edprison_notation_{...}%یا خام برمیگردن یا باNullPointerExceptionکرش میکنن. - توی لاگ خطاهایی مثل
NoClassDefFoundError: ...ReflectionMethodموقع باز کردن منوی کلنگ، ادعای پوچ (Pouch)، یا پرتاب بمب میبینی — یعنی دریل/بمب/پوچ/زره فعلاً عملاً کار نمیکنن. - دیتای بازیکنها گاهی اصلاً توی
plugins/EdPrison/data/users.ymlذخیره نمیشه، حتی بعد از فعالیت زیاد.
راهکار فعلی
Tokens رو با اضافهکردن یک ارز جدید به CoinsEngine جایگزین کردیم (بخش ۴) — نمایش و دستورات ادمین درست کار میکنن. اما این باعث نمیشه منوی خرید انچنت داخل EdPrison درست کار کنه، چون اون منو به موجودی داخلی خودِ EdPrison نگاه میکنه، نه CoinsEngine.
راهحل قطعی
تهیهی یک نسخهی اصلی و لایسنسدار از سازنده (EdwardBelt، از SpigotMC یا دیسکورد رسمیش) و جایگزینی جار فعلی. تا اون موقع، هر باگ عجیب و بیدلیل توی EdPrison (نه فقط تو اکونومی) رو با این مشکل ریشهای مرتبط بدون.
ساختار دیتای دستی (برای وصلهی اضطراری)
اگه لازم شد دستی دیتای یک بازیکن رو ویرایش کنی (فقط وقتی سرور Stopه):
اسکوربورد و تبلیست (TAB)
همهی متنهای کنار صفحهی بازیکن از اینجا میان.
سه بخش اصلی داخل این فایل:
- header-footer — متن بالا/پایین لیست تب (خودکار وسطچین میشه)
- scoreboard — پنل کنار صفحه (Money/Coins/Tokens/Rank و...) — خودکار وسطچین نمیشه
- tablist-name-formatting / scoreboard-teams — رنگ و ترتیب اسم پلیرها بر اساس رنک
وسطچین کردن دستی خطوط اسکوربورد
چون فونت ماینکرفت monospace نیست، برای وسطچیننمایی از پدینگ فاصلهی دستی استفاده میشه. فرمول تقریبی که توی این کانفیگ جواب داده:
یعنی اگه متن یک خط رو عوض کردی (مثلاً کوتاهتر یا بلندتر شد)، باید تعداد فاصلههای اول خط رو دوباره حساب کنی وگرنه از وسط جابجا میشه.
&#...) خراب میشن.صندوقچه و کلید (ExcellentCrates)
کاملاً سالم و مستقل از مشکل EdPrison.
کلیدهای موجود: common epic rare superior vote rankup
کانفیگ هر صندوقچه/کلید داخل این مسیرهاست:
مینها و رنکآپ (Prison)
موتور اصلی رنک/مین سرور — جدا از EdPrison و سالمه.
۲۶ رنک پیشفرض (A تا Z) + ۷ رنک پرستیژ (P1 تا P7) بارگذاری شدن. دیتاش اینجاست:
مدیریت دیتای بازیکنها
دیتای هر بازیکن پخش شده بین چند پلاگین با فرمتهای متفاوت.
| پلاگین | فرمت ذخیرهسازی | مسیر |
|---|---|---|
| EdPrison | YAML شامل JSON | plugins/EdPrison/data/users.yml |
| Essentials | YAML، یک فایل بهازای هر UUID | plugins/Essentials/userdata/<uuid>.yml |
| Prison | JSON، یک فایل بهازای هر بازیکن | plugins/Prison/data_storage/ranksDb/players/ |
| LuckPerms | دیتابیس H2 | فقط با /lp |
| CoinsEngine | دیتابیس SQLite | فقط با دستورات پلاگین |
| ماینکرفت خودِ بازی | NBT باینری | world/playerdata/<uuid>.dat |
قبل از هر ویرایش دستی
- سرور رو کامل Stop کن — هرگز فایل دیتا رو موقع روشن بودن سرور ویرایش نکن.
- از فایل اصلی یک کپی پشتیبان بگیر (مثلاً
users.yml.bak). - فایل رو مستقیم از سرور زنده دانلود کن، نه از یک بکاپ قدیمی محلی — دیتا مدام تغییر میکنه.
- بعد از ویرایش، آپلود کن و سرور رو Start کن، بعد داخل بازی تأیید کن.
نظارت و انضباط
ابزارهای بن، میوت و فیلتر کلمات.
| پلاگین | کار |
|---|---|
| AdvancedBan | سیستم بن/میوت/کیک با دیتابیس HSQLDB محلی |
| Badword | فیلتر خودکار کلمات نامناسب در چت |
| CombatLogX | جلوگیری از فرار وسط جنگ (حالت Combat Tag) |
| EasyCommandBlocker | مسدودسازی دستورات خاص برای گروههای خاص |
دنیاها و مناطق
۴ دنیای اصلی، هرکدوم با نقش خودش.
| دنیا | نقش | مدیریت با |
|---|---|---|
playworld | دنیای اصلی معدنکاری/بازی | WorldGuard |
spawn | اسپاون، NPCها، منطقهی امن | WorldGuard |
plotworld | پلاتهای شخصی بازیکنها | PlotSquared |
arena | PvP آزاد | WorldGuard |
برندینگ و ظاهر سرور
هرجا اسم/لوگوی سرور دیده میشه.
| محل | فایل |
|---|---|
| آیکون سرور (لیست سرورهای بازی) | server-icon.png — دقیقاً ۶۴×۶۴ پیکسل |
| MOTD (توضیح زیر اسم سرور در لیست) | server.properties → کلید motd |
| هدر/فوتر تبلیست | plugins/TAB/config.yml → header-footer |
| اسکوربورد کنار صفحه | plugins/TAB/config.yml → scoreboard |
server-icon.png، فقط /tab reload کافی نیست — برای دیدنش توی لیست سرور، سرور باید کامل ریاستارت بشه.روال ایمن تغییر کانفیگ
همین ترتیب رو برای هر تغییر کانفیگ دنبال کن.
- فایل هدف رو مستقیم از سرور زنده دانلود کن (نه از بکاپ قدیمی).
- یک کپی پشتیبان از نسخهی فعلی بگیر (مثلاً با پسوند
.bak). - تغییر رو اعمال کن — انکودینگ رو UTF-8 بدون BOM نگه دار.
- اگه تغییر روی «اسم دستور» یا «ارز/کارنسی» بود، سرور رو کامل Stop/Start کن (reload کافی نیست).
- اگه تغییر فقط کانفیگ نمایشی بود (TAB، پیامها)، معمولاً دستور reload خودِ پلاگین کافیه.
- بلافاصله بعد از اعمال، توی کنسول یا چت تست کن و
logs/latest.logرو برای خطای جدید چک کن.
عیبیابی مشکلات رایج
اینها رو خودمون اینجلسه تجربه کردیم — چکلیست سریع.
| علامت | دلیل محتمل | راهحل |
|---|---|---|
پلیسهولدر خام نمایش داده میشه (مثلاً %x_y%) | اکسپنشن ثبت نشده یا identifier اشتباهه | /papi parse <پلیر> %...% رو تست کن |
| دستور اجرا میشه ولی هیچ اتفاقی نمیافته | پلاگین کرشکرده/کرکشده — کرش بیصدا | logs/latest.log رو برای NPE/Exception همون لحظه چک کن |
| متن اسکوربورد از وسط جابجا شده | طول متن عوض شده ولی فاصلهی پدینگ آپدیت نشده | فرمول بخش ۶ رو دوباره حساب کن |
| بعد از آپلود، فایل رمزنگاریشده/بههمریخته نمایش داده میشه | انکودینگ اشتباه یا انتقال ASCII بهجای Binary در FTP | دوباره با UTF-8 بدون BOM و حالت Binary آپلود کن |
| یک دستور بهجای پلاگین موردنظر، پلاگین دیگهای جواب میده | دو پلاگین یک اسم دستور رو ثبت کردن | Alias دستور رو توی یکی از دو پلاگین عوض کن |
| دیتای بازیکن پیدا نمیشه | داری فایل بکاپ محلی/قدیمی رو چک میکنی، نه سرور زنده | فایل رو مستقیم از FTP سرور زنده دانلود کن |