Account Trust

Account trust gives every connecting player a trust score from 0 to 100, based on how old and how established their accounts are. It helps you spot the fresh throwaway accounts cheaters use after a ban, and, if you want, keep them out before they ever spawn.

Scored Always, Enforced Only When You Turn It On

While Network check on connect is on, every connecting player gets a trust score and you see it on the Players page. Nothing happens to low scores until you turn on TrustScore & account risk in the panel. Its default action only logs.

How It Works

  1. A player connects. Your server sends their identifiers (account IDs such as discord: or steam:) and hardware tokens to the CXA network. This is the same network check that handles global bans.
  2. The network weighs the signals in the table below and turns them into a score between 0 and 100.
  3. The score is turned into a band: red, orange, yellow, lime or green.
  4. If account trust is turned on and the player's band is below your Minimum band, or they miss an account you require, the Action is applied: the join is logged or rejected.
  5. The score is saved on the Players page and your scripts can read it with the GetTrustScore export.

Bands

BandScoreMinimum band option in the panel
red0 to 19Red (block nobody)
orange20 to 39Orange (recommended)
yellow40 to 59Yellow (strict)
lime60 to 79Lime (very strict)
green80 to 100Green (whitelist-like)

Players below the Minimum band get the Action. With the default orange, only red players are affected. With red, nobody is below it, so nobody is affected.

What Changes the Score

The exact weights are not published. If they were, anyone could build a throwaway account that just passes. These are the signals the network looks at:

SignalEffect on the score
Discord account younger than Discord account min ageLowers it strongly
Discord account only a few months oldLowers it slightly
Discord account several years oldRaises it
No Discord account linkedLowers it
Steam account younger than Steam account min ageLowers it
Steam account several years oldRaises it
No Steam account linkedLowers it slightly
No Cfx.re account linkedLowers it
Microsoft / Xbox account linkedRaises it slightly
No hardware tokens (possible spoofer)Lowers it
First time seen on the CXA networkLowers it slightly
Long history and many connections on CXA servers and on your serverRaises it
Old global bans (older than Ignore bans older than)Lower it
Active global ban on any linked accountAlways red

Where a signal has two levels, only one of them counts. A few details:

  • The Discord account age is read from the Discord ID itself, so it works for every player with Discord linked.
  • The Steam account age is only checked when account trust is turned on and Check Steam age is on. It needs a Steam Web API key in Webhooks & keys, and it only works for public Steam profiles. Private profiles get neither the bonus nor the penalty.
  • Network history and connection counts come from earlier joins on CXA servers. A brand-new player starts lower and climbs just by playing.

Configuration

Turn on and tune account trust in the panel under Configuration → Network & trust → TrustScore & account risk. It also needs Network check on connect in the same section.

OptionKeyDefaultWhat it does
On / Off switchTrustScore.EnabledfalseApplies the Action to low scores and missing accounts. The score is calculated either way.
Minimum bandTrustScore.MinimumBandorangePlayers below this band get the Action.
ActionTrustScore.Actionloglog (Only log) or reject (Reject connection).
Discord account min ageTrustScore.DiscordMinAgeDays30 daysDiscord accounts younger than this lower the score strongly.
Steam account min ageTrustScore.SteamMinAgeDays30 daysSteam accounts younger than this lower the score.
Check Steam ageTrustScore.CheckSteamAgetrueReads the Steam account age. Needs a Steam Web API key.
Require DiscordTrustScore.RequireDiscordfalsePlayers without a linked Discord account get the Action.
Require SteamTrustScore.RequireSteamfalsePlayers without a linked Steam account get the Action.
Require Cfx.re accountTrustScore.RequireCfxfalsePlayers without a linked Cfx.re (FiveM) account get the Action.
Always allowed identifiersTrustScore.WhitelistemptyIdentifiers that always pass, for example discord:123456789012345678.

The same settings in config.lua, for reference. With a license, the panel's values are used.

Config.TrustScore = {                        -- 0-100 score: red < orange < yellow < lime < green
    Enabled = false,                         -- Apply the Action below (the score is calculated anyway)
    MinimumBand = 'orange',                  -- Players below this band get the Action
    Action = 'log',                          -- 'log' or 'reject'
    DiscordMinAgeDays = 30,                  -- Discord accounts younger than this are risky
    SteamMinAgeDays = 30,                    -- Steam accounts younger than this are risky (public profiles only)
    CheckSteamAge = true,                    -- Needs a Steam API key in the panel
    RequireDiscord = false,
    RequireSteam = false,
    RequireCfx = false,
    Whitelist = {},                          -- Identifiers that always pass, e.g. 'discord:123...'
}

Put the Steam Key in the Panel

The Steam age check runs on the CXA network, so it uses the Steam Web API key saved under Webhooks & keys → API keys. A key that is only in sv_config.lua is used for Steam names and avatars in your logs, not for the trust score.

Identifiers on Always allowed identifiers skip both the account trust check and the global ban check. Use the list for trusted regulars who would otherwise be flagged, for example a long-time player without Steam.

What Rejected Players See

With Action set to reject, a player below your Minimum band sees:

Output
Your account did not pass this server's security check (TrustScore: red). Link your Discord, Steam and Cfx.re accounts to FiveM or try again later.

A player who misses a required account sees the missing accounts (discord, steam or fivem):

Output
This server requires a linked account: discord,steam. Link it in FiveM settings and reconnect.

Both messages follow your server language (Config.Locale).

With Action set to log, the player joins normally. Your Connections Discord channel gets an entry titled Network check: low_trust or Network check: missing_account, with the TrustScore field showing the score and band.

Where You See It in the Panel

  • Players → Online: the TrustScore column shows the band and the score, for example ORANGE · 31.
  • Players → All players: filter the list with the band selector (All bands, red, orange, yellow, lime, green).
  • The player profile shows the TrustScore card, the number of global bans and the bands of linked accounts.

Players are only recorded while Network check on connect is on. See Players.

Using the Score in Your Scripts

The GetTrustScore export returns the score your server received when the player joined.

Lua
-- Read the trust score of a player, for example when they create a character
local trust = exports['cxa-anticheat']:GetTrustScore(source)
if trust and (trust.band == 'red' or trust.band == 'orange') then
    -- trust.score is 0 to 100, trust.band is 'red', 'orange', 'yellow', 'lime' or 'green'
    print(('Low trust player %s: %s (%s)'):format(source, trust.score, trust.band))
end

It returns nil when no score is known, for example when the network check is off or did not answer. See Custom Flags & Trust.

Recommendations

Recommended:

  • Watch the TrustScore column for a week before you turn account trust on, so you know how your real players score.
  • Start with Minimum band orange and Action log, then switch to reject once the Connections channel only shows accounts you would block.
  • Add a Steam Web API key in Webhooks & keys so the Steam age counts.
  • Add trusted regulars who score low to Always allowed identifiers.

Avoid:

  • Using lime or green as Minimum band on a public server. Many honest new players start in yellow.
  • Turning on Require Steam on servers where many players don't use Steam.
  • Relying on account trust alone. It flags risky accounts, it does not detect cheats.

Bans & the CXA Network

  • Global bans lower the trust score: an active one makes the player red, an old one lowers the score.
  • See Bans & the CXA Network.

Join Screening

  • Required identifiers in Join Screening always reject players without them, with no score involved.
  • Require Discord, Require Steam and Require Cfx.re account use the account trust Action instead, so they can also only log.
  • See Join Screening.

Custom Flags & Trust

  • Use GetTrustScore to give new accounts fewer starting items or to watch them more closely.
  • See Custom Flags & Trust.

Limitations

  • The score needs an active license and Network check on connect. If the network does not answer within the Timeout, the player joins without a score, or is rejected when Let players in when unreachable is off.
  • Players whose identifiers are in Config.Bypass.Identifiers skip the network check and get no score.
  • Scores of online players are kept in memory. After the anticheat restarts, players who were already online show no score until they reconnect.
  • Private Steam profiles cannot be aged.

Common Problems

Every Player Shows "—" in the TrustScore Column

What you see: The TrustScore column is empty for everyone.

How to fix it:

  • Turn on Configuration → Network & trust → Network check on connect.
  • Wait for players to reconnect. Scores are created when a player joins.
  • Check that the license is active and the server shows as online in Overview.

Real Players Are Rejected With "did not pass this server's security check"

What you see: Regular players get Your account did not pass this server's security check (TrustScore: ...).

How to fix it:

  • Lower Minimum band one step, or switch Action to log.
  • Lower Discord account min age if many of your players have new Discord accounts.
  • Add the affected players to Always allowed identifiers.

The Steam Age Has No Effect

What you see: Players with brand-new Steam accounts don't lose points.

How to fix it:

  • Turn on account trust and Check Steam age. The Steam age is only checked while both are on.
  • Save a valid Steam Web API key (32 characters) under Webhooks & keys → API keys.
  • The player's Steam profile may be private.

GetTrustScore Returns nil

What you see: Your script gets nil for an online player.

How to fix it:

  • Make sure Network check on connect is on.
  • The player may have joined before the anticheat restarted. The score comes back when they reconnect.
  • Bypassed players listed in Config.Bypass.Identifiers never get a score.

© 2026 CodeXart Studios · CXA Anticheat