MyCommands

التوثيق · v2.8.1

التثبيت والبدء

المتطلبات

سيرفر Paper 1.20+ (أو مشتق). اختياري: Vault (اقتصاد)، PlaceholderAPI (placeholders)، MyCore.

التثبيت

  1. حمّل MyCommands.jar
  2. ضع الملف في plugins/
  3. أعد تشغيل السيرفر
  4. عدّل plugins/MyCommands/config.yml (لغة، تبريد، تأخير، حدود، رسائل، إلخ)
أول خطوات

أوامر أساسية: /spawn, /home, /sethome, /warp, /warps, /tpa, /msg, /help. أدمن: /gamemode, /heal, /feed, /setspawn, /setwarp. إعادة تحميل الإعدادات: /mycommands reload. نقل البيانات (YAML ↔ MySQL): /mycommands migrate.

أوامر المشرف

قائمة أوامر الأدمن فقط مع الاستخدام والاختصارات والصلاحية.

أمراستخداماختصارصلاحية
/gamemode<وضع> [لاعب]gmmycommands.gamemode
/fly[لاعب]—mycommands.fly
/heal[لاعب] أو all—mycommands.heal
/feed[لاعب] أو all—mycommands.feed
/god[لاعب]—mycommands.god
/vanish—vmycommands.vanish
/tp<لاعب> أو <x> <y> <z>teleportmycommands.tp
/tphere<لاعب>smycommands.tphere
/give<لاعب> <عنصر> [كمية]—mycommands.give
/clear[لاعب]cimycommands.clear
/invsee<لاعب>invmycommands.invsee
/enderchest[لاعب]ecmycommands.enderchest
/weather<clear/rain/thunder>—mycommands.weather
/time<day/night/ticks>—mycommands.time
/speed<1-10> [لاعب]—mycommands.speed
/broadcast<رسالة>bcmycommands.broadcast
/kick<لاعب> [سبب]—mycommands.kick
/freeze<لاعب>—mycommands.freeze
/setspawn, /setwarp, /delwarpspawn والوارب—mycommands.setspawn, mycommands.setwarp
/mycommandsreload, migrate—mycommands.reload, mycommands.migrate

أوامر اللاعب

أوامر متاحة للاعبين (نقل، معلومات، مساعدة).

أمراستخداماختصارصلاحية
/spawn——mycommands.spawn
/home[اسم]—mycommands.home
/sethome[اسم]—mycommands.sethome (+ mycommands.sethome.N)
/delhome<اسم>—mycommands.delhome
/homes——mycommands.homes
/back——mycommands.back
/tpa<لاعب>callmycommands.tpa
/tpaccept—tpyesmycommands.tpaccept
/tpdeny—tpnomycommands.tpdeny
/warp<اسم>—mycommands.warp
/warps——mycommands.warps
/me, /near, /realname, /seen, /listمعلومات اللاعب—mycommands.me, إلخ.
/motd, /rules, /help—مساعدةmycommands.motd, mycommands.help
/confirm, /cancel—yes, nomycommands.confirm
/afk——mycommands.afk

الرسائل والوظائف الممتدة

الرسائل الخاصة

أمراستخداماختصارصلاحية
/msg<لاعب> <رسالة>m, tell, whisper, wmycommands.msg
/reply<رسالة>rmycommands.reply
/ignore[لاعب]—mycommands.ignore
/socialspy—spymycommands.socialspy (أدمن)

واجهات والوظائف الممتدة

/homegui (homesgui), /warpgui (warpsgui) — واجهة للمنازل والوارب. /nick (nickname) — تغيير الاسم المعروض. /stats (statistics) — إحصائيات النقل (ذاتك أو [لاعب]). الصلاحيات: mycommands.gui.homes, mycommands.gui.warps, mycommands.nick, mycommands.stats.

الصلاحيات

ملخص الصلاحيات الرئيسية.

  • mycommands.admin — كل أوامر الأدمن
  • mycommands.player — أوامر اللاعب (spawn, home, warp, tpa, msg, help، إلخ)
  • mycommands.extended — الواجهات، nick، stats
  • mycommands.sethome.N — حد N منازل (مثلاً mycommands.sethome.5)
  • mycommands.sethome.unlimited — منازل غير محدودة
  • mycommands.cooldown.bypass — تخطي فترات الانتظار
  • mycommands.teleportdelay.bypass — تخطي تأخير النقل
  • mycommands.afk.bypass — عدم وسمك AFK تلقائياً

الإعداد — التبريد والنقل

فترات الانتظار

cooldowns.enabled, cooldowns.commands (home, spawn, warp, tpa, back, heal, feed, repair) بالثواني. cooldowns.bypass-for-ops.

تأخير النقل

teleport-delay.enabled, teleport-delay.delay لكل أمر. teleport-delay.cancel-on-move, teleport-delay.bypass-for-ops.

مكافحة الإساءة

anti-abuse.prevent-dangerous-teleports (check-lava, check-void, check-water).

معاينة النقل

teleport.preview (enabled, show-particles, show-compass, duration).

الإعداد — الحدود والوارب

الحدود

limits.max-homes, limits.tp-request-timeout, limits.max-ignored-players, limits.max-warps (-1 = غير محدود).

الوارب

warps.enabled, warps.per-warp-permission (mycommands.warp.<اسم> لكل warp).

الصلاحيات (منازل)

permissions.homes.default — عدد المنازل الافتراضي عند عدم وجود mycommands.sethome.N.

الإعداد — الرسائل والدخول/الخروج

عام

language — fr, en.

الرسائل

messages.me-format ({player}, {action}), messages.motd, messages.rules, messages.format (boxed, action-bar, progress-bars).

الرسائل الخاصة

private-messages.enabled, private-messages.sound, private-messages.socialspy-on-join.

الدخول / الخروج

join-quit-messages (enabled, join, first-join, quit, welcome-message, join-title, join-action-bar, webhook Discord).

التأكيدات والإشعارات

confirmations.enabled, confirmations.require-for. notifications.titles, notifications.toast.

الإعداد — الاسم المستعار والواجهات والسجن

الأسماء المستعارة

nicknames.enabled, min/max-length, allow-colors, save-nicknames, check-blacklist, check-similarity.

الواجهات

guis.enabled, modern-design, items-glow, homes-gui-enabled, warps-gui-enabled, sounds, show-stats, خيارات homes/warps.

التجميد، الرجوع، السجن

freeze.allowed-commands, back.save-on-death, jail.enabled, jail.allowed-commands.

نقطة البداية والتأثيرات

spawn.per-world, teleport-on-first-join/death/respawn. effects.particles, sounds. home.check-safe-location, warp.check-safe-location.

AFK والاقتصاد

afk.enabled, timeout, display-format, kick, broadcast. economy.enabled, economy.costs (home-set, warp, spawn, back, nick-change، إلخ).

الإحصائيات والتصحيح

statistics.enabled, debug.enabled, metrics.enabled (bStats).

الإعداد — التخزين والترحيل

التخزين

storage.type — yaml أو mysql. storage.mysql (host, port, database, username, password, pool, table-prefix).

الترحيل

migration.auto-detect, migration.prompt-on-startup, migration.backup-before-migrate. استخدم /mycommands migrate لترحيل YAML إلى MySQL أو العكس.

الميزات

النقل

Spawn (حسب العالم اختياري)، منازل (حد بالصلاحية)، وارب، TPA/TpAccept/TpDeny، back (الموقع السابق أو الموت).

الأدمن

Gamemode, fly, heal/feed (ذاتك أو الكل), god, vanish, tp/tphere/tpall, give, clear, invsee, enderchest, weather/time, ptime/pweather, speed, broadcast, kick, freeze, repair, enchant, جداول افتراضية, jail, setspawn, setwarp, socialspy, reload, migrate.

اللاعب والاجتماعي

spawn, home/sethome/delhome/homes, back, tpa/tpaccept/tpdeny, warp/warps, me, near, realname, seen, list, motd, rules, help, confirm, cancel, afk. رسائل: msg, reply, ignore, socialspy (أدمن).

الممتد

homegui, warpgui, nick (ألوان اختيارية), stats.

البيانات والتكاملات

تخزين YAML أو MySQL، /mycommands migrate, /mycommands reload. Vault (تكاليف), PlaceholderAPI (توسعة MyCommands), MyCore. تجربة المستخدم: تأخير النقل (إلغاء عند الحركة), فترات انتظار, تأكيدات, معاينة, جزيئات/أصوات, رسائل دخول/خروج, webhooks Discord.