Troubleshooting

Solutions to common Mythic Framework installation and server issues

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

Invalid License Key

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

Port Already in Use

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

Missing Dependencies (Windows)

Error:

FXServer.exe is not a valid Win32 application
Missing MSVCP140.dll

Solutions:

1. Install Visual C++ Redistributables:
   • VC++ 2015-2022 x64
   • Download and install
   • Restart computer
2. Install .NET Framework 4.7.2 or higher
3. Run as Administrator

Permission Denied (Linux)

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

MongoDB Connection Failed

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

MySQL Connection Failed

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

Database Timeout

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

mythic-base Failed to Start

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
   

Dependency Not Found

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
   

UI Resources Not Loading

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

Server Lag / High CPU

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

Players Can't Connect

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:

   • Forward port 30120 TCP/UDP to server local IP
   • Test with canyouseeme.org

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
   

Connection Rejected

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

Character Not Loading

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

Inventory Not Opening

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

HUD Not Showing

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

Phone Not Working

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

Commands Not Working

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

   • Search this documentation
   • Check Core Concepts
   • Review API Reference
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.