Minecraft · راهنما

راهنمای LuckPerms: گروه‌ها، رتبه‌ها و دستورها

به‌روزرسانی October 10, 2026 6 دقیقه مطالعه

در این صفحه
  1. LuckPerms را نصب کنید و به خودتان دسترسی بدهید
  2. گروه‌ها، وراثت، وزن و مسیرها
  3. پیکربندی آماده برای بازیکن، ناظر و ادمین
  4. پیشوندها و رتبه‌ها در چت
  5. ویرایشگر وب LuckPerms
  6. دستورهای LuckPerms که به کار می‌برید
  7. LuckPerms روی سرور یا شبکه‌ی HytHost
  8. پرسش‌های متداول

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

این راهنما استفاده از LuckPerms را از صفر نشان می‌دهد — نصب، مفاهیم پایه، یک پیکربندی آماده برای بازیکن / ناظر / ادمین، ویرایشگر وب و دستورهایی که هر هفته به کار می‌برید.

LuckPerms را نصب کنید و به خودتان دسترسی بدهید

  1. نسخه‌ی مناسب را دانلود کنید از luckperms.net — نسخه‌ی Bukkit برای Paper و Spigot، یا نسخه‌ی Fabric، NeoForge یا Velocity برای همان پلتفرم‌ها. به Java 11 یا جدیدتر نیاز دارد که همه‌ی سرورهای امروزی دارند.
  2. فایل jar را در plugins بگذارید (یا mods در Fabric و NeoForge)، هر افزونه‌ی دسترسی دیگری را حذف کنید و سرور را کامل ری‌استارت کنید.
  3. از کنسول به خودتان دسترسی بدهید. در ابتدا هیچ‌کس نمی‌تواند از دستورهای LuckPerms استفاده کند، حتی خودتان:
lp user YourName permission set luckperms.* true

از این به بعد می‌توانید از /lp داخل بازی استفاده کنید. در اولین اجرا LuckPerms چند کتابخانه دانلود می‌کند، پس سرور باید به اینترنت دسترسی داشته باشد.

LuckPerms را روی سروری اجرا کنید که برای بازیکنانتان در دسترس است: هاست Minecraft از HytHost از €2.59 در ماه، همراه با MySQL.

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

گروه‌ها، وراثت، وزن و مسیرها

  • نودهای دسترسی همان کلیدها هستند، مثل essentials.home یا minecraft.command.gamemode. هر کدام می‌تواند true، false یا تنظیم‌نشده باشد.
  • گروه‌ها دسترسی‌ها را نگه می‌دارند. همه‌ی بازیکنان در default هستند؛ بقیه را شما اضافه می‌کنید.
  • وراثت: یک گروه می‌تواند گروه‌های والد داشته باشد و هرچه آن‌ها دارند را بگیرد. اگر admin از mod ارث ببرد و mod از default، ادمین‌ها هر سه را دارند.
  • وزن تعیین می‌کند وقتی دو گروه با هم تضاد دارند کدام برنده شود — عدد بزرگ‌تر برنده است. فاصله‌های ۱۰۰تایی برای گروه‌هایی که بعداً اضافه می‌کنید جا باز می‌گذارد.
  • مسیرها (tracks) نردبان‌های ارتقا هستند، مثل default → helper → mod → admin، که با promote و demote استفاده می‌شوند. به‌تنهایی وراثت را تغییر نمی‌دهند.
  • کانتکست‌ها یک دسترسی را به یک سرور یا دنیای خاص محدود می‌کنند، مثلاً world=survival در انتهای دستور.

پیکربندی آماده برای بازیکن، ناظر و ادمین

گروه‌ها را بسازید، آن‌ها را به هم زنجیر کنید و به هر کدام دسترسی‌های لازمش را بدهید. نام نودهای زیر مربوط به دستورهای EssentialsX است؛ آن‌ها را با نودهای افزونه‌هایی که استفاده می‌کنید جایگزین کنید.

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod setweight 100
lp group admin setweight 200

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.msg true

lp group mod permission set essentials.kick true
lp group mod permission set essentials.mute true
lp group mod permission set essentials.tempban true

lp group admin permission set essentials.* true
lp group admin permission set luckperms.* true

lp user Steve parent add mod

سپس یک مسیر برای ارتقاها:

lp createtrack staff
lp track staff append default
lp track staff append mod
lp track staff append admin

دستور lp user Steve promote staff بازیکن Steve را یک پله بالا می‌برد. فهرست کامل دستورها و نودهای EssentialsX در راهنمای EssentialsX آمده است.

پیشوندها و رتبه‌ها در چت

برای یک گروه پیشوند تنظیم کنید:

lp group admin meta setprefix "&c[Admin] "

LuckPerms پیشوند را ذخیره می‌کند؛ نمایش آن کار یک افزونه‌ی چت است. Vault و یک افزونه‌ی چت که از آن می‌خواند، مثل EssentialsX Chat، را نصب کنید. اگر بازیکنان چند گروه داشته باشند، پیشوندی با بالاترین اولویت استفاده می‌شود — آن را با meta setprefix 100 "..." تنظیم کنید.

ویرایشگر وب LuckPerms

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

دستورهای LuckPerms که به کار می‌برید

دستورکاربرد
/lp user <user> infoگروه‌ها و جزئیات یک بازیکن را نشان می‌دهد
/lp user <user> permission set <node> trueبه یک بازیکن دسترسی می‌دهد
/lp user <user> permission unset <node>دوباره آن را حذف می‌کند
/lp user <user> permission check <node>نشان می‌دهد بازیکن دسترسی دارد یا نه
/lp user <user> parent add <group>بازیکن را به یک گروه اضافه می‌کند
/lp user <user> parent set <group>بازیکن را فقط در همان گروه قرار می‌دهد
/lp user <user> parent addtemp <group> <duration>رتبه‌ی موقت، مثلاً 30d
/lp group <group> permission set <node> trueبه کل یک گروه دسترسی می‌دهد
/lp creategroup <group>, /lp listgroupsگروه می‌سازد، گروه‌ها را فهرست می‌کند
/lp group <group> parent add <group>یک گروه را وارث گروه دیگر می‌کند
/lp user <user> promote <track>بازیکن را در مسیر بالا می‌برد (demote پایین می‌آورد)
/lp group <group> meta setprefix <prefix>پیشوند چت یک گروه را تنظیم می‌کند
/lp editorویرایشگر وب را باز می‌کند
/lp verbose record، سپس /lp verbose uploadبررسی‌های دسترسی را ثبت می‌کند تا نود جاافتاده را پیدا کنید
/lp syncداده‌ها را دوباره از فضای ذخیره‌سازی بارگذاری می‌کند

مطمئن نیستید یک دستور به کدام نود نیاز دارد؟ /lp verbose record را اجرا کنید، دستور را از طرف بازیکن به کار ببرید، سپس /lp verbose upload — گزارش همه‌ی دسترسی‌های بررسی‌شده را نشان می‌دهد.

LuckPerms روی سرور یا شبکه‌ی HytHost

  • نصب: فایل jar را با فایل‌منیجر یا از طریق SFTP در plugins آپلود کنید و سپس از پنل ری‌استارت کنید. اولین دستور lp user ... luckperms.* را در تب Console اجرا کنید.
  • یک سرور: ذخیره‌سازی پیش‌فرض H2 کافی است.
  • شبکه: LuckPerms را روی پراکسی و روی همه‌ی سرورهای backend نصب کنید و همه را با storage-method: mysql در config.yml به یک پایگاه داده‌ی MySQL مشترک وصل کنید. هر پلن Minecraft از HytHost پایگاه داده‌ی MySQL دارد؛ راه‌اندازی خود پراکسی در نحوه‌ی راه‌اندازی پراکسی Velocity توضیح داده شده است.

Paper، Velocity و MySQL در همه‌ی پلن‌ها — هاست Minecraft از HytHost از €2.59 در ماه.

مشاهده‌ی پلن‌های Minecraft
پرسش‌های متداول

پرسش‌های متداول

از کنسول سرور دستور lp user YourName permission set luckperms.* true را اجرا کنید. پس از آن می‌توانید همه‌ی دستورهای /lp را داخل بازی به کار ببرید.

از /lp user PlayerName parent add groupname استفاده کنید. برای اینکه آن گروه تنها گروه بازیکن باشد، به جای parent add از parent set استفاده کنید.

LuckPerms فقط پیشوند را ذخیره می‌کند. به Vault و یک افزونه‌ی چت که آن را بخواند، مثل EssentialsX Chat، هم نیاز دارید. اگر بازیکن چند گروه داشته باشد، پیشوندی با بالاترین اولویت برنده است.

/lp verbose record را اجرا کنید، بگذارید بازیکن دستور را به کار ببرد، سپس /lp verbose upload. گزارش همه‌ی دسترسی‌هایی را که سرور بررسی کرده فهرست می‌کند، از جمله همانی که رد شده است.

بله. آن را روی پراکسی و روی همه‌ی سرورهای backend نصب کنید و همه را به یک پایگاه داده‌ی MySQL یا MariaDB مشترک وصل کنید تا رتبه‌ها مشترک باشند.

رتبه‌ها، دسترسی‌ها و سروری که آنلاین می‌ماند

هاست Minecraft از HytHost، Paper یا Velocity را با LuckPerms، پایگاه داده‌ی MySQL و بکاپ خودکار اجرا می‌کند — از €2.59 در ماه.

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

این راهنما برایتان مفید بود؟