شرح تركيب أوركا بوت خطوة بخطوة — ديسكورد وفايف ام وأول قطاع

شرح تركيب أوركا بوت: إضافة البوت لسيرفر الديسكورد، شحن الرصيد والاشتراك، ربط سيرفر فايف ام (FiveM) بسكربت OrcaBot_V3، ثم إنشاء أول قطاع وتجربة /مساعدة.

مكان الصفحة: الموقع ← «انتقل للسيرفرات والقطاعات» ← سيرفرك — لوحة السيرفر ← «الاشتراك والرصيد» — لوحة السيرفر ← «الإدارة العامة» ← «ربط فايف ام» — لوحة السيرفر ← «نظرة عامة» ← «إنشاء قطاع»

هذا المقال يشرح تركيب أوركا بوت من الصفر لين يشتغل أول قطاع في سيرفرك: تضيف البوت لسيرفر الديسكورد، تشحن الرصيد وتشترك، تربط سيرفر فايف ام بسكربت OrcaBot_V3، تضبط إعدادات السيرفر ورتبة البوت، ثم تنشئ القطاع وتجربه بأمر /مساعدة. الخطوات مرتبة بالتسلسل اللي يمشي عليه التركيب، وكل خطوة فيها رابط لشرحها المفصل.

قبل ما تبدأ

• لازم تكون مالك سيرفر الديسكورد أو عندك صلاحية ADMINISTRATOR فيه — هذولا اللي يقدرون يسوون التركيب.
• سيرفر فايف ام شغّال وظاهر في قائمة السيرفرات العامة servers.fivem.net.
• توصل لملفات السيرفر (مجلد resources وملف server.cfg) وللكونسول حقه.
• سيرفرك على فريمورك مدعوم: ESX أو QB-Core (CFW) أو vRP أو مود الشرطة (Police Mod)، وأي فريمورك خاص عن طريق التواصل مع الدعم في ديسكورد أوركا بوت. التفاصيل في الفريموركات المدعومة.

مشّ على الترتيب: «ربط فايف ام» ما يظهر قبل الاشتراك، و«إنشاء قطاع» يحتاج سيرفر فايف ام مربوط وشغّال.

الخطوة 1: سجّل دخولك وافتح سيرفرك

1. ادخل orcabot.net واضغط «انتقل للسيرفرات والقطاعات».
2. سجّل دخولك بحساب الديسكورد ووافق على الطلب.
3. في قسم «سيرفراتك» تلقى سيرفرات حسابك في الديسكورد — اضغط «إنتقال» تحت سيرفرك.

ما لقيت سيرفرك؟ اضغط زر التحديث جنب خانة البحث («تحديث قائمة السيرفرات») عشان تنسحب القائمة من الديسكورد من جديد، وتأكد إنك داخل بالحساب الصحيح.

الخطوة 2: أضف البوت لسيرفر الديسكورد

إذا البوت مو موجود في السيرفر، تطلع لك صفحة «إعداد البوت للسيرفر»:

1. اضغط «إضافة البوت إلى السيرفر» — تنفتح صفحة الديسكورد في تبويب جديد وسيرفرك محدد.
2. خلّ صلاحية ADMINISTRATOR مفعّلة ووافق.
3. ارجع لصفحة أوركا واضغط «تحديث الصفحة» — تفتح لك لوحة السيرفر.

أخطاء شائعة: إذا شلت ADMINISTRATOR وقت الإضافة، بتطلع لك بعدين رسائل مثل «البوت لا يملك صلاحية MANAGE_ROLES». رجّع الصلاحية لرتبة البوت من إعدادات سيرفر الديسكورد — الشرح في صلاحيات البوت في الديسكورد.

الخطوة 3: اشحن رصيد السيرفر

من لوحة السيرفر ← «الاشتراك والرصيد» ← «شحن الرصيد». الرصيد ينحط في محفظة السيرفر، وعندك طريقتين:

• «دفع مباشر»: بالبطاقة أو Apple Pay أو PayPal، من 5$ إلى 10,000$، والرصيد ينضاف تلقائياً أول ما يوصل الدفع.
• «دفع يدوي»: STC Pay أو USDT أو تحويل بنكي محلي أو InstaPay أو Vodafone Cash — تحوّل وترفع صورة الإيصال، والطلب ينراجع خلال 1–24 ساعة.

أخطاء شائعة: ما يصير يكون عندك أكثر من 3 طلبات يدوية قيد المراجعة بنفس الوقت. وإذا بتختار «الاشتراك عبر PayPal» في الخطوة الجاية، الدفع يصير في PayPal مباشرة وما تحتاج تشحن المحفظة. التفاصيل في كيفية شحن الرصيد.

الخطوة 4: اشترك في خطة

1. من «الاشتراك والرصيد» افتح «ترقية الخطة».
2. اختر الخطة اللي تناسبك واضغط زرها «ترقية إلى» + اسم الخطة.
3. إذا الخطة تقبل الاشتراك عبر PayPal، يسألك «اختر طريقة الدفع»: - «الاشتراك عبر PayPal»: يتجدد تلقائياً وتقدر تلغيه أي وقت. - «الدفع من المحفظة»: فترة وحدة، وتجدده متى ما تبي.
4. في نافذة «تأكيد الترقية» تقدر تكتب كود الخصم في خانة «أدخل كود الخصم» وتضغط «تطبيق»، وبعدها اضغط «تأكيد الترقية». إذا رصيدك ما يكفي يطلع لك «رصيدك غير كافٍ» وزر «شحن …» يفتح لك «شحن الرصيد» والمبلغ الناقص معبّأ (أقل شحنة 5$).

بعد التفعيل يرجعك لـ«نظرة عامة» وتشوف خطتك تحت «الخطة الحالية». التفاصيل في كيفية الاشتراك وترقية الخطة.

أخطاء شائعة: بدون اشتراك ما يظهر «ربط فايف ام»، ولو فتحت صفحته تطلع لك «ربط فايف ام غير متاح في باقتك».

الخطوة 5: اربط سيرفر فايف ام

افتح لوحة السيرفر ← «الإدارة العامة» ← «ربط فايف ام»، تبويب «الربط».

5.1 جيب كود السيرفر

1. ادخل servers.fivem.net وابحث عن سيرفرك، وانسخ الكود من آخر رابط صفحته.
2. الصقه تحت «ادخل كود الخادم» — يقبل الكود لحاله أو رابط cfx.re/join/xxxxxx كامل — واضغط «البحث عن الخادم».

5.2 ركّب السكربت على السيرفر

تطلع لك صفحة «تأكيد الربط» فيها بيانات سيرفرك وخطوات «تركيب سكريبت OrcaBot»:

1. اضغط «تحميل OrcaBot_V3.zip» وفك الضغط.
2. حط مجلد OrcaBot_V3 داخل resources (يصلح داخل مجلد تصنيف مثل [ORCA]).
3. أضف ensure OrcaBot_V3 في server.cfg بعد سطر الفريمورك حقك، مثل ensure es_extended أو ensure qb-core أو ensure vrp.
4. أعد تشغيل السيرفر، أو اكتب في الكونسول refresh ثم ensure OrcaBot_V3.

ما فيه ملف إعدادات تعدّله ولا كود تكتبه — الربط ينحفظ تلقائياً بعد أمر الكونسول. واختياري: ركّب سكربت support-arabic وحطه قبل OrcaBot_V3 عشان يطلع العربي صح في إشعارات اللعبة.

5.3 أكّد الربط

1. اضغط «تأكيد الربط» — الموقع يتأكد إن السكربت شغّال ونسخته مقبولة.
2. سيرفرات vRP: إذا ملف vRP المرافق مو مركّب، ينقلك لمرحلة «تركيب ملف vRP المرافق». حمّل orcabot_hook.lua وحطه داخل مجلد مورد vRP جنب base.lua، وأضف 'orcabot_hook.lua' كآخر سطر داخل server_scripts في fxmanifest.lua حق vRP، وأعد تشغيل vRP. لما يطبع الكونسول vRP companion installed اضغط «تحقّق وتأكيد الربط».

5.4 اقبل الطلب من الكونسول

1. تطلع صفحة «نجح إرسال طلب الربط!» فيها أمر مثل accept orca connection <رقم الطلب> — انسخه بزر النسخ (نفس الأمر يطبعه السكربت في الكونسول).
2. اكتبه في كونسول السيرفر (مثل Live Console في txAdmin)، مو F8 داخل اللعبة.
3. عندك 5 دقايق والعداد ظاهر في الصفحة. أول ما ينقبل يطلع لك «تم ربط الخادم بنجاح!».

5.5 تأكد إن الربط شغّال

صفحة «الربط» تعرض سيرفرك مع «مربوط» و«متصل» ونسخة السكربت. اضغط «اختبار الاتصال» — المفروض يطلع «الخادم متصل» مع سرعة الرد — وتقدر تشوف اللاعبين من «المتصلون الآن».

أخطاء شائعة:

• «لم نعثر على خادم بهذا الكود»: الكود غلط، أو السيرفر طافي، أو مو ظاهر في قائمة FiveM العامة.
• «لم يُكتشف السكريبت على الخادم»: المجلد مو داخل resources، أو ناقص ensure OrcaBot_V3، أو ما أعدت التشغيل. وإذا متأكد من التركيب، ممكن جدار حماية أو حماية DDoS عند الاستضافة يمنع اتصالنا — تواصل مع الدعم.
• «السيرفر يرفض اتصال OrcaBot — تواصل مع الدعم الفني» بعد «اختبار الاتصال»: سيرفرك ظاهر في قائمة FiveM، بس جدار الحماية عند الاستضافة يمنع اتصالنا فيه — تواصل مع الدعم.
• «نسخة السكريبت على الخادم قديمة»: حمّل الأحدث من نفس الصفحة واستبدل المجلد كامل.
• «هذا السيرفر مرتبط بالفعل بسيرفر ديسكورد آخر»: افصله من لوحة ذاك السيرفر أولاً، أو أعد تشغيل OrcaBot_V3 إذا كان ماسك ربط قديم.
• «انتهت مهلة الاتصال»: عدّت الـ5 دقايق قبل ما تكتب الأمر — اضغط «إعادة المحاولة» وأكّد من جديد.
• اسم المجلد لازم يكون OrcaBot_V3 بالضبط، ونسخة وحدة بس — نسخة زيادة مثل OrcaBot_V3-old تخرب الاتصال.

الشرح الكامل وحلول باقي المشاكل في ربط سيرفر فايف ام بأوركا بوت.

الخطوة 6: اضبط إعدادات السيرفر

من لوحة السيرفر ← «نظرة عامة» ← «إعدادات السيرفر»:

• «رتب الإدارة»: رتب إدارة سيرفرك. لو أحد منهم غيّر وظيفته داخل اللعبة، البوت يسجّل الحركة بس وما يوظفه أو يفصله تلقائياً.
• «رتب اللاعبين المعتمدين»: رتب لاعبيك المعتمدين، ولهم نفس التنقّل الحر بين القطاعات.
• «المنطقة الزمنية»: الافتراضي Asia/Riyadh، وتنطبق على كل القطاعات في التوظيف والإجازات والتقارير.
• «هيكل الكود»: قالب أسماء الأعضاء في الديسكورد، والافتراضي [{alphabet}-{code_number}] {name} ويطلع مثل [P-012] سعود. خلّه على الافتراضي إذا ما عندك نظام خاص، لأن أي تعديل عليه بعدين يفتح نافذة تعيد بناء أسماء كل الأعضاء — الشرح في نظام الأسماء والأكواد.

بعد أي تعديل يطلع شريط «يوجد تغييرات لم تُحفظ بعد» — اضغط «حفظ التغييرات».

«رتب الإدارة» ما تعطي أصحابها أي صلاحية في لوحة التحكم — «إعدادات السيرفر» و«ربط فايف ام» وإنشاء القطاعات لمالك السيرفر ومن عنده ADMINISTRATOR بس.

الشرح الكامل في إعدادات السيرفر.

الخطوة 7: رتّب رتبة البوت وصلاحياته

البوت يعطي رتب القطاع ويسحبها ويغيّر أسماء الأعضاء، والديسكورد ما يخلي البوت يتحكم إلا في الرتب اللي تحت رتبته. عشان كذا:

1. افتح إعدادات سيرفر الديسكورد ← الأدوار (Roles).
2. اسحب رتبة البوت لفوق: فوق كل الرتب اللي يعطيها (رتب القطاع، و«رول القطاع الرئيسي»، ورتب الدورات والمسؤوليات)، وفوق أعلى رتبة عند الأعضاء اللي بيغيّر أسماءهم (اسم مالك السيرفر نفسه ما يقدر أي بوت يغيّره).
3. خلّ ADMINISTRATOR على رتبة البوت. إذا شلتها، تأكد من الصلاحيات اللي يحتاجها — منها MANAGE_ROLES للرتب وMANAGE_NICKNAMES للأسماء وMANAGE_CHANNELS لميزة «أنشئها لي»، وVIEW_CHANNEL وSEND_MESSAGES وEMBED_LINKS في كل قناة ينشر فيها.

لو الترتيب غلط بتشوف في معالج القطاع رتب مقفلة تحتها «هذه الرتبة أعلى من رتبة البوت أو تساويها — ارفع رتبة البوت فوقها ليستطيع تعيينها»، أو رسالة «رتبة البوت أقل من أعلى رتبة للعضو — لا يمكن تعديله. انقل رول البوت لأعلى.» التفاصيل في صلاحيات البوت في الديسكورد.

الخطوة 8: أنشئ أول قطاع

من «نظرة عامة» ← قسم «القطاعات» ← «إنشاء قطاع». المعالج 9 خطوات:

1. «السيرفر و FiveM»: يتأكد إن سيرفر فايف ام مربوط وشغّال، وبدونه ما يفتح «التالي».
2. «اختيار القطاع»: تختار وظيفة من سيرفرك، مثل police للأمن العام (الشرطة). الوظيفة اللي فيها أقل من 3 رتب تطلع «مغلق». في vRP اسم الخطوة «إنشاء القطاع» وتعرّف القطاع بنفسك.
3. «هوية القطاع»: الشعار (إلزامي) والبنر، واللون والإيموجيات، و«هيكل الكود» مع «حرف القطاع (الرمز)». الوظائف المعروفة مثل police يجيها شعار جاهز.
4. «ربط الرتب»: كل رتبة تنربط برول ديسكورد. في المطابقة الذكية تختار أول وآخر رتبة من رتب الديسكورد وتضغط «طابِق»، وهي تعبّيها لك. ولازم تربط الرتب كلها. في vRP تختار من «مجموعات vRP» (مجموعات الوظائف بس)، وكل مجموعة تصير رتبة.
5. «الأدوار الخاصة»: «رول القطاع الرئيسي» (إلزامي)، و«رتب القيادة» و«رتب الدورات» و«رتب المسؤوليات» (اختيارية).
6. «القنوات»: تختار تصنيفات (Categories) القطاع وتضغط «مطابقة القنوات»، وبعدها لكل قناة «اختر قناة موجودة» أو «أنشئها لي».
7. «لوحات المتصدرين»: نطاق الرتب للوحتي المتصدرين.
8. «الأماكن»: تختار إعداد أماكن جاهز، وتعدّل الأماكن لاحقاً من لوحة القطاع.
9. «المراجعة»: تراجع كل شي وتضغط «إنشاء القطاع».

بعد الإنشاء تطلع نافذة «جارٍ إضافة الأعضاء إلى القطاع» بشريط تقدّم حي، والبوت يوظّف تلقائياً كل عضو يحمل رتب القطاع في الديسكورد، وتنزل لوحات المتصدرين والقوانين والمتصلين في قنواتها. البوت ما يخترع أكواد: اللي اسمه فيه كود بنفس هيكل الكود (مثل [P-012] سعود) يحتفظ فيه، واللي بدون كود يتوظف بدون كود لين يعطيه القائد واحد.

أخطاء شائعة:

• زر «إنشاء قطاع» مقفل: خطتك ما فيها مكان لقطاع جديد، ويطلع جنبه «وصلت الحد الأقصى — رقّ الخطة لإضافة قطاعات»، أو «إنشاء القطاعات معطّل في خطتك الحالية» إذا ما عندك اشتراك.
• «السيرفر غير متصل حالياً — شغّل السيرفر وسكربت OrcaBot ثم أعد المحاولة.»: شغّل سيرفر فايف ام أول.
• رول ما ينختار: السبب مكتوب تحت اسم الرول، وإذا كان رتبة البوت ارجع للخطوة 7.

الشرح الكامل في كيفية إنشاء قطاع جديد، والقطاعات الجاهزة في القطاعات المدعومة.

الخطوة 9: جرّب البوت بأمر المساعدة

1. ادخل أي قناة داخل تصنيف القطاع اللي اخترته في خطوة «القنوات».
2. اكتب /مساعدة واختره من أوامر أوركا بوت.
3. البوت يرد برسالة تشوفها أنت بس، عنوانها «مساعدة أوركا بوت» وفيها رابط «لوحة تحكم القطاع».

إذا جاك «هذا الأمر يجب استخدامه داخل قناة تابعة لقطاع مسجل»، فالقناة مو داخل تصنيف القطاع. وإذا جا عضو «هذا الإجراء متاح لمنتسبي القطاع الفعّالين فقط»، فهو للحين مو موظف في القطاع. باقي الأوامر في أوامر البوت.

الصلاحيات

• إضافة البوت، شراء الخطة، «ربط فايف ام»، «إعدادات السيرفر» و«إنشاء قطاع»: مالك السيرفر ومن عنده ADMINISTRATOR بس.
• «شحن الرصيد»: مالك السيرفر ومن عنده ADMINISTRATOR، وقادة القطاعات. القائد يشوف «ترقية الخطة» بعد، لكن زر الشراء يطلع له مقفل.
• /مساعدة: أعضاء القطاع الموظفين وقادته، ومالك السيرفر ومن عنده ADMINISTRATOR — داخل قنوات تصنيف القطاع.

التفاصيل في مستويات الوصول والصلاحيات.

ملاحظات مهمة

• إذا انتهى الاشتراك تتعطل القطاعات بدون ما تنحذف بياناتها.
• صفحة «الربط» تعرض نسخة السكربت عندك والأحدث، وإذا صارت نسختك أقل من المطلوب يطلع «تحديث السكريبت مطلوب».

أسئلة شائعة

هل لازم أشترك قبل ما أربط سيرفر فايف ام؟

نعم. «ربط فايف ام» متاح بس للسيرفرات اللي خطتها تسمح بقطاع واحد على الأقل، وبدونها تطلع لك «ربط فايف ام غير متاح في باقتك» مع زر «ترقية الخطة».

وين ألقى كود سيرفر فايف ام؟

في servers.fivem.net: ابحث عن سيرفرك وانسخ الكود من آخر رابط صفحته. وتقدر تلصق رابط cfx.re/join/... كامل، والموقع يطلّع الكود منه بنفسه.

كتبت أمر accept وما صار شي، ليش؟

لازم تكتبه في كونسول السيرفر مو F8 داخل اللعبة، وبنفس رقم الطلب اللي في الصفحة، وقبل ما يخلص عداد الـ5 دقايق. إذا انتهى الوقت اضغط «إعادة المحاولة» وأكّد الربط من جديد.

هل أحتاج أعدّل ملفات السكربت أو أحط كود في ملف؟

لا. ما فيه ملف إعدادات، والربط ينحفظ تلقائياً بعد أمر الكونسول ويرجع بعد كل إعادة تشغيل. أي إعداد للسكربت تغيّره من تبويب «إعدادات السكربت».

أقدر أربط نفس سيرفر فايف ام بأكثر من سيرفر ديسكورد؟

لا. كل سيرفر فايف ام يرتبط بسيرفر ديسكورد واحد. عشان تنقله، اضغط «فصل الخادم» من لوحة السيرفر القديم ثم اربطه من الجديد.

ليش رول ما ينختار في «ربط الرتب»؟

غالباً الرول أعلى من رتبة البوت أو يساويها، أو البوت ما عنده MANAGE_ROLES، أو الرول أعلى من رتبتك، أو مستخدم لغرض ثاني أو في قطاع ثاني. السبب مكتوب تحت اسم الرول، ولو كان السبب رتبة البوت ارفعها فوقه من إعدادات الديسكورد. والرول اللي عليه صلاحيات إدارية يطلب منك تأكيد إذا رتبتك أعلى منه، وإلا ينقفل.

هل كل قطاع له اشتراك لحاله؟

لا. الاشتراك على مستوى سيرفر الديسكورد كامل، والخطة تحدد كم قطاع تقدر تشغّل.

مقالات ذات صلة

• ما هو أوركا بوت؟ بوت إدارة قطاعات فايف ام
• ربط سيرفر فايف ام بأوركا بوت — التثبيت والمزامنة
• صلاحيات أوركا بوت في الديسكورد وترتيب رتبة البوت
• كيفية إنشاء قطاع جديد في أوركا بوت
• حل مشاكل أوركا بوت الشائعة

آخر تحديث: 2026-10-29