open.mp multiplayer game framework
An upcoming multiplayer mod for Grand Theft Auto: San Andreas that will be fully backwards compatible with the existing multiplayer mod San Andreas Multiplayer.
This monorepo contains the web services and documentation for open.mp and SA-MP.
docs/Wiki documentation for SA-MP and open.mp in Markdown format including translations.emails/MJML email templates for account registration and other things.frontend/Next.js app for the https://open.mp site.prisma/Prisma database models for generating Go code and SQL migrations.server/Backend API for server listings, accounts, etc.
To work on the frontend, you mostly only need to focus on the frontend/ directory. Run npm commands in there such as npm run dev. See the readme file in there for more details.
The only files that the frontend need that are not in that directory are docs/ which it uses to for the https://open.mp/docs pages. .env is not used for frontend development.
When working on the backend, the root of the repository is where you need to be. The server application will assume it's being run from the root, not from within server/.
To start the API server, use Taskfile and run task, the default task is to build and run the API server.
The frontend, by default, only uses the live API. To change this you must edit any URLs from https://api.open.mp/... to http://localhost/....
You can run the following command to get a minimal development environment ready:
docker-compose -f .\docker-compose.dev.yml up -d
The .dev.yml Compose configuration contains services that aren't secure or production ready and suitable for local testing.
The frontend is deployed directly to Vercel from the master branch.
The backend is deployed to a server from the master branch using the docker-compose.yml file. You can simulate a production deployment by running docker-compose up.