VibeUE

MCP Server for Unreal Engine

TROUBLESHOOTING

Solutions for common VibeUE issues and problems

If you're experiencing issues with VibeUE, you've come to the right place. Check the common problems and solutions below. If you don't find your issue, reach out to the community or file an issue on GitHub.

🔌 MCP Server Connection Issues

⚠️ MCP Server Not Connecting

Symptom:

Tools don't appear in chat, or "Server not responding" error appears

Solution Steps:

  1. Check that your MCP server is running and accessible
  2. For HTTP servers: Open http://localhost:3000 in your browser (replace 3000 with your port)
  3. Verify the URL in vibeue_mcp_servers.json is correct
  4. Check that the server process hasn't crashed - look at server logs
  5. Restart Unreal Engine
  6. Check Unreal Editor logs (Window → Developer Tools → Output Log) for connection errors

⚠️ "Connection Timeout" Error

Symptom:

Server connection times out after 30 seconds

Causes & Solutions:

  • Firewall blocking: Allow Unreal Engine in your firewall settings
  • Wrong host/port: Verify the server URL (e.g., http://127.0.0.1:3000)
  • Server not ready: Some servers take time to start - check server startup logs
  • Network issues: If using remote servers, check your network connection

📦 Plugin & Installation Issues

⚠️ VibeUE Plugin Not Found

Symptom:

Plugin doesn't appear in Settings, or "Plugin not loaded" error

Solution Steps:

  1. Verify VibeUE is installed in your Plugins folder
  2. Open Edit → Plugins and search for "VibeUE"
  3. If not found: GitHub installation: Run GenerateProjectFiles.bat and rebuild
  4. If not found: FAB installation: Reinstall via Fab
  5. Restart Unreal Engine
  6. Check for compilation errors in the Output Log

⚠️ Installation Fails on FAB

Symptom:

Installation gets stuck or shows error during FAB installation

Solution Steps:

  1. Close all Unreal Engine instances
  2. Delete your project's Plugins/VibeUE folder
  3. Try the installation again
  4. If error persists: Install via GitHub instead

🛠️ Tool & Feature Issues

⚠️ Tools Not Responding / Errors

Symptom:

Using a tool results in error or "Tool not available" message

Solution Steps:

  1. Check the Unreal Editor output log for detailed error messages
  2. Verify you have a valid level open before using level-related tools
  3. Some tools require specific prerequisites (e.g., selected actor for actor tools)
  4. Restart Unreal Engine and try again
  5. Check if the tool is available in your VibeUE version

⚠️ AI Chat Panel Not Appearing

Symptom:

VibeUE button doesn't appear or chat panel won't open

Solution Steps:

  1. Check that VibeUE plugin is enabled: Edit → Plugins → Search "VibeUE" → Enable
  2. Restart Unreal Engine
  3. Try opening via menu: Tools → VibeUE → AI Chat
  4. If still missing, check Output Log for plugin load errors
  5. Verify you have an API key configured

⚙️ Configuration Issues

⚠️ Invalid API Key Error

Symptom:

"Invalid API key" or "Authentication failed" error in chat

Solution Steps:

  1. Open VibeUE Settings (gear icon in chat panel)
  2. Verify your API key is correct (get new key at vibeue.com/login)
  3. For OpenRouter: Ensure key from openrouter.ai/keys is correct
  4. No extra spaces or characters in the key
  5. Save and restart Unreal Engine

⚠️ Configuration File Not Found

Symptom:

External MCP servers not loading, or error about missing config

Solution Steps:

  1. Locate the correct config file for your installation type (FAB vs GitHub)
  2. If file doesn't exist, create it with valid JSON content
  3. See the MCP Servers documentation for file location and format
  4. Restart Unreal Engine after creating the file

📞 Still Need Help?

→

Check the FAQ

Visit our FAQ page for answers to common questions

→

Contact Support

Reach out on our support page or community channels

→

Report an Issue

Found a bug? Report it on GitHub

Back: Custom Tools All Documentation