Skip to main content
This guide covers common issues encountered during installation and server operation, with step-by-step solutions.

​
Quick Diagnostics

Before diving into specific issues, run these quick checks:
1

Check Prerequisites Running

# Windows - Check services
net start | findstr "MongoDB"
net start | findstr "MySQL"

# Linux - Check services
systemctl status mongod
systemctl status mysql
2

Verify Server Console

Look for the exact error message in server console - most errors are self-explanatory
3

Check F8 Console

In-game, press F8 to see client-side errors (JavaScript errors, network issues)
4

Review Logs

Check server logs for detailed error information

​
Installation Issues

​
Server Won’t Start

Error:
[Error] Invalid license key
[Error] License key validation failed
Solutions:
  1. Verify license key in server.cfg is correct
  2. Check key matches your server IP
  3. Generate new key if IP changed: Cfx.re Portal
  4. For localhost testing, use 127.0.0.1 as the IP when generating
Test:
# Check what IP server thinks it has
curl ifconfig.me
Error:
[Error] Couldn't bind port 30120
[Error] Address already in use
Solutions:Windows:
# Find what's using port 30120
netstat -ano | findstr :30120

# Kill the process (replace PID with actual process ID)
taskkill /PID [PID] /F

# Or use different port in server.cfg
endpoint_add_tcp "0.0.0.0:30121"
endpoint_add_udp "0.0.0.0:30121"
Linux:
# Find what's using port 30120
lsof -i :30120

# Kill the process
kill -9 [PID]

# Or use different port
Error:
FXServer.exe is not a valid Win32 application
Missing MSVCP140.dll
Solutions:
  1. Install Visual C++ Redistributables:
  2. Install .NET Framework 4.7.2 or higher
  3. Run as Administrator
Error:
bash: ./FXServer: Permission denied
cannot execute binary file
Solutions:
# Make executable
chmod +x FXServer
chmod +x run.sh

# Fix ownership
sudo chown -R $USER:$USER .

# Verify architecture (should be x86_64)
uname -m

# If wrong architecture, download correct build

​
Database Connection Issues

Error:
[mythic-base] Failed to connect to MongoDB
[Error] MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Solutions:Step 1: Verify MongoDB is Running
# Windows
net start | findstr MongoDB
# If not running:
net start MongoDB

# Linux
systemctl status mongod
# If not running:
sudo systemctl start mongod
Step 2: Test Connection
# Test MongoDB connection
mongo

# If using authentication:
mongo -u mythic -p your_password --authenticationDatabase admin
Step 3: Check Connection String
  • Verify format in server.cfg: 
    mongodb://[username:password@]host:port/[?options]
  • Common mistakes:
    • Missing authSource=admin with authentication
    • Wrong username/password
    • Wrong port (default is 27017)
Step 4: Check Firewall
# Windows - Allow MongoDB through firewall
netsh advfirewall firewall add rule name="MongoDB" dir=in action=allow protocol=TCP localport=27017

# Linux - Allow in UFW
sudo ufw allow 27017/tcp
Step 5: Check MongoDB Logs
  • Windows: C:\Program Files\MongoDB\Server\6.0\log\mongod.log
  • Linux: /var/log/mongodb/mongod.log
Error:
[oxmysql] Connection failed
[Error] Access denied for user 'mythic'@'localhost'
[Error] Unknown database 'MythicFramework_345AE9'
Solutions:Issue: Wrong Credentials
# Test credentials
mysql -u mythic -p
# Enter password from connection string

# If fails, create user:
mysql -u root -p
CREATE USER 'mythic'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON *.* TO 'mythic'@'localhost';
FLUSH PRIVILEGES;
Issue: Database Doesn’t Exist
# Connect as root
mysql -u root -p

# Check if database exists
SHOW DATABASES;

# Create if missing
CREATE DATABASE MythicFramework_345AE9 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Issue: Connection String Format Verify format:
mysql://user:password@host:port/database?charset=utf8mb4
Common mistakes:
  • Special characters in password not URL-encoded
  • Missing database name
  • Wrong port (default is 3306)
Issue: MySQL Not Running
# Windows (XAMPP)
# Start from XAMPP Control Panel

# Linux
sudo systemctl start mysql
# or
sudo systemctl start mariadb
Error:
[Error] Connection timeout
[Error] Pool connection timeout
Solutions:
  1. Increase timeout in connection string: 
    mongodb://.../?connectTimeoutMS=30000&socketTimeoutMS=30000
mysql://...?connectTimeout=30000
  2. Check database load: 
    # MongoDB
mongo
db.currentOp()

# MySQL
mysql -u root -p
SHOW PROCESSLIST;
  3. Restart databases: 
    # Windows
net stop MongoDB && net start MongoDB
# MySQL via XAMPP Control Panel

# Linux
sudo systemctl restart mongod
sudo systemctl restart mysql

​
Resource Loading Issues

Error:
[Error] Failed to start resource mythic-base
[Error] Couldn't load resource mythic-base
Critical: mythic-base MUST start successfully. All other Mythic resources depend on it.Solutions:
  1. Verify folder exists: 
    resources/[mythic]/mythic-base/
  2. Check fxmanifest.lua exists: 
    resources/[mythic]/mythic-base/fxmanifest.lua
  3. Review console for specific error:
    • Lua syntax errors
    • Missing files
    • Database connection issues
  4. Check Node.js installed: 
    node --version
# Should show v16+ or v18+
  5. Try manual start: 
    # In server console
refresh
start mythic-base
# Watch for specific error
Error:
[Error] Dependency 'mythic-base' not found for 'mythic-inventory'
[Error] Couldn't start resource - dependency failed
Solutions:
  1. Check load order in configs/resources.cfg: 
    # Correct order:
ensure oxmysql          # First
ensure mythic-base      # Second
ensure mythic-pwnzor    # Third
ensure mythic-characters
ensure mythic-inventory
# etc.
  2. Verify dependency exists:
    • Check if the dependency resource folder exists
    • Verify it’s not commented out in resources.cfg
  3. Restart in order: 
    refresh
start oxmysql
start mythic-base
start mythic-inventory
Error:
  • HUD not showing
  • Inventory UI blank
  • Phone not appearing
Solutions:
  1. Check resource is started: 
    # In server console
status mythic-hud
status mythic-inventory
status mythic-phone
  2. Check for JavaScript errors:
    • In-game, press F8
    • Look for red JavaScript errors
    • Screenshot and analyze
  3. Clear FiveM cache: 
    # Windows
%localappdata%\FiveM\FiveM.app\cache
# Delete entire cache folder

# Restart FiveM client
  4. Verify UI build files exist: 
    resources/[mythic]/mythic-hud/ui/dist/
resources/[mythic]/mythic-inventory/ui/dist/
# Should contain index.html, main.js, etc.
  5. Check NUI devtools (F8 in-game): 
    # Type in F8 console:
nui_devtools
# Opens Chrome DevTools for UI debugging

​
Runtime Issues

​
Performance Problems

Symptoms:
  • Server FPS drops below 30
  • Player desync
  • Delayed interactions
Diagnosis:Press F8 in-game and type:
resmon true
This shows which resources are using the most CPU and memory. Restart or optimize high-usage resources to improve performance.Additional Solutions:
  • Reduce player count if server can’t handle the load
  • Update resources to latest versions
  • Check system resources (Task Manager on Windows, htop on Linux)

​
Player Connection Issues

Error (Client):
Connection timed out
Server is not responding
Solutions:
  1. Verify server is running:
    • Check console shows “Server is ready”
    • No crash errors in console
  2. Check firewall: 
    # Windows - Open port 30120
netsh advfirewall firewall add rule name="FiveM" dir=in action=allow protocol=TCP localport=30120
netsh advfirewall firewall add rule name="FiveM UDP" dir=in action=allow protocol=UDP localport=30120

# Linux
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
  3. Check router port forwarding:
  4. Test connection: 
    # From another computer
telnet YOUR_SERVER_IP 30120
# Should connect

# Or use netcat
nc -zv YOUR_SERVER_IP 30120
  5. Check sv_maxclients not full: 
    # In server console
status
# Shows current players vs max
Error:
Connection rejected by server
You have been kicked
You are banned from this server
Solutions:
  1. Check ban list: 
    # In mythic-base database
mongo
use fivem
db.bans.find()

# Remove ban
db.bans.deleteOne({ "identifier": "steam:11000..." })
  2. Check whitelist:
    • If queue/whitelist enabled, verify player is whitelisted
  3. Check anti-cheat:
    • mythic-pwnzor may be blocking player
    • Check console for anti-cheat messages
    • Temporarily disable to test: stop mythic-pwnzor
  4. Review connection logs:
    • Check Discord connection webhook
    • Look for specific rejection reason
Symptoms:
  • Stuck at character selection
  • Infinite loading
  • Spawn but can’t move
Solutions:
  1. Check mythic-characters started: 
    status mythic-characters
  2. Check database for character: 
    mongo
use fivem
db.characters.find({ "SID": 1 })
// Or search by player identifier
  3. Check F8 console (client):
    • Look for JavaScript errors
    • Network errors
    • Missing resources
  4. Try /logout command: 
    # Forces character selection again
/logout
  5. Delete character cache: 
    # Windows (client)
%localappdata%\FiveM\FiveM.app\cache
# Delete contents

# Server-side
restart mythic-characters

​
Common Gameplay Issues

Solutions:
  1. Check keybind: Default is I
  2. Verify mythic-inventory started: status mythic-inventory
  3. F8 console - check for errors
  4. Try: restart mythic-inventory
  5. Clear cache and reconnect
Solutions:
  1. Verify mythic-hud started
  2. F8 console - check for JavaScript errors
  3. Try: restart mythic-hud
  4. Check if HUD is hidden: Some resources can hide HUD
  5. Clear FiveM cache
Solutions:
  1. Check keybind: Default is P
  2. Verify mythic-phone started
  3. Check if you have phone item in inventory
  4. F8 console - JavaScript errors
  5. Try: restart mythic-phone
Solutions:
  1. Verify mythic-commands started
  2. Check permissions (for admin commands)
  3. Verify syntax: /command arguments
  4. Check console for command errors
  5. Some commands require specific resources running

​
Advanced Troubleshooting

​
Enable Debug Mode

server.cfg
# Enable verbose logging
set sv_environment dev
setr log_level 2

# Enable SQL debugging
set mysql_debug true

# Enable resource monitoring
set resmon 1

​
Check Logs

Server Logs:
  • Console output (save with logging software)
  • Discord webhooks (if configured)
  • Custom log files (if logging resource installed)
Database Logs:
  • MongoDB: /var/log/mongodb/mongod.log (Linux)
  • MySQL: Check error log location in MySQL config
FiveM Client Logs:
  • Windows: %localappdata%\FiveM\FiveM.app\logs
  • Look for CitizenFX_log_*.txt

​
Test Individual Resources

# Stop all and test one by one
stop mythic-hud
stop mythic-inventory
# etc.

# Start individually
start mythic-hud
# Test if works

start mythic-inventory
# Test if works

​
Network Diagnostics

# Check network stats
net_stats

# Check player connections
status

# Monitor bandwidth
# Windows: Resource Monitor > Network
# Linux: iftop or nethogs

​
Getting Help

If you can’t resolve the issue:
1

Gather Information

  • Exact error message
  • Server console output
  • F8 console output (screenshot)
  • server.cfg (remove sensitive data)
  • Steps to reproduce
2

Check Documentation

3

Community Support

  • Join Discord
  • Post in #support channel
  • Provide all info from Step 1
Before asking for help:
  • Try solutions in this guide
  • Search Discord for similar issues
  • Provide complete information (partial info = longer resolution time)

​
Prevention Best Practices

Regular Backups

Backup databases daily. Test restore procedures monthly.

Monitor Resources

Use resmon regularly. Watch for unusual CPU/RAM usage.

Update Carefully

Test updates on dev server before production. Always backup first.

Document Changes

Keep notes on configuration changes. Makes troubleshooting easier.
Most issues are configuration-related. Double-check server.cfg, database connections, and resource load order before assuming code issues.