Appearance
Files, ports and services
Important files
| Path in the framework | Purpose |
|---|---|
pawn.json | Dependency/compiler configuration |
gamemodes/gamemode.pwn | Source entry point |
gamemodes/gamemode.amx | Compiled game, generated locally |
config.json | Local open.mp runtime configuration |
mysql.ini | Local game database connection |
gamemodes/config/header.pwn | Branding and feature switches |
gamemodes/config/secrets.pwn | Local compiled secrets, created from example |
database/schema.sql | Clean-install schema and minimal seeds |
web-platform/web/prisma/sql/framework-web.sql | Additive web migration for MariaDB |
models/ | Supplied UI assets and your optional model files |
scriptfiles/colandreas/ColAndreas.cadb | External/generated stock collision database |
scriptfiles/callbackfix.amx | YSI callback helper, generated/used by its dependency |
scriptfiles/geoip.db | Retained optional country/ISP lookup data, not an active VPN blocker |
log.txt | Engine/runtime log used by the agent |
bans.json | Engine 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
| Service | Typical port/protocol | Public? |
|---|---|---|
| Game | 7777 UDP | Yes, for players |
| Artwork downloads | Configured port, TCP; may also be numeric 7777 | When used |
| Community web app | 3000 TCP internally | Through HTTPS reverse proxy |
| Server agent | 7001 TCP/HTTP | No |
| MariaDB | 3306 TCP | No |
| Optional API | 3001 TCP | Only if intentionally extended/exposed |
| Framework project website | 80 TCP inside its Nginx container | Through HTTPS domain |
| Project website local preview | 4173 TCP | Loopback testing only |
| SMTP submission | Your server’s port, commonly 587/465 TCP | Outbound 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.