PrivateBankSelf - 私人银行系统

LSE PrivateBankSelf - 私人银行系统 V2.0.0

完成注册/登录后下载

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 设计原则是:其他插件通过接口调用银行能力,而不是直接修改银行数据文件,从而降低多插件同时操作账本时的数据冲突和资金风险。
后退
顶部 底部