ZeroDev Sound: kurulum rehberi

Bu resource, üçüncü taraf ses veya müzik entegrasyonu içermez ve sağlamaz. Müzik yalnızca sunucu sahibinin resource'a eklediği ses dosyalarından ve GTA'nın yerleşik radyosundan çalar. Oyuncular bağlantı giremez. Yalnızca sahibi olduğunuz veya kullanım ve dağıtım hakkına sahip olduğunuz sesleri ekleyin; içeriği izinsiz yayınlamak Cfx.re Creator Platform License Agreement'ı ve yasayı ihlal edebilir.

Oyuncuların satın aldığı, taşıdığı, yere koyduğu ve birbirine bağladığı hoparlörler ve kendi araçlarına kurdukları araç ses sistemi. Bu, tam referanstır. Kısa sürüm için docs/SETUP.md (5 adım); sorunlar için docs/TROUBLESHOOTING.md; 1.x'ten geliyorsanız UPGRADING.md.

İçindekiler 1. Gereksinimler 2. Kurulum 3. Envanteriniz için item'lar 4. İlk açılış: ne görmelisiniz 5. En çok değiştirilen ayarlar 6. Kontroller 7. Araç ses sistemi 8. Müzik kaynakları 9. Pulse Phone 10. Polis, komşular ve yöneticiler 11. Diller 12. Sorun giderme 13. Güncelleme

1. Gereksinimler

Başka bir şey yok: ox_lib yok, API anahtarı yok, Google hesabı yok.

Linux sunucular: Latest değil, Recommended sunucu artifact'ini kullanın. FiveM sunucu indirme sayfasında (docs.fivem.net/docs/server-download/) Linux'u ve Recommended güncelleme dalını seçin. En son Linux artifact'indeki bir sunucu yüklenirken çöktü (FXServer bir /proc/self/maps dökümü yazdırdı) ve önerilen artifact'e geçmek sorunu çözdü. Elimizdeki tek Linux raporu bu; ZeroDev Sound'u henüz kendimiz bir Linux sunucusunda çalıştırmadık.

Standalone bir sunucuda (framework yok) her şey ücretsizdir: mağaza ve araç parçaları hiçbir ücret almaz.

2. Kurulum

Adım 1. Klasörü bırakın. zerodev-sound klasörünü resources klasörünüze koyun (herhangi bir alt klasör olur, örneğin resources/[zerodev]/zerodev-sound). Klasör adını zerodev-sound olarak koruyun: ox_inventory item tanımları onu bu adla çağırır.

Adım 2. server.cfg dosyasına ekleyin, veritabanı, framework ve envanterinizden sonra:

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

Adım 3. Yöneticilerinize yönetici iznini verin (hoparlör sınırı yok, /soundadmin listesi, uzaktan durdurma ve kaldırma):

add_ace group.admin zerodev.sound.admin allow

Adım 4. Item'ları ayarlayın, envanterinize göre: 3. bölüm. ESX envanterinde ve QBCore'da bu sizin yerinize yapılır.

Adım 5. Sunucuyu yeniden başlatın (her oyuncunun modelleri yüklemesi için yalnızca resource'u değil, sunucuyu tamamen) ve konsolu kontrol edin: 4. bölüm.

3. Envanteriniz için item'lar

Toplam 12 item var: on hoparlör, mikrofon standı ve tamir kiti.

Resimler zerodev-sound/web/img/items/ içinde. Asla tahmin etmeniz gerekmez: bir şey eksik olduğunda sunucu konsolu envanteriniz için tam tanımları yazdırır ve henüz yerinde olmayan her resmin adını verir.

Hangi envanteri kullanıyorsunuz?

Item'ları scriptin eklemesine izin vermek yerine qb-core'a elle eklemek için QBCore bloğunu qb-core/shared/items.lua içine yapıştırın.

Bu API'lerden birini taklit eden başka bir envanter: Config.Inventory değerini o envantere ayarlayın (5. bölüme bakın). Kendi geliştirdiğiniz bir envanter, okunabilir olan server/bridge.lua içinde bağlanabilir: oradaki her envanter üç küçük fonksiyondan oluşur (sayma, ekleme, çıkarma).

ox_inventory bloğu

return { ... } tablosunun içine yapıştırın (ox_inventory/data/items.lua dosyasında):

    ['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 bloğu

qb-, ps-, lj- ve qs-inventory'nin okuduğu QBCore item biçimi:

    ['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 içinde bir etiketi, fiyatı veya ağırlığı değiştirdiyseniz, tanımları bunun yerine kendi konsolunuzdan kopyalayın: konsol onları sizin ayarlarınızdan yazdırır.

4. İlk açılış: ne görmelisiniz

Sunucu konsolunda

ZeroDev Sound tek bir kontrol kutusu yazdırır (yeniden yazdırmak için sunucu konsoluna soundcheck yazın): veritabanı ve şema, framework, para, envanter ve item'lar, garaj tablosu, target, Pulse Phone, modeller, montaj bölümleri ve oyun içinde değiştirilen ayarlar. OK olmayan her satır ne yapılacağını söyler; docs/SETUP.md bir örnek gösterir ve docs/TROUBLESHOOTING.md her satırı açıklar.

• Framework satırı neyin bulunduğunu söyler. Yanlışsa Config.Framework veya Config.Inventory ayarını yapın (config/config.lua içinde).
• Sarı bir Add these to ox_inventory/data/items.lua ... satırı (veya ... if these items are not in ... yet, add them) ve ardından item tanımları: envanteriniz için 3. bölümü uygulayın, ardından yeniden başlatın. ox_inventory mesajı item'lar eklendiğinde durur. qs-, codem-, origen- ve tgiann-inventory'de tanımlar, ekleyip eklemediğinizden bağımsız olarak, hatırlatma amacıyla her açılışta yazdırılır.
• Sarı bir Copy zds_....png from zerodev-sound/web/img/items into ... satırı: bu resimler henüz envanterinizin resim klasöründe değil. Satır klasörün adını verir.
• Pulse Phone app not registered: ...: Pulse Phone çalışıyor ama uygulamayı reddetti. 9. bölüme bakın.

Oyun içinde (beş kontrol)

1. Haritada Legion Square'de bir ZeroDev Sound blip'i ve Benny's'te bir Car audio bay blip'i görünür.
2. Mağazada bir satış görevlisi, hoparlörlerin sergilendiği bir standın başında durur. Satış görevlisini target ile seçin (veya target resource'u yoksa E'ye basın) ve bir Roam Portable Speaker satın alın.
3. Onu envanterinizden kullanın. Elinize gelir. E'ye basın, Library'yi açın ve Night Drive'ı çalın (scriptle gelen bir demo parça). Çevrenizdeki insanlar onu duyar.
4. Bir araca binin. İlk birkaç seferde ekranın köşesi, araç teybini hangi tuşun açtığını söyler (varsayılan olarak K).
5. Araç ses sistemi montaj bölümüne sürücü olarak girin ve E'ye basın. Montaj ekranı aracınızda açılır.

5. En çok değiştirilen ayarlar

Oyun içinde: /soundadmin > Settings, sık kullanılan ayarları herkes için canlı olarak değiştirir (montaj bölümleri, kimlerin kurulum yapabileceği, hangi araçlar, fiyatlar, en yüksek ses düzeyi, sessiz saatler, sınırlar, mağaza, polis ve hasar). Bunlar veritabanında kaydedilir ve config.lua dosyasına göre önceliklidir; ta ki panelde Reset to config'e basana kadar.

Aksi belirtilmedikçe her şey config/config.lua içindedir. Ürünler, fiyatlar ve araç parçaları config/catalogue.lua içinde; her aracın fabrika sesi config/vehicles.lua içinde.

Item adları. Başka bir script zds_ item adlarından birini zaten kullanıyorsa, o ürünün anahtarını Catalogue.Speakers içinde yeniden adlandırın (örneğin zds_roam = { ... }), ardından envanterinizde yeni adı kullanın ve resmini de buna uygun şekilde yeniden adlandırın.

6. Kontroller

Kumandada: Music (sunucunuzun kütüphanesi), Queue (sıradakiler, kayıtlı çalma listeleri), Speakers (her hoparlörün gücü ve seviyesi, bağlama, toplama) ve Tune (altı ses modu, üç bantlı ekolayzer, müziği kimin seçtiği, açılış saatleri ve konser kurulumları için "Real distance"). Müziği kimin seçtiği: Only me; Party, yakındaki herkesin sahibin onaylayacağı şarkıları isteyebildiği mod; ya da Anyone, yakındaki kişilerin oynatabildiği, duraklatabildiği, atlayabildiği, sıraya ekleyebildiği ve ileri sarabildiği mod. Opening hours iki saat arasında sahibin çalma listelerinden birini kendiliğinden oynatır; mağaza veya kulüp için.

Mikrofon (pma-voice gerekir). Mikrofonu tuttuğunuz sürece o sistemin herhangi bir hoparlörünün yakınındaki herkes sesinizi o hoparlörden, anons sistemi tınısıyla, hoparlör müziği ne kadar yüksek çalıyorsa o kadar yüksek ve sesi ne kadar uzağa gidiyorsa o kadar uzakta duyar. Mikserden veya mikrofon standından 4 m uzaklaşın, bağlantıyı kesin ya da mikrofonu yerine koyun; sesiniz yeniden normale döner. Sistem üzerinden yalnızca sistemin sahibi (araçta adminler de) şarkı söyleyebilir; diğer oyuncuların her sistemi kullanabilmesi için onlara zds.mic ace yetkisini verin. Sesiniz her hoparlörün bulunduğu noktadan gelmez: sesli sohbet bir sesi oraya yerleştiremez, bu yüzden hoparlörün yakınındakiler sizi o hoparlörün ses seviyesinde duyar. Ayarlar: Config.Mic.

7. Araç ses sistemi

Oyuncular nasıl kurulum yapar

1. Araç ses sistemi montaj bölümüne (varsayılan olarak Benny's) girin ve sürücü olarak E'ye basın.
2. Hazır bir kitle başlayın (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) ya da parça seçin: subwoofer'lar (8" ile 18" arası), kutular, amfiler, kapı hoparlörleri, tweeter'lar, pod'lar, sahte tabanlar, paneller, pleksi, kapasitör, ikinci akü, LED şerit ve teyp.
3. Her parçayı araçta yerine sürükleyin. Subwoofer'lar kutularının yuvalarına oturur. Her parça bir kaplama alır (sekiz renk); subwoofer'lar ve hoparlörler ayrıca bir ızgara ve ışık halkası alır. Mirror bir parçayı diğer tarafa kopyalar; Fine position onu küçük adımlarla hareket ettirir. Beş kamera görünümü: Boot, Cabin, Side, Front, Top. Size: subwoofer'lar 8", 10", 12", 15" ve 18" olarak gelir (bir kutudaki her subwoofer aynı boyuttadır ve kutu onların etrafında, yapıldığı boyuttan %30'a kadar büyük veya küçük olarak inşa edilir); kapı hoparlörleri 5.25", 6.5" ve 6x9"; diğer tüm parçalar %5'lik adımlarla %80 ile %130 arasında (teyp standart boyuttadır). Daha büyük kutular ve paneller daha pahalıdır; küçültülen bir parça hiçbir ücrete mal olmaz. Daha büyük sürücülerde koniler daha fazla hareket eder ve daha büyük bir kapı hoparlörü daha derine iner.
4. Ödemeden önce kurulumun araçta çaldığını duymak için Test system'e basın. Config.Library içindeki ilk şarkıyı çalar (değiştirmediyseniz scriptle gelen demo parça).
5. Install'a basın. Yalnızca araç için yeni olan parçalar ücretlendirilir; son kurulumdan kalan parçalar yeniden ücretlendirilmez.

Kurulum plakaya bağlı olarak kaydedilir ve araç ne zaman geri gelirse onunla gelir: her garajdan, otoparktan (impound) veya yeniden doğuştan. Garaj scriptinizde düzenlenecek bir şey yok.

Oyuncular ne duyar

• Her aracın sınıfına ve modeline göre zaten bir fabrika sesi vardır: 4 hoparlörlü bir sistem, premium 10 hoparlörlü veya referans 13 hoparlörlü bir sistem, motosikletlerde kaporta hoparlörleri; bisikletlerde, hava araçlarında ve trenlerde yoktur. Takılan hoparlörler kendilerine en yakın fabrika hoparlörlerinin yerini alır; subwoofer'lar ise ona eklenir.
• Aracın dışında gövdeden çoğunlukla bas geçer. Açık kapılar, açık camlar ve açık bir bagaj, her biri baktığı tarafa doğru daha fazla ses çıkarır.
• Subwoofer'ı olan bir araç, park hâlindeyken veya çok yavaş giderken basla birlikte süspansiyonu üzerinde hafifçe zıplar (sürerken asla) ve içerideki herkes kick'i hisseder.
• Teypte (K) ses düzeyi, subwoofer seviyesi, fader ve balans vardır.
• Amfilerinin ve değerlerinin izin verdiğinin çok üzerinde, tam sese yakın, bir süre zorlanan subwoofer'lar yanabilir. Aracın yakınındaki herkes o subwoofer'dan çıkan ince bir duman görür ve boğuk bir patlama duyar. Yanan bir subwoofer hareket etmeyi bırakır, bas düşer ve konisi, montaj bölümünde değiştirilene kadar yanık kalır (yeni subwoofer ücretlidir; izi silmek ücretsiz bir tamir değildir). Yetkililer bunu gösterebilir: araçta /soundblow veya sunucu konsolunda soundblow <plate>.

Hangi araçlara kurulum yapılabilir (Config.Install.vehicles)

• 'owned' (varsayılan): yalnızca framework'ünüzün sahip olunan araçlar tablosundaki araçlar (ESX'te owned_vehicles, QBCore ve Qbox'ta player_vehicles).
• 'any': kimsenin sahibi olmadığı araçlar da (NPC araçları, spawn edilen araçlar, kiralıklar).
• Her iki durumda da başka bir oyuncunun aracı onun kalır: yalnızca sahibi, Config.Install.jobs listesinden görevdeki bir mekaniker veya bir yönetici onu değiştirebilir. Standalone bir sunucuda her araç sahipli sayılır.

Garajlar, plakalar ve otoparklar (impound)

• Plakalar boşlukları kırpılarak ve büyük harfle eşleştirilir; böylece plakaları boşlukla dolduran veya harf büyüklüğünü değiştiren garajlar da eşleşir.
• Sahte veya değiştirilmiş plakalı bir araç, kayıtlı plakası geri gelene kadar kurulumunu bulamaz.
• Yalnızca bir oyuncunun ekranında var olan araçlar (garaj önizlemeleri, bazı showroom araçları) asla kurulum almaz: başka kimse için gerçek araç değildirler.

Diğer ses veya teyp scriptleri

ZeroDev Sound; kendi komutları (/sound, /caraudio, ...), event'leri ve araç state bag'leri olan ayrı bir resource'tur, bu yüzden diğer scriptlerin yerini almaz veya onları değiştirmez (bir araçta çalarken yalnızca GTA'nın kendi araç radyosunu kapatır). Aynı araçta aynı anda iki araç ses sistemi scripti çalıştırmak birlikte test edilmedi: araç başına tek teyp kullanın.

8. Müzik kaynakları

Müzik yalnızca resource'a eklediğiniz ses dosyalarından çalar. Oyuncular sizin listenizden seçer; bağlantı giremezler ve hiçbir web adresi çalınmaz. Yalnızca sahibi olduğunuz veya kullanım ve dağıtım hakkına sahip olduğunuz sesleri ekleyin.

• mp3 veya ogg dosyalarını zerodev-sound/web/library/ içine koyun ve her birini Config.Library içinde { title = '...', artist = '...', file = 'name.mp3' } biçiminde listeleyin. Tam deneyimi alırlar: 3D ses, odalar ve duvarlar, araba kabinleri, ses modları, EQ ve gerçek basla birlikte hareket eden koniler.
• Config.Sources.library = false kütüphaneyi kapatır.
• GTA'nın kendi araba radyosu, bu resource'tan hiçbir şarkı o arabada çalmadığı sürece her arabada çalışmaya devam eder.
• Açılış kutusu oyuncuların kaç şarkı seçebileceğini gösterir ve atlanan her girdi için uyarır (web/library/ içinde mp3 veya ogg olmayan bir dosya adı).
• 3.0.0'dan güncelleme: bağlantı olan kayıtlı şarkılar, son şarkılar ve çalma listesi girdileri artık gösterilmez ve çalınmaz. Kütüphane şarkıları çalışmaya devam eder.

9. Pulse Phone

Ayarlanacak bir şey yok. Pulse Phone sunucuda çalıştığında (resource adı phone, iki sürümden biri):

• Her telefonun Ana Ekranı'na bir Sound uygulaması gelir. /sound ile aynı kumandadır: bir hoparlöre veya araca bağlanın, müzik seçin, tüm grubu yönetin. Oyuncular onu kaldırabilir ve App Hub'dan geri alabilir.
• Bağlı hoparlörde veya araçta çalan şey, kalan süresiyle birlikte Island'da ve Kilit Ekranı'nda görünür. Dokunmak Sound uygulamasını açar.
• Pulse Drive (Pulse'un araç ekranı, varsayılan olarak F10) oturduğunuz aracın teybini gösterir: şarkı, sanatçı ve kapak; oynat, duraklat, önceki, sonraki ve ses düzeyiyle ve Sound uygulaması için bir Open düğmesiyle. Bunun için Pulse Phone 1.2.9 veya daha yenisi gerekir; eski sürümler bunu göstermez.

Telefonu olmayan oyuncular, uygulamanın yaptığı her şeyi yapan /sound ve K tuşunu kullanır.

Telefonun klasörünün adını değiştirdiyseniz, bu satırı onun adıyla config/config.lua dosyasına ekleyin:

Config.PulseResource = 'phone'

10. Polis, komşular ve yöneticiler

11. Diller

Script, Pulse Phone ile aynı 25 dilde gelir. Dili config/config.lua içinde ayarlayın:

Örneğin Config.Locale = 'de'. Varsayılan 'auto' değeri Pulse Phone'u izler: sunucu Pulse'un Config.Locale ayarını alır ve her oyuncu Sound'u telefonunda seçtiği dilde görür. Pulse yoksa İngilizcedir. Oyun mesajları, tuş istemleri, eşya adları ve teyp tuşunun adı locales/<code>.lua içindedir; arayüz (kumanda, araç teybi, mağaza, montaj ekranı, Pulse uygulaması) locales/<code>_ui.lua içindedir. Eksik olan her şey İngilizce gösterilir.

Bir satırı değiştirmek için o dilin dosyasında düzenleyin. Her %s, %d, %.1f, %% ve ~a~ olduğu gibi kalsın. Kendi dilinizi eklemek için locales/en.lua dosyasını locales/xx.lua olarak kopyalayın, Locales['en'] ifadesini Locales['xx'] olarak değiştirin (iki yerde de), tırnak içindeki metni çevirin ve Config.Locale = 'xx' ayarlayın. locales/ui_strings.txt, bir xx_ui.lua için her arayüz anahtarını listeler.

12. Sorun giderme

Oyuncular hoparlör item'larını kullanamıyor

• ox_inventory: tanımlar ox_inventory/data/items.lua içinde ve client satırlarıyla birlikte olmalı ve yapıştırdıktan sonra ox_inventory yeniden başlatılmalıdır. Klasörün adı hâlâ zerodev-sound olmalıdır (tanımlar zerodev-sound.useItem çağırır).
• QBCore / ESX: zerodev-sound, server.cfg içinde framework'ünüzden sonra başlamalıdır.
• QBCore'da codem-inventory: codem-inventory'nin QBCore.Functions.UseItem fonksiyonunu kendisine yönlendiren kendi adımını tamamlayın.
• Envanter yok: hoparlörler item değildir. Oyuncular /sound açar ve Set up'a basar (Your speakers altında).

Item resimleri eksik

• ox_inventory: kopyalanacak bir şey yok; resim yolu zerodev-sound'u gösterir. Resimler boşsa tanımın image = 'nui://zerodev-sound/...' satırını ve klasör adını kontrol edin.
• Diğer envanterler: Copy ... into ... konsol satırını okuyun: eksik resimleri ve gidecekleri klasörü listeler. Bunları zerodev-sound/web/img/items/ içinden kopyalayın ve envanteri yeniden başlatın.

Oyuncu bir bağlantıyı çalamaz

Bu bilerek böyle: oyuncular yalnızca sizin kütüphanenizden seçer. Şarkıyı Config.Library içine ekleyin (8. bölüm).

Hiç ses yok

• FiveM'in yerleşik tarayıcısı sesi tıklama olmadan başlatır, bu yüzden oyuncuların sese "izin vermek" için hiçbir şeye basmasına gerek yoktur. Bir oyuncu hiçbir şey duymazken diğerleri duyuyorsa, onun Windows ses karıştırıcısında FiveM'i kontrol edin.
• Hoparlörü kumandanın Speakers sekmesinde kontrol edin: kapalı ya da Broken olabilir.
• Polis onu kapatmış olabilir (Config.Police.silenceMinutes süresince) ya da sessiz saatler ses düzeyini sınırlıyor olabilir (Config.QuietHours).
• Bir oyuncu aynı anda en fazla Config.Streaming.maxAudibleSessions ayrı şarkı duyar (6), en yakındakiler önce.
• Montaj ekranındaki Test system, Config.Library boşsa veya Config.Sources.library = false ise sessizdir: kütüphanedeki ilk şarkıyı çalar.

Mağaza yerinde değil

• Config.Shop.enabled değeri true olmalıdır.
• Satış görevlisi ve stand yalnızca bir oyuncu Config.Shop.locations konumuna yaklaşık 70 m mesafedeyken ve yalnızca o oyuncunun ekranında görünür. Ayarladığınız koordinatları kontrol edin.
• ox_target veya qb-target ile satış görevlisini target ile seçin. Biri yoksa satış görevlisinin yanında durun: E Browse speakers.

Bir hoparlör sade bir GTA hoparlörü olarak görünüyor ya da hiç görünmüyor

stream/ klasörü eksik veya adı değiştirilmiş ya da oyuncu resource başlamadan önce girmiş. Sunucuyu yeniden başlatın ve yeniden bağlanın.

Araç ses sistemi mesajları ve anlamları

Polis seçeneklerini göremiyor

Polis meslek adlarınızı Config.Police.jobs listesine ekleyin. Oyuncular görevde olmalıdır.

13. Güncelleme

1.x'ten 2.0'a geçiyorsanız UPGRADING.md dosyasını okuyun. 2.x sürümleri arasında:

1. config/ klasörünüzü, çevirdiyseniz locales/ klasörünü ve web/library/ içine eklediğiniz şarkıları yedekleyin.
2. Sunucuyu durdurun. zerodev-sound klasörünü yenisiyle değiştirin (adını koruyun).
3. config/ dosyalarınızı geri koyun. Güncelleme notları yeni ayarlardan bahsediyorsa o satırları yeni dosyalardan kendi dosyalarınıza kopyalayın.
4. Sunucuyu başlatın ve konsolu okuyun. Varsa yeni item'lar envanteriniz için yazdırılır.

Yerleştirilen hoparlörler, araç kurulumları ve çalma listeleri veritabanında tutulur (zds_speakers, zds_car_builds, zds_playlists, zds_stash) ve bir güncelleme bunlara dokunmaz.

Geri dönme: yeni sürüm sorunsuz çalışana kadar önceki zerodev-sound klasörünü resources dışında tutun ve güncellemeden önce veritabanını yedekleyin. Geri dönmek için sunucuyu durdurun, önceki klasörü ve config/ klasörünüzü geri koyun ve sunucuyu başlatın. Aynı veritabanında 3.0'dan 2.x'e geri dönüş test edilmedi; bir şey yanlış görünürse veritabanı yedeğini geri yükleyin.