open.mp

frightened_peach_delly

Multiplayer mod with full compatibility for SA-MP.

2likes0comments

Visit project 2

Project details

About this project

Open Multiplayer offers a fully backwards compatible mod for SA-MP, enhancing the multiplayer experience. It provides a robust SDK, allowing developers to create and extend functionalities while ensuring compatibility across versions. Ideal for game enthusiasts looking to innovate within a familiar framework.

Open Multiplayer is a multiplayer modification that maintains full backwards compatibility with SA-MP, enhancing the online gaming experience for users. This project provides a structured framework that includes core SDK headers, server implementation details, and various components designed for extensibility and modularity.

Structure of the Repository

The repository is organized into several key directories:

Path	Content
`SDK/include`	Contains core SDK headers that are stable across versions.
`SDK/include/Server/Components/*/`	Houses headers for components and plug-in SDKs, also stable across versions.
`Shared/NetCode/`	Includes netcode headers responsible for RPC and packet structures; this content may vary between versions.
`Shared/Network/`	Contains network utility headers, which might not remain stable.
`lib/`	A collection of various submodules and third-party libraries.
`Server/Source/`	The main implementation of the server, subject to change in future versions.
`Server/Components/*/`	Implementation details for components/plug-ins, not stable across versions.

Core Concepts

The project is built around several fundamental concepts:

Name	Description
Entity	Represents a 3D object in the game world.
Pool	A container that consists of entities with a limited number of IDs.
Component	A separable module designed for specific functionalities.
Extensible	Allows for extensions that maintain ABI compatibility.
Extension	Adds extra features to an extensible component without breaking compatibility.

Required Tools

To build and work with Open Multiplayer, the following tools are recommended:

CMake 3.19+
Conan 1.57+ (Note: version 2.x is incompatible. Download older versions directly from GitHub releases or install via pip3 install conan==1.57.0).

Windows Development Tools

Visual Studio 2019+ with the Desktop development with C++ workload and C++ Clang tools for Windows component is required for building on Windows.

Clone the Repository

To clone the Open Multiplayer repository and its submodules, use the following command:

# With HTTPS:
git clone --recursive https://github.com/openmultiplayer/open.mp
# With SSH:
git clone --recursive git@github.com:openmultiplayer/open.mp

Building the Project

Specific build instructions for Windows and Mac are as follows:

On Windows

cd open.mp
mkdir build
cd build
cmake .. -A Win32 -T ClangCL
cmake --build . --config RelWithDebInfo

On Mac

If using Homebrew, install Conan as shown, ensuring the correct version:

brew install conan@1
sudo ln -s /usr/local/opt/conan@1/bin/conan /usr/local/bin/conan
cd open.mp
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make

This robust framework offers an excellent opportunity for developers looking to create engaging and connected gaming experiences, capitalizing on the existing SA-MP community.

Comments

Your draft will be saved

Start the conversation

Share the first comment.