Para ve bankacılık
İki hesap arasında money.transfer, ai-core üzerinden banka script’i ve hangi fatura script’i çalışıyorsa onun üzerinden faturalar.
import { money, banking, billing } from "@aicore8/lib/server";money, sunucudaki her bakiyedir: yüklü bir oyuncunun hesapları, bir mesleğin ya da çetenin ortak hesabı, parayı tek transaction'da taşıyan bir transfer ve defter. Bağlı olmayan bir karakter characters ile yapılır. banking ve billing, sunucunun banka ve fatura script'leri için katmanlardır.
money
money.get
Yüklü bir oyuncunun tek bir hesaptaki bakiyesi.
Taraf: Server · Bekler: hayır
money.get(source: number, account: string): number | nulllocal balance = aiLib.money.get(source, account)Parametreler
Prop
Type
Dönüş değeri
number | null: bakiye ya da oyuncunun yüklü karakteri yoksa / hesap tipi yoksa null. Kayıtlı bir karakterin bakiyeleri characters.get ile gelir.
Örnek
import { money, notify } from "@aicore8/lib/server";
export function tellBalance(source: number): void {
const bank = money.get(source, "bank");
notify(source, bank === null ? "Karakter yok" : `Banka: $${bank}`, bank === null ? "error" : "inform");
}money.add, money.remove and money.set
Yüklü bir oyuncunun tek bir hesabını defter satırıyla değiştirir. Bir ödül, bir fiyat, script'inin ödediği bir maaş için çağrılar bunlardır.
Taraf: Server · Bekler: hayır
money.add(source: number, account: string, amount: number, reason?: string): boolean
money.remove(source: number, account: string, amount: number, reason?: string): boolean
money.set(source: number, account: string, amount: number, reason?: string): booleanlocal ok = aiLib.money.add(source, account, amount, reason)
local ok = aiLib.money.remove(source, account, amount, reason)
local ok = aiLib.money.set(source, account, amount, reason)Parametreler
Prop
Type
Dönüş değeri
boolean: değişiklik yapıldıysa true. Oyuncunun yüklü karakteri yoksa, hesap yoksa, miktar 0’dan büyük tam sayı değilse ya da - remove için - bakiye ödemeye yetmiyorsa (hesap tipi sıfırın altına inemiyorsa) false.
Örnek
import { money, onClientCallback } from "@aicore8/lib/server";
import { fail } from "@aicore8/lib/shared";
onClientCallback("myshop:buyTools", { lock: true }, (source) => {
if (!money.remove(source, "cash", 150, "shop:tools")) return fail("NOT_ENOUGH_CASH");
// eşyayı burada ver
return { ok: true };
});Bir oyuncudan diğerine ödeme bir remove artı bir add değildir: ortada bir hata para yaratır ya da yok eder. Tek bir veritabanı transaction'ı olan money.transfer kullan.
money.sharedGet
Bir mesleğin ya da çetenin hesabındaki bakiye - bank, diğer framework'lerin society parası dediği şeydir.
Taraf: Server · Bekler: hayır
money.sharedGet(type: "job" | "gang", id: string, account: string): number | nulllocal balance = aiLib.money.sharedGet(type, id, account)Parametreler
Prop
Type
Dönüş değeri
number | null: bakiye ya da o meslek / çetede böyle bir hesap yoksa null (bilinmeyen bir meslek ya da sunucuda olmayan bir hesap tipi).
money.sharedAdd and money.sharedRemove
Bir mesleğin ya da çetenin hesabını defter satırıyla değiştirir - bir şirketin geliri ve gideri.
Taraf: Server · Bekler: hayır
money.sharedAdd(type: "job" | "gang", id: string, account: string, amount: number, reason?: string): boolean
money.sharedRemove(type: "job" | "gang", id: string, account: string, amount: number, reason?: string): booleanlocal ok = aiLib.money.sharedAdd(type, id, account, amount, reason)
local ok = aiLib.money.sharedRemove(type, id, account, amount, reason)Dönüş değeri
boolean: değişiklik yapıldıysa true; bilinmeyen meslek ya da çete, olmayan hesap, hatalı miktar veya ödemeye yetmeyen hesap için false.
Örnek
import { money } from "@aicore8/lib/server";
/** Tamirci dükkânının kazandığı bir şehir sözleşmesi ve parçalar için ödediği ücret. */
export function contractDone(job: string, pay: number, parts: number): boolean {
if (!money.sharedAdd("job", job, "bank", pay, "city contract")) return false;
return money.sharedRemove("job", job, "bank", parts, "parts");
}money.transfer
Parayı tek bir veritabanı transaction’ında, iki tarafta da bir defter satırıyla bir hesaptan diğerine taşır. Paranın yarı yolda ortaya çıkmaması ya da kaybolmaması gereken her şey için kullan: başka bir oyuncuya ödeme, bir mesleğin prim ödemesi, bir ücret.
Taraf: Server · Bekler: hayır
money.transfer(from: MoneyRef, to: MoneyRef, amount: number, reason?: string, fee?: number): booleanlocal ok = aiLib.money.transfer(from, to, amount, reason, fee)Parametreler
Prop
Type
Dönüş değeri
boolean: iki satır da yazıldıysa true. Bir miktar tam sayı değilse, bir hesap yoksa, ikisi aynıysa ya da from amount artı fee’yi ödeyemiyorsa false.
Örnek
import { onClientCallback, money, nearestPlayerTo, notify } from "@aicore8/lib/server";
import { fail, oneArg, readInt } from "@aicore8/lib/shared";
onClientCallback("my-cash:give", { args: oneArg((v) => readInt(v, 1, 100_000)), lock: true }, (source, amount) => {
const target = nearestPlayerTo(source, 2);
if (target === null) return fail("NOBODY_NEAR");
if (!money.transfer({ source, account: "cash" }, { source: target, account: "cash" }, amount, "give:cash"))
return fail("NOT_ENOUGH_CASH");
notify(target, `You received $${amount}`, "success");
return { ok: true };
});money.history
Bir hesabın defter satırları, en yeni başta: ne hareket etti, sonraki bakiye, sebep, kim yaptı ve ne zaman. Bir oyuncunun hesabı, bir mesleğin / çetenin hesabı ve kayıtlı bir karakterin hesabı için çalışır.
Taraf: Server · Bekler: evet
money.history(account: LedgerRef, query?: LedgerQuery): Promise<LedgerPage>local page = aiLib.money.history(account, query)Parametreler
Prop
Type
Dönüş değeri
Bir LedgerPage: rows ve before olarak göndereceğin next (son sayfada null). ai-core bir satırı değişiklikten bir an sonra yazar, yani en yeni satır bakiyenin birkaç milisaniye gerisinde olabilir.
Örnek
import { money } from "@aicore8/lib/server";
/** Kayıtlı bir karakterin son 20 banka satırı. */
export async function statement(charId: number) {
const page = await money.history({ owner: "character", id: String(charId), account: "bank" }, { limit: 20 });
return page.rows.map((r) => `${r.at}: ${r.amount} (${r.reason})`);
}banking
banking, ai-core’un bankacılık katmanı üzerinden banka script’iyle konuşur. Meslek parasının kendisi her zaman money ya da ai-core’un export’ları üzerinden hareket eder.
banking.open
Banka script’inin ekranını bir oyuncu için açar.
Taraf: Server · Bekler: hayır
banking.open(source: number): booleanlocal ok = aiLib.banking.open(source)Dönüş değeri: açıldıysa true. Script dışarıdan açılamıyorsa ya da hiçbiri çalışmıyorsa false.
onClientCallback("my-atm:open", (source) => (banking.open(source) ? { ok: true } : fail("BANK_UNAVAILABLE")));banking.societyBalance
Görüntülemek için bir mesleğin şirket (society) bakiyesi. ai-core’un core hesap modunda ai-core’un meslek hesabıdır; own modunda banka script’inin kendi hesabı.
Taraf: Server · Bekler: hayır
banking.societyBalance(job: string): number | nulllocal balance = aiLib.banking.societyBalance(job) -- number ya da nilDönüş değeri: bakiye ya da hiçbiri çalışmıyorsa veya script bakiye tutmuyorsa null (Lua’da nil).
const balance = banking.societyBalance("mechanic") ?? 0;banking.provider
Taraf: Server · Bekler: hayır
banking.provider(): string | nulllocal name = aiLib.banking.provider()Dönüş değeri: katmanın kullandığı banka script’i ya da null.
console.log(`banking through ${banking.provider() ?? "nothing"}`);billing
billing, faturaları hangi fatura script’i çalışıyorsa onun üzerinden gönderir; hiçbiri yoksa ai-core’un kendi faturaları kullanılır (oyuncu ekrandaki bir listeden öder, para o ödediğinde hareket eder). Metinler zaten çevrilmiş haldedir.
billing.send
Bir meslekten (cezalar, hizmet ücretleri) ya da bir oyuncudan fatura gönderir.
Taraf: Server · Bekler: hayır
billing.send(bill: BillRequest): booleanlocal ok = aiLib.billing.send(bill)BillRequest
Prop
Type
Dönüş değeri
boolean: gönderildiyse true, geçersizse ya da reddedildiyse false.
Örnek
import { billing, nearestPlayerTo, online } from "@aicore8/lib/server";
import { fail } from "@aicore8/lib/shared";
function fine(officer: number, amount: number) {
if (!online.onDutyIn(officer, ["police"])) return fail("NOT_ON_DUTY");
const target = nearestPlayerTo(officer, 3);
if (target === null) return fail("NOBODY_NEAR");
return billing.send({ to: target, amount, label: "Speeding", from: officer, job: "police" })
? { ok: true }
: fail("BILL_FAILED");
}billing.unpaid
Oyuncunun açık faturaları.
Taraf: Server · Bekler: evet (TypeScript’te Promise, Lua’da thread’i yield eder)
billing.unpaid(source: number): Promise<UnpaidBill[] | null>local bills = aiLib.billing.unpaid(source) -- table[] ya da nil, bir thread içinde çağırDönüş değeri: UnpaidBill[] (id, label, hâlâ borçlu olunan amount, sender) ya da fatura script’i onları listeleyemiyorsa null.
const bills = await billing.unpaid(source);
const owed = bills?.reduce((sum, bill) => sum + bill.amount, 0) ?? 0;billing.pay
Oyuncu açık faturalarından birini öder.
Taraf: Server · Bekler: hayır
billing.pay(source: number, id: string): booleanlocal ok = aiLib.billing.pay(source, id)Prop
Type
Dönüş değeri: ödendiyse true. Reddedildiyse (yetersiz para, bilinmeyen fatura) ya da fatura script’i ödemeleri yalnızca kendi ekranında alıyorsa false.
if (!billing.pay(source, billId)) return fail("PAY_FAILED");billing.provider
Taraf: Server · Bekler: hayır
billing.provider(): string | nulllocal name = aiLib.billing.provider()Dönüş değeri: faturaların gittiği fatura script’i; ai-core’un kendi faturaları için "ai-core".
if (billing.provider() === "ai-core") console.log("using ai-core's own bills");