TXW Documentation

seraphim-ac

TXW Documentation

Customer docs for Seraphim-AC setup, protection layers, admin access and operations.

Filter inactive

Built from markdown on 2026-04-02 10:30:44

Seraphim-AC Kunden-Dokumentation (Deutsch)

Ausführliche Kunden-Doku für Setup, Rechte, Schutzmodule, Panel und Betrieb von Seraphim-AC.

Überblick

Seraphim-AC ist ein mehrschichtiges FiveM-Anticheat mit Server- und Client-Prüfungen, HWID-Bans, Ingame-Panel, Screenshot- und OCR-Funktionen, Anti-Dumper-Schutz sowie optionaler Discord-Bridge.
Die Resource ist für produktiven Betrieb aufgebaut und trennt Konfiguration, Schutzlogik, UI und Betriebsfunktionen.

Schnellstart

  1. Resource-Ordner als seraphim-ac ablegen.
  2. In server.cfg sicherstellen, dass Abhängigkeiten wie screenshot-basic, sessionmanager und chat verfügbar sind.
  3. configs/Config.lua an Server, Rechte, Webhooks und Sprache anpassen.
  4. Falls Lizenzdaten oder externe Anbindung benötigt werden, alle nötigen Werte vor dem Start setzen.
  5. Danach mit ensure seraphim-ac starten.

Kernfunktionen

Protection Stack
  • Serverseitige Checks für Movement, Heuristics, Events, Entities, Playerstates und Weapon Integrity.
  • Clientseitige Checks für Dumper, Spoofer, OCR, Screenshots, Freecam/Spectate, Plugins und weitere Runtime-Signaturen.
  • Score-basiertes Verhalten über Heuristics.BanThreshold, DecayRate und DecayInterval.
  • Kombination aus Direktmassnahmen und Suspicion-Scoring statt nur einem einzigen Erkennungspfad.
Admin & Operations
  • Ingame-Panel über /smpanel.
  • Unban-Oberfläche über /smunban.
  • ACE-Bypass und Panel-Rechte in Config.Core.AceBypass und per add_ace.
  • Optional automatische txAdmin-Whitelisting-Logik über Config.Core.TxadminAutowhitelist.
Evidence & Ban Workflow
  • Screenshot-basierte Beweisaufnahme.
  • Video-/Recorder-Komponenten im Client für erweiterte Nachweise.
  • Ban- und Screenshot-Webhooks in Config.Webhooks.
  • HWID-Sperren über das HWID-Modul und banned_hwids.json.
Discord Bridge
  • Optionaler Bot-Bridge-Betrieb für list, view, ban und unban.
  • Absicherung über AllowedUserIds.
  • Bot-Token bleibt außerhalb der Resource in server.cfg.
  • Antworten nutzen das vorhandene i18n-System.

Resource-Aufbau

Bereich Aufgabe
configs/Config.lua Zentrale Laufzeit-Konfiguration
server/*.lua Schutzlogik, Initialisierung, Bans, Logging, Discord, Rechte
client/*.lua Client-Detections, NUI-Anbindung, Screenshots, Evidence
panel/ Adminpanel im Spiel
panel/unban_nui/ Eigenes Unban-Interface
weapons/*.json Waffen- und Integritätsdaten
banned_hwids.json Persistente HWID-Sperren

Installation

Standard-Startreihenfolge

  • Basis-Framework und Datenbank zuerst
  • screenshot-basic
  • weitere Kernresources wie sessionmanager und chat
  • seraphim-ac
  • danach übrige Gameplay-Resources

Wichtige Hinweise

  • Der Ressourcenname für den Anti-Dumper ist in der Config auf seraphim-ac ausgelegt.
  • In Config.Core.ImportantResources stehen Resources, die als kritisch behandelt werden.
  • Config.Core.WhitelistedResources deckt erlaubte Sonderfälle für Resource-Operationen ab.

Rechte und ACE-Setup

Typische Rechte

add_ace group.admin seraphim-ac.bypass allow
add_ace group.admin "seraphim-ac.panel" allow
add_ace group.admin "seraphim-ac.admin" allow

add_ace identifier.steam:1100001xxxxxxx seraphim-ac.bypass allow
add_ace identifier.discord:1100001xxxxxxx "seraphim-ac.panel" allow

Bedeutung

  • seraphim-ac.bypass: umgeht Schutzprüfungen für vertrauenswürdige Admins oder Systeme.
  • seraphim-ac.panel: erlaubt das Ingame-Panel.
  • seraphim-ac.admin: zusätzliche Admin-Ebene für AC-Operationen.
  • Config.Core.AceBypass: Liste globaler ACE-Berechtigungen, die vollständig ausgenommen werden.

Wichtige Commands

Command Zweck Rechte
/smpanel öffnet das Adminpanel seraphim-ac.panel, seraphim-ac.admin oder Bypass
/smunban öffnet das Unban-NUI AC-Adminrechte

Konfigurationsbereiche

Config.Core
  • Systemweite Sprache über Language.
  • Bypass- und Adminlogik über AceBypass, DiscordBypassIds, LicenseBypassIds.
  • Schutz kritischer Resources über ImportantResources.
  • Maintenance-/Load-Fenster über ResourceMaintenanceWindowMs und LoadingProtectionMs.
Config.Detections
  • Bewegung: AntiTeleport, AntiNoClip, AntiFreecam.
  • Status-Checks: GodMode, AntiInfiniteStamina, Spectate.
  • Cheat-Familien: AntiSusano, AntiEulen, Freecam.
  • Mehrere Module erlauben eigene Thresholds, Reset-Timer oder serverseitige Zusatzprüfungen.
Config.Entities
  • Spam-Limits für Peds, Fahrzeuge, Objekte, Fire und Particles.
  • Blacklists für Peds, Fahrzeuge und Objekte.
  • Zusatzchecks wie AntiCarForce, AntiVehicleModding und AntiSpawnEntities.
Config.Triggers
  • Event-Blacklist.
  • Max-Value- und Spam-Schutz.
  • Allowlist für legitime Events.
  • Schutz gegen Client-Trigger-Missbrauch und Resource-Stopper.
Config.Screenwatcher
  • OCR-basierte Bildschirmprüfung.
  • Blacklisted Keywords wie bekannte Menu-/Injector-Namen.
  • Steuerung über CheckIntervalSeconds, MinConfidence, OcrLanguage, MinTextLength.
Config.AntiDumper
  • Dateihashes und Laufzeit-Fallen für Dumper-Erkennung.
  • Serverseitiger Guard mit Trap-Events, Timeouts und Eskalationsregeln.
  • Reagiert auf fehlende, manipulierte oder unerwartete Dateien.
Config.Weapons
  • AntiIllegalWeapon.Whitelist: erlaubt Waffen, die nicht durch den Weapon-Integrity-/Loadout-Check geblockt werden sollen.
  • AntiNoRecoil.Whitelist: nimmt Waffen gezielt aus der clientseitigen No-Recoil-/No-Spread-Erkennung heraus.
  • Beide Listen akzeptieren Waffenamen als String oder direkt den numerischen Weapon-Hash.

Weapon Whitelists richtig eintragen

whitelistweapon

Für Waffen, die Seraphim-AC beim Weapon-Integrity-Check ignorieren soll, die Liste unter Config.Weapons.AntiIllegalWeapon.Whitelist pflegen.

Weapons = {
    AntiIllegalWeapon = {
        Enabled = true,
        Framework = "ESX",
        Whitelist = {
            "WEAPON_STUNGUN",
            "weapon_flashlight",
            GetHashKey("WEAPON_NIGHTSTICK")
        }
    }
}
  • Richtiger Pfad: Config.Weapons.AntiIllegalWeapon.Whitelist
  • Erlaubte Formate: "WEAPON_STUNGUN", "weapon_stungun" oder ein numerischer Hash
  • Strings werden intern normalisiert, WEAPON_ kann also vorhanden sein oder fehlen
  • Diese Whitelist ist nur für legitime Sonderwaffen gedacht, zum Beispiel Police-Taser, Event-Waffen oder framework-spezifische Loadout-Ausnahmen
  • Nicht wahllos komplette Waffenklassen eintragen, sonst verliert der Illegal-Weapon-Schutz an Wirkung

whitelistnorecoil

Für Waffen, die absichtlich kein oder fast kein Recoil/Spread haben sollen, die Liste unter Config.Weapons.AntiNoRecoil.Whitelist pflegen.

Weapons = {
    AntiNoRecoil = {
        Enabled = true,
        Whitelist = {
            "WEAPON_STUNGUN",
            "weapon_snowball",
            GetHashKey("WEAPON_BALL")
        }
    }
}
  • Richtiger Pfad: Config.Weapons.AntiNoRecoil.Whitelist
  • Erlaubte Formate: Waffenname als String oder numerischer Hash
  • Diese Whitelist betrifft nur die No-Recoil-/No-Spread-Prüfung auf dem Client
  • Ideal für Utility-, Fun- oder Event-Waffen, bei denen normale Recoil-Werte nicht sinnvoll sind
  • Nicht mit AntiIllegalWeapon.Whitelist verwechseln: beide Listen sind technisch getrennt und müssen bei Bedarf separat gepflegt werden

Empfohlene Vorgehensweise

  1. Zuerst exakt prüfen, welche Waffe Probleme macht.
  2. Die Waffe nur in die passende Whitelist eintragen, nicht pauschal in beide.
  3. Resource mit restart seraphim-ac oder ensure seraphim-ac neu laden.
  4. Die betroffene Waffe ingame erneut testen.
  5. Nur die minimal nötigen Waffen eingetragen lassen.

Schutzbereiche im Detail

Movement & Position

  • Teleport-Prüfungen mit Distanz-, Zeit- und Geschwindigkeitslogik.
  • NoClip-/High-Z-Erkennung.
  • Freecam- und Spectate-Erkennung.
  • Fahrzeugbasierte Anomalien wie Launch- oder Car-Force-Missbrauch.

Combat & Player State

  • Godmode- und Damage-Spoof-Prüfungen.
  • Silent-Aim- und unplausible Trefferwinkel.
  • Infinite-Stamina-Erkennung.
  • Heuristische Bewertung für verdächtiges Kampfverhalten.

Events & Exploits

  • Blacklisted Events.
  • Spam-Detection und Value-Checks.
  • Honeypots und Trigger-Missbrauchsschutz.
  • Resource-Stopper- und Dumper-Indikatoren.

Entities & World Manipulation

  • Blacklisted Vehicles, Peds und Objekte.
  • Spawn- und Spam-Limits.
  • Fahrzeugmodding- und NPC-Hijacking-nahe Schutzpfade.
  • Safe-Zones für Anti-Delete-/Bewegungslogik.

Client Integrity

  • Anti-Dumper mit Hash- und Antwortprüfung.
  • Plugin/File-Checks über AntiChiper.
  • Spoof-Detektion über AntiSpoof.
  • Screenshot-, OCR- und Evidence-Pipeline für Nachweise.

Panel und Kundenbetrieb

Panel

  • Das Panel dient als Verwaltungsoberfläche für Konfiguration, Übersicht und Betriebsfunktionen.
  • PanelUI.Theme steuert das Aussehen von smpanel und smunban.
  • Das Projekt bringt bereits ein Green-Theme mit.

Unban-NUI

  • Eigene Oberfläche für Banlisten und Entsperrungen.
  • Nutzt dieselbe Theme-Logik wie das Hauptpanel.

Webhooks

  • Getrennte Ziele für Connect, Disconnect, Screenshot, Ban, Admin, Explosion, Honeypot, Main.
  • Empfehlenswert ist die Trennung nach Sicherheitsereignis und Betriebs-Logging.

Discord Bridge

Setup

  1. Config.DiscordBridge.Enabled = true
  2. ChannelId setzen
  3. AllowedUserIds mit den Discord-IDs der erlaubten Nutzer füllen
  4. Bot-Token in server.cfg setzen:
setr seraphim_discord_bot_token "DEIN_BOT_TOKEN"
  1. Resource neu starten

Befehle

  • !ac help
  • !ac list
  • !ac view <ban_nummer|identifier>
  • !ac unban <ban_nummer|identifier>
  • !ac ban <player_id> <grund>

Empfohlene Kunden-Checks nach dem Setup

  1. Panel mit Admin-Account öffnen.
  2. Unban-NUI testen.
  3. Screenshot- und Ban-Webhooks prüfen.
  4. Einen Testfall für Eventschutz und einen für Entity-Blacklist verifizieren.
  5. Sprache auf gewünschte Config.Core.Language setzen und Texte prüfen.

Troubleshooting

Panel öffnet nicht
  • ACE-Rechte prüfen.
  • Resource wirklich als seraphim-ac gestartet?
  • NUI-Dateien und ui_page nicht umbenannt.
Discord Bridge reagiert nicht
  • Enabled, ChannelId und AllowedUserIds prüfen.
  • Bot-Token in server.cfg prüfen.
  • Discord-Channel-Rechte und MESSAGE CONTENT INTENT prüfen.
Zu viele oder zu wenige Flags
  • Thresholds in Detections, Heuristics und Triggers servergerecht abstimmen.
  • Safe-Zones, Allowlists und wichtige Resources sauber pflegen.
  • Nicht blind alles deaktivieren, sondern Regel für Regel validieren.

Sprachen

Die Runtime bringt aktuell Lokalisierung für mindestens Deutsch und Englisch mit.
Die Kundendoku wird hier zusätzlich auf Französisch angeboten, damit dieselbe Docs-Site für internationale Kunden konsistent bleibt.

Seraphim-AC Customer Documentation (English)

Detailed customer docs for setup, permissions, protection modules, panel usage and day-to-day operations of Seraphim-AC.

Overview

Seraphim-AC is a layered FiveM anticheat with server-side and client-side checks, HWID bans, in-game admin UI, screenshot and OCR tooling, anti-dumper protection and an optional Discord bridge.
The resource is structured for production use and separates configuration, protection logic, UI and operations.

Quick Start

  1. Keep the resource folder name as seraphim-ac.
  2. Make sure dependencies such as screenshot-basic, sessionmanager and chat are available in server.cfg.
  3. Adjust configs/Config.lua for your server, permissions, webhooks and language.
  4. If license or external bridge settings are required, configure them before startup.
  5. Start the resource with ensure seraphim-ac.

Core Features

Protection Stack
  • Server-side checks for movement, heuristics, events, entities, player states and weapon integrity.
  • Client-side checks for dumpers, spoofing, OCR, screenshots, freecam/spectate, plugins and runtime signatures.
  • Score-based behavior handling via Heuristics.BanThreshold, DecayRate and DecayInterval.
  • Combines direct action paths and suspicion scoring instead of relying on one single detector.
Admin & Operations
  • In-game panel via /smpanel.
  • Dedicated unban interface via /smunban.
  • ACE bypass and panel permissions through Config.Core.AceBypass and add_ace.
  • Optional txAdmin auto-whitelisting with Config.Core.TxadminAutowhitelist.
Evidence & Ban Workflow
  • Screenshot-based evidence capture.
  • Video/recorder components on the client for stronger proof chains.
  • Ban and screenshot webhooks in Config.Webhooks.
  • Hardware bans through the HWID module and banned_hwids.json.
Discord Bridge
  • Optional bot bridge for list, view, ban and unban.
  • Access control through AllowedUserIds.
  • Bot token stays outside the resource in server.cfg.
  • Responses use the existing i18n layer.

Resource Structure

Area Purpose
configs/Config.lua central runtime configuration
server/*.lua protection logic, startup, bans, logging, Discord, permissions
client/*.lua client detections, NUI bridge, screenshots, evidence
panel/ in-game admin panel
panel/unban_nui/ dedicated unban UI
weapons/*.json weapon and integrity data
banned_hwids.json persistent HWID bans

Installation

Typical Start Order

  • framework and database first
  • screenshot-basic
  • core resources such as sessionmanager and chat
  • seraphim-ac
  • remaining gameplay resources afterwards

Important Notes

  • The anti-dumper configuration expects the resource name seraphim-ac.
  • Config.Core.ImportantResources defines resources treated as critical.
  • Config.Core.WhitelistedResources covers allowed exceptions for resource operations.

Permissions and ACE Setup

Typical Permissions

add_ace group.admin seraphim-ac.bypass allow
add_ace group.admin "seraphim-ac.panel" allow
add_ace group.admin "seraphim-ac.admin" allow

add_ace identifier.steam:1100001xxxxxxx seraphim-ac.bypass allow
add_ace identifier.discord:1100001xxxxxxx "seraphim-ac.panel" allow

Meaning

  • seraphim-ac.bypass: bypasses protection checks for trusted admins or systems.
  • seraphim-ac.panel: grants access to the in-game panel.
  • seraphim-ac.admin: additional admin level for anticheat operations.
  • Config.Core.AceBypass: list of ACE permissions that are fully exempt from checks.

Main Commands

Command Purpose Permission
/smpanel opens the admin panel seraphim-ac.panel, seraphim-ac.admin or bypass
/smunban opens the unban NUI AC admin permissions

Configuration Areas

Config.Core
  • Global language via Language.
  • Bypass and admin flow via AceBypass, DiscordBypassIds, LicenseBypassIds.
  • Critical-resource protection through ImportantResources.
  • Maintenance and load grace windows through ResourceMaintenanceWindowMs and LoadingProtectionMs.
Config.Detections
  • Movement: AntiTeleport, AntiNoClip, AntiFreecam.
  • Player state: GodMode, AntiInfiniteStamina, Spectate.
  • Cheat families: AntiSusano, AntiEulen, Freecam.
  • Multiple modules expose their own thresholds, reset timers or server-side validation options.
Config.Entities
  • Spam limits for peds, vehicles, objects, fire and particles.
  • Blacklists for peds, vehicles and objects.
  • Additional checks such as AntiCarForce, AntiVehicleModding and AntiSpawnEntities.
Config.Triggers
  • Event blacklist.
  • Max-value and spam protections.
  • Allowlist support for legitimate events.
  • Detection paths against client trigger abuse and resource stoppers.
Config.Screenwatcher
  • OCR-based screen inspection.
  • Blacklisted keywords for known cheat menu and injector names.
  • Controlled with CheckIntervalSeconds, MinConfidence, OcrLanguage, MinTextLength.
Config.AntiDumper
  • File hashes and runtime traps for dumper detection.
  • Server-side guard with trap events, timeouts and escalation rules.
  • Reacts to missing, tampered or unexpected files.
Config.Weapons
  • AntiIllegalWeapon.Whitelist: allows weapons that should be skipped by the weapon integrity/loadout check.
  • AntiNoRecoil.Whitelist: excludes specific weapons from the client-side no recoil/no spread detection.
  • Both lists accept weapon names as strings or raw numeric weapon hashes.

How to configure weapon whitelists correctly

whitelistweapon

If Seraphim-AC should ignore a weapon during weapon integrity checks, add it to Config.Weapons.AntiIllegalWeapon.Whitelist.

Weapons = {
    AntiIllegalWeapon = {
        Enabled = true,
        Framework = "ESX",
        Whitelist = {
            "WEAPON_STUNGUN",
            "weapon_flashlight",
            GetHashKey("WEAPON_NIGHTSTICK")
        }
    }
}
  • Correct path: Config.Weapons.AntiIllegalWeapon.Whitelist
  • Accepted formats: "WEAPON_STUNGUN", "weapon_stungun" or a numeric hash
  • String entries are normalized internally, so WEAPON_ may be present or omitted
  • Use this only for legitimate exception weapons such as police tasers, event weapons or framework-specific loadout edge cases
  • Do not whitelist entire weapon sets without a concrete reason, otherwise the illegal weapon protection loses value

whitelistnorecoil

If a weapon is intended to have little or no recoil/spread, add it to Config.Weapons.AntiNoRecoil.Whitelist.

Weapons = {
    AntiNoRecoil = {
        Enabled = true,
        Whitelist = {
            "WEAPON_STUNGUN",
            "weapon_snowball",
            GetHashKey("WEAPON_BALL")
        }
    }
}
  • Correct path: Config.Weapons.AntiNoRecoil.Whitelist
  • Accepted formats: weapon name string or numeric hash
  • This whitelist only affects the client-side no recoil/no spread detector
  • Best used for utility, fun or event weapons where normal recoil values do not make sense
  • Do not confuse it with AntiIllegalWeapon.Whitelist: both lists are separate and must be maintained independently when needed
  1. Identify exactly which weapon causes the false positive.
  2. Add the weapon only to the matching whitelist, not blindly to both.
  3. Reload the resource with restart seraphim-ac or ensure seraphim-ac.
  4. Test the affected weapon again in game.
  5. Keep the whitelist limited to the minimum required entries.

Protection Coverage

Movement and Position

  • Teleport checks with distance, timing and speed logic.
  • NoClip and high-Z detection.
  • Freecam and spectate detection.
  • Vehicle anomaly checks such as launch abuse or car force manipulation.

Combat and Player State

  • Godmode and damage-spoof checks.
  • Silent-aim and impossible hit-angle detection.
  • Infinite stamina detection.
  • Heuristic scoring for suspicious combat behavior.

Events and Exploits

  • Blacklisted events.
  • Spam and max-value controls.
  • Honeypots and trigger abuse protection.
  • Resource stopper and dumper-related indicators.

Entities and World Manipulation

  • Blacklisted vehicles, peds and objects.
  • Spawn and spam limits.
  • Vehicle-modding and world manipulation related safeguards.
  • Safe zones for anti-delete and movement-side validation.

Client Integrity

  • Anti-dumper with hash validation and response verification.
  • Plugin/file checks through AntiChiper.
  • Spoof detection through AntiSpoof.
  • Screenshot, OCR and evidence pipeline for proof collection.

Panel and Customer Operations

Panel

  • The panel is the main control surface for configuration, overview and operational features.
  • PanelUI.Theme controls both smpanel and smunban.
  • The project already ships with a green theme.

Unban NUI

  • Separate interface for ban list review and unban actions.
  • Shares the same theme flow as the main panel.

Webhooks

  • Separate targets for Connect, Disconnect, Screenshot, Ban, Admin, Explosion, Honeypot, Main.
  • Splitting operational logs from security incidents is recommended.

Discord Bridge

Setup

  1. Set Config.DiscordBridge.Enabled = true
  2. Fill in ChannelId
  3. Add allowed Discord IDs to AllowedUserIds
  4. Put the bot token in server.cfg:
setr seraphim_discord_bot_token "YOUR_BOT_TOKEN"
  1. Restart the resource

Commands

  • !ac help
  • !ac list
  • !ac view <ban_number|identifier>
  • !ac unban <ban_number|identifier>
  • !ac ban <player_id> <reason>
  1. Open the panel with an admin account.
  2. Test the unban NUI.
  3. Verify screenshot and ban webhooks.
  4. Validate one event-protection case and one entity blacklist case.
  5. Set Config.Core.Language to the target language and verify messages.

Troubleshooting

Panel does not open
  • Check ACE permissions.
  • Confirm the resource really starts as seraphim-ac.
  • Make sure NUI files and the ui_page path were not renamed.
Discord bridge does not respond
  • Check Enabled, ChannelId and AllowedUserIds.
  • Check the bot token in server.cfg.
  • Check Discord channel permissions and MESSAGE CONTENT INTENT.
Too many or too few detections
  • Tune thresholds in Detections, Heuristics and Triggers for your server.
  • Maintain safe zones, allowlists and important resources cleanly.
  • Do not disable everything blindly; validate rule by rule.

Languages

The runtime currently includes at least German and English localization.
This customer documentation is also provided in French so the docs site stays consistent for international customers.

Documentation Client Seraphim-AC (Francais)

Documentation detaillee pour l installation, les permissions, les modules de protection, le panel et l exploitation de Seraphim-AC.

Vue d ensemble

Seraphim-AC est un anticheat FiveM en plusieurs couches avec controles cote serveur et cote client, bans HWID, interface admin en jeu, outils de screenshot et OCR, protection anti-dumper et bridge Discord optionnel.
La resource est organisee pour un usage en production avec une separation claire entre configuration, logique de protection, interface et exploitation.

Demarrage Rapide

  1. Conserver le nom du dossier de resource en seraphim-ac.
  2. Verifier dans server.cfg que des dependances comme screenshot-basic, sessionmanager et chat sont disponibles.
  3. Adapter configs/Config.lua pour votre serveur, vos permissions, vos webhooks et votre langue.
  4. Si une licence ou une integration externe est necessaire, configurer ces valeurs avant le demarrage.
  5. Lancer ensuite la resource avec ensure seraphim-ac.

Fonctions Principales

Protection Stack
  • Controles serveur pour les mouvements, heuristiques, events, entites, etats joueur et integrite des armes.
  • Controles client pour les dumpers, le spoofing, l OCR, les screenshots, la freecam/spectate, les plugins et les signatures runtime.
  • Gestion par score via Heuristics.BanThreshold, DecayRate et DecayInterval.
  • Combine actions directes et scoring de suspicion au lieu de dependre d un seul detecteur.
Admin & Operations
  • Panel en jeu via /smpanel.
  • Interface de deban via /smunban.
  • Permissions ACE et bypass via Config.Core.AceBypass et add_ace.
  • Auto-whitelist txAdmin optionnelle avec Config.Core.TxadminAutowhitelist.
Evidence & Ban Workflow
  • Capture de preuves par screenshot.
  • Composants video/enregistrement cote client pour renforcer les preuves.
  • Webhooks de ban et de screenshot dans Config.Webhooks.
  • Bans materiels via le module HWID et banned_hwids.json.
Discord Bridge
  • Bridge bot optionnel pour list, view, ban et unban.
  • Controle d acces via AllowedUserIds.
  • Le token du bot reste hors de la resource dans server.cfg.
  • Les reponses utilisent la couche i18n existante.

Structure de la Resource

Zone Role
configs/Config.lua configuration centrale d execution
server/*.lua logique de protection, demarrage, bans, logs, Discord, permissions
client/*.lua detections client, pont NUI, screenshots, preuves
panel/ panel admin en jeu
panel/unban_nui/ interface de deban dediee
weapons/*.json donnees armes et integrite
banned_hwids.json bans HWID persistants

Installation

Ordre de Demarrage Recommande

  • framework et base de donnees d abord
  • screenshot-basic
  • ressources coeur comme sessionmanager et chat
  • seraphim-ac
  • puis les autres ressources gameplay

Notes Importantes

  • La configuration anti-dumper attend le nom de resource seraphim-ac.
  • Config.Core.ImportantResources definit les ressources critiques.
  • Config.Core.WhitelistedResources couvre les exceptions autorisees pour les operations de resource.

Permissions et Configuration ACE

Permissions Typiques

add_ace group.admin seraphim-ac.bypass allow
add_ace group.admin "seraphim-ac.panel" allow
add_ace group.admin "seraphim-ac.admin" allow

add_ace identifier.steam:1100001xxxxxxx seraphim-ac.bypass allow
add_ace identifier.discord:1100001xxxxxxx "seraphim-ac.panel" allow

Signification

  • seraphim-ac.bypass : bypass complet pour admins ou systemes de confiance.
  • seraphim-ac.panel : acces au panel en jeu.
  • seraphim-ac.admin : niveau admin supplementaire pour les operations AC.
  • Config.Core.AceBypass : liste des permissions ACE totalement exemptees.

Commandes Principales

Commande But Permission
/smpanel ouvre le panel admin seraphim-ac.panel, seraphim-ac.admin ou bypass
/smunban ouvre le NUI de deban permissions admin AC

Zones de Configuration

Config.Core
  • Langue globale via Language.
  • Gestion des bypass et admins via AceBypass, DiscordBypassIds, LicenseBypassIds.
  • Protection des ressources critiques via ImportantResources.
  • Fenetres de maintenance et de chargement via ResourceMaintenanceWindowMs et LoadingProtectionMs.
Config.Detections
  • Mouvement : AntiTeleport, AntiNoClip, AntiFreecam.
  • Etat joueur : GodMode, AntiInfiniteStamina, Spectate.
  • Familles de cheats : AntiSusano, AntiEulen, Freecam.
  • Plusieurs modules exposent leurs propres thresholds, reset timers ou validations serveur.
Config.Entities
  • Limites de spam pour peds, vehicules, objets, feu et particules.
  • Blacklists pour peds, vehicules et objets.
  • Checks supplementaires comme AntiCarForce, AntiVehicleModding et AntiSpawnEntities.
Config.Triggers
  • Blacklist d events.
  • Protections anti spam et max-value.
  • Allowlist pour les events legitimes.
  • Protection contre l abus de triggers client et les resource stoppers.
Config.Screenwatcher
  • Inspection d ecran basee sur l OCR.
  • Mots clefs blacklists pour des menus ou injecteurs connus.
  • Controle via CheckIntervalSeconds, MinConfidence, OcrLanguage, MinTextLength.
Config.AntiDumper
  • Hash de fichiers et pieges runtime pour la detection de dumper.
  • Guard serveur avec trap events, timeouts et regles d escalation.
  • Reagit aux fichiers manquants, modifies ou inattendus.
Config.Weapons
  • AntiIllegalWeapon.Whitelist : autorise des armes qui doivent etre ignorees par le controle weapon integrity/loadout.
  • AntiNoRecoil.Whitelist : exclut des armes specifiques de la detection client no recoil/no spread.
  • Les deux listes acceptent soit un nom d arme en string, soit directement le hash numerique de l arme.

Bien configurer les weapon whitelists

whitelistweapon

Si Seraphim-AC doit ignorer une arme dans le controle weapon integrity, ajoutez-la dans Config.Weapons.AntiIllegalWeapon.Whitelist.

Weapons = {
    AntiIllegalWeapon = {
        Enabled = true,
        Framework = "ESX",
        Whitelist = {
            "WEAPON_STUNGUN",
            "weapon_flashlight",
            GetHashKey("WEAPON_NIGHTSTICK")
        }
    }
}
  • Bon chemin : Config.Weapons.AntiIllegalWeapon.Whitelist
  • Formats acceptes : "WEAPON_STUNGUN", "weapon_stungun" ou un hash numerique
  • Les strings sont normalisees en interne, donc WEAPON_ peut etre present ou absent
  • A utiliser uniquement pour de vraies exceptions legitimes, par exemple taser police, armes d event ou cas specifiques de loadout framework
  • Ne whitelist pas de grandes listes d armes sans raison precise, sinon la protection illegal weapon perd de sa valeur

whitelistnorecoil

Si une arme doit volontairement avoir peu ou pas de recoil/spread, ajoutez-la dans Config.Weapons.AntiNoRecoil.Whitelist.

Weapons = {
    AntiNoRecoil = {
        Enabled = true,
        Whitelist = {
            "WEAPON_STUNGUN",
            "weapon_snowball",
            GetHashKey("WEAPON_BALL")
        }
    }
}
  • Bon chemin : Config.Weapons.AntiNoRecoil.Whitelist
  • Formats acceptes : nom d arme en string ou hash numerique
  • Cette whitelist agit seulement sur la detection client no recoil/no spread
  • Adaptee aux armes utilitaires, fun ou event pour lesquelles un recoil normal n a pas de sens
  • Ne pas confondre avec AntiIllegalWeapon.Whitelist : les deux listes sont separees et doivent etre gerees separement si necessaire

Methode recommandee

  1. Identifier exactement quelle arme provoque le faux positif.
  2. Ajouter l arme uniquement dans la whitelist adaptee, pas automatiquement dans les deux.
  3. Recharger la resource avec restart seraphim-ac ou ensure seraphim-ac.
  4. Retester l arme en jeu.
  5. Garder une whitelist la plus petite possible.

Couverture de Protection

Mouvement et Position

  • Checks de teleport avec logique de distance, temps et vitesse.
  • Detection NoClip et High-Z.
  • Detection freecam et spectate.
  • Verification d anomalies vehicule comme launch abuse ou car force.

Combat et Etat Joueur

  • Checks Godmode et damage spoof.
  • Detection silent aim et angles de tir impossibles.
  • Detection stamina infinie.
  • Scoring heuristique pour comportement combat suspect.

Events et Exploits

  • Events blacklists.
  • Controle du spam et des valeurs maximales.
  • Honeypots et protection contre l abus de triggers.
  • Indicateurs lies aux resource stoppers et dumpers.

Entites et Manipulation du Monde

  • Vehicules, peds et objets blacklists.
  • Limites de spawn et de spam.
  • Protections liees au vehicle modding et a la manipulation du monde.
  • Safe zones pour la validation anti-delete et mouvement.

Integrite Client

  • Anti-dumper avec validation de hash et verification des reponses.
  • Verification de plugins/fichiers via AntiChiper.
  • Detection de spoof via AntiSpoof.
  • Pipeline screenshot, OCR et preuves pour la collecte d evidences.

Panel et Exploitation Client

Panel

  • Le panel est la surface principale pour la configuration, la vue d ensemble et les fonctions d exploitation.
  • PanelUI.Theme controle smpanel et smunban.
  • Le projet inclut deja un theme vert.

Unban NUI

  • Interface separee pour consulter la liste des bans et deban.
  • Utilise la meme logique de theme que le panel principal.

Webhooks

  • Cibles separees pour Connect, Disconnect, Screenshot, Ban, Admin, Explosion, Honeypot, Main.
  • Il est recommande de separer les logs d exploitation des incidents securite.

Discord Bridge

Setup

  1. Definir Config.DiscordBridge.Enabled = true
  2. Renseigner ChannelId
  3. Ajouter les IDs Discord autorises dans AllowedUserIds
  4. Mettre le token du bot dans server.cfg :
setr seraphim_discord_bot_token "VOTRE_BOT_TOKEN"
  1. Redemarrer la resource

Commandes

  • !ac help
  • !ac list
  • !ac view <ban_number|identifier>
  • !ac unban <ban_number|identifier>
  • !ac ban <player_id> <reason>

Verifications Recommandees Apres Setup

  1. Ouvrir le panel avec un compte admin.
  2. Tester le NUI de deban.
  3. Verifier les webhooks de screenshot et de ban.
  4. Valider un cas de protection event et un cas de blacklist d entites.
  5. Regler Config.Core.Language sur la langue cible et verifier les messages.

Troubleshooting

Le panel ne s ouvre pas
  • Verifier les permissions ACE.
  • Confirmer que la resource demarre bien sous le nom seraphim-ac.
  • Verifier que les fichiers NUI et le chemin ui_page n ont pas ete renommes.
Le Discord bridge ne repond pas
  • Verifier Enabled, ChannelId et AllowedUserIds.
  • Verifier le token du bot dans server.cfg.
  • Verifier les permissions du channel Discord et MESSAGE CONTENT INTENT.
Trop ou pas assez de detections
  • Ajuster les thresholds dans Detections, Heuristics et Triggers selon votre serveur.
  • Maintenir proprement les safe zones, allowlists et ressources critiques.
  • Ne pas tout desactiver sans validation regle par regle.

Langues

La runtime inclut actuellement au minimum l allemand et l anglais.
Cette documentation client est aussi fournie en francais pour garder la meme experience de documentation pour les clients internationaux.