Skip to content

Troubleshooting ​

Start with the failing component’s own log and the earliest useful error. Avoid launching duplicate processes or importing the clean schema as a general repair command.

Game will not start ​

SymptomCheck
Cannot load gamemodeCorrect non-empty gamemodes/gamemode.amx, script name and working directory
Missing native/plugin errorPlatform/build compatibility, component versus plugin placement, library dependencies
MySQL failuremysql.ini, credentials, database name, host/network and database logs
ColAndreas fatal errorExact collision-file path/case, valid generated file and compatible plugin
Address already in useExisting game process and chosen UDP/artwork TCP ports
Starts then stopsRead log.txt through the full startup sequence, not just the agent’s start response

On Linux, use ldd on the runtime/plugins to find missing dependencies. The engine is a 32-bit application; the host may need the corresponding runtime libraries.

Web build or startup fails ​

  • Run commands in web-platform/web/, not the framework root.
  • Use the supported Node version and npm ci with the checked-in lockfile.
  • Generate Prisma after installation/schema changes.
  • Confirm the web Docker context is web-platform/, Dockerfile web/Dockerfile.
  • For the separate framework project website repository, use its root Dockerfile and target HTTP port 80.
  • Run the supplied standalone npm start after npm run build; do not replace it with next start.
  • On Windows, stop the running standalone app before rebuilding if output directories report EBUSY.

Login, cookies and email ​

SymptomCheck
Login loops on public hostHTTPS origin, AUTH_URL, proxy host/protocol and secure cookies
Account rejected despite correct passwordActive ban, reset-required state, rate limit or pending 2FA code
Reset-required accountComplete the password-recovery flow using the registered email
Code expired/invalidLatest message, five-minute expiry, attempts, single-use and resend cooldown
No emailsSMTP connectivity/authentication, allowed sender, TLS settings, provider restrictions and web logs
Email link points to localhostCorrect AUTH_URL and restart web
Missing table/columnReview/apply additive SQL migration; do not reset the live database

See the mail guide for DNS, certificates and delivery diagnosis. A successful SMTP connection is not proof of inbox delivery.

ACP cannot control the game ​

Check the agent process and private URL/key first. A 401/403 can be an authentication/role issue; a 502 can mean the agent is unreachable. Verify the operation’s actual rank requirement.

If the game is running independently, agent status can still say stopped. Stop the independent process and start through the agent. In containers, verify shared process ownership rather than only a shared mount.

Missing uniforms or equipment ​

Check faction membership, locker enabled state, range, interior/world and squad. Check equipment type/row, tier and duty conditions. Use /reloadarmories after equipment edits and /reloadfskins after uniform-row edits. Custom asset registration changes require a full game restart.

For stock uniform creation, use the faction owner’s /fskinadd flow. ACP can edit usable-row metadata even when custom uploads are disabled. Do not expect the disabled custom-upload section to create stock rows.

Jobs do not offer a route ​

Place the depot and create eligible business records first. Trucker destinations require supported buy types, normal exterior interior/world and the minimum distance. Use a supported registered cargo vehicle, not an arbitrary temporary engine vehicle.

Data changes disappear ​

The game keeps in-memory entity/character arrays. Editing SQL or web data while the relevant state is loaded can be overwritten by a later save. Use supported commands, documented reloads and offline-edit requirements. Keep a backup before diagnosing persistent-data issues.

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