Skip to main content
To install a plugin on your open.mp server, upload its Linux .so file to a plugins folder in Files, then open Game settings and add the name without the extension (for example streamer) to Plugins, one per line. Click Review and save, then Save changes, and restart. open.mp components, such as Pawn.CMD and sscanf, go in the components folder instead and load automatically.

​
Before you start

  • Make a backup.
  • Download the Linux build of each plugin (.so). Your server runs on Linux, so Windows .dll files don’t load.
  • Check the plugin’s page for an open.mp version or open.mp notes.

​
Plugin or component: what is the difference?

The open.mp installation guide says these must go in components, not plugins: Pawn.CMD, Pawn.RakNet, sampvoice, discord-connector and sscanf (an open.mp-compatible build; the guide names sscanf 2.13.8). It also says YSF isn’t needed on open.mp, and FCNPC is replaced by the official open.mp NPC component.

​
How to install a legacy plugin

1

Create the plugins folder

Open Files. If there is no plugins folder yet, create one in the main folder of your server, next to config.json.
2

Upload the .so file

Upload the plugin’s Linux .so file into plugins/ with the File Manager or SFTP. If the download is a zip, extract it on your PC first and upload only the .so file and any files the plugin’s readme names.
3

Add it in Game settings

Open Game settings > Game mode and plugins and type the plugin name without .so in Plugins, one per line. For plugins/streamer.so, enter streamer.
4

Save and restart

Click Review and save, then Save changes, and click Restart now.
5

Check the console

Watch the console or log.txt while the server starts. A plugin that fails to load is reported there.

​
How to install a component

1

Upload to components

Upload the component’s Linux .so file into the components folder.
2

Restart

Restart the server. You don’t need to list components in Game settings.
3

Check it loaded

The console prints Loading component for each file and then Loaded n component(s). A fresh server loads 22; the number goes up by one for each component you add.

​
Does my plugin need a database?

Plugins such as MySQL need a database. Create one on Databases in the Game Panel and copy its host, user name and password into your script or plugin config. See manage databases.

​
Frequently asked questions

​
Why does my plugin not load?

The most common causes are a Windows .dll instead of a Linux .so, a name in Plugins that doesn’t match the file name, a component placed in plugins/, or a plugin that isn’t compatible with open.mp. See server not starting.

​
Do I need to remove the default components?

No. Leave the files that came with the server in components alone. The server needs them to run.

​
Do I need the plugin’s include file on the server?

No. Include (.inc) files are only needed on your PC when you compile your gamemode with qawno.

open.mp server guide

Every open.mp page in one place.

Install a gamemode

Gamemodes and filterscripts.

Migrate from SA-MP

Move your SA-MP server over.

Server not starting

Fix plugin and gamemode errors.

Databases

Create a MySQL database.
Tested by the FREAKHOSTING team on our Game Panel on 3 November 2026 (open.mp server 1.6.7.3218). Steps may differ slightly if the game changes.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!
Last Updated: November 2026