Skip to content

Files, ports and services ​

Important files ​

Path in the frameworkPurpose
pawn.jsonDependency/compiler configuration
gamemodes/gamemode.pwnSource entry point
gamemodes/gamemode.amxCompiled game, generated locally
config.jsonLocal open.mp runtime configuration
mysql.iniLocal game database connection
gamemodes/config/header.pwnBranding and feature switches
gamemodes/config/secrets.pwnLocal compiled secrets, created from example
database/schema.sqlClean-install schema and minimal seeds
web-platform/web/prisma/sql/framework-web.sqlAdditive web migration for MariaDB
models/Supplied UI assets and your optional model files
scriptfiles/colandreas/ColAndreas.cadbExternal/generated stock collision database
scriptfiles/callbackfix.amxYSI callback helper, generated/used by its dependency
scriptfiles/geoip.dbRetained optional country/ISP lookup data, not an active VPN blocker
log.txtEngine/runtime log used by the agent
bans.jsonEngine IP bans, distinct from SQL account bans

vpn_whitelist.ini is unused/removed; VPN exceptions live in SQL. Integrated flight/client checks do not need external filterscripts.

Network ports ​

ServiceTypical port/protocolPublic?
Game7777 UDPYes, for players
Artwork downloadsConfigured port, TCP; may also be numeric 7777When used
Community web app3000 TCP internallyThrough HTTPS reverse proxy
Server agent7001 TCP/HTTPNo
MariaDB3306 TCPNo
Optional API3001 TCPOnly if intentionally extended/exposed
Framework project website80 TCP inside its Nginx containerThrough HTTPS domain
Project website local preview4173 TCPLoopback testing only
SMTP submissionYour server’s port, commonly 587/465 TCPOutbound from web to your mail service

These are configurable defaults, not a firewall script. Use actual configured ports and separate TCP/UDP publishing. A container’s localhost points to itself, not another service.

Working directories ​

Start the game from the framework root. Run web npm commands inside web-platform/web/, agent commands inside web-platform/samp-agent/ and optional API commands inside web-platform/api/.

The project website is a separate repository. Its Dockerfile build context is its own repository root. The community web Dockerfile instead expects web-platform/ as context.

Open-source roleplay foundations for open.mp. Bring your own world.