Troubleshooting

hostConnected stays false

The page is not connected to the Vifu host.

• Confirm the game is loaded inside Vifu.
• Confirm manifest.json includes companion.plugin.v1.
• Confirm the SDK is loaded before companion features are used.

Commands do not run

• Register commands before the host can request them.
• Keep command state ready.
• Validate that inputSchema matches the arguments sent by the host.

Context is empty

• Return JSON-compatible values from read.
• Avoid class instances, DOM nodes, functions, and circular objects.
• Keep context values compact and visible to the player.

Local browser testing does nothing

That is expected. A static local browser tab has no Vifu host bridge. The game should still run, and companion calls should not crash the page.