Agency-Housing：在游戏中建造 FiveM 房屋，无需编辑配置文件

在城市中建造房屋

Agency-Housing 是一套由数据库驱动的 FiveM 房屋系统，玩家在游戏中通过创建工具建造房屋，无需在配置文件中填写一堆坐标。管理员运行 /acreatehouse，在当前位置放置入口，标记地产边界，选择房屋内壳体，为房屋命名并定价，然后保存。从此，所有玩家都能看到这栋房屋，房屋数据也会存储在 MySQL 中。

脚本会自动检测 QBCore、QBox 和 ESX，也可在没有任何框架的情况下完全 standalone 运行。数据库表会在首次启动时自动创建。

创建工具

• 入口： 精确放置在管理员所在位置。
• 地产边界： 从空中标记，并保存为 PolyZone。
• 室内： 可选择 18 种内壳体之一，或在游戏中记录自定义室内空间。
• 地图标记： 可为每栋房屋单独设置。

菜单提供七种强调色，让房屋界面与服务器的风格相匹配。

房主可以做什么

• 买卖房屋，可配置退款金额和每位玩家的房屋数量上限。
• 将钥匙交给其他玩家，也可以收回。
• 为整块地产布置家具，最多可放置 60 个道具。
• 锁定和解锁玩家持有钥匙的真实 MLO 房门。
• 使用车库、储物和衣柜点位，并安装房屋升级。
• 回应门铃。

两个按键就能完成大部分操作： F7 打开住房菜单并 F3 在自己的房产中打开业主菜单。 E 在门口标记处进入房屋、回应门铃，并锁定或解锁 MLO 房门。每个命令都以 "a" 开头，例如 /ahousing 和 /ahousemenu，因此不会与其他资源冲突。

专属衣柜

从 1.0.2 版本起，Agency-Housing 内置衣柜。玩家可以为当前穿搭命名并保存，之后在房屋内的任意衣柜换回，每人最多保存 20 套。无需服装脚本，适用于所有框架和 standalone。安装了 illenium-appearance 或 qb-clothing 时，脚本会自动识别。管理员可以在任何位置通过以下命令打开内置衣柜 /ahwardrobe.

支持框架，也可完全独立运行

配置保持为 auto 时，脚本会自动检测框架，即使框架启动较晚也可以，并会在每次启动时于控制台显示检测结果。没有 QBCore、QBox 或 ESX 时，脚本以 standalone 模式运行：通过玩家的 Rockstar licence 区分玩家，管理员由 ACE 或配置中的 licence 列表指定，金钱处理则通过三个简单的钩子完成。你也可以选择将房屋设为免费。

购买、出售、钥匙、家具、升级、MLO 房门、门铃和 Companion app 都能正常使用，保存方式与框架服务器完全相同。

储物系统也会以同样方式自动检测。支持通过 ox_inventory、qb-inventory 1 和 2、qs、ps、lj 及 jpr 打开。在没有库存系统的服务器上，不会提供储物点位。

无需导入 SQL

首次启动时会自动创建所有表和新增列，支持 MariaDB 和 MySQL 8。如果服务器的数据库用户没有创建表的权限， sql/install.sql 仍然包含在内。

在现实世界管理房屋

Agency-Housing 可与免费的 Agency Companion app 配合使用，支持 iOS、Android、iPad、Mac 和 Apple Watch。玩家可以锁定和解锁房屋、发放和收回钥匙、回应门铃、买卖房屋，以及规划前往任意自有房产的路线。工作人员可以传送、列出待售房屋或删除房屋。

配对通过 /ahconnect进行，时间短 /ahc，可使用 QR 码或六位数代码。服务器需要能够向 api.agencyg.de 发起出站 HTTPS 连接。

更新至 1.0.2

已拥有 Agency-Housing 的用户均可免费更新。配置中新增了 standalone 配置区块和衣柜选项，因此请先备份现有配置值，使用新的 config.lua 并重新设置。房屋、钥匙、家具和 Companion 配对信息会保留，无需导入任何内容。manifest 已更改，因此请在重启资源前运行 refresh，或重启服务器。

获取 Agency-Housing

Agency-Housing 可在 Agency Scripts 商店免费获取获取，且 文档 列出了所有命令、配置选项和导出。