Troubleshooting

Solutions to common issues you might encounter with UnrealPilot.

Common Issues

Chat window not opening

Possible solutions:

  • Verify plugin is enabled in Edit → Plugins
  • Restart Unreal Engine Editor completely
  • Check Output Log for error messages
  • Re-install the plugin if issues persist

AI not responding

Check these items:

  • Verify your API key is correct in Project Settings
  • Check your internet connection
  • Test your API key directly on the provider's website
  • Check if you've hit rate limits with your provider
  • Look for error messages in the Output Log

Tools not working correctly

Troubleshooting steps:

  • Ensure you're using Unreal Engine 5.0 or newer
  • Verify all required engine modules are loaded
  • Check the Output Log for specific error messages
  • Try restarting the editor
  • Simplify your request and try again

Performance is slow

Optimization tips:

  • Use faster AI models (GPT-4o instead of GPT-4, Claude Sonnet instead of Opus)
  • Clear conversation history if it gets very long
  • Close unnecessary editor windows and panels
  • Check your system resources (RAM, CPU usage)
  • Ensure stable internet connection

API costs too high

Ways to reduce costs:

  • Use cheaper models for simple tasks
  • Be more specific in your prompts to avoid back-and-forth
  • Clear conversation history to reduce context sent
  • Batch similar requests together

Still Having Issues?

If you can't resolve your issue with the solutions above:

💡 Tip: Before opening a new issue, search existing ones - your problem might already be solved!

Last updated: December 2025