Skip to main content

Troubleshooting

If something isn't working, start here. Most issues are solved in 30 seconds.

The resource won't start​

If you see this in the console:

Couldn't find resource fiverank_guard

Solution:

  1. Check that the folder is in the right place: resources/fiverank_guard/fxmanifest.lua
  2. Check that your server.cfg has the line ensure fiverank_guard.

"Invalid token"​

If you see this:

[FiveRank Guard] INVALID_TOKEN — the token doesn't exist or has been revoked.

Solutions:

  1. Check that the token is correctly typed in server.cfg (no spaces, quotes properly closed).
  2. Generate a new token at Panel → FR Guard → Generate new API Key and replace it in server.cfg.
  3. Each token only works for one server. If you copied a token from another server, it won't work.

"Server not verified"​

If you see this:

[FiveRank Guard] NOT_VERIFIED_OWNER — this server is not verified.

Solution:

FR Guard only works on verified servers. Go to Panel → Servers → [Your server] → Verify and complete the verification process.

All players are being rejected​

If nobody can join the server:

  1. Check if it says "Discord required". Your players probably don't have Discord open. Let them know they must open Discord before connecting.
  2. Check that your VPS has outbound internet access. From your VPS run: 
    curl -I https://fiverank.gg
    It should respond HTTP/2 200. If not, it's a firewall issue with your hosting.
  3. Make sure you have set fiverank_fail_open "1" so a temporary issue doesn't lock everyone out.

The connection card gets stuck​

If the "Checking your reputation…" card never progresses:

  • Your server can't reach fiverank.gg. This is almost always the hosting's firewall blocking outbound HTTPS. Ask your provider to open outbound port 443.
  • If you use a private network (Pterodactyl, Docker), check that you have outbound internet access from the container.

I want to see more logs to understand what's happening​

Enable detailed logs temporarily:

set fiverank_debug "1"

Restart the resource. Now you'll see each check in the console:

[FiveRank Guard] [debug] connecting: Carlos (270...)
[FiveRank Guard] [debug] discord = 123456789012345678
[FiveRank Guard] [debug] cache miss → response in 142ms → allowed

When you're done, disable it again (set fiverank_debug "0") to keep your logs clean.

Still not working​

Don't stay stuck. Join the Discord and we'll help you in under 24 hours:

When asking for help, attach:

  1. Console screenshot with fiverank_debug enabled.
  2. Your server.cfg (hide the token before sending it).
  3. Which framework you're using (ESX, QBCore, etc.).