Pulse Phone dokümantasyonu
Kurulum ayrıntıları
1. Hızlı kurulum
Bir şey kopyalamadan önce
Aşağıdaki gereksinimleri karşılayan, OneSync'i açık ve oyun build'i 2699 veya daha yeni olan bir sunucu artifact'i kullanın. Normal bir roleplay sunucusu için önce framework'ünüz, envanteriniz, oxmysql, ses resource'unuz ve screenshot-basic çalışır durumda olsun. Standalone, framework olmadan da çalışır; orada envanter item'ları isteğe bağlıdır.
Satın alımı talep ettikten sonra resource'u Cfx.re hesabınızdan indirin. Asset'in sahibi olan hesaba ait sunucu anahtarını kullanın. Cfx.re bir hak (entitlement) hatası bildirirse hesap/anahtar ilişkisini düzeltin; telefon ayarlarını değiştirmek bu hakkı veremez.
Adım 1 — Resource'u sunucunuza koyun
Paketi çıkarın ve phone resource klasörünü, yani fxmanifest.lua dosyasını içeren klasörü, sunucunuzun resources dizinine kopyalayın. Adını değiştirmeyin ve onun yerine dıştaki ZIP/paket klasörünü koymayın.
Hosting'deki bir sunucuda Binary modunda yükleyin ya da zip'i yükleyip orada çıkarın (neden). Hızlı başlangıç (2. adım) bu build için her klasörün dosya sayısını ve boyutunu listeler; açılış kontrolü eksik veya yanlış boyuttaki her dosyanın adını verir.
İki telefon aynı tuş ve item için çakışmasın diye Pulse'u test etmeden önce önceki telefon resource'unuzu durdurun. Verilerini daha sonra içe aktarmayı planlıyorsanız yedekleyin.
Adım 2 — Envanter item'larınızı ekleyin
Mevcut envanterinizi seçin; onu değiştirmeniz gerekmez.
| Envanteriniz | Gereken işlem |
|---|---|
| ox_inventory | Verilen config/items/ox_inventory.lua dosyasını açın. Tanımlarını ox_inventory/data/items.lua içine, mevcut tablonun içine birleştirin. Envanterin tüm dosyasını değiştirmeyin. ox_inventory'nin kendi phone tanımını koruyun: kullanıldığında Pulse Phone'u açar ve açılış kontrolünün Phone item satırı bunu doğrular. Yalnızca o satır başka bir scripti açtığını söylüyorsa yazdırılan tanımla değiştirin. Resimleri config/items/images/ klasöründen ox_inventory/web/images/ klasörüne kopyalayın. Düzenledikten sonra sunucuyu yeniden başlatın. |
| QBCore ile qb-inventory | Eksik item tanımları açılışta otomatik olarak kaydedilir. config/items/images/ içeriğini qb-inventory/html/images/ içine kopyalayın. Envanteriniz kalıcı shared tanımlar gerektiriyorsa, verilen config/items/qb-core.lua dosyası qb-core/shared/items.lua içine birleştirilmeye hazırdır. |
| ESX varsayılan envanteri | Eksik item'lar otomatik olarak eklenir. Konsol yeniden başlatma isterse ESX'in onları okuması için bir kez yeniden başlatın. Veritabanı hesabınız onları ekleyemiyorsa config/items/esx.sql kullanın. |
| qs-inventory veya desteklenen başka bir envanter | Item'lar ve envanterler sayfasında envanterinize ait kısa satırı izleyin. Onun kendi item listesini ve resim klasörünü kullanın. |
| Envanteri olmayan standalone | Envanter tanımı gerekmez. Item gereksinimlerini kapalı bırakın. |
Açılış kontrolü eksik tanımları belirler ve yalnızca hâlâ ihtiyacınız olan tanımları yazdırır. Item tanımlarını açılışta yükleyen bir envanter, örneğin ox_inventory, yukarıdaki tanımlara ihtiyaç duyar; Pulse başka bir resource'un dosyalarının üzerine yazmaz.
Adım 3 — Ana yapılandırmayı kontrol edin
config/config.lua dosyasını açın. Varsayılanlar mevcut kurulumunuzu algılar:
Config.Framework = 'auto'inventory = 'auto' değerini mevcut Config.Providers tablosunda bırakın. Birden fazla envanter resource'u çalıştırıyorsanız bu değeri kullanmak istediğiniz envantere ayarlayın, örneğin 'ox_inventory'. Dosyanın sonuna ikinci bir Config.Providers veya Config.Item tablosu eklemeyin.
Mevcut Config.Item tablosunda telefonların nasıl çalışacağını seçin:
| Ayar | Ne yapar |
|---|---|
required = false, unique = false |
Her karakterin item taşımadan bir telefonu olur. İlk testiniz için kullanışlıdır. |
required = true, unique = false |
Karakterin kendi telefonunu açması için bir phone item'ı gerekir. O item'ı başkasına vermek verilerini aktarmaz. |
unique = true |
Her telefon item'ının kendi numarası ve verileri vardır. Item'ı vermek o telefonu aktarır. ox_inventory, qb-inventory, qs-inventory, core_inventory veya codem-inventory gerektirir. |
name = 'phone' |
Envanter item adı. Verilen item tanımını da değiştirmedikçe bunu koruyun. |
Benzersiz telefonlar seçili envanter köprüsünü takip eder. Config.Item.inventory = 'auto' olarak bırakın; bu eski geçersiz kılma yalnızca mevcut ileri düzey kurulumlar içindir. Config.Providers.inventory açıkça ayarlandığında önceliklidir.
Mevcut bir sunucuda Config.IdentityScope ayarını değiştirmeyin. Varsayılan olan 'character', farklı karakterlerin telefonlarını ayrı tutar.
İsteğe bağlı: envanter telefonları ve ücretli hizmet
Her telefon için ayrı bir telefon item'ı zorunlu kılmak için, envanter tanımlarını ekledikten sonra required = true ve unique = true değerlerini mevcut Config.Item tablosunda ayarlayın (config/config.lua içinde). Yukarıda listelenen benzersiz telefon envanterlerinden birini kullanın.
Telefon hizmeti satmak için aynı dosyada Config.Carrier.enabled = true ayarlayın. Bu, oyuncuların tarifelerini satın aldığı Carrier uygulamasını açar. Yeni telefonların normal aramalar, mesajlar ve mobil veri uygulamaları için önce bir tarifeye ihtiyacı vardır. App Hub, hizmet mağazası değil, oyuncuların uygulama yüklediği yerdir. Kapsama bölgeleri de istiyorsanız Config.Coverage.enabled = true ayarlayın. Kapsama ve ücretli tarifeler ayrı seçeneklerdir; istemediğiniz özelliği kapalı bırakın.
Yinelenen tablolar eklemek yerine mevcut ayarları düzenleyin. Kaydettikten sonra sunucuyu yeniden başlatın. Bir oyun içi ayar daha önce kaydedildiyse, dosyadaki değerinizin geçerli olması için o ayarı Settings → Server içinde sıfırlayın.
Adım 4 — Bağımlılıkları Pulse'tan önce başlatın
Mevcut veritabanı bağlantınızı ve framework ayarlarınızı koruyun. Yalnızca eksik satırları ekleyin; hiçbir bağımlılığın ikinci bir kopyasını başlatmayın.
Sunucunuzda zaten kurulu olan resource'larla bu sırayı kullanın:
- Veritabanı resource'u ve mevcut bağlantı ayarları.
- Framework ve gerektirdiği kütüphaneler, kimlik ve karakter resource'ları.
- Envanter, o envanterin framework'ünüze yönelik yapılandırmasıyla.
- Desteklenen bir ses resource'u ve
screenshot-basic. ensure phone.
Yalnızca Pulse için ESX, QBCore veya farklı bir envanter kurmayın. Kendine özgü başlatma sırası örneği için mevcut kurulumunuzu Framework'ünüz sayfasında seçin. Qbox, başka bir resource onun QBCore uyumlu export'larını kullansa bile Qbox olarak algılanır.
Pulse yönetici erişimi için add_ace group.admin phone.admin allow ekleyin. Bu iznin geçerli olması için yönetici hesabınız zaten group.admin grubunda olmalıdır.
Adım 5 — İlk açılış kontrolünü okuyun
Sunucuyu yeniden başlatın. Pulse bir açılış raporu yazdırır ve SQL bağlantısı hazır olduğunda veritabanı tablolarını otomatik olarak oluşturur.
- FIX / FAIL: zorunlu bir parça çalışamıyor. Oyuncuların kullanmasına izin vermeden önce düzeltme satırını izleyin.
- NOTE / WARN: hangi özelliğin etkilendiğini okuyun; bazı uyarılar yapılandırmadığınız isteğe bağlı özellikleri anlatır.
- Kontrolü tekrarlamak için sunucu konsolunda
phone:healthçalıştırın. - Seçilen framework/envanter/sağlayıcıları görmek için
phone:diagçalıştırın. - Yönetici olarak girin, F8'i açın ve mevcut rehberli kurulum için
phone:setupçalıştırın.
Oyun içi yönetici kurulumunda kaydedilen ayarlar, dosyadaki karşılık gelen ayarları geçersiz kılar. Bir dosya değişikliği yok sayılıyor gibi görünüyorsa, daha fazla dosya değiştirmeden önce Settings → Server'ı kontrol edin ve o kaydedilmiş geçersiz kılmayı sıfırlayın.
Adım 6 — Oyuncu olarak test edin
- Bir karakter yükleyin, F1'e basın ve telefon kurulumunu tamamlayın. Item gereksinimleri açıksa önce mağazadan bir telefon satın alın veya karaktere yapılandırılmış telefon item'ını verin.
- Mühürlü bir kutu satın aldıysanız, kutuyu açmak için envanterden kutuyu kullanın, ardından kurulumu bitirin. Telefon açık olarak gelir;
Config.Device.arrivesOn = falseile önce End veya O tuşunu basılı tutun. - Messages, Contacts ve Phone'u açın. Ana ekrana dönün, uygulama değiştiriciyi açın ve her uygulamayı sırayla kapatın.
- Bir fotoğraf ve kısa bir video çekin. İkisini de Photos'ta açın, telefonu kapatıp yeniden açın ve hâlâ orada olduklarını doğrulayın.
- Yeniden bağlanın ve aynı karakterin hâlâ aynı telefona sahip olduğunu kontrol edin. Kurulu ses resource'unuzu kullanarak ikinci bir oyuncuyla aramaları test edin.
Neyi nerede değiştirirsiniz
| Değiştirmek istediğiniz şey | Dosya veya yer |
|---|---|
| Framework, envanter sağlayıcısı, telefon item'ı, mağaza, modeller, tuş ataması | config/config.lua |
| Ses sağlayıcısı | config/config.lua |
| Uygulama ve hizmet/meslek ayarları | config/apps.lua |
| Envanter tanımları ve resimleri | config/items/ |
| Veritabanı bağlantısı, resource başlatma sırası, medya hosting kimlik bilgileri | server.cfg (özel kimlik bilgilerini sunucu tarafında tutun) |
| Geliştirici entegrasyonları | İleri düzey entegrasyonlar, isteğe bağlı Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) ve mevcut bridge/ dosyaları; normal kurulum bunları düzenlemeyi gerektirmez |
| Yerleşik depolamayı kullanan oyuncu fotoğrafları/videoları | media/; güncellerken bu klasörü koruyun |
Aşağıdaki bölümler ayrıntılı referansı içerir. İlk kurulumu bitirmek için her özellik ayarını okumanız gerekmez.