Dinheiro e banco
money.transfer entre duas contas, o script de banco pelo ai-core e cobranças pelo script de cobrança que estiver rodando.
import { money, banking, billing } from "@aicore8/lib/server";money é todo o saldo do servidor: as contas de um jogador carregado, a conta partilhada de um emprego ou de uma gangue, uma transferência que move o dinheiro numa só transação, e o registo. Uma personagem que não está ligada passa por characters. O banking e o billing são as camadas para os scripts de banco e de faturas do servidor.
money
money.get
O saldo de um jogador carregado numa conta.
Lado: Servidor · Espera: não
money.get(source: number, account: string): number | nulllocal balance = aiLib.money.get(source, account)Parâmetros
Prop
Type
Retorno
number | null: o saldo, ou null quando o jogador não tem personagem carregada ou o tipo de conta não existe. Os saldos de uma personagem guardada vêm de characters.get.
Exemplo
import { money, notify } from "@aicore8/lib/server";
export function tellBalance(source: number): void {
const bank = money.get(source, "bank");
notify(source, bank === null ? "Sem personagem" : `Banco: $${bank}`, bank === null ? "error" : "inform");
}money.add, money.remove and money.set
Altera uma conta de um jogador carregado, com uma linha de registo. São as chamadas para uma recompensa, um preço, um salário que o seu script paga.
Lado: Servidor · Espera: não
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)Parâmetros
Prop
Type
Retorno
boolean: true quando a alteração foi feita. false quando o jogador não tem personagem carregada, a conta não existe, o valor não é um inteiro acima de 0, ou - no remove - o saldo não pode pagar (a menos que o tipo de conta possa ir abaixo de zero).
Exemplo
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");
// dê o item aqui
return { ok: true };
});Um jogador pagar a outro não é um remove mais um add: uma falha a meio faria aparecer ou desaparecer dinheiro. Use money.transfer, que é uma só transação.
money.sharedGet
O saldo da conta de um emprego ou de uma gangue - bank é o que outros frameworks chamam dinheiro de sociedade.
Lado: Servidor · Espera: não
money.sharedGet(type: "job" | "gang", id: string, account: string): number | nulllocal balance = aiLib.money.sharedGet(type, id, account)Parâmetros
Prop
Type
Retorno
number | null: o saldo, ou null quando esse emprego ou gangue não tem essa conta (um emprego desconhecido, ou um tipo de conta que o servidor não tem).
money.sharedAdd and money.sharedRemove
Altera a conta de um emprego ou de uma gangue, com uma linha de registo - as receitas e os custos de uma empresa.
Lado: Servidor · Espera: não
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)Retorno
boolean: true quando a alteração foi feita, false para um emprego ou gangue desconhecidos, uma conta que falta, um valor errado, ou uma conta que não pode pagar.
Exemplo
import { money } from "@aicore8/lib/server";
/** Um contrato da cidade que a oficina ganha, e o que paga pelas peças. */
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
Move dinheiro de uma conta para outra em uma única transação no banco de dados, com uma linha no extrato dos dois lados. Use para tudo em que o dinheiro não pode aparecer nem sumir no meio do caminho: pagar outro jogador, um emprego pagando um bônus, uma taxa.
Lado: Servidor · Espera: não
money.transfer(from: MoneyRef, to: MoneyRef, amount: number, reason?: string, fee?: number): booleanlocal ok = aiLib.money.transfer(from, to, amount, reason, fee)Parâmetros
Prop
Type
Retorno
boolean: true quando as duas linhas foram escritas. false quando um valor não é um número inteiro, uma conta não existe, as duas são a mesma, ou from não pode pagar amount mais fee.
Exemplo
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
As linhas do registo de uma conta, as mais recentes primeiro: o que se moveu, o saldo depois, o motivo, quem o fez e quando. Funciona para a conta de um jogador, a de um emprego ou gangue, e a de uma personagem guardada.
Lado: Servidor · Espera: sim
money.history(account: LedgerRef, query?: LedgerQuery): Promise<LedgerPage>local page = aiLib.money.history(account, query)Parâmetros
Prop
Type
Retorno
Uma LedgerPage: rows e o next que passa como before (null na última página). O ai-core escreve uma linha um momento depois da alteração, por isso a mais recente pode estar alguns milissegundos atrás do saldo.
Exemplo
import { money } from "@aicore8/lib/server";
/** As últimas 20 linhas de banco de uma personagem guardada. */
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 conversa com o script de banco pela camada de banco do ai-core. O dinheiro dos empregos em si sempre se move por money ou pelos exports do ai-core.
banking.open
Abre a tela do script de banco para um jogador.
Lado: Servidor · Espera: não
banking.open(source: number): booleanlocal ok = aiLib.banking.open(source)Retorno true quando aberta. false quando o script não pode ser aberto de fora ou nenhum está rodando.
onClientCallback("my-atm:open", (source) => (banking.open(source) ? { ok: true } : fail("BANK_UNAVAILABLE")));banking.societyBalance
O saldo da sociedade de um emprego, para exibição. No modo de conta core do ai-core é a conta do emprego no ai-core; no modo own, a do próprio script de banco.
Lado: Servidor · Espera: não
banking.societyBalance(job: string): number | nulllocal balance = aiLib.banking.societyBalance(job) -- number ou nilRetorno o saldo, ou null (nil em Lua) quando nenhum está rodando ou o script não guarda saldo.
const balance = banking.societyBalance("mechanic") ?? 0;banking.provider
Lado: Servidor · Espera: não
banking.provider(): string | nulllocal name = aiLib.banking.provider()Retorno o script de banco que a camada usa, ou null.
console.log(`banking through ${banking.provider() ?? "nothing"}`);billing
billing envia cobranças pelo script de cobrança que estiver rodando; sem um, pelas próprias cobranças do ai-core (o jogador paga a partir de uma lista na tela, o dinheiro se move quando ele paga). Os textos já vêm traduzidos.
billing.send
Envia uma cobrança de um emprego (multas, taxas de serviço) ou de um jogador.
Lado: Servidor · Espera: não
billing.send(bill: BillRequest): booleanlocal ok = aiLib.billing.send(bill)BillRequest
Prop
Type
Retorno
boolean: true quando enviada, false quando inválida ou recusada.
Exemplo
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
As cobranças em aberto do jogador.
Lado: Servidor · Espera: sim (Promise em TypeScript, pausa a thread em Lua)
billing.unpaid(source: number): Promise<UnpaidBill[] | null>local bills = aiLib.billing.unpaid(source) -- table[] ou nil, chame dentro de uma threadRetorno UnpaidBill[] (id, label, amount ainda devido, sender), ou null quando o script de cobrança não consegue listá-las.
const bills = await billing.unpaid(source);
const owed = bills?.reduce((sum, bill) => sum + bill.amount, 0) ?? 0;billing.pay
O jogador paga uma das suas cobranças em aberto.
Lado: Servidor · Espera: não
billing.pay(source: number, id: string): booleanlocal ok = aiLib.billing.pay(source, id)Prop
Type
Retorno true quando paga. false quando recusada (dinheiro insuficiente, cobrança desconhecida) ou o script de cobrança só aceita pagamentos na própria tela.
if (!billing.pay(source, billId)) return fail("PAY_FAILED");billing.provider
Lado: Servidor · Espera: não
billing.provider(): string | nulllocal name = aiLib.billing.provider()Retorno o script de cobrança para onde as cobranças vão, "ai-core" para as próprias cobranças do ai-core.
if (billing.provider() === "ai-core") console.log("using ai-core's own bills");Veículos
spawnVehicle, vehicleType, randomPlate, veículos mais próximos, entidades a partir de net ids do cliente, vehicleKeys, combustível e garagens.
Empregos e serviços
Alertas da polícia, prisão, registros do MDT, médicos, reviver e curar, estresse, fome e sede, definições de empregos e gangues, horário nobre.