01概述
一套完整的 FiveM 银行系统，可运行于 QBCore、Qbox、ESX，也可完全独立运行。玩家拥有包含银行存款与现金的钱包、四种主题的银行卡、按 ID 或向附近玩家转账、利率只由服务端决定的定期存款、股票与加密货币交易、ATM PIN 以及完整的交易记录。没有框架时，银行会管理自己的账户，其他资源也可以通过服务端导出把它当作资金系统使用。此外还有两种菜单设计、13 种语言、标记点或 qb-target / ox_target、每位玩家可调的显示尺寸滑块、首次启动时自动创建的数据表，以及免费的 Agency Companion 应用，让玩家随时查看余额、转账、管理定期存款和银行卡。
02功能
+值得了解
Agency-Banking 是一个完整的 FiveM 服务器银行系统。它支持 QBCore、Qbox 或 ESX 框架，在无框架服务器上则维护自己的账户。玩家可以在银行分行和 ATM 机处理资金：钱包显示银行余额和现金，提供四种主题的银行卡，支持转账、定期存款、股票和加密货币交易，并有完整的活动日志。数据库表在首次启动时创建，免费的 Agency Companion 应用将余额、转账、定期存款和银行卡信息同步到玩家的真实手机。
- 支持所有框架，或无框架
- 当 Config.Framework 设置为 'auto' 时，银行会自动检测 QBCore、Qbox 或 ESX 并使用它们的资金系统。仅当未安装任何框架时，银行才切换为独立模式：玩家通过 Rockstar 许可证识别，余额存储在银行自有的表中，若安装了 Agency Phone 则共享该表，或通过 Config.Standalone 使用您自己的函数。
- 玩家对银行的所有期望功能
- 钱包同时显示银行余额和现金。玩家可以存取款，通过服务器 ID 或附近玩家转账，创建四种主题的银行卡，并用 PIN 码保护 ATM，连续五次输错后锁定 60 秒。定期存款默认期限为 7、14 或 30 天，利率由服务器配置决定，玩家无法更改，市场界面允许玩家交易股票和加密货币。
- 为其他资源提供的资金系统
- 服务器导出函数如 GetBankBalance、AddBankMoney 和 RemoveBankMoney 在所有框架中表现一致。在独立服务器上，它们即为资金系统：商店、工作或车库通过银行收费和支付，打开银行时余额即时更新。提供两种菜单设计，支持 13 种语言，支持标记点或 qb-target / ox_target，且每位玩家可调节显示大小滑块。
?常见问题
Agency-Banking 需要 QBCore 或 ESX 吗？
不需要。它支持 QBCore、Qbox 和 ESX，且无框架时独立运行，维护自己的账户。唯一必需的资源是 oxmysql。保持 Config.Framework 为 'auto'，服务器控制台会显示检测到的框架名称或显示“Running standalone”。
我需要导入 SQL 文件吗？
不需要。每次启动时，资源会自动创建所需表格，并为旧数据库添加缺失列，支持 MariaDB 和 MySQL 8。agency_banking.sql 文件仅供偏好手动设置数据库的服务器使用。
其他脚本如何支付或扣款给玩家？
通过服务器导出函数。exports['Agency-Banking']:AddBankMoney(source, amount, reason) 用于支付，余额不足时 RemoveBankMoney 返回 false 并不扣款。现金也有对应函数。在 QBCore 和 ESX 中，打开的银行界面会自动跟踪框架资金变动；其他变动后，请触发 agency_banking:client:MoneyChanged 事件通知玩家。
玩家可以调整银行界面大小吗？
可以。设置中的显示大小滑块支持从 60% 到 150% 以 1% 步长缩放。拖动时平滑变化，滑块停止时文本重新绘制清晰，每位玩家保存自己的设置。
如何从旧版本更新？
备份您的数据，替换资源文件并使用新的 config.lua，其中新增了 Config.Design、Config.Framework、Config.Standalone 和 Config.Commands。重启资源后，账户、银行卡和定期存款数据保留在数据库中，缺失的列会自动添加。