Ö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.walletgün sonra (varsayılan7) onu siler. - Oyuncu bir özel kartı Kartı At ile silebilir. Yerleşik kartlar silinemez.
transferable = trueolarak 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
- Oyuncu bir kartı açar ve Göster'e, devredilebilen bir kartta da Ver'e dokunur.
- Telefon
ShowRangemetre 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. - 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ı
Licencesiçinde bir anahtar değildir, ya da (ESX)esx_licensebaşlatılmamıştır, ya daRequireItems = trueve item eksiktir. BadgeJobTypesayarlı olmasına rağmen ESX'te her meslekte kurum kimliği var. ESX mesleklerinde filtrelenecek birtypeyoktur, 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 zatenMaxCustomCardskart 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.walletgün sonra siler. Saklamak için bunu0yap; birini daha önce silmek içinRemoveCardkullan.