Installation
التثبيت
أربع خطوات: استيراد ملف SQL، منح نفسك صلاحية الوصول إلى محرر النصوص، تسجيل العناصر الخاصة بك، وتشغيل الموارد.
1. المكونات المطلوبة
| المورد | مطلوب | السبب |
|---|---|---|
ox_lib |
نعم | الاستدعاءات (Callbacks)، الإشعارات، والترجمات |
oxmysql |
نعم | تخزين المواد وحالة إدمان اللاعب |
| مورد استهداف (Targeting) | اختياري | فحص اللاعب بدون استخدام أمر (Command) |
2. server.cfg — ترتيب التشغيل
قم بتشغيل bupa-addictioncreator بعد تشغيل الموارد التي تعتمد عليها.
ensure ox_lib
ensure oxmysql
ensure ox_target
ensure bupa-addictioncreator3. قاعدة البيانات
قم باستيراد sql/bupa_addictioncreator.sql. سيقوم بإنشاء جدولين:
| الجدول | المحتوى |
|---|---|
bupa_substances |
تعريفات المواد التي تقوم بنشائها داخل المحرر |
bupa_addictions |
مستوى إدمان كل شخصية، القدرة على التحمل، عدد الجرعات والجلوسات السابقة |
يمكن تغيير كلا الاسميين تحت قسم Config.Tables إذا كان هناك تعارض مع نظام آخر تقوم بتشغيله حالياً.
4. الوصول إلى المحرر
يقوم المحرر بتغيير تأثيرات المخدرات داخل سيرفرك، لذلك فهو محمي بصلاحيات.
add_ace group.admin bupa.substances allow
```
{% endcode5 %}
على سيرفر تجريبي (Dev Server) حيث لم يتم إعداد صلاحيات ACE بعد، قم بإدخال معرف الرخصة (License) الخاصة بك في ملف الإعدادات بدلاً من ذلك:
{% code title="config.lua" %}
```lua
Config.Creator = {
Command = 'substances',
UseAce = true,
Ace = 'bupa.substances',
Developers = { 'license:0000000000000000000000000000000000000000' },
LivePreview = true,
}5. تسجيل العناصر الخاصة بك
كل مادة تقوم بنشائها في المحرر تشير إلى عنصر في المخزن (Inventory)، ويجب أن يكون هذا العنصر موجوداً بالفعل. قم بنسخ الجزء الخاص بالمخزن الخاص بك من الملف المطابق في install/inv/:
| الملف | الأنظمة المدعومة |
|---|---|
inv/ox_inventory.txt |
ox_inventory |
inv/qb-inventory.txt |
qb-inventory, lj-inventory, ps-inventory |
inv/qs-inventory.txt |
qs-inventory |
inv/codem-inventory.txt |
codem-inventory |
inv/tgiann-inventory.txt |
tgiann-inventory |
inv/esx.txt |
مخازن ESX الكلاسيكية |
بالنسبة لـ ox_inventory، هناك سطران مهمان في هذا الإدخال:
['meth_syringe'] = {
label = 'Meth',
weight = 20,
stack = true,
close = true,
consume = 0,
description = 'A loaded syringe',
client = { image = 'meth_syringe.png' },
server = { export = 'bupa-addictioncreator.useSubstance' },
},server.export— لا يحتوي مخزن ox_inventory على دالةCreateUseableItem، لذلك يُعد هذا التصدير (Export) هو الطريقة التي يتعرف بها المورد على استخدام العنصر.consume = 0— بدون هذا الخيار، سيقوم مخزن ox_inventory بإزالة العنصر قبل أن يقرر المورد ما إذا كانت الجرعة مسموح بها أم لا. يقوم المورد بإزالة العنصر بنفسه بمجرد التحقق من ذلك.
على أنظمة QBox و QB-Core و ESX، يقوم المورد بتسجيل العنصر القابل للاستخدام بنفسه من خلال النظام الأساسي، لذا فإن إضافة useable = true على العنصر هي كل ما تحتاجه.
يجب أن يتطابق اسم العنصر في المحرر تماماً مع اسم العنصر في المخزن الخاص بك، وبأحرف صغيرة (Lower Case). يقوم المحرر بتحويل ما تكتبه إلى أحرف صغيرة؛ لذا يجب أن يتطابق ملف العناصر الخاص بك مع ذلك.