Özellikler
Banka, faturalar ve kripto
Banka uygulaması, faturalar, canlı fiyatlarla kripto ve Coin Lab.
Bu sayfada dört para özelliği bir arada anlatılır.
| Özellik | Uygulama | Config |
|---|---|---|
| Banka: bakiye, havaleler, ek hesaplar, meslek hesabı, para istekleri, en yakın ATM | Banka | Config.Bank |
| Faturalar: oyuncular arası ve şirketlerden gelen faturalar | Faturalar ve Banka'nın Faturalar sekmesi | Config.Invoices |
| Kripto: canlı fiyatlarla gerçek coinler | Banka'nın Kripto sekmesi | Config.Crypto |
| Coin Lab: oyuncuların kendi çıkardığı coinler | Coin Lab | Config.Coins |
Hepsi karakterin framework'teki banka parasını (QBCore, Qbox, ESX) kullanır. Telefon ana hesap için kendine ait bir bakiye tutmaz; yalnızca geçmişi tutar. Telefonda gösterilen tutarlar Config.Currency ile biçimlendirilir.
#1. Banka
#Oyuncu ne görür
Banka uygulamasının dört sekmesi vardır: Cüzdan (bakiye, nakit, IBAN, son işlemler, harcama grafiği), Faturalar, Kripto ve Hesaplar.
- Para Gönder. Oyuncu bir telefon numarası ya da IBAN yazar veya bir kişi seçer. Telefon göndermeden önce bunun kime ait olduğunu gösterir (o oyuncu adını Yayıncı Modu ile gizliyorsa "gizli bir hesaba"). Her havaleye bir not eklenebilir.
- Para İste ("para iste"). Diğer oyuncuya kişisel bir istek gönderir. İstek onun Faturalar uygulamasına ve Banka'sının Faturalar sekmesine düşer; tek dokunuşla öder.
- Harcamaların. Bir gün, bir hafta, bir ay ya da tüm zamanlar için yatırılan, çekilen, alınan ve gönderilen paralar.
- En Yakın ATM. Oyuncunun çevresindeki en yakın 3 ATM, sokak adı ve mesafesiyle. En Yakına Rota Çiz haritaya bir işaret koyar.
Havaleyi alan kişi, çevrimdışıyken bile bir bildirim alır.
#IBAN
Her karakterin bir IBAN'ı vardır. Banka resource'unda karakter için bir IBAN varsa (tgiann-bank) banka adaptöründen gelir; yoksa telefon config_server.lua içindeki ServerConfig.IbanGenerate ile bir tane üretir. Havaleler IBAN'ı da telefon numarasını da kabul eder.
#Banka adaptörleri
Adaptör iki şeye karar verir: IBAN'ın nereden geldiğine ve meslek hesaplarının (şirket parasının) nerede tutulduğuna.
Adapter |
Gerekenler | Meslek hesapları |
|---|---|---|
'tgiann-bank' |
tgiann-bank | tgiann-bank'ın meslek hesapları |
'qb-management' |
qb-management | qb-management |
'renewed-banking' |
Renewed-Banking | Renewed-Banking |
'esx_society' |
esx_society ve esx_addonaccount | society_<job> |
'framework' |
hiçbir şey | yok |
'auto', bu sırayla çalışan ilk adaptörü kullanır. Adıyla belirtilen bir adaptör çalışmıyorsa bir uyarıyla auto'ya düşer. Konsol sonucu başlangıçta yazdırır: bank adapter: <name>. Kendi adaptörünü yazmak Banka entegrasyonu sayfasında anlatılıyor.
#Ek hesaplar
Accounts.Enabled = true olduğunda bir karakter, Hesaplar sekmesinden en fazla Accounts.Max ek hesap açabilir:
| Tür | Nedir |
|---|---|
| Birikim | Yalnızca sahibine aittir |
| Ortak | Sahibi, kendisi dışında en fazla Accounts.SharedMembers oyuncuyu telefon numarasıyla ekler |
Ortak hesap üyesi ya Üye (para yatırabilir ve çekebilir) ya da İzleyicidir (yalnızca görür). Para hesaplar arasında Hesaplar Arası ile aktarılır. Bir hesap ancak boşken kapanır. Her hesabın kendi IBAN'ı ve kimin neyi aktardığını gösteren kendi hareket listesi vardır.
tgiann-bank çalışıyorsa telefon kendi ek hesaplarını tutmaz. Onun yerine tgiann-bank'ın ek ve ortak hesaplarını salt okunur olarak gösterir: para yatırma ve çekme tgiann-bank'ın ATM'lerinde yapılır.
#Meslek hesabı
Accounts.JobAccount = true olduğunda, rütbesi patron rütbesi olan bir oyuncu mesleğinin hesabını Hesaplar sekmesinde görür ve bu hesapla kendi hesabı arasında para aktarabilir. Meslek hesabından para çekmek bir gerekçe ister. Bunun için meslek hesapları olan bir adaptör gerekir; 'framework' ile meslek hesabı yoktur.
#Seçenekler
| Seçenek | Varsayılan | Ne yapar |
|---|---|---|
Adapter |
'auto' |
Banka adaptörü, yukarıya bak |
Accounts.Enabled |
true |
Oyuncular ek hesap açabilir |
Accounts.Max |
3 |
Bir karakterin sahip olabileceği ek hesap sayısı, birikim ve ortak hesaplar birlikte |
Accounts.SharedMembers |
5 |
Bir ortak hesapta sahibi dışındaki kişi sayısı |
Accounts.JobAccount |
true |
Patronlar meslek hesaplarını görür ve hesaba para yatırıp çekebilir |
Requests |
true |
Banka'da "para iste". Config.Invoices.EveryoneCanSend false olsa bile çalışır |
AtmModels |
prop_atm_01, prop_atm_02, prop_atm_03, prop_fleeca_atm |
En Yakın ATM ekranının aradığı prop modelleri |
Bankanın kullandığı diğer seçenekler:
| Seçenek | Varsayılan | Ne yapar |
|---|---|---|
Config.Limits.TransferMax |
1000000 |
En büyük havale, hesap aktarımı, istek, fatura ve kripto emri |
Config.Limits.CashMessageMax |
50000 |
Mesajlar'da bir sohbet içinde gönderilen ya da istenen en büyük tutar; bkz. Mesajlaşma |
Config.Currency |
{ Code = 'USD', Symbol = '$', Locale = 'en-US' } |
Tutarların telefonda nasıl yazıldığı |
Türk bir sunucu Config.Currency = { Code = 'TRY', Symbol = '₺', Locale = 'tr-TR' } kullanır. Locale binlik ayırıcıyı, ondalık işaretini ve simgenin nereye geleceğini belirler.
#2. Faturalar
Fatura, bir oyuncunun başka bir oyuncuya gönderdiği bir ödeme talebidir. Alıcının Faturalar uygulamasında (ve Banka'nın Faturalar sekmesinde) ödenene kadar bekler. Ödeme, tutarı alıcının bankasından alır.
| Tür | Kim gönderir | Parayı kim alır |
|---|---|---|
| Kişisel | EveryoneCanSend = true iken herhangi bir oyuncu |
Gönderen, tamamını |
| Şirket | Jobs içinde listelenen bir mesleğin, izin verilen rütbedeki oyuncuları |
Meslek hesabı ile çalışan arasında bölünür |
| İstek | Config.Bank.Requests açıkken, Banka'daki Para İste ile herhangi bir oyuncu |
Gönderen, tamamını |
| Script | AddInvoice ile başka bir resource |
Meslek hesabı (meslek varsa), gönderen olarak belirtilen oyuncu ya da kimse (ceza gibi düz bir etiket) |
Alıcıya telefon numarasıyla ulaşılabilir. Çevrimiçi olması gerekmez. Gönderen, fatura ödenmemişken onu iptal edebilir; ödendikten sonra geri alınamaz. Alıcı yeni bir fatura için, gönderen ise fatura ödendiğinde bildirim alır.
#Şirket faturaları ve paylaşım
luaGradeShare = { Base = 20, PerGrade = 5, Max = 50 },
Jobs = {
police = { label = 'Police', cutSender = 'rest', cutReceiver = 'grade', send = 'all' },
mechanic = { label = 'Mechanic', cutSender = 70, cutReceiver = 30, send = { 2, 3, 4 } },
ambulance = { label = 'EMS', cutSender = 'rest', cutReceiver = 'grade', share = { Base = 10, PerGrade = 5, Max = 40 } },
},
Gelen config.lua uzun bir örnek liste içerir. Jobs listesini sunucunun mesleklerine göre ayarla.
| Alan | Ne yapar |
|---|---|
label |
Faturadaki ad |
cutSender |
Meslek hesabına giden yüzde ya da 'rest': çalışanın almadığı kısım |
cutReceiver |
Faturayı gönderen çalışana giden yüzde ya da 'grade': rütbesiyle birlikte artan bir pay (aşağıda) |
share |
Bu meslek için isteğe bağlı { Base, PerGrade, Max }; GradeShare yerine kullanılır |
send |
Gönderebilen rütbeler: 'all' ya da { 2, 3, 4 } gibi bir liste |
Adlar kolayca karıştırılır: cutSender şirketin payı, cutReceiver çalışanın payıdır. İkisinin toplamı 100'ün altında kalırsa aradaki fark kimseye ödenmez. Toplam 100 olduğunda yuvarlamadan kalan kısım mesleğe gider.
#Rütbeye göre pay
cutReceiver = 'grade' olduğunda çalışanın yüzdesi 0. rütbede GradeShare.Base'dir, üstündeki her rütbe için GradeShare.PerGrade eklenir ve asla GradeShare.Max'ı geçmez. Varsayılanlarla bu 0. rütbede %20, 3. rütbede %35 ve 6. rütbeden itibaren %50 eder. cutSender = 'rest' eklersen kalan kısmı meslek hesabı alır; böylece hiçbir şey kaybolmaz.
Kullanılan rütbe, çalışanın faturayı gönderdiği andaki rütbesidir; faturayla birlikte saklanır. Bu bilgi saklanmadan önce gönderilmiş bir faturada, gönderen o meslekte çevrimiçiyse şu anki rütbesi, değilse 0. rütbe kullanılır.
Mesleğin payı bir meslek hesabına ödenemiyorsa (meslek hesapları olan bir adaptör yoksa ya da mesleğin hesabı yoksa) ödeme reddedilir, ödeyen parasını geri alır ve uygulama bunu söyler. 'framework' adaptörüyle her meslek için cutSender = 0 ayarla.
Fatura ödendiğinde çevrimdışı olan bir çalışan, payını framework'ün çevrimdışı para sistemiyle (QBCore, Qbox, ESX) alır. Bunun mümkün olmadığı yerde pay tutulur ve bir sonraki girişinde ödenir.
#Seçenekler
| Seçenek | Varsayılan | Ne yapar |
|---|---|---|
EveryoneCanSend |
true |
Herhangi bir oyuncu kişisel fatura gönderebilir. Yönetim tableti bunu sunucu çalışırken değiştirebilir |
GradeShare |
{ Base = 20, PerGrade = 5, Max = 50 } |
cutReceiver = 'grade' olan meslekler için çalışanın rütbeye göre payı |
Jobs |
örnek bir liste | Şirket adına fatura kesebilen meslekler ve paylaşım. Sunucunun mesleklerine göre ayarla |
Config.Retention.invoices |
90 |
Ödenmiş ya da iptal edilmiş bir faturanın saklandığı gün sayısı. Ödenmemiş faturalar borçtur ve temizlik tarafından asla silinmez |
#fx-billingapp
Paketle gelen Billing uygulaması (fx-billingapp, bkz. Config.BundledApps) çalışırken, telefonun kendi Faturalar simgesi Ana Ekran'dan kalkar; böylece oyuncular iki fatura uygulaması görmez. Faturaların kendisi kalır: Banka faturaları ve istekleri listelemeye devam eder, script'ler de fx-phone'un export'larıyla fatura kesmeye devam eder. Telefonun kendi Faturalar uygulamasını tutmak için Config.BundledApps içinde ['fx-billingapp'] = false ayarla.
#3. Kripto
Banka'nın Kripto sekmesi, oyuncuların gerçek coinleri canlı fiyatlarla almasını, satmasını ve göndermesini sağlar.
- Fiyatlar CoinGecko'dan gelir; server bunları bütün sunucu için
RefreshMinutesdakikada bir, ayarladığınCurrencycinsinden çeker. Her telefon yeni fiyatları hemen alır. - CoinGecko'ya ulaşılamazsa bilinen son fiyat kalır. İlk canlı fiyattan önce ve canlı fiyatlar kapalıyken her zaman config'teki
pricekullanılır. - Alım, maliyeti tam birime yukarı yuvarlayarak bankadan alır. Satış bankaya aşağı yuvarlanmış tutarı öder.
- Coinler başka bir oyuncuya telefon numarası ya da IBAN ile gönderilebilir. Alıcı bir bildirim alır.
#Coinler
luaCoins = {
{ id = 'bitcoin', symbol = 'BTC', name = 'Bitcoin', price = 65000, canBuy = true, canSell = true, canTransfer = true },
...
},
| Alan | Ne yapar |
|---|---|
id |
Coinin CoinGecko id'si (bitcoin, ethereum, litecoin, …) |
symbol, name |
Oyuncunun gördüğü |
price |
İlk canlı fiyat gelene kadar ve canlı fiyatlar kapalıyken her zaman kullanılır |
icon |
İsteğe bağlı https:// görsel |
canBuy, canSell, canTransfer |
Bu coin için her işlemi ayrı ayrı kapatır |
Script'ler fiyatını kendileri yönettikleri bir coin ekleyebilir (AddCustomCoin) ve coin verip alabilir: bkz. Server export'ları: kripto.
#Seçenekler
| Seçenek | Varsayılan | Ne yapar |
|---|---|---|
Currency |
'usd' |
CoinGecko fiyat para birimi, küçük harfle (lira için 'try') |
RefreshMinutes |
30 |
İki fiyat çekimi arasındaki dakika. Ücretsiz API'de 5 veya üstünde tut |
Coins |
BTC, ETH, LTC | Satıştaki coinler |
config_server.lua içinde ServerConfig.Crypto.CoinGecko canlı fiyatları açar ya da kapatır, ServerConfig.Crypto.ApiKey ise isteğe bağlı bir CoinGecko demo anahtarı alır. Varsayılan aralıkta anahtarsız API yeterlidir.
#4. Coin Lab
Coin Lab (uygulama id'si coins, varsayılan olarak yüklü gelmez) oyuncuların kendi coinlerini çıkarmasını ve alıp satmasını sağlar.
- Coin çıkarmak bankadan
LaunchPricetutar. Oyuncu bir ad, 3 ile 6 harf arası bir kısaltma (ticker), bir simge ve bir renk seçer. Bir kısaltma yalnızca bir kez var olabilir. - Fiyat arzı izler. Fiyat =
BasePrice+Stepx dolaşımdaki coin sayısı. Her alım fiyatı yükseltir, her satış düşürür. - Para yaratılmaz. Alıcıların ödediği para coinin rezervine gider, satıcılara da oradan ödenir.
- Her alım ve satışta
Feeoranında bir komisyon alınır. Alımın komisyonu ekonomiden çıkar; satışın komisyonu coinin rezervinde kalır ve hâlâ elde tutulan coinlere karşılık olur. Çıkarma ücreti de ekonomiden çıkar. - Coinler Popüler (piyasa değeri), Yeni ve Hacim'e göre listelenir; her birinin fiyatı, son haftası küçük bir çizgi olarak ve o haftaki değişimi gösterilir.
#Oyuncu ne görür
| Ekran | Üzerinde ne var |
|---|---|
| Ana sayfa | Portföy değerini ve toplam açık kâr/zararı gösteren bir cüzdan kartı, Coinlerim (coin başına miktar, değer ve kâr/zarar) ve piyasa listesi |
| Bir coin | 1 saat, 1 gün, 1 hafta, 1 ay ya da çıkarıldığından beri fiyat grafiği (herhangi bir anın fiyatı ve saati için imleci üzerine getir), Pozisyonum, coinin istatistikleri, oyuncunun o coindeki tarihli kendi işlemleri ve Al / Sat |
| Al / Sat | Emir verilmeden önce server tarafından fiyatlandırılır: toplam, coin başına ortalama, geride bıraktığı fiyat ve satışta kayıtlı maliyete karşı ne kazandırdığı |
| Portföyüm | Portföyün zaman içindeki değeri, maliyet, açık ve gerçekleşmiş kâr/zarar, değerin eldeki coinlere nasıl dağıldığı |
| Geçmiş | Karakterin her alımı, satışı ve coin çıkarması, tarih ve saatiyle, güne göre gruplanmış; satış ne kazandırdığını gösterir |
#Rakamlar nasıl hesaplanır
- Değer, elindeki coinlerin tamamını şu anda satmanın komisyon düşüldükten sonra ödeyeceği tutardır. Fiyat çizgisinde büyük bir sahip satarken fiyatı düşürür; bu yüzden "fiyat x coin" kimsenin alamayacağı bir para vaat ederdi.
- Maliyet, elde tutulan coinler için bankadan çıkan paradır, komisyonlar dahil. Ortalama maliyet bunun, karşılığında ödenen coin sayısına bölünmüş halidir.
- Açık kâr/zarar değer eksi maliyettir. Gerçekleşmiş kâr/zarar, şimdiye kadarki tüm satışların ödediği tutardan satılan coinlerin maliyeti çıkarılarak bulunur. Bir satış maliyetten kendi payını beraberinde götürür; bu yüzden geriye kalanın ortalama maliyeti değişmez.
- Grafikler işlemlerden çizilir: fiyat yalnızca coin alınıp satıldığında hareket eder ve her işlem geride bıraktığı fiyatı saklar. Arada hiçbir şey saklanmaz ya da uydurulmaz; bu yüzden durgun bir coin düz bir çizgi gösterir.
- Bu takip başlamadan önce alınan coinlerin (güncellemeden önce var olan miktarların) kayıtlı bir maliyeti yoktur. Uygulama bir maliyet uydurmak yerine bunu söyler: değerleri gösterilir, kâr/zararları gösterilmez ve satılmaları kâr yazmaz. Sonradan aynı miktara eklenen coinler normal şekilde takip edilir. Eski işlemler Geçmiş'te de yoktur, çünkü onları kimin yaptığı saklanmamıştı.
#Seçenekler
| Seçenek | Varsayılan | Ne yapar |
|---|---|---|
Enabled |
true |
false Coin Lab'i kapatır: simge kalkar ve alım satım dahil her istek reddedilir. Coinler ve miktarlar saklanır, yeniden açıldığında geri gelir |
LaunchPrice |
500 |
Bir coin çıkarmanın ücreti |
BasePrice |
1.0 |
İlk coinin fiyatı |
Step |
0.01 |
Dolaşımdaki her coin için fiyatın ne kadar arttığı |
Fee |
0.02 |
Her alım ve satıştan alınan pay (%2). En fazla 0.2; daha yüksek değerler buna indirilir |
MaxPerPlayer |
2 |
Bir karakterin çıkarabileceği coin sayısı |
MaxTrade |
5000 |
Tek bir emirdeki coin sayısı |
#Export'lar
| Sayfa | Export'lar |
|---|---|
| Server export'ları: banka | AddTransaction GetBankData SetBankData |
| Server export'ları: faturalar | AddInvoice GetInvoices DeleteInvoice |
| Server export'ları: kripto | AddCrypto RemoveCrypto GetOwnedCoin GetCoin AddCustomCoin |
| Client export'ları: diğer | GetCryptoWallet GetCoinValue |
#Bilmekte fayda var
- Çevrimdışı bir oyuncuya havale "offline" hatasıyla başarısız oluyor. Framework'te çevrimdışı para sistemi yok (standalone ya da
AddOfflineMoney'yi doldurmayan özel bir bridge). Gönderen parasını geri alır. - Şirket faturasını ödemek başarısız oluyor. Banka adaptöründe o meslek için hesap yok. Meslek hesapları olan bir adaptör kullan ya da
cutSender = 0ayarla. - Hesaplar sekmesinde meslek hesabı yok. Oyuncunun rütbesi patron rütbesi değil,
Accounts.JobAccount = falseya da adaptörde o meslek için hesap yok. - "Yeni Hesap Aç" görünmüyor. tgiann-bank çalışıyor (onun yerine kendi hesapları gösterilir) ya da
Accounts.Enabled = false. - En Yakın ATM hiçbir şey bulmuyor. Yalnızca oyunun oyuncunun çevresinde yüklediği
AtmModelsmodellerindeki prop'ları görür; bu yüzden kırsalda hiçbir şey bulamaz. Prop'u olmayan ya da başka modelde olan bir ATM asla bulunmaz: kendi ATM prop modelleriniAtmModels'e ekle. - Ödenmemiş faturalar asla silinmez. Bilerek böyle: ödenmemiş fatura borçtur. Yalnızca ödenmiş ve iptal edilmiş olanlar
Config.Retention.invoicesgün sonra kaldırılır. Gönderen eski bir faturayı iptal edebilir. Jobslistesinden çıkarılan bir mesleğin eski ödenmemiş faturaları durur. Birini ödemek tutarın tamamını meslek hesabına gönderir.- Her para hareketi karakter başına bir kilit tutar; böylece aynı karakter için iki hareket asla aynı anda çalışmaz. Bu sırada gelen ikinci hareket reddedilir ve yeniden denenebilir.