Özellikler

Cüzdan

Kimlik kartı, ruhsatlar, kurum kimliği ve özel kartlar; oyuncuların bunları nasıl gösterdiği ya da devrettiği.

Cüzdan uygulaması karakterin kartlarını tutar: kimlik kartı, ruhsatlar, kurum kimliği ve diğer script'lerin verdiği biletler, kuponlar ve kartlar. Oyuncu herhangi bir kartı yanında duran birine gösterebilir, buna izin veren kartları da devredebilir.

Her şey Config.Wallet ile ayarlanır.

#Kartlar

Kart Nereden gelir Telefondan değiştirilebilir mi
Kimlik Kartı Karakterden: ad, doğum tarihi, cinsiyet, uyruk, kan grubu, belge numarası Hayır
Ruhsatlar Framework'ün karakterde olduğunu söylediği ruhsatlar, her biri için bir kart Hayır
Kurum Kimliği (meslek kartı) Karakterin şu anki mesleği ve rütbesi Hayır
Özel kartlar Diğer script'lerden, AddCard export'u üzerinden Yalnızca silinebilir

İlk üçü yerleşik kartlardır. Hiçbir yerde saklanmazlar: Cüzdan her açıldığında server onları karakterden okur. Framework'te bir ruhsatını kaybeden oyuncu, uygulama bir sonraki yüklendiğinde o kartı da kaybeder. Bu kartlarda "Bu kart karakter bilgilerinden oluşur; telefondan değiştirilemez." notu bulunur.

Her yerleşik kartın bir belge numarası ve bir barkod kodu vardır (ID-…, LIC-…, JOB-…). Bunlar karakter id'sinden üretilir, bu yüzden aynı karakter her zaman aynı numaraları gösterir.

#Kimlik Kartı

Oyuncunun profil fotoğrafıyla birlikte adı, doğum tarihini, cinsiyeti, uyruğu, kan grubunu ve belge numarasını gösterir. Framework'te olmayan alanlar boş kalır (Qbox ve QBCore'da uyruk vardır; ESX'te yalnızca karakter için ayarlanmışsa).

#Ruhsatlar

Ruhsat kartları framework'ten gelir:

Framework Ruhsatların okunduğu yer
QBCore, Qbox Karakterin metadata.licences alanı. true olan her ruhsat bir kart verir
ESX esx_license'ın user_licenses tablosu. esx_license başlatılmamışsa hiç ruhsat yoktur
Standalone, custom Yok

Yalnızca Licences listesindeki ruhsatlar kart alır. Liste, framework'teki ruhsat adını kartın kullandığı başlıkla eşler (wallet.licences.<key> dil anahtarı):

luaLicences = { driver = 'driver', weapon = 'weapon', business = 'business', hunting = 'hunting', fishing = 'fishing', pilot = 'pilot' },

Framework'ün sürücü belgesine drive diyorsa (ESX drive, drive_bike, weapon gibi adlar kullanır), onu ekle: drive = 'driver'. Listede olmayan bir ruhsat yok sayılır.

#Kurum Kimliği

Mesleği unemployed dışında olan her karakter; mesleği, rütbeyi ve bir sicil numarasını gösteren bir kimlik kartı alır. BadgeJobTypes, QBCore veya Qbox meslek tanımındaki type alanını kullanarak bunu bazı meslek türleriyle sınırlar (örneğin { 'leo', 'ems' }). Boş bırakırsan her meslek kart alır. Meslekleri type alanı olmayan bir framework'te (ESX) bu şekilde filtreleme yapılamaz; orada liste ne derse desin her meslek kart alır.

#Kan grubu

Kimlik kartında ve ruhsatlarda görünen kan grubu, Sağlık uygulamasındaki Sağlık Kimliği'ten gelir; bkz. Sağlık. ShowBloodType = false kan grubunu kartlardan kaldırır.

#Özel kartlar

Diğer script'ler AddCard ile kart ekler: konser biletleri, spor salonu üyelikleri, kuponlar, anahtarlar, geçiş kartları. Bir kartın bir türü (ticket, coupon, membership, pass, key, other), bir başlığı, isteğe bağlı alanları, barkod olarak gösterilen bir kodu, bir vereni ve bir son geçerlilik tarihi vardır. Oyuncu çevrimiçiyse kartı hemen alır, değilse Cüzdan'ı bir sonraki açışında alır.

  • Son geçerlilik tarihi geçen bir kart, Süresi doldu işaretiyle Cüzdan'da kalır. Oyuncu onu silebilir. Günlük temizlik, süresi dolduktan Config.Retention.wallet gün sonra (varsayılan 7) onu siler.
  • Oyuncu bir özel kartı Kartı At ile silebilir. Yerleşik kartlar silinemez.
  • transferable = true olarak işaretlenmiş bir kart başka bir oyuncuya devredilebilir.

Export'lar Server export'ları: cüzdan sayfasındadır: AddCard, RemoveCard, GetCards.

#Kart gösterme ve devretme

  1. Oyuncu bir kartı açar ve Göster'e, devredilebilen bir kartta da Ver'e dokunur.
  2. Telefon ShowRange metre içindeki kişileri arar ve onları mesafeleriyle birlikte "Yakındaki kişi 1", "Yakındaki kişi 2" olarak listeler. İsimler asla gösterilmez: bir kişi görürsün, kim olduğunu değil. En fazla 8 kişi listelenir.
  3. Oyuncu birini seçer.

Göster. Diğer oyuncu "Sana bir kart gösterildi" bildirimini alır. Telefonu açık ve kilitsizse kart hemen ekranında açılır ve "Sunucu tarafından doğrulandı" olarak işaretlenir. Kart sahibinde kalır. Bir oyuncuya gösterilen kart, ShownMinutes dakika boyunca (varsayılan 2) Cüzdan'ının en üstünde Sana gösterilenler altında kalır ve bu süre içinde bildiriminden açılabilir. Oyuncu onu Bitti ile kapatırsa listeden daha erken çıkar. En fazla son 5 kart listelenir.

Ver. Kart diğer oyuncunun Cüzdan'ına geçer ve oyuncu kartın başlığını içeren bir bildirim alır. Yalnızca transferable = true olan özel kartlar verilebilir; kimlik, ruhsatlar ve kurum kimliği asla verilemez.

Diğer oyuncunun gördüğü kopya, server'da sahibinin gerçek verisinden oluşturulur. Kartı gösteren telefon yalnızca hangi kartın kime gösterildiğini gönderir; bu yüzden bir oyuncu değiştirilmiş bir sayfayla sahte kimlik oluşturamaz.

#Item şartı

RequireItems = true olduğunda yerleşik bir kart yalnızca eşleşen item oyuncunun envanterindeyken görünür:

luaItems = { identity = 'id_card', driver = 'driver_license', weapon = 'weaponlicense' },

Anahtarlar, kimlik kartı için identity ve Licences listesindeki ruhsat anahtarlarıdır (driver, weapon, …). Items içinde karşılığı olmayan bir ruhsat (varsayılan olarak avcılık, balıkçılık, işletme, pilot) item gerektirmez. Kurum kimliği hiçbir zaman item gerektirmez.

#Seçenekler

Seçenek Varsayılan Ne yapar
Enabled true false Cüzdan'ı kapatır: simge kalkar ve her istek (listeleme, gösterme, verme, fotoğraf, silme) reddedilir. Script'lerin eklediği kartlar saklanmaya devam eder, AddCard / RemoveCard çalışmaya devam eder
ShowBloodType true Sağlık Kimliği'teki kan grubunu kimlik kartına ve ruhsatlara yazar
ShowRange 3.0 Metre: birine kart gösterebilmek ya da verebilmek için ne kadar yakın durması gerektiği
ShownMinutes 2 Birinin sana gösterdiği kartın "Sana gösterilenler" listesinde kaldığı ve bildiriminden açılabildiği dakika
RequireItems false Yerleşik kartlar yalnızca eşleşen item envanterdeyken görünür
Items identity = 'id_card', driver = 'driver_license', weapon = 'weaponlicense' Her kart için item, RequireItems ile kullanılır
Licences driver, weapon, business, hunting, fishing, pilot Framework'teki ruhsat adı ve kullandığı kart başlığı
BadgeJobTypes {} Kurum kimliği taşıyan meslek türleri. Boş: her meslek. ESX'te (meslek türü yok) her meslek
MaxCustomCards 40 Bir karakterin tutabileceği özel kart sayısı

#Bilmekte fayda var

  • Bir ruhsat görünmüyor. Framework'teki adı Licences içinde bir anahtar değildir, ya da (ESX) esx_license başlatılmamıştır, ya da RequireItems = true ve item eksiktir.
  • BadgeJobTypes ayarlı olmasına rağmen ESX'te her meslekte kurum kimliği var. ESX mesleklerinde filtrelenecek bir type yoktur, bu yüzden liste orada yok sayılır.
  • Kimlik kartındaki belge numarası karakter id'sidir (QBCore ve Qbox'ta citizenid, ESX'te identifier). Identifier'ları gizli tutuyorsan bunu göz önünde bulundur.
  • AddCard, nil, 'limit' döndürür oyuncu zaten MaxCustomCards kart tutuyorsa. Cüzdanı dolu bir oyuncuya kart vermek "Karşı tarafın cüzdanı dolu." hatasıyla başarısız olur.
  • "Kişi artık yanında değil." Diğer oyuncu liste oluşturulduktan sonra uzaklaştı. Liste 60 saniye geçerlidir ve oyuncunun hâlâ ShowRange (artı 1.5 m) içinde olması gerekir.
  • Süresi dolan özel kartları günlük temizlik, süreleri dolduktan Config.Retention.wallet gün sonra siler. Saklamak için bunu 0 yap; birini daha önce silmek için RemoveCard kullan.