ZeroDev Sound: دليل التثبيت

لا يحتوي هذا المورد على أي تكاملات صوتية أو موسيقية من أطراف ثالثة ولا يوفّرها. تُشغَّل الموسيقى فقط من الملفات الصوتية التي يضيفها مالك السيرفر إلى المورد ومن الراديو المدمج في GTA. لا يمكن للاعبين إدخال روابط. أضف فقط صوتًا تملكه أو تملك حقوق استخدامه وتوزيعه؛ فبثّ المحتوى دون إذن قد يخالف اتفاقية Cfx.re Creator Platform License Agreement والقانون.

سماعات يشتريها اللاعبون ويحملونها ويضعونها ويربطونها، وصوتيات سيارات يركّبونها في سياراتهم. هذا هو المرجع الكامل. للنسخة المختصرة اقرأ docs/SETUP.md (5 خطوات)؛ وللمشاكل، docs/TROUBLESHOOTING.md؛ وإذا كنت قادمًا من 1.x، UPGRADING.md.

المحتويات 1. المتطلبات 2. التثبيت 3. العناصر للـ inventory الخاص بك 4. التشغيل الأول: ما يجب أن تراه 5. الإعدادات الأكثر تغييرًا 6. أزرار التحكم 7. صوتيات السيارات 8. مصادر الموسيقى 9. Pulse Phone 10. الشرطة والجيران والأدمن 11. اللغات 12. حل المشاكل 13. التحديث

1. المتطلبات

لا شيء آخر: بدون ox_lib، وبدون مفتاح API، وبدون حساب Google.

سيرفرات Linux: استخدم server artifact الموصى به (Recommended)، وليس الأحدث (Latest). في صفحة تحميل سيرفر FiveM (docs.fivem.net/docs/server-download/) اختر Linux وفرع التحديث Recommended. سيرفر على أحدث artifact لـ Linux تعطّل أثناء التحميل (طبع FXServer تفريغ /proc/self/maps)، والانتقال إلى الـ artifact الموصى به أصلح المشكلة. هذا هو البلاغ الوحيد لدينا عن Linux؛ ولم نشغّل ZeroDev Sound على سيرفر Linux بأنفسنا بعد.

على سيرفر standalone (بدون framework) كل شيء مجاني: المتجر وقطع السيارات لا تكلف شيئًا.

2. التثبيت

الخطوة 1. ضع المجلد. ضع مجلد zerodev-sound في مجلد resources (أي مجلد فرعي لا بأس به، مثلًا resources/[zerodev]/zerodev-sound). أبقِ اسم المجلد zerodev-sound: إدخالات عناصر ox_inventory تستدعيه بهذا الاسم.

الخطوة 2. أضفه إلى server.cfg، بعد قاعدة البيانات والـ framework والـ inventory:

ensure oxmysql
ensure es_extended        # or qb-core / qbx_core, or nothing on a standalone server
ensure ox_inventory       # or your inventory
ensure ox_target          # optional, or qb-target
ensure phone              # optional: Pulse Phone
ensure zerodev-sound

الخطوة 3. امنح الأدمن صلاحية الإدارة (بلا حد للسماعات، وقائمة /soundadmin، والإيقاف والإزالة عن بُعد):

add_ace group.admin zerodev.sound.admin allow

الخطوة 4. أعدّ العناصر للـ inventory الخاص بك: القسم 3. على inventory الخاص بـ ESX وعلى QBCore يتم ذلك لك.

الخطوة 5. أعِد تشغيل السيرفر (إعادة تشغيل كاملة، وليس الريسورس فقط، حتى يحمّل كل لاعب الموديلات) وراجع الكونسول: القسم 4.

3. العناصر للـ inventory الخاص بك

يوجد 12 عنصرًا: عشر سماعات وحامل الميكروفون وطقم التصليح.

الصور موجودة في zerodev-sound/web/img/items/. لن تحتاج إلى التخمين أبدًا: كلما كان شيء ناقصًا، يطبع كونسول السيرفر الإدخالات الدقيقة للـ inventory الخاص بك ويذكر أي صورة ليست في مكانها بعد.

أي inventory لديك؟

لإضافة العناصر إلى qb-core يدويًا بدلًا من ترك السكربت يفعل ذلك، الصق كتلة QBCore في qb-core/shared/items.lua.

inventory آخر يحاكي أحد هذه الـ APIs: اضبط Config.Inventory عليه (راجع القسم 5). ويمكن ربط inventory خاص بك في server/bridge.lua، وهو قابل للقراءة: كل inventory هناك عبارة عن ثلاث دوال صغيرة (العدّ، والإضافة، والإزالة).

كتلة ox_inventory

الصق داخل جدول return { ... } في ox_inventory/data/items.lua:

    ['zds_repair_kit'] = { label = 'Speaker Repair Kit', weight = 600, stack = false, close = true, description = 'Fixes a broken speaker. Use it next to one.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_repair_kit.png' } },
    ['zds_roam'] = { label = 'Roam Portable Speaker', weight = 2000, stack = false, close = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_roam.png' } },
    ['zds_room_ceiling'] = { label = 'Ceiling Speaker', weight = 2000, stack = false, close = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_ceiling.png' } },
    ['zds_room_shelf'] = { label = 'Shelf Speaker', weight = 4000, stack = false, close = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_shelf.png' } },
    ['zds_room_sub'] = { label = 'Home Subwoofer', weight = 8000, stack = false, close = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_sub.png' } },
    ['zds_room_tower'] = { label = 'Tower Speaker', weight = 10000, stack = false, close = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_tower.png' } },
    ['zds_stage_array'] = { label = 'Line Array Speaker', weight = 12000, stack = false, close = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_array.png' } },
    ['zds_stage_mic'] = { label = 'Mic Stand', weight = 3000, stack = false, close = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mic.png' } },
    ['zds_stage_mixer'] = { label = 'DJ Mixer', weight = 5000, stack = false, close = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mixer.png' } },
    ['zds_stage_monitor'] = { label = 'Stage Monitor', weight = 6000, stack = false, close = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_monitor.png' } },
    ['zds_stage_pa'] = { label = 'PA Speaker', weight = 10000, stack = false, close = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_pa.png' } },
    ['zds_stage_sub'] = { label = 'Concert Subwoofer', weight = 15000, stack = false, close = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_sub.png' } },

كتلة QBCore

شكل العناصر في QBCore، الذي تقرؤه qb- وps- وlj- وqs-inventory:

    ['zds_repair_kit'] = { name = 'zds_repair_kit', label = 'Speaker Repair Kit', weight = 600, type = 'item', image = 'zds_repair_kit.png', unique = true, useable = true, shouldClose = true, description = 'Fixes a broken speaker. Use it next to one.' },
    ['zds_roam'] = { name = 'zds_roam', label = 'Roam Portable Speaker', weight = 2000, type = 'item', image = 'zds_roam.png', unique = true, useable = true, shouldClose = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.' },
    ['zds_room_ceiling'] = { name = 'zds_room_ceiling', label = 'Ceiling Speaker', weight = 2000, type = 'item', image = 'zds_room_ceiling.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.' },
    ['zds_room_shelf'] = { name = 'zds_room_shelf', label = 'Shelf Speaker', weight = 4000, type = 'item', image = 'zds_room_shelf.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.' },
    ['zds_room_sub'] = { name = 'zds_room_sub', label = 'Home Subwoofer', weight = 8000, type = 'item', image = 'zds_room_sub.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.' },
    ['zds_room_tower'] = { name = 'zds_room_tower', label = 'Tower Speaker', weight = 10000, type = 'item', image = 'zds_room_tower.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.' },
    ['zds_stage_array'] = { name = 'zds_stage_array', label = 'Line Array Speaker', weight = 12000, type = 'item', image = 'zds_stage_array.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.' },
    ['zds_stage_mic'] = { name = 'zds_stage_mic', label = 'Mic Stand', weight = 3000, type = 'item', image = 'zds_stage_mic.png', unique = true, useable = true, shouldClose = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).' },
    ['zds_stage_mixer'] = { name = 'zds_stage_mixer', label = 'DJ Mixer', weight = 5000, type = 'item', image = 'zds_stage_mixer.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).' },
    ['zds_stage_monitor'] = { name = 'zds_stage_monitor', label = 'Stage Monitor', weight = 6000, type = 'item', image = 'zds_stage_monitor.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.' },
    ['zds_stage_pa'] = { name = 'zds_stage_pa', label = 'PA Speaker', weight = 10000, type = 'item', image = 'zds_stage_pa.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.' },
    ['zds_stage_sub'] = { name = 'zds_stage_sub', label = 'Concert Subwoofer', weight = 15000, type = 'item', image = 'zds_stage_sub.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.' },

إذا غيّرت تسمية أو سعرًا أو وزنًا في config/catalogue.lua، انسخ الإدخالات من الكونسول لديك بدلًا من ذلك: فهو يطبعها من إعداداتك.

4. التشغيل الأول: ما يجب أن تراه

في كونسول السيرفر

يطبع ZeroDev Sound صندوق فحص واحدًا (اكتب soundcheck في كونسول السيرفر لطباعته مجددًا): قاعدة البيانات والمخطط، والـ framework، والأموال، والـ inventory والعناصر، وجدول الكراج، والـ targeting، وPulse Phone، والموديلات، وورش التركيب، والإعدادات التي تغيّرت داخل اللعبة. كل سطر ليس OK يوضح ما يجب فعله؛ ويعرض docs/SETUP.md مثالًا ويشرح docs/TROUBLESHOOTING.md كل سطر.

• سطر الـ framework يذكر ما تم العثور عليه. إذا كان خاطئًا، اضبط Config.Framework أو Config.Inventory في config/config.lua.
• سطر أصفر Add these to ox_inventory/data/items.lua ... (أو ... if these items are not in ... yet, add them) تتبعه إدخالات عناصر: نفّذ القسم 3 للـ inventory الخاص بك، ثم أعِد التشغيل. رسالة ox_inventory تتوقف بمجرد إضافة العناصر. على qs- وcodem- وorigen- وtgiann-inventory تُطبع الإدخالات عند كل تشغيل كتذكير، سواء أضفتها أم لا.
• سطر أصفر Copy zds_....png from zerodev-sound/web/img/items into ...: تلك الصور ليست في مجلد صور الـ inventory لديك بعد. ويذكر اسم المجلد.
• Pulse Phone app not registered: ...: Pulse Phone يعمل لكنه رفض التطبيق. راجع القسم 9.

داخل اللعبة (خمسة فحوصات)

1. تُظهر الخريطة علامة ZeroDev Sound في Legion Square وعلامة Car audio bay عند Benny's.
2. في المتجر، يقف بائع عند منصة تُعرض عليها السماعات. استهدف البائع (أو اضغط E عند عدم وجود ريسورس target) واشترِ Roam Portable Speaker.
3. استخدمها من الـ inventory. ستخرج في يديك. اضغط E، وافتح Library وشغّل Night Drive (مقطع تجريبي يأتي مع السكربت). من حولك يسمعونه.
4. اركب سيارة. في المرات الأولى، تُظهر زاوية الشاشة أي مفتاح يفتح ستيريو السيارة (K افتراضيًا).
5. ادخل بسيارتك إلى ورشة صوتيات السيارات كسائق واضغط E. تنفتح أداة التركيب على سيارتك.

5. الإعدادات الأكثر تغييرًا

داخل اللعبة: /soundadmin > Settings يغيّر الإعدادات الشائعة مباشرةً للجميع (ورش التركيب، ومن يستطيع التركيب، وأي سيارات، والأسعار، وأعلى مستوى صوت، وساعات الهدوء، والحدود، والمتجر، والشرطة، والتلف). وتُحفظ في قاعدة البيانات ولها الأولوية على config.lua حتى تضغط Reset to config في اللوحة.

كل شيء موجود في config/config.lua ما لم يُذكر غير ذلك. المنتجات والأسعار وقطع السيارات في config/catalogue.lua؛ وصوت المصنع لكل سيارة في config/vehicles.lua.

أسماء العناصر. إذا كان سكربت آخر يستخدم مسبقًا أحد أسماء العناصر zds_، أعِد تسمية مفتاح ذلك المنتج في Catalogue.Speakers (مثلًا zds_roam = { ... })، ثم استخدم الاسم الجديد في الـ inventory لديك وأعِد تسمية صورته لتطابقه.

6. أزرار التحكم

في الريموت: Music (مكتبة السيرفر)، وQueue (التالي، والقوائم المحفوظة)، وSpeakers (طاقة كل سماعة ومستواها، والربط، والتجميع)، وTune (ستة أوضاع صوت، ومعادل صوت بثلاثة نطاقات، ومن يختار الموسيقى، وساعات العمل، و"Real distance" لتجهيزات الحفلات). من يختار الموسيقى: Only me؛ أو Party، حيث يمكن لأي شخص قريب طلب أغانٍ ليوافق عليها المالك؛ أو Anyone، حيث يمكن للقريبين التشغيل والإيقاف المؤقت والتخطي والإضافة إلى قائمة الانتظار والتقديم. Opening hours تشغّل تلقائيًا إحدى قوائم المالك بين ساعتين، لمتجر أو نادٍ.

الميكروفون (يحتاج pma-voice). أثناء حملك له، يسمع كل من هو قرب أي سماعة في ذلك النظام صوتك عبرها، بصوت يشبه نظام PA، وبنفس علو الموسيقى التي تشغلها تلك السماعة وإلى نفس المسافة التي تصل إليها؛ ابتعد 4 m عن الميكسر أو حامل الميكروفون، أو افصل الاتصال، أو أعد الميكروفون، فيعود صوتك طبيعيًا. صاحب النظام وحده (والمشرفون، في حالة السيارة) يمكنه الغناء عبره؛ امنح اللاعبين الآخرين صلاحية ace zds.mic ليستخدموا أي نظام. صوتك لا يُسمع من موضع كل سماعة: الدردشة الصوتية لا تستطيع وضع الصوت هناك، لذا يسمعك من هم قرب السماعة بعلو تلك السماعة بدلًا من ذلك. الإعدادات: Config.Mic.

7. صوتيات السيارات

كيف يركّب اللاعبون

1. ادخل بسيارتك إلى ورشة صوتيات السيارات (Benny's افتراضيًا) واضغط E كسائق.
2. ابدأ من طقم جاهز (Daily thump، Competition، Trunk wall، Sound quality، Clean and hidden) أو اختر القطع: سبووفرات (من 8" إلى 18")، وصناديق، وأمبليات، وسماعات أبواب، وتويترات، وpods، وأرضيات مزيفة، وألواح، وبليكسي، ومكثّف، وبطارية ثانية، وشريط LED، ووحدة رأس (head unit).
3. اسحب كل قطعة إلى مكانها في السيارة. الـ subs تستقر في فتحات صندوقها. كل قطعة تأخذ تشطيبًا (ثمانية ألوان)، والـ subs والسماعات تأخذ شبكة وحلقة إضاءة. Mirror ينسخ القطعة إلى الجهة الأخرى؛ وFine position يحرّكها بخطوات صغيرة. خمسة مناظر للكاميرا: Boot وCabin وSide وFront وTop. الحجم: الـ subs متوفرة بقياس 8" و10" و12" و15" و18" (كل الـ subs في صندوق واحد بنفس الحجم والصندوق يُبنى حولها، حتى 30% أكبر أو أصغر مما صُنع له)؛ وسماعات الأبواب بقياس 5.25" و6.5" و6x9"؛ وكل قطعة أخرى من 80% إلى 130% بخطوات 5% (وحدة الرأس بحجم قياسي). الصناديق والألواح الأكبر تكلف أكثر؛ والقطعة التي تُصغَّر لا تكلف شيئًا. المخاريط تتحرك أكثر في السماعات الأكبر، وسماعة الباب الأكبر تصل إلى ترددات أخفض.
4. اضغط Test system لسماع التركيب يعمل في السيارة قبل الدفع. يشغّل أول أغنية في Config.Library (المقطع التجريبي المرفق ما لم تغيّره).
5. اضغط Install. تُحسب فقط القطع الجديدة على السيارة؛ والقطع المحتفظ بها من التركيب السابق لا تُحسب مرة أخرى.

يُحفظ التركيب مرتبطًا باللوحة ويعود كلما عادت السيارة: من أي كراج أو حجز أو إعادة ظهور. لا شيء يُعدَّل في سكربت الكراج لديك.

ما يسمعه اللاعبون

• كل سيارة لديها مسبقًا صوت مصنع حسب الفئة والموديل: نظام بأربع سماعات، أو نظام premium بعشر سماعات، أو نظام reference بثلاث عشرة سماعة، وسماعات في هيكل الدراجات النارية؛ أما الدراجات الهوائية والطائرات والقطارات فليس لها صوت. السماعات المركّبة تحل محل سماعات المصنع الأقرب إليها؛ والـ subs تُضاف إليه.
• خارج السيارة، يمر الباص غالبًا عبر الهيكل. الأبواب المفتوحة والنوافذ المفتوحة والصندوق المفتوح كل منها يُخرج المزيد من الصوت، نحو الجهة التي يواجهها.
• السيارة التي فيها subs تهتز برفق على نوابضها مع الباص وهي متوقفة أو تسير ببطء شديد (وليس أثناء القيادة أبدًا)، ويشعر كل من بداخلها بالـ kick.
• الستيريو (K) فيه مستوى الصوت، ومستوى الـ sub، والـ fader، والـ balance.
• الـ subs التي تُدفع لفترة أبعد بكثير مما يسمح به الأمبلي وتصنيفها، قرب أعلى مستوى صوت، قد تحترق. يرى كل من بالقرب من السيارة خيطًا رفيعًا من الدخان من ذلك الـ sub ويسمع فرقعة مكتومة. الـ sub المحروق يتوقف عن الحركة، وينخفض الباص، ويبقى مخروطه متفحمًا حتى يُستبدل في الورشة (الـ sub الجديد يُدفع ثمنه؛ وإزالة الأثر ليست تصليحًا مجانيًا). يمكن للطاقم عرض ذلك: /soundblow داخل السيارة، أو soundblow <plate> في كونسول السيرفر.

أي سيارات يمكن التركيب فيها (Config.Install.vehicles)

• 'owned' (الافتراضي): فقط السيارات الموجودة في جدول المركبات المملوكة في الـ framework لديك (owned_vehicles في ESX، وplayer_vehicles في QBCore وQbox).
• 'any': أيضًا السيارات التي لا يملكها أحد (سيارات الـ NPC، والسيارات المُستدعاة، والمستأجرة).
• في الحالتين، السيارة التي يملكها لاعب آخر تبقى له: فقط مالكها، أو ميكانيكي في الدوام من Config.Install.jobs، أو أدمن يمكنه تغييرها. على سيرفر standalone كل سيارة تُعتبر مملوكة.

الكراجات واللوحات والحجز

• تُطابَق اللوحات بعد إزالة المسافات وبالأحرف الكبيرة، لذا فالكراجات التي تضيف مسافات أو تغيّر حالة الأحرف تبقى متطابقة.
• السيارة ذات اللوحة المزيفة أو المتغيرة لا تجد تركيبها حتى تعود لوحتها المحفوظة.
• السيارات الموجودة فقط على شاشة لاعب واحد (معاينات الكراج، وبعض سيارات المعارض) لا تحصل على تركيب أبدًا: فهي ليست سيارات حقيقية بالنسبة لأي شخص آخر.

سكربتات صوت أو ستيريو أخرى

ZeroDev Sound ريسورس مستقل بأوامره الخاصة (/sound، /caraudio، ...) وأحداثه وstate bags المركبات الخاصة به، لذا لا يحل محل سكربتات أخرى ولا يغيّرها (أثناء التشغيل في سيارة يُطفئ فقط راديو السيارة الأصلي في GTA). تشغيل سكربتي صوتيات سيارات على نفس السيارة في آن واحد لم يُختبر معًا: استخدم ستيريو واحدًا لكل سيارة.

8. مصادر الموسيقى

تُشغَّل الموسيقى فقط من الملفات الصوتية التي تضيفها إلى المورد. يختار اللاعبون من قائمتك؛ ولا يمكنهم إدخال روابط، ولا يُشغَّل أي عنوان ويب أبدًا. أضف فقط صوتًا تملكه أو تملك حقوق استخدامه وتوزيعه.

• ضع ملفات mp3 أو ogg في zerodev-sound/web/library/ وأدرج كل ملف في Config.Library بهذا الشكل: { title = '...', artist = '...', file = 'name.mp3' }. تحصل على التجربة الكاملة: صوت 3D، والغرف والجدران، ومقصورات السيارات، وأوضاع الصوت، وEQ، ومخروطات تتحرك مع الباص الحقيقي.
• Config.Sources.library = false يوقف المكتبة.
• راديو السيارة الأصلي في GTA يظل يعمل في أي سيارة ما دامت لا تُشغَّل فيها أغنية من هذا المورد.
• يعرض مربع بدء التشغيل عدد الأغاني التي يمكن للاعبين اختيارها، ويحذّر من أي إدخال تم تخطّيه (اسم ملف ليس mp3 أو ogg داخل web/library/).
• التحديث من 3.0.0: الأغاني المحفوظة والأغاني الأخيرة وعناصر القوائم التي كانت روابط لم تعد تظهر ولا تُشغَّل. أغاني المكتبة تستمر بالعمل.

9. Pulse Phone

لا شيء لإعداده. عندما يعمل Pulse Phone على السيرفر (اسم الريسورس phone، بأي من الإصدارين):

• يحصل كل هاتف على تطبيق Sound على شاشته الرئيسية. وهو نفس جهاز التحكم في /sound: اتصل بسماعة أو بالسيارة، واختر الموسيقى، وأدِر المجموعة كلها. يمكن للاعبين حذفه واستعادته من App Hub.
• ما يُشغَّل على السماعة أو السيارة المتصلة، مع الوقت المتبقي، يظهر على الـ Island وشاشة القفل. والنقر يفتح تطبيق Sound.
• Pulse Drive (شاشة السيارة في Pulse، F10 افتراضيًا) يعرض ستيريو السيارة التي تجلس فيها: الأغنية والفنان والغلاف، مع التشغيل والإيقاف المؤقت والسابق والتالي ومستوى الصوت، وزر Open لتطبيق Sound. هذا يحتاج Pulse Phone 1.2.9 أو أحدث؛ والإصدارات الأقدم ببساطة لا تعرضه.

اللاعبون بدون الهاتف يستخدمون /sound وK، اللذين يفعلان كل ما يفعله التطبيق.

إذا أعدت تسمية مجلد الهاتف، أضف هذا السطر إلى config/config.lua باسمه:

Config.PulseResource = 'phone'

10. الشرطة والجيران والأدمن

11. اللغات

يأتي السكربت بنفس اللغات الـ 25 الموجودة في Pulse Phone. اضبط واحدة منها في config/config.lua:

Config.Locale = 'de'، على سبيل المثال. القيمة الافتراضية 'auto' تتبع Pulse Phone: يأخذ السيرفر Config.Locale الخاص بـ Pulse، ويحصل كل لاعب على Sound باللغة التي اختارها في هاتفه. بدون Pulse تكون الإنجليزية. رسائل اللعبة وتلميحات المفاتيح وأسماء العناصر واسم مفتاح الستيريو موجودة في locales/<code>.lua؛ والواجهة (جهاز التحكم، وستيريو السيارة، والمتجر، وأداة التركيب، وتطبيق Pulse) في locales/<code>_ui.lua. أي نص ناقص يظهر بالإنجليزية.

لتغيير سطر، عدّله في ملف تلك اللغة. أبقِ كل %s و%d و%.1f و%% و~a~ كما هي. لإضافة لغة خاصة بك، انسخ locales/en.lua إلى locales/xx.lua، وغيّر Locales['en'] إلى Locales['xx'] (في الموضعين)، وترجم النص بين علامات الاقتباس، واضبط Config.Locale = 'xx'. يسرد locales/ui_strings.txt كل مفاتيح الواجهة لملف xx_ui.lua.

12. حل المشاكل

اللاعبون لا يستطيعون استخدام عناصر السماعات

• ox_inventory: يجب أن تكون الإدخالات داخل ox_inventory/data/items.lua مع سطر client الخاص بها، ويجب إعادة تشغيل ox_inventory بعد اللصق. ويجب أن يبقى اسم المجلد zerodev-sound (الإدخالات تستدعي zerodev-sound.useItem).
• QBCore / ESX: يجب أن يبدأ zerodev-sound بعد الـ framework في server.cfg.
• codem-inventory على QBCore: أكمل الخطوة الخاصة بـ codem-inventory التي توجّه QBCore.Functions.UseItem إليه.
• بدون inventory: السماعات ليست عناصر. يفتح اللاعبون /sound ويضغطون Set up تحت Your speakers.

صور العناصر مفقودة

• ox_inventory: لا شيء لنسخه؛ مسار الصورة يشير إلى zerodev-sound. إذا كانت فارغة، تحقق من سطر image = 'nui://zerodev-sound/...' في الإدخال ومن اسم المجلد.
• أنظمة inventory أخرى: اقرأ سطر الكونسول Copy ... into ...: فهو يسرد الصور الناقصة والمجلد الذي تذهب إليه. انسخها من zerodev-sound/web/img/items/ وأعِد تشغيل الـ inventory.

لا يستطيع اللاعب تشغيل رابط

هذا مقصود: يختار اللاعبون من مكتبتك فقط. أضف الأغنية إلى Config.Library (القسم 8).

لا يوجد صوت إطلاقًا

• المتصفح المدمج في FiveM يبدأ الصوت بدون نقرة، لذا لا يحتاج اللاعبون أبدًا إلى الضغط على أي شيء "للسماح" بالصوت. إذا كان لاعب واحد لا يسمع شيئًا بينما يسمع الآخرون، تحقق من FiveM في خالط مستوى الصوت (volume mixer) في Windows لديه.
• تحقق من السماعة في تبويب Speakers في جهاز التحكم: قد تكون مطفأة، أو Broken.
• ربما أطفأتها الشرطة (لمدة Config.Police.silenceMinutes)، أو أن ساعات الهدوء تحدّ من مستوى الصوت (Config.QuietHours).
• يسمع اللاعب كحد أقصى Config.Streaming.maxAudibleSessions أغنية منفصلة في آن واحد (6)، الأقرب أولًا.
• Test system في أداة التركيب صامت عندما يكون Config.Library فارغًا أو Config.Sources.library = false: فهو يشغّل أول أغنية في المكتبة.

المتجر غير موجود

• يجب أن تكون قيمة Config.Shop.enabled هي true.
• البائع والمنصة يظهران فقط عندما يكون اللاعب ضمن حوالي 70 m من Config.Shop.locations، وعلى شاشة ذلك اللاعب فقط. تحقق من الإحداثيات التي ضبطتها.
• مع ox_target أو qb-target، استهدف البائع. وبدون أي منهما، قف عند البائع: E لتصفح السماعات.

السماعة تظهر كسماعة GTA عادية، أو لا تظهر إطلاقًا

مجلد stream/ مفقود أو أُعيدت تسميته، أو أن اللاعب دخل قبل بدء الريسورس. أعِد تشغيل السيرفر وأعِد الاتصال.

رسائل صوتيات السيارات وما تعنيه

الشرطة لا ترى خياراتها

أضف أسماء وظائف الشرطة لديك إلى Config.Police.jobs. يجب أن يكون اللاعبون في الدوام.

13. التحديث

عند الانتقال من 1.x إلى 2.0: اقرأ UPGRADING.md. وبين إصدارات 2.x:

1. خذ نسخة احتياطية من مجلد config/، وlocales/ إذا كنت قد ترجمته، وأي أغانٍ أضفتها إلى web/library/.
2. أوقف السيرفر. استبدل مجلد zerodev-sound بالجديد (احتفظ بالاسم).
3. أعِد ملفات config/ الخاصة بك. إذا ذكرت ملاحظات التحديث إعدادات جديدة، انسخ تلك الأسطر من الملفات الجديدة إلى ملفاتك.
4. شغّل السيرفر واقرأ الكونسول. العناصر الجديدة، إن وُجدت، تُطبع للـ inventory الخاص بك.

السماعات الموضوعة وتركيبات السيارات وقوائم التشغيل محفوظة في قاعدة البيانات (zds_speakers، zds_car_builds، zds_playlists، zds_stash) ولا يمسّها التحديث.

العودة إلى الإصدار السابق: احتفظ بمجلد zerodev-sound السابق خارج resources حتى يعمل الإصدار الجديد جيدًا، وخذ نسخة احتياطية من قاعدة البيانات قبل التحديث. للعودة، أوقف السيرفر، وأعد المجلد السابق وconfig/ الخاص بك إلى مكانهما، ثم شغّله. لم تُختبر العودة من 3.0 إلى 2.x على نفس قاعدة البيانات، لذا استعد النسخة الاحتياطية لقاعدة البيانات إذا بدا أي شيء غير سليم.