Fast Player Commands (FPC)
FPC ist eine art Makro die es ermöglicht Befehle schneller auszuführen und dank sscanf können wir sogar die einzelnen Parameter auslesen.
Es gibt nicht viel dabei zu erklären, es ist ein einfaches Makro das viel viel kürzer ist wie zb. dcmd und ihr müsst nicht kein extra dcmd_ thread hinzufügen, ihr könnt alles in dem Callback erledigen.
Das ganze ist Resourcen sparender als strtok, strrest, dcmd_...
Die groß und kleinschreibung wird für jedem befehl nicht beachtet, ihr könnt also alle befehle mit CAPSLOCK oder ganz klein schreiben, es macht kein unterschied wenn ihr diesen Befehl ingame eingibt.
Ihr benötigt lediglich die sscanf funktion von Y_Less.
In eurem Filterscript / Gamemode könnte dass ganze dann so aussehen:
public OnPlayerCommandText(playerid, cmdtext[])
{
if(Command("/KickEx"))
{
new pid, kickreason[128];
if(sscanf(cmdtext, "uz", pid, kickreason)) return SendClientMessage(playerid, COLOR_WHITE, "[Benutzung] /KickEx [Name/ID] [Reason]");
if(!IsPlayerConnected(pid)) return SendClientMessage(playerid, COLOR_WHITE, "Spieler wurde nicht gefunden.");
if(!strlen(kickreason)) kickreason[0] = '-'
format(str, sizeof(str), "Du wurdest vom server gekickt, grund: %s", kickreason);
SendClientMessage(pid, COLOR_RED, str);
Kick(pid);
return 1;
}
return 0;
}
Die einzelnen befehle müssen wohl nicht erklärt werden, die dürften euch ja klar sein ;).
Wer die sscanf befehle nicht kennt:
- u - Hiermit könnt ihr die Spielerid raufinden *
- c - Ein Char
- d, i - Ein Zahlenwert KEIN FLOAT!
- h, x - Ein Hex-wert
- f - Ein Floatwert
- s - Ein einzelner String
- z - Der Restliche string **
- pX - An additional delimiter where X is another character. // Keine ahnung
- '' - Encloses a litteral string to locate. // Keine ahnung
* Wenn ihr zb ein /kick befehl habt und ihr wollt den spieler mit /kick Spieler kicken, könnt ihr ein teil des namens angeben, falls mehrer den gleichen eingegeben part haben wird INVALID_PLAYER_ID (0xFFFF) zurückgegeben, angemommen der User heißt Momo5000 (ID: 0) und wollen ihn kicken, wir haben nun 3 varianten zu verfügung:
/kick Momo
/kick Momo5000
/kick 0
** z sollte immer am ende eingesetzt werden da es alle restlichen parameter als string zurück gibt.
Wie könnt ihr FPC benutzen? ganz einfach, ihr fügt diesen Define unter den includes ein.
#define Command(%1) (!strcmp(cmdtext, %1, true, strlen(%1)) && strdel(cmdtext, 0, strlen(%1) + 1) == true)
Und zu guter letzt fügt ihr den Sscanf stock von Y_Less ganz untem im script ein:
/*
* @Function: sscanf(string[], format[], {Float,_}:...)
* @Info: Used to get the command params
*/
stock sscanf(string[], format[], {Float,_}:...)
{
#if defined isnull
if (isnull(string))
#else
if (string[0] == 0 || (string[0] == 1 && string[1] == 0))
#endif
{
return format[0];
}
#pragma tabsize 4
new
formatPos = 0,
stringPos = 0,
paramPos = 2,
paramCount = numargs(),
delim = ' ';
while (string[stringPos] && string[stringPos] <= ' ')
{
stringPos++;
}
while (paramPos < paramCount && string[stringPos])
{
switch (format[formatPos++])
{
case '\0':
{
return 0;
}
case 'i', 'd':
{
new
neg = 1,
num = 0,
ch = string[stringPos];
if (ch == '-')
{
neg = -1;
ch = string[++stringPos];
}
do
{
stringPos++;
if ('0' <= ch <= '9')
{
num = (num * 10) + (ch - '0');
}
else
{
return -1;
}
}
while ((ch = string[stringPos]) > ' ' && ch != delim);
setarg(paramPos, 0, num * neg);
}
case 'h', 'x':
{
new
num = 0,
ch = string[stringPos];
do
{
stringPos++;
switch (ch)
{
case 'x', 'X':
{
num = 0;
continue;
}
case '0' .. '9':
{
num = (num << 4) | (ch - '0');
}
case 'a' .. 'f':
{
num = (num << 4) | (ch - ('a' - 10));
}
case 'A' .. 'F':
{
num = (num << 4) | (ch - ('A' - 10));
}
default:
{
return -1;
}
}
}
while ((ch = string[stringPos]) > ' ' && ch != delim);
setarg(paramPos, 0, num);
}
case 'c':
{
setarg(paramPos, 0, string[stringPos++]);
}
case 'f':
{
new changestr[16], changepos = 0, strpos = stringPos;
while(changepos < 16 && string[strpos] && string[strpos] != delim)
{
changestr[changepos++] = string[strpos++];
}
changestr[changepos] = '\0';
setarg(paramPos,0,_:floatstr(changestr));
}
case 'p':
{
delim = format[formatPos++];
continue;
}
case '\'':
{
new
end = formatPos - 1,
ch;
while ((ch = format[++end]) && ch != '\'') {}
if (!ch)
{
return -1;
}
format[end] = '\0';
if ((ch = strfind(string, format[formatPos], false, stringPos)) == -1)
{
if (format[end + 1])
{
return -1;
}
return 0;
}
format[end] = '\'';
stringPos = ch + (end - formatPos);
formatPos = end + 1;
}
case 'u':
{
new
end = stringPos - 1,
id = 0,
bool:num = true,
ch;
while ((ch = string[++end]) && ch != delim)
{
if (num)
{
if ('0' <= ch <= '9')
{
id = (id * 10) + (ch - '0');
}
else
{
num = false;
}
}
}
if (num && IsPlayerConnected(id))
{
setarg(paramPos, 0, id);
}
else
{
#if !defined foreach
#define foreach(%1,%2) for (new %2 = 0; %2 < MAX_PLAYERS; %2++) if (IsPlayerConnected(%2))
#define __SSCANF_FOREACH__
#endif
string[end] = '\0';
num = false;
new
name[MAX_PLAYER_NAME];
id = end - stringPos;
foreach (Player, playerid)
{
GetPlayerName(playerid, name, sizeof (name));
if (!strcmp(name, string[stringPos], true, id))
{
setarg(paramPos, 0, playerid);
num = true;
break;
}
}
if (!num)
{
setarg(paramPos, 0, INVALID_PLAYER_ID);
}
string[end] = ch;
#if defined __SSCANF_FOREACH__
#undef foreach
#undef __SSCANF_FOREACH__
#endif
}
stringPos = end;
}
case 's', 'z':
{
new
i = 0,
ch;
if (format[formatPos])
{
while ((ch = string[stringPos++]) && ch != delim)
{
setarg(paramPos, i++, ch);
}
if (!i)
{
return -1;
}
}
else
{
while ((ch = string[stringPos++]))
{
setarg(paramPos, i++, ch);
}
}
stringPos--;
setarg(paramPos, i, '\0');
}
default:
{
continue;
}
}
while (string[stringPos] && string[stringPos] != delim && string[stringPos] > ' ')
{
stringPos++;
}
while (string[stringPos] && (string[stringPos] == delim || string[stringPos] <= ' '))
{
stringPos++;
}
paramPos++;
}
do
{
if ((delim = format[formatPos++]) > ' ')
{
if (delim == '\'')
{
while ((delim = format[formatPos++]) && delim != '\'') {}
}
else if (delim != 'z')
{
return delim;
}
}
}
while (delim > ' ');
return 0;
}
Bugs könnt ihr gerne reporten, ich versuche diese dann zu beheben, so viel spaß beim scripten nun 
Edit: Sinnloses Include entfernt.
die playerid von sich selbst oder von jemanden 
.
C&P merkt man direkt, du musst nicht abfragen ob jemand Connected ist oder nicht