AI Core
API başvurusuLib: server

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.

TypeScript
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

İmza
money.get(source: number, account: string): number | null
Lua
local 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

İmza
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): boolean
Lua
local 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

İmza
money.sharedGet(type: "job" | "gang", id: string, account: string): number | null
Lua
local 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

İmza
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): boolean
Lua
local 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

Signature
money.transfer(from: MoneyRef, to: MoneyRef, amount: number, reason?: string, fee?: number): boolean
Lua
local 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

İmza
money.history(account: LedgerRef, query?: LedgerQuery): Promise<LedgerPage>
Lua
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

Signature
banking.open(source: number): boolean
Lua
local 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

Signature
banking.societyBalance(job: string): number | null
Lua
local balance = aiLib.banking.societyBalance(job) -- number ya da nil

Dö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

Signature
banking.provider(): string | null
Lua
local 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

Signature
billing.send(bill: BillRequest): boolean
Lua
local 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)

Signature
billing.unpaid(source: number): Promise<UnpaidBill[] | null>
Lua
local bills = aiLib.billing.unpaid(source) -- table[] ya da nil, bir thread içinde çağır

Dö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

Signature
billing.pay(source: number, id: string): boolean
Lua
local 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

Signature
billing.provider(): string | null
Lua
local 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");

Bu sayfada