Configuring Permissions in the Dashboard Settings

The Dashboard Settings tab provides a centralized interface for managing all permission-related configuration. Let’s explore the complete permission configuration workflow.

Accessing the Tool Permissions interface:

1. Open the GameCatalyst Dashboard
2. Click the Settings tab at the top
3. In the left sidebar, click Tool Permissions
4. The main panel shows all commands organized by category

The Tool Permissions interface layout:

The interface is divided into sections:

• Top section — Bulk category toggles and an “Update Permissions” button
• Middle section — Scrollable list of all commands with individual toggles
• Bottom section — Component Dot-Path Max Depth slider (controls how deeply AI can traverse nested properties)

Understanding the command list:

Each command entry shows:

• Command name — The full command name (e.g., object.create)
• Toggle switch — Green = enabled, Gray = disabled
• Category label — Which category this command belongs to

Commands are grouped visually by category with headers separating each group.

Real-time propagation:

When you change a permission setting:

1. The change is saved to the database immediately
2. All active AI client sessions are notified within 5 seconds
3. The AI’s available tools list updates automatically
4. No restart required for Unity, the servers, or the AI client

You can verify the change took effect by asking your AI: “What commands are available?” The AI will call get_available_tools and show you the current list.

Component Dot-Path Max Depth:

This slider controls how deeply the AI can traverse nested properties when using component.set or component.add. For example:

• Depth 1: color
• Depth 2: material.color
• Depth 3: renderer.material.color
• Depth 5 (default): a.b.c.d.e

The default value is 5, which is sufficient for nearly all use cases. You can increase it if you need deeper nesting, or decrease it to limit how far the AI can traverse property chains.

Saving and persistence:

All permission changes are saved automatically. There’s no “Save” button because changes take effect immediately. Your permission configuration persists across:

• Unity Editor restarts
• GameCatalyst server restarts
• AI client disconnects and reconnects

Permissions are stored per-project in the GameCatalyst database. Each Unity project has its own independent permission configuration.

Resetting to defaults:

If you want to reset all permissions to the default state (all commands enabled):

1. Enable all category toggles at the top of the Tool Permissions tab
2. This enables every command in every category
3. Alternatively, you can manually enable individual commands as needed

There’s no “Reset to Defaults” button because the default state is simply “everything enabled.” You build your permission profile by selectively disabling commands you don’t want the AI to use.