Troubleshooting Guide

Simple fixes for common ChocoHax problems

Connection Issues (Panel ↔ Server)

Panel can't reach your server over WebSocket

ChocoHax uses a live WebSocket from your game server to the panel. There is no HTTP proxy path.

Required: Your game host must be able to open an outbound WebSocket to the panel wsUrl returned at auth.

What to do:

Confirm the resource authenticated and received a wsUrl

Check server console for auth success. If auth fails, fix outbound HTTPS to lyx.ac first (see below).

Allow outbound WebSocket (WSS) from the game host

Firewalls/anti-DDoS must permit outbound connections to the panel host. You do not need to whitelist panel IPs inbound on your FiveM port.

Check the panel server status page

The dashboard shows whether the WebSocket is connected. Offline WS means panel actions and live stats will fail until the game reconnects.

Before you buy: Some hosts block outbound WSS or MITM TLS. Confirm your provider allows outbound WebSocket connections to lyx.ac, otherwise the panel cannot talk to your server.

Auth Failed (Server → Panel)

Server can't connect to lyx.ac

Your hosting provider might be blocking the connection between server and panel.

How to fix:

Test connection from your server:

ping lyx.ac

Should get replies from our servers

If ping fails, contact your hosting provider:

Tell them: "My server needs to connect to lyx.ac for anticheat authentication. Please unblock this domain."

False Positives

Getting detected but not cheating

ChocoHax is detecting legitimate players. Fix your configuration.

Most common cause: Configuration not properly set up for your server

Fix Config

Turn OFF features that cause false positives:

❌ Analyze your Discord logs and identify the feature that is causing the false positive

❌ Turn off the feature or adjust the category settings

❌ Restart your server 2 times

Whitelist Areas

Add safe zones:

✅ Spawn areas

✅ Garage zones

✅ Minigames zones

Fix Permissions

Read Guide

Test Everything

Try these:

🔸 Ask players to perform normal activities while checking logs

🔸 Try to use admin actions like noclipping, teleporting, etc

🔸 Report the false positive to the support

Permissions Not Working

Admin commands not working

Read the permission guides - they explain everything.

Basic Permissions

Learn how permissions work

ACE Permissions

Advanced FiveM integration

Performance Issues

Server is lagging with ChocoHax

ChocoHax is well optimized and should not cause any performance issues.

90% of performance issues: Anti-spam protection enabled while resources spam animations

Most Common Performance Problem - Example:

❌ Bad Setup (Causes Lag)

• You have ChocoHax anti-spam protection enabled
• You have emote resources that are getting used a lot by players (like dpemotes)
• These resources spam animation entities constantly
• ChocoHax checks every entity created by these resources = massive performance hit

✅ Good Setup (No Lag)

• Disable anti-spam protection in ChocoHax settings
• OR whitelist your animation resources properly

Performance targets:

0.20ms

CPU Usage

~200MB

RAM Usage

Check your configuration:

• Disable useless features
• Turn off anti-spam if you have animation resources
• Make sure features don't conflict with other resources

Check your server health:

resmon

Make sure your server is running well overall

Still Need Help?

Try these if nothing above worked

Configuration Guide

Learn proper setup

Support Ticket

Get personalized help

Discord

Community support