Последняя версия: 0.2.2.3 (Июль 2016)

От меня: Я видел много аналогов в плагинах, в том числе те, которые были написаны на ассемблере, хакали память сервера и т.д. Но по моему самым надёжным был и будет тот самый zcmd. Это немного улучшенный, обновленный вариант под теперешние требования, и намного быстрее оригинала.
Автор сего творения: Yashas; Оригинал: click
Опубликовано с разрешения автора.
ZCMD не обновлялся в течение последних 6 лет. Мы многого достигли за эти годы, но эти достижения не были реализованы в ZCMD. Я просто переписал ZCMD 0.3.1 и обновил его. Теперь он намного быстрее, чем ZCMD, что делает этот Командный Процессор самым быстрым на данный момент. Результаты тестов скорости приведены в конце этой темы.

Наиболее значимые улучшения эффективности могут наблюдаться, когда Вы используете маленькие команды (команды, которые не сильно нагружают CPU). Если вы используете только один format в вашей команде, I-ZCMD будет почти в 2 раза быстрее, чем ZCMD. Если вы вызываете 10 (функций?) format из вашей команды, I-ZCMD будет в 1.5 раза быстрее ZCMD. Основная причина того, почему I-ZCMD гораздо быстрее по сравнению с ZCMD в том, что I-ZCMD избавилось от вызова двух CallLocalFunction (очень медленных функций).

Изменения относительно ZCMD:
OnPlayerCommandReceived и OnPlayerCommandPerformed теперь вызываются напрямую, вместо использования CallLocalFunction
Убраны Перехваты OnGameModeInit/OnFilterscriptInit
Сделана небольшая оптимизация
Чувствительность к регистру символов теперь можно включать/выключать, используя define

Как установить?
Тем, кто уже использует ZCMD, нужно просто скачать include I-ZCMD и заменить им свой include ZCMD. Никаких изменений в функциональности, все изменения влияют только на скорость и эффективность работы скрипта. Единственная новая возможность в I-ZCMD, это настройка чувствительности к регистру через define IZCMD_ENABLE_CASE_SENSITIVITY перед подключением IZCMD. По умолчанию чувствительности к регистру нет (ZCMD не чувствителен к регистру)

Для тех, кто не использует ZCMD: вам нужно скачать I-ZCMD и закинуть в вашу папку include. Любой мануал по ZCMD также применим и к I-ZCMD, т.к. синтаксис у них одинаков.

Как использовать?
Если вы знаете, как использовать ZCMD, значит вы знаете, как использовать и I-ZCMD тоже. В таком случае вы можете пропустить этот пункт.

Чтобы создать команду, все, что вам нужно, это создать public функцию, используя любой из приведенных вариантов.

Код:
COMMAND:yourcommand(playerid,params[])
{
return CMD_SUCCESS;
}
CMD:yourcommand(playerid,params[])
{
return CMD_SUCCESS;
}
command(yourcommand,playerid,params[])
{
return CMD_SUCCESS;
}
cmd(yourcommand,playerid,params[])
{
return CMD_SUCCESS;
}
Когда игрок введёт "/yourcommand параметры", будет вызвана public функция. Параметр playerid будет иметь id игрока, который использовал команду, и params[] - параметры, в которых будет текст, что игрок ввёл после ввода команды (Так, params[] будет содержать в себе "параметры").

Параметр "params" никогда не будет пустым. Если игрок не введёт никаких параметров, то params[0] будет равен '\1'.

Вы должны возвращать CMD_SUCCESS, если команда выполнилась успешно, иначе CMD_FAILURE. Этот результат будет передан в OnPlayerCommandPerformed. Вы также можете использовать стиль возвращения ZCMD, то есть: 1 для успешного выполнения и любое другое значение для отказа.

Вы не можете использовать OnPlayerCommandText, когда вы подключаете этот include. Он не будет вызываться, если вы до сих пор используете его в своём коде. Вместо этого есть два новых обратных вызова.

OnPlayerCommandReceived
Этот callback вызывается перед тем, как будет вызвана функция команды.

Параметры:
playerid - ID игрока, который использовал команду
cmdtext - текст, который ввёл игрок

Возвращаемые значения:
1 - функция команды будет вызвана
0 - функция команды не будет вызвана.

Код:
public OnPlayerCommandReceived(playerid,cmdtext[])
{
return 1;
}
OnPlayerCommandPerformed
Этот callback вызывается после того, как функция команды выполнится.

Параметры:
playerid - ID игрока, который использовал команду
cmdtext - текст, который ввёл игрок
success - то, что вернула функция команды (CMD_SUCCESS или CMD_FAILURE)

Возвращаемые значения:
0 или CMD_FAILURE - Игрок увидит Сообщение об Ошибке, т.е. "Unknown command"
1 или CMD_SUCCESS - Сообщения об ошибке выслано не будет

Код:
public OnPlayerCommandPerformed(playerid,cmdtext[], success)
{
return success;
}

Если вы не используете OnPlayerCommandPerformed, то возвращаемое значение в функции вашей команды будет решать, отправлять ли Сообщение об Ошибке или нет.
Возвращение 0 или CMD_FAILURE в функции команды будет значить отправку сообщения об ошибке.
Возвращение 1 или CMD_SUCCESS в функции команды будет значить, что сообщение об ошибке отправлено не будет.

Чувствительность к регистру
Чувствительность к регистру отключена по умолчанию, что означает, что "/pm" и "/PM" будет одним и тем же. Чувствительность к регистру может быть включена добавлением дефайна IZCMD_ENABLE_CASE_SENSITIVITY перед подключением izcmd в вашем скрипте.

Советы и хитрости

1. Вызывайте функции команд вручную
Вы можете вызывать функцию команды используя следующий код.

Код:
cmd_yourcommand(playerid,params);
Вы должны использовать префикс "cmd_" в вашей функции команды для её вызова.

2. Сокращённые команды
Вы можете создавать сокращённые команды используя приведённую идею ниже.

Код:
COMMAND:arrest(playerid,params[])
{
//ваш код команды arrest
return CMD_SUCCESS;
}
COMMAND:ar(playerid,params[])
{
return cmd_arrest(playerid,params);
}
3. Отключение команд, если игрок не залогинен
Вы можете отключить команды для тех игроков, которые не вошли, используя следующее решение.

Код:
public OnPlayerCommandReceived(playerid,cmdtext[])
{
if(!PlayerLoggedIn[playerid])
{
SendClientMessage(playerid,-1,"Вы должны войти в систему, чтобы использовать любые команды");
return 0;
}
return 1;
}
4. I-ZCMD вместе с sscanf - самый быстрый способ обработки команд

Код:
COMMAND:setskin(playerid,params[])
{
new skinid;
if(sscanf(params,"i",skinid)) SendClientMessage(playerid,-1,"Использование: /setskin [skinid]");
else SetPlayerSkin(playerid, skin);
return CMD_SUCCESS;
}
Больше примеров
Код:
COMMAND:getvid(playerid,params[])
{
new id,string[144],vid;
if(sscanf(params,"u",id))
{
if(IsPlayerInAnyVehicle(playerid))
{
vid = GetPlayerVehicleID(playerid);
format(string,sizeof(string),"ID вашей машины: %d. Используйте /getvid [Name/ID], чтобы узнать ID машины других игроков.",vid);
return SendClientMessage(playerid,-1,string);
}
return SendClientMessage(playerid,-1,"Вы должны находиться в машине. Используйте /getvid [Name/ID], чтобы узнать ID машины.");
}
if(IsPlayerConnected(id))
{
if(IsPlayerInAnyVehicle(id))
{
new pName[MAX_PLAYER_NAME];
GetPlayerName(playerid,pName,MAX_PLAYER_NAME);
vid = GetPlayerVehicleID(id);
format(string,sizeof(string),"Игрок %s(%d) использует %d ID машины.",pName,id,vid);
SendClientMessage(playerid,-1,string);
}
else
{
SendClientMessage(playerid,-1,"Указанный игрок не в машине.");
}
}
else { return SendClientMessage(playerid,-1,"Использование: /getvid:Invalid Player ID"); }
}
return CMD_SUCCESS;
}
Тесты скорости
Код теста имеет около 250 тестовых команд, из которых вызывается 6 существующих и одна несуществующая команда.

Код, который был использован для тестов скорости, может быть найден здесь.

y_commands took 1231ms on average
ZCMD took 1201ms on average
I-ZCMD (Non-case-sensitive) took 547ms on average
I-ZCMD (Case-sensitive) took 353ms on average

I-ZCMD (Case-Sensitive) is 3.40 times faster than ZCMD
I-ZCMD (Case-Sensitive) is 3.49 times faster than y_commands

I-ZCMD (Non-Case-Sensitive) is 2.20 times faster than ZCMD
I-ZCMD (Non-Case-Sensitive) is 2.25 times faster than y_commands

ZCMD is 1.02 times faster than y_commands

Пожалуйста, заметьте, если вам нужна любая из возможностей y_command - используйте y_commands. Если вы попытаетесь реализовать подобные возможности в iZCMD, iZCMD, скорее всего, будет медленнее, чем y_commands. Используйте iZCMD если и только если вы не используете никаких возможностей y_command.
Благодарности
Zeex за оригинальный Include ZCMD и концепцию/алгоритм.
Yashas за потраченные 60 минут на обновление.
Nexius за перевод темы на русский язык.

---

Скриншоты:

---

ВНИМАНИЕ!

Мы настоятельно рекомендуем вам, проверить файлы VIRUS Total

Для скачивания авторизуйтесь