HAWKNET DOCS

Troubleshooting

Something broken? Find your symptom below and follow the fix.

Connection Issues

“Plugin not connected”

The Hawknet daemon is not running, or the Studio plugin is not active.

Fix: Make sure Roblox Studio is open with a place file loaded. Click Reset Hawknet in the Studio toolbar. Confirm the daemon is running by checking hawknet status in your terminal.

Plugin installed but “Reset Hawknet” not visible

Studio does not detect new plugins until it restarts.

Fix: Close Roblox Studio completely and reopen it.

“Command timed out after 30 seconds”

The plugin received the command but Studio never responded. This usually means Studio is frozen or a script is stuck in an infinite loop.

Fix: Check Studio’s Output window for Luau errors. If Studio is unresponsive, force-close it and reopen.

“Circuit breaker open”

Repeated connection failures triggered a temporary safety shutoff.

Fix: Wait 30 seconds. The plugin retries automatically. If it persists, click Reset Hawknet in the Studio toolbar.

License Issues

“No valid Hawknet license”

Hawknet could not find an active entitlement for this install.

Fix: If you do not have an active subscription yet, get one from the product page. If you should already have access, treat this as a bug and email support so we can check it.

Sync Issues

Sync conflicts after editing the same file in both Studio and on disk

Both Studio and the filesystem changed since the last sync. Hawknet does not know which version to keep.

Fix: Ask the AI to check for conflicts and resolve them. You can choose to keep the Studio version, the filesystem version, or merge manually.

Multi-Agent Issues

“Blocked” or lock errors

Another AI session is editing the same script. Hawknet uses locks to prevent two agents from writing to the same thing at once.

Fix: Wait for the other session to finish. Locks expire after 5 minutes. If you need to override, ask the AI to force-acquire the lock.

MCP Configuration Issues

AI client does not see Hawknet after install

The AI client was not running when Hawknet was installed, or it did not pick up the config file.

Fix: Run hawknet by itself in your terminal to reconfigure all detected clients. Then fully restart your AI client.

Open Cloud Issues

Open Cloud auth fails

Hawknet cannot authenticate with Roblox Open Cloud. Credentials are missing or expired.

Disclaimer: Open Cloud support is still experimental, so auth issues here may reflect unfinished behavior on our side as well as local setup problems.

Fix: Run hawknet auth to log in via OAuth. If you use API key auth instead, set the ROBLOX_CLIENT_SECRET environment variable.

Still Stuck?