[Tutorial] How to make a /cuff and /uncuff command.

[TaLhA XIV]

Okay in this tutorial you will learn that how to make a /cuff and a /uncuff command.

Okay first:
Include these files.

PHP Code:

#include <a_samp>
#include <zcmd>
#include <sscanf2> 


Okay now here are the full codes and I have explained them in the script:

PHP Code:

CMD:cuff(playerid, params[])//This is will create you cmd so you can continue your codes.
{
    new targetid;//this defines the id of the player you want to cuff((playerid id your id and the target id that I defined it the id of the player you want to cuff))
    if(sscanf(params, "u", targetid)) return SendClientMessage(playerid, -1, "[USAGE]: /cuff [Part of Name/Player ID]");
    if(IsPlayerConnected(targetid))//this will check that if the player you want to cuff is connected to the server or not.
        {
            new Float:x, Float:y, Float:z;//these are the defines of your x,y and z position.
               GetPlayerPos(playerid, x, y, z);//this will store your position to be used in the following codes.((this stores the your x,y, and z position in to the variables we created.))
               if(IsPlayerInRangeOfPoint(targetid, 5.0, x, y, z))//this will check that if the player you want to cuff is near you or not.
                   {
                    new str[512];//this it the define for the string you will format further.((str means string.You can also change it to string but this seems to be easy.))
                      new name[MAX_PLAYER_NAME];//this is the variable you created to store the your name.
                    GetPlayerName(playerid, name, sizeof(name));//this will get your name and store it in the variable you defines as name.
                    new target[MAX_PLAYER_NAME];//this is the variable you created to store the name of the player you want to cuff.
                       GetPlayerName(targetid, target, sizeof(target));//this will get the name of the person you want to cuff and will store it into a variable we defined as target.
                       format(str, sizeof(str), "INFO: You have cuffed %s!",target);//explained at the end of the tutorial.
                       SendClientMessage(playerid, 0xE01B1B, str);//this will send the formated message to you that you created before.
                       format(str, sizeof(str), "WARNING: You have been cuffed by %s!",name);//explained at the end of the tutorial.
                       SendClientMessage(targetid, 0xE01B1B, str);//this will send the formated message to the player you cuffed.
                    SetPlayerAttachedObject(targetid, 0, 19418, 6, -0.011000, 0.028000, -0.022000, -15.600012, -33.699977,-81.700035, 0.891999, 1.000000, 1.168000);//this will set the object cuffs at the hand of the player you want to cuff.
                      SetPlayerSpecialAction(targetid,SPECIAL_ACTION_CUFFED);//this will set players hand backwards.
                      return 1;
                }

        }
    return 1;
}

CMD:uncuff(playerid, params[])//sfcs cmd.
{

        new targetid;//this defines the id of the player you want to cuff((playerid id your id and the target id that I defined it the id of the player you want to cuff))
        if(sscanf(params, "u", targetid)) return SendClientMessage(playerid, -1, "[USAGE]: /uncuff [Part of Name/Player ID]");
        if(IsPlayerConnected(targetid))//this will check that if the player you want to cuff is connected to the server or not.
        {
            new Float:x, Float:y, Float:z;//these are the defines of your x,y and z position.
               GetPlayerPos(playerid, x, y, z);//this will store your position to be used in the following codes.((this stores the your x,y, and z position in to the variables we created.))
               if(IsPlayerInRangeOfPoint(targetid, 5.0, x, y, z))//this will check that if the player you want to cuff is near you or not.
                   {
                    if(!SetPlayerAttachedObject(targetid, 0, 19418, 6, -0.011000, 0.028000, -0.022000, -15.600012, -33.699977,-81.700035, 0.891999, 1.000000, 1.168000))return SendClientMessage(playerid,-1,"ERROR: The player is not cuffed!");//this will check that if the player is not cuffed and you are trying to apply this cmd,this will send him a error message.
                      SetPlayerSpecialAction(targetid,SPECIAL_ACTION_NONE);//this will remove the players cuffs and his arms will go normal.
                    new str[512];//this it the define for the string you will format further.((str means string.You can also change it to string but this seems to be easy.))
                      new name[MAX_PLAYER_NAME];//this is the variable you created to store the your name.
                    GetPlayerName(playerid, name, sizeof(name));//this will get your name and store it in the variable you defines as name.
                    new target[MAX_PLAYER_NAME];//this is the variable you created to store the name of the player you want to cuff.
                       GetPlayerName(targetid, target, sizeof(target));//this will get the name of the person you want to cuff and will store it into a variable we defined as target.
                       format(str, sizeof(str), "INFO: You have uncuffed %s!",target);//explained at the end of the tutorial.
                       SendClientMessage(playerid, 0xE01B1B, str);//will send the formated message to you that you created above.
                       format(str, sizeof(str), "WARNING: You have been uncuffed by %s!",name);//explained bellow.
                       SendClientMessage(targetid, 0xE01B1B, str);//will send the formated message to the player you want to cuff that you created above.
                      return 1;
                }

        }
        return 1;
} 


Now the lines I haven't explained in the script.

PHP Code:

if(sscanf(params, "u", targetid)) return SendClientMessage(playerid, -1, "[USAGE]: /uncuff [Part of Name/Player ID]"); 


for more info about sscanf,use this.:
http://forum.sa-mp.com/showthread.php?t=120356

This will check that if a player enter a invalid information,if it is a invalid information,it will send him an error message.

PHP Code:

format(str, sizeof(str), "INFO: You have cuffed %s!",target);//explained at the end of the tutorial. 


format is used for formatting messages that you want to send to other people or to yourself.
for more info go here:
http://wiki.sa-mp.com/wiki/Format

[Landon]

Nice tut mate

[MoDee]

Thanks mate

[TaLhA XIV]

Originally Posted by Michael23

Nice tut mate

Thanks

Originally Posted by MoDee

Thanks mate

Thanks

[Mellnik]

nice tut, but change "u" to "r" by sscanf or do you want that bots can be cuffed^^

[TaLhA XIV]

Originally Posted by Mellnik

nice tut, but change "u" to "r" by sscanf or do you want that bots can be cuffed^^

nah avoid that.

[Jack_Leslie]

Instead of checking if the player has the object attached to them, I recommend you checking if their special action is cuffed, much more efficient in my opinion.

[[ABK]Antonio]

Originally Posted by TaLhA XIV

CMD:cuff(playerid, params[])//This is will create you cmd so you can continue your codes.
{
    new targetid;//this defines the id of the player you want to cuff((playerid id your id and the target id that I defined it the id of the player you want to cuff))
    if(sscanf(params, "u", targetid)) return SendClientMessage(playerid, -1, "[USAGE]: /cuff [Part of Name/Player ID]");
    if(IsPlayerConnected(targetid))//this will check that if the player you want to cuff is connected to the server or not.
        {
            new Float:x, Float:y, Float:z;//these are the defines of your x,y and z position.
            GetPlayerPos(playerid, x, y, z);//this will store your position to be used in the following codes.((this stores the your x,y, and z position in to the variables we created.))
            if(IsPlayerInRangeOfPoint(targetid, 5.0, x, y, z))//this will check that if the player you want to cuff is near you or not.
                {
                    new str[512];//this it the define for the string you will format further.((str means string.You can also change it to string but this seems to be easy.))
                    new name[MAX_PLAYER_NAME];//this is the variable you created to store the your name.
                    GetPlayerName(playerid, name, sizeof(name));//this will get your name and store it in the variable you defines as name.
                    new target[MAX_PLAYER_NAME];//this is the variable you created to store the name of the player you want to cuff.
                    GetPlayerName(targetid, target, sizeof(target));//this will get the name of the person you want to cuff and will store it into a variable we defined as target.
                    format(str, sizeof(str), "INFO: You have cuffed %s!",target);//explained at the end of the tutorial.
                    SendClientMessage(playerid, 0xE01B1B, str);//this will send the formated message to you that you created before.
                    format(str, sizeof(str), "WARNING: You have been cuffed by %s!",name);//explained at the end of the tutorial.
                    SendClientMessage(targetid, 0xE01B1B, str);//this will send the formated message to the player you cuffed.
                    SetPlayerAttachedObject(targetid, 0, 19418, 6, -0.011000, 0.028000, -0.022000, -15.600012, -33.699977,-81.700035, 0.891999, 1.000000, 1.168000);//this will set the object cuffs at the hand of the player you want to cuff.
                    SetPlayerSpecialAction(targetid,SPECIAL_ACTION_CUFFED);//this will set players hand backwards.
                    return 1;
                }

        }
    return 1;
}

Why 512 cells when we only need around 50-60?
Why two name variables when you only need one?
Why return after the special action when there's nothing else in the command and it would just return down the line?

[TaLhA XIV]

Wowow thanks for the suggestions but I did not tested it so thanks for that.

[David (Sabljak)]

Great Tutorial! Thanks

But ... maybe add this?

uncuff

RemovePlayerAttachedObject(playerid, 0);

and

When cuffed, you jump and fall

public OnPlayerKeyStateChange(playerid, newkeys, oldkeys)
{
if(newkeys & KEY_JUMP && !(oldkeys & KEY_JUMP) && GetPlayerSpecialAction(playerid) == SPECIAL_ACTION_CUFFED) ApplyAnimation(playerid, "GYMNASIUM", "gym_jog_falloff",4.1,0,1,1,0,0);
return 1;
}