142 lines
3.1 KiB
Markdown
142 lines
3.1 KiB
Markdown
---
|
||
description: Quickly restart the running Godot game
|
||
allowed_tools:
|
||
- 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!
|
||
```
|