Your next roleplay server
Starts here.

OpenRP Framework gives you the gameplay systems, web control panels and documentation to build your own open.mp roleplay server. Shape the world. Create your community. Make it yours.

  • Pawn
  • open.mp
  • MySQL / MariaDB
  • bcrypt
  • Open source

Everything a serious RP server ends up needing

The boring, hard-to-get-right foundations are done, so you can spend your time on your server's own identity.

Accounts & characters

bcrypt passwords, multiple characters per account, MySQL persistence and a UCP-friendly schema.

Admin suite

Levels, duty, reports, jail, bans, spectate, noclip and full logging, ready on day one.

Vehicles

Ownership, dealerships, fuel, impound, mods, tickets, real vehicle slots and keys.

Properties & businesses

Houses, businesses, firms, real estate, furniture, wardrobes and burglary.

Jobs & economy

A simple crate-based trucker run, plus garbage, pizza, fishing and more, with paychecks and a bank.

Law enforcement & EMS

SAPD and FDSA out of the box: radio, MDC, 911, cuffs, arrests, tickets, injuries and medical.

Phone & communication

Phone, radio channels, adverts, rumours and proximity chat.

Optional systems

Gangs, gang zones, gun dealers and fear & respect behind simple feature flags.

Readable code

Module headers, function comments and an architecture guide help you find your way around the code.

A foundation you can make your own

This was split from a live server's script, so anything specific to that server has been removed.

Included

  • Stock GTA:SA models and skins 0-311
  • Two legal factions: SAPD (police) and FDSA (fire / EMS)
  • Clean database schema with secure first-admin setup
  • Config templates and a secrets template
  • Architecture guide and per-function comments

Deliberately not included

  • Custom models, maps and interiors
  • Custom skins and faction uniform models
1 / 11

Get started

Follow the complete installation checklist →

You need an open.mp server (SA-MP 0.3.7 may work but is untested and will likely need changes), MariaDB 10.5+, and the Pawn compiler 3.10.10. sampctl pulls the dependencies and builds it for you. Install sampctl for your platform before building.

  1. Create the database

    mysql -u root -p < database/schema.sql
  2. Set your credentials

    Edit mysql.ini and config.json (open.mp; server.cfg is only for SA-MP), then copy gamemodes/config/secrets.example.pwn to secrets.pwn.

  3. Brand it

    Set SERVER_NAME, SERVER_WEBSITE and SERVER_DISCORD in gamemodes/config/header.pwn.

  4. Build

    sampctl ensure
    sampctl build

    On Linux, install sampctl yourself and run sampctl build.

  5. Run and log in

    Create your first administrator with npm run admin:create in the web application. The setup prints a unique password; no shared administrator account is shipped.

Make it yours

Everything map-specific is set to 0, 0, 0 with a TODO: set coordinates for your map comment. Search the code for it.

I want to…Look at
Add a mapgamemodes/visuals/maps/template.pwn
Remove default buildingsgamemodes/visuals/remove.pwn
Add custom modelsgamemodes/visuals/models.pwn
Add attachment itemsgamemodes/attachments/store/
Add a factionfactions table, FACTION_TYPE_*, police/systems/radio.pwn
Turn on Discord logginggamemodes/config/secrets.example.pwn
Understand the layoutgamemodes/ARCHITECTURE.md

Status: early

Usable, but not polished. Known gaps:

  • Map coordinates are zeroed and need setting for your map (DMV, jails, spawns, depot and more).
  • The clean database and Windows build have been checked. Live gameplay and Linux/EasyPanel deployment still need testing on your own server.

Found a bug or want to help? Open an issue or a pull request.