PhoneHub + Pulse Phone — kurulum rehberi

Bu sürüm Pulse Phone'u, PhoneHub binasını, özel PhoneHub OS'u, 3D telefon kiosk'unu, tamir tezgâhını ve personel stok/teslimat sistemini bir araya getirir. Yalnızca telefon olan sürümden ayrı bir üründür. Telefonu ve mağaza resource'unu birlikte kurun. İki phone kopyası veya PhoneHub haritasının iki sürümünü çalıştırmayın.

1. Kurulumdan önce

• Mevcut telefon resource'unuzu, harita resource'unuzu, yapılandırmanızı ve veritabanınızı yedekleyin.
• OneSync ve GTA oyun build'i 2699 veya daha yenisini kullanın.
• Önce veritabanınızı, framework'ünüzü, envanterinizi, ses resource'unuzu ve screenshot-basic'i başlatın.
• Resource adlarını tam olarak phone ve zerodev_phonehub_mlo olarak koruyun.
• Önceki PhoneHub resource'larını aktif resources dizininden kaldırın ve yinelenen ensure satırlarını silin. Yedekleri o dizinin dışında saklayın.
• Aynı Portola Drive binasının yerini alan başka bir haritayı devre dışı tutun.
• Harita dosyalarını değiştirmeden önce FiveM'i tamamen kapatın ve sunucuyu durdurun. Sunucuyu başlatın, ardından FiveM'i yeniden açın. Bu stream edilen MLO'yu değiştirmeden veya yeniden başlatmadan önce client'ların bağlantısını kesin. Bağlı bir client, binadan uzaktayken bile haritayı tutabilir; çalışırken yeniden başlatmak o client'ı çökertebilir.

Bu paket sunucu lisans anahtarı, framework, envanter veya ücretli üçüncü taraf scriptler içermez. Keymaster işleminden sonra sunucu anahtarı, bu yeni birleşik asset'e hakkı olan hesaba ait olmalıdır. Eski, yalnızca telefon olan sürüme sahip olmak bu yeni sürümü vermez.

2. Resource'ları kopyalayın

Bu indirmedeki phone ve zerodev_phonehub_mlo klasörlerini sunucunuzun resources dizinine kopyalayın. Bunları herhangi bir kategori klasörüne koyabilirsiniz; klasör adlarını tam olarak koruyun.

screenshot-basic. Kamera, screenshot-basic'in phone öncesinde başlatılmasını gerektirir; standart resource çalışır. İndirme ayrıca daha hafif bir kopya içerir (oyun görüntüsünü yalnızca fotoğraf çekilirken çizer; adı, export'ları ve event'leri aynıdır). Ona geçmek isteğe bağlıdır: eski klasörünüzü yedek olarak resources dışında tutun, ekran görüntüsü alan scriptleri test edin ve bir şey değişirse eski klasörü geri koyun. Adımlar Pulse Phone hızlı başlangıcının 6. adımında; değiştirilen dosyalar screenshot-basic/ZERODEV-CHANGES.md içinde listelenmiştir.

Bu satırları server.cfg içinde mevcut bağımlılıklarınızdan sonra ekleyin:

ensure phone
ensure zerodev_phonehub_mlo

Yeni pakete eski bir telefon motorunu veya arayüzünü kopyalamayın. Yükseltmede ihtiyacınız olan ayarları yeni yapılandırma dosyalarına taşıyın. Veritabanınızı, resource KVP depolamanızı, media ve ownermedia klasörlerinizi koruyun. Yeni phone/config/phonehub_business.lua dosyası, yalnızca telefon olan sürümde bulunmayan teslimat ayarlarını içerir.

Yapılandırılmış mağaza tezgâhı -749.541, -216.952224, 36.256562 konumunda, yönü 210. Mağaza konumu temiz entegre sürümde zaten yapılandırılmıştır. PhoneHub bu sürümdeki tek telefon mağazasıdır: yalnızca telefon olan paketin Legion Square mağazası buna dahil değildir. 1.4.4 veya daha eski bir sürümden kalan bir config.lua hâlâ Legion Square'i listeler; bu kayıt atlanır ve konsol bunu bir kez söyler. PhoneHub terminalini açmak için zemindeki kiosk'ta, bir tamir tezgâhında, servis tezgâhında veya çatıdaki kontrol noktasında PhoneHub tuşuna (varsayılan olarak E) basın ya da /phonehub kullanın. Kiosk Shop'u, tamir tezgâhı Repair'i açar. Tuş FiveM tuş atamalarından değiştirilebilir. Komut, tuşla aynı yakınlığı gerektirir; personel işlemleri yine de sunucu izni gerektirir.

3. Framework, envanter ve diğer scriptler

Config.Framework = 'auto' ve otomatik sağlayıcı ayarlarıyla başlayın (phone/config/config.lua içinde). Telefonun açılış sağlık raporu, seçtiği gerçek sağlayıcıları belirtir. Satın alım yapmadan önce bu raporu kontrol edin.

Envanter adaptörleri ox_inventory'yi, desteklenen framework envanter fonksiyonlarını ve phone/guides/integrations.md (veya telefon build'inizle gelen entegrasyon rehberi) içinde listelenen, adı belirtilen üçüncü taraf sağlayıcıları kapsar. Her sağlayıcı kendi gerçek item tanımlarına ve uyumlu bir API sürümüne ihtiyaç duyar. Eksik item'lar telefonun sağlık kontrollerinde bildirilir; bu hataları bastırmayın. Item kurulum örnekleri phone/config/items/ altında gelir.

Telefonun düzenlenebilir köprüleri ses, society hesapları, bankacılık, garajlar, housing, dispatch ve diğer entegrasyonları kapsar. Her işlev için tam olarak tek bir sağlayıcı seçili tutun. Adı değiştirilmiş resource'ları Config.ResourceNames ile sabitleyin; bir sağlayıcıyı açıkça seçmek için Config.Providers kullanın. Rastgele üçüncü taraf export'lar otomatik olarak uyumlu değildir: scriptiniz listede yoksa belgelenmiş özel köprüyü uygulayın. Framework adaptörleri ve otomatik sözleşme testleri, her üçüncü taraf sürümünün canlı test edildiği iddiası değildir.

Bu sürüm için canlı test edilen altyapı: ESX Legacy, ox_inventory, oxmysql ve pma-voice. Başka bir framework'te mağazayı açmadan önce 7. bölümdeki ilk çalıştırma kontrollerini yapın.

4. Herkese açık mağaza veya oyuncuya ait işletme

Sunucu konsolunda iki komuttan birini çalıştırın:

phonehubmode public
phonehubmode business

Seçilen mod yeniden başlatmalarda korunur. Herkese açık mod normal alışverişi korur. İşletme modu, PhoneHub tezgâhında yapılan satın alımlara kalıcı stok ve rezervasyon uygular. İşletme modu tezgâhta takası devre dışı bırakır. Aynı telefon ödeme akışı fiyatları, ödemeleri ve item teslimatını doğrular.

Meslek adını ve rütbelerini phone/config/phonehub_business.lua içinde ayarlayın:

Meslekleri framework'ünüzün normal yönetim araçlarıyla atayın. Company yönetimi için telefonda Services → My Work → PhoneHub → Staff and account yolunu açın. Seçili framework'ün desteklenen personel/society fonksiyonlarını kullanır. Birleşik sürüm ayrıca Business sekmesinden oyun içi satın alım veya aşağıda açıklanan yönetici atama komutu ile kalıcı oyuncu sahipliğini destekler. Tüm sahiplik fiyatları oyun içi para birimi tutarlarıdır.

esx_addonaccount kullanan ESX için, hesap resource'unu başlatmadan önce zerodev_phonehub_mlo/setup/phonehub_esx_society.sql dosyasını da içe aktarın, ardından sunucunuzu yeniden başlatın. Bu, mevcut bir bakiyenin üzerine yazmadan sıfır bakiyeli society_phonehub şirket hesabını oluşturur. Mesleğin adını değiştirdiyseniz hesap sonekini de buna göre güncelleyin. Diğer bankacılık sağlayıcıları, yapılandırılmış meslek için kendi normal şirket hesabı kurulumlarını gerektirir. İşletmeyi açmadan önce Company içinde küçük bir para yatırma ve çekme işlemini doğrulayın.

İşletme bütçesi, stok alımı için ayrı bir dahili defterdir. Satışlar ona eklenir; tedarikçi siparişleri ondan düşülür. Otomatik olarak bir society banka hesabı değildir ve çekilebilir bir oyuncu nakit bakiyesi değildir.

5. Tedarikçi siparişleri ve stok teslimatı

Servis tezgâhında PhoneHub terminalini açmak için E'ye basın, ardından Stock'u seçin. Bir ürün, yapılandırma ve miktar seçin. Sunucu tedarikçi teklifini hesaplar ve çalışanın rütbesini, yakınlığını ve işletme bütçesini kontrol eder.

Varsayılan teslimat 120 saniye sürer. Yeniden başlatmalarda yolda kalır. Ulaştıktan sonra bir çalışan terminalde Receive delivery seçeneğini seçer. Varsayılan destination='stock', malları ödeme akışının kullandığı mağaza stok defterine ekler; alıcının oyuncu envanteri sağlayıcısından bağımsız olarak. Tekrarlanan teslim alma istekleri aynı sevkiyatı iki kez ekleyemez. Müdürler teslim alınmamış bir sevkiyatı tek seferlik bütçe iadesiyle iptal edebilir.

Yapılandırma:

delivery = {
    seconds = 120,
    autoReceive = false,
    destination = 'stock',
    resource = '',
    export = '',
}

Özel bir depo/stash için destination='custom' ayarlayın ve bir sunucu export'u belirtin. Bu export (shipment, source) alır ve kalıcı bir tekilleştirme anahtarı olarak shipment.id kullanmalıdır. Yalnızca her satır başarıyla saklandığında true döndürün. Envanterinizin item/SKU eşlemesini o adaptörde yapılandırın. Özel teslimat item'ları ayrıca dahili satış defterine eklemez; stokun iki kez sayılmaması için depo satış akışınızı açıkça bağlayın. Evrensel bir stash adaptörü varsayılmaz.

Belirsiz bir harici teslim, körü körüne yeniden denenmez, incelemeye alınır. Hedef envanteri kontrol ettikten sonra şunu kullanın:

phonehubdelivery <shipment-id> delivered
phonehubdelivery <shipment-id> retry

Belirsiz bir müşteri ödeme rezervasyonu için, phonehubresolve <reservation-id> returned|delivered kullanmadan önce ödeme ve envanter kayıtlarını inceleyin.

6. Mağaza kontrolleri

Servis kontrol noktasının veya çatıdaki kontrol kaidesinin yanında E'ye basın.

• Space: ön kapı ve çatı kapısı kilitleri, mağaza ışıkları, lounge ekranı, teras tentesi (yağmurda veya karda otomatik ya da açık/kapalı), teras ısıtıcıları veya hava akışı, teras elektriği ve 15 saniyelik bir sprinkler testi.
• Cameras: Entrance overview, Showroom overview ve Service counter. Terminale dönmek kamerayı kapatır; Escape çıkar.
• Stock ve Business: tedarikçi siparişleri, teslimatlar, hasılat, satış ve tamir defteri ve ekip erişimi.

Bina kontrolleri PhoneHub mesleğini veya yapılandırılmış personel/yönetici ACE'sini gerektirir. Terasın herkese açık kontrol erişimi systems_config.lua içinde ayrıca yapılandırılır. phonehub.admin iznini yalnızca güvenilir yönetici principal'ınıza verin; asla herkese vermeyin. MLO sistem yapılandırmasında phoneResource='phone' ayarlayın.

Otomatik kapılar kilitli değilken yakınlık sensörleri kullanır. Hareketli kanatları, açıkken dahil, katı kalmalıdır. Mobilyalar, cam ve aydınlatma özenle yapılmış harita asset'leridir; her dekoratif nesnenin bir oynanış etkileşimi yoktur.

7. İlk çalıştırma kabul kontrolleri

1. Sunucuyu başlatın ve phone:health çalıştırın. Beklenen framework, envanter, veritabanı ve ses sağlayıcılarını ve eksik zorunlu item olmadığını doğrulayın.
2. Normal şekilde girin ve mağazayı ziyaret edin. noclip kapalıyken kaldırımdan her iki giriş kapısı çiftinden geçin, merdivenleri çıkıp inin ve çatı kapısından geçin.
3. Tenteyi açıp kapatın. Sekiz paneli her konumda kılavuz raylar içinde hizalı kalmalıdır. Yağmurda/karda otomatik kapanmayı ayrıca test edin.
4. Her CCTV görünümünü açın, aralarında geçiş yapın ve çıkın. Sahne görünür olmalı ve normal oyuncu görünümü/odağı geri dönmelidir.
5. Her iki kapı grubunu bir personel hesabıyla kilitleyin. Çarpışmayı iki taraftan da kontrol edin. Kilidi açın ve yakınlık açılış animasyonunu yeniden doğrulayın.
6. Gündüz/gece aydınlatmasını, ekran açık/kapalı durumunu, camı, tabelaları, koltukları ve tüm kenarları kontrol edin. Stream geçişlerini incelemek için binaya doğru ve binadan uzağa yürüyün ve araç sürün.
7. Herkese açık modda bir telefon/aksesuar satın alın. İşletme modunda stok düşüşünü, çalışan siparişini, varış/teslim almayı, yetersiz bakiyeyi ve yetkisiz erişimi kontrol edin.
8. Sunucuyu yeniden başlatın ve mağaza modunun, stokun ve bekleyen teslimatların korunduğunu doğrulayın. Yinelenen bir teslim alma/iptal denemesini tekrarlayın; yinelenen mal veya iade görünmemelidir. Birden fazla oyuncunun aynı mağaza durumunu gördüğünü doğrulayın.

Client F8 konsolundaki phonehubcheck gerçek tente hizalamasını bildirir; her panel 1'e yakın bir hizalama bildirmelidir. Bu bir tanılama aracıdır; görsel kalitenin veya çarpışmaların doğru olduğunun kanıtı değildir. Otomatik kontroller her kamera açısını veya tüm sunucu kombinasyonlarını onaylayamaz.

8. Sorun giderme ve güncellemeler

30120 portu meşgul: başka bir sunucu örneği zaten çalışıyor. İkinci bir FXServer başlatmak yerine onu txAdmin'iniz (veya hosting paneliniz) üzerinden durdurun.

Kontroller eksik: iki resource'un da başladığını, adlarının değişmediğini ve oyuncunun kontrol noktasında olduğunu doğrulayın. Client F8 ve sunucu hatalarını inceleyin.

Personel erişimi yok: yapılandırılmış mesleği, sayısal rütbeyi, servis tezgâhına yakınlığı ve seçili meslek sağlayıcısını kontrol edin. Herkese açık mağaza modu personel yetkisi vermez.

Eski harita/eski arayüz kalıyor: yinelenen resource/ensure kayıtlarını kaldırın. FiveM'i tamamen kapatın, sunucuyu durdurun, dosyaları değiştirin, ardından sunucuyu başlatın ve FiveM'i yeniden açın. Yalnızca yeniden bağlanmak eski stream asset'lerini tutabilir. Bir client bağlıyken, binadan uzakta olsa bile, MLO'yu çalışırken yeniden yüklemeyin.

Geri alma: bu resource'ları durdurun, yedeklenen resource klasörlerini ve yapılandırmayı geri yükleyin, ardından mevcut txAdmin'inizle yeniden başlatın. Bilerek tutarlı bir veri yedeğini geri yüklemiyorsanız veritabanı/KVP depolamasını koruyun.

Destek talepleri için verilen sürüm hash'lerini (SHA256.json) saklayın.

PhoneHub OS ve sahiplik

Config.PhoneHubOS (phone/config/phonehub_business.lua içinde) bu sürümü kontrol eder. ownership='both' oyun içi satın almaya ve yönetici atamasına izin verir. Yalnızca tek bir yola izin vermek için 'admin' veya 'purchase' ayarlayın. purchasePrice bir oyun içi para birimi tutarıdır. Yöneticiler phonehubowner <online player id> komutunu sunucu konsolundan veya phonehub.admin ACE'si ile kullanır. Bir satın alma ödemesi beklerken atama engellenir. Sahip, geçici bir oyuncu source numarasına değil, framework karakter kimliğine bağlı olarak saklanır. Sahiplik, mevcut kalıcı stok ve işletme bütçesi sistemini etkinleştirir.

Sahipler yakındaki personeli veya müdürleri Business sekmesinden ekler. Bu bağımsız roller framework kimlik köprüsü üzerinden çalışır; oyuncunun ana mesleğini değiştirmez. Mevcut PhoneHub meslek rolleri ve yapılandırılmış yönetici erişimi çalışmaya devam eder. Varsayılan olarak müdürler tedarik siparişi verebilir, personel de gelen sevkiyatları teslim alabilir. Stok, bir satın alım veya tedarikçi teslimatı onaylanana kadar rezerve kalır.

service='hybrid' hem destekli hem self servis ödeme ve tamire izin verir. 'self' doğrudan hizmete izin verir; 'staff' bu mağazada müşterinin onayladığı bir personel teklifini gerektirir. Tek başına satılan ürün mevcut alışveriş OS'unu korur.

Zemindeki kiosk'a yaklaşın ve E'ye basın. Shop sekmesi gerçek korumalı Pulse modelini sürükleyerek döndürme, ön/arka inceleme, yakınlaştırma ve seçili kaplamayla yükler. Fiyat telefon sunucusundan gelir. Ödeme onay gerektirir ve yapılandırılmış envanteri, parayı ve kutulu telefon teslimatını kullanır. Zaman aşımı, ödemenin başarısız olduğunun kanıtı değildir; yeniden denemeden önce envanteri ve ödeme kaydını kontrol edin.

Müşteriler Help sekmesinden satış veya tamir yardımı ister ve bir sıra numarası alır. Personel Counter sekmesinde yakındaki bir müşteriyi seçer ve bir teklif hazırlar; yalnızca o müşteri onaylayıp ödeyebilir. İkisi de aynı mağazada ve aynı routing bucket'ta kalmalıdır. Tamir onayı, seçilen benzersiz cihaza ve onun teklif edilen fiyatına bağlanır. Cihazı değiştirmek onayı geçersiz kılar.

Destekli tamirlerde teknisyen boş bir tamir tezgâhında terminali açar, müşterinin tamir teklifini hazırlar ve kabul için orada kalır. Tezgâh ödemeden önce rezerve edilir. Başarılı bir ücretli tamir, o oyuncuyu teknisyen olarak kullanarak montaj sekansını çalıştırır; self serviste mağaza teknisyeni kullanılır. Cihaz tamirinden telefon motoru sorumludur ve kesintiye uğrayan bir sunucu oturumundan sonra ücretli işi kurtarır. Client prop'ları asla bir envanter telefonu oluşturmaz veya değiştirmez.

Çatı ve tezgâh kontrol noktalarındaki Space sekmesi tenteyi, iklimlendirmeyi, kilitleri, aydınlatmayı ve ekranı kontrol eder. Tamamlanmış MLO'nun geometrisi, hava koruması, zemin kaplaması ve oturma alanları korunur.