ZeroDev Sound: คู่มือการติดตั้ง

รีซอร์สนี้ไม่มีและไม่ได้ให้บริการการเชื่อมต่อเสียงหรือเพลงจากบุคคลที่สามใด ๆ เพลงจะเล่นจากไฟล์เสียงที่เจ้าของเซิร์ฟเวอร์เพิ่มลงในรีซอร์สและจากวิทยุในตัวของ GTA เท่านั้น ผู้เล่นไม่สามารถใส่ลิงก์ได้ ให้เพิ่มเฉพาะเสียงที่คุณเป็นเจ้าของหรือมีสิทธิ์ใช้งานและเผยแพร่ การสตรีมเนื้อหาโดยไม่ได้รับอนุญาตอาจละเมิด Cfx.re Creator Platform License Agreement และกฎหมาย

ลำโพงที่ผู้เล่นซื้อ พกพา วาง และเชื่อมต่อกัน และเครื่องเสียงรถยนต์ที่ผู้เล่นประกอบเข้ารถของตัวเอง นี่คือเอกสารอ้างอิงฉบับเต็ม ฉบับย่ออ่านได้ที่ docs/SETUP.md (5 ขั้นตอน) ปัญหาต่างๆ ดู docs/TROUBLESHOOTING.md ถ้ามาจาก 1.x ดู UPGRADING.md

สารบัญ 1. ความต้องการของระบบ 2. การติดตั้ง 3. ไอเทมสำหรับอินเวนทอรีของคุณ 4. การเริ่มครั้งแรก: สิ่งที่คุณควรเห็น 5. ค่าตั้งที่คนเปลี่ยนบ่อยที่สุด 6. การควบคุม 7. เครื่องเสียงรถยนต์ 8. แหล่งเพลง 9. Pulse Phone 10. ตำรวจ เพื่อนบ้าน และแอดมิน 11. ภาษา 12. การแก้ปัญหา 13. การอัปเดต

1. ความต้องการของระบบ

ไม่ต้องมีอย่างอื่น: ไม่ต้องใช้ ox_lib ไม่ต้องใช้ API key ไม่ต้องใช้บัญชี Google

เซิร์ฟเวอร์ Linux: ใช้ server artifact แบบ Recommended ไม่ใช่ Latest ในหน้าดาวน์โหลดเซิร์ฟเวอร์ FiveM (docs.fivem.net/docs/server-download/) เลือก Linux และสาขาอัปเดต Recommended มีเซิร์ฟเวอร์ที่ใช้ artifact Linux รุ่นล่าสุดแครชระหว่างโหลด (FXServer แสดง dump /proc/self/maps) และการเปลี่ยนไปใช้ artifact แบบ recommended แก้ปัญหาได้ นี่เป็นรายงานเดียวเกี่ยวกับ Linux ที่เรามี เรายังไม่เคยรัน ZeroDev Sound บนเซิร์ฟเวอร์ Linux เอง

บนเซิร์ฟเวอร์ standalone (ไม่มีเฟรมเวิร์ก) ทุกอย่างฟรี: ร้านและชิ้นส่วนรถไม่คิดเงิน

2. การติดตั้ง

ขั้นตอนที่ 1 วางโฟลเดอร์ วางโฟลเดอร์ zerodev-sound ในโฟลเดอร์ resources (โฟลเดอร์ย่อยใดก็ได้ เช่น resources/[zerodev]/zerodev-sound) ใช้ชื่อโฟลเดอร์ zerodev-sound ไว้ตามเดิม: รายการไอเทมของ ox_inventory เรียกมันด้วยชื่อนี้

ขั้นตอนที่ 2 เพิ่มลงใน server.cfg หลังฐานข้อมูล เฟรมเวิร์ก และอินเวนทอรี:

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 ตั้งค่าไอเทมสำหรับอินเวนทอรีของคุณ: หัวข้อที่ 3 บนอินเวนทอรีของ ESX และบน QBCore ทำให้อัตโนมัติ

ขั้นตอนที่ 5 รีสตาร์ทเซิร์ฟเวอร์ (รีสตาร์ทเต็ม ไม่ใช่แค่ resource เพื่อให้ผู้เล่นทุกคนโหลดโมเดล) แล้วตรวจคอนโซล: หัวข้อที่ 4

3. ไอเทมสำหรับอินเวนทอรีของคุณ

มี 12 ไอเทม: ลำโพงสิบตัว ขาตั้งไมค์ และชุดซ่อม

รูปภาพอยู่ใน zerodev-sound/web/img/items/ คุณไม่ต้องเดาเลย: เมื่อมีอะไรขาด คอนโซลเซิร์ฟเวอร์จะแสดงรายการที่ตรงกับอินเวนทอรีของคุณ และระบุรูปที่ยังไม่ได้วางไว้

คุณใช้อินเวนทอรีอะไร?

ถ้าต้องการเพิ่มไอเทมลงใน qb-core ด้วยมือแทนที่จะให้สคริปต์ทำ ให้วางบล็อก QBCoreลงใน qb-core/shared/items.lua

อินเวนทอรีอื่นที่ลอก API ของตัวใดตัวหนึ่งเหล่านี้: ตั้ง Config.Inventory เป็นตัวนั้น (ดูหัวข้อที่ 5) อินเวนทอรีที่เขียนเองเชื่อมได้ใน server/bridge.lua ซึ่งอ่านได้: แต่ละอินเวนทอรีในนั้นมีฟังก์ชันเล็กๆ สามตัว (นับ เพิ่ม ลบ)

บล็อก 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 ในคอนโซลเซิร์ฟเวอร์เพื่อแสดงอีกครั้ง): ฐานข้อมูลและ schema เฟรมเวิร์ก เงิน อินเวนทอรีและไอเทม ตารางการาจ ระบบ target Pulse Phone โมเดล อู่ติดตั้ง และค่าตั้งที่เปลี่ยนในเกม ทุกบรรทัดที่ไม่ใช่ OK จะบอกว่าต้องทำอะไร docs/SETUP.md มีตัวอย่าง และ docs/TROUBLESHOOTING.md อธิบายแต่ละบรรทัด

• บรรทัดเฟรมเวิร์กระบุสิ่งที่ตรวจพบ ถ้าผิด ให้ตั้ง 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สำหรับอินเวนทอรีของคุณ แล้วรีสตาร์ท ข้อความของ ox_inventory จะหายไปเมื่อมีไอเทมครบ บน qs-, codem-, origen- และ tgiann-inventory รายการจะแสดงทุกครั้งที่เริ่มเพื่อเตือน ไม่ว่าคุณจะเพิ่มแล้วหรือยัง
• บรรทัดสีเหลือง Copy zds_....png from zerodev-sound/web/img/items into ...: รูปเหล่านั้นยังไม่อยู่ในโฟลเดอร์รูปของอินเวนทอรีคุณ บรรทัดนี้ระบุโฟลเดอร์ให้
• Pulse Phone app not registered: ...: Pulse Phone ทำงานอยู่แต่ปฏิเสธแอป ดูหัวข้อที่ 9

ในเกม (ตรวจห้าข้อ)

1. แผนที่แสดงไอคอน ZeroDev Sound ที่ Legion Square และไอคอน Car audio bay ที่ Benny's
2. ที่ร้าน พนักงานยืนอยู่ที่บูธที่จัดแสดงลำโพง target ที่พนักงาน (หรือกด E ถ้าไม่มี resource target) แล้วซื้อ Roam Portable Speaker
3. ใช้จากอินเวนทอรี ลำโพงจะออกมาอยู่ในมือคุณ กด 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 = { ... }) แล้วใช้ชื่อใหม่ในอินเวนทอรีของคุณ และเปลี่ยนชื่อรูปภาพให้ตรงกัน

6. การควบคุม

ในรีโมต: Music (ไลบรารีของเซิร์ฟเวอร์คุณ), Queue (เพลงถัดไป เพลย์ลิสต์ที่บันทึกไว้), Speakers (การเปิดปิดและระดับเสียงของลำโพงแต่ละตัว การเชื่อมต่อ การเก็บ) และ Tune (โหมดเสียงหกแบบ อีควอไลเซอร์สามแบนด์ ใครเป็นคนเลือกเพลง เวลาเปิดทำการ และ "Real distance" สำหรับชุดคอนเสิร์ต) ใครเป็นคนเลือกเพลง: Only me; Party ที่ทุกคนใกล้ ๆ ขอเพลงได้และเจ้าของเป็นผู้ อนุมัติ; หรือ Anyone ที่คนใกล้ ๆ เล่น หยุดชั่วคราว ข้าม ต่อคิว และเลื่อนเพลงได้ Opening hours จะเล่นหนึ่งในเพลย์ลิสต์ของเจ้าของเองระหว่างสองช่วงเวลา สำหรับร้านค้าหรือคลับ

ไมค์ (ต้องใช้ pma-voice) ระหว่างที่คุณถือไมค์ ทุกคนที่อยู่ใกล้ลำโพงตัวใดก็ได้ของระบบนั้นจะได้ยินเสียงคุณผ่านลำโพงเป็นเสียงแบบ PA ดังเท่ากับที่ลำโพงนั้นเปิดเพลง และไปได้ไกลเท่ากัน ถ้าเดินห่างจากมิกเซอร์หรือขาตั้งไมค์ 4 m ตัดการเชื่อมต่อ หรือวางไมค์คืน เสียงของคุณจะกลับเป็นปกติ เฉพาะเจ้าของระบบ (และแอดมิน สำหรับรถ) เท่านั้นที่ร้องผ่านระบบได้ ให้ ace zds.mic กับผู้เล่นคนอื่นเพื่อให้ใช้ได้กับทุกระบบ เสียงของคุณจะไม่ได้ดังออกมาจากตำแหน่งของลำโพงแต่ละตัว เพราะ voice chat วางเสียงไว้ตรงนั้นไม่ได้ คนที่อยู่ใกล้ลำโพงจึงได้ยินคุณที่ระดับความดังของลำโพงนั้นแทน การตั้งค่า: Config.Mic

7. เครื่องเสียงรถยนต์

ผู้เล่นประกอบอย่างไร

1. ขับเข้าอู่ติดตั้งเครื่องเสียงรถยนต์ (Benny's เป็นค่าเริ่มต้น) แล้วกด E ในฐานะคนขับ
2. เริ่มจากชุดสำเร็จ (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) หรือเลือกชิ้นส่วนเอง: ซับวูฟเฟอร์ (8" ถึง 18") ตู้ แอมป์ ลำโพงประตู ทวีตเตอร์ พอด พื้นหลอก แผงตกแต่ง อะคริลิก คาปาซิเตอร์ แบตเตอรี่ลูกที่สอง ไฟ LED และวิทยุติดรถ
3. ลากแต่ละชิ้นส่วนไปวางในรถ ซับจะลงไปในช่องของตู้ แต่ละชิ้นเลือกฟินิชได้ (แปดสี) ส่วนซับและลำโพงเลือกหน้ากากและวงแหวนไฟได้ Mirror คัดลอกชิ้นส่วนไปอีกฝั่ง Fine position ขยับทีละนิด มุมกล้องห้าแบบ: Boot, Cabin, Side, Front, Top ขนาด: ซับมีขนาด 8", 10", 12", 15" และ 18" (ซับทุกดอกในตู้เดียวกันมีขนาดเดียวกัน และตู้ถูกสร้างรอบซับ ใหญ่หรือเล็กกว่าที่ออกแบบไว้ได้สูงสุด 30%) ลำโพงประตูขนาด 5.25", 6.5" และ 6x9" ชิ้นส่วนอื่นทั้งหมดตั้งแต่ 80% ถึง 130% ทีละ 5% (วิทยุติดรถเป็นขนาดมาตรฐาน) ตู้และแผงที่ใหญ่ขึ้นราคาสูงขึ้น ส่วนชิ้นที่ทำให้เล็กลงไม่เสียเงินเพิ่ม ดอกที่ใหญ่กว่าขยับได้ไกลกว่า และลำโพงประตูที่ใหญ่กว่าลงได้ต่ำกว่า
4. กด Test system เพื่อฟังชุดที่ประกอบเล่นผ่านรถก่อนจ่ายเงิน จะเล่นเพลงแรกใน Config.Library (เพลงเดโมที่มากับสคริปต์ เว้นแต่คุณจะเปลี่ยน)
5. กด Install จ่ายเฉพาะชิ้นส่วนที่ใหม่สำหรับรถคันนั้น ชิ้นส่วนที่เก็บไว้จากการติดตั้งครั้งก่อนไม่ต้องจ่ายซ้ำ

การติดตั้งถูกบันทึกผูกกับป้ายทะเบียนและกลับมาทุกครั้งที่รถกลับมา: จากการาจ ที่ยึดรถ หรือการเกิดใหม่ ไม่ต้องแก้อะไรในสคริปต์การาจของคุณ

ผู้เล่นได้ยินอะไร

• รถทุกคันมีเสียงติดรถจากโรงงานตามคลาสและรุ่นอยู่แล้ว: ระบบ 4 ลำโพง ระบบพรีเมียม 10 ลำโพง หรือระบบระดับอ้างอิง 13 ลำโพง ลำโพงที่แฟริ่งสำหรับมอเตอร์ไซค์ ส่วนจักรยาน อากาศยาน และรถไฟไม่มี ลำโพงที่ติดตั้งจะแทนที่ลำโพงเดิมที่อยู่ใกล้ที่สุด ส่วนซับจะเพิ่มเข้าไป
• นอกรถ ส่วนใหญ่จะได้ยินแค่เบสที่ทะลุตัวถังออกมา ประตูที่เปิด หน้าต่างที่เปิด และท้ายรถที่เปิด แต่ละอย่างปล่อยเสียงออกมามากขึ้นไปทางฝั่งที่มันหันไป
• รถที่มีซับจะเด้งเบาๆ บนสปริงตามเบสขณะจอดหรือคลานช้าๆ (ไม่เด้งขณะขับ) และทุกคนในรถรู้สึกถึงแรงกระแทก
• เครื่องเสียง (K) มีระดับเสียง ระดับซับ เฟดเดอร์ และบาลานซ์
• ซับที่ถูกอัดเกินกว่าที่แอมป์และสเปกรองรับไปมาก ใกล้เสียงเต็ม เป็นเวลาสักพัก อาจพังได้ ทุกคนใกล้รถจะเห็นควันบางๆ จากซับนั้นและได้ยินเสียงป๊อกทึบ ซับที่พังจะหยุดขยับ เบสจะลดลง และดอกจะไหม้ดำอยู่อย่างนั้นจนกว่าจะเปลี่ยนที่อู่ (ซับใหม่ต้องจ่ายเงิน การลบรอยไม่ใช่การซ่อมฟรี) สตาฟแสดงให้ดูได้: /soundblow ในรถ หรือ soundblow <plate> ในคอนโซลเซิร์ฟเวอร์

รถคันไหนประกอบได้ (Config.Install.vehicles)

• 'owned' (ค่าเริ่มต้น): เฉพาะรถในตารางรถของผู้เล่นในเฟรมเวิร์กของคุณ (owned_vehicles บน ESX, player_vehicles บน QBCore และ Qbox)
• 'any': รวมรถที่ไม่มีเจ้าของด้วย (รถ NPC รถที่ spawn รถเช่า)
• ไม่ว่าแบบไหน รถที่ผู้เล่นคนอื่นเป็นเจ้าของยังเป็นของเขา: เฉพาะเจ้าของ ช่างที่เข้าเวรจาก Config.Install.jobs หรือแอดมินเท่านั้นที่เปลี่ยนได้ บนเซิร์ฟเวอร์ standalone รถทุกคันนับว่ามีเจ้าของ

การาจ ป้ายทะเบียน และที่ยึดรถ

• ป้ายทะเบียนถูกเทียบแบบตัดช่องว่างและเป็นตัวพิมพ์ใหญ่ ดังนั้นการาจที่เติมช่องว่างหรือเปลี่ยนตัวพิมพ์ของป้ายก็ยังตรงกัน
• รถที่ใช้ป้ายปลอมหรือป้ายที่เปลี่ยนไปจะหาการติดตั้งไม่เจอจนกว่าจะใช้ป้ายที่บันทึกไว้อีกครั้ง
• รถที่มีอยู่แค่บนหน้าจอของผู้เล่นคนเดียว (พรีวิวในการาจ รถโชว์รูมบางคัน) ไม่มีวันได้รับการติดตั้ง: สำหรับคนอื่นแล้วมันไม่ใช่รถจริง

สคริปต์เสียงหรือเครื่องเสียงอื่นๆ

ZeroDev Sound เป็น resource ของตัวเอง มีคำสั่งของตัวเอง (/sound, /caraudio, ...) events และ state bag ของยานพาหนะของตัวเอง จึงไม่แทนที่หรือเปลี่ยนสคริปต์อื่น (ขณะเล่นในรถ มันแค่ปิดวิทยุรถของ 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 ทำงานบนเซิร์ฟเวอร์ (ชื่อ resource phone เอดิชันใดก็ได้):

• โทรศัพท์ทุกเครื่องจะได้แอป Sound บน Home Screen เป็นรีโมตเดียวกับ /sound: เชื่อมต่อลำโพงหรือรถ เลือกเพลง ควบคุมทั้งกลุ่ม ผู้เล่นลบออกได้และติดตั้งกลับจาก App Hub ได้
• เพลงที่กำลังเล่นบนลำโพงหรือรถที่เชื่อมต่อ พร้อมเวลาที่เหลือ จะแสดงบน Island และ Lock Screen แตะเพื่อเปิดแอป 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 ต้อง start หลังเฟรมเวิร์กใน server.cfg
• codem-inventory บน QBCore: ทำขั้นตอนของ codem-inventory เองที่ชี้ QBCore.Functions.UseItem ไปที่มันให้เสร็จ
• ไม่มีอินเวนทอรี: ลำโพงไม่ใช่ไอเทม ผู้เล่นเปิด /sound แล้วกด Set up ใต้ Your speakers

รูปไอเทมหายไป

• ox_inventory: ไม่ต้องคัดลอกอะไร path ของรูปชี้ไปที่ zerodev-sound ถ้ารูปว่าง ให้ตรวจบรรทัด image = 'nui://zerodev-sound/...' ของรายการและชื่อโฟลเดอร์
• อินเวนทอรีอื่น: อ่านบรรทัด Copy ... into ... ในคอนโซล: มันระบุรูปที่ขาดและโฟลเดอร์ที่ต้องใส่ คัดลอกจาก zerodev-sound/web/img/items/ แล้วรีสตาร์ทอินเวนทอรี

ผู้เล่นเล่นลิงก์ไม่ได้

เป็นการออกแบบไว้แบบนั้น: ผู้เล่นเลือกได้จากไลบรารีของคุณเท่านั้น ให้เพิ่มเพลงลงใน 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 ให้ target ที่พนักงาน ถ้าไม่มี ให้ยืนที่พนักงาน: E Browse speakers

ลำโพงแสดงเป็นลำโพงธรรมดาของ GTA หรือไม่แสดงเลย

โฟลเดอร์ stream/ หายไปหรือถูกเปลี่ยนชื่อ หรือผู้เล่นเข้ามาก่อน resource จะ start รีสตาร์ทเซิร์ฟเวอร์แล้วเชื่อมต่อใหม่

ข้อความของเครื่องเสียงรถยนต์และความหมาย

ตำรวจไม่เห็นตัวเลือกของตัวเอง

เพิ่มชื่ออาชีพตำรวจของคุณใน Config.Police.jobs ผู้เล่นต้องเข้าเวรอยู่

13. การอัปเดต

มาจาก 1.x ไป 2.0: อ่าน UPGRADING.md ระหว่างเวอร์ชัน 2.x:

1. สำรองโฟลเดอร์ config/, locales/ ถ้าคุณแปลไว้ และเพลงที่คุณเพิ่มไว้ใน web/library/
2. หยุดเซิร์ฟเวอร์ แทนที่โฟลเดอร์ zerodev-sound ด้วยตัวใหม่ (ใช้ชื่อเดิม)
3. ใส่ไฟล์ config/ ของคุณกลับเข้าไป ถ้าบันทึกการอัปเดตพูดถึงค่าตั้งใหม่ ให้คัดลอกบรรทัดเหล่านั้นจากไฟล์ใหม่ไปใส่ในไฟล์ของคุณ
4. Start เซิร์ฟเวอร์แล้วอ่านคอนโซล ไอเทมใหม่ (ถ้ามี) จะแสดงให้สำหรับอินเวนทอรีของคุณ

ลำโพงที่วางไว้ การติดตั้งในรถ และเพลย์ลิสต์เก็บอยู่ในฐานข้อมูล (zds_speakers, zds_car_builds, zds_playlists, zds_stash) และไม่ถูกแตะต้องโดยการอัปเดต

การย้อนกลับ: เก็บโฟลเดอร์ zerodev-sound เดิมไว้นอก resources จนกว่าเวอร์ชันใหม่จะทำงานได้ดี และสำรองฐานข้อมูลก่อนอัปเดต หากต้องการย้อนกลับ ให้หยุดเซิร์ฟเวอร์ นำโฟลเดอร์เดิมและ config/ ของคุณกลับมา แล้วเริ่มเซิร์ฟเวอร์ การย้อนจาก 3.0 กลับไป 2.x บนฐานข้อมูลเดียวกันยังไม่ได้ทดสอบ หากมีอะไรผิดปกติให้กู้คืนข้อมูลสำรองของฐานข้อมูล