gh-zate-cc-godot-plugins-gd/commands/restart.md

description, allowed_tools

description	allowed_tools
Quickly restart the running Godot game	mcp__godot__stop_project mcp__godot__run_project mcp__godot__get_debug_output

Quickly restart the running Godot project for fast iteration during development.

Process

1. Stop the current instance

   • Use mcp__godot__stop_project to stop the running game
   • Display: ♻️ Restarting game...

2. Wait briefly (0.5 seconds) for clean shutdown

3. Start the project again

   • Use mcp__godot__run_project with projectPath set to current working directory

4. Get initial output

   • Wait 1.5 seconds
   • Use mcp__godot__get_debug_output to check for errors

5. Display result

If restart successful:

✓ Game restarted successfully!

  Quick stats:
  • Restart time: <elapsed_time>
  • Status: Running

  Commands:
    /gd:restart     Restart again
    /gd:debug       View debug output
    /gd:stop        Stop the game

  💡 Tip: Keep this workflow for rapid iteration:
     Edit code → Save → /gd:restart → Test

If errors occurred:

⚠ Game restarted with errors:

<formatted_errors>

  Use /gd:debug for detailed error information

  Commands:
    /gd:debug       View full debug output
    /gd:stop        Stop the game

  Would you like help fixing these errors?

If no game was running:

ℹ No game was running. Starting fresh...

<use same output as /gd:run>

Usage Tips

Display these tips the first time user runs /gd:restart:

💡 Restart Command Tips:

   1. Fast Iteration: Use /gd:restart after making code changes
      instead of manually stopping and starting the game.

   2. Keyboard Shortcut: Save this command for quick access
      (check if your terminal supports command aliases)

   3. Watch Your Console: Errors from the restart will be
      displayed immediately.

   4. No Need to Stop First: /gd:restart handles stopping
      automatically.

   Typical workflow:
   1. Make changes to your code
   2. Save (Cmd+S / Ctrl+S)
   3. Run /gd:restart
   4. Test your changes
   5. Repeat!

Performance Optimization

Track restart metrics for user feedback:

📊 Restart Performance:
   • This restart: 2.1s
   • Average: 2.3s
   • Fastest: 1.8s

   Your game restarts quickly! This is great for iteration.

Error Recovery

If restart fails:

❌ Restart failed!

   Possible causes:
   - Previous instance didn't shut down cleanly
   - Godot editor is not responding
   - MCP server connection issue

   Try these steps:
   1. Wait a few seconds and try again
   2. Check if Godot editor is running
   3. Run /gd:setup to verify MCP configuration

   Or manually:
   1. /gd:stop (ensure game stops)
   2. /gd:run (start fresh)

Integration with Error Monitoring

After restart, if errors detected, activate godot-debugging skill hints:

🔍 Detected issues in restart:

   [ERROR] Null instance in player.gd:45

   Common cause: Node references changed or removed

   Quick fix: Verify all @onready var paths are correct
              after scene modifications.

   Want detailed help? Just ask about this error!