SA-MP Forums Archive - Tutorials

[Tutorial] Wreck Car After Respawn [Easily]

Tue, 07 Jul 2020 15:41:00 +0000

I am New developer, And I have Low skill for sa-mp.
[I am weak english]

I am open a server for real life. But sometimes players often seize the opportunity to Spawn car, such as Drive the car fall water without Mechanic's repair. I try to fix this problems but I am new developer [weak developer]

First : I try to make Save health's Car into Mysql but I can't make it.
Second : I am think to easy make and I tried not related to the database.

Yep! I choose the second method. and I think it basic for all gamemode.

Begin : make it

Code:

new Float:VehicleDamage[MAX_VEHICLES];

Next : Find to : public OnVehicleDeath(vehicleid)
Describe : When The Vehicle was damage by something such as Fall the water, Weapon or Crash
It's Check = 1.
Type :

Code:

VehicleDamage[vehicleid] = 1;

Next : Find public OnVehicleSpawn(vehicleid)
Describe : If the vehicledamage = 1 , It will determine what the vehicle will look like.
TYPE:

Code:

if(VehicleDamage[vehicleid] == 1)
    {
	UpdateVehicleDamageStatus(vehicleid, panels, doors, lights, 15);//If want to Show look the car's damage
        SetVehicleHealth(vehicleid, 300);//Set Health After Respawn
        VehicleDamage[vehicleid] = 0; // Back Check this car to 0
    }

This is working, But If you're Restart Server Or Vehicle's Respawn. The Car is comeback to Full hp.
-----------------------------------------------------------------------------------------------------------------

I developed knowledge from...

Credit : SharpenBlade
https://sampforum.blast.hk/showthread.php?tid=676775

[Tutorial] Creating Menus/Dialog Box's

Fri, 26 Jun 2020 07:52:00 +0000

Creating A Menu with a Dialog

Syntax for Dialogs

PHP Code:

ShowPlayerDialog(playerid, **DIALOGID**, **DIALOGSTYLE**, "**DIALOGTITLE**", "**DIALOGBODYCONTENT**", "**LEFTBUTTONTEXT**", "**RIGHTBUTTONTEXT**");

DialogID - This is used to reference a Dialog in different area's of your Gamemode/Filterscript.
DialogStyle - This is a multi choice depending what kind of Dialog Style you need or want, you will learn about these in this tutorial.
DialogTitle - This goes on the Dialog at the top, as the Title shown.
DialogBodyContent - This is what is in the middle of your Dialog, weather that is Text,Numbers,Items etc, you will also learn how to create Listitems in this tutorial.
Left & Right Button - This is to make your Dialogs Responsive and do different things, adding extra dialogs to open after you click it, or do certain tasks.

Setting Up Framework for Dialogs
We will use an Enumerator for this, so we don't have to constantly define numbers and have a possibility of forgetting DialogID's along the way.
If you don't know how to use an Enumerator, there is a great Article about this already.
https://sampforum.blast.hk/showthread.php?tid=318307

PHP Code:

enum {     DIALOG_UNUSED };

First off the bat, you'll want to make sure this Enumerator is placed at the top of your script, below your Includes,Defines, beside any custom Global Variables you've created already.

What is DIALOG_UNUSED? This is basically DIALOG ID 0, we are using this as a placeholder and I will explain why.

Say you have your Help Command, which just shows all the available CMD's on your server, but it doesn't do anything else when you click the Menu Buttons on the Dialog? That mean's we wont need to use OnDialogResponse Callback's features for that Dialog, and if there is any more Dialogs you have, that have no functions with the buttons, you also wont need OnDialogResponse's Features, therefore you're able to use the same Dialog ID, so we can just use DIALOG_UNUSED like this

Code:

ShowPlayerDialog(playerid, DIALOG_UNUSED, DIALOG_STYLE_MSGBOX, "Messagebox Title 1", "This is Information inside the first Messagebox", "Ok", ""); ShowPlayerDialog(playerid, DIALOG_UNUSED, DIALOG_STYLE_MSGBOX, "Messagebox Title 2", "This is Information inside the second Messagebox", "Okay", "");

DIALOG_STYLE_MSGBOX

This is a MessageBox, You can fit a lot of text into these, It's useful for Help Commands such as /ahelp or /help
or even /stats or whatever feature you want, like maybe even Text Messages in a Roleplay Gamemode?
Literally your Imagination will be the limit of this Dialog's Usage.

So lets create one!
First we should have another look at that Enumerator

PHP Code:

enum {     DIALOG_UNUSED };

We can add more DialogID's we are actually going to use with response functions, so for now lets just show a Helpful MessageBox with information.

PHP Code:

enum {     DIALOG_UNUSED,     DIALOG_HELP,     DIALOG_HELP2 };

So now we have the DialogID DIALOG_HELP and DIALOG_HELP2 defined and now ready to be used, so lets use them in a Command.

NOTE: I am not creating a tutorial on CMDS and Processors, this is ZCMD Format, if you can't understand it then I suggest you go study it a little.

PHP Code:

CMD:help(playerid, params[]) {     ShowPlayerDialog(playerid, DIALOG_HELP, DIALOG_STYLE_MSGBOX, "Help Page 1", "This is Page 1 of the Help Messagebox", "Page 2", "Exit");     return 1; }

Now that we have that Command created, if you were to test it, you'd notice typing /help will show a Messagebox, with what we wrote in it, furthermore youll notice the Page 2 Button does not actually do anything, so lets change that and make it do something.

First I would like to mention, using Switches is the best method here, youll have less confusion with your code and switch brings some great benefits and in some cases less code to actually write.

And theres been mention if youre running filterscripts with dialogs in them, that when youre coding your dialog response you should be returning 0, ill quote something here for you guys.

Quote:

Originally Posted by l0gic

OnDialogResponse
"Returning 0 in this callback will pass the dialog to another script in case no matching code were found in your gamemode's callback.
It is always called first in filterscripts so returning 1 there blocks other filterscripts from seeing it."

In my opinion all dialogs should be together and in one place however thats not always the case, so return however you need, thanks l0gic for this information, but lets pretend all our dialogs are just in the gamemode for this Tutorial.

So lets do our response for our help command we created.

PHP Code:

public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) {     switch(dialogid)     {         case DIALOG_UNUSED: return 1; //This is the Empty Dialog that isn't used as I previously mentioned.         case DIALOG_HELP://This is our Help Dialog called from CMD:help         {             if(!response) return 1;//This is the Exit Button we made, the right side Button             else if(response)//This is the Page 2 Button we made, the left side Button             {                 //We want to show the Page 2 Dialog now that they have pressed the Help Page 2 Button                 ShowPlayerDialog(playerid, DIALOG_HELP2, DIALOG_STYLE_MSGBOX, "Help Page 2", "This is Page 2 of the Help Messagebox", "Page 1", "Exit");                 return 1;             }         }         case DIALOG_HELP2://This is our Page 2 Dialog Response, called from DIALOG_HELP Button         {             if(!response) return 1;//This is the Exit Button we made, the right side Button             else if(response)//This is the Page 1 Button we made, the left side Button, to take us back to the Page 1 Dialog             {                 //We want to show the Page 1 Dialog now that they have pressed the Help Page 1 Button                 ShowPlayerDialog(playerid, DIALOG_HELP, DIALOG_STYLE_MSGBOX, "Help Page 1", "This is Page 1 of the Help Messagebox", "Page 2", "Exit");                 return 1;             }         }     }     return 1; }

Now if you go ingame and test that, you'll see that /help still works the same, but the button "Page 2" Actually displays the Page 2 Dialog now.
and if we click the "Page 1" Button, you'll be directed back to the 1st Page of Help.
Things to note: You can add new lines in a Messagebox by writing "\n" within the Text for the Messagebox Content, See Below as an Example.

PHP Code:

ShowPlayerDialog(playerid, DIALOG_UNUSED, DIALOG_STYLE_MSGBOX, "Line Testing", "This is Line 1\nThis is Line 2\nThis is Line 3", "Ok", "");

DIALOG_STYLE_INPUT

This is an Input Box, This can be used for many different things, Setting a Skin ID, by typing it into the Dialog Input, anything to do with Numbers really, or even Strings!, changing a players name can be done here aswell!

SOoOoO let's create a Name Change Input Box!

First off, we will add a new DialogID into our Enum, name it DIALOG_CHANGENAME

PHP Code:

enum {     DIALOG_CHANGENAME };

Now we have a Dialog ID for Change Name Dialog, we can make the Command to show the Dialog itself.

PHP Code:

CMD:changename(playerid, params[]) {     ShowPlayerDialog(playerid, DIALOG_CHANGENAME, DIALOG_STYLE_INPUT, "Change Name","Enter your new desired Name you wish to use:","Change","Exit");     return 1; }

There we go, if you go ingame, you'll see when you type /changename, a dialog will show up, with an input field, to change your name, however it won't do anything, because again, we have not setup the response in OnDialogResponse.

So let's do that now!

PHP Code:

public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) {     switch(dialogid)     {         case DIALOG_UNUSED: return 1; //This is the Empty Dialog that isn't used as I previously mentioned.         case DIALOG_CHANGENAME://This is our Changename Dialog called from CMD:changename         {             if(!response) return 1;//This is the Exit Button we made, the right side Button             else if(response)//This is the Change Button we made, the left side Button             {                 if(!strlen(inputtext) || strlen(inputtext) > 24) return SendClientMessage(playerid, -1, "Name Changing requires the name to be of a length between 1-24");//This checks if they typed nothing or too much.                 //We want to Change the Players Username based on what they typed in the Box earlier since we now know its between 1-24, so we use "inputtext" for that again.                 SetPlayerName(playerid, inputtext);//This will change the players name based on what they wrote in the Input Dialog.                 SendClientMessage(playerid, -1, "You have successfully changed your name, enjoy!");                 return 1;             }         }     }     return 1; }

Now when you go ingame, typing /changename and enter a name in the Input Box, you'll notice your name will be changed!, quite a small basic feature but you can imagine how complicated it would get, if you want to check if another player has that name, but this is for the sake of a Tutorial and learning to use the Dialog's themselves, not feature packed Functions within them.

DIALOG_STYLE_LIST

This is a ListBox, personally my favorite of them all, because of how Dynamic this can be, and its functions, so much use within this 1 Dialog type that it's hard for me to pick a Feature to use for the Tutorial, Teleport List? Yeah lets do it.

So again, we need that Enum to have our new Dialog ID, name it DIALOG_TELEPORTS.

PHP Code:

enum {     DIALOG_UNUSED,     DIALOG_TELEPORTS };

Now we have a Dialog ID for Teleport List, we can make the Command to show the Dialog itself.

PHP Code:

CMD:teleport(playerid, params[]) {     ShowPlayerDialog(playerid, DIALOG_TELEPORTS, DIALOG_STYLE_LIST, "Teleport","Los Santos\nSan Fierro\nLas Venturas","Teleport","Exit");     return 1; }

See how we are using that "\n" in the string there, thats because again we are making a new line, like how I exampled earlier, but this time, it does a little more than adding a new "line", let me explain this here.
"Los Santos" will be now on its own line, and when we click only that line, its response would be different than "San Fierro" or "Las Venturas"
they basically get split up into a ***LIST*** Simple right? sure is!

So if we go ingame, yet again we can use the Command associated with our new Dialog Type, /teleport, we can click all 3 but nothing will happen because again OnDialogResponse needs to be coded for it, so lets get going with our response code.

PHP Code:

public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]) {     switch(dialogid)     {         case DIALOG_UNUSED: return 1; //This is the Empty Dialog that isn't used as I previously mentioned.         case DIALOG_TELEPORTS://This is our Teleports Dialog called from CMD:teleport         {             if(!response) return 1;//This is the Exit Button we made, the right side Button             else if(response)//This is the Teleport Button we made, the left side Button             {                 switch(listitem)//This is switching ListItems, self explanatory BUT this is smart, them "\n" we added play the role on determining how many List Items we have.                 {                     //We always start with "0" which is essentially the First List Item from the top.                     case 0://Los Santos Teleport                     {                         SetPlayerPos(playerid, 1532.0996,-1675.6741,13.3828);                         SendClientMessage(playerid, -1, "You've teleported to Los Santos");                         return 1;                     }                     case 1://San Fierro Teleport                     {                         SetPlayerPos(playerid, -2649.0630,21.0362,6.1328,357.6369); // San Fierro                         SendClientMessage(playerid, -1, "You've teleported to San Fierro");                         return 1;                     }                     case 2://Las Venturas Teleport                     {                         SetPlayerPos(playerid, 1687.0597,1446.8789,10.7688,275.8561); // Las Venturas                         SendClientMessage(playerid, -1, "You've teleported to Las Venturas");                         return 1;                     }                 }             }         }     }     return 1; }

That should be perfect, going ingame, typing /teleport should bring us to our Teleport Menu with our 3 Options, selecting one and pressing "Teleport" Button should teleport us to the desired Location now, you can easily add onto this list and create more teleports and modify the existing ones.

DIALOG_STYLE_PASSWORD

This is a Password Input, exactly the same type of Input Dialog as the standard Input one we used to change our name, but this one simply covers the password with the
hidden character, during input... using this is exactly the same as DIALOG_STYLE_INPUT.
Create one and see for yourself, you'd use this specifically for a password screen.

PHP Code:

ShowPlayerDialog(playerid, PUTDIALOGIDHERE, DIALOG_STYLE_PASSWORD, "Password","Things you type here will be shown as a password:","Ok","");

And that concludes the Tutorial, I seen a few different Tutorials for Dialogs, I even created one myself a few years ago, however that was in 2012 and I wasn't as smart as I am now, so reiterating on it, with switches and decent examples of usage, hopefully this helps someone, it's good to know how to use these, even with all the Textdraws nowadays I still personally prefer Dialogs, feel free to comment any ideas for another Tutorial if you guys need help with something else.

[Tutorial] An In-Depth philosophy to creating a SA-MP Server.

Tue, 12 May 2020 20:15:00 +0000

Introduction
Hello, for those of you who do not know me, I've been here for quite a while. I have created several gamemodes and scripts, some of them I published here, and some of them had laid waste in my computer. So far from past years of experience. I have came to the conclusion that I want to share my knowledge with you so you will be able to create a server for your own.

This tutorial is aimed towards an introduction to simple programming scope and learning how to use simple things like methods, events and variables to attain what you want.
Even though you many deny, most of the time you use only 20% of the programming language to deliver 80%. We use simple things like, ifs, for, while, methods, variable, macros and functions to create that awesome dynamic house system that we so want for our server. While is true that more advanced things like plugins to be able to store data in a database on the internet (MySQL), or be able to use great functions to check if player is colliding with a building (MapAndreeas) or even use simple but powerfull cryptic plugins like Whirlpool. In the end, we still use the same toys but with new power.

Content

Methods
Events
Variables
Redefinitions

Methods
When coming across the internet, you may see a lot of name interpretations, some will those functions, some will call them methods. Methods are just a quick way to deliver a sample of code throughout the code without having to repeat it. We don't want to have to write a 500 line code each time we want to add a new system.
Methods can be used for simple things like, creating a car at the player's position

Code:

CreateCarAtPlayerPosition(playerid, modelid, Float: rotation, color1, color2, siren)
{
     new Float: X, Float: Y,  Float: Z;
     GetPlayerPos(playerid, X, Y, Z);
     new carid = CreateVehicle(modelid, X, Y, Z, rotation, color1, color2, siren);
     PutPlayerInVehicle(playerid, carid, 0);
     return carid;
}

You don't have to worry about what these things mean, as they are simply self-explanatory, we are creating three float variables that store numerical value with decimal points, we are getting the player's position with a method called GetPlayerPoss, that requires the three variables we just declared previously. We then create a new variable that stores the id of a car that we are creating. The variable carid stores informations about a vehicle that has a modelid given by the method, the current position of the player, the colors, rotation and siren properties that are given by the method. We then proceed at the end by putting the player in the vehicle we just created in the seat of the passenger, seat 0. Afer that, we return the id of the vehicle that we created for later code uses.
We do this so next time we want to create a new vehicle we will just do this

Code:

public OnPlayerSpawn(playerid)
{
    CreateCarAtPlayerPosition(playerid, 411, 0.0, 0, 0, 0);
    return 1;
}

What this code does is creating an infernus for the player with a rotation of 0, black and without a siren at it's current position when the player spawns.

Let's say we don't want to specify the rotation each time, or the color, we just want our code to spawn a red vehicle at the player's position that has no sirens and for that we just need to create a new method

Code:

CreateRedVehicleAtPlayerPosition(playerid, modelid)
{
    return CreateCarAtPlayerPosition(playerid, modelid, 0.0, 3, 0, 0);
}

See how super-simplified this method got? Now with a simple function we can create any red vehicle we want and at the player's position
The above code and explanation is a philosophy and also a simple guide of how most of the scripts work at their core. Simple methods, that do simple things. It is said, that a method should not do more than just one thing.
We don't want a method that creates the entirety of the server, we create a method for each thing that we want to do.
For example, we can have methods like:

Code:

CreatePlayerVehicleInRangeOf(playerid, Float:range, Float: X, Float: Y, Float: Z);
CreateShopInRangeOf(Float:range, Float: X, Float: Y, Float: Z, interior, virtual_world);
CreatePickupBehindPlayer(playerid, pickupid, type);

And many more uses as well. Methods should allow code reuse.

Events
We describe an event as something that occurs when an entity x is influenced by an exterior force that has some kind of effect on the given entity. Thus, we can see, that sa-mp servers has in fact, many events, for example, we have an event that handles what happens when the player joins a server: OnPlayerConnect or when player types on the main chat: OnPlayerText, when types a command: OnPlayerCommandText, so far and so forth.
We can also create events of our own by using timers. Timers allow the posibility of calling a method to act as an event every x amount of time, where x can be any amount of time we want, yes, even years (don't know why you would want that). You can use timers to check if something happens: example -> player is using the minigun. In the timer main method you can make so that if the player indeed uses a minigun and the player is not an admin, a new event is called: OnPlayerCheating(cheaterid)

A simple example of the explanation above would be this:

Code:

...bla bla #include... blala

public OnGameModeInit()
{
    SetTimer("CheckCheaters", 1000, true);
    return 0;
}

forward CheckCheaters();
public CheckCheaters()
{
    for(new i = 0; i < MAX_PLAYERS; i++)
    {
         if(IsPlayerConnected(i))
         {
              new weapon[13][2];
              for(j = 0; j <= 12; j++)
             {
                  GetPlayerWeaponData(i, j, weapon[j][0], weapon[j][1]);
             }
             
              for(j = 0; j <= 12; j++)
             { 
                  if(weapon[j][0] == 46 && !IsPlayerAdmin(playerid) ) OnPlayerCheating(i);
             }
         }
    }
    return 1;
}

forward OnPlayerCheating(cheaterid);
public OnPlayerCheating(cheaterid)
{
    new cheater_name[MAX_PLAYER_NAME];
    GetPlayerName(cheaterid, cheater_name, sizeof(cheater_name));
    new message[50];
    format(message, sizeof(message), "%s has been found cheating. Banned", cheater_name);
    SendClientMessageToAll(-1,  message);
    BanEx(cheaterid, "Hacks");
    return 1;
}

Why use it likes this? Because now you can create multiple checks in the timer for other hacks, example if player is flying and is not in a car or an admin, like this:

Code:

...bla bla #include... blala

public OnGameModeInit()
{
    SetTimer("CheckCheaters", 1000, true);
    return 0;
}

forward CheckCheaters();
public CheckCheaters()
{
    for(new i = 0; i < MAX_PLAYERS; i++)
    {
         if(IsPlayerConnected(i))
         { 
              // weapon check, you can also create a method like: CheckHackWeapon(playerid, weaponid) and use that instead of this whole code
              new weapon[13][2];
              for(j = 0; j <= 12; j++)
             {
                  GetPlayerWeaponData(i, j, weapon[j][0], weapon[j][1]);
             }
             
              for(j = 0; j <= 12; j++)
             { 
                  if(weapon[j][0] == 46 && !IsPlayerAdmin(playerid) ) OnPlayerCheating(i);
             }

             //flying hack - not in a vehicle check + in a vehicle check
            new Float: X, Float: Y, Float: Z;
            GetPlayerPos(playerid, X, Y, Z);
            new Float: velocityX, Float: velocityY, Float: velocityZ;
            new Float: vehiclevX, Float: vehiclevY, Float: vehiclevZ;
            GetVehicleVelocity(GetPlayerVehicleID(i), vehiclevX, vehiclevY, vehiclevZ);
            GetPlayerVelocity(playerid, X, Y, Z);
            if(!IsPlayerInAnyVehicle(i)) {
            new Float: speed = (( velocityX*velocityX ) + (velocityY * velocityY) + (velocityZ*velocityZ));
                 if(speed > 100) {
                      if(!IsPlayerAdmin(playerid)) OnPlayerCheating(i);
                 }
            }
           else {
               new speed = ( (vehiclevX*vehiclevX) + (vehiclevY*vehiclevY) + (vehiclevZ*vehiclevZ) );
               if(speed > 100) {
                   if(!IsPlayerAdmin(playerid)) OnPlayerCheating(i);
               }
          }
         }
    }
    return 1;
}

forward OnPlayerCheating(cheaterid);
public OnPlayerCheating(cheaterid)
{
    new cheater_name[MAX_PLAYER_NAME];
    GetPlayerName(cheaterid, cheater_name, sizeof(cheater_name));
    new message[50];
    format(message, sizeof(message), "%s has been found cheating. Banned", cheater_name);
    SendClientMessageToAll(-1,  message);
    BanEx(cheaterid, "Hacks");
    return 1;
}

This is not a tutorial to teach you how to do those things that I just explained and some of the things that I have explained myself, maybe wrong to the ideea that some things may not be precise. There are plenty of great tutorials on this website to teach you on how to create the ideal" anti-flying hack or just direct scripts that let's you add them into your server without much struggle. This is tutorial is not meant to teach you how to do those things, but to give you an ideea about the philosophy of programming language and how to use this philosophy to create great code that can be re-used at any time without having to create a new gamemode just because you forgot what is in your gamemode after not scripting for a while.

As you can see in the code above, both uses the same method as an event. If the player is passing through this checks in this timer, the method will be called each time, if not, it will not be called

This is an excellent example, of how we could create an event to handle something, let's say for instance, we want an event that handles what happens when the player creates a new account, or what happens when the player is doing something that is worth creating an event for.

Yes, some of you may say that timers are not necesarily needed always, that is true, they consume a lot of power and are quite laggy at times. You can also call the method that acts as an event in certain situations. Example, you have an event that handles what happens when the player levels up on an rpg server. In this case you would create for example a method called: AdvancePlayerLevel:

Code:

AdvancePlayerLevel(playerid)
{
     PLAYER_ACCOUNT[playerid][pLevel]++;
     OnPlayerHadLevelUp(playerid, PLAYER_ACCOUNT[playerid][pLevel]);
}

and thus, we can declare the event method like this.

Code:

forward OnPlayerHadLevelUp(playerid, level);
public OnPlayerHadLevelUp(playerid, level)
{
    new name[MAX_PLAYER_NAME];
    GetPlayerName(playerid, name, sizeof(name));
    new message[256];
    format(message, sizeof(message), "%s has advanced to level %d. Congratiolations!",  name, level);
    SendClientMessageToAll(-1, message);
}

And now we have an event that handles what happens after the player reaches a new level, you can use this new event in any shape you want it. Why not give him ability to use new commands when he levels up to level 10? Or give him a new car at level 15, your imagination is the sky now.

[TO-BE-CONTINUED]

Conclusions
Well, as an end, I want to say, I am sorry for any gramatical errors that I may had made in this post, I'll come from time to time to update this post and make it better. Also why I made this post? Well, while it makes perfect sense what I just wrote, it's a great mindset to start with when programming, and not just a sa-mp server. We want to be able to create includes, plugins and scripts that allow us to be able to re-use code without having to write the same thing 500 times over the whole sa-mp server project. We also want code that can handle any situation and events or methods that can come to our aid when want to create a simple method that update's a player's password or deletes or creates an account.

What's your own tips and advice?
How do you use methods in your script?
How do you use events in your script?
How do you use timers in your scripts?
How do you use variables in your script, or redefinitions?

Those are simple and good questions, because a great way of creating scripts can save up a long time of struggling to get over an ugly, big and unordered chunk of 27.000 lines code gamemode where everything is shuffled randomly everywhere.

[Tutorial] How to make a simple discord bot, In Javascript.

Tue, 12 May 2020 15:39:00 +0000

_________________

Introduction

Hey there! I released a moderation bot here in the forums today and a lot of people were asking on how I made it, so here I am making a tutorial for everyone. To make a discord bot you can use python or javascript, in this case, we will be using javascript as it is easier (I think so at least). So, I am sure most of you know this but just to make sure ill say it again. Discord is a real-time messaging platform that bills itself as an “all-in-one voice and text chat for gamers.” Due to its slick interface, ease of use, and extensive features, Discord has experienced rapid growth and is becoming increasingly popular even among those with little interest in video games, including the SAMP community. For this bot you can use any kind of editor you want, i recommend Visual Studio Code. Let's start making our bot.

1 -Create an application in the developer portal

Go to - https://discord.com/developers/applications
After you, Login/Signup create an application.

2 - Create a bot for your application

Go to your new application and create a bot for it, after that copy the token from it.

3 - Copy the client ID and invite the bot

Go to - https://discordapi.com/permissions.html
Enter your Client ID and enable all permissions, then click the link to invite the bot to the desired server.

4 - Making the actual bot

Now read carefully. First of all, you need to download Node.js - https://nodejs.org/en/download/
Then you create a folder in your desktop and using the command prompt use "cd" to go to the folder you created.
Then you can do "npm init", you may skip all the steps by pressing enter if you want. This will create a son file.
After that we need to install the discord.js modules, we can do that by typing "npm install discord.js" in the command prompt. Now you will find a folder named "node_modules" in your discord bot's folder. (Ignore the warnings that it will show)
Next, we need to create a new file in our folder called index.js. now we can start making the actual script.
I will only give you the basics, the rest you will have to learn by yourself (I can assist at any time if you need help). Try to write it instead of just copy/pasting, it really helps.

PHP Code:



const Discord = require("discord.js") // We require discord.js’s library

const client = new Discord.Client() // We initialize it by calling Client()

client.on("ready", () => { // Then we listen for the ready event via the on method and we tell how to handle this event with a callback function.

  console.log(`Logged in as ${client.user.tag}!`) // Send's a message in the console when the bot starts

})

client.on("message", msg => { // // Now we listen for the message event via the on method and we tell how to handle this event with a callback function again.

  if (msg.content === "ping") { // This tells the bot that if a user types "ping", he should respond with "Pong!"

    msg.reply("Pong!")

  }

})

client.login("token-goes-here")// Here you should put the token you copied from the discord's developer website.

To start the bot you can do "node index.js"(or any other name u used), or you can create a .bat file and put in it the following code:

PHP Code:



echo off

cls

echo Starting Bot

node index.js

pause

Enjoy!

Now this is the most basic bot you may create, there are a lot of other features you may add, economy systems, new commands, etc. No-one was born as a developer It only takes concentration, put some time into it and you will reach perfection. Feel free to ask me any questions you have, ill be glad to respond and assist you.

[Tutorial] Anti firing bullets from non-bullet weapon hack

Tue, 07 Apr 2020 06:42:00 +0000

In recent days players in my server have been suffering from a game freeze/crash caused by hackers firing bullets from weapon ID 0 (a non-bullet weapon). This was supposedly fixed in the 0.3.7-R2 server, but it doesn't seem to be. This is how you can fix it:

Code:

public OnPlayerWeaponShot(playerid, weaponid, hittype, hitid, Float:fX, Float:fY, Float:fZ)
{
    switch (weaponid)
    {
        case 22 .. 34, 38:
        {
            // valid bullet weapon
        }
        default:
        {
            // invalid bullet weapon
            return 0; // desync the shot
        }
    }
    return 1;
}

[Tutorial] Pre-sized random strings

Wed, 20 Nov 2019 16:33:00 +0000

Hi guy's I'm making a little system for my RP server for transfer "money" player to player like an IBAN code...then after taked a look on internet I didn't found nothing interesting, then I tryied a raw method, then it work.
It's various stock for get random strings, number, character.
This is a basic random method, hope you liked and it's usefull for who need it.
(sorry if I wrote wrong, I'm from Italy...then MAMMAMIA MARCELLO, pizzeria, mafia etc )

how to use

for make it easy this is a little example:

pawn Code:

CMD:test(playerid, params[])
{
    new string[22];
    format(string, sizeof(string), "%s", SizedRandomNumbers(10) );
    SendClientMessage(playerid, -1, string);
    return 1;
}
/*
the output will be a string with 10 random numbers
and not like using random(9999999999) where the output can be less than you wanted
*/

the code

pawn Code:

/* --- numbers --- */
stock SizedRandomNumbers(size)
{
    new str[128];
    for(new i=0; i<size; i++)
    {
        format(str, sizeof(str), "%s%d", str, random(9));
    }
    return str;
}

/* --- Characters --- */
stock SizedRandomUpperCharacters(size)
{
    new str[128];
    for(new i=0; i<size; i++)
    {
        new lettere = RandomEx(1, 26);
        switch(lettere)
        {
            case 1: format(str, sizeof(str), "%sA", str);
            case 2: format(str, sizeof(str), "%sB", str);
            case 3: format(str, sizeof(str), "%sC", str);
            case 4: format(str, sizeof(str), "%sD", str);
            case 5: format(str, sizeof(str), "%sE", str);
            case 6: format(str, sizeof(str), "%sF", str);
            case 7: format(str, sizeof(str), "%sG", str);
            case 8: format(str, sizeof(str), "%sH", str);
            case 9: format(str, sizeof(str), "%sI", str);
            case 10: format(str, sizeof(str), "%sL", str);
            case 11: format(str, sizeof(str), "%sM", str);
            case 12: format(str, sizeof(str), "%sN", str);
            case 13: format(str, sizeof(str), "%sO", str);
            case 14: format(str, sizeof(str), "%sP", str);
            case 15: format(str, sizeof(str), "%sQ", str);
            case 16: format(str, sizeof(str), "%sK", str);
            case 17: format(str, sizeof(str), "%sJ", str);
            case 18: format(str, sizeof(str), "%sR", str);
            case 19: format(str, sizeof(str), "%sS", str);
            case 20: format(str, sizeof(str), "%sT", str);
            case 21: format(str, sizeof(str), "%sU", str);
            case 22: format(str, sizeof(str), "%sV", str);
            case 23: format(str, sizeof(str), "%sZ", str);
            case 24: format(str, sizeof(str), "%sX", str);
            case 25: format(str, sizeof(str), "%sY", str);
            case 26: format(str, sizeof(str), "%sW", str);
        }
    }
    return str;
}

stock SizedRandomDownCharacters(size)
{
    new str[128];
    for(new i=0; i<size; i++)
    {
        new lettere = RandomEx(1, 26);
        switch(lettere)
        {
            case 1: format(str, sizeof(str), "%sa", str);
            case 2: format(str, sizeof(str), "%sb", str);
            case 3: format(str, sizeof(str), "%sc", str);
            case 4: format(str, sizeof(str), "%sd", str);
            case 5: format(str, sizeof(str), "%se", str);
            case 6: format(str, sizeof(str), "%sf", str);
            case 7: format(str, sizeof(str), "%sg", str);
            case 8: format(str, sizeof(str), "%sh", str);
            case 9: format(str, sizeof(str), "%si", str);
            case 10: format(str, sizeof(str), "%sl", str);
            case 11: format(str, sizeof(str), "%sm", str);
            case 12: format(str, sizeof(str), "%sn", str);
            case 13: format(str, sizeof(str), "%so", str);
            case 14: format(str, sizeof(str), "%sp", str);
            case 15: format(str, sizeof(str), "%sq", str);
            case 16: format(str, sizeof(str), "%sk", str);
            case 17: format(str, sizeof(str), "%sj", str);
            case 18: format(str, sizeof(str), "%sr", str);
            case 19: format(str, sizeof(str), "%ss", str);
            case 20: format(str, sizeof(str), "%st", str);
            case 21: format(str, sizeof(str), "%su", str);
            case 22: format(str, sizeof(str), "%sv", str);
            case 23: format(str, sizeof(str), "%sz", str);
            case 24: format(str, sizeof(str), "%sx", str);
            case 25: format(str, sizeof(str), "%sy", str);
            case 26: format(str, sizeof(str), "%sw", str);
        }
    }
    return str;
}

stock SizedRandomUDCharacters(size)
{
    new str[128];
    for(new i=0; i<size; i++)
    {
        new lettere = RandomEx(1, 52);
        switch(lettere)
        {
            // lettere minuscole
            case 1: format(str, sizeof(str), "%sa", str);
            case 2: format(str, sizeof(str), "%sb", str);
            case 3: format(str, sizeof(str), "%sc", str);
            case 4: format(str, sizeof(str), "%sd", str);
            case 5: format(str, sizeof(str), "%se", str);
            case 6: format(str, sizeof(str), "%sf", str);
            case 7: format(str, sizeof(str), "%sg", str);
            case 8: format(str, sizeof(str), "%sh", str);
            case 9: format(str, sizeof(str), "%si", str);
            case 10: format(str, sizeof(str), "%sl", str);
            case 11: format(str, sizeof(str), "%sm", str);
            case 12: format(str, sizeof(str), "%sn", str);
            case 13: format(str, sizeof(str), "%so", str);
            case 14: format(str, sizeof(str), "%sp", str);
            case 15: format(str, sizeof(str), "%sq", str);
            case 16: format(str, sizeof(str), "%sk", str);
            case 17: format(str, sizeof(str), "%sj", str);
            case 18: format(str, sizeof(str), "%sr", str);
            case 19: format(str, sizeof(str), "%ss", str);
            case 20: format(str, sizeof(str), "%st", str);
            case 21: format(str, sizeof(str), "%su", str);
            case 22: format(str, sizeof(str), "%sv", str);
            case 23: format(str, sizeof(str), "%sz", str);
            case 24: format(str, sizeof(str), "%sx", str);
            case 25: format(str, sizeof(str), "%sy", str);
            case 26: format(str, sizeof(str), "%sw", str);
            // Lettere maiuscole
            case 27: format(str, sizeof(str), "%sA", str);
            case 28: format(str, sizeof(str), "%sB", str);
            case 29: format(str, sizeof(str), "%sC", str);
            case 30: format(str, sizeof(str), "%sD", str);
            case 31: format(str, sizeof(str), "%sE", str);
            case 32: format(str, sizeof(str), "%sF", str);
            case 33: format(str, sizeof(str), "%sG", str);
            case 34: format(str, sizeof(str), "%sH", str);
            case 35: format(str, sizeof(str), "%sI", str);
            case 36: format(str, sizeof(str), "%sL", str);
            case 37: format(str, sizeof(str), "%sM", str);
            case 38: format(str, sizeof(str), "%sN", str);
            case 39: format(str, sizeof(str), "%sO", str);
            case 40: format(str, sizeof(str), "%sP", str);
            case 41: format(str, sizeof(str), "%sQ", str);
            case 42: format(str, sizeof(str), "%sK", str);
            case 43: format(str, sizeof(str), "%sJ", str);
            case 44: format(str, sizeof(str), "%sR", str);
            case 45: format(str, sizeof(str), "%sS", str);
            case 46: format(str, sizeof(str), "%sT", str);
            case 47: format(str, sizeof(str), "%sU", str);
            case 48: format(str, sizeof(str), "%sV", str);
            case 49: format(str, sizeof(str), "%sZ", str);
            case 50: format(str, sizeof(str), "%sX", str);
            case 51: format(str, sizeof(str), "%sY", str);
            case 52: format(str, sizeof(str), "%sW", str);
        }
    }
    return str;
}

[Tutorial] How To Create Random Spawns!

Tue, 23 Jul 2019 18:39:00 +0000

Creating Random Spawns

So this is a very simple, straight-forward tutorial on how to make random spawns.

For creating random spawns, there are 2 methods i can think of right now. First simple switch () statement and second using milti-dimentional arrays.

There are alot of beginners who are unable to understand the concept of multi-dimensional arrays so in this tutorial i will show them how to make a random spawn system and similar stuff without using the arrays. Since the array method is explained in the wiki, i'll be explaining the second one.

Here is a code showing the OnPlayerSpawn () callback, for-example if you want to spawn the player at one of five random positions, this code will work:

Code:

public OnPlayerSpawn (playerid)
{
    new selected_spawn = random (5);

    switch (selected_spawn)
    {
        case 0: { SetPlayerPos (playerid, 0.0,   0.0,   0.0);  SetPlayerFacingAngle (playerid, 0.0); }
        case 1: { SetPlayerPos (playerid, 10.0, 10.0, 10.0); SetPlayerFacingAngle (playerid, 10.0); }
        case 2: { SetPlayerPos (playerid, 20.0, 20.0, 20.0); SetPlayerFacingAngle (playerid, 20.0); }
        case 3: { SetPlayerPos (playerid, 30.0, 30.0, 30.0); SetPlayerFacingAngle (playerid, 30.0); }
        case 4: { SetPlayerPos (playerid, 40.0, 40.0, 40.0); SetPlayerFacingAngle (playerid, 40.0); }
    }
    return 1;
}

Explained:

1.

Code:

new selected_spawn = random (5);

Here you can see a new integer type variable being created followed by an assignment operator and a function named 'random ()'. This semantic of this line of code works like this:

- It creates an integer variable.
- It then generates a random value between 0 and 4 (5 is the size of its range, since in coding counting starts from 0 so 0, 1, 2, 3, 4 = 5)
- It assigns the randomly generated value to the newly created variable.

2.

Code:

switch (selected_spawn) { }

This is called a switch statement, in simple words it is an alternative to the if-statement with some limitations but it can be used neatly in this case. So it will execute a function or set of functions depending upon the value of variable 'selected_spawn'.

As you can see, we have provided it 2 functions to perform in each case, for-example if the value of 'selected_spawn' turns out to be 1, it will perform the following functions and hence the player's position will be set to the given coordinates.

Code:

switch (selected_spawn)
    {
        case 0: { SetPlayerPos (playerid, 0.0,   0.0,   0.0);  SetPlayerFacingAngle (playerid, 0.0); }
        case 1: { SetPlayerPos (playerid, 10.0, 10.0, 10.0); SetPlayerFacingAngle (playerid, 10.0); }
        case 2: { SetPlayerPos (playerid, 20.0, 20.0, 20.0); SetPlayerFacingAngle (playerid, 20.0); }
        case 3: { SetPlayerPos (playerid, 30.0, 30.0, 30.0); SetPlayerFacingAngle (playerid, 30.0); }
        case 4: { SetPlayerPos (playerid, 40.0, 40.0, 40.0); SetPlayerFacingAngle (playerid, 40.0); }
    }

Now, that was all, if you want to add another random spawn, you can increment the range of the random () function and add it's coordinates in the switch () statement.

You can also make a function out of it, so if you want to set random positions multiple times in the code, it will be useful.

Here is an example code:

Code:

public OnPlayerSpawn (playerid)
{
    SetRandomPosition (playerid); // You can use this multiple times in other parts of code too.
    return 1;
}

stock SetRandomPosition (playerid)
{
    new selected_spawn = random (5);

    switch (selected_spawn)
    {
        case 0: { SetPlayerPos (playerid, 0.0,   0.0,   0.0);  SetPlayerFacingAngle (playerid, 0.0); }
        case 1: { SetPlayerPos (playerid, 10.0, 10.0, 10.0); SetPlayerFacingAngle (playerid, 10.0); }
        case 2: { SetPlayerPos (playerid, 20.0, 20.0, 20.0); SetPlayerFacingAngle (playerid, 20.0); }
        case 3: { SetPlayerPos (playerid, 30.0, 30.0, 30.0); SetPlayerFacingAngle (playerid, 30.0); }
        case 4: { SetPlayerPos (playerid, 40.0, 40.0, 40.0); SetPlayerFacingAngle (playerid, 40.0); }
    }
    return 1;
}

[Tutorial] Adding and Removing Mapped Objects to/from your Script

Wed, 22 May 2019 01:43:00 +0000

Dual Gaming - Tutorial #1

Introduction

I've noticed that some tutorials are hard for persons who are opening pawno for the first time or those who are a bit or completely new to how scripting on SA-MP works. This is my first tutorial, and I hope it helps and aids those who are adding objects to their server or gamemode for the first time.

Mapping your objects

Mapping in SA-MP is quite easy, in my point of view. It simply needs patience, dedication and time. Some persons tend to become annoyed when they're mapping, and when things aren't going their way, they flip off. Trust me, it happens to me sometimes. You may map an object in a map editor, but after adding it to the gamemode or filterscript and testing it on the server, it doesn't give the output you expected. What I want you to do is take a deep breath, and aim towards fixing it, as if you've never had difficulties while mapping it.

I personally recommend two map editor softwares. They are:

SA-MP Map Editor - Click here to download/view it (More preferable)
MTA (Multi Theft Auto) Map Editor - Click here to download/view this extension

The SA-MP Map Editor is a software which is based on the default map of San Andreas. It covers the entire map, and it's used for adding, deleting, and editing objects of all kinds, sorts and models. It's easy to use, and after mapping a specific part of the map, you can click on "Show Code" to give you the codes of the Objects Created and Objects Deleted. On the other hand, the MTA map editor is mainly used for mapping MTA servers (no intentions in drawing your attention away from SA-MP and its Map Editor) but we're luckily able to convert the MTA Object Codes to SA-MP objects. Are you wondering where and how to do that? Simple, head over to https://convertffs.com/. After visiting this website, open your MTA map file (the file with the .map extension, e.g. TutorialMaps.map) which you saved via the MTA Map editor and copy its code. Paste the copied code into the dialog box on the convertffs website, and choose an OutPut mode. It's highly recommend to use CreateDynamicObjectEx when compiling object codes, because it caters for lags and avoids the objects limit. In some cases, you may find or see persons using CreateDynamicObject in their codes, but you'll get to know more about that (in-depth info) in the future.

Differences:

CreateDynamicObjectEx - allows you to change the draw distance (how many objects a player can see from their distance) and show the object for various worlds, interiors or players.
CreateDynamicObject - has no settings to allow players to view objects from a far distance (streaming many at one time) and such objects can only be seen in one world or interior.
CreateObject - is default. However, it only limits you to a certain amount of objects (which can be seen here: https://sampwiki.blast.hk/wiki/Limits)
RemoveBuildingForPlayer - this removes the buildings and objects for players.

Differentiation and Specific Usages

If you're adding the mapped object codes to your .pwn gamemode file, found in the gamemode folder, place the codes under:

PHP Code:



public OnGameModeInit()

{

    // Place the Codes here

    return 1;

}

For adding the object codes to a filterscript's .pwn file, which can be found in the filterscripts folder, place them under:

PHP Code:



public OnFilterScriptInit()

{

    // Place the Codes here

    return 1;

}

For removing objects from the San Andreas Map, place the codes under:

PHP Code:



public OnPlayerRequestClass(playerid, classid)

{

    // Codes

    return 1;

}

PHP Code:



public OnPlayerConnect(playerid)

{

        // Codes

    return 1;

}

For some persons, the objects may not be removed if you place them under public OnPlayerConnect(playerid), so public OnPlayerRequestClass(playerid, classid) is an alternative method.

Tip: You must add the streamer include to your pawno/includes folder (which can be found here: GitHub Releases).

How to add it to your .pwn gamemode file after placing it in the include folder? Look below (add it below #include [At the top of the script])

PHP Code:



#include

Good luck, and if you have comments/remarks, feel free to share them below. I might make tutorials of how to create certain stuff, like faction-related scripts, attaching items/objects to players/vehicles, creating login/register dialogs, how to built master-account scripts (which allows you to create a main account, and create characters afterwards in-game (step-by-step), and some other stuff!

[Tool/Web/Other] Check the script for curly bracket mistakes (linux)

Fri, 05 Apr 2019 17:37:00 +0000

Hello samp-forum community,

I had some problems with curly brackets in the past. I read it also very often already, that people had to deal with these problems already.

I just created a tool for finding these curly bracket mistakes and I also tested it. It was really annoying for me to find these curly bracket mistakes. I found them relatively quickly because I know what I have done before etc. but it's better and easier if I use my little tool.

Example code (with the known problem):

Code:

if(ianduisnotme == 1)
{
    put some code in here
}
}

Example code (without the known problem):

Code:

if(ianduisnotme == 1)
{
    put some code in here
}

Code:

Y_Less suggestion:
How does it deal with code like:

Code:

#if A
    Func(a) {
#else
    Func(b) {
#endif


    }

It also deals with this code.

It also tells you if there's a mistake; for instance:

Code:

#if A
    Func(a) {
#else
    Func(b) //Mistake is here
#endif


    }

Code:

#if A
    Func(a) {
#else
    Func(b) //Mistake is here, missing opening bracket
#endif

    //Mistake here also, missing closing bracket

Code:

#if A
    Func(a) //Mistake here, missing closing bracket
#else
    Func(b) //Mistake is here, missing closing bracket
#endif
}

    }

Use:

Code:

perl syncor.pl -f

Code:

DL-Link (v. 3): https://drive.******.com/open?id=1XmrkXe...ko5SEJ1qeA

What doesn't do the script? It doesn't tell you the kind of mistake! It's simply unecessary for you because you know how to script pawno right ?

Have fun and enjoy the future without doing a long long search for the curly bracket mistake!

-Doddinger

PS. If you have any suggestions, simply write them down and reply here.

[Tutorial] State-based hooks (aka pre-hooks)

Sun, 31 Mar 2019 22:24:00 +0000

This is a hook method I came up with long ago (before hook method 7, i.e. modern ALS). It uses states to determine if a hook exists or not. This was previously documented, but that documentation is both deleted and obsolete - the technique is the same, but the implementation has evolved a little bit.

PHP Code:



#include 


/*

First define several states for "hooked" and "unhooked".  These functions are

purely to define states, they are never used.  The states only need to be

defined once per mode, and both fixes.inc and YSI already define them.  The

function name is unimportant, but the state specifiers must be exactly as below:

*/


static stock Library_IncludeStates() <_ALS : _ALS_x0, _ALS : _ALS_x1, _ALS : _ALS_x2, _ALS : _ALS_x3>

{

}


static stock Library_IncludeStates() <_ALS : _ALS_go>

{

}


/*

Here is our first hooked function, it is always a good idea to hook a ScriptInit

function so you can set "_ALS_" state, but you can also do that in any other

callback, this is just merely a small optimisation.

*/

public OnGameModeInit()

{

    /*

    Set the `_ALS_` state to `_ALS_go`.  The basic idea is that this state is

    ALWAYS `_ALS_go`, if the next callback in a callback chain exists it will

    have an implementation defined for the `_ALS_go` state; if there is no next

    callback, only the fallback will exist.  This should be done before the

    first chain call - it only NEEDs to be done once but multiple times is fine,

    and multiple libraries can (and do) do this.

    */

    state _ALS : _ALS_go;


    /*

    Now call the next callback in the chain.  With the normal ALS method this

    requires a pre-processor `#if` directive to protect against the case where

    the next item in the chain doesn't exist.  With this version, the next

    chain callback always exists in some form even if the user didn't define it.

    */

    return Library_OnGameModeInit();

}


/*

Forward the next callback in the chain.

*/

forward Library_OnGameModeInit();


/*

Normal ALS redefinition checks.

*/

#if defined _ALS_OnGameModeInit

    #undef OnGameModeInit

#else

    #define _ALS_OnGameModeInit

#endif


/*

Now this is where it starts getting interesting.  Because we unconditionally

call `Library_OnGameModeInit`, the code MUST include this function, but because

we are hooking it, we don't know if it will or not - so we create it!  But if we

create it, then what's in the next library (or mode) in the chain?  The answer

is they are BOTH the next function in the chain thanks to the magic of states.


The first line here defines `OnGameModeInit` when `_ALS` is set to two of the

other values - this is actually NEVER the case, but is important as it tells the

compiler which automata our `Library_OnGameModeInit` function is controlled by

(i.e. `_ALS`).  The second line is the "fallback" function - if `_ALS` is in a

state for which there is no specific implementation, this one will get called

instead and just instantly return (maybe you can now see the trick).  If `_ALS`

is set to `_ALS_go` and there is no other function, then the compiler will

identify this fallback function as the correct one to call (or rather the

runtime will).  If the hooked function DOES exist, then that more specialised

version will be called instead.


If we didn't have the first function to define states, then the fallback

wouldn't compile.

*/

public Library_OnGameModeInit() <_ALS : _ALS_x0, _ALS : _ALS_x1> { return 1; }

public Library_OnGameModeInit() <> { return 1; }


/*

Because we are now using states, we need a slightly more complex redefinition of

the next callback's function definition - we need to transparently add the

`_ALS : _ALS_go` state to it, so that's exactly what this line does.


Remember that `_ALS` only needs to be defined once in a mode, and `Library_` is

just the prefix I've used in this example - it needs to be unique.

*/

#define OnGameModeInit(%0) Library_OnGameModeInit(%0) <_ALS : _ALS_go>

PHP Code:



/*

This is just another `OnGameModeInit` that will be correctly called if it

exists.  It shouldn't be part of your library (i.e. this is user code).

*/


public OnGameModeInit()

{

    printf("Hello");

    return 1;

}

y_hooks are simpler to write, and faster to run. Normal ALS hooks are slightly faster, but lack two properties. Because this version uses states the next item in the chain always exists, and the entry point to the chain function is in a known format and location in the AMX. These properties together allow us to detect and intercept these calls at run-time. And so introduces "pre-hooks". The standard call order for hooks is as follows:

y_hooks, in include order.
ALS hooks, in include order.
User code.

However, there are some libraries (notably fixes.inc) which must be called before y_hooks hooks, but can't rely on y_hooks to use `hook` and thus come first. For these, we have pre-hooks, defined by these state hooks, and natively supported by y_hooks (which leads to the interesting property that including y_hooks actually optimises these functions. The new order thus becomes:

Pre-hooks.
y_hooks, in include order.
ALS hooks, in include order.
User code.

Pre-hooks are called in include order, but y_hooks can not determine which is the last one, so we need to explicitly inform it of the order:

PHP Code:



CHAIN_ORDER(Library);

#undef CHAIN_ORDER

#define CHAIN_ORDER CHAIN_NEXT(Library)

This assumes you have YSI (and thus y_prehook, part of YSI_Core). Otherwise, check the file for the macro definitions:

https://github.com/pawn-lang/YSI-Inc.../y_prehook.inc

It also defines macros to simplify the forwarding, and add custom return values:

PHP Code:



/*

Normal ALS definitions.

*/

#if defined _ALS_OnGameModeInit

    #undef OnGameModeInit

#else

    #define _ALS_OnGameModeInit

#endif


/*

All that is required for forwarding.  The `= 1` is to define the default return

value, so in `OnPlayerCommandText` this would be `= 0`.

*/

CHAIN_FORWARD:Library_OnGameModeInit() = 1;


/*

Now the redefinition.

*/

#define OnGameModeInit(%0) CHAIN_PUBLIC:Library_OnGameModeInit(%0)

Again, check y_prehook for more information. These macros are also mostly in fixes.inc, but currently misnamed.

[Tutorial] Returning strings and arrays

Sun, 17 Feb 2019 15:09:00 +0000

While functions in Pawn typically return only simple cell-sized values, the language does allow for (even native) functions to return arrays and therefore also strings. However, the mechanism that allows it is a bit more complex and may not be suited for some use cases.

First of all, let's look at the standard way of getting a string out of a function.

Via an output parameter
All native SA-MP functions produce a string via a standard non-const array parameter. Since arrays are passed by reference (meaning the function gets access to the actual variable and not just the value inside), the native function can easily store any data inside:

pawn Code:

new name[MAX_PLAYER_NAME + 1];
GetPlayerName(playerid, name, sizeof name);

Usually, another parameter is used alongside the array parameter to specify the length of the array. In Pawn, there is no simple way to obtain the length of an array directly at runtime, and so the compiler has to provide the length when needed (the sizeof operator). For strings, an extra cell must be allocated in the array to store the null character, indicating the end of the string (hence the + 1).

This way is especially useful for obtaining variable-length arrays (such as strings). The format function, for example, can be only implemented for this way, because the theoretical length of the output string is unlimited.

Returning an array directly
If you want to produce a fixed-size array, you can return it from a function directly:

pawn Code:

forward [MAX_PLAYER_NAME + 1]PlayerName(playerid);
stock PlayerName(playerid)
{
    new name[MAX_PLAYER_NAME + 1];
    GetPlayerName(playerid, name, sizeof name);
    return name;
}

The forward declaration is optional, but it is useful since it makes you keep in mind that the length of the array is important.

Now, if you know a bit of other languages like C etc., you may be aware that since name is allocated on the stack, it doesn't exist anymore when the function returns. Pawn gets around this fact using a trick – when the function is called, extra space for the array is allocated, and the address of this variable is provided to the function via a secret parameter.

In reality, the function looks like this:

pawn Code:

stock PlayerName(playerid, output[MAX_PLAYER_NAME + 1])
{
    new name[MAX_PLAYER_NAME + 1];
    GetPlayerName(playerid, name, sizeof name);
    output = name;
}

As you can see, returning a string is just a convenient syntactic shortcut for an extra output parameter.

However, this comes at a cost of slightly decreased performance and bugs in certain cases. Let's start with the issues:

pawn Code:

stock Select(index, arg[], arg2[])
{
    if(index == 0) return arg;
    return arg2;
}

This simple function seems to return one of the arguments, but since they have indeterminate sizes (represented as 0), the compiler thinks this function returns a zero-sized array and does not actually allocate any extra space for the string. You cannot return strings (or arrays) that have indeterminate length, and the compiler sometimes fails to inform you about this.

pawn Code:

forward [4]Func1();
stock Func1()
{
    new str[] = "abc";
    return str;
}

forward [4]Func2();
stock Func2()
{
    return Func1();
}

This code is also horribly wrong, but in a subtle way. Func2 does allocate extra space for the array returned from Func1, but before the array can be copied to the secret output array of the second function, it is deallocated again and isn't accessible anymore.

pawn Code:

stock Func(...)
{
    new str[] = "abc";
    return str;
}

The extra output argument is placed at the end of all arguments, even after the variadic ones. However, the compiler fails to correctly obtain the return address in this case, and assumes its position is constant.

In all these cases, returning a string is a really bad thing to do, since the code usually compiles fine, and the issue only becomes apparent at runtime.

There is a slight performance cost associated with returning arrays as well: the output = name; always happens if the function is implemented in Pawn, and so the array is copied at least once. Take a look at this code:

pawn Code:

new name[MAX_PLAYER_NAME + 1]; // = PlayerName(playerid); doesn't work, direct assignment isn't supported
name = PlayerName(playerid);

The compiler again allocates extra space for the string returned from PlayerName (always on the heap), before it moves it to name. Therefore, the array has to be unnecessarily copied twice before it is usable.

As you can see, returning arrays has some significant drawbacks, but it is still useful in some cases, when you are cautious.

pawn Code:

format(string, sizeof string, "Your name is %s.", PlayerName(playerid));

This is the intended usage of returning arrays – as temporary arguments to other functions. In all other cases, using a normal output parameter is safer and faster. In this case, no extra copying happens at the caller's site.

PlayerName itself can be "fixed" to return the string directly without unnecessary copying, via in-line assembly:

pawn Code:

forward [MAX_PLAYER_NAME + 1]PlayerName(playerid);
stock PlayerName(playerid)
{
    #assert MAX_PLAYER_NAME + 1 == 25
    #emit PUSH.C 25 // size parameter of GetPlayerName
    #emit PUSH.S 16 // secret return parameter of PlayerName at address 16 (&playerid + 4)
    #emit PUSH.S playerid // equal to 12
    #emit PUSH.C 12 // number of bytes passed to the function (4 * 3 arguments)
    #emit SYSREQ.C GetPlayerName // calling the function
    #emit STACK 16 // cleanup of the arguments from the stack
    #emit RETN
}

This way, PlayerName does no extra copying, passing the secret return address directly to GetPlayerName.

PawnPlus strings
Dynamic strings in PawnPlus offer the flexibility and convenience of normal values, since they are passed around as references.

pawn Code:

stock String:Func()
{
    return str_new("abc");
}

The string can be returned from functions, passed to other functions or even to native functions, inspected, or modified, and all of this without any additional copying.

Constant strings
All the previous methods are suitable for strings that are produced at runtime, but for constant strings, I'd advise against using any of them. Use macros instead.

pawn Code:

new const _tips[][] = {
    "Tip one",
    "Tip two",
    "Tip three",
    "Tip four"
};
#define RandomTip() (_tips[random(sizeof _tips)])

Using this in functions like SendClientMessage requires no string copying at all, since the address of the string is used directly. You can also afford to use variable-length strings in the array, resulting in a little more efficient storage.

[Tutorial] How to make a simple server time system

Fri, 15 Feb 2019 21:38:00 +0000

Hello this is my first tutorial Iam just gonna explain this fast (if there's anybody who needs this). This tutorial is about time on your server (not weather), how to make the server to automatically set the server time as the clock on your server...?

First you need to make a timer that will set server time every 1 hour (if you have a payday sistem which repeats every hour you can just put everything there):

Code:

forward Time(); // you should put this timer with the other timers in you server but it is not really important
public Time()
{
    // This is what will happen when timer's time run out
}

Second you need to get your server (clock) time inside that timer like this:

Code:

forward Time();
public Time()
{
    new h; // here we make a new variable in which we will store that time we get from server
    gettime(h); // here we store it to variable 'h'
}

Then we need to put server time as the variable 'h', but if in your country currently is winter probbably it is night at like 6 o'clock so you can make that too like this:

Code:

forward Time();
public Time()
{
    new h; 
    gettime(h); 
    if(h == 18 || h == 19) // here we check if it is 19h or 18h if it is we will set the world time to current time plus 5 hours so it will be night and so we are goin on with this below
    {
         SetWorldTime(h+5);
    }
    else if(h == 20 || h == 21)
    {
        SetWorldTime(h+4);
    }
    else if(h == 22 || h == 23)
    {
        SetWorldTime(h+2);
    }
    else   // here we check if current time is not 18,19,20,21,22,23 (everything that we haven't specified before) and if time is like 9h AM it will set your world time to 9
    {
        SetWorldTime(h);
    }
}

And one last thing is to actually set the timer and make it repeating every 1h (put this in your on gamemode init so it will be set as server is started):

Code:

SetTimer("Time", 3600000, true); // this is setting the public timer which you made before, 3600000 is the one hour in milliseconds and true means that timer will be repeated every time when interval get to 0 and your interval is 1hour (3600000)

This is my first tutorial and I haven't spend much time on it so don't hate a lot. And if there's mistakes type below

[Tutorial] Using the ternary operator :?

Wed, 23 Jan 2019 14:35:00 +0000

Ternary operator

Ahoy everyone.
This time i'll show you guys how to use the ternay operator given by many languages like C or PAWN.
This time we will only talk about the condititonal operator to replace if-statements. There are also ways to perform other actions using nested ternary operator statements.

It is commonly referred as the conditional operator. An expression x ? y : a evaluates to y if the value of x is true, and otherwise to a.

Brief example, comparing 2 numbers using if-statement.

Code:

new result;
new a=1;
new b=0;

if (a > b) 
{
    result = x;
}
else 
{
    result = y;
}

Using our beloved ternary operator makes it much simplier and shorter, and that's it..

Code:

result = a > b ? x : y;
result = a < b ? printf("a is less") : printf("a is greater");

... but not in any case.

Now some examples from my gamemodes, in this case my spectate system to spectate a random player.
Using if-statement.

Code:

    if(!tmp) return INVALID_PLAYER_ID;
    if(idx>tmp) idx=0;
    if(idx<0) idx=tmp-1;
    return randoms[idx];

Using ternary operator it looks like that.
Unfortunately not any statements are appropriate to be written using ternary operators like this one.
It might look quite weird.

Code:

return (!tmp) ? INVALID_PLAYER_ID : randoms[(idx>tmp)?0:((idx<0)?(tmp-1):idx)];

In conclusion that's a brief tutorial how you can use ternary operators.

Unfortunately we tend to get crappy using ternary operators excessively.
It will be complicated to maintain code using ternaries especially for beginners.
You have to consider when to use it and not.
It might be useful to increase the readability of your code, but in other cases it might do the contrary.

So just use it when really necessary.

For now that's it, but during the next days i'll introduce some more advanced examples using the ternary operator in PAWN.

[Tutorial] How to open shops interiors! and make a system!

Fri, 28 Dec 2018 19:41:00 +0000

Hi This is my first tutorial in this tutorial i am going to show you how do you can open shop interior.
Shops interiors coord,ids from here: http://weedarr.wikidot.com/interior pickups ids from here:http://weedarr.wikidot.com/pickups weapons ids from here:https://sampwiki.blast.hk/wiki/Weapons

You'll need to type /save in game to create a enter pickup for the shops also for the exit
and you'll find it in documents/GTA SAN ANDREAS USER FILES/SAMP/savedpositions
Let's begin
You'll need to add a pickup like this

Code:

// The entry pickup
new AmmuPickupEntry;

// The exit pickup
new AmmuPickupExit;

public OnGameModeInit() {
    // 1318 is the pickup model ID, followed by the coordinates in the world
    AmmuPickupEntry = CreatePickup(1318, 1, 1367.8782, -1279.7295, 13.5469);

    // And this is the exit pickup that exists inside the store
    AmmuPickupExit = CreatePickup(1318, 1, 285.3757, -41.3928, 1001.5156);
}

Step 2:
Now the pickups is created sucessfully now we will need to make what players will be teleported to if he stand on the pickups

Code:

You'll need to go to OnPlayerPickUpPickUp
}
	if(pickupid == ammupickupentry)//LS Enter ammu market the pickup that we've created
 	{
 	    SetPlayerPos(playerid, 286.1017,-41.8042, 1001.5156);// if the player stand on it he gets teleported to ammu coord
 	    SetPlayerInterior ( playerid, 1 );// and we set him into ammu-natioin id you can get both of this in http://weedarr.wikidot.com/interiornl69d...2.94231007 	}
 	if(pickupid == ammuoutpickupexit)//LS exit ammu market the exit pickup that we've created 
 	{
 	    SetPlayerPos(playerid, 1364.8909,-1279.5602,13.5469);// if the player stand on it he gets teleported to out of ammu you can teleport him the place that you want by /save  
 	    SetPlayerInterior (playerid, 0);// here we get the player out of interior by setting his interior to 0
 	}

Step 3:
Now it's done and players can gets into the ammu-nation!
Let's add a checkpoint by entering it let them buy weapons!

Code:

We will have to add
new ammuCP;// you can add it before ongamemodeinit
Now we go to the ammu-nation type /save in the place that we want to put the Checkpoint
After that we go to OnGamodeinit
ammuCP= CreateDynamicCP(296.6336,-38.0615,1001.5156,2,-1,-1,-1);// now we've created the cp Just put your X,y,z dont touch anything else
After that go to your dialog defines!
type
#Define DIALOG_AMMU 788// if you have this in your gamemode so change it to another id
After that go to OnPlayerEnterDynamicCP
}
	if(checkpointid == ammuCP)// now we will create what happens if player enter this checkpoint dialog will appear i've just added few Weapons you can add what you want
	{
		format(str, 956, "Sawn-off\nCombat Shotgun.nMicro SMG\nMP5\nAK47\nM4\nTec9\nSniper Rifle\nDetonator\nDesert Eagle\nBody Armour\nMinigun\n");
 		ShowPlayerDialog(playerid, DIALOG_AMMU, DIALOG_STYLE_LIST, "{FF0000}Ammu-Nation", str, "Confirm", ".: Close :.");
 	}
The Pickups is done also the Checkpoint also the Dialog

Step 4:
So now we'll go to OnDialogResponse

Code:

if(dialogid == DIALOG_AMMU)
	{
	    if(response)
	    {
	        if(listitem == 0)// Sawn-off
			{
			    if(GetPlayerMoney(playerid) < 12000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");// We will check if the player have 12k to buy sawn-off if he dont have, we will send him message! that he cant buy it
   				GivePlayerWeapon(playerid, 26, 100);// this function is used to giveplayerweapon(playerid, 26 is the weapon id, 100 is the ammo
       			GivePlayerMoney(playerid, -12000);// now we will take from the player 12k
          		GameTextForPlayer(playerid,"~r~-12000~g~$",5000,1);// this is a gametext for player will appear when he buy sawn-off
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Sawnoff Shotgun");//a message will appear

			}
			if(listitem == 1)//Combat Shotgun
			{
			    if(GetPlayerMoney(playerid) < 10000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 27, 50);
       			GivePlayerMoney(playerid, -10000);
          		GameTextForPlayer(playerid,"~r~-10000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Combat Shotgun");
   			}
   			if(listitem == 2)//Micro SMG
   			{
   			    if(GetPlayerMoney(playerid) < 6000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 28, 400);
       			GivePlayerMoney(playerid, -6000);
          		GameTextForPlayer(playerid,"~r~-6000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Micro SMG");
   			}
   			if(listitem == 3)//MP5
   			{
   			    if(GetPlayerMoney(playerid) < 15000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 29, 300);
       			GivePlayerMoney(playerid, -15000);
          		GameTextForPlayer(playerid,"~r~-15000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: MP5");
			}
			if(listitem == 4)// M4
			{
                if(GetPlayerMoney(playerid) < 20000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 30, 600);
       			GivePlayerMoney(playerid, -20000);
          		GameTextForPlayer(playerid,"~r~-20000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: M4");
   			}
   			if(listitem == 5)//tec9
   			{
   			    if(GetPlayerMoney(playerid) < 4000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 32, 500);
       			GivePlayerMoney(playerid, -4000);
          		GameTextForPlayer(playerid,"~r~-4000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Tec9");
			}
			if(listitem == 6)//Sniper Rifle
			{
			    if(GetPlayerMoney(playerid) < 15000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 34, 100);
       			GivePlayerMoney(playerid, -15000);
          		GameTextForPlayer(playerid,"~r~-15000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Sniper Rifle");
   			}
   			if(listitem == 7)//Detonator
   			{
   			    if(GetPlayerMoney(playerid) < 25000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 40, 5);
       			GivePlayerMoney(playerid, -25000);
          		GameTextForPlayer(playerid,"~r~-25000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Detonator");
 			}
   			if(listitem == 8)//Desert eagle
   			{
   			    if(GetPlayerMoney(playerid) < 20000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 24, 300);
       			GivePlayerMoney(playerid, -20000);
          		GameTextForPlayer(playerid,"~r~-25000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Desert Eagle");
			}
			if(listitem == 9)//body armour
			{
   				if(GetPlayerMoney(playerid) < 2000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				SetPlayerArmour(playerid, 100);
				GameTextForPlayer(playerid,"~r~-2000~g~$",5000,1);
				SendClientMessage(playerid, 0x22B998AA,"You Bought: Body Armour");
			}
			if(listitem == 10)//Minigun
			{
			    if(GetPlayerMoney(playerid) < 150000) return SendClientMessage(playerid, COLOR_RED, "Error: {FFFFFF} You don't have enough money!");
   				GivePlayerWeapon(playerid, 38, 20);
       			GivePlayerMoney(playerid, -150000);
          		GameTextForPlayer(playerid,"~r~-150000~g~$",5000,1);
   				SendClientMessage(playerid, 0x22B998AA,"You Bought Weapon: Minigun");
				return 1;
			}
		}
	}

This was my first tutorial here i hope i can have time making more tutorials!
Give Feedbacks!
Also if there's something i didn't explain you can tell me in the comments i will edit it asap!
Note: you dont have to use the same colors that i've typed you can use your own colors in your gamemode that you've defined

[Tutorial] "Goes To" operator: -->

Thu, 27 Dec 2018 14:27:00 +0000

Goes To

Just a brief tutorial to tell people about the “goes to” operator: -->. The arrow design is to show it goes towards the number, thus it decrements a variable until it reaches zero, and can be used in loops to loop a number of times. Mainly the while loop:

Code:

new i = 10;
while (i --> 0)
{
    printf("%d", i);
}

Will print:

9
8
7
6
5
4
3
2
1
0

Note that 10 is not included, while 0 is. This makes it like normal loops, but backwards.

You can loop over players backwards with:

Code:

for (new i = MAX_PLAYERS; i --> 0; )
{
}

Technically you can go down to any value:

Code:

new j = 10;
while (j --> 5) {}

And yes, if you haven’t figured it out yet, this isn’t actually a new operator. It is two operators (-- and >) with odd spacing. That last example would be more normally written as:

Code:

new j = 10;
while (j-- > 5) {}

I first saw this here: https://stackoverflow.com/questions/...-operator-in-c so though I’d write it here. It is stupid, don't use it...