Ö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 RefreshMinutes dakikada bir, ayarladığın Currency cinsinden ç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 price kullanı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 LaunchPrice tutar. 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 + Step x 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 Fee oranı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 = 0 ayarla.
  • Hesaplar sekmesinde meslek hesabı yok. Oyuncunun rütbesi patron rütbesi değil, Accounts.JobAccount = false ya 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 AtmModels modellerindeki 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 modellerini AtmModels'e ekle.
  • Ödenmemiş faturalar asla silinmez. Bilerek böyle: ödenmemiş fatura borçtur. Yalnızca ödenmiş ve iptal edilmiş olanlar Config.Retention.invoices gün sonra kaldırılır. Gönderen eski bir faturayı iptal edebilir.
  • Jobs listesinden çı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.