الفريموركات المدعومة في فايف ام — ESX و QB-Core (CFW) و vRP ومود الشرطة

الفريموركات المدعومة في أوركا بوت لسيرفرات فايف ام (FiveM): ESX و QB-Core (CFW) و vRP ومود الشرطة وأي فريمورك خاص عبر الدعم، وكيف يكتشف السكربت فريمورك سيرفرك.

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

الفريموركات المدعومة في أوركا بوت هي ESX، QB-Core (CFW)، vRP، مود الشرطة (Police Mod)، وأي فريمورك خاص عن طريق التواصل مع الدعم في ديسكورد أوركا بوت. سكربت OrcaBot_V3 يتعرف على ESX و QB-Core (CFW) و vRP بنفسه أول ما يشتغل، فما تحتاج تختار شي ولا تعدّل ملف إعدادات. والفرق الأهم بينهم هو مصدر رتب القطاع: في ESX و QB-Core (CFW) تجي من وظائف سيرفرك، وفي vRP تبنيها أنت من لوحة التحكم. هنا تعرف كيف يصير التعرّف، ووش يختلف في لوحتك حسب الفريمورك، وكيف تضيف فريمورك خاص.

الفريموركات المدعومة

• ESX — السكربت يتعرف عليه من سكربت es_extended، ووظائف سيرفرك ودرجاتها (Grades) تنقرأ من اللعبة.
• QB-Core (CFW) — يتعرف عليه من سكربت qb-core، ويمشي في اللوحة مثل ESX: الوظائف والرتب من اللعبة.
• vRP — يتعرف عليه من سكربت vRP (الاسم الافتراضي vrp)، ويحتاج «ملف vRP المرافق» orcabot_hook.lua داخل vRP، ورتب القطاع تبنيها في اللوحة.
• مود الشرطة (Police Mod) — مدعوم، وتجهيز ربطه مع سيرفرك يكون عن طريق التواصل مع الدعم في ديسكورد أوركا بوت.
• أي فريمورك خاص — عن طريق التواصل مع الدعم في ديسكورد أوركا بوت: يتجهز لفريموركك ملف ربط (adapter) ينحط داخل السكربت، والطريقة في «إضافة فريمورك خاص» تحت.

كيف يتعرف السكربت على فريمورك سيرفرك؟

1. «إطار السيرفر (Framework)» يبدأ على «تلقائي»: أول ما يشتغل OrcaBot_V3 يدوّر على الفريمورك الشغّال — es_extended يعني ESX، وqb-core يعني QB-Core (CFW)، وسكربت vRP بالاسم المكتوب في «اسم سكربت vRP» يعني vRP.
2. الفريمورك لازم يشتغل قبل OrcaBot_V3: حط ensure OrcaBot_V3 في server.cfg بعد سطر الفريمورك (مثل ensure es_extended أو ensure qb-core أو ensure vrp). لو اشتغل OrcaBot_V3 قبله ما يلقاه — عدّل الترتيب وأعد تشغيل OrcaBot_V3.
3. تشوف النتيجة في «ربط فايف ام» ← تبويب «إعدادات السكربت» ← «إطار السيرفر (Framework)». تحت الخانة تطلع وحدة من هالرسائل، وتتحدّث لحالها كل 30 ثانية ما دامت الصفحة مفتوحة وما فيها تعديلات ما انحفظت: - «السكربت يعمل الآن بإطار: esx — مقفول عليه.» — لقى الفريمورك وتقفلت الخانة عليه (بدل esx يطلع qbcore أو vrp أو اسم فريموركك الخاص). - «شغّل السيرفر وانتظر اتصال السكربت — يتحدد الإطار تلقائياً.» — السيرفر طافي أو السكربت للحين ما اتصل. - «لم يجد السكربت أي إطار يعرفه — أضف إطارك بالخطوات تحت ثم اختره.» — ما لقى فريمورك يعرفه، وهنا بس تنفتح الخانة.
4. الفريمورك ينقرأ مرة وحدة وقت تشغيل السكربت، فأي تغيير على «إطار السيرفر (Framework)» أو «اسم سكربت vRP» يتطبّق بعد إعادة تشغيل OrcaBot_V3.

وش يختلف بين ESX و QB-Core (CFW) و vRP؟

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

والفريمورك الخاص يمشي في اللوحة مثل ESX و QB-Core (CFW): الوظائف والرتب من اللعبة، وتحدّث الرتب من «مزامنة الرتب».

ESX و QB-Core (CFW): الوظائف والرتب من اللعبة

• إنشاء القطاع: خطوة «اختيار القطاع» تعرض وظائف سيرفرك، والوظيفة لازم يكون فيها 3 رتب أو أكثر (الأقل تطلع «مغلق»). درجاتها تصير رتب القطاع، وتربط كل رتبة برول ديسكورد في «ربط الرتب» — التفاصيل في كيفية إنشاء قطاع جديد.
• الرتب نسخة من اللعبة: ما فيه إضافة رتبة يدوي. إذا غيّرت درجات الوظيفة في السيرفر، اضغط «مزامنة الرتب» في «الرتب و الترقيات»، وتنفتح «مزامنة الرتب مع اللعبة» تعرض التغييرات قبل ما تتطبّق: الدرجة الجديدة تصير رتبة («ستُضاف»)، والمحذوفة تنحذف رتبتها («ستُحذف») وينتقل أعضاؤها لأقرب رتبة باقية تحتها، وإذا ما فيه فلأقرب رتبة فوقها («سيُنقلون»)، والدرجة اللي تغيّر اسمها يتغيّر اسم رتبتها («أسماء ستتغيّر»). الرتب الباقية تحتفظ برول الديسكورد وشروط الترقية حقتها.
• التطبيق: اضغط «تطبيق المزامنة». وإذا فيه رتب بتنحذف أو أعضاء بينتقلون يصير الزر «مراجعة وتطبيق» ويطلب «نعم، طبّق التغييرات». وبعد كل مزامنة من هالزر تغيّر رتب القطاع، تنتظر ساعة قبل المزامنة اللي بعدها في نفس القطاع.
• المزامنة التلقائية: أوركا بعد يطبّق نفس المزامنة لحاله في مزامناته التلقائية (مثل لما تسوي «تفعيل القطاع» بعد تعطيله)، فلا تحذف درجة من وظيفة القطاع في السيرفر إلا وأنت تبي رتبتها تنحذف.
• تنبيه عدم التطابق: لما تختلف درجات اللعبة عن رتب القطاع، يطلع للإدارة في «الرتب و الترقيات» تنبيه «رتب اللعبة (FiveM) لا تطابق رتب النظام — يلزم مزامنة الرتب لتحديثها.» مع زر «مزامنة الآن».
• اسم القطاع: غيّرت اسم الوظيفة الظاهر في اللعبة؟ اضغط القلم جنب اسم القطاع في «معلومات القطاع» («مزامنة الاسم»). أما مفتاح الوظيفة (مثل police) فلا تغيّره، لأنه اللي يربط القطاع باللعبة — وإذا تغيّر تطلع «الوظيفة غير موجودة في اللعبة».
• الاسم داخل اللعبة: برقية «تغيير الاسم والكود» تغيّر اسم اللاعب داخل اللعبة، لأن خيارها الافتراضي في «اعدادات الربط باللعبة» هو «تغيير فوري»، ولو اللاعب مو داخل السيرفر ينتظره التغيير لين يدخل. وفي QB-Core (CFW) الاسم ينكتب في اسم الشخصية: أول كلمة اسم أول والباقي اسم العائلة.
• تغيير الوظيفة داخل اللعبة يوصل أوركا بوت مباشرة، ووش يصير بعده تحدده الإدارة من «اعدادات الربط باللعبة» — شوف ربط الأحداث داخل اللعبة.

vRP: الرتب تبنيها في لوحة التحكم

vRP ما فيه قائمة وظائف ولا درجات، فيه مجموعات بس. عشان كذا لوحة أوركا هي اللي تعرّف القطاع ورتبه، وكل رتبة مربوطة بمجموعة vRP.

1. الملف المرافق: وقت «ربط فايف ام»، لو الملف مو مركّب أو نسخته قديمة، تطلع بعد مرحلة السكربت مرحلة «تركيب ملف vRP المرافق». حمّل orcabot_hook.lua وحطه في مجلد vRP جنب base.lua، وأضف 'orcabot_hook.lua' كآخر سطر داخل server_scripts في fxmanifest.lua حق vRP، وأعد تشغيل vRP. لما يطبع كونسول السيرفر [OrcaBot] vRP companion installed اضغط «تحقّق وتأكيد الربط». بدون هالملف ما يكتمل ربط سيرفر vRP.
2. إنشاء القطاع: في خطوة «إنشاء القطاع» تكتب «اسم القطاع»، وفي خطوة «ربط الرتب» تختار «مجموعات vRP»: كل مجموعة تصير رتبة، وتربط كل رتبة برول ديسكورد. تنفع بس مجموعات الوظائف (gtype=job)، والمجموعة الوحدة ما تنربط إلا برتبة وحدة في السيرفر كله، فالمستخدمة في قطاع ثاني تطلع مقفولة.
3. «هيكل الرتب»: صفحة تطلع لسيرفرات vRP بس، تضيف فيها الرتب وتحذفها وترتّبها بالسحب، وتربط كل رتبة بمجموعة vRP ورول ديسكورد. حذف الرتبة ينقل أعضاءها لأقرب رتبة باقية — التفاصيل في هيكل الرتب لسيرفرات vRP.

وبعد الإنشاء:

• لما تتطبّق الترقية أو التنزيل داخل اللعبة (حسب «اعدادات الربط باللعبة»)، ياخذ اللاعب مجموعة رتبته الجديدة وتنشال القديمة، وما تنلمس مجموعاته اللي مو مربوطة برتب القطاعات (مثل مجموعات الأدمن والـVIP). والفصل يشيل منه مجموعات رتب القطاعات اللي عليه.
• أي تغيير على مجموعة رتبة اللاعب وهو داخل السيرفر، حتى من قائمة الأدمن حقت vRP، يوصل أوركا بوت على طول عن طريق الملف المرافق.
• حذفت مجموعة من cfg/groups.lua؟ «هيكل الرتب» ينبه الإدارة إن فيه رتب «تشير إلى مجموعة vRP لم تعد موجودة على السيرفر» مع زر «حذفها ونقل الأعضاء».
• ما فيه اسم داخل اللعبة يتغيّر: «تغيير الاسم والكود» تغيّر اسم الديسكورد بس. و«مزامنة الاسم» ما تشتغل في vRP («غير متاح على vRP»)، لأن اسم القطاع يجي من اللوحة مو من اللعبة.
• القطاع الجديد يبدأ و«التقارير» و«الإشراف» مطفية، وافتراضيات شروط الترقية ولوحات المتصدرين ورصد غير المتفاعلين تعتمد على النقاط بدل ساعات العمل. تقدر تشغّل «النقاط» من بطاقة «الأنظمة» في «معلومات القطاع» — شوف نظام النقاط.
• «وضع الرتب الموحّد» يتفعّل تلقائياً أول مرة يبلّغ فيها السكربت إن سيرفرك vRP، إلا إذا الإدارة سبق وغيّرته بنفسها: العضوية بالرتبة الرئيسية للقطاع وحدها، ودور الرتبة لحاله ما يوظّف أحد. تقدر تغيّره من إعدادات السيرفر، ولو طفّيته ما يرجع يتفعّل لحاله.

إضافة فريمورك خاص

الفريمورك الخاص يتجهز له ملف ربط (adapter) عن طريق التواصل مع الدعم في ديسكورد أوركا بوت. وملف الربط يناسب الفريمورك اللي يملك وظائف ودرجات مثل ESX، لأن القطاع ورتبه تنقرأ من وظائف السيرفر. ولما السكربت ما يلقى فريمورك يعرفه، تطلع نفس هالخطوات في «إعدادات السكربت» تحت «خطوات إضافة إطار آخر»:

1. اطلب من الدعم قالب ملف الربط (framework_name.lua)، ومطور سيرفرك يسمّيه باسم فريموركك ويكتب دواله.
2. حط الملف في OrcaBot_V3/bridge/adapters/<اسم الفريمورك>.lua.
3. تأكد إن الفريمورك يشتغل قبل OrcaBot_V3 في server.cfg، وأعد تشغيل OrcaBot_V3.
4. اختر «<اسم الفريمورك> (مخصص)» من «إطار السيرفر (Framework)» واضغط «حفظ التغييرات».
5. أعد تشغيل OrcaBot_V3 مرة ثانية، ولما يشتغل تطلع «السكربت يعمل الآن بإطار: <اسم الفريمورك> — مقفول عليه.»

ولو مطورك كتب داخل الملف اسم سكربت فريموركك و«إطار السيرفر (Framework)» على «تلقائي»، يلقاه السكربت بنفسه بعد إعادة التشغيل في الخطوة 3 وتتقفل الخانة عليه، فما تحتاج الخطوتين 4 و5.

الاسم: حروف إنجليزية صغيرة وأرقام و_، يبدأ بحرف، ولين 32 خانة (مثل mycore)، ونفسه في اسم الملف وداخل الملف وفي اللوحة. ولو كان الاسم المحفوظ ما لقى السكربت ملفه تطلع «لم يجد السكربت الملف bridge/adapters/<الاسم>.lua — أضفه ثم أعد تشغيل OrcaBot_V3.»

ملف الفريمورك الخاص مو داخل OrcaBot_V3.zip. إذا حدّثت السكربت واستبدلت المجلد كامل، انسخ bridge/adapters/<اسم الفريمورك>.lua وorcabot_settings.json من المجلد القديم للجديد قبل التشغيل.

الإعدادات

في «ربط فايف ام» ← «إعدادات السكربت»، وتحفظها بـ«حفظ التغييرات»:

• «إطار السيرفر (Framework)» — الافتراضي «تلقائي»، ويتقفل على الفريمورك اللي يلقاه السكربت.
• «اسم سكربت vRP» — اسم سكربت vRP في سيرفرك (الافتراضي vrp)، ويتطبّق بعد إعادة تشغيل OrcaBot_V3.
• «مصدر الفلوس (vRP)» — من وين تنخصم الغرامات وتنضاف الهدايا داخل اللعبة في vRP: «المحفظة (wallet)» (الافتراضي) أو «البنك (bank)».
• «حدث تغيير الوظيفة (ESX)» — الحدث اللي يطلقه ESX لما تتغير وظيفة اللاعب (الافتراضي esx:setJob). غيّره بس إذا سيرفرك يستخدم اسم ثاني، ويتطبّق على اللاعب لما يدخل اللعبة من جديد.

الصلاحيات

• «ربط فايف ام» و«إعدادات السكربت»: مالك السيرفر واللي عنده ADMINISTRATOR بس.
• «مزامنة الرتب» وربط الرتب برولات الديسكورد في «الرتب و الترقيات»، و«مزامنة الاسم»: للإدارة بس (مالك السيرفر واللي عنده ADMINISTRATOR). القائد يشوف زر المزامنة مقفل، وتلميحه «مزامنة الرتب متاحة لمدراء السيرفر فقط — يمكنك العرض فقط».
• «هيكل الرتب» في vRP: القادة يفتحونها، والتعديل للإدارة («تعديل الرتب متاح لإداريي السيرفر فقط.»).
• «وضع الرتب الموحّد» في «إعدادات السيرفر»: للإدارة.

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

ملاحظات مهمة

• الفريمورك لازم يشتغل قبل OrcaBot_V3، وإلا تفشل أوامر اللعبة وسببها «لم يكتمل ربط السكربت بإطار عمل السيرفر بعد — أعد تشغيل مورد OrcaBot_V3.»
• ESX و QB-Core (CFW) ينعرفون باسم السكربت بالضبط: es_extended وqb-core. لو فريموركك شغّال باسم ثاني ما يلقاه السكربت، فتواصل مع الدعم في ديسكورد أوركا بوت. أما vRP فتكتب اسمه في «اسم سكربت vRP».
• في vRP بدون الملف المرافق ما يتغيّر شي داخل اللعبة، والسبب «إضافة vRP المرافقة (OrcaBot Companion) غير مُشغَّلة على السيرفر.» وإذا ملفك قديم وقت الربط تطلع «نسخة ملف vRP المرافق قديمة. حمّل الأحدث واستبدل الملف القديم ثم أعد تشغيل vRP وأعد المحاولة.»
• في الفريمورك الخاص، الإجراء اللي ناقصه دالة في ملف الربط سببه «هذا الإجراء غير مدعوم في إطار عمل السيرفر الحالي.»
• هالأسباب تطلع جنب «السبب:» في تفاصيل البرقية وفي جدول الهدايا والغرامات، وأكثرها تكرار تلقاه على «فشل التنفيذ» في «اعدادات الربط باللعبة».

أسئلة شائعة

هل أوركا بوت يدعم سيرفرات vRP؟

إيه. السكربت يتعرف على vRP بنفسه (لو اسم سكربته مو vrp اكتبه في «اسم سكربت vRP»)، وتركّب «ملف vRP المرافق» orcabot_hook.lua داخل vRP وقت الربط. ورتب القطاع تبنيها من مجموعات vRP في معالج الإنشاء، وتعدّلها بعدين من «هيكل الرتب».

هل مود الشرطة (Police Mod) مدعوم؟

إيه، مود الشرطة (Police Mod) من الفريموركات المدعومة في أوركا بوت. تواصل مع الدعم في ديسكورد أوركا بوت عشان يجهزون لك ربطه مع سيرفرك.

فريموركي خاص ومو في القائمة، أقدر أستخدم أوركا بوت؟

إيه، عن طريق التواصل مع الدعم في ديسكورد أوركا بوت. تاخذ منهم قالب ملف الربط (framework_name.lua)، ومطور سيرفرك يكتبه ويحطه في OrcaBot_V3/bridge/adapters/، وبعدها تختاره من «إطار السيرفر (Framework)». وملف الربط يناسب الفريمورك اللي فيه وظائف ودرجات مثل ESX.

سيرفري ESX والصفحة تقول «لم يجد السكربت أي إطار يعرفه»، وش أسوي؟

غالباً OrcaBot_V3 اشتغل قبل es_extended: انقل ensure OrcaBot_V3 تحت سطر الفريمورك في server.cfg وأعد تشغيل OrcaBot_V3. ونفس الشي لـ QB-Core (CFW) مع qb-core، وفي vRP تأكد كمان إن «اسم سكربت vRP» مكتوب صح. ولو فريموركك شغّال باسم سكربت ثاني، تواصل مع الدعم في ديسكورد أوركا بوت.

ليش ما أقدر أغيّر «إطار السيرفر (Framework)»؟

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

أضفت درجة جديدة لوظيفة القطاع في سيرفري، كيف تصير رتبة؟

في ESX و QB-Core (CFW) افتح «الرتب و الترقيات» والسيرفر شغّال، واضغط «مزامنة الرتب» وراجع التغييرات وطبّقها، وبعدها اربط الرتبة الجديدة برول ديسكورد من نفس الصفحة. هذا كله للإدارة بس، وبعد كل مزامنة تغيّر الرتب تنتظر ساعة قبل اللي بعدها في نفس القطاع.

هل لازم أعدّل ملفات الفريمورك حقي؟

في ESX و QB-Core (CFW) لا: السكربت يتعرف على es_extended وqb-core بنفسه، وتركّب OrcaBot_V3 بس. وفي vRP تضيف «ملف vRP المرافق» داخل مجلد vRP وسطر واحد في fxmanifest.lua حقه.

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

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

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