Agency-Doorlock

✨ 新增

• 服务器 exports：AddPlayerAccess(doorId, player) 和 RemovePlayerAccess(doorId, player)
• 服务器 exports：HasPlayerAccess(doorId, player)、GetPlayerAccess(doorId) 和 IsReady()
• player 可以是在线玩家的服务器 ID 或标识符：QBCore 和 Qbox 使用 citizenid，ESX 使用 identifier，独立模式使用 license
• 访问权限变更会保存到数据库，并实时同步给所有玩家，不会因此授予设置或管理员权限
• 服务器事件：agency-doorlock:accessChanged，包含 doorId、identifier 和 granted，可用于日志和自定义脚本

📦 更新说明

• 替换资源文件夹并保留你的 config.lua，无需更改数据库
• 完整参考文档请见 README.md 和 docs.agencyg.de/doorlock/exports

✨ 新功能

• 从 ox_doorlock 导入选定的门，并通过预览查看状态、jobs、gangs、最低等级和不支持的设置。
• 导入前可选择全部或不选择任何门。导入的门无需重启即可立即使用。
• 导入时会保留名称、单开门和双开门、锁定状态、jobs、gangs、市民 ID、1 至 8 位数字的 PINs、自动上锁、交互范围、隐藏提示以及保持开启状态。
• 运行 adoorlock_import 查看预览，或运行 adoorlock_import confirm 导入所有新门。
• 导入功能支持全部 25 种语言。

🔧 改进

• 再次导入时，会跳过 Agency-Doorlock 已在同一位置锁定的门。
• 启动时，服务器控制台会提示哪些门可供导入。

📦 更新说明

• 仅当 ox_doorlock 正在运行时才能导入。导入后，请从 server.cfg 中移除 ensure ox_doorlock，因为两个脚本会锁定相同的门。
• 无法导入物品钥匙、撬锁设置，以及非 1 到 8 位数字的门禁密码。预览会提示不受支持的设置。
• 对于关联了职业或帮派并设置了门禁密码的门，职业或帮派成员无需 PIN 即可开门；其他人仍需输入 PIN。
• 从 1.1.x 更新时，请替换所有文件并保留 config.lua。请保留 shared/locale/ 中已编辑的文件；缺少的新文本将以英文显示。
• 无需更改数据库。重启 Agency-Doorlock，并让更新期间在线的玩家重新连接，以加载新菜单。
• 全新安装请参阅 README.md 中的 Installation 部分。

✨ 新增

• Agency-Doorlock：在 /adoorlock 配置器中输入门模型名称或 hash。
• Agency-Doorlock：自动扫描附近区域，查找匹配的门实体。
• Agency-Doorlock：使用“Add All”一次添加多个附近且模型 hash 相同的门。
• Agency-Doorlock：支持自定义 mapping props 和自定义模型名称。

📦 更新说明

• Agency-Doorlock：版本 v1.1.2

✨ 新增

• 车库门和大门解锁时可以保持开启，在 /adoorlock 中使用每扇门独立的 Hold open 选项即可。
• 锁定保持开启的门时，门会关闭并上锁；与 Auto-lock 配合使用，可在 N 秒后自动关闭。
• 可为每扇门单独设置上锁和解锁的交互范围：使用滑块设置为 0.5 至 10 m，或通过数字输入框设置为最高 50 m。

🔧 改进

• 门目标选择会选中你进入其交互范围最深的那扇门。
• ox_target 和 qb-target 的瞄准选项会采用该型号任意一扇门所要求的最大范围。
• 保存时会在服务器端验证并限制每扇门的范围；空值或无效值将使用已配置的默认值。
• “保持开启”和交互范围标签现已翻译为全部 25 种受支持语言：EN, DE, BG, CS, DA, EL, ES, FI, FR, HR, HU, IT, JA, KO, NL, NO, PL, PT, RO, RU, SK, SV, TR, UK, ZH。所有语言文件的键集合均完整且一致。

🐛 已修复

• Companion 配对卡现在使用服务器语言；此前，在 25 种语言中的 23 种语言里，有 17 条应用和配对文本会回退为英文。
• 发布前已检查翻译占位符和格式。

⚙️ Config

• Config.HoldOpenRatio 控制门的开启幅度；1.0 表示完全打开，较低的数值可防止卷帘门穿入几何物体。
• Config.HoldOpenDistance 设置强制保持开启的范围。
• Config.MaxInteractDistance 设置服务器端的距离上限，默认值为 50 m。
• 每扇门的交互范围默认为 Config.InteractDistance；未调整的门保持现有行为。

📦 更新说明

• 替换 Agency-Doorlock 文件夹，或覆盖 fxmanifest.lua、config.lua、client/main.lua、client/configurator.lua 和 server/main.lua。
• 还需覆盖 html/index.html、html/script.js、html/style.css 以及 shared/locale/ 中的全部 25 个文件。
• 无需手动修改数据库或进行迁移；现有门会使用默认值，并保留访问规则、PIN、按键绑定和配置。
• 需要 oxmysql，该依赖此前就已存在。通过 txAdmin 或运行 ensure Agency-Doorlock 重启资源。
• 关闭 Hold open 时，门的行为与 v1.1.0 完全一致。

✨ 新功能

• 配套应用： 可通过 QR 码或 6 位代码独立连接 Agency-Phone 和 Agency-Elevator。
• 配对： 运行 /adlconnect 或 /adlc 获取 QR 码，也可以在 /adoorlock 设置菜单中找到。
• 配对： 如果无法扫描，请在应用中输入 6 位代码；设备连接期间，该代码会一直显示。
• 玩家： 查看你有权限访问的门及其实时上锁或解锁状态。
• 玩家： 靠近时可上锁或解锁自己拥有的门，遵循与游戏内相同的访问规则。
• 玩家： 在应用中为任意一扇门设置 GPS 航点。
• 管理员： 可远程控制服务器上的任何门，不受距离限制。
• 管理员： 可在应用中删除门；静态 config 门仍受保护。
• 管理员： 可远程打开游戏内的门设置菜单，以添加或编辑门。
• 配套应用： 免费应用可在 iOS 和 Android 上使用，设置指南见 companion.agencyg.de。
• 配套应用： 一个应用即可连接 Agency-Doorlock、Agency-Phone、Agency-Pad、Agency-Elevator、Agency-Reports 等。

🔧 改进

• 本地化：新增的应用、配对和 UI 文本已翻译为全部 25 种支持语言：EN、DE、BG、CS、DA、EL、ES、FI、FR、HR、HU、IT、JA、KO、NL、NO、PL、PT、RO、RU、SK、SV、TR、UK、ZH。

🐛 已修复

• 设置菜单： 6 位配对码始终显示在 QR 码下方。
• Companion QR 卡片： 可流畅展开和收起，且不会遮挡门列表。
• NUI： 改进了面板的打开和关闭表现，并进行了其他细微优化。

⚙️ 配置

• 将 Config.Companion.Enable = false 设置为禁用可选集成。
• 配对码会在 Config.Companion.TokenTTL 后过期，默认值为 5 分钟。

📦 更新说明

• 替换 Agency-Doorlock 文件夹，或覆盖已更新的文件。
• 替换 fxmanifest.lua、config.lua、client/main.lua、client/companion.lua、client/configurator.lua、server/main.lua。
• 替换 server/companion.lua、server/companion_relay.lua、html/index.html、html/script.js、html/style.css。
• 替换 html/js/companion.js、html/js/qrcode.min.js、shared/locales.lua 以及 shared/locale/ 中的所有文件。
• 检查 config.lua 中的 Config.Companion 配置块；保留自己的配置不会有问题。
• 现有门、按键绑定、音效和配置无需迁移即可正常使用，也不会丢失数据。
• 不包含 Config.Companion 配置块的旧版 config.lua 文件会使用安全的默认值，并保持该功能启用。
• 首次启动时会自动创建 pairing 表。无需手动执行 SQL 或修改数据库。
• 仍然需要 oxmysql。通过 txAdmin 或运行 ensure Agency-Doorlock 重启 resource。