PrivateBankSelf 跨插件 API
PrivateBankSelf 提供基于 LSE ll.exports / ll.imports 的跨插件接口,方便其他 QuickJS 插件安全读取银行数据、查询客户资料,以及调用银行资金与业务联动能力。
命名空间统一为:
PrivateBankSelf
当前开放接口:
- getBankCatalog
获取服务器全部私人银行基础信息,包括银行 ID、名称、行长、状态、总资产、基础储备金、运营资金、盈利池及股市开启状态。
- getClientProfile(xuid, bankId)
查询指定玩家在银行中的客户资料,包括信誉等级、客户优先级、活期存款、定期存款、总存款、银行卡状态及银行信息。
bankId 为空时可用于查询玩家全局信誉等级。
- getOwnerBanks(xuid)
查询指定玩家名下建立的全部私人银行及其经营状态。
- lotteryPurchaseFromDeposit(reqId, xuid, bankId, cost, profitAmount, actorName, ticketId)
从指定玩家的银行活期余额中安全扣除业务资金,并可同时将其中一部分计入银行盈利池。支持 reqId 幂等处理,可防止重复请求造成重复扣款。
- lotteryAddProfit(reqId, bankId, amount, actorName, note)
向指定银行盈利池增加业务收入,并自动生成银行资金流水记录。
- lotteryChargeIssueFee(reqId, bankId, amount, actorName, note)
从银行盈利池扣除指定业务费用。不会动用银行基础储备金,并带有金额安全限制与幂等保护。
- lotteryAdjust(reqId, bankId, pnl, stockWeight, announcement)
向银行提交外部业务经营结果,可写入经营盈亏、股市影响权重以及银行公告,用于与其他经济插件联动。
- creditDemand(reqId, xuid, bankId, amount, reason)
将外部业务资金安全转入指定玩家在私人银行中的活期账户,并同步银行运营资金及流水。
调用方式
其他 LSE QuickJS 插件可通过:
ll.hasExported("PrivateBankSelf", "接口名")
检测接口是否存在,再使用:
ll.imports("PrivateBankSelf", "接口名")
进行调用。
涉及资金变更的 API 均建议使用唯一 reqId,例如:
PLUGIN:BUSINESS:ORDER_ID
这样即使插件重试请求,也可避免重复扣款或重复入账。
PrivateBankSelf 的 API 设计原则是:
其他插件通过接口调用银行能力,而不是直接修改银行数据文件,从而降低多插件同时操作账本时的数据冲突和资金风险。