SA:O APIExternal browser integration

Opens an approved HTTPS destination in the operating system browser without exposing arbitrary shell execution.

Syntax

Copy signature

bool openExternalURL(string url)

Arguments

urlstring

HTTPS URL up to 4096 characters.

Returns

true when the destination passed the permission policy and the system open request was started; false otherwise.

Ownership and lifecycle

External URLs are opened only when the HTTPS destination is allowed by the client browser-domain permission state or is a fixed first-party exception. The call creates no persistent handle.

Important behavior

• Normal destinations must already be allowed by the client CEF domain-permission state.
• A small immutable first-party onboarding/purchase allowlist bypasses the generic prompt; arbitrary server-provided URLs do not.

Where this comes from

SOURCECLuaBrowserDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaBrowserDefs.cpp INTRODUCED / EXTENDEDc5c5cba3dRead the commit and why the change was made

RELATED SA:O APIS

Continue exploring

Read the system guide →

engineSetRadarMapTile Registers or replaces a resource-owned TXD in one cell of San Andreas Online's sparse 40 × 40 native radar grid. engineResetRadarMapTile Removes a radar tile owned by the calling resource and restores the native ocean fallback. engineGetRadarMapStats Returns the current extended-radar hook, registration, loading, failure, and source-byte counters.

← Back to the SA:O Lua API · How External browser integration works →