06.05.2011, 16:44
(
Last edited by RyDeR`; 07/05/2011 at 10:14 AM.
)
Introduction
A lot of people want to know how to create a plugin using Microsoft Visual C++ 2008/2010. Some people think it's hard but it's actually quite simple if you know how to start.
I will explain step by step below how you create your first native.
Things you need to know before starting
A lot of people want to know how to create a plugin using Microsoft Visual C++ 2008/2010. Some people think it's hard but it's actually quite simple if you know how to start.
I will explain step by step below how you create your first native.
Things you need to know before starting
- You have to install Microsoft Visual C++.
- You need some PAWN scripting experience to understand things.
- SA-MP Software Development Kit (SDK).
- Run Microsoft Visual C++ (2008/2010 version).
- Go to "File" tab then click "New" and select "Project".
- You will see the following dialog
- Select "Win32 Project", enter a project name and press "OK" to continue.
- The following dialog will appear
- Just press "Next" to continue.
- In the next dialog you have to select "DLL" under Application type and "Empty project" under additional options and press the "Finish" button.
- Now the only thing you're going to see is the solution explorer somewhere on the left side. (If you don't see the solution explorer press the "View" tab then select "Other windows" and click on "Solution explorer")
- As you can see, I called my project "Test". Do right click on "Test" in the solution explorer and go select "Properties".
- You will see the following dialog
- On the left, click "Linker" then select "Input" and write next to "Module Definition File" the name of your project or something else adding the ".def" extension behind and press "OK".
- Now refer yourself back to the solution explorer and do right click on your project name again and select "Add", and then click "New Item".
- In the dialog that pops up, select "C++ File (.cpp)" and below next to "Name" you write the thing you wrote next to "Module Definition File" (in step 11). And press "Add".
- Press right click on your project name, select "Add" and click "New Item" again.
- This time you do the same, select "C++ File (.cpp)" but now, you write next to "Name" the name you chose previously but this time using the ".cpp" extension. Then press "Add".
- Now you will see 2 tabs opened: "YourProjectName.def" and "YourProjectName.cpp".
- Open "YourProjectName.def" and paste the following thing into that:
Code:EXPORTS Supports Load Unload AmxLoad AmxUnload
- Now open "YourProjectName.cpp" and paste the following thing into that:
pawn Code:#include "../SDK/plugin.h"
typedef void
(*logprintf_t)(char* format, ...)
;
logprintf_t
logprintf
;
void
**ppPluginData
;
extern void
*pAMXFunctions
;
PLUGIN_EXPORT bool PLUGIN_CALL Load(void **ppData)
{
pAMXFunctions = ppData[PLUGIN_DATA_AMX_EXPORTS];
logprintf = (logprintf_t)ppData[PLUGIN_DATA_LOGPRINTF];
return 1;
}
PLUGIN_EXPORT void PLUGIN_CALL Unload()
{
}
AMX_NATIVE_INFO projectNatives[] =
{
{ 0, 0 }
};
PLUGIN_EXPORT unsigned int PLUGIN_CALL Supports()
{
return SUPPORTS_VERSION | SUPPORTS_AMX_NATIVES;
}
PLUGIN_EXPORT int PLUGIN_CALL AmxLoad(AMX *amx)
{
return amx_Register(amx, projectNatives, -1);
}
PLUGIN_EXPORT int PLUGIN_CALL AmxUnload(AMX *amx)
{
return AMX_ERR_NONE;
} - Now refer yourself back to Solution explorer and right click your project name again, select "Add", and click on "New Filter". Now you will see that a new file has been created. Change the name to "SDK".
- Extract the "SDK" file you have downloaded in "Documents/Visual Studio 2010/Projects/YourProjectName/".
- Go back to the solution explorer and right click on the "SDK" filter you have created and select "Add", then click on "Existing Item".
- A dialog will appear, now browse to the "SDK" directory you have copied and select "amxplugin.cpp".
- Now that's pretty it! Now press F7 and compile it.
- You can find your .dll file in the Debug directory.
- Add this somewhere in your .cpp script:
pawn Code:static cell AMX_NATIVE_CALL YourNativeNameHere(AMX *amx, cell *params)
{
logprintf("I haz made my first plugin!! :)");
// Your codes go in here
return 1; // Change the return value if need
} - Go to:
And add "{ "YourNativeNameHere", YourNativeNameHere }", like this:pawn Code:AMX_NATIVE_INFO projectNatives[] =
{
{ 0, 0 }
};
pawn Code:AMX_NATIVE_INFO projectNatives[] =
{
{ "YourNativeNameHere", YourNativeNameHere } // In the first array dimension, you write the name of the native you're going to call in PAWN. In the second one, you write the name in .cpp file. In this case, they're the same!
}; - Compile, and go to the Debug file.
- Select your .dll file and copy it to your server files.
- Create a new .pwn script and add "native YourNativeNameHere();" at the top. And just call it under "OnFilterScriptInit".
pawn Code:#include <a_samp>
native YourNativeNameHere();
public OnFilterScriptInit()
{
YourNativeNameHere();
return 1;
} - When you run your server, it should print this: "I haz made my first plugin!!
". - This is just the basic. Now you can create other unique things!
NOTE: If you want natives with parameters, you can use "params[]" starting from index 1.
- Try to figure out how to do other things. I'm just teaching you the basic on how to get started.
- You can ask questions below, but I'm not going to answer then all.
Good work ryder.
