ZeroDev Sentinel 문서

ZeroDev Sentinel: 설치 및 사용 방법

ZeroDev Sentinel은 FiveM용 서버 사이드 안티치트 리소스입니다. 서버가 보는 것을 기록하고, 판단 이유를 알기 쉬운 문장으로 스스로 설명하는 규칙으로 평가하며, 누군가를 처벌하기 전에 스태프에게 증거를 줍니다. 처음에는 보호 레벨 Watch로 시작합니다. 다른 설정을 고르기 전까지는 기록만 하고 아무도 처벌하지 않습니다. 이 가이드는 ESX, QBCore, Qbox, standalone 서버에서의 버전 0.1.2를 다룹니다.

ZeroDev Sentinel 0.1.2 기준23분 분량업데이트

1. 요구 사항

  • OneSync 켜기 (server.cfg에 set onesync on). 이 리소스는 OneSync를 의존성으로 선언하므로, OneSync가 없으면 FXServer가 리소스를 시작하지 않습니다.
  • Node 22 스크립트를 실행하는 FXServer 아티팩트 (현재 권장 아티팩트라면 무엇이든 됩니다. manifest가 node_version '22'를 요구합니다). Node는 해싱, 압축, 파일 목록, 이의 제기 웹 경로를 담당합니다.
  • 선택: oxmysql. oxmysql이 있으면 Sentinel은 기록을 데이터베이스에 저장하고, 첫 시작 때 테이블을 직접 만듭니다. 가져올 SQL 파일은 없습니다. 없으면 모든 데이터가 리소스 자체의 키-값 저장소에 저장됩니다.
  • 선택: pma-voice. 콘솔이나 브라우저 패널에서 플레이어의 보이스 채팅을 듣는 데 필요합니다.

프레임워크가 중요한 건 두 가지뿐입니다. 돈과 아이템 추적(어떤 상점, 직업, 스크립트도 지급하지 않은 돈과 아이템, 보상 루프, 롤백)과 누가 스태프인지(모든 프레임워크가 사용하는 ACE 그룹)입니다. 탐지, 케이스, 클립, 콘솔, 브라우저 패널, Discord, 오너 데스크는 어떤 프레임워크에서도 똑같이 작동합니다.

2. 5분 설치

SQL은 전혀 필요 없고, 첫 시작을 위해 config를 고칠 필요도 없으며, 다른 리소스도 바뀌지 않습니다.

1단계: 폴더를 resources에 넣기

zerodev_sentinel 폴더를 resources 폴더에 복사합니다. 폴더 이름은 반드시 그대로 두세요. guard 파일은 zerodev_sentinel로 보고하며, 폴더 이름이 다르면 sentinel:guard가 경고합니다.

2단계: server.cfg에 추가하기

저장소와 돈 추적이 시작할 때 찾을 수 있도록 oxmysql과 프레임워크 다음에 시작하세요. 프레임워크별 정확한 순서는 섹션 3에 있습니다.

3단계: 서버 시작하기

콘솔에 시작 박스와 일회용 오너 코드가 출력됩니다. 박스의 각 줄은 실제 검사이며, 마지막 줄에는 READY 또는 문제 개수와 함께 NOT READY가 표시됩니다(섹션 15).

4단계: 오너 자리 차지하기

서버에 접속해 채팅에 /sentinel owner <code>를 입력하세요. 이제 오너 자리는 당신 것입니다(섹션 4).

5단계: 오너 데스크 열기

게임에서 F7을 누르고(또는 F8에 sentinel:console 입력) OWNER를 엽니다. First run 시트에 끝난 것과 아직 안 된 것이 표시됩니다: Discord, 클립 저장소, 스태프와 그 권한. 줄마다 버튼이 하나씩 있습니다. 그다음 Watch 상태로 며칠 플레이하고, Right now 시트에서 Sentinel이 찾은 내용을 읽은 뒤, 같은 데스크에서 보호 레벨을 Recommended로 바꾸세요(섹션 6).

3. 사용 중인 프레임워크

Sentinel은 시작할 때 프레임워크와 인벤토리를 스스로 찾습니다. 설정할 것은 없습니다. 서버 콘솔의 sentinel:trail로 어떤 어댑터를 골랐는지 볼 수 있습니다.

ESX Legacy

server.cfg
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

server.cfg
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

server.cfg
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 없음)

server.cfg
set onesync on
ensure zerodev_sentinel
  • 돈과 아이템 추적을 제외한 모든 것이 작동합니다: 이동, 월드, 이벤트, 미끼 이벤트, 갓모드, state bag, 무기, 케이스, 클립, 리플레이, 콘솔, 패널, Discord, 역할, 밴.
  • 프레임워크 없이 ox_inventory만 있으면 아이템은 ox_inventory를 통해 추적합니다.
  • 저장소: 키-값 저장소, 또는 먼저 시작했다면 oxmysql.

작동 확인

  • sentinel:health: 시작 박스를 다시 보여 줍니다. 각 줄은 실제 검사이며, READY는 빠진 것이 없다는 뜻입니다.
  • sentinel:diag: 저장소, 어댑터, 레벨이 선택된 이유, 각 규칙과 그 카운터, 최근 결정.
  • sentinel:trail: 사용 중인 돈·아이템 어댑터와 플레이어 한 명의 최근 변경 내역.

자동 저장소 모드에서 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 권한에 더해 공개, 해제, 라이브 뷰, 밴 요청, 이의 제기
Senior admin Admin 권한에 더해 즉시 적용되는 밴

권한은 직접 정할 수 있습니다. 각 역할은 바꿀 수 있는 스위치 목록입니다. 복사본으로 나만의 역할을 만들고(예: "Trial mod"), 어떤 역할이든 이름을 바꾸고, 역할은 그대로 둔 채 특정 한 사람에게만 스위치를 추가하거나 뺄 수 있습니다. 위험으로 표시된 스위치(즉시 밴, 보이스 채팅 청취, 설정, 스태프 관리)는 한 번 더 눌러야 합니다. 모든 변경은 스태프 기록에 남으므로 누가 무엇을 바꿨는지 언제든 볼 수 있습니다.

이미 ACE를 쓰고 있는 서버에서는 ACE도 계속 작동하며, 검사할 때마다 읽습니다:

server.cfg
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, PROTECTION)로 바꾸며, 서버 콘솔의 sentinel:level, 그리고 Config.Protection(config/config.lua 안)으로도 설정할 수 있습니다. 데스크에서 설정한 값은 저장되며, 재시작 후 config 줄보다 우선합니다.

  • Watch: 모든 규칙이 지켜보며 자신이 무엇을 했을지 기록합니다. 아무에게도 알림이 가지 않고 아무에게도 아무 일도 일어나지 않습니다. 그동안 Sentinel은 서버에서 무엇이 정상인지 배웁니다. 이벤트 관찰기(각 이벤트의 빈도와 형태)와 접속 검사는 Watch에서만 학습하고, 엔티티·전투·돈 한도는 깨끗한 플레이에서 계속 학습합니다.
  • Recommended: 모든 규칙이 활성화됩니다. 스태프는 증거가 담긴 알림을 받고 케이스가 열립니다. Sentinel은 절대 스스로 처벌하지 않으며, 결정은 스태프가 합니다.
  • Strict: Recommended와 같고, 점수가 높으면 스태프가 확인할 때까지 플레이어를 격리합니다. 증거 수준의 탐지(Tier A: 미끼 이벤트 발동, 위조된 요청)는 밴 웨이브용 밴도 대기열에 넣습니다.

스위치 아래에는 각 규칙과 그 상태, 상태가 어디에서 왔는지가 표시됩니다. 서버에 필요하다면 여기서 규칙 하나를 Live 또는 Shadow로 고정할 수 있습니다(예: 내 스크립트 하나를 계속 플래그하는 규칙). state 줄을 Config.Rules에 넣으면 config 파일에서 고정되며 데스크보다 우선합니다.

권장 순서:

  1. 며칠 동안 평소처럼 플레이하며 Watch로 둡니다.
  2. 규칙이 무엇을 했을지 읽습니다: Right now 시트, sentinel:diag rules(shadow 열은 규칙이 점수를 매겼을 횟수) 그리고 sentinel:diag decisions 100.
  3. 믿을 수 있는 사람을 플래그한 규칙은 Shadow로 고정하고 저희에게 알려 주세요.
  4. Recommended로 바꿉니다. 이제 스태프가 케이스와 증거를 봅니다. 자동으로 처벌되는 사람은 없습니다.
  5. Recommended가 보여 주는 결과를 믿을 수 있을 때 Strict로.

언제든 되돌릴 수 있습니다: 데스크에서 Watch를 고르거나 sentinel:level watch를 실행하세요.

7. 스태프 콘솔 (F7)

게임에서 F7을 누르세요(또는 F8에 sentinel:console을 입력하세요). 각 플레이어는 게임 설정(Key Bindings, FiveM)에서 키를 바꿀 수 있습니다. Esc로 닫습니다.

  • Right now는 서버에서 무슨 일이 일어나고 있는지 쉬운 말로 알려 줍니다. 누가 위협으로 보이고 그 이유는 무엇인지, 무엇이 증명됐는지, 무엇이 설명됐는지(소생, 내 스크립트의 텔레포트 등), 그리고 무엇에 내 판단이 필요한지. 중요한 플레이어는 각각 한 줄을 받습니다: 무엇을 했는지, 아마 무엇인지, Sentinel이 얼마나 확신하는지(Unusual, Suspicious, Very likely, Proven), Sentinel이 이미 한 일, 그리고 다음 단계 하나.
  • 케이스 파일: 열린 케이스가 먼저 나오고, 각각 탐지 내용, 증거, 화면 클립, 봉인(케이스의 해시 체인이 여전히 검증되는지)과 REVEAL, QUARANTINE, CLEAR, BAN 키가 있습니다(CLEAR와 BAN은 한 번 더 눌러야 합니다).
  • 근무 지도: 접속 중인 플레이어를 섬의 3D 모델 위에 보여 줍니다. 지형은 첫 스태프의 게임에서 측정되어 data/map/에 저장됩니다.
  • Play replay는 콘솔을 닫고 비공개 월드에서 사건을 다시 재생합니다. Backspace를 누르면 돌아옵니다.
  • 오너(오너 자리 전용): First run, Protection, Keys, Staff, Internal affairs, Server check.

게임 안에서 명령어는 F8에서는 슬래시 없이, 채팅에서는 슬래시와 함께 입력합니다(/sentinel:diag).

8. 브라우저 패널

게임에 접속해 있지 않을 때 쓰는, 웹 브라우저 속 같은 데스크입니다:

  • 서버 PC에서: 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자)를 봅니다. 이의를 제기하려고 접속할 수는 없으므로, 이의 제기는 게임 밖에서 들어옵니다:

  1. 스태프를 통해. 플레이어가 코드를 스태프에게 보냅니다(Discord 티켓, 메일). 스태프가 sentinel:appeal <code> <text>로 기록합니다.
  2. 웹 경로를 통해. Sentinel은 서버 자체 주소에서 응답합니다: http://<server address>:<port>/zerodev_sentinel/appeal. JSON { "code": "...", "text": "...", "contact": "optional" }이 담긴 POST(텍스트 10~2000자)만 받으므로, 플레이어를 보내는 페이지가 아니라 내 웹사이트의 폼에서 쓰도록 만든 것입니다. 받아들인 요청은 코드가 밴과 일치하든 아니든 모두 같은 응답 202 "received"를 받습니다. 한 주소에서 너무 많은 요청(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는 그 계정이나 케이스의 활성 밴을 모두 풀고 대기 중인 wave 밴을 취소하며, reject는 밴을 유지합니다. 결정은 최종이며 케이스 로그에 기록됩니다. sentinel:appeals로 열린 이의 제기를 나열합니다.

10. 신고와 내부 감사

플레이어 신고. 어떤 플레이어든 /report <server id> <what happened>를 입력해 플레이어나 스태프를 신고할 수 있습니다. 두 플레이어 주변의 최근 2분이 케이스에 저장됩니다. 스태프는 신고를 조치 완료, 위반 없음, 증거 없음, 중복 중 하나로 닫습니다. 스태프에 대한 신고는 오너에게만 갑니다.

내부 감사(오너 전용, 오너 데스크): 각 스태프가 한 일과 확인이 필요한 것(자기 자신에게 준 권한, 전투 중 숨기, 케이스 없는 밴, 플레이어에게 텔레포트). 주간 공정성 보고서가 data/reports/에 작성되며, sentinel:staff report로 지금 바로 작성할 수 있습니다. 스태프 기록의 어떤 내용도 스태프를 처벌하지 않습니다.

11. 리소스 보호

아무 설정을 하지 않아도 Sentinel은 플레이어가 내 스크립트로 보낼 수 있는 모든 이벤트를 지켜보고 그 플레이어를 판정합니다. 다만 다른 리소스의 핸들러가 실행되는 것을 막을 수는 없습니다. 스크립트가 실행되기 전에 잘못된 호출을 막으려면 그 스크립트에 guard를 추가하세요.

  1. sentinel:audit은 시작된 모든 리소스에서 클라이언트가 트리거할 수 있는 이벤트를, 핸들러가 하는 일에 따라 등급을 매겨 나열합니다(예: 클라이언트가 고른 금액으로 돈을 주는 핸들러). 어떤 리소스부터 보호할지 정할 때 사용하세요.
  2. sentinel:guard <resource>는 추가할 줄과, 추가 후 리소스의 server_scripts가 어떻게 보일지를 출력합니다. guard 줄은 첫 번째 server script여야 합니다. 이 명령어는 출력만 하며 파일은 바꾸지 않습니다.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. 그 리소스를 재시작하세요. 이제 sentinel:guard <resource>에 "guarded since ..."가 표시됩니다. sentinel:guard만 입력하면 보호 중인 모든 리소스를 나열합니다.
  2. 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는 파일을 절대 수정하지 않으며, 핸들러가 받는 내용도 절대 바꾸지 않습니다. 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 "..."
클립 웹훅 FiveManage 대신, 클립을 받는 Discord 웹훅 set sentinel_clip_webhook "..."
클립 저장소 fivemanage, discord, off 또는 automatic (설정된 것 중 첫 번째) set sentinel_clip_storage "..."

server.cfg의 키가 데스크보다 우선하며, 데스크에도 그렇게 표시됩니다. Discord 버튼은 콘솔과 같은 역할과 스위치를 따릅니다. 이 중 아무것도 없으면 케이스와 클립은 서버(data/)에 남고, 콘솔과 패널에서 볼 수 있습니다.

더 간단한 웹훅 알림도 계속 쓸 수 있습니다: 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는 강한 신호입니다: 스태프가 확인해야 합니다. 단독으로는 서로 다른 두 계열이 일치하거나 같은 것이 반복될 때만 케이스를 엽니다.
  • 티어 C는 약한 신호입니다: 점수에 더해질 뿐 절대 단독으로 조치하지 않습니다.

이동

규칙 잡아내는 것 설명되는 경우 티어
teleport 두 샘플 사이에 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 플레이어와 스크립트보다 훨씬 많은 엔티티(또는 한 모델)를 분당 스폰 스폰하는 내 스크립트 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

전투

규칙 잡아내는 것 티어
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

이벤트와 요청

규칙 잡아내는 것 티어
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 밴된 플레이어가 새 계정으로 돌아옴(하드웨어 토큰, 식별자, 브라우저 지문) 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 대기열에 있는 밴
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 사본은 하나만 남기고 다른 폴더는 중지
저장소 어떤 저장소가 선택되었는지(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:로 시작하는 키)에 저장됩니다. 밴은 항상 key-value 저장소에도 복제되므로 데이터베이스가 다운된 동안에도 계속 적용됩니다.

17. 업데이트

새 버전은 같은 Keymaster 에셋에 게시됩니다. Sentinel은 증거를 자기 폴더 안에 보관하므로, 교체하기 전에 다음을 하세요:

  1. zerodev_sentinel 폴더의 config/와 data/ 폴더(아카이브, 클립, 신고, 학습된 기준값)를 백업하고, oxmysql을 쓴다면 zds_ 테이블도 백업하세요.
  2. 서버를 멈추고, zerodev_sentinel 폴더를 새 폴더로 교체한 다음(폴더 이름은 유지), data/ 폴더를 다시 넣으세요. 옛 파일을 덮어 복사하지 말고, 바꾼 설정을 새 config 파일로 옮기세요.
  3. 서버를 시작하고 시작 박스(sentinel:health)를 확인하세요.

업데이트하기 전에 변경 기록에서 새 버전의 릴리스 노트를 읽으세요.

18. 제거

  1. 보호한 모든 리소스에서 guard 줄을 지우고(sentinel:guard로 목록을 볼 수 있음) 그 리소스들을 재시작하세요. 이것을 가장 먼저 하세요. 폴더를 지우면 guard 파일도 사라집니다.
  2. server.cfg에서 ensure zerodev_sentinel과 sentinel.admin / sentinel.staff 줄을 지운 다음 리소스를 중지하세요. sentinel:lockdown으로 entity lockdown을 바꿨다면, Sentinel을 중지하면 원래 모드로 돌아갑니다.
  3. zerodev_sentinel 폴더를 삭제하세요. 그러면 data/와 그 안의 모든 아카이브, 클립, 신고가 함께 지워지므로, 남기고 싶은 것은 먼저 복사해 두세요.
  4. oxmysql을 쓴다면, 밴과 케이스가 더 이상 필요 없을 때 16장에 나온 zds_ 테이블을 삭제하세요. key-value 기록은 리소스 이름으로 서버 저장소에 남지만, 리소스가 없으면 아무 일도 하지 않습니다.

Sentinel은 자기 폴더, 자기 데이터베이스 테이블, 자기 key-value 저장소에만 씁니다. 다른 리소스나 server.cfg는 수정하지 않습니다.

자주 묻는 질문

Sentinel이 스스로 누군가를 밴하거나 킥하나요?

Watch나 Recommended에서는 하지 않습니다. 처음에는 Watch로 시작하며, 했을 조치를 기록만 합니다. Recommended에서는 스태프가 증거를 받고 판단합니다. Strict에서만 높은 점수가 나온 플레이어를 스태프가 확인할 때까지 격리하고, 증거 수준의 탐지가 있으면 밴을 ban wave 대기열에 넣습니다.

데이터베이스가 필요한가요?

아니요. oxmysql이 있으면 Sentinel은 데이터베이스에 기록을 저장하고 첫 시작 때 자체 테이블을 만듭니다. 가져올 SQL 파일은 없습니다. 없으면 모든 것이 리소스 자체 key-value 저장소에 저장됩니다.

QBCore와 Qbox에서 작동하나요?

네. 탐지, 케이스, 클립, 콘솔, 브라우저 패널, Discord, 오너 데스크는 모든 프레임워크에서 같습니다. 돈과 아이템 추적에는 ESX, QBCore, Qbox, ox_inventory용 전용 어댑터가 있습니다.

관리자에게 접근 권한을 주려면?

오너 데스크의 STAFF에서 접속 중인 플레이어를 고르고, 역할을 고른 다음 GRANT를 누르세요. 또는 ACE를 계속 써도 됩니다. sentinel.admin은 Admin을, sentinel.staff는 Moderator를 줍니다.

밴된 플레이어가 이의를 제기할 수 있나요?

네. 접속 거부 메시지에 이의 제기 코드가 표시됩니다. 플레이어가 그 코드를 스태프에게 보내면 스태프가 sentinel:appeal로 등록하거나, 웹사이트가 Sentinel의 이의 제기 경로로 보냅니다. 스태프는 콘솔에서 또는 sentinel:decide로 승인하거나 거절합니다.

플레이어 PC의 치트 프로그램을 볼 수 있나요?

아니요. Sentinel은 서버가 볼 수 있는 것과 플레이어의 게임이 보고하는 것으로 판단합니다. 플레이어 PC의 다른 프로그램은 읽지 않습니다.

보이스 채팅 청취 기능은 완성되었나요?

pma-voice와 청취 스위치(기본적으로 오너 전용)가 필요하며, 소리는 내 게임을 통해 재생됩니다.

플레이어에게는 무엇이 보이나요?

처음 접속할 때, 서버가 플레이를 기록하며 스태프가 보고 들을 수 있다는 짧은 안내가 자기 언어로 표시됩니다(Config.Notice). 문제없는 플레이어에게는 그 밖에 바뀌는 것이 없습니다.

영어에서 번역한 페이지입니다. 영어 페이지와 내용이 다르면 영어 페이지가 기준입니다. English