ZeroDev Sentinel ドキュメント
ZeroDev Sentinel:インストールと使い方
ZeroDev Sentinel は FiveM 用のサーバーサイド・アンチチートリソースです。サーバーが見ているものを記録し、自分の判断理由をわかりやすい文で説明するルールで評価し、誰かを処罰する前にスタッフへ証拠を渡します。最初は保護レベル Watch で起動します。あなたが別の設定を選ぶまで、ログを取るだけで誰も処罰しません。このガイドは ESX、QBCore、Qbox、standalone サーバー上のバージョン 0.1.2 を対象としています。
1. 動作要件
- OneSync を有効にする(server.cfg に
set onesync on)。このリソースは OneSync を依存関係として宣言しているため、OneSync がないと FXServer はこのリソースを起動しません。 - Node 22 のスクリプトを実行できる FXServer アーティファクト(現在の推奨アーティファクトならどれでも可。manifest は
node_version '22'を指定しています)。Node はハッシュ計算、圧縮、ファイル一覧、異議申し立て用の Web ルートを担当します。 - 任意:oxmysql。 oxmysql があれば、Sentinel は記録をデータベースに保存し、初回起動時に自分でテーブルを作成します。インポートする SQL ファイルはありません。oxmysql がない場合は、すべてリソース自身のキーバリューストアに保存されます。
- 任意:pma-voice。コンソールやブラウザパネルからプレイヤーのボイスチャットを聞くために使います。
フレームワークが関係するのは2点だけです。お金とアイテムの追跡(どのショップ、ジョブ、スクリプトも支払っていないお金やアイテム、報酬ループ、ロールバック)と、誰がスタッフか(すべてのフレームワークが使う ACE グループ)です。検出、ケース、クリップ、コンソール、ブラウザパネル、Discord、オーナーデスクは、どのフレームワークでも同じように動きます。
2. 5分でインストール
SQL は一切不要で、初回起動のために config を編集する必要もなく、ほかのリソースが変更されることもありません。
3. お使いのフレームワーク
Sentinel は起動時にフレームワークとインベントリを自動で見つけます。設定することは何もありません。サーバーコンソールで sentinel:trail を実行すると、選ばれたアダプターがわかります。
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- お金とアイテム: ESX 自身のサーバーイベントから読み取ります(口座のお金の追加・削除・設定、インベントリアイテムの追加・削除、プレイヤー間のアイテムの受け渡しを両側をひも付けて記録)。ロールバックは 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 では、そのフックを通じてアイテムを追跡します。qb-inventory ではアイテムの変化は追跡しません(リスナーのペイロードがドキュメント化されていないため)が、ロールバックでは 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 のフックでアイテムを追跡します。フレームワークのお金を表すアイテムは、フレームワーク側の処理に任せます。
- スタッフ: QBCore と同じく ACE グループです。
Standalone(framework なし)
set onesync on
ensure zerodev_sentinel- お金とアイテムの追跡以外はすべて動作します:移動、ワールド、イベント、おとりイベント、ゴッドモード、state bag、武器、ケース、クリップ、リプレイ、コンソール、パネル、Discord、ロール、BAN。
- ox_inventory があってフレームワークがない場合、アイテムは ox_inventory を通じて追跡します。
- ストレージ:キーバリューストア、または先に起動していれば oxmysql。
動作の確認
sentinel:health:起動ボックスをもう一度表示します。各行は実際のチェックで、READY は何も不足していないことを意味します。sentinel:diag:ストレージ、アダプター、レベルが選ばれた理由、各ルールとそのカウンター、最新の判定。sentinel:trail:使用中のお金とアイテムのアダプターと、1人のプレイヤーの最近の変化。
自動ストレージモードでは、Sentinel は oxmysql がすでに起動している場合にだけ oxmysql を使います(oxmysql の起動中は最大15秒待ちます)。oxmysql が後から起動した場合は、キーバリューストアを使います。
4. 初回起動:オーナー席
初回起動時に、30分間有効なワンタイムコードがサーバーコンソールに表示されます(sentinel:owner code で新しいコードを表示)。サーバーに参加して /sentinel owner <code> と入力すると、オーナー席があなたのアカウントにひも付けられ、コードは無効になります。
キー、保護レベル、ロール、権限を変更できるのはオーナー席だけです。別のアカウントに移す必要がある場合は、サーバーコンソールで sentinel:owner reset を実行すると席が空きます。
5. スタッフと権限
オーナーデスクの STAFF で、オンラインのプレイヤーを選び、ロールを選んで GRANT を押します。用意されているロールは4つです:
| ロール | 初期状態でできること |
|---|---|
| サポート | ケースの閲覧、通報の対応、勤務マップ |
| Moderator | Support の権限に加えて、リプレイ、キック、隔離 |
| Admin | Moderator の権限に加えて、開示、クリア、ライブビュー、BAN 申請、異議申し立て |
| Senior admin | Admin の権限に加えて、即時に適用される BAN |
権限はあなたが決められます。 各ロールは変更可能なスイッチの一覧です。コピーから独自のロールを作ったり(例:"Trial mod")、どのロールの名前も変えたり、ロールを変えずに特定の1人にだけスイッチを追加・削除したりできます。危険と表示されたスイッチ(即時 BAN、ボイスチャットの傍聴、設定、スタッフ管理)は、もう一度押す必要があります。すべての変更はスタッフ記録に書き込まれるので、誰が何を変えたかをいつでも確認できます。
すでに 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. 保護レベル
オーナーデスクのスイッチ1つ(OWNER、PROTECTION)で切り替えます。サーバーコンソールの sentinel:level や、Config.Protection(config/config.lua 内)でも設定できます。デスクで設定した内容は保存され、再起動後は config の行より優先されます。
- Watch: すべてのルールが監視し、自分ならどうしたかを書き残します。誰にも通知されず、誰にも何も起きません。その間に Sentinel はあなたのサーバーで何が普通かを学習します。イベントオブザーバー(各イベントの頻度と形)と参加時チェックは Watch のときだけ学習し、エンティティ・戦闘・お金の上限はクリーンなプレイから学習を続けます。
- Recommended: すべてのルールが有効になります。スタッフには証拠付きのアラートが届き、ケースが開かれます。Sentinel が自分から処罰することはなく、判断するのはスタッフです。
- Strict: Recommended と同じ動作に加え、スコアが高いとスタッフが確認するまでプレイヤーを隔離します。証拠レベルの検出(Tier A:おとりイベントの発火、偽造されたリクエスト)があった場合は、BAN ウェーブ用の BAN もキューに入れます。
スイッチの下には、各ルールとその状態、状態の出どころが一覧表示されます。サーバーに必要なら、そこで個別のルールを Live または Shadow に固定できます(たとえば、自分のスクリプトの1つを何度もフラグするルールなど)。state の行を Config.Rules に書くと config ファイル側で固定され、デスクより優先されます。
おすすめの進め方:
- 数日間、通常のプレイを Watch で見守る。
- ルールがどうしていたかを確認する:Right now シート、
sentinel:diag rules(shadow 列はそのルールがスコアを付けていたはずの回数)、sentinel:diag decisions 100。 - 信頼できる人をフラグしたルールは Shadow に固定し、私たちに知らせてください。
- Recommended に切り替える。これでスタッフはケースと証拠を見られます。自動で処罰されることはありません。
- Recommended の結果を信頼できるようになったら Strict に。
いつでも戻せます:デスクで Watch を選ぶか、sentinel:level watch を実行します。
7. スタッフコンソール(F7)
ゲーム内で F7 を押します(または F8 で sentinel:console と入力します)。キーは各プレイヤーがゲームの設定(Key Bindings、FiveM)で変更できます。Esc で閉じます。
- Right now は、サーバーで何が起きているかをわかりやすい言葉で伝えます。誰が脅威に見えるのかとその理由、何が証明されたか、何に説明がついたか(蘇生、自分のスクリプトによるテレポートなど)、そして何にあなたの対応が必要か。重要なプレイヤーにはそれぞれ1行が割り当てられます:何をしたか、おそらく何なのか、Sentinel の確信度(Unusual、Suspicious、Very likely、Proven)、Sentinel がすでに行ったこと、そして次の一手が1つ。
- ケースファイル:未解決のケースが先頭に並び、それぞれに検知内容、証拠、画面クリップ、封印(ケースのハッシュチェーンがまだ検証できるか)と、REVEAL、QUARANTINE、CLEAR、BAN のキーがあります(CLEAR と BAN は2回目の押下が必要です)。
- 勤務マップ:オンラインのプレイヤーを島の3Dモデル上に表示します。地形は最初のスタッフのゲームで計測され、
data/map/に保存されます。 - Play replay はコンソールを閉じ、プライベートなワールドでインシデントを再生します。Backspace で戻ります。
- オーナー(オーナー席のみ):First run、Protection、Keys、Staff、Internal affairs、Server check。
ゲーム内のコマンドは、F8 ならスラッシュなしで、チャットならスラッシュ付きで入力します(/sentinel:diag)。
8. ブラウザパネル
ゲームに入っていないときのための、Web ブラウザ版の同じデスクです:
- サーバー PC 上で:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(ポートはサーバーのポートで、デフォルトは 30120) - ほかの場所から:
http://<server address>:<port>/zerodev_sentinel/panel/、またはその前に置いた独自の HTTPS アドレス
サインイン。1回限りのコードを使います。ゲーム内で /sentinel panel と入力するか(コードはあなたにだけ表示され、1回だけ、5分間有効です)、サーバーコンソールで sentinel:panel <id or account> を実行します。セッションは8時間続き、SIGN OUT と END ALL MY SESSIONS で終了します。ロールとスイッチは、ブラウザでもゲーム内とまったく同じように適用されます。
ライブビュー。ライブビューのスイッチを持つスタッフは、パネルまたはコンソールから、オンラインのどのプレイヤーの画面も見られます。Save to case を押さない限り、ディスクには何も保存されません。
聴取。そのプレイヤーのボイスチャットを聞くには、聴取のスイッチ(デフォルトではオーナーのみ)と pma-voice が必要です。音声はあなた自身のゲームを通して再生されるので、同じサーバーにゲームで入っておいてください。
ライブビューと聴取はすべてスタッフ記録とプレイヤーのケースに書き込まれます。また、プレイヤーには初回参加時に、スタッフが画面を見たり音声を聞いたりする場合があることが通知されます(録画の通知、Config.Notice)。
9. ケース、隔離、キック、BAN、異議申し立て
何かが見つかると、Right now がそのプレイヤーをわかりやすい言葉で示します:何をしたか、Sentinel の確信度、そして Sentinel がどう対処したか。ケースを開くと証拠(位置、SHA-256 で封印された画面クリップ、3D リプレイ)を確認でき、次のキーを使えます:
- REVEAL:プレイヤーの識別子を表示します。
- QUARANTINE:スタッフが確認するまで、プレイヤーを通常のワールドからプライベートな routing bucket に移します。
sentinel:release <server id>で戻します。 - CLEAR:チートではない。ケースを閉じ、予約されている BAN を止めます。
- KICK:サーバーから追い出します。理由はプレイヤーに表示されます。
- BAN:ban wave を通して、異議申し立てコード付きで実行します。
ban wave。BAN は、コンソールで押した BAN も含めて ban wave の待機列に入り、Strict の場合にのみ、デフォルトでは2〜24時間後のランダムな時刻に実行されます(Config.Actions)。sentinel:wave で一覧表示、sentinel:wave now <account> で1件を即時実行、sentinel:wave cancel <account> で取り消します。
異議申し立て。BAN されたプレイヤーには、拒否メッセージに異議申し立てコード(英数字8文字)が表示されます。異議を申し立てるためにサーバーへ入ることはできないので、異議申し立てはゲームの外から届きます:
- スタッフ経由。プレイヤーがコードをスタッフに送ります(Discord のチケット、メール)。スタッフが
sentinel:appeal <code> <text>で記録します。 - Web ルート経由。Sentinel はサーバー自身のアドレスで応答します:
http://<server address>:<port>/zerodev_sentinel/appeal。受け付けるのは JSON の POST{ "code": "...", "text": "...", "contact": "optional" }(テキストは 10〜2000 文字)だけなので、プレイヤーに案内するページではなく、自分の Web サイトのフォーム用です。受け付けたリクエストには、コードが BAN と一致したかどうかに関係なく、すべて同じ応答 202 "received" を返します。1つのアドレスからのリクエストが多すぎる場合(10分間に5件)や全体で多すぎる場合(1分間に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] で判断します。accept はそのアカウントまたはケースの有効な BAN をすべて解除し、待機中の wave BAN を取り消します。reject は BAN を維持します。判断は最終的なもので、ケースログに書き込まれます。sentinel:appeals で未処理のものを一覧表示します。
10. 通報と内部監査
プレイヤーの通報。どのプレイヤーも /report <server id> <what happened> と入力して、プレイヤーやスタッフを通報できます。両プレイヤーの直前2分間がケースに保存されます。スタッフは通報を「対応済み」「違反なし」「証拠なし」「重複」のいずれかとして閉じます。スタッフに関する通報はオーナーにだけ届きます。
内部監査(オーナーのみ、オーナーデスク上):各スタッフが何をしたか、そして確認が必要なもの(自分への付与、戦闘中に姿を隠すこと、ケースのない BAN、プレイヤーへのテレポート)。週次の公正性レポートが data/reports/ に書き出されます。sentinel:staff report で今すぐ書き出せます。スタッフ記録の内容によってスタッフが処分されることはありません。
11. リソースの保護
何も設定しなくても、Sentinel はプレイヤーがスクリプトに送れるすべてのイベントを監視し、そのプレイヤーを判定します。ただし、ほかのリソースのハンドラーが実行されるのを止めることはできません。スクリプトが実行される前に不正な呼び出しを止めたい場合は、そのスクリプトに guard を追加します。
sentinel:auditは、起動中のすべてのリソースについて、クライアントがトリガーできるイベントを、ハンドラーの動作に応じた評価付きで一覧表示します(たとえば、クライアントが選んだ金額でお金を渡すハンドラー)。どのリソースから先に保護するかを決めるのに使ってください。sentinel:guard <resource>は、追加する行と、追加後のリソースの server_scripts を表示します。guard の行は最初の server script でなければなりません。このコマンドは表示するだけで、ファイルは一切変更しません。
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 で1つ削除します。
guard がファイルを編集することはなく、ハンドラーが受け取る内容を変えることもありません。guard/guard.lua にある、シンプルで読みやすい Lua です。
12. Discord とクリップ保存先のキー
いちばん簡単なのはオーナーデスクの KEYS です。それぞれの値を貼り付けて SAVE を押します。キーはサーバーにだけ保存されます。デスクもすべての応答も "set" とだけ表示し、キーを再び表示することはありません。
| デスク上の項目 | 内容 | または server.cfg で(set を使い、setr は使わないでください) |
|---|---|---|
| Discord ボットトークン | 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、または automatic(設定されている最初のもの) | set sentinel_clip_storage "..." |
server.cfg のキーはデスクより優先され、デスクにもそう表示されます。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 はそれを説明できる理由(リスポーン、蘇生、スタッフの操作、プレイヤーを移動させたりお金を払ったりする自分のスクリプト)を確認します。説明がついた検知内容は記録されるだけで、スコアには加算されません。
- ティア A は証拠です:チートにしかできないこと(本物のスクリプトがどれも呼ばないおとりイベント、偽造されたリクエスト)。
- ティア B は強い兆候です:スタッフが確認すべきもの。単独でケースを開くのは、2つの異なるファミリーが一致したとき、または同じものが繰り返されたときだけです。
- ティア C は弱い兆候です:スコアに加算されるだけで、単独で動くことはありません。
移動
| ルール | 検知するもの | 説明がつくケース | ティア |
|---|---|---|---|
| teleport | 2つのサンプル間で 150 m を超える(または可能な距離の 3x を超える)移動 | スポーン、リスポーン、蘇生、routing bucket の変更、スタッフ、自分のスクリプトのテレポートイベント | B |
| foot_speed | 徒歩で 12 m/s を超える速度で 1.5 s 走っている(落下中でも ragdoll でもない) | スポーン、リスポーン、スタッフ、自分のスクリプト | B |
| air_float | フリーズ中に移動している(noclip)、「落下中」なのに降りてこない(fly)、ゲーム上は静止しているのに座標上は高速で移動している(スピードメニュー) | スポーン、リスポーン、スタッフ、自分のスクリプト | B |
| foot_rise | 徒歩で 3 s のあいだ、4 m/s より速く真上に上昇している | スポーン、リスポーン、スタッフ、自分のスクリプト | B |
| vehicle_speed | そのクラスがあなたのサーバーで出す最高速度の 1.3x を超える車両 | スタッフ、自分のスクリプト | B |
ワールド
| ルール | 検知するもの | 説明がつくケース | ティア |
|---|---|---|---|
| entity_blocked | ブロックしたモデルのスポーン | そのモデルをスポーンさせる自分のスクリプト | B |
| entity_rate / entity_model_rate | プレイヤーやスクリプトよりはるかに多いエンティティ(または1つのモデル)を1分間にスポーンさせる | スポーンを行う自分のスクリプト | B |
| entity_untrusted | スポーンさせるスクリプトがないのに、クライアントが作成したエンティティ | スポーンを行う自分のスクリプト | B |
| entity_disguised | 1人のプレイヤーの周りに同じアンビエント ped モデルが一斉に現れる(スポーンを交通に見せかけるメニュー) | スポーン、リスポーン、bucket の変更 | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | 持っている武器では起こせない爆発、多すぎる爆発、見えない爆発、プレイヤーから遠く離れた爆発 | 自分のスクリプトによる爆発 | B |
| projectile_weapon / projectile_rate | その武器では撃てない弾、または多すぎる弾 | B | |
| ptfx_rate | パーティクルエフェクトの大量発生(よくあるクラッシュ・ラグ攻撃) | B | |
| fire_rate | どの武器でも不可能な速さで起こされる火災 | B |
戦闘
| ルール | 検知するもの | ティア |
|---|---|---|
| damage_plausibility | その武器で出せる値を超えるダメージ | B |
| hit_range | 武器の射程外からの命中 | B |
| shot_rate / kill_rate | 武器の限界より速い射撃、あなたのサーバーの通常をはるかに超える1分あたりのキル数 | B |
| silent_aim | プレイヤーが狙っていない場所への命中が繰り返される | B |
| aim_stats / aim_stats_backed | 30+ 回の戦闘で、ヘッドショット率とスナップ角度があなたのサーバーのプレイヤーから大きく外れている | C(別のファミリーと合わせて B) |
| esp_los_backed | ウィットネスが壁の向こうに隠れていると報告したプレイヤーを繰り返し狙う | C〜B |
イベントとリクエスト
| ルール | 検知するもの | ティア |
|---|---|---|
| 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 s で 500+ 回の呼び出し。FiveM 自身のオーバーフローによるキックの際は、上位のイベントが一覧表示されます | B |
| guard_rule / guard_hard | 保護されたイベントに設定したルール(金額、頻度、距離)への違反 | B / A |
経済
| ルール | 検知するもの | ティア |
|---|---|---|
| money_nowhere / item_nowhere | どのショップ、仕事、スクリプトも渡していないお金やアイテム(開発用イベント、流出したショップの売却処理) | B |
| economy_repeat | 報酬や仕事のイベントが 30 s で10回支払われる(ループで呼び出して稼ぐ行為) | B |
| money_jump / money_rate | 残高の急な跳ね上がり、またはあなたのサーバーの通常をはるかに超える稼ぎのペース | B |
| economy_trap | 本物の仕事がどれも支払わない、仕掛けられた報酬の受け取り | A |
| weapon_not_owned | インベントリが一度も渡していない武器を持っている | B |
プレイヤーのゲーム(ウィットネス)
| ルール | 検知するもの | ティア |
|---|---|---|
| godmode | サーバー側で 30 s のあいだプレイヤーが無敵と読み取れる(共有のセーフゾーンではない) | B |
| witness_backed | サーバー自身の観測で裏付けられた、ゲームからの兆候(godmode、透明化、当たり判定なし) | B |
| witness_bait | ゲームが、知っているはずのないチェックに応答している | A |
| witness_tamper | ゲーム内の Sentinel 自身のチェックがフックまたは改変されている | B |
アイデンティティとファイル
| ルール | 検知するもの | ティア |
|---|---|---|
| ban_fingerprint | BAN されたプレイヤーが新しいアカウントで戻ってきた(ハードウェアトークン、識別子、ブラウザのフィンガープリント) | A / flag |
| young_account | 作られたばかりのアカウント(重みを加えるだけ) | C |
| scanner_error / too_large | スクリプトスキャナーが読めなかったリソース、または確認する価値のある大きすぎるファイル | info |
どのルールも約束しないこと
Sentinel が判定するのは、サーバーから見えるものと、プレイヤーのゲームが報告するものです。プレイヤーの PC 上のほかのプログラムは読み取りません。また、どのアンチチートも、すべてのチートを捕まえられるとは約束できません。検知内容にはすべて証拠が付いているので、スタッフは事実に基づいて判断できます。
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 の待機列にある BAN |
sentinel:appeals |
未処理の異議申し立て |
sentinel:audit |
起動中の全リソースの危険なイベント |
sentinel:guard <resource> |
リソースを保護する行 |
sentinel:advisor |
サーバーで変更する価値のある FiveM の設定 |
config/ 内の config ファイル(config.lua、protection.lua、watch.lua)と config/locales/ 内の翻訳は自由に編集できます。bridge/ 内のフレームワークアダプターと guard/ 内の guard ファイルも同様です。有効な Lua のまま保ち、変更後は zerodev_sentinel を再起動してください。初回起動のために config を編集する必要はありません。
15. 起動ボックスとハードニングアドバイザー
ストレージの準備ができた少し後に、Sentinel はサーバーコンソールにボックスを表示します。FAIL の行は Sentinel が正しく動作できないことを、WARN の行は機能を減らして動作していること(たとえばダイジェストなしの証拠)を意味します。sentinel:health でいつでも再表示できます。
| 行 | チェック内容 | OK でないとき |
|---|---|---|
| ビルド | fxmanifest.lua のバージョンとビルドラベル。 | - |
| OneSync | onesync の convar。Sentinel は位置、エンティティ、ゲームイベントを OneSync 経由で読み取ります。 |
server.cfg で onesync を on に設定 |
| 起動中のコピー | フォルダ名に関係なく、このリソースのコピーがいくつ起動しているか。1 でなければなりません。 | Sentinel のコピーは1つだけ残し、もう一方のフォルダは停止 |
| ストレージ | どのストレージが選ばれたか(mysql または kvp)と、準備ができているか。 | sentinel:diag storage を参照 |
| 証拠フォルダ | リソース内の data/archive へのテスト書き込みと読み込み。 | Sentinel リソース内に data/archive フォルダを作成し、サーバーが書き込めることを確認 |
| SHA-256 | node/util.js が応答するかどうか。すべての証拠のフィンガープリントを作成します。 | 証拠はダイジェストなしで保存されます。コンソールで Node のエラーを確認 |
| 保護 | 保護レベル、そのモード、どこから設定されたか。 | - |
| ルール | 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 はプレイヤーごとに直近約2分間の位置とイベントをメモリに保持し(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: で始まるキー)に保存されます。BAN は常に key-value ストアにも複製されるため、データベースが落ちている間も有効なままです。
17. アップデート
新しいバージョンは同じ Keymaster アセットで公開されます。Sentinel は証拠を自分のフォルダ内に保存しているため、置き換える前に次のことを行ってください:
zerodev_sentinelフォルダ内のconfig/とdata/フォルダ(アーカイブ、クリップ、レポート、学習したベースライン)をバックアップし、oxmysql の場合はzds_テーブルもバックアップします。- サーバーを停止し、
zerodev_sentinelフォルダを新しいものに置き換え(フォルダ名はそのまま)、data/フォルダを元に戻します。古いファイルで上書きするのではなく、変更した設定を新しい config ファイルに移してください。 - サーバーを起動し、起動ボックス(
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 の場合、BAN やケースが不要になったら、セクション16に記載の
zds_テーブルを削除します。key-value の記録はリソース名の下でサーバーのストアに残りますが、リソースがなければ何もしません。
Sentinel が書き込むのは、自分のフォルダ、自分のデータベーステーブル、自分の key-value ストアだけです。他のリソースや server.cfg は編集しません。
よくある質問
Sentinel が勝手に BAN やキックをすることはありますか?
Watch と Recommended ではしません。最初は Watch で始まり、実行したであろう処分を記録するだけです。Recommended ではスタッフが証拠を受け取って判断します。Strict のときだけ、高いスコアでプレイヤーをスタッフが確認するまで隔離し、証拠レベルの検知で BAN を ban wave の待機列に入れます。
データベースは必要ですか?
いいえ。oxmysql があれば、Sentinel はデータベースに記録を保存し、初回起動時に自分のテーブルを作成します。インポートする SQL ファイルはありません。なければ、すべてリソース独自の key-value ストアに保存されます。
QBCore や Qbox で動きますか?
はい。検知、ケース、クリップ、コンソール、ブラウザパネル、Discord、オーナーデスクはどのフレームワークでも同じです。お金とアイテムの追跡には、ESX、QBCore、Qbox、ox_inventory それぞれ専用のアダプターがあります。
管理者にアクセス権を与えるには?
オーナーデスクの STAFF で、オンラインのプレイヤーを選び、ロールを選んで GRANT を押します。または ACE を使い続けることもできます。sentinel.admin で Admin、sentinel.staff で Moderator が付与されます。
BAN されたプレイヤーは異議を申し立てられますか?
はい。接続拒否メッセージに異議申し立てコードが表示されます。プレイヤーがそれをスタッフに送り、スタッフが sentinel:appeal で登録するか、ウェブサイトが Sentinel の異議申し立てルートに送信します。スタッフはコンソールまたは sentinel:decide で承認または却下します。
プレイヤーの PC 上のチートプログラムは見えますか?
いいえ。Sentinel が判断するのは、サーバーから見えるものとプレイヤーのゲームが報告する内容です。プレイヤーの PC 上の他のプログラムは読み取りません。
ボイスチャットの傍聴機能は完成していますか?
pma-voice と傍聴スイッチ(初期設定ではオーナーのみ)が必要で、音声は自分のゲームを通して再生されます。
プレイヤーには何が見えますか?
初めて参加したときに、サーバーがプレイを記録していることと、スタッフが見たり聞いたりできることを伝える短い通知が本人の言語で表示されます(Config.Notice)。問題のないプレイヤーにとって、それ以外は何も変わりません。