Troubleshooting

Common issues and the fastest way to resolve them. If you do not see your issue here, contact support from your account dashboard.

Sign-in / connectivity

"Sign-in failed. Check your email and password" on a valid account. Known issue in Windows builds prior to v0.10.0 — the plugin was using a legacy credential verifier that fails for real accounts. Upgrade to v0.10.0 (Windows) to resolve. macOS customers encountering this today should contact support; the v0.10.0 .pkg is pending.

"Cannot reach the service" on first launch. The plugin retries against a secondary endpoint automatically (since v0.9.21), so most transient issues resolve on a second attempt. If it persists:

1. Check your internet connection.
2. Confirm your account is active from the web dashboard.
3. Sign out from the plugin and sign in again.

"Session expired" in the middle of a long task. Sign in again from the plugin — your conversation history is preserved. See Authentication for how token refresh works.

Chat behaviour

Chat scrolls away while I am reading a streaming reply. Resolved in v0.9.21. If you still see this, you are on an older build — please upgrade.

Paragraph breaks missing in streamed answers. Resolved in v0.9.21. Upgrade to restore correct formatting.

"New Chat" seems to remember the previous conversation. Resolved in v0.9.21. Upgrade.

Play-mode (PIE) tools

An actor-manipulation command silently does nothing during play. Use the _smooth variants (e.g. move_actor_smooth, rotate_actor_smooth) for runtime animation during play mode. The editor-only tween commands are not safe during play and the plugin will now redirect or block them with a clear error.

"Spawn is blocked during play" error. This is intentional. Spawn actors from edit mode or from Blueprints; the MCP spawn command is restricted to edit mode to protect your project from runtime corruption.

Install

Plugin does not appear in UE's Plugins dialog. Confirm the KARIANA folder is at <UProject>/Plugins/KARIANA/ (or Engine\Plugins\Marketplace\KARIANA\ for engine-wide) and that KARIANA.uplugin is directly inside it. If the folder ended up nested (KARIANA/KARIANA/) after extraction, flatten it.

UE tries to rebuild modules from source on launch. The shipped zip includes prebuilt binaries under Binaries\Win64\. If that folder is missing or got dropped during extraction, UE treats KARIANA as a source plugin and fails compiling from Source/ without a C++ toolchain. Re-extract the zip and confirm Binaries\Win64\ is present.

Permission denied installing engine-wide. Writing into Program Files\Epic Games\UE_5.7\Engine\Plugins\Marketplace\ requires Administrator rights. Run File Explorer as Administrator before moving the folder.

macOS — "cannot be opened" dialog on the v0.9.22 .pkg. Approve it under System Settings → Privacy & Security and try again. The package is not yet notarised. macOS is currently held at v0.9.22; v0.10.0 .pkg is pending.

Performance

First response is slow after a long idle. The provider warms up connections on demand; subsequent responses are faster. This is expected.

Model list is empty after sign-in. Sign out and sign back in. If the list is still empty, contact support — it usually means your account does not yet have models assigned.

Getting help

• Include your plugin version (visible in the KARIANA panel).
• Include your UE version.
• Include a short description of what you did and what you expected.

Support contact is in your account dashboard.