In this guide, I’ll show you how to compile your gamemode using Visual Studio Code. We’ll start by installing the necessary compiler and setting up everything step-by-step.
To begin, we need to install the Pawn Development Tool extension for VSCode. You can either install it through VSCode directly or via this marketplace link: https://marketplace.visualstudio.com/items?itemName=openmp.pawn-development
If you want to contribute or dive deeper into the project, here’s the source code link: https://github.com/openmultiplayer/vscode-pawn
1. Open Visual Studio Code
2. Go to the Extensions Section
Click on the extensions icon located on the left-hand toolbar.
3. Search for "Pawn Development Tool
Type Pawn Development Tool in the search bar.
4. Select the First Option
The first option that appears will be the correct extension.
5. Install the Extension
Click on the install button.
Now that we’ve installed the extension, let’s move on to setting up the compiler.
1. Navigate to Your Gamemode Directory
Open your gamemode folder in VSCode.
2. Initialize the Pawn Task/Compiler
To set up the compiler, press
QuoteCtrl + Shift + P
or
QuoteF1
or go to View > Command Palette. Then, search for Pawn Development: Initialize Pawn Build Task.
3. Select the Build Task Option
Click on the result.
After initializing the task, you might encounter an error when trying to compile, like this:
This happens because the compiler doesn’t know the location of `pawncc.exe`. So, we need to set it manually by editing the `tasks.json` file.
1. Open `tasks.json`
Find the `tasks.json` file in your `.vscode` folder.
2. Specify the Compiler Path
In the `command` field of `tasks.json`, you need to set the path to your compiler. If you’re using SA-MP Server, you might be using **pawno**, and for open.mp servers, you’ll likely be using qawno. Here’s how to configure each:
Pawno users: Set the path to `${workspaceRoot}/pawno/pawncc`
Qawno users: Set the path to `${workspaceRoot}/qawno/pawncc`
Example setup:
Now, you can compile your gamemode. If everything is set correctly, the compiler should successfully compile your script.
Update:
(Thanks to edgy and Southclaws they helped me figure this out and learn how to set it up!)
You might notice that errors and warnings aren’t being highlighted yet. This is because we haven't set them up properly. Let's fix that by going back to the `tasks.json` file.
Adjust the `problemMatcher` Configuration
First, locate the `"problemMatcher"` section in the `tasks.json` file. We need to modify the `"fileLocation"` property.
Change `"relative"` to `"autoDetect"` so it can automatically detect your gamemode file location.
Next, update `"${workspaceRoot}"` to `"${workspaceRoot}/gamemodes"` to ensure it's pointing to your gamemode directory.
After making these changes, errors and warnings should now be properly highlighted in your gamemode.
This guide was based on my own experience compiling gamemodes in VSCode. If you notice any mistakes or have suggestions for improvement, feel free to let me know!
Thanks for reading, and good luck with your gamemode development!