EclipSysShield

Configuration

All configuration lives in config.lua. This page also covers the full unban guide and recommended presets.

Integration Settings

config.lua

-- Discord Webhook (REQUIRED for notifications)
Config.DiscordWebhook        = "YOUR_WEBHOOK_URL_HERE"

-- txAdmin Integration
Config.UseTxAdmin            = true

-- Wasabi Admin Menu Integration
Config.UseWasabiAdmin        = true
Config.WasabiBypassPermission = "admin"  -- must match your Wasabi group name

Detection Toggles

config.lua

Config.Detections = {
    GodMode         = true,
    SpeedHack       = true,
    Teleport        = true,
    Noclip          = true,
    Aimbot          = true,
    SuperJump       = true,
    RapidFire       = true,
    InfiniteAmmo    = true,
    ExplosionAbuse  = true,
    ResourceInject  = true,
    VehicleMods     = true,
    WeaponBlacklist = true,
}

Thresholds

config.lua

Config.Thresholds = {
    MaxVehicleSpeed    = 150.0,   -- m/s (540 km/h)
    MaxPlayerSpeed     = 10.0,    -- m/s on foot
    MaxTeleportDistance = 100.0,  -- meters
    HeadshotThreshold  = 5,      -- rapid headshots before flag
}

Punishment Settings

config.lua

Config.Punishment = {
    AutoKick         = true,
    AutoBan          = false,   -- uses txAdmin if enabled
    BanDuration      = 0,       -- 0 = permanent, otherwise days
    WarningThreshold = 3,       -- warnings before action triggers
}

Blacklists

config.lua

Config.BlacklistedResources = {
    "eulen", "lynx", "brutan",  -- known cheat menus
}

Config.BlacklistedWeapons = {
    `WEAPON_RAILGUN`,
    `WEAPON_FIREEXTINGUISHER`,
}

Whitelist

Add trusted identifiers to bypass all checks. Use this for confirmed-safe admins or players who trigger false positives.

config.lua

Config.Whitelist = {
    "steam:110000xxxxxxxx",
    "license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "discord:123456789012345678",
}

Recommended presets

Strict

MaxVehicleSpeed = 120
MaxTeleportDist = 50
WarningThreshold = 2
AutoBan = true

Moderate ✦

MaxVehicleSpeed = 150
MaxTeleportDist = 100
WarningThreshold = 3
AutoKick = true

Relaxed

MaxVehicleSpeed = 180
MaxTeleportDist = 150
WarningThreshold = 5
AutoKick = false

Unban Guide

There are four ways to unban a player. The in-game command is the fastest for quick unbans.

Method 1 — In-game command

in-game

-- by Steam ID:
/eclipsys:unban steam:110000103f4a2d3

-- by License (Rockstar):
/eclipsys:unban license:a1b2c3d4e5f6...

-- by Discord:
/eclipsys:unban discord:123456789012345678

Requires eclipsys.admin ACE permission, txAdmin admin status, or server console access.

Method 2 — txAdmin web panel

Go to http://YOUR_SERVER_IP:40120 and log in to txAdmin.

Click Player Database → Bans in the sidebar.

Find the player using the search bar, then click Revoke Ban.

Method 3 — txAdmin in-game menu

Press F1 → Player Management → Ban List → find player → Unban.

Method 4 — Server console

server console

txAdmin-listBans
txAdmin-removeBan 123                      # by ban ID
txAdmin-removeBan steam:110000103f4a2d3   # by identifier

Finding a player's identifier

Every ban Discord webhook notification includes the full set of identifiers. Look for:

Discord webhook — ban notification

Player: PlayerName [123]
Reason: Speed hack detected
Identifiers:
  Steam:   steam:110000103f4a2d3
  License: license:xxxxxxxxxx
  Discord: @Username
  IP:      123.456.789.012

After unbanning a trusted player, add them to Config.Whitelist or grant them eclipsys.admin to prevent future false positives. Use /eclipsys info [id] to monitor their activity.

Installation

Changelog