申请接入联合封禁

接入后,经审核的封禁记录会在玩家连接前同步拦截;撤销同样会自动同步。

接入后你会得到什么

  • 连前拦截。玩家进入服务器前查询本地缓存,命中生效中的联合封禁直接拒绝, 不占用服务器 slot,也不需要你写任何判断代码。
  • 撤销会下发。记录被撤销或到期后,事件通过增量同步推到所有接入服务器, 本地命中集合随之清空 —— 不需要你手工维护名单。
  • 故障不锁门。连不上中央 API 时按「状态未知」处理并放行,绝不让中央故障变成全服进不去。

你需要准备什么

  • 一台能安装 FiveM resource 的服务器(放行出站 HTTPS 即可)。
  • 一个用于接收审核结果与安全通告的联系方式(QQ / 邮箱 / Discord 均可)。
  • 插件的 API 地址、密钥写在 server.cfg 的 setr 里, 不要提交到公开仓库,也不要贴进群里。

边界(请先确认能接受)

  • IP 不作为封禁依据。IP 只作为审核佐证保存,永远不参与命中匹配 —— 网吧、校园网、CGNAT 下大量真实玩家共享出口 IP,按 IP 匹配等同于批量误封。
  • 提交不等于生效。你提交的记录要经过中央审核并发布后才进入全球生效集合。 审核队列会公布深度,但不公布内容。
  • 证据仅审核可见。上传的证据不进公开目录,其他服务器看不到你的证据, 也不允许跨服查看。

提交接入申请

审核通过前不会签发密钥。一个账号可以申请多个服务器,每个服务器有自己独立的密钥。

提交后可随时在「我的接入」查看状态

装好密钥之后

  1. 把 cnfivem_globalban 放进 resources 目录,server.cfg 里 ensure。
  2. 写入 cnfivem_gb_key_id 与 cnfivem_gb_key_secret。
  3. 启动后执行 /gb_status,看到 「已同步」即接入成功。
  4. 插件每 30 秒增量同步一次,长期离线会自动回退全量快照追平。