高级武器授权

🔫 高级武器授权系统

📞 技术支持 QQ：3159440839

多框架兼容的精细化武器管控解决方案，为您的服务器构建完善的枪械授权与发放体系。

🎯 功能简介

这款高级武器授权系统专为 FiveM RP 服务器精心打造，从管理员后台 → CDK 兑换 → 玩家持枪检测 → 授权到期回收全流程闭环管理。无论是警匪 RP、黑帮势力划分、活动福利发放，还是会员武器特权，都能精确到「单玩家、单武器、单时长」级别管控。配备 Soft Neumorphism 现代界面、青色辉光质感、流畅交互动效，每一处操作都给玩家与管理员双向的高级体验。

💎 核心优势：服务端权威校验、SQL 注入防护、CDK 防刷、到期自动回收，让武器管理既安全可控，又能融入服务器的运营节奏。

⚙️ 核心特性

🔗 多框架深度兼容

全面支持 ESX、QBCore、QBX、ox_core 主流框架，通过 ak-lib 桥接层实现零适配接入，自动识别框架类型无需手动配置，大幅降低服务器运维整合成本。

📦 多背包系统适配

原生支持 ox_inventory、qb-inventory、qs-inventory、codem-inventory 等主流背包，自动适配不同背包数据结构。智能匹配 weapon_x / WEAPON_X 大小写键名，彻底解决 ox_inventory 用户的物品键名兼容问题。

🎯 Target 双系统兼容

支持 ox_target 与 qb-target 任意一种，自动识别已启用的目标系统并注册兑换 NPC 交互，本地化 ped 实体使用 addLocalEntity 接口确保稳定性。

🔐 严格的管理员体系

仅认配置文件 Config.Admins 内的标识符，不会回退到 ACE / 框架管理员兜底，权限边界清晰可控。支持 license / discord / steam / fivem / live 任意前缀，可在面板内动态增删管理员（自动写回 config 文件）。

🔫 受限武器列表

只有添加到「受限列表」的武器才会被检测授权，其他武器不影响。管理员可在面板内新增、编辑、删除受限武器，实时同步全服客户端。

🎫 完整 CDK 兑换系统

批量生成：单次最多 50 张，16 位字母+数字组合（自动剔除易混字符 0/O/I/1）

绑定武器：每张 CDK 绑定一把武器，支持永久或限时（自定义天数）授权

多重限制：CDK 自身有效期、可用次数、启用/禁用状态独立配置

管理面板：列表筛选、批量删除（仅未使用）、启用禁用一键操作

管理员备注：每张 CDK 可写备注（如「周年庆活动」「VIP 奖励」）便于审计

🤖 世界 NPC 兑换点

在世界放置兑换 NPC（坐标 / 模型 / scenario / 是否固定 / 无敌可配置），玩家通过 Target 交互打开兑换 UI，输入 16 位 CDK 即可获得武器授权。输入框自动按 4-4-4-4 格式化，支持粘贴、退格回退格、左右箭头跨格切换。

🛡️ 服务端权威校验

频率限制：单玩家每分钟最多兑换 3 次（可配置）

SQL 注入防护：所有用户输入参数化绑定

永久授权重复保护：玩家已有永久授权时禁止重复兑换

并发竞争保护：使用次数原子更新，防止并发抢兑

⏰ 到期自动收回 Sweeper

SQL 端 NOW() 比较：不在 Lua 端比时间字符串，彻底规避时区漂移坑

每 60 秒扫描：命中后清缓存 → 推送同步 → 卸下手中武器 → 通知玩家 → 可选清背包

完整审计日志：「到期自动收回」单独记录，便于追溯

测试指令：内置测试命令快进任意授权的到期时间，验证流程

🚨 反作弊持枪检测

客户端武器检测循环，发现持有未授权武器立即卸下，5 秒冷却防通知刷屏。服务端二次校验后从背包清掉物品（可在配置中关闭），自动写入「非法持枪」日志，形成完整证据链。

📊 三通道日志面板

日志精确区分为三类：

管理员操作：grant / revoke / cdk_create / cdk_enable / cdk_disable / cdk_batch_delete / 到期自动收回

非法持枪：玩家未授权使用受限武器的全部记录

CDK 兑换：cdk_redeem / cdk_redeem_fail / cdk_redeem_race，独立查看不混淆

🎨 Soft Neumorphism 现代 UI

暖灰玻璃质感 + 青色辉光强调色，告别塑料感

凸起 / 凹陷 立体阴影按钮，状态切换流畅

半透明分层卡片，纯 CSS 多层 box-shadow 实现

聊天指令打开，无需使用按键占用

⚡ CEF 性能优化

完全不使用 backdrop-filter / filter: blur，规避 CEF 黑块掉帧问题

自定义 Promise 模态（akConfirm / akPrompt）替代原生 confirm / prompt，避免阻塞 UI

集中 SVG 图标库，无任何 emoji 占位

跨资源回调本地化，避免 funcref 失效问题

📋 智能玩家管理

在线玩家列表：管理员面板可直接查看所有在线玩家

身份码查询：按 server id 搜索玩家，查看所有 identifier（license / discord / steam）

玩家详情页：实时展示该玩家拥有的全部授权武器，一键撤销

🗄️ 数据库自动建表

启动时自动创建 4 张表，反复重启无影响：

ac_weapon_authorization — 授权记录

ac_weapon_list — 受限武器列表

ac_weapon_auth_logs — 三类日志

ac_weapon_auth_cdks — CDK 定义与使用记录

使用 DATETIME 字段（非 TIMESTAMP），无需关心 MySQL session 时区设置。

🔍 自带版本检测

启动时异步拉取远端版本号比对，控制台输出更新提示，作者发布新版本时所有用户启动即可获知。检测逻辑硬编码无法绕过，确保用户拿到的是最新功能与安全修复。

⌨️ 便捷操作体验

ESC 键关闭面板

聊天指令支持别名：可同时注册多个指令打开同一面板

数字键自动跳格：CDK 输入框输入 4 位自动跳到下一段

段位粘贴智能识别：粘贴完整 12 位日期数字自动填充 5 段输入框

左右箭头跨段移动：单元格内移动到边界后自动切换段落

🔊 反馈到位的音效

兑换成功播放 CHALLENGE_UNLOCKED 音效（可配置）

失败播放系统提示音

操作按钮点击均有声音反馈

📁 清晰的代码架构

模块化分文件：CDK 管理 / CDK 兑换 / NPC 生成 / Schema 迁移 各一个文件

共享工具集 _G.WA：跨模块复用核心函数（writeLog / isAdmin / grantPlayerAuth 等）

客户端服务端分离

HTML/CSS/JS 拆分独立文件：UI 资源便于二次定制

配置集中管理：所有可调参数在 config.lua 一处搞定

🛠️ 加密与开放并存

基于 FiveM Asset Escrow 加密保护核心代码，同时开放以下文件可自由编辑：

config.lua — 全部配置

sql.sql — 数据库结构（参考用）

index.html

 / html/css/* / html/scripts/* — UI 完全可定制

让您既能保护商业代码，又能给客户充分的二次开发空间。