aurora-mp/omp-cef

omp-cef

Client/server CEF plugin for open.mp and SA-MP.

omp-cef embeds Chromium Embedded Framework into GTA San Andreas Multiplayer clients and allows servers to create browser-based UI in several rendering modes: Overlay2D, World2D and WorldObject3D.

Features

• Off-screen CEF rendering inside GTA SA
• Overlay2D browser rendering for HUDs and menus
• Browser layers to control which 2D interfaces appear on top
• World2D browser rendering at world positions
• WorldObject3D browser rendering through object texture replacement
• Packaged server resources served through http://cef/...
• Pawn natives and callbacks
• JavaScript <-> Pawn/C# event bridge
• Focus, cursor, input and audio controls
• Game screen capture exposed to CEF interfaces as RGBA frames
• Custom ESC menu support
• Custom TAB menu (scoreboard) support
• Secure client/server handshake and UDP transport

Documentation

The full documentation is available in the GitHub Wiki:

https://github.com/aurora-mp/omp-cef/wiki

Supported clients

• SA-MP 0.3.7-R1
• SA-MP 0.3.7-R3-1
• SA-MP 0.3.7-R5-1
• SA-MP 0.3.DL-R1

Current CEF version

148.0.10+g7ee53f5+chromium-148.0.7778.218

Repository layout

src/
  client/          # client plugin (CEF offscreen + DX9 + SA:MP hooks)
  server/
    common/        # network core, sessions, resources, protocol
    omp/           # open.mp component (bridge + lifecycle + natives)
    samp/          # SA-MP plugin (bridge + lifecycle + natives)
   shared          # shared protocol/types (packets, serialization, common utilities)
deps/              # deps (minhook, sdk, etc.)
vcpkg.json         # vcpkg manifest (if using manifest mode)
CMakeLists.txt
CMakePresets.json  # CMake presets (configure/build presets for VS/CMake)

Building

Build requirements and detailed setup instructions are documented in the wiki:

https://github.com/aurora-mp/omp-cef/wiki

Short version:

• Visual Studio 2022
• CMake
• vcpkg
• Windows SDK
• x86 target for GTA SA / SA-MP client-side

Samples

• Overlay2D HUD
• World2D browser
• WorldObject3D browser
• JavaScript <-> Pawn events
• Browser lifecycle
• Hidden browser navigation
• Stress testing

Contributing

Pull requests are welcome <3.

License

See the repository license.