Agency-Banking：完整的 FiveM 银行系统，兼容或无需框架

为你的城市打造完整银行

Agency-Banking 将每家银行网点和 ATM 变成一款完整的银行应用。玩家可以并排查看银行余额和现金、转账，并在一个地方管理银行卡、定期存款和投资。它支持 QBCore、Qbox 或 ESX；在不使用框架的服务器上，则由它管理自己的账户。唯一必需的资源是 oxmysql。

菜单中的所有功能

• 钱包： 银行余额和现金、存款和取款。
• 转账： 通过服务器 ID 转账，或转给附近的玩家。
• 银行卡： 四种主题的银行卡。
• ATM PIN： 连续输错五次后锁定 60 秒。
• 定期存款： 默认期限为 7、14 或 30 天，利率来自服务器配置，玩家无法设定。
• 市场： 股票和加密货币交易。
• 活动记录： 账户的完整历史记录。

自动检测框架，或使用 Standalone

将框架设置保留为 auto，银行便会自动检测 QBCore、Qbox 或 ESX，即使框架较晚启动也不例外。每次启动时，服务器控制台都会显示检测到的框架，或说明银行以 standalone 模式运行。只有在这些框架都未安装时，才会选择 Standalone。

在 standalone 模式下，玩家通过 Rockstar licence 识别，管理员则通过 ACE 或配置中的 licence 列表识别。余额和现金由银行自行管理。安装 Agency-Phone 后，手机和银行会共用同一余额；使用自有资金系统的服务器可通过配置中的几个 hook 接入。

供其他脚本使用的资金系统

服务器导出在所有框架上都以相同方式运行。在 standalone 服务器上，它们就是资金系统：商店、工作或车库通过银行向玩家付款和收费，打开的银行界面会立即显示新余额。

-- pay a player into their bank account
exports['Agency-Banking']:AddBankMoney(source, 500, 'Paycheck')

-- charge a player: returns false and takes nothing if the balance is too low
if not exports['Agency-Banking']:RemoveBankMoney(source, 150, 'Garage fee') then
    -- not enough money
end

现金也有对应的一组导出，使用 AddCashMoney 和 RemoveCashMoney，以及 GetBankBalance, GetCashBalance, AddTransaction 用于活动记录的导出和 GetFramework。在 QBCore 和 ESX 上，打开的银行界面会自动同步框架中的资金变动。发生其他资金变动后，为该玩家触发 agency_banking:client:MoneyChanged 。

由服务器验证

付款、利率、定期存款、银行卡和交易都会在服务器上验证，因此被修改的客户端无法凭空生成资金，也无法操作其他玩家的银行卡。Companion 配对本身不授予任何银行权限：来自应用的每项资金操作都会再次由服务器验证。

两种设计和尺寸滑块

菜单采用 Agency 设计：深色纯色面板、金色点缀、胶囊按钮，以及沿侧边栏滑动的金色高亮。偏好经典蓝色风格的服务器可将设计设置切换为 v1，同时保留所有功能。

每位玩家都可以在“设置”中按 1% 的步进，将银行界面缩放至 60% 到 150%，每位玩家的尺寸设置都会单独保存。银行支持 13 种语言，可通过标记点、qb-target 或 ox_target 打开。

安装与更新

无需导入 SQL：首次启动时会在 MariaDB 和 MySQL 8 上创建所有表、列和索引。附带的 agency_banking.sql 仅供数据库用户无权创建表的服务器使用。默认情况下， /openbank 仅限管理员使用，通过一个配置开关即可向所有玩家开放。

已拥有 Agency-Banking 的用户均可免费获取更新。更新后，账户、银行卡、交易、定期存款和 Companion 配对信息都会保留。请使用新的 config.lua，不要直接覆盖旧文件；当 manifest 有变更时，请在重启资源前运行 refresh。

在真实手机上使用银行服务

Agency-Banking 可与 iOS 和 Android 上免费的 Agency Companion 应用配对，独立运行，不依赖 Agency-Phone：随时查看余额、转账、管理银行卡和定期存款，以及修改 ATM PIN。玩家可以通过 /abconnect进行，时间短 /abc配对，也可以扫描银行菜单中的二维码。

获取 Agency-Banking

Agency-Banking 可在 Agency Scripts 商店免费获取获取，且 文档 中查看配置、导出项和事件。