أنظمة الـ Inventory

4. العناصر وأنظمة الـ inventory

العناصر مطلوبة فقط على سيرفرات الـ framework. الملفات موجودة في config/items/ والصور في config/items/images/.

ما يفعله الهاتف بنفسه. عند بدء التشغيل يحدد العناصر التي تحتاجها الميزات التي فعّلتها (الجدول أدناه)، ثم:

في فحص بدء التشغيل سطر Items واحد: [OK] عندما تكون كل العناصر موجودة، أو [FAIL] مع الأسماء الناقصة والحل أسفله. يطبعه phone:health مجددًا بعد أن تصلح شيئًا.

إذا كان عنصر ناقصًا، يبدأ الهاتف رغم ذلك. يعطّل المتجر العلب أو يوقف بيع ذلك العنصر، ويذكر الكونسول العنصر المطلوب إضافته.

الـ Reserves تتكدس. الحزم الممتلئة لا تحمل metadata، لذا يمكن أن تشترك حتى 20 منها في خانة واحدة. الحزمة التي تُنزع وهي مستخدمة جزئيًا تصبح عنصرًا مستقلًا بشحنتها في الـ metadata الخاصة بها (على ox_inventory وqb-inventory وqs-inventory)، لذا تحتاج إلى خانة فارغة. وبدون metadata للعناصر (standalone، والـ inventory الافتراضي لـ ESX) تُتتبَّع فقط الحزمة المستخدمة، واحدة لكل شخصية لكل حجم.

مع Config.Item.required = true (أو الهواتف الفريدة) يتحقق السيرفر من عنصر الهاتف عبر الـ inventory لديك ويرفض طلبات الهاتف من اللاعب الذي لا يملكه. فقدان العنصر يُنهي مكالمات ذلك اللاعب، بما فيها مكالمات الطوارئ، ويغلق الهاتف.

إعطاء علبة مختومة لشخص آخر. على ox_inventory وqb-inventory وqs-inventory يحمل عنصر العلبة نفسه الموديل والتشطيب اللذين تم شراؤهما، لذا من يفتحها يحصل على ذلك الهاتف. وعلى كل inventory آخر تكون العلبة عنصرًا عاديًا، والموديل والتشطيب محفوظان في سجل شراء المشتري نفسه: العلبة المُعطاة تنفتح كعملية الشراء التالية للمالك الجديد، أو بالموديل والتشطيب الافتراضيين. مع Config.Store.boxPerFinish = true يحتفظ اسم عنصر العلبة بالتشطيب، لكن ليس بالموديل.

النص الدقيق للصق، للـ inventory الخاص بك

لن تحتاج أبدًا إلى كتابة إدخال عنصر بنفسك. عندما يكون عنصر ناقصًا، يطبع فحص بدء التشغيل النص الدقيق للـ inventory الخاص بك أسفل الصندوق، ويعرض Settings > Server > Health Check نفس النص مع زر Copy. الصقه، وأعِد تشغيل الـ inventory والهاتف، وشغّل phone:health مرة أخرى.

كيف يبدو كل منها، للـ Reserve:

-- ox_inventory/data/items.lua
['pulse_magpack'] = { label = "Pulse Reserve", weight = 110, stack = true, close = true, consume = 0, description = "Magnetic battery pack. Fills 70% of a phone.", client = { export = "phone.usePack", image = "pulse_magpack.png" } },

-- qb-core/shared/items.lua, qs-inventory and similar
['pulse_magpack'] = { name = "pulse_magpack", label = "Pulse Reserve", weight = 110, type = 'item', image = "pulse_magpack.png", unique = false, useable = true, shouldClose = true, description = "Magnetic battery pack. Fills 70% of a phone." },

-- TMC
['pulse_magpack'] = { ['label'] = "Pulse Reserve", ['weight'] = 110, ['type'] = 'item', ['image'] = "pulse_magpack.png", ['unique'] = false, ['stackable'] = true, ['useable'] = true, ['shouldClose'] = true, ['description'] = "Magnetic battery pack. Fills 70% of a phone." },

-- ESX default inventory
INSERT IGNORE INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
  ('pulse_magpack', 'Pulse Reserve', 1, 0, 1);

عنصر phone الخاص بـ ox_inventory. يأتي ox_inventory مع إدخال phone مصنوع لسكربت هاتف آخر. لا تحتاج إلى تغييره: استخدامه يفتح Pulse Phone. في فحص بدء التشغيل سطر Phone item يوضح كيف يعمل إدخالك. فقط عندما يذكر export سكربت آخر ([WARN]، أو [FAIL] مع الهواتف المطلوبة أو الفريدة) يطبع الإدخال البديل. إذا كان سكربت الهاتف الذي صُنع له ذلك الإدخال ما زال يعمل، يفتح العنصر ذلك السكربت بدلًا من Pulse: سطر Phone item يذكر اسمه؛ احذفه من server.cfg.

ما يجب فعله للـ inventory الخاص بك

لأنظمة الـ inventory الأخرى في هذا الجدول، يجعل الهاتف العناصر قابلة للاستخدام بنفسه. ox_inventory يستخدم أسطر client = { export = 'phone....' } الموجودة بالفعل في ملفه.

ox_inventory: إذا كنت تستخدم هاتفًا آخر من قبل، احذف أيضًا الـ hook الخاص به Item('phone', ...) من ox_inventory/modules/items/client.lua.

ak47_inventory يحفظ طريقة استخدام العنصر في إدخال كل عنصر. أضف هذه:

-- powerbank
server = { onUse = function(source) exports.phone:UsePowerbank(source) end },
-- pulse_magpack and pulse_magpack_max
server = { onUse = function(source, item) exports.phone:UseMagPack(source, item and item.slot, item and item.name) end },
-- pulse_cable
server = { onUse = function(source) exports.phone:UseChargingCable(source) end },
-- pulse_phone_box
server = { onUse = function(source, item) exports.phone:UseBox(source, item and item.slot) end },
-- pulse_router
server = { onUse = function(source) exports.phone:UseRouter(source) end },
-- pulse_burner
server = { onUse = function(source, item) exports.phone:UseBurner(source, item and item.slot) end },
-- pulse_case, pulse_case_clear, pulse_pouch, pulse_protector
server = { onUse = function(source, item) exports.phone:FitPhoneProtection(source, item and item.name) end },
-- pulse_buds
server = { onUse = function(source) exports.phone:UseBuds(source) end },
-- pulse_ringlight
server = { onUse = function(source) exports.phone:UseRingLight(source) end },
-- pulse_wallet
server = { onUse = function(source) exports.phone:UseCardWallet(source) end },

الهواتف الفريدة (Config.Item.unique = true) تضع رقم الهاتف على العنصر، لذا تسليم العنصر يعني تسليم الهاتف. وتحتاج إلى ox_inventory أو qb-inventory أو qs-inventory أو core_inventory أو codem-inventory.