Enabling and Disabling Individual Commands
GameCatalyst’s permission system lets you control exactly which commands your AI assistant can execute. Every command can be individually enabled or disabled, giving you complete control over what the AI can and cannot do.
How to enable or disable commands:
- Open the GameCatalyst Dashboard in Unity
- Click the Settings tab
- Click Tool Permissions in the left sidebar
- You’ll see a list of all 60+ commands organized by category
- Each command has a toggle switch next to it
- Click the toggle to enable (green) or disable (gray) a command
What happens when you disable a command:
When you disable a command, it immediately becomes unavailable to all connected AI clients. If an AI tries to use a disabled command, it receives a clear error message: “This command is not available. Check Tool Permissions in the Dashboard.”
The AI sees which commands are available through the get_available_tools management command. When you change permissions, the AI’s tool list updates within 5 seconds automatically. No need to restart anything.
Common use cases:
- Disable file deletion — Turn off
file.deleteandfolder.deleteif you want the AI to create and modify files but never delete them - Disable play mode control — Turn off
play_modeif you want to manually control when Unity enters play mode - Disable component modification — Turn off
component.setif you want the AI to create objects but not modify existing components - Disable workspace.plan — Turn off the
workspace.plancommand if you prefer the AI to use its own planning system (DAP guidance still applies)
Permission inheritance:
GameCatalyst uses a 4-layer permission system. A command must be allowed at every layer to execute:
- Command Definitions — The command exists in the system
- Project Permissions — The project allows this command
- Engine Session — The Unity instance allows this command
- Client Session — The AI client’s session allows this command (intersection of all above)
When you toggle a command in the Dashboard, you’re controlling Layer 2 (Project Permissions). The change propagates through all layers automatically.
Manual refresh:
If permissions don’t seem to update, click the Update Permissions button at the bottom of the Tool Permissions tab. This forces an immediate refresh across all layers.