Troubleshooting

Troubleshooting

http://cef/... page does not load

Check:

• resource exists under scriptfiles/cef/<resource>/
• CEF_AddResource("<resource>") is called
• URL uses http://cef/<resource>/<file>
• file path and case match
• resource was repackaged/revalidated after changes

Resource 'assets' not found

Your frontend build probably uses absolute asset paths.

For Vite:

export default defineConfig({
  base: "./",
});

Then rebuild and copy dist/ to your CEF resource directory.

Browser is created but invisible

Check:

• page is not fully transparent
• browser is visible with CEF_SetBrowserVisible(..., true)
• correct browser ID is used
• viewport size is valid
• for WorldObject3D, browser is attached to an object
• texture name matches the model texture

ERROR_ID_ALREADY_IN_USE

The browser ID is already active for that player.

Fix:

• use a different ID
• call CEF_DestroyBrowser first
• wait before recreating

CEF handshake timeout

Possible causes:

• client plugin missing
• client plugin blocked by antivirus
• CEF UDP port blocked
• server/client version mismatch
• wrong IP/endpoint
• server firewall or provider firewall

WorldObject3D texture does not apply

Check:

• object exists for the player
• CEF_CreateWorldBrowser succeeded
• CEF_AttachBrowserToObject is called after creation
• texture name is correct
• width/height are reasonable
• object model actually contains the target texture

DevTools

Enable DevTools for a browser:

CEF_EnableDevTools(playerid, browserid, true);

Use it to inspect:

• console errors
• missing resources
• JS exceptions
• failed network requests