Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kabal.trade/llms.txt

Use this file to discover all available pages before exploring further.

Most issues in Kabal AI fall into a small number of categories. Find the symptom that matches yours below and follow the steps to resolve it. If none of these fixes work, use the in-app How-to-Play modal or report the issue on GitHub.

​
Wallet issues

​
Phantom is not detected

The browser cannot find the Phantom extension. This happens when Phantom is not installed or was recently disabled.
1

Install Phantom

Visit phantom.app and install the browser extension for Chrome, Firefox, Brave, or Edge.
2

Refresh the page

After installation, do a hard refresh (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on Mac) so the page can detect the newly installed extension.
3

Try connecting again

Click Connect Wallet in the dashboard. Phantom should now prompt you to approve the connection.
Phantom is only required for Live mode. Replay and Paper mode work without any wallet installed.

​
Wallet connects but is immediately rejected

If Phantom opens and you approve the connection but the dashboard shows an error or logs you out immediately, the most likely cause is an early-access whitelist check. During the invite-only early access period, only pre-approved wallet addresses can connect in Live mode. If your address is not on the whitelist, the connection is rejected. What to do: Check your invite for the whitelisted address. If you believe you should have access, contact the Kabal AI team through the official Telegram or Discord channel. There is no self-service whitelist addition.
Do not share your Phantom seed phrase or private key with anyone claiming to help you get whitelisted. Kabal AI staff will never ask for this.

​
Wallet won’t connect on this subdomain

Wallet connection only works on supported subdomains. Visiting www.kabal.trade or an unlisted subdomain may render the dashboard in a state that doesn’t support wallet interaction. What to do: Navigate to fun.kabal.trade for the full RPG dashboard (Paper, Replay, and Live modes) or pro.kabal.trade for the Command Center. Wallet connection is not available on app.kabal.trade.

​
Paper mode / SSE stream

​
”Disconnected” banner appears in Paper mode

Paper mode receives live trade events over a Server-Sent Events (SSE) stream from api.kabal.trade/events/stream. When this banner appears, the stream connection was lost.
1

Check your internet connection

The SSE stream requires an active network connection. Confirm you can load other pages before continuing.
2

Wait for auto-reconnect

The dashboard reconnects automatically using exponential backoff. The first retry fires after ~1.5 seconds. If the stream is still down, subsequent retries space out up to a maximum of 30 seconds between attempts. The banner disappears as soon as the connection is restored.
3

Try a hard refresh

If the banner persists for several minutes and your connection is healthy, do a hard refresh (Ctrl+Shift+R). This resets the SSE client and starts a fresh connection attempt.
4

Switch to Replay mode

If api.kabal.trade is experiencing downtime, use Replay mode in the meantime. Replay plays back pre-recorded sessions locally and does not require a live connection.

​
No trade events appear in Paper mode

If the Disconnected banner is not shown but the Kolosseum and Research zones stay silent, the SSE stream may be connected but sending no events. What to do: Replay mode is the right fallback. Select a session from the mode picker at / and launch it. Events in Replay run exactly the same agent loop and award XP identically to Paper mode.

​
XP and levels

​
XP is not updating after trades

XP is stored in your browser’s localStorage under the key kabal_xp_v1 and updates automatically after each kabal-trade-close and kabal-kr-drop event. If it’s not changing, one of the following is likely:
  • You recently cleared site data. Clearing localStorage resets XP to zero. Check your current value by opening the browser console and running localStorage.getItem('kabal_xp_v1').
  • Events are not firing. If Paper mode is disconnected, no trade events reach the XP listener. Resolve the connection issue first (see above).
  • You’re in a tab that isn’t receiving events. XP updates sync across tabs via the storage event, but if the tab is in a background state on some mobile browsers it may lag. Bring the tab to the foreground and wait for the next trade cycle.
Clearing your browser’s localStorage or site data permanently resets your XP, KR balance, pity counter, card inventory, and achievements. This cannot be undone. Back up your XP value before clearing site data if you want to restore it manually.

​
My level is not advancing even though I have enough XP

Level is derived from total XP using the formula: 
level = floor(sqrt(xp / 50))
You can verify your expected level at any time by opening the browser console and running: 
Math.floor(Math.sqrt(Number(localStorage.getItem('kabal_xp_v1')) / 50))
If the result matches what the dashboard shows, your level is correct and you may simply need more XP to cross the next threshold. The XP required for each level grows non-linearly — level 10 requires 5,000 XP, level 12 requires 7,200 XP.
LevelXP required
150
2200
3450
4800
51,250
72,450
105,000
127,200
1511,250
If the console result is higher than what the dashboard shows, do a hard refresh to force the UI to re-read localStorage.

​
Feature locked / “Coming Soon”

​
A feature shows as locked even though I think I should have access

Every feature in Kabal AI has a minimum level requirement. Locked features display the required level and a padlock icon. The unlock happens automatically the moment you reach that level — you don’t need to claim it or navigate away. What to do: Check the Feature Unlocks page to confirm the exact level required for the feature you want. Then verify your current level matches or exceeds it using the XP check above.
The fastest way to level up is to keep trading in Paper or Replay mode. Every win (+12 XP), every loss (+3 XP), and every KR drop (+5 to +200 XP by rarity) moves you closer to the next unlock. The pity system guarantees a KR drop after 25 consecutive non-drop wins, so drops — and their XP bonuses — are never arbitrarily blocked.

​
General errors

​
The page shows a white screen or “Recover Mode”

Kabal AI is a single-page application (SPA) that lazy-loads JavaScript chunks on demand. A white screen usually means a chunk failed to load, or a render error crashed the component tree.
1

Do a hard refresh

Press Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac). This bypasses the cache and forces the browser to download fresh assets. Most white-screen issues resolve here.
2

Check for a Recover Mode message

If you see a dark panel with the heading Jungle Kabal — Recover Mode, a render error was caught by the global error boundary. The error message shown in the panel can help identify whether the problem is a missing chunk or a data issue.
3

Clear localStorage (last resort)

If Recover Mode persists after a hard refresh, a corrupted localStorage value may be causing the crash. Open the browser console, run localStorage.clear(), then reload.
Running localStorage.clear() permanently deletes your XP, KR balance, pity counter, achievements, and all other saved progress. Only do this if the app is completely unusable and a hard refresh did not help.

​
The wrong subdomain is loading

If the page you landed on is showing the wrong dashboard layout — for example, the coming-soon landing page instead of the full RPG dashboard — check that you are visiting the correct subdomain.
What you wantWhere to go
Full RPG dashboard (Paper, Replay, Live)fun.kabal.trade
Command Center (Pro layout)pro.kabal.trade
Hub and announcementsapp.kabal.trade
Navigate directly to the correct subdomain and the right layout will load.