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.
- Off-screen CEF rendering inside GTA SA
- Overlay2D browser rendering for HUDs and menus
- 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
- Custom ESC menu support
- Custom TAB menu (scoreboard) support
- Secure client/server handshake and UDP transport
The full documentation is available in the GitHub Wiki:
https://github.com/aurora-mp/omp-cef/wiki
- 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
148.0.10+g7ee53f5+chromium-148.0.7778.218src/
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)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
- Overlay2D HUD
- World2D browser
- WorldObject3D browser
- JavaScript <-> Pawn events
- Browser lifecycle
- Hidden browser navigation
- Stress testing
Pull requests are welcome <3.
See the repository license.
