Troubleshooting¶

// In Unity Editor: IntelliVerse-X → Diagnostics → Run Check
// Or in code:
var report = IVXDiagnostics.RunCheck();
Debug.Log(report);

// 1. Check config exists
var config = Resources.Load<IntelliVerseXConfig>("IntelliVerseXConfig");
if (config == null)
{
    Debug.LogError("Config not found! Create via Assets → Create → IntelliVerse-X → Config");
}

// 2. Initialize manually
await IntelliVerseXSDK.InitializeAsync(config);

// 3. Check for errors in console

// Test connection
try
{
    await IVXNakamaManager.ConnectAsync();
    Debug.Log("Connected successfully!");
}
catch (Exception ex)
{
    Debug.LogError($"Connection failed: {ex.Message}");

    // Check specific error
    if (ex is HttpRequestException)
    {
        Debug.Log("Network issue - check internet connection");
    }
    else if (ex.Message.Contains("certificate"))
    {
        Debug.Log("SSL certificate issue");
    }
}

try
{
    await IVXAuthService.LoginAsync(email, password);
}
catch (AuthException ex) when (ex.Code == "Unauthorized")
{
    ShowError("Invalid email or password");
}
catch (AuthException ex) when (ex.Code == "UserNotFound")
{
    ShowRegisterPrompt();
}

// Enable verbose logging
IVXAdsManager.EnableDebugLogging(true);

// Check initialization
IVXAdsManager.OnInitialized += (success) =>
{
    Debug.Log($"Ads initialized: {success}");
};

// Check ad load events
IVXAdsManager.OnRewardedAdLoaded += () =>
{
    Debug.Log("Rewarded ad loaded");
};

IVXAdsManager.OnRewardedAdFailed += (error) =>
{
    Debug.LogError($"Rewarded ad failed: {error}");
};

// Ensure data persists
IVXSecureStorage.SetObject("game_save", saveData);

// Verify it was saved
var loaded = IVXSecureStorage.GetObject<SaveData>("game_save");
if (loaded == null)
{
    Debug.LogError("Save failed!");
}

// For cloud sync, ensure connected
if (IVXNakamaManager.IsConnected)
{
    await IVXCloudStorage.SyncAsync();
}

// Check leaderboard exists
var entries = await IVXLeaderboardManager.GetTopScoresAsync("weekly_highscore");

if (entries == null || entries.Length == 0)
{
    // Check if leaderboard exists on server
    Debug.Log("No entries - leaderboard may be empty or not exist");

    // Submit a test score
    await IVXLeaderboardManager.SubmitScoreAsync("weekly_highscore", 100);
}

// Enable all debug features
IntelliVerseXSDK.EnableDebugMode(true);

// Or specific features
IVXLogger.SetLevel(LogLevel.Verbose);
IVXAdsManager.EnableDebugLogging(true);
IVXNakamaManager.EnableVerboseLogging(true);