Trucker Job: Export ve Event'ler
Komutlar, tuş ataması, Trucker Job'un dinlediği oyuncu yükleme event'leri ve dayandığı hype-core köprüleri.
v1.0.0'da export yok
hype-truckerjob henüz kendine ait bir export kaydetmiyor. Her şey tablet, yönetici paneli ve aşağıdaki komutlar üzerinden çalışır. Framework, target, yakıt ve araç anahtarı entegrasyonu hype-core üzerinden yapılır.
| Ad | Tür | Taraf | Amaç |
|---|---|---|---|
/cancelroute | Komut | İstemci | Aktif rotayı iptal eder |
/truckeradmin | Komut | Sunucu | Yönetici panelini açar |
+toggleinfopanel | Tuş ataması | İstemci | Rota panelini gösterir veya gizler (B) |
hype-core:server:player-loaded | Event | Sunucu | Karakterin şoför verisini ve işletmelerini yükler |
hype-core:client:player-loaded | Event | İstemci | Tablet verisini, NPC'leri ve blip'leri yeniler |
Komutlar
/cancelroute
Bir onay penceresinden sonra oyuncunun aktif rotasını iptal eder. Ödeme yapılmaz, iş başarısız sayılır, rota araçları
silinir ve CancelRoute.penalty işletme kasasından alınır. Tablette de aynı buton vardır.
/cancelrouteKomut adı Config.CancelRoute.command ayarından gelir. Sadece tablet butonunu bırakmak için false yap; iptali
tamamen kapatmak için CancelRoute.enable = false kullan.
/truckeradmin
Yönetici panelini açar. Oyuncular bunu sohbetten veya F8 konsolundan çalıştırır; sunucu konsolundan gelen komut yok sayılır.
/truckeradminKomut adı Config.AdminMenu.command ayarından gelir; false olursa komut kaydedilmez. Panelden ekip şunları
yapabilir:
| İşlem | Ne yapar |
|---|---|
| Kirayı ödendi say | Bir işletmenin ödenmemiş tüm faturalarını kapatır |
| Kirayı uzat | Bir sonraki kira tarihini 1 ile 365 gün arasında ileri alır |
| Kasayı ayarla | İşletme kasasını tam bir tutara ayarlar |
| İşletmeyi düzenle | Adı ve blip'in tamamını (simge, renk ve boyut) değiştirir |
| İşletmeyi sıfırla | Sahibi kaldırır ve işletmeyi tekrar satışa çıkarır |
| Çalışanı kov | Bir çalışanı işletmeden çıkarır |
| Rotayı iptal et | Bir oyuncunun aktif rotasını başarısız sayar |
| Işınlan | Yöneticiyi panel haritasında seçilen noktaya götürür |
Her işlem sunucu konsoluna yazılır ve Config.Discord açıksa admin loguna gönderilir.
+toggleinfopanel
Rota aktifken ekrandaki rota panelini gösterir veya gizler. Varsayılanı B olan bir tuş atamasıdır; her oyuncu bunu
Ayarlar → Tuş Atamaları → FiveM altında Toggle Trucker Job Info Panel adıyla değiştirebilir.
Event'ler
Script, bir karakterin hazır olduğunu anlamak için hype-core'un oyuncu yükleme event'lerini kullanır. hype-core'daki framework köprüleri bunları QBox, QBCore ve ESX yükleme event'lerinden tetikler; çoğu durumda bir şey yapmana gerek yok.
hype-core:server:player-loaded
Karakterin şoför XP'sini yükler (ve hype_truckerjob_personel kaydını oluşturur), çalıştığı her işletmede onu çevrim
içi yapar ve çalışan listelerini yeniler. Multicharacter kaynağın karakterleri olağan framework event'leri olmadan
yüklüyorsa bunu kendin tetikle.
TriggerEvent('hype-core:server:player-loaded', source)Seçenek
Tür
hype-core:client:player-loaded
İstemcide script; oyuncu verisini, config'i ve çevirileri tablete yeniden gönderir, işletme NPC'lerini, blip'leri ve target seçeneklerini baştan kurar.
TriggerEvent('hype-core:client:player-loaded')İç event'ler
hype-truckerjob:server:* ve hype-truckerjob:client:* adlı event'ler iç kullanım içindir. Sunucu her rota adımını,
konumu ve ödemeyi kontrol eder; bunları elle tetiklemek işe yaramaz ve aktif bir rotayı başarısız yapabilir.
hype-core köprüleri
hype-truckerjob framework'ünden doğrudan hiçbir şey çağırmaz. Dışarıya yapılan her çağrı hype-core üzerinden geçer; böylece kurulumundaki bir değişikliği tüm HypeScripts kaynakları için hype-core'da bir kez yaparsın.
| İhtiyaç | hype-core çağrısı | Ayarlandığı yer |
|---|---|---|
| Karakter kimliği ve adı | GetPlayerIdentifier, GetCharacterName, GetPlayers | Framework, otomatik tespit edilir |
| Para | GetPlayerMoney, AddPlayerMoney, RemovePlayerMoney | Framework |
| Ehliyet | GetPlayerLicense | Framework, ESX'te esx_license |
| Ölüm kontrolü | GetIsPlayerDead | Framework |
| NPC etkileşimi | GetModules("Target") | ox_target, yoksa qb-target |
| Tır yakıtı | GetFuel, SetFuel | hype-core config'indeki Fuel |
| Araç anahtarları | GiveKeys, RemoveKeys | hype-core config'indeki VehicleKeys |
| Blip ve NPC'ler | CreateBlip, UpdateBlip, RemoveBlip, CreateFreezedPed, RemovePed | - |
| Profil fotoğrafı | GetDiscordAvatar | hype-core'un Discord bot ayarları |
Bildirimler, text UI, progress bar'lar ve pencereler doğrudan ox_lib kullanır. Oyuncunun Discord avatarı yoksa ve
MugShotBase64 çalışıyorsa, tablet profil fotoğrafı olarak karakterin yüz fotoğrafı kullanılır.
Fuel = 'ox_fuel',
VehicleKeys = 'qbx_vehiclekeys',