ZeroDev Sentinel 文档
ZeroDev Sentinel:安装与使用
ZeroDev Sentinel 是一个用于 FiveM 的服务器端反作弊 resource。它记录服务器看到的内容,用能以简单语句说明自身的规则进行判断,并在任何人受到处罚之前把证据交给你的管理人员。它以 Watch 保护级别启动:只记录,不处罚任何人,直到你另作选择。本指南适用于 ESX、QBCore、Qbox 和 standalone 服务器上的 0.1.2 版本。
1. 运行要求
- 开启 OneSync(在 server.cfg 中写入
set onesync on)。该 resource 将 OneSync 声明为依赖项,所以没有 OneSync 时 FXServer 不会启动它。 - 能运行 Node 22 脚本的 FXServer artifact(任何当前推荐的 artifact 都可以;manifest 要求
node_version '22')。Node 负责哈希计算、压缩、文件列表和申诉网页路由。 - 可选:oxmysql。有了它,Sentinel 会把记录存进你的数据库,并在首次启动时自行建表。没有需要导入的 SQL 文件。没有它时,所有数据都存放在该 resource 自己的键值存储中。
- 可选:pma-voice,用于从控制台或浏览器面板监听玩家的语音聊天。
框架只影响两件事:资金和物品追踪(没有任何商店、工作或脚本发放的金钱和物品、奖励循环、回滚),以及谁是你的管理人员(ACE 组,所有框架都使用)。检测、案件、片段、控制台、浏览器面板、Discord 和 owner desk 在所有框架上的工作方式都相同。
2. 五分钟安装
不需要任何 SQL,首次启动无需修改配置,也不会改动其他任何 resource。
3. 你的框架
Sentinel 启动时会自行识别框架和 inventory,无需任何设置。在服务器控制台运行 sentinel:trail 可以看到它选择了哪个适配器。
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- 资金和物品:从 ESX 自己的服务器事件中读取(账户资金的增加、扣除或设定;inventory 物品的增加或移除;玩家之间给予的物品,双方会关联起来)。回滚使用 ESX 自己的玩家方法,并回读结果。
- ESX 搭配 ox_inventory:资金的追踪方式相同。在这种模式下,ESX 的物品方法不返回结果,所以 Sentinel 只根据回读结果做判断。
- 管理人员:给你的管理员 ACE 权限(第 5 节)。添加相应的行后,ESX 自己的
group.admin就可以作为 ACE 组使用。
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- 资金:从 QBCore 的资金变动事件中读取(增加、扣除和设定,附带原因)。同一时刻的一笔减少和一笔等额增加会被关联为转账,因为 QBCore 没有自己的转账事件。
- 物品:使用 ox_inventory 时,物品通过它的 hook 追踪。使用 qb-inventory 时,物品变动不会被追踪(它的 listener 数据格式没有文档),但回滚仍可以通过 qb-inventory 有文档的 export 移动物品。
- 管理人员:QBCore 的权限组就是 ACE 组(
group.admin、group.god)。添加第 5 节中的 ACE 行。
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- 资金:从 Qbox 的资金变动事件中读取;余额通过
qbx_core自己的 export 回读。对离线角色(按 citizen id)修改资金不会触发事件,因此不在追踪记录中。 - 物品:Qbox 使用 ox_inventory,Sentinel 通过 ox_inventory 的 hook 追踪其物品。代表框架资金的物品交由框架部分处理。
- 管理人员:ACE 组,与 QBCore 相同。
Standalone(无框架)
set onesync on
ensure zerodev_sentinel- 除资金和物品追踪外,其他一切都能运行:移动、世界、事件、诱饵事件、godmode、state bag、武器、案件、片段、回放、控制台、面板、Discord、角色和封禁。
- 有 ox_inventory 但没有框架时,物品通过 ox_inventory 追踪。
- 存储:键值存储,或者先启动 oxmysql 时使用 oxmysql。
检查是否正常运行
sentinel:health:再次显示启动框。每一行都是真实的检查;READY 表示没有缺少任何东西。sentinel:diag:为什么选择了这种存储、这些适配器和这个级别,每条规则及其计数器,以及最近的判定。sentinel:trail:正在使用的资金和物品适配器,以及某个玩家最近的变动。
在自动存储模式下,只有当 oxmysql 已经启动时 Sentinel 才会使用它(oxmysql 正在启动时最多等待 15 秒);如果 oxmysql 启动得更晚,就使用键值存储。
4. 首次启动:所有者席位
首次启动时,服务器控制台会打印一个一次性代码,有效期 30 分钟(sentinel:owner code 会生成新的)。进入服务器并输入 /sentinel owner <code>:席位会绑定到你的账号,代码随即失效。
只有所有者席位可以更改密钥、保护级别、角色和权限。如果需要把席位转到另一个账号,在服务器控制台运行 sentinel:owner reset 即可释放席位。
5. 管理人员与权限
在 owner desk 的 STAFF 中:选择一名在线玩家,选择一个角色,按 GRANT。自带四个角色:
| 角色 | 默认可做 |
|---|---|
| 支持 | 查看案件、处理举报、值班地图 |
| Moderator | 同 Support,另加回放、踢出和隔离 |
| Admin | 同 Moderator,另加揭示、排除嫌疑、实时查看、封禁申请、申诉 |
| Senior admin | 同 Admin,另加立即生效的封禁 |
权限由你决定。每个角色都是一组可修改的开关。你可以从副本创建自己的角色(例如 "Trial mod"),重命名任何角色,也可以在不改变某人角色的情况下给他额外开一个开关或关掉一个。标记为危险的开关(立即封禁、监听语音聊天、设置、管理人员管理)需要再按一次确认。每次更改都会写入管理记录,所以你随时都能看到谁改了什么。
对已经在用 ACE 的服务器,ACE 依然有效,并且每次检查都会读取:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| 权限 | 赋予的角色 |
|---|---|
sentinel.admin |
Admin(在所有者席位被认领之前为 Senior admin),以及游戏内的所有 sentinel:* 命令 |
sentinel.staff |
Moderator;移动规则会把管理人员自己的移动视为已解释 |
少数命令(sentinel:audit、sentinel:case、sentinel:replay、sentinel:save)注册为受限命令:在游戏中还需要 command.<name>。常用的那一行 add_ace group.admin command allow 已经涵盖这一点。服务器控制台可以运行所有命令。
6. 保护级别
owner desk 上的一个开关(OWNER、PROTECTION),另外还有服务器控制台中的 sentinel:level,以及 Config.Protection(位于 config/config.lua)。你在 desk 上的设置会被保存,重启后优先于配置文件中的那一行。
- Watch:每条规则都会观察并记下它本来会做什么;不会向任何人发出警报,也不会对任何人采取行动。与此同时,Sentinel 会学习你服务器上的正常情况:事件观察器(每个事件的频率和形态)和进服检查只在 Watch 下学习;实体、战斗和资金的阈值会继续从正常游戏中学习。
- Recommended:每条规则都正式生效。管理人员会收到附带证据的警报,并会开启一个案件。Sentinel 从不自行处罚;由你的管理人员决定。
- Strict:与 Recommended 相同,另外高分会把玩家隔离,直到管理人员查看;证据级别的检测结果(Tier A:诱饵事件被触发、伪造的请求)还会把一次封禁排入 ban wave 队列。
开关下方,desk 会列出每条规则及其状态和状态来源。如果你的服务器需要,可以在那里把单条规则固定为 Live 或 Shadow(例如某条规则一直标记你自己的某个脚本);state 行(写在 Config.Rules 中)会在配置文件中固定该规则,并优先于 desk。
合理的顺序:
- 在正常游戏中开 Watch 运行几天。
- 查看规则本来会做什么:Right now 页、
sentinel:diag rules(shadow 列统计某条规则本来会计分的次数)以及sentinel:diag decisions 100。 - 凡是标记了你信任之人的规则,都固定为 Shadow,并告诉我们。
- 切换到 Recommended。现在管理人员能看到案件和证据;不会有人被自动处罚。
- 当你信任 Recommended 展示的结果时,再用 Strict。
随时可以退回:在 desk 上选 Watch,或运行 sentinel:level watch。
7. 管理控制台(F7)
在游戏内按 F7(或在 F8 中输入 sentinel:console)。每位玩家都可以在游戏设置中更改按键(Key Bindings,FiveM)。按 Esc 关闭。
- Right now 用大白话说明你的服务器上正在发生什么:谁看起来像威胁以及原因、哪些已被证实、哪些已得到解释(一次 revive、脚本自身的传送),以及哪些需要你处理。每位值得关注的玩家占一行:他做了什么、这很可能是什么、Sentinel 有多确定(异常、可疑、很可能、已证实)、Sentinel 已经做了什么,以及一个下一步。
- Case files:未结案件排在最前,每个案件都有检测结果、证据、屏幕片段、封印(该案件的哈希链是否仍能校验通过),以及 REVEAL、QUARANTINE、CLEAR 和 BAN 按键(CLEAR 和 BAN 需要再按一次确认)。
- Duty map:在线玩家显示在岛屿的 3D 模型上。地形由第一位管理员的游戏测量,并保存在
data/map/中。 - Play replay 会关闭控制台,并在私人世界中回放这次事件;按 Backspace 返回。
- Owner(仅限服主席位):First run、Protection、Keys、Staff、Internal affairs 和 Server check。
在游戏内输入的命令,在 F8 中不带斜杠,在聊天中带斜杠(/sentinel:diag)。
8. 浏览器面板
同一个工作台,在网页浏览器里使用,适合你不在游戏内的时候:
- 在服务器电脑上:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(端口就是你的服务器端口,默认 30120) - 从其他地方:
http://<server address>:<port>/zerodev_sentinel/panel/,或你架在它前面的自有 HTTPS 地址
登录。使用一次性代码:在游戏内输入 /sentinel panel(代码只显示给你本人,只能用一次,5 分钟内有效),或在服务器控制台运行 sentinel:panel <id or account>。一次会话持续 8 小时;SIGN OUT 和 END ALL MY SESSIONS 可结束会话。你的角色和开关在浏览器中与在游戏内完全一样生效。
实时查看。拥有实时查看开关的管理人员可以在面板或控制台中查看任何在线玩家的屏幕。除非你按下 Save to case,否则不会在磁盘上保留任何内容。
监听。监听该玩家的语音聊天需要监听开关(默认仅限服主)和 pma-voice。声音通过你自己的游戏播放,所以你需要在同一台服务器的游戏内。
每一次实时查看和每一次监听都会写入管理记录和该玩家的案件,并且玩家首次进服时会被告知管理人员可能会查看和监听(录制告知,Config.Notice)。
9. 案件、隔离、踢出、封禁和申诉
发现情况时,Right now 会用大白话点出这名玩家:他做了什么、Sentinel 有多确定,以及它对此做了什么。打开案件查看证据(位置、用 SHA-256 封存的屏幕片段、3D 回放),然后使用这些按键:
- REVEAL:显示该玩家的标识符。
- QUARANTINE:把玩家从真实世界移到一个私人 routing bucket 中,直到管理人员查看。
sentinel:release <server id>会把他带回来。 - CLEAR:没有作弊;关闭案件并停止其排队中的封禁。
- KICK:踢出服务器,并附上玩家能看到的原因。
- BAN:通过 ban wave 执行,并附带申诉码。
ban wave。封禁(包括在控制台按下的 BAN)会排入 ban wave 队列,并且只在 Strict 下执行,默认在 2 到 24 小时后的随机时间执行(Config.Actions)。sentinel:wave 列出它们,sentinel:wave now <account> 立即执行其中一个,sentinel:wave cancel <account> 取消它。
申诉。被封禁的玩家会在拒绝连接的提示中看到一个申诉码(8 位字母和数字)。他们无法进服申诉,所以申诉要从游戏外送到你这里:
- 通过你的管理团队。玩家把申诉码发给你的管理团队(Discord 工单、邮件)。一名管理人员用
sentinel:appeal <code> <text>把它记录下来。 - 通过网页路由。Sentinel 在你服务器自己的地址上应答:
http://<server address>:<port>/zerodev_sentinel/appeal。它只接受带 JSON{ "code": "...", "text": "...", "contact": "optional" }的 POST(text 为 10 到 2000 个字符),所以它是给你网站上的表单用的,不是让玩家直接访问的页面。每个被接受的请求都得到相同的回答:202 "received",无论申诉码是否对应某个封禁。来自同一地址的请求过多(10 分钟内 5 次)或总请求过多(每分钟 30 次)会得到 429。如果在你自己的 HTTPS 反向代理后面,请设置set sentinel_http_proxy true,这样限制才会按访客的地址计数。
拒绝连接的提示不会说明到哪里申诉。请在你的规则中告诉玩家,或在 Config.Bans.message 中写上带你自己链接的文字(保留 %s,它会变成申诉码),例如 'You are banned. Appeal at discord.gg/yourserver with code %s'。
管理人员在控制台中做出决定,或使用 sentinel:decide <case or code> accept|reject [note]。接受会解除该账户或案件的所有生效封禁,并取消排队中的 ban wave 封禁;驳回则保留封禁。决定是最终的,并会写入案件日志。sentinel:appeals 列出未处理的申诉。
10. 举报与 internal affairs
玩家举报。任何玩家都可以输入 /report <server id> <what happened> 来举报一名玩家或一名管理人员。两名玩家周围最近两分钟会被保存进一个案件。管理人员结案时可标为:已处理、无违规、无证据或重复。针对管理人员的举报只发给服主。
Internal affairs(仅限服主,在 owner desk 上):每位管理人员做了什么,以及哪些需要查看(给自己授权、战斗中隐身、没有案件的封禁、传送到玩家身边)。每周公平性报告会写入 data/reports/;sentinel:staff report 可立即生成。管理记录中的任何内容都不会处罚管理人员。
11. 保护一个资源
无需任何设置,Sentinel 就会观察玩家能发给你脚本的每一个事件,并对玩家做出判断。它无法阻止其他资源的 handler 运行。要在脚本运行之前拦下恶意调用,请给那个脚本加上 guard。
sentinel:audit列出每个已启动资源中客户端可以触发的事件,并按其 handler 的行为分级(例如一个按客户端指定的金额发钱的 handler)。用它来决定先保护哪些资源。sentinel:guard <resource>会打印要添加的那一行,以及该资源的 server_scripts 添加后的样子。guard 行必须是第一个服务器脚本。这条命令只打印,不会修改任何文件。
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- 重启那个资源。
sentinel:guard <resource>现在会显示 "guarded since ..."。单独输入sentinel:guard会列出所有受保护的资源。 - 用
sentinel:patch添加规则。在某个资源有规则之前,它的 guard 会放行所有调用,但来自被隔离玩家的调用除外,每个 guard 都会丢弃这类调用。示例:10 秒内最多 3 次购买,物品名称最长 32 个字符,数量从 1 到 10;被拒绝的调用算作实证("hard": true):
text
sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}
对于框架回调,把 callback:<name> 写作事件:sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}。sentinel:patch <resource> 列出某个资源的规则;sentinel:patch <resource> <event> off 删除其中一条。
guard 从不修改文件,也从不改变 handler 收到的内容。它是 guard/guard.lua 中普通、可读的 Lua。
12. Discord 和片段存储密钥
最简单的方法是 owner desk 上的 KEYS:粘贴每个值,然后按 SAVE。密钥只保存在服务器上;owner desk 和每条回复都只显示 "set",绝不会再次显示密钥。
| owner desk 上的行 | 它是什么 | 或者在 server.cfg 中(用 set,绝不要用 setr) |
|---|---|---|
| Discord 机器人 token | 你在 discord.com/developers 创建并已邀请进你服务器的机器人 | set sentinel_discord_token "..." |
| Discord 服务器 ID | 右键点击你的服务器,Copy Server ID(需开启开发者模式) | set sentinel_discord_guild "..." |
| 警报频道 ID | 案件发布到这里,并带有给管理团队用的按钮 | set sentinel_discord_channel "..." |
| 申诉频道 ID | 申诉发布到这里 | set sentinel_discord_appeals "..." |
| FiveManage 密钥 | 来自 fivemanage.com 的媒体密钥;片段会上传到那里 | set sentinel_fivemanage_key "..." |
| 片段 webhook | 代替 FiveManage:一个接收片段的 Discord webhook | set sentinel_clip_webhook "..." |
| 片段存储 | fivemanage、discord、off,或自动(第一个已设置的) | set sentinel_clip_storage "..." |
server.cfg 中的密钥优先于 owner desk,owner desk 上也会注明。Discord 按钮遵循与控制台相同的角色和开关。如果这些都没有设置,案件和片段会留在你的服务器上(data/),并在控制台和面板中显示。
更简单的 webhook 警报仍然可用:set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>",或在服务器控制台输入 sentinel:webhook set <url>。sentinel:webhook test 发送一条测试消息;sentinel:webhook 显示状态,绝不会打印 URL;sentinel:webhook clear 删除已保存的那个。
13. 每条规则能抓到什么
每条规则触发时都会写下一句直白的话,说明它看到了什么、排除了什么。在一条规则对任何人计分之前,Sentinel 会先检查能解释它的原因(重生、revive、管理操作、你自己的某个会移动玩家或给玩家发钱的脚本)。已得到解释的检测结果会被记录,但绝不计分。
- Tier A 是实证:只有作弊才会做的事(一个没有任何真实脚本会调用的诱饵事件、一个伪造的请求)。
- Tier B 是强信号:应该由管理人员查看。单凭它本身,只有当两个不同的规则类别一致,或同一类别重复出现时,才会开一个案件。
- Tier C 是弱信号:它会增加分数,但绝不单独触发处理。
移动
| 规则 | 能抓到什么 | 可由以下情况解释 | Tier |
|---|---|---|---|
| teleport | 两次采样之间跳跃超过 150 m(或达到可能值的 3 倍) | 出生、重生或 revive、routing bucket 变更、管理人员、你的脚本的传送事件 | B |
| foot_speed | 步行时以超过 12 m/s 的速度奔跑 1.5 秒,且不在下落、不在 ragdoll 状态 | 出生、重生、管理人员、你的脚本 | B |
| air_float | 被冻结时仍在移动(noclip);"下落"却不落地(飞行);按坐标在快速移动,而游戏却显示玩家站着不动(加速菜单) | 出生、重生、管理人员、你的脚本 | B |
| foot_rise | 步行时以超过 4 m/s 的速度垂直上升 3 秒 | 出生、重生、管理人员、你的脚本 | B |
| vehicle_speed | 车辆速度超过其类别在你服务器上所能达到最高速度的 1.3 倍 | 管理人员、你的脚本 | B |
世界
| 规则 | 能抓到什么 | 可由以下情况解释 | Tier |
|---|---|---|---|
| entity_blocked | 生成你已屏蔽的模型 | 你那些会生成它的脚本 | B |
| entity_rate / entity_model_rate | 每分钟生成的实体(或某一个模型)远多于玩家和脚本的正常数量 | 你的生成类脚本 | B |
| entity_untrusted | 由客户端创建、却没有任何脚本会生成的实体 | 你的生成类脚本 | B |
| entity_disguised | 某个玩家周围突然出现大量相同的环境 ped 模型(菜单把它的生成伪装成路人和车流) | 出生、重生、bucket 变更 | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | 手持武器不可能造成的爆炸、过多的爆炸、不可见的爆炸,或距离玩家很远的爆炸 | 你的脚本产生的爆炸 | B |
| projectile_weapon / projectile_rate | 该武器不可能发射的投射物,或数量过多 | B | |
| ptfx_rate | 粒子特效刷屏(一种常见的崩溃和卡顿攻击) | B | |
| fire_rate | 起火速度超过任何武器所能达到的速度 | B |
战斗
| 规则 | 能抓到什么 | Tier |
|---|---|---|
| damage_plausibility | 伤害超过该武器可能造成的数值 | B |
| hit_range | 在武器射程之外命中 | B |
| shot_rate / kill_rate | 射速超过武器本身;每分钟击杀数远高于你的服务器的水平 | B |
| silent_aim | 反复命中玩家并未瞄准的位置 | B |
| aim_stats / aim_stats_backed | 在 30 场以上的交战中,爆头比例和甩枪角度远超你服务器上的玩家 | C(与另一类别一起时为 B) |
| esp_los_backed | 反复瞄准见证者报告为躲在墙后的玩家 | C 至 B |
事件与请求
| 规则 | 能抓到什么 | Tier |
|---|---|---|
| bait_event | 调用一个预先埋设、没有任何真实脚本使用的事件(作弊菜单会扫描并触发这类事件) | A |
| bait_statebag / statebag_write | 写入只应由服务器写入的 state bag(把自己设为管理员、godmode 标记),或写入过大的 state bag | A / B |
| events_before_ready / _trap | 玩家甚至还没出生就发送的事件(在进服之前注入) | B / A |
| event_rate / event_shape | 某个事件的调用频率远高于正常水平,或其参数形态与你服务器上的正常调用不同 | B |
| event_flood | 10 秒内 500 次以上调用;当 FiveM 自身因溢出而踢人时,会列出调用最多的事件 | B |
| guard_rule / guard_hard | 违反你为受保护事件设置的规则(数量、频率、距离) | B / A |
经济
| 规则 | 能抓到什么 | Tier |
|---|---|---|
| money_nowhere / item_nowhere | 没有任何商店、工作或脚本发放过的钱或物品(开发用事件、被泄露的商店出售事件) | B |
| economy_repeat | 某个奖励或工作事件在 30 秒内支付了 10 次(通过循环调用来刷钱) | B |
| money_jump / money_rate | 余额突然跳涨,或收入速度远高于你的服务器的水平 | B |
| economy_trap | 领取一个预先埋设、没有任何真实工作会支付的奖励 | A |
| weapon_not_owned | 手持一把背包从未发放过的武器 | B |
玩家的游戏(见证者)
| 规则 | 能抓到什么 | Tier |
|---|---|---|
| godmode | 服务器读到该玩家处于无敌状态达 30 秒(不是共享的安全区) | B |
| witness_backed | 来自游戏的迹象,并得到服务器自身视角的印证(godmode、隐身、无碰撞) | B |
| witness_bait | 游戏回应了一个它本不应该知道的检查 | A |
| witness_tamper | Sentinel 自己在游戏中的检查被 hook 或被修改 | B |
身份与文件
| 规则 | 能抓到什么 | Tier |
|---|---|---|
| ban_fingerprint | 被封禁的玩家换了新账户回来(硬件 token、标识符、浏览器指纹) | A / flag |
| young_account | 全新的账户(只增加权重) | C |
| scanner_error / too_large | 脚本扫描器无法读取的资源,或值得看一眼的超大文件 | info |
没有任何规则承诺的事
Sentinel 判断的是服务器能看到的内容和玩家的游戏所报告的内容。它不读取玩家电脑上的其他程序,也没有任何反作弊能保证抓到每一个作弊。每个检测结果都附带证据,所以你的管理团队是根据事实做决定。
14. 命令与配置
每条命令都在命令页面上,每个配置项都在配置页面上,两者都是直接从资源本身生成的。最常用的有:
| 命令 | 作用 |
|---|---|
/sentinel owner <code> |
用控制台中的代码在游戏内认领服主席位 |
/sentinel panel |
浏览器面板的一次性登录代码(仅限管理人员) |
/report <server id> <what happened> |
任何玩家举报一名玩家或一名管理人员 |
sentinel:health |
再次显示启动框 |
sentinel:diag |
Sentinel 做了什么决定以及原因 |
sentinel:level watch\|recommended\|strict |
更改防护等级并保存 |
sentinel:wave |
排入 ban wave 队列的封禁 |
sentinel:appeals |
未处理的申诉 |
sentinel:audit |
每个已启动资源中有风险的事件 |
sentinel:guard <resource> |
用来保护某个资源的那一行 |
sentinel:advisor |
你的服务器上值得更改的 FiveM 设置 |
config/ 中的配置文件(config.lua、protection.lua、watch.lua)和 config/locales/ 中的翻译对你开放,bridge/ 中的框架适配器和 guard/ 中的 guard 文件也是。请保持它们是有效的 Lua,并在修改后重启 zerodev_sentinel。首次启动不需要修改任何配置。
15. 启动框与加固顾问
存储就绪后片刻,Sentinel 会在服务器控制台打印一个框。FAIL 行表示 Sentinel 无法正常工作;WARN 行表示它能工作但功能减少(例如证据没有摘要)。随时可以用 sentinel:health 再次打印。
| 行 | 它检查什么 | 不是 OK 时 |
|---|---|---|
| Build | 来自 fxmanifest.lua 的版本和构建标签。 | - |
| OneSync | onesync convar。Sentinel 通过 OneSync 读取位置、实体和游戏事件。 |
在 server.cfg 中 set onesync on |
| Copies running | 该资源启动了多少份,无论文件夹叫什么名字。必须是 1。 | 只保留一份 Sentinel;停止另一个文件夹 |
| 存储 | 选择了哪种存储(mysql 或 kvp),以及它是否就绪。 | 参见 sentinel:diag storage |
| Evidence folder | 在资源内的 data/archive 中进行一次写入和读取测试。 | 在 Sentinel 资源内创建文件夹 data/archive,并确保服务器可以写入 |
| SHA-256 | node/util.js 是否有响应;它为每一份证据生成指纹。 | 证据保存时没有摘要;请检查控制台中是否有 Node 错误 |
| Protection | 防护等级、它的模式以及它的来源。 | - |
| 规则 | 有多少条规则处于 live,有多少条处于 shadow。 | - |
在启动框之后,顾问会打印你的服务器上值得更改的 FiveM 设置(Config.Advisor.atStartup = false 时只在输入 sentinel:advisor 时打印)。对每项设置,它会显示当前值、推荐值、它能拦住什么、可能会弄坏什么,以及可复制的那一行。它只读取这些值;绝不修改 server.cfg。保留某一行之前,请先在你的服务器上测试。
16. 语言,以及会记录什么
给玩家和管理人员看的文字来自 config/locales/<code>.lua,这个版本有 25 种语言。Config.Locale 选择语言;设置 Config.GameLanguage = true 后,如果玩家的游戏使用的是 GTA 提供的某种语言,他进入游戏后就会以该语言看到 Sentinel。
Sentinel 会为每位玩家在内存中保留大约最近两分钟的位置和事件(Config.Recorder),并把它们写入 data/archive/ 中的归档,时机是开立案件或管理人员使用 sentinel:save 时。审核期间,它会向嫌疑人的游戏请求屏幕片段(每段 20 秒),并把它们存放在 data/clips/ 中。它会保存 FiveM 提供给服务器的标识符(IP 地址会被记录,但默认绝不会用来拒绝连接),以及在 Discord 运行时的 Discord ID。每位玩家首次进服时都会收到一条以其语言显示的简短告知:服务器会录制游玩过程,管理人员可能会查看和监听(Config.Notice = false 可将其关闭;那就请在你的规则中告诉他们)。也请在你的隐私政策中说明这一点。
这个版本不会自动删除旧的归档和片段:不再需要时,请自行清空 data/archive/ 和 data/clips/。
使用 oxmysql 时,Sentinel 的记录保存在这些表中:zds_account、zds_ban、zds_setting、zds_pair、zds_exemption、zds_case、zds_schema、zds_report 和 zds_trail。没有 oxmysql 时,同样的记录保存在资源的 key-value 存储中(键以 zds: 开头)。封禁总会同步镜像到 key-value 存储,所以数据库宕机时封禁仍然生效。
17. 更新
新版本会发布到同一个 Keymaster 资源。Sentinel 把证据保存在自己的文件夹里,所以在替换它之前:
- 备份
zerodev_sentinel文件夹中的config/和data/文件夹(归档、片段、报告、学到的基线),使用 oxmysql 时还要备份zds_表。 - 停止服务器,用新的
zerodev_sentinel文件夹替换旧的(保持文件夹名称不变),再把你的data/文件夹放回去。把你改过的设置移到新的配置文件里,而不是用旧文件覆盖它们。 - 启动服务器并查看启动框(
sentinel:health)。
更新前,请先在更新日志中阅读新版本的更新说明。
18. 卸载
- 从你保护过的每个资源中删除 guard 行(
sentinel:guard会列出它们),并重启这些资源。请先做这一步:文件夹一旦删除,guard 文件也就没有了。 - 从 server.cfg 中删除
ensure zerodev_sentinel以及sentinel.admin/sentinel.staff行,然后停止该资源。如果sentinel:lockdown改过 entity lockdown,停止 Sentinel 会恢复原来的模式。 - 删除
zerodev_sentinel文件夹。这会连同data/以及所有归档、片段和报告一起删除,所以请先把想保留的内容复制出来。 - 使用 oxmysql 时,如果你不再需要这些封禁和案件,请删除第 16 节列出的
zds_表。key-value 记录会以该资源的名称留在服务器的存储中,没有该资源时它们不起任何作用。
Sentinel 只写入自己的文件夹、自己的数据库表和自己的 key-value 存储。它不会修改其他资源或 server.cfg。
常见问题
Sentinel 会自行封禁或踢出玩家吗?
在 Watch 或 Recommended 下不会。它从 Watch 开始,只记录本来会做什么。在 Recommended 下,管理团队拿到证据并做决定。只有在 Strict 下,高分才会把玩家隔离,直到管理人员查看,实证级的检测结果才会把一次封禁排入 ban wave 队列。
需要数据库吗?
不需要。使用 oxmysql 时,Sentinel 会把记录存进你的数据库,并在首次启动时自行建表;无需导入 SQL 文件。没有 oxmysql 时,所有内容都保存在资源自带的 key-value 存储中。
它能在 QBCore 和 Qbox 上运行吗?
是的。检测、案件、片段、控制台、浏览器面板、Discord 和 owner desk 在所有框架上都相同。资金和物品追踪为 ESX、QBCore、Qbox 和 ox_inventory 各有专用适配器。
如何给我的管理员授权?
在 owner desk 的 STAFF 中:选择一名在线玩家,选择一个角色,按 GRANT。或者继续使用 ACE:sentinel.admin 赋予 Admin,sentinel.staff 赋予 Moderator。
被封禁的玩家可以申诉吗?
可以。拒绝连接的提示中会显示申诉码。玩家把它发给你的管理团队,由他们用 sentinel:appeal 记录,或者由你的网站把它提交到 Sentinel 的申诉接口。管理团队在控制台中或用 sentinel:decide 接受或驳回。
它能看到玩家电脑上的作弊程序吗?
不能。Sentinel 判断的是服务器能看到的内容和玩家的游戏所报告的内容。它不读取玩家电脑上的其他程序。
语音聊天监听功能可以用了吗?
它需要 pma-voice 和监听开关(默认仅限服主),并通过你自己的游戏播放。
玩家会看到什么?
首次进服时,会有一条以其语言显示的简短告知:服务器会录制游玩过程,管理人员可能会查看和监听(Config.Notice)。对没有作弊的玩家来说,其他一切不变。