مركز التوثيق 📚
كل ما تحتاج معرفته لإتقان Power Bot — من الإعداد الأول حتى الاحتراف الكامل.
🚀 البدء السريع
ثلاث خطوات فقط تفصلك عن تشغيل أقوى بوت عربي في سيرفرك:
1. أضف البوت
اضغط أضف البوت واختر سيرفرك ووافق على الصلاحيات. يجب أن تملك صلاحية إدارة السيرفر في السيرفر المستهدف.
2. تحقق أنه يعمل
اكتب في أي روم: #ping — إذا رد البوت بسرعة الاستجابة فكل شيء تمام. جرب أيضاً /help لعرض القائمة الكاملة.
3. افتح لوحة التحكم
ادخل لوحة التحكم وسجّل دخولك بحساب ديسكورد، ثم اختر سيرفرك وفعّل الأنظمة التي تريدها بضغطة واحدة.
ابدأ بتحديد روم السجلات من الإعدادات العامة — كل أحداث الإدارة والحماية ستُسجل فيه فوراً وتوفر عليك الكثير.
الأوامر بأسلوبين
كل أمر يعمل بطريقتين: أوامر السلاش الرسمية /ban أو البريفكس النصي #ban. البريفكس الافتراضي هو # وتستطيع تغييره بأمر #prefix ! أو من لوحة التحكم.
⚜️ لوحة التحكم
لوحة التحكم هي أسهل طريقة لإدارة البوت — كل شيء تفعله بالأوامر تستطيع فعله من المتصفح وأكثر:
| الصفحة | ماذا تفعل فيها |
|---|---|
| 🏠 نظرة عامة | إحصائيات حية ورسوم بيانية للرسائل والانضمام والمغادرة |
| ⚙️ الإعدادات العامة | البريفكس، روم السجلات، روم الاقتراحات، الرتب التلقائية |
| 📜 إدارة الأوامر | تفعيل/تعطيل أي أمر من الـ 57 بسويتش |
| 👋 الترحيب | محرر الصورة بالسحب والإفلات + رفع خلفية مخصصة |
| 🛡️ الحماية | كل أنظمة الحماية بإعداداتها التفصيلية |
| ⭐ المستويات | رتب المستويات ورومات بدون XP ومضاعف XP |
| 💰 التقييمات + 🛒 المتجر | اليومية والضريبة ومحرر متجر الرتب |
| 📝 بنّاء الإمبيد | تصميم إمبيدات بمعاينة حية وإرسالها لأي روم |
| 🏆 الليدربورد | توب المستويات والتقييمات + رابط صفحة عامة |
فقط الأعضاء الذين يملكون صلاحية إدارة السيرفر (Manage Server) يرون السيرفر في لوحة التحكم ويستطيعون تعديل إعداداته.
🔤 المتغيرات
المتغيرات نصوص خاصة يستبدلها البوت تلقائياً بقيم حقيقية. استخدمها في رسائل الترحيب والمستويات والردود التلقائية:
| المتغير | يتحول إلى | أين يعمل |
|---|---|---|
| {user} | منشن العضو @فلان | الترحيب، المستويات، الردود |
| {username} | اسم العضو بدون منشن | الترحيب، الردود، صورة الترحيب |
| {server} | اسم السيرفر | في كل مكان |
| {count} | عدد أعضاء السيرفر | الترحيب، صورة الترحيب |
| {level} | المستوى الجديد | رسالة الترقية فقط |
مثال: رسالة ترحيب أهلاً {user} في {server}! أنت العضو {count} 🎉 تصبح: "أهلاً @ماهر في مملكة الذهب! أنت العضو 1,250 🎉"
👋 نظام الترحيب
رحّب بأعضائك الجدد برسالة نصية وصورة سوداء ذهبية مصممة تحمل اسمهم وصورتهم الشخصية.
التفعيل بالأوامر
| الأمر | الوظيفة |
|---|---|
| #welcome channel #الترحيب | تحديد الروم وتفعيل النظام |
| #welcome message النص | تغيير الرسالة النصية |
| #welcome image on/off | تفعيل أو تعطيل الصورة |
| #welcome background رابط | خلفية مخصصة برابط |
| #welcome test | تجربة الترحيب عليك فوراً |
محرر الصورة بالسحب والإفلات
من لوحة التحكم → صفحة الترحيب تجد محرراً تفاعلياً مثل بروبوت وأقوى:
- اسحب الصورة الشخصية أو اسم العضو أو العنوان أو رقم العضو لأي مكان على الصورة
- غيّر الأحجام بالسلايدرات والألوان بمنتقي الألوان لكل عنصر
- ارفع خلفية من جهازك (png / jpg / webp حتى 6MB) أو ضع رابطاً
- عدّل نص العنوان نفسه — مثلاً "نورت {server}"
- زر إرسال تجربة حقيقية يحفظ ويرسل الصورة فعلياً في الروم
لا تنسَ الضغط على حفظ الإعدادات بعد ترتيب العناصر — ما تراه في المحرر هو بالضبط ما سيرسله البوت.
🛡️ الحماية التلقائية
خمسة أنظمة حماية تعمل على مدار الساعة. المشرفون معفيون تلقائياً — أي عضو يملك صلاحية إدارة الرسائل لا تنطبق عليه الفلاتر.
| النظام | ماذا يفعل | أمر التفعيل |
|---|---|---|
| مضاد السبام | يعاقب من يرسل رسائل كثيرة بوقت قصير (قابل للضبط) | #automod enable antispam |
| مضاد الروابط | يحذف أي رسالة تحتوي رابطاً (مع رومات مستثناة) | #automod enable antilink |
| مضاد الدعوات | يحذف روابط دعوات ديسكورد discord.gg | #automod enable antiinvite |
| الكلمات الممنوعة | يحذف الرسائل التي تحتوي كلمات من قائمتك | #automod addword كلمة |
| مضاد المنشنات | يعاقب من يمنشن عدداً كبيراً برسالة واحدة | #automod enable antimention |
اعرض حالة كل الأنظمة بأمر #automod status، أو أدرها بتفاصيل أدق (عدد الرسائل، المدة، نوع العقوبة، الرومات المستثناة) من لوحة التحكم → الحماية.
🚨 مضاد الريد
يتصدى لهجمات الدخول الجماعي (Raids) التي تستخدم حسابات وهمية لتخريب السيرفرات، بطبقتين من الحماية:
1. فلتر الدخول الجماعي
إذا دخل عدد كبير من الأعضاء خلال ثوانٍ قليلة (الافتراضي: 8 أعضاء خلال 15 ثانية) يعتبرها البوت هجمة ويطرد أو يحظر الداخلين الجدد تلقائياً، مع تسجيل كل شيء في روم السجلات.
2. فلتر عمر الحساب
حدد حداً أدنى لعمر حساب ديسكورد (مثلاً 7 أيام) — أي حساب أحدث من ذلك يُطرد فور دخوله مع رسالة توضيحية له، لأن حسابات الريد غالباً تكون جديدة.
فعّل النظام من لوحة التحكم → الحماية → مضاد الريد، واضبط 8 داخلين / 15 ثانية / طرد مع عمر حساب 3 أيام — توازن ممتاز بين الأمان وعدم إزعاج الأعضاء الحقيقيين.
🔨 الإدارة والتحذيرات
أوامر الإدارة الأساسية
| الأمر | الوظيفة | الصلاحية المطلوبة |
|---|---|---|
| #ban @عضو السبب | حظر (يعمل حتى لو خرج العضو بالايدي) | حظر الأعضاء |
| #unban الايدي | فك الحظر | حظر الأعضاء |
| #kick @عضو | طرد | طرد الأعضاء |
| #timeout @عضو 10m | ميوت مؤقت (s/m/h/d) | إعطاء ميوت |
| #clear 50 | مسح رسائل (مع تحديد عضو اختيارياً) | إدارة الرسائل |
| #lock / #unlock | قفل/فتح الروم | إدارة الرومات |
| #slowmode 5s | الوضع البطيء | إدارة الرومات |
| #role @عضو @رتبة | إعطاء/إزالة رتبة | إدارة الرتب |
نظام التحذيرات الذكي
أعطِ تحذيرات بـ #warn @عضو السبب واعرضها بـ #warnings @عضو. عند وصول العضو لحد التحذيرات (الافتراضي 3) يعاقَب تلقائياً — ميوت ساعة أو طرد أو حظر حسب إعدادك، وتُصفّر تحذيراته.
احذف تحذيراً محدداً بـ #removewarn @عضو 2 أو الكل بـ #removewarn @عضو all.
⭐ نظام المستويات
يكسب الأعضاء XP بطريقتين:
- الكتابة: 15–25 XP لكل رسالة (مرة كل دقيقة لمنع السبام)
- الرومات الصوتية: 5 XP لكل دقيقة جلوس بالصوت (روم AFK مستثنى)
الأوامر
| الأمر | الوظيفة |
|---|---|
| #rank | بطاقة مستواك الذهبية المصممة |
| #top | توب 10 بالمستويات |
| #levelrole add 10 @رتبة | رتبة تلقائية عند مستوى معين |
| #setlevel @عضو 5 | تحديد مستوى يدوياً (للإدارة) |
من لوحة التحكم تضبط: رسالة الترقية ورومها، مضاعف XP (حتى x5)، رتب المستويات، ورومات لا يُكسب فيها XP.
اجعل رتب المستويات سلماً للتشجيع: مستوى 5 = عضو نشيط، مستوى 15 = عضو مميز، مستوى 30 = أسطورة 👑
💰 التقييمات والأنظمة التلقائية
نظام عملة متكامل مثل بروبوت — يجمع أعضاؤك الرصيد ويشترون به رتباً من متجرك.
كيف يكسب الأعضاء
| الأمر | المبلغ | التكرار |
|---|---|---|
| #daily | 500$ (قابل للتغيير) | كل 24 ساعة |
| #work | 100–700$ حسب الوظيفة العشوائية | كل ساعة |
| #transfer @عضو 1000 | تحويل بضريبة (الافتراضي 5%) | — |
المتجر
أضف رتباً للمتجر بـ #shop add @رتبة 5000 أو من لوحة التحكم → المتجر. الأعضاء يعرضون المتجر بـ #shop ويشترون بـ #buy 1.
أوامر إضافية: #credits لعرض الرصيد، #moneytop لأغنى الأعضاء، #addmoney @عضو 1000 للإدارة (رقم سالب للخصم).
🎫 نظام التذاكر
نظام دعم فني كامل بالأزرار — العضو يضغط زراً فيُفتح له روم خاص لا يراه غيره وغير فريق الدعم.
الإعداد خطوة بخطوة
- 1️⃣ حدد رتبة الدعم: #ticket role @الدعم-الفني
- 2️⃣ (اختياري) حدد كاتيقوري: #ticket category وروم سجلات: #ticket log #روم
- 3️⃣ أرسل رسالة الفتح: #ticket setup #افتح-تذكرة
عند فتح تذكرة يُنشأ روم باسم ticket-0001 بترقيم تلقائي، يظهر فيه زر إغلاق (يخفي الروم عن صاحبها) ثم زر حذف نهائي. كل تذكرة تُسجل في روم سجلات التذاكر.
🎉 القيف اواي
نظام سحوبات كامل بالأزرار وسحب تلقائي:
| الأمر | الوظيفة |
|---|---|
| #giveaway start 1h 2 نيترو | قيف اواي لمدة ساعة بفائزين اثنين |
| #giveaway list | عرض النشطة مع الايديات |
| #giveaway end الايدي | إنهاء فوري وسحب الفائزين |
| #giveaway reroll الايدي | إعادة سحب فائزين جدد |
- الأعضاء يشاركون بضغطة زر 🎉 — والعدد يتحدث على الزر مباشرة
- الضغط مرة ثانية يسحب المشاركة
- عند انتهاء الوقت يسحب البوت الفائزين تلقائياً ويمنشنهم
- المدد: 30s ثواني، 10m دقائق، 2h ساعات, 3d أيام (حتى 30 يوم)
💬 الردود التلقائية
علّم البوت يرد على كلمات محددة برسائل من اختيارك (حتى 50 رداً):
#autoresponse add سلام | وعليكم السلام {user} 🌹
لاحظ الفاصلة | بين الكلمة والرد في الأمر النصي. احذف رداً بـ #autoresponse remove سلام واعرض الكل بـ #autoresponse list.
من لوحة التحكم → الردود التلقائية تضيف وتعدل وتحذف بواجهة أسهل، مع أزرار تعديل لكل رد.
🏷️ الرتب الذاتية والتلقائية
رتب بالأزرار
#selfroles اختر لونك @أحمر @أزرق @ذهبي — ينشئ رسالة بأزرار، أي عضو يضغط زراً يأخذ الرتبة، ويضغط مجدداً يزيلها. حتى 5 رتب بالرسالة الواحدة.
رتب تلقائية للجدد
#autorole add @عضو-جديد — تُعطى تلقائياً لكل من يدخل السيرفر (حتى 5 رتب)، أو من لوحة التحكم → الإعدادات العامة.
رتبة البوت يجب أن تكون أعلى من أي رتبة يوزعها — اسحب رتبة Power Bot لأعلى القائمة في إعدادات السيرفر.
📮 نظام الاقتراحات
فعّله بـ #suggestions channel #الاقتراحات — بعدها أي عضو يكتب #suggest فكرتي الرهيبة فيظهر اقتراحه في الروم بإمبيد أنيق باسمه وصورته مع تصويت ✅ ❌ جاهز.
رسالة العضو الأصلية تُحذف تلقائياً للحفاظ على نظافة الرومات، ويصله تأكيد مؤقت.
🔧 أدوات إضافية
| الأمر | الوظيفة |
|---|---|
| #afk سبب | وضع الغياب — يضيف [AFK] للقبك ويخبر من يمنشنك |
| #remind 30m اجتماع | تذكير يمنشنك بعد المدة (حتى 7 أيام) |
| #poll سؤال؟ | تصويت سريع بـ ✅ ❌ |
| #embed عنوان | وصف | #ff0000 | إمبيد سريع (أو من لوحة التحكم لتحكم كامل) |
| #say نص | البوت يقول ما تكتبه |
| #avatar / #banner / #user / #server | معلومات وصور |
| #id / #ping / #uptime | أدوات سريعة |
📝 بنّاء الإمبيد
طريقتان لإنشاء إمبيدات احترافية بلون سيرفرك:
من الديسكورد (سريع)
#embed العنوان | الوصف | #8f6fff | رابط_صورة — افصل الأجزاء بـ | واللون والصورة اختياريان. رسالتك الأصلية تُحذف ويبقى الإمبيد نظيفاً.
من لوحة التحكم (كامل)
صفحة بنّاء الإمبيد تعطيك: نص فوق الإمبيد، عنوان، وصف متعدد الأسطر، منتقي لون، صورة كبيرة وصورة مصغرة، وفوتر — مع معاينة حية بشكل ديسكورد تتحدث وأنت تكتب، ثم اختر الروم واضغط إرسال.
قوائم أسعار، قوانين السيرفر، إعلانات الفعاليات، رسائل الشراكات — أي شيء يستحق مظهراً ملكياً.
🏆 الليدربورد وسجل التغييرات
الليدربورد
من لوحة التحكم → الليدربورد تشاهد توب 25 بالمستويات والتقييمات بالأسماء والصور. والأقوى: زر الصفحة العامة يعطيك رابطاً تشاركه بأي مكان — أعضاؤك يشوفون ترتيبهم بدون تسجيل دخول، برابط مثل:
موقعك/leaderboard.html?guild=ايدي_سيرفرك
سجل التغييرات (Audit Log)
صفحة سجل التغييرات بلوحة التحكم تعرض آخر 50 تعديلاً على إعدادات سيرفرك: من عدّل (بالاسم والصورة)، أي أقسام غيّر، ومتى بالضبط — شفافية كاملة بين المشرفين.
🎛️ تخصيص البوت نفسه
لأنك تملك الكود كاملاً، تستطيع تخصيص هوية البوت من ملف config.json:
| الحقل | ماذا يغيّر |
|---|---|
| botName | اسم البوت بالرسائل والمساعدة والموقع |
| botColor | لون كل الإمبيدات (الافتراضي ذهبي #8f6fff) |
| defaultPrefix | البريفكس الافتراضي للسيرفرات الجديدة |
| owners | ايديات مالكي البوت (تتجاوز فحوصات الصلاحيات) |
| web.port / web.url | منفذ ورابط الموقع ولوحة التحكم |
| supportServer | رابط سيرفر الدعم بزر المساعدة |
إضافة أمر جديد بنفسك
أنشئ ملفاً في src/commands/القسم/اسم.js بنفس شكل أي أمر موجود (name, description, options, execute) — البوت يحمّله ويسجله كسلاش تلقائياً عند إعادة التشغيل، ويظهر بصفحة الأوامر والداشبورد بدون أي خطوة إضافية.
أعد تشغيل البوت (أغلق النافذة وشغّل start.bat) ليقرأ التغييرات.
🔐 دليل الصلاحيات
البوت يطلب صلاحية Administrator عند الإضافة لضمان عمل كل الأنظمة. إذا فضّلت تقييده، هذه أقل الصلاحيات المطلوبة لكل نظام:
| النظام | الصلاحيات المطلوبة |
|---|---|
| الإدارة | Ban Members, Kick Members, Moderate Members, Manage Messages |
| الرتب (ذاتية/مستويات/متجر) | Manage Roles + رتبة البوت أعلى من الرتب الموزعة |
| التذاكر | Manage Channels |
| الترحيب والسجلات | Send Messages, Attach Files, Embed Links |
| القفل والإخفاء والسلو | Manage Channels |
| XP الصوتي | لا شيء إضافي — يكفي رؤية الرومات الصوتية |
ولا تنسَ تفعيل الـ Intents الثلاثة في Discord Developer Portal: Presence + Server Members + Message Content، وإلا لن يعمل البوت.
🖥️ تشغيل البوت 24/7
البوت يعمل ما دام جهازك شغالاً. لتشغيله على مدار الساعة عندك خيارات:
VPS (الأفضل)
استأجر سيرفراً صغيراً (تكفي أقل باقة)، انسخ مجلد المشروع إليه، نصّب Node.js ثم:
npm install && npm install -g pm2 && pm2 start index.js --name powerbot && pm2 save
pm2 يعيد تشغيل البوت تلقائياً لو تعطل أو أعيد تشغيل السيرفر.
استضافات البوتات المجانية/الرخيصة
ارفع الملفات وحدد أمر التشغيل node index.js. تأكد أن الاستضافة تدعم Node 18+ وتسمح بفتح منفذ للموقع إذا أردت لوحة التحكم.
غيّر web.url في config.json لرابط موقعك الحقيقي، وأضف رابطك/callback في OAuth2 Redirects بمنصة المطورين، وغيّر sessionSecret لنص عشوائي طويل.
⚡ ورقة الغش السريعة
أكثر الأوامر استخداماً في مكان واحد — للنسخ السريع:
إعداد سيرفر جديد (أول 5 دقائق)
| #log #السجلات | روم السجلات |
| #welcome channel #الترحيب | تفعيل الترحيب |
| #automod enable antispam | مضاد السبام |
| #automod enable antiinvite | مضاد الدعوات |
| #autorole add @عضو | رتبة تلقائية للجدد |
| #suggestions channel #الاقتراحات | روم الاقتراحات |
| #ticket role @الدعم ثم #ticket setup #تذاكر | نظام التذاكر |
الإدارة اليومية
| #clear 50 | مسح 50 رسالة |
| #timeout @عضو 10m سبب | ميوت 10 دقائق |
| #warn @عضو سبب | تحذير (عقوبة تلقائية عند الحد) |
| #lock / #unlock | قفل/فتح الروم |
| #slowmode 5s | وضع بطيء |
الفعاليات
| #giveaway start 1d 2 نيترو | قيف اواي يوم كامل بفائزين |
| #embed عنوان | وصف | #8f6fff | إمبيد ذهبي سريع |
| #poll هل نسوي فعالية الليلة؟ | تصويت فوري |
| #selfroles العنوان @رتبة1 @رتبة2 | رتب ذاتية بالأزرار |
💾 النسخ الاحتياطي والنقل
كل ذاكرة بوتك في مكانين فقط — انسخهما دورياً وأنت بأمان:
| المسار | ماذا يحوي |
|---|---|
| data/ | الإعدادات، المستويات، الرصيد، التحذيرات، الإحصائيات، القيف اواي |
| config.json | التوكن والهوية وإعدادات الموقع |
| web/public/uploads/ | خلفيات الترحيب المرفوعة (اختياري) |
النقل لجهاز أو استضافة جديدة
انسخ مجلد المشروع كاملاً → على الجهاز الجديد شغّل npm install ثم npm start — كل شيء يرجع كما كان: نفس الإعدادات، نفس مستويات الأعضاء، نفس أرصدتهم.
على ويندوز استخدم Task Scheduler لنسخ مجلد data يومياً لمكان آمن، وعلى لينكس سطر cron واحد يكفي: cp -r data backup_$(date +%F)
📖 قاموس المصطلحات
جديد على عالم بوتات ديسكورد؟ هذه أهم المصطلحات التي ستقابلها:
| المصطلح | المعنى |
|---|---|
| التوكن (Token) | كلمة سر البوت — من يملكه يتحكم بالبوت كاملاً، لا تشاركه أبداً |
| البريفكس (Prefix) | الرمز قبل الأوامر النصية مثل # أو ! |
| السلاش (Slash) | أوامر ديسكورد الرسمية التي تبدأ بـ / وتظهر بقائمة تلقائية |
| الإمبيد (Embed) | رسالة منسقة بإطار ملون وعنوان وصور — أجمل من النص العادي |
| الايدي (ID) | رقم فريد لكل عضو وروم ورتبة — انسخه بالزر الأيمن بعد تفعيل وضع المطور |
| الانتنتس (Intents) | أذونات خاصة من منصة المطورين تسمح للبوت برؤية الأعضاء والرسائل |
| XP | نقاط الخبرة — تُكسب بالكتابة والتواجد الصوتي وترفع مستواك |
| الريد (Raid) | هجوم بحسابات وهمية تدخل السيرفر دفعة واحدة للتخريب |
| الأوتومود (Automod) | الحماية التلقائية التي تراقب وتعاقب دون تدخل بشري |
| OAuth2 | طريقة تسجيل الدخول الرسمية من ديسكورد بدون مشاركة كلمة مرورك |
🩺 حل المشاكل الشائعة
| المشكلة | الحل |
|---|---|
| "Used disallowed intents" | فعّل الـ Intents الثلاثة من Developer Portal → Bot |
| البوت لا يرد على # | تأكد من تفعيل Message Content Intent وأن الأمر غير معطل من لوحة التحكم |
| لا يعطي رتباً | ارفع رتبة البوت فوق الرتب الموزعة |
| صور الترحيب لا تظهر | تأكد أن npm install نصّب @napi-rs/canvas بنجاح، وأن للبوت صلاحية Attach Files |
| تسجيل الدخول للوحة لا يعمل | تحقق من clientSecret وأن http://localhost:3000/callback مضاف في OAuth2 Redirects |
| الرسوم البيانية فارغة | طبيعي بالبداية — التتبع يبدأ من لحظة تشغيل النسخة الحديثة |
| أوامر السلاش لا تظهر | انتظر دقائق (ديسكورد يحدثها ببطء أول مرة) أو أعد تشغيل البوت |
لم تجد حلاً؟ زر صفحة الدعم.
90% من المشاكل سببها واحد من ثلاثة: Intents غير مفعلة بمنصة المطورين، رتبة البوت منخفضة بترتيب الرتب، أو صلاحية ناقصة بالروم المحدد. افحصها بالترتيب قبل أي شيء آخر.