Yapılandırma

Finans uygulamaları

Banka, Hesap Defteri (billing), Borsa Bülteni (borsa) ve İşletme (company) ayarları; banka adaptörleri ve işletme kasası dahil.

Her tutarın birimine dikkat et. Banka tutarları cent cinsindendir (100 = 1 dolar). Hesap Defteri, İşletme ve Borsa Bülteni tutarları dolar cinsindendir.

#Banka: apps/bank/config.lua

Banka script'ine bağlantı framework/frameworks.lua (FXBank) içinde.

Ayar Varsayılan Ne yapar
Enabled true Banka uygulaması
Mode 'auto' 'auto', 'vorp', 'rsg', 'internal' ya da 'custom'. Auto: VORP ve vorp_banking başlamışsa 'vorp', RSG ve rsg-banking başlamışsa 'rsg', aksi hâlde 'internal'
RequireSignal true Yatırma, çekme ve havale sinyal ister
CashInTown.Enabled true Nakit yatırma ve çekme yalnızca kasabada. Server oyuncunun gerçek konumuna bakar. Havale ve para istekleri her yerde çalışır. false: her yerde
CashInTown.Radius 220 Kasaba merkezinden metre; kasabanın kendi radius'u yoksa
CashInTown.Towns 9 kasaba { town = 'Valentine', coords = vector3(-308.0, 773.8, 118.7) }. Saint Denis radius = 480, Blackwater radius = 260. Merkezleri haritana göre düzelt
MaxAmount 10000000 İşlem başına en fazla, cent ($100.000)
HistoryLimit 20 Gösterilen son işlemler, 1 ile 100 arası
Transfer.Enabled false Defterden havale; hesap numarası, telgraf adresi ya da karakter kimliğiyle
Transfer.MaxNote 80 Havale notu uzunluğu
Transfer.Limit nil Havale başına en fazla, cent. nil MaxAmount kullanır. Örnek: 50000 $500'dür
LedgerLimit 100 Hesap defteri sayfasında bir hesap için gösterilen satır, 10 ile 300 arası
ShowNames true Hesap numarası ya da adres yazılınca alıcının adı gösterilir. false: "gizli hesap" uyarısı
Accounts.Enabled true Ek hesaplar: birikim ve ortak
Accounts.MaxOwn 3 Bir karakterin açabileceği ek hesap
Accounts.MaxMembers 5 Ortak hesaptaki kişi, sahibi dahil
Accounts.MaxName 30 Hesap adı uzunluğu
Accounts.Job true İşletme kasasını görme yetkisi olan oyunculara meslek hesabı kartı gösterilir
Requests.Enabled true Para istekleri
Requests.MaxOpen 5 Karakter başına bekleyen istek
Requests.MaxNote 80 İstek notu uzunluğu
Requests.Cooldown 10 İki istek arası saniye
Branches 5 şube "En yakın şube" listesi ve Atlas rotası için { town, coords, hours }. Boş: şube düğmesi gizlenir
Internal.Name 'Defter Bankasi' 'internal' modunda banka adı
Vorp.Branch 'Valentine' vorp_banking her şube için ayrı hesap tutar. Defter bunu kullanır (bank_users.name, vorp_banking'in Config.banks anahtarı)
Vorp.Label nil Gösterilen ad. nil: '<Branch> Bankasi'
Vorp.CreateAccount true Karakterin o şubede hesabı yoksa ilk yatırma vorp_banking varsayılanlarıyla bir hesap açar
Rsg.Branch 'home' rsg-banking 3.x: 'home' oyuncunun seçtiği şubedir; ya da 'valentine' gibi sabit bir şube
Rsg.Labels 5 ad Şube başına gösterilen ad

'internal', bakiyeleri defterin kendi fx_pocketbook_bank tablosunda tutar. Şube export'ları olmayan eski rsg-banking, RSG-Core bank parasına düşer (yalnızca çevrimiçi oyuncular). Başka bir banka script'i için Mode = 'custom' yap ve framework/frameworks.lua içindeki custom adaptörünü doldur; yorumları her fonksiyonu ve ne döndürmesi gerektiğini listeler.

#Hesap Defteri: apps/billing/config.lua

Ayar Varsayılan Ne yapar
Enabled true Hesap Defteri uygulaması
AllowPersonalSend false Oyuncular kendi adlarına fatura kesebilir
AllowPersonalReceive true Oyuncular kendi adlarına fatura alabilir
AllowCreateUI true Uygulamada fatura kesilebilir. false: yalnızca export'larla
MaxAmount 100000 En büyük fatura, dolar
MinDescription, MaxDescription 8, 240 Açıklama uzunluğu
MaxDetails 3000 Ayrıntı metni uzunluğu
MaxInstallments 24 En fazla taksit
MaxPeriodDays 365 Taksitler arasındaki en uzun süre
MaxRecurringDays 365 En uzun tekrar süresi
PageSize 12 Sayfa başına fatura
NearbyDistance 5.0 Alıcı bu kadar yakında olmalı
EnforceNearby true Fatura kesilirken NearbyDistance kontrol edilir
PickerDistance 15.0 Bu kadar yakındaki oyuncular seçicide ad etiketi alır; yalnızca NearbyDistance içindekiler seçilebilir
DuplicateWindowSeconds 120 Aynı fatura (kesen, hesaplar, tutar, açıklama) bu süre içinde yeniden reddedilir. 0: kapalı
CompanySend 'member' İşletme adına kimin fatura kesebileceği
CompanyManage 'boss' İşletmenin faturalarını kimin yönetebileceği
JobPermissions {} Meslek başına: { sheriff = { send = 2 } }
Blacklisted {} Meslek başına: { sheriff = { send = true } } o eylemi engeller
Commission {} Meslek başına: { sheriff = { [2] = 0.05, all = 0.02 } }. İşletme faturalarındaki oran; fatura kesilince sabitlenir
MaxAttachments 3 Fatura başına görsel bağlantısı
ImageHosts {} Boş: herhangi bir herkese açık HTTPS alan adı. Server bunları asla indirmez
MaxBulkCancel 50 Bir kerede iptal edilen fatura
AllowProfiles true Hesap görselleri
Penalty.Enabled false Vadesi geçen faturalara gecikme ücreti
Penalty.InitialPercent, HourlyPercent, MaxPercent 10, .5, 100 Gecikme ücreti: başlangıç %'si artı gecikilen her saat için %, en fazla üst sınıra kadar
SweepInterval 60000 Zamanlanmış faturaları açan ve gecikme ücreti ekleyen kontroller arasındaki ms
Enforcement.Enabled true unpaid export'u ödenmemiş faturası olan bir karakter için blocked = true bildirir; diğer script'ler buna göre davranır
Enforcement.GraceMinutes 30 Bundan yeni faturalar sayılmaz
Collection.Enabled false Vadesi geçen faturaları kendiliğinden tahsil et. Asla eksiye düşürmez, çevrim dışı framework satırlarını asla düzenlemez
Collection.IntervalSeconds 3600 Bir faturada iki tahsilat denemesi arasındaki saniye
Collection.GraceMinutes 60 Vadeden sonra tahsilata kadar geçen dakika
Collection.MaxPerRun 1000 Deneme başına en fazla alınan, dolar
Collection.Reserve 0 Ödeyende her zaman bırakılan dolar
Collection.Companies false İşletmelere kesilen faturaları da tahsil et. Kişisel faturalar yalnızca çevrimiçi oyunculardan tahsil edilir
Hooks.Sent, Hooks.Paid, Hooks.Cancelled boş fonksiyonlar Server'da çağrılır: Sent(src, id), Paid(src, id, amount), Cancelled(src, id)

Yetki değerleri (CompanySend, CompanyManage, JobPermissions): 'member' işletmedeki herkes, 'boss' Config.Company.Jobs'taki bossGrade ve üstü, bir sayı o rütbe ve üstüdür. Yalnızca Config.Company.Jobs içinde listelenen meslekler işletme olarak fatura kesebilir.

#apps/billing/config_server.lua

Ayar Varsayılan Ne yapar
API.AllowedResources {} Hesap Defteri export'larını çağırabilen resource'lar: { ['my-script'] = true }. Boş: hiçbirine izin yok
API.AllowDistanceOverride false İzinli bir resource'un kestiği faturalar mesafe kontrolünü atlar
API.MaxRequests, API.WindowSeconds 30, 10 Resource ve oyuncu başına hız sınırı
API.MaxPayloadBytes 16384 En büyük istek
Logs Bkz. config_server.lua

#Borsa Bülteni: apps/borsa/config.lua

Fiyatları server üretir. Para Config.MoneyAccount'tan alınır ve oraya ödenir.

Ayar Varsayılan Ne yapar
Enabled true Uygulama
RequireSignal false true: alım satım sinyal ister. Fiyatlara bakmak her zaman serbest
City, Year 'Saint Denis', 1899 Bülten başlığı. Gün ve ay gerçek tarihtir
TickMinutes 5 Fiyat değişimleri arasındaki dakika. En az 1
Commission 1.0 Her alım ve satımda kesilen %. 0: yok
MaxPerTrade 100 Tek alımda en fazla hisse
MaxSharesPerCompany 500 Bir oyuncunun bir şirkette tutabileceği en fazla hisse. 0: sınırsız
TradeCooldown 2 İki alım satım arası saniye
MinFactor, MaxFactor 0.35, 3.0 Fiyat başlangıç fiyatının bu katları arasında kalır
MaxMovePerTick 3.0 Bir adımdaki en büyük % değişim
Revert 0.0003 Her adımda başlangıç fiyatına doğru çekim. 0: yok
Companies 8 şirket Aşağıya bak
News.Enabled true Haberler sekmesi
News.BigMove 4.0 Gün içinde bu %'den fazla oynayan bir hisse için kısa bir otomatik haber yazılır. 0: kapalı
News.Headlines 6 haber Kendi haberlerin: company, title, sum, body, isteğe bağlı img (train, mine, cattle, theatre, fair, sheriff, fishing, caravan) ve hours (haberin yaşı). İlki büyük gösterilir

Bir şirket:

lua{ id = 'SDD', name = 'Saint Denis Demiryolu', sector = 'Demiryolu', icon = 'train', color = 'blue',
  price = 48.25, volatility = 0.012, drift = 0.5, hq = 'Saint Denis', dividend = 1.2,
  text = 'Lemoyne ile New Hanover arasinda yolcu ve yuk tasir. ...' },
Alan Ne
id 2 ile 6 arası büyük harf. Asla değiştirme: oyuncuların hisseleri buna bağlıdır
price Başlangıç fiyatı
volatility 0.005 sakin, 0.03 çok oynak
drift -1 düşüş, 0 nötr, 1 yükseliş
dividend Yalnızca gösterilir, asla ödenmez
color blue, green, red, ochre, plum, teal

Oyuncuların elinde hissesi varken bir şirketi silme: hisseler artık satılamaz.

#İşletme: apps/company/config.lua

Ayar Varsayılan Ne yapar
Enabled true Uygulama
UnemployedJob 'unemployed' Kovulan çalışana verilen meslek
HireDistance 5.0 Bu kadar yakındaki oyuncular işe alınabilir
MaxAmount 100000 En büyük kasa yatırma ya da çekme, dolar
HistoryLimit 50 Kasa geçmişinin sayfa başına satırı, 5 ile 50 arası
MaxAnnouncement 500 Duyuru uzunluğu
AnnounceCooldown 30 Bir işletmenin iki duyurusu arası saniye
StartingGrade 0 Yeni çalışanın rütbesi. Bir meslek startingGrade ile bunu geçersiz kılabilir
OfflineChanges.Enabled true Çevrim dışı çalışanlar için işe alma, kovma ve rütbe değişiklikleri kuyruğa alınır ve uygulanır
OfflineChanges.PollInterval 5000 Kuyruk çalıştırmaları arasındaki ms
OfflineChanges.BatchSize 50 Çalıştırma başına değişiklik, 1 ile 100 arası
Payroll {} Meslek ve rütbe başına, maaş dönemi başına dolar. Yalnızca gösterilir
InvoiceShare { default = 0, min = 0, max = 80, step = 5, commissionTo = 'wallet' } İşletme faturalarından çalışan payı. Patron yüzdeyi uygulamada min ile max arasında ayarlar. Fatura üzerinde sabitlenir. commissionTo = 'wallet': pay çalışanın cüzdanında bekler; 'bank': hemen çalışanın parasına ödenir (çevrim dışıyken cüzdanda kalır)
WithdrawReason true Kasadan para çekmek kısa bir "ne için" satırı ister
Jobs Kanun meslekleri ve newspaper örnekleri İşletmeler. Framework mesleklerinle eşleştir
Permissions aşağıya bak Kimin neyi yapabileceği
JobPermissions {} Meslek başına Permissions geçersiz kılmaları
ProtectHigherRanks true Kimse eşit ya da daha yüksek rütbeli bir çalışanı değiştiremez
luaJobs = {
    -- VORP kanun meslekleri
    sheriff = { label = 'Şerif Dairesi', bossGrade = 4, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli', [3] = 'Başyardımcı', [4] = 'Şerif' } },
    deputy = { label = 'Şerif Yardımcıları', bossGrade = 2, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli' } },
    marshal = { label = 'Federal Marshal', bossGrade = 2, grades = { [0] = 'Marshal yardımcısı', [1] = 'Marshal', [2] = 'Baş marshal' } },
    police = { label = 'Saint Denis Polisi', bossGrade = 3, grades = { [0] = 'Polis', [1] = 'Komiser yardımcısı', [2] = 'Komiser', [3] = 'Emniyet müdürü' } },
    -- RSG kanun meslekleri: rsg-core bunları tanımlamaz; kendi shared/jobs.lua dosyandaki rütbe numaralarını kullan
    vallaw = { label = 'Valentine Şerifliği', bossGrade = 3, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli', [3] = 'Şerif' } },
    rholaw = { label = 'Rhodes Şerifliği', bossGrade = 3, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli', [3] = 'Şerif' } },
    blklaw = { label = 'Blackwater Polisi', bossGrade = 3, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli', [3] = 'Şef' } },
    strlaw = { label = 'Strawberry Şerifliği', bossGrade = 3, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli', [3] = 'Şerif' } },
    stdenlaw = { label = 'Saint Denis Polisi', bossGrade = 3, grades = { [0] = 'Memur', [1] = 'Yardımcı', [2] = 'Kıdemli', [3] = 'Şef' } },
    newspaper = { label = 'Gazete Dairesi', bossGrade = 3, grades = { [0] = 'Muhabir', [1] = 'Yazar', [2] = 'Editör', [3] = 'Müdür' } },
},
Permissions = { hire = 'boss', fire = 'boss', setGrade = 'boss', deposit = 'member', withdraw = 'boss', announce = 'boss',
    history = 'boss', balance = 'member', postalRead = 'member', postalSend = 'member', postalManage = 'boss',
    postalWork = 'member', postalDoors = 'member', shareManage = 'boss' },

Değerler: 'member', 'boss' (bossGrade ve üstü) ya da bir rütbe numarası. postal* yetkileri Telgraf'taki postane işletmeleri içindir. shareManage fatura payını ayarlar.

Jobs içindeki her meslek kendi kasası olan bir işletmedir. Resmi Defter cezaları memurun işletmesinin faturası olarak kesilir; bu yüzden ceza kesen her kanun mesleği burada olmalı. rsg-core RSG kanun mesleklerini tanımlamaz; kendi shared/jobs.lua dosyandaki rütbe numaralarını kullan.

#apps/company/config_server.lua

Treasury.Bindings, bir işletme kasasını başka bir script'in SQL tablosundaki bir hesap satırına bağlar; defter kendi kasası yerine o bakiyeyi okur ve yazar. Yalnızca bakiyesi SQL'de duran bankalar için; bakiyeyi bellekte ya da export arkasında tutan bir bankayı asla bağlama.

luaTreasury = { Bindings = {
    ['company:vorp:sheriff'] = { Table = 'my_society', KeyColumn = 'job', BalanceColumn = 'money',
        Key = 'sheriff', Unit = 'dollars', Resource = 'my_society_script' },
} },
Alan Ne
anahtar company:vorp:<meslek> ya da company:rsg:<meslek>
Table, KeyColumn, BalanceColumn Tablo ve sütunlar. Bir fx_pocketbook_* tablosu olamaz
Key Satırın anahtar değeri
Unit 'cents' ya da 'dollars'
Resource Tablonun sahibi olan script. Başlamış olmalı

İki işletme aynı satıra bağlanamaz. Bir bağlantı ilk kullanıldığında fx_pocketbook_treasury_bindings tablosuna kaydedilir ve silinen bir kayıt satırını başka bir işletmeye bırakmaz. pocketbook_health bağlantıları kontrol eder.