Pulse Phone dokümantasyonu

Framework'ler

Pulse Phone 1.4.2 için8 dk okumaGüncellendi: 20 Ekim 2026

3. Framework'ünüz için adım adım

Telefon framework'ünüzü kendisi bulur: es_extended, qb-core, qbx_core, ox_core, ND_Core, vrp veya TMC'nin core resource'u. Config.Framework ayarına (config/config.lua içinde) yalnızca birden fazlası çalışıyorsa veya özel bir framework için ihtiyacınız olur.

Bir bakışta framework'ünüz

Framework	Nasıl bulunur	Item'lar	Banka ve nakit	Bilmekte fayda var
ESX Legacy	`es_extended`	Pulse item'larını ESX'in `items` tablosuna kendisi ekler (varsayılan envanter). ox_inventory'de açılış kontrolünün yazdırdığı bloğu yapıştırın	ESX hesapları	Society scriptiniz üzerinden şirket hesapları
QBCore	`qb-core`	Pulse item'larını QBCore'un shared items listesine kendisi ekler (qb-, ps-, lj-inventory)	QBCore parası	Şirketi `isboss` rütbeleri yönetir
Qbox	`qbx_core` (onun `qb-core` taklidi ikinci bir framework değil, Qbox sayılır)	Yazdırılan ox_inventory bloğunu yapıştırın	Qbox parası	QBCore adaptörünü değil, her zaman Qbox adaptörünü kullanır
ox_core	`ox_core`	Yazdırılan ox_inventory bloğunu yapıştırın	Karakterin ox_core hesabı; nakit, ox_inventory'nin `money` item'ıdır	Görev durumu yok: herkes görevde sayılır
ND Core	`ND_Core`	Yazdırılan ox_inventory bloğunu yapıştırın	ND'nin `bank` ve `cash` değerleri	Görev durumu yok; şirket hesabı yok
TMC	TMC'nin kendi core nesnesiyle tanınan `core` resource'u	Her item TMC'nin item listesinde olmalıdır: açılış kontrolü bunları yazdırır	TMC parası	Özel köprü üzerinden çalışır, ayarlanacak bir şey yok
vRP 2	`vrp`	vRP bölümüne bakın	vRP cüzdanı ve bankası	vRP 1 ve fork'ları desteklenmez
Standalone	yukarıdakilerin hiçbiri çalışmıyor	Gerekmez	Telefonun kendi bankası	Test sunucuları veya framework'ü olmayan sunucular için
Özel	`Config.Framework = 'custom'`	Köprünüz üzerinden	Köprünüz üzerinden	"Özel veya kendi geliştirdiğiniz framework" bölümüne bakın

Framework'ü zorlamak

Çoğu sunucunun buna hiç ihtiyacı olmaz. Açılış satırı yanlış framework'ü gösterdiğinde veya iki framework core'u kurulu ve başlatılmış olduğunda framework'ü zorlayın. server.cfg dosyasına tek satır ekleyin:

server.cfg

setr phone_framework qb

Değer	Framework
`esx`	ESX Legacy (`es_extended`)
`qb`	QBCore (`qb-core`)
`qbox`	Qbox (`qbx_core`)
`ox`	ox_core
`nd`	ND Core (`ND_Core`)
`vrp`	vRP 2 (`vrp`)
`tmc`	TMC (`core`)
`standalone`	Framework yok: telefon kendi kimliğini ve bankasını tutar
`custom`	Kendi köprünüz (aşağıda "Özel veya kendi geliştirdiğiniz framework" bölümüne bakın)
`auto`	Satırı hiç eklememekle aynı: `Config.Framework` karar verir

Config.Framework ayarına göre önceliklidir. Değiştirdikten sonra telefonu yeniden başlatın.
Resource adları da çalışır: qbcore, qb-core, qbx_core, es_extended, ox_core. Tanımadığı bir kelime reddedilir: açılış kontrolü bunu söyler ve para özellikleri kapalı kalır.
qb, qbx_core çalıştıran bir sunucuda Qbox adaptörünü kullanır. Qbox, QBCore olarak da yanıt verir.
Zorladığınız framework başlatılmamışsa telefonlar, o başlatılana kadar "not ready" ekranında kalır. Telefon asla kendiliğinden başka bir framework'e geçmez.

Multicharacter her framework'te çalışır. Config.IdentityScope = 'character' (varsayılan) her karaktere kendi telefonunu verir. 'player' hesap başına bir telefon verir. Bir kez seçin: canlı bir sunucuda değiştirmek mevcut tüm telefonları geride bırakır.

Şirket yönetimi (mesai, personel, işe alım, Services uygulamasındaki şirket hesabı) Config.Services içindeki şirketleri kullanır (config/apps.lua dosyasında). Meslek adlarınız varsayılanlardan (police, ambulance, mechanic, taxi, fire ...) farklıysa, kendi adlarınızı o şirketin job listesine ekleyin. Patron rütbelerini kendiniz seçmek için şirkete bossGrade = <n> ekleyin.

ESX Legacy

server.cfg

ensure oxmysql
ensure es_extended
# ... your ESX scripts, inventory, banking ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Item'lar: varsayılan ESX envanteriyle yapılacak bir şey yok. Telefon item'larını açılışta ESX'in items tablosuna ekler ve konsol hangilerini eklediğini söyler. Kendiniz eklemeyi tercih ederseniz config/items/esx.sql hazır. Başka bir envanterle 4. bölüme bakın.
Para: banka ESX bank hesabıdır, nakit money hesabıdır.
Karakter: telefon ESX'in oyuncu identifier değerini takip eder; bu yüzden esx_multicharacter çalışır.
Patron: şirketi boss adlı rütbe yönetir (bossGrade ayarlamadıysanız).
Şirket hesapları: esx_addonaccount / esx_society veya 7. bölümdeki bir bankacılık scripti.

QBCore

server.cfg

ensure oxmysql
ensure qb-core
# ... qb-inventory and your other qb scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Item'lar: yapıştırılacak bir şey yok. Telefon ihtiyaç duyduğu item'ları açılışta QBCore'un shared items listesine ekler ve konsol hangilerini eklediğini söyler. Resimleri config/items/images/ klasöründen qb-inventory/html/images/ klasörüne kopyalayın; açılış kontrolü eksik olanların adını verir.
Para: bank ve cash.
Karakter: citizenid; bu yüzden qb-multicharacter çalışır.
Patron: meslek tanımlarınızda isboss = true olan rütbeler (bossGrade ayarlamadıysanız).
Şirket hesapları: Renewed-Banking, qb-banking veya eski qb-management.
Multijob: ps-multijob çalışıyorsa oyuncunun diğer meslekleri Services'te görünür ve tek dokunuş bir mesleği aktif yapar.

Qbox

server.cfg

ensure oxmysql
ensure qbx_core
ensure ox_inventory
# ... your other Qbox scripts, in Qbox's own order ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Item'lar: Qbox, başka bir scriptten item alamayan ox_inventory'yi kullanır. Sunucuyu bir kez başlatın: açılış kontrolü eksik tanımları ox_inventory/data/items.lua içine yapıştırmaya hazır şekilde yazdırır (4. bölüm). Resimler ox_inventory/web/images/ klasörüne gider.
Para: qbx_core üzerinden bank ve cash.
Karakter: citizenid.
Patron: isboss = true olan rütbeler (bossGrade ayarlamadıysanız).
Multijob: yerleşik. Oyuncunun diğer meslekleri Services'te görünür.
qbx_core, qb-core olarak da yanıt verir. Bu normaldir: telefon ikisini tek bir framework olarak ele alır.

ox_core

server.cfg

ensure oxmysql
ensure ox_core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Item'lar: sunucuyu bir kez başlatın: açılış kontrolü eksik tanımları ox_inventory/data/items.lua içine yapıştırmaya hazır şekilde yazdırır (4. bölüm). Resimler ox_inventory/web/images/ klasörüne gider.
Para: banka, karakterin ox_core hesabıdır. Nakit, ox_inventory'deki money item'ıdır.
Karakter: charId.
Meslekler: ox_core gruplarında görev durumu yoktur, bu yüzden telefon görev durumunu kendisi tutar. Şirket yönetimi (personel, işe alım, rütbeler) ve vale ox_core'da kullanılamaz.

ND Core

server.cfg

ensure oxmysql
ensure ox_lib
ensure ND_Core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Kendiliğinden bulunur: ND_Core başlatıldığında. Zorlamak için: setr phone_framework nd.
Item'lar: ND, ox_inventory kullanır. Sunucuyu bir kez başlatın: açılış kontrolü eksik tanımları ox_inventory/data/items.lua içine yapıştırmaya hazır şekilde yazdırır (4. bölüm).
Para: karakterin ND bank değeri ve ND cash değeri (ox_inventory, money item'ını eşit tutar).
Karakter: ND'nin karakter kimliği. Karakterin bir ND numarası varsa gösterilen telefon numarası ND'nin kendi numarasıdır.
Meslekler: karakterin ND mesleği ve rütbesi. ND'de görev durumu yoktur, bu yüzden herkes görevde sayılır. Şirket yönetimi, şirket hesapları ve vale ND Core'da kullanılamaz.
Garaj: sahip olunan araçlar ND'nin nd_vehicles tablosundan gelir.

vRP

Yalnızca vRP 2 desteklenir (vRP 1 veya topluluk fork'ları değil). Telefon, bridge/frameworks/vrp/ içinden vRP'ye küçük bir eklenti yükler. Kopyalanacak bir şey yok.

server.cfg

ensure oxmysql
ensure vrp
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Item'lar: vRP için item dosyası yoktur ve vRP 2 item'ları telefon için kullanılabilir yapamaz. Config.Item.required = false ayarını (varsayılan) koruyun ve mağazanın telefonları doğrudan teslim etmesi için Config.Store.box = false ayarlayın. Oyuncular şarj item'larını /phonepack ve /phonecable ile kullanır; bir vRP envanteriyle bunlar için oyuncunun pulse_magpack ve pulse_cable taşıması gerekir, bu yüzden iki item'ı da vRP item listenize ekleyin ya da Config.Charging.enabled = false ayarlayın.
Para: vRP'nin bankası ve cüzdanı.
Karakter: vRP'nin karakter kimliği.
Meslekler: şirket yönetimi ve vale vRP'de kullanılamaz. Bir garaj scripti bağlamadığınız sürece Garage uygulaması boş kalır.

TMC

TMC yerleşiktir. Telefon TMC'nin core resource'unu kendisi tanır: ek resource yok, config/config.lua içinde değişiklik yok (auto, tmc ve custom hepsi çalışır).

server.cfg

ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Açılış kontrolü Framework: TMC gösterir.

Item'lar: Pulse item'larını TMC'nin item listesine diğer item'ları eklediğiniz gibi ekleyin. Adlar: phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (tanımlar config/items/tmc.lua içinde), mağaza kutuları için ise pulse_phone_box ve her kaplama için bir tane (pulse_phone_box_black ...). Etiketler, ağırlıklar ve açıklamalar config/items/qb-core.lua içinde, resimler config/items/images/ içinde. Listede olmayan bir item reddedilir ve oyuncu "inventory full" görür: ardından konsol item'ın adını verir. Listede olmayan bir kutu item'ı satışı durdurmaz: mağaza o telefonu kutusuz teslim eder ve bunu konsolda belirtir. Kutuları hiç istemiyorsanız Config.Store.box = false ayarlayın.
Para: karakterin nakdi ve bankası: çalışıyorsa TMC'nin banking resource'u (karakterin kendi kişisel hesabı), aksi hâlde core'un banka parası. Hesap numaralarınız BNK123456 biçiminde değilse, hesap numarasını tutan alanın adını config/config.lua içinde belirtin: Config.Providers.tmcBankAccount = 'charinfo.account' (kendi alanınızı kullanın). Banka okunamadığında Wallet uydurma bir rakam değil, bir tire gösterir.
Karakter: TMC'nin citizen id değeri.
Meslekler: görevdeki meslek (veya ilki), rütbesi ve görev durumuyla.
Geçici pulse_tmc bağlayıcısını kullandınız mı? ensure pulse_tmc satırını kaldırın ve o klasörü silin. Hâlâ çalışırken konsol size hatırlatır.

Standalone (framework yok)

server.cfg

ensure oxmysql
ensure pma-voice
ensure screenshot-basic
ensure phone

Item'lar: gerekmez. Her oyuncunun bir telefonu, bir Reserve'ü ve bir kablosu vardır.
Para: telefon kendi bankasını tutar. Yeni bir oyuncu 5000 ile başlar (startingBalance, config/apps.lua içinde).
Karakter: oyuncunun Rockstar lisansı.
Meslekler, araçlar ve evler: telefon kendisininkini tutar. Bunları 9. bölümdeki test komutlarıyla doldurun.

Özel veya kendi geliştirdiğiniz framework

Config.Framework = 'custom' ayarını yapın (config/config.lua içinde).
Telefona optional-developer-kit/custom_framework_bridge.lua yapısında bir köprü tablosu verin: ya Config.Providers.custom olarak (config/config.lua içinde) ya da kendi resource'unuzdan exports.phone:RegisterFrameworkBridge(MyBridge) ile.
Yalnızca GetCharacterId zorunludur. Ad, meslek, lisans veya araç/ev listesi fonksiyonunu dışarıda bırakırsanız telefon, sunucunuzda böyle bir veri yokmuş gibi davranır. Para veya item fonksiyonunu dışarıda bırakırsanız o işlem reddedilir: telefon asla kendine ait bir bankadan ödeme yapmaz. Bank uygulaması yalnızca köprünüzde GetBankBalance varsa görünür.
Telefon çalışmaya devam ederken core'unuz yeniden başlarsa, core hazır olduğunda exports.phone:FrameworkRestarted() çağırın.

bridge/frameworks/custom.lua, telefonun tablonuzu nasıl kullandığını gösterir. Kendi geliştirdiğiniz diğer scriptleri (bir bankacılık veya garaj scripti) bağlamak için optional-developer-kit/custom_provider_template.lua dosyasına ve Exports sayfasına bakın. İki şablon telefon klasöründe değil, isteğe bağlı geliştirici kitinde gelir: zerodevscripts.com/downloads/PulsePhone-developer-kit.zip.