Connection filters
The on-connect pipeline: what each filter blocks, the options behind every card, and the keys with no card at all.
Connection filters decide who is allowed to finish connecting, before the player is in the world. They run on the Raven cloud during the join, on every connection attempt, and a player who trips one never reaches your server. This page covers each filter and every option behind the cards.
Where the section is
Open Main Settings for the server. The section sits under Auto-Installation (Resources Installation from 1.9.3) on resource 1.7.3 and newer. An older resource has no ConnectionFilters config keys at all, so the section is hidden for those servers rather than shown and ignored.
The header carries a master toggle. Switching it off stops the whole pipeline, and because it maps to ConnectionFilters.Enable it is one switch for all four filters. Your own ban list and the network ban list are separate from the pipeline and keep working either way.
The filters at a glance
Four filters, all evaluated in the Raven cloud. Each has its own toggle under the master one, and each ships in the state below.
| Filter | Config key | Ships as | Rejects |
|---|---|---|---|
| Name filter | NameFilter.Enable | off | A player name that carries a script payload, breaks a length limit, or contains a blocked substring. |
| Discord filter | DiscordFilter.Enable | on | A player with no linked Discord account, or one whose account is newer than the minimum age. |
| VPN / proxy check | VpnCheck.Enable | off | A connection through a commercial VPN, an open proxy or a datacentre. |
| Country filter | CountryFilter.Enable | off | A country you blocked, or every country you did not allow. |
When a filter rejects a player
A player who trips any one filter is turned away during the join and never reaches your server.
Global bans
The first card in the section, on servers where the section exists. It is not part of the filter pipeline and it is not covered by the master toggle: the switch and its whitelist live on your server record rather than in the config. Full detail on Global bans.
Name filter
Four options behind the toggle. Changing any of them turns the filter on if it was off, so the change takes effect.
| Option | Key | Default | What it does |
|---|---|---|---|
| XSS / injection detection | XssDetection | on | Rejects a name that carries an HTML or script injection payload. Leave it on: a name is rendered in a lot of places and this is what stops one being used to deliver a payload. |
| Block non-ASCII names | BlockNonAscii | off | Rejects any character outside printable ASCII. A blunt instrument: it turns away emoji and every player whose name is written in Cyrillic, Arabic, Hebrew, Chinese or Japanese. |
| Min length / Max length | MinLength / MaxLength | 0 / 32 | Measured on the trimmed name. Either limit set to 0 is off, so the shipped pair means no minimum and a 32 character ceiling. |
| Blocked words | BlockedWords | empty | Case-insensitive substrings, not whole words, so a short entry matches inside longer names. Adding admin also rejects a player called Badminton. |
Discord filter
This is the one filter that ships enabled, and the one most worth reading before you leave it alone. The shipped state is the filter on, Force Discord off, and the minimum age check on at 14 days.
| Option | Key | Default | What it does |
|---|---|---|---|
| Force Discord | DiscordFilter.Force | off | Rejects any player with no linked Discord account. A real policy decision rather than a spam setting: every player who has not linked Discord in FiveM is turned away. |
| Minimum account age | DiscordFilter.Age.Enable | on | Rejects accounts newer than the value below, and also rejects players with no linked account at all, because there is no age to read without one. |
| Age in days | DiscordFilter.Age.Value | 14 | Whole days, clamped to at least 1 on save. |
VPN / proxy check
One toggle, no options. It rejects connections through commercial VPNs, open proxies and datacentres.
Country filter
Allows or blocks connections by country. The card body is always open, even while the filter is off, so you can look at the map and build a list before committing to anything.
| Mode | Stored as | Effect |
|---|---|---|
| Block selected | blacklist | Rejects the countries you picked and lets everyone else in. The shipped mode. |
| Allow only selected | allowlist | Rejects everyone except the countries you picked. Read that twice before saving: one forgotten country locks out a whole region of your player base. An allowlist that somehow ends up empty allows everyone rather than nobody. |
Pick countries by clicking the map or searching the list. The map has its own search, region filters and zoom, and each selection also appears as a removable chip under it. Codes are stored as uppercase two-letter codes whatever you typed or clicked.
Picking a country turns the filter on automatically, and clearing the list back to empty turns it off again, because a country filter with no countries filters nothing. For the same reason the toggle refuses to switch on while nothing is selected, and the card says so.
Keys with no card
Two keys live under ConnectionFilters and are visible in the JSON editor, but neither is edited from this section.
| Key | Default | Where it is |
|---|---|---|
AutoWhitelistTxAdmins | on | The one connection-filter key the resource itself reads. A player the server has seen authenticate as a txAdmin admin is treated as whitelisted, which exempts them from the detections that honour the whitelist. Its toggle is on the Moderators tab, covered on Admins and moderators. |
ForceClientTokens.Enable | on | Retired. It is still in the config template, but editing it changes nothing. |
If you have seen client tokens named somewhere and gone looking for the switch, that is why you could not find it: there is no choice left to offer.
The txAdmin auto-whitelist is the opposite case: a live setting with a card somewhere else. What a whitelisted player is exempt from, and which resource versions honour which detections, is on Admins and moderators, with the Ace side on Ace permissions.
Editing behaviour to know about
- Changing any option inside a filter turns that filter on if it was off. Editing the Discord age while the Discord filter is disabled enables it, so check the toggle after you tune something.
- Nothing saves as you type. The section rides the same Save Changes bar as the rest of Main Settings.
- Turning a filter on without giving it anything to act on does not count as a change. The country filter with no countries is the case you will meet, and it stays unsaved until you pick one.
- Changing any of this needs the settings edit permission.