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
- A player connects. Your server sends their identifiers (account IDs such as
discord:orsteam:) and hardware tokens to the CXA network. This is the same network check that handles global bans. - The network weighs the signals in the table below and turns them into a score between 0 and 100.
- The score is turned into a band: red, orange, yellow, lime or green.
- 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.
- The score is saved on the Players page and your scripts can read it with the
GetTrustScoreexport.
Bands
| Band | Score | Minimum band option in the panel |
|---|---|---|
| red | 0 to 19 | Red (block nobody) |
| orange | 20 to 39 | Orange (recommended) |
| yellow | 40 to 59 | Yellow (strict) |
| lime | 60 to 79 | Lime (very strict) |
| green | 80 to 100 | Green (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:
| Signal | Effect on the score |
|---|---|
| Discord account younger than Discord account min age | Lowers it strongly |
| Discord account only a few months old | Lowers it slightly |
| Discord account several years old | Raises it |
| No Discord account linked | Lowers it |
| Steam account younger than Steam account min age | Lowers it |
| Steam account several years old | Raises it |
| No Steam account linked | Lowers it slightly |
| No Cfx.re account linked | Lowers it |
| Microsoft / Xbox account linked | Raises it slightly |
| No hardware tokens (possible spoofer) | Lowers it |
| First time seen on the CXA network | Lowers it slightly |
| Long history and many connections on CXA servers and on your server | Raises it |
| Old global bans (older than Ignore bans older than) | Lower it |
| Active global ban on any linked account | Always 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.
| Option | Key | Default | What it does |
|---|---|---|---|
| On / Off switch | TrustScore.Enabled | false | Applies the Action to low scores and missing accounts. The score is calculated either way. |
| Minimum band | TrustScore.MinimumBand | orange | Players below this band get the Action. |
| Action | TrustScore.Action | log | log (Only log) or reject (Reject connection). |
| Discord account min age | TrustScore.DiscordMinAgeDays | 30 days | Discord accounts younger than this lower the score strongly. |
| Steam account min age | TrustScore.SteamMinAgeDays | 30 days | Steam accounts younger than this lower the score. |
| Check Steam age | TrustScore.CheckSteamAge | true | Reads the Steam account age. Needs a Steam Web API key. |
| Require Discord | TrustScore.RequireDiscord | false | Players without a linked Discord account get the Action. |
| Require Steam | TrustScore.RequireSteam | false | Players without a linked Steam account get the Action. |
| Require Cfx.re account | TrustScore.RequireCfx | false | Players without a linked Cfx.re (FiveM) account get the Action. |
| Always allowed identifiers | TrustScore.Whitelist | empty | Identifiers 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:
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):
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.
-- 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))
endIt 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
orangeand Actionlog, then switch torejectonce 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
limeorgreenas 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.
Related Features
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
GetTrustScoreto 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.Identifiersskip 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.Identifiersnever get a score.
© 2026 CodeXart Studios · CXA Anticheat