rap-sor / samp-cef

Client and server plugins for SA:MP to embed CEF.

SAMP CEF

This project embeds CEF into SA:MP expanding abilities to express yourself with beauty in-game interfaces using HTML / CSS / JavaScript.

It is a FRAMEWORK (or SDK), not something that you download and use. To be able to create you should have some webdev basics (JS / HTML / CSS).

What you can do

• Create browser views from a gamemode or from client-side plugins (C ABI).
• Place browsers on objects (with kind-of spatial sound)
• Send and receive custom defined events from / to clients.

Crates

• cef - Rust wrappers around CEF C API.
• cef-api - Rust wrappers to build client plugins using CEF.
• cef-interface - example of a Rust plugin.
• cef-sys - bindings for CEF C API.
• client - client CEF plugin.
• d3dx9 - bindings to DirectX SDK.
• loader - small loader that makes it work (should be named cef.asi).
• messages - protobuf messages to communicate with server on net.
• network - quinn glue (laminar like).
• proto - raw proto files.
• renderer - glue between CEF renderer process and main logic.
• server - server side plugin.

Download

Latest builds from the master branch are placed in the Actions.

Currently there is those OS:

• CentOS 7 (cef-centos-7.so)
• Debian 9, 10, 11 (cef-debian-*.so)
• Ubuntu 18.04, 20.04 (cef-ubuntu-*.so)
• Windows (cef-windows.dll)

And also all client-side parts (cef.asi, client.dll, renderer.exe).

Building

Dependencies

• Rust compiler (nightly) with i686-windows-pc-msvc toolchain
• Prebuilt CEF with proprietary codes (if you wanna use streams). I had one for you in releases. (Client only)
• Environment variable CEF_PATH that points to libcef.lib (client only).
  • In powershell it's like $env:CEF_PATH="C:/some/path"
  • Then build

Notes ...

If you get a linker error, you should change hard-coded links in the source code

• client/build.rs - path to DirectX SDK (default one)

Running Rust

and now

cargo +nightly build --target i686-windows-pc-msvc --release

rustup toolchain install nightly-i686
cargo +nightly-i686 build --release

also the client plugin can be built using OpenAL for sound (rodio by default). to do that compile the client without default features. for example:

cargo +nightly-i686 build --release --package client --no-default-features

to make it work you should place openal.dll as sound.dll in the cef folder. I do not remember what version is used exactly ... but I have it on the release page.

to build specific part you can add --package <NAME>

for example if you will try to build ALL crates on linux, you will get an error. so, pass --package server to build only server on linux.

CEF version

Current versions of CEF and Chromium: 89.0.5+gc1f90d8+chromium-89.0.4389.40 release branch 4389

Date:             February 26, 2021

CEF Version:      89.0.5+gc1f90d8+chromium-89.0.4389.40
CEF URL:          https://bitbucket.org/chromiumembedded/cef.git
                  @c1f90d8c933dce163b74971707dbd79f00f18219

Chromium Version: 89.0.4389.40
Chromium URL:     https://chromium.googlesource.com/chromium/src.git
                  @2c3400a2b467aa3cf67b4942740db29e60feecb8

Docs

• docs/main_ru.md
• docs/main_en.md (it's better to google translate russian one ...)
• Also, check out wiki on github.

Video examples

• https://www.youtube.com/watch?v=Jh9IBlOKoVM (гоблин на весь дом)
• https://www.youtube.com/watch?v=jU-O8_t1AfI (простые интерфейсы)
• https://www.youtube.com/watch?v=qs7n8LoVYs4 (кастомный интерфейс гта)
• https://www.youtube.com/watch?v=vcyTjn3RJhs (голосовой чят)
• https://www.youtube.com/watch?v=6OnCSHKcOGU (кухня по телеку)

BIG TODO: EXAMPLES

But it's similar to fivem or ragemp implementations.