DC_CMD v2.8 (23/03/14)

[Daniel_Cortez]

Всем привет.

За последнее время в паблик выкладывалось много разных командных процессоров.
Один самый быстрый командный процессор сменялся другим, шли споры, какой из них быстрее и т.д. и т.п.
Пришло время положить конец этим спорам.
Представляю вашему вниманию новый командный движок DC_CMD, реализованный в виде плагина.

Все команды обрабатываются в плагине, что ускоряет их выполнение, однако принцип работы схож с ZCMD.

Установка:

1. Файл dc_cmd.dll (или dc_cmd.so, если на хостинге) закинуть в папку "plugins", dc_cmd.inc - в папку "pawno/include".
2. В server.cfg в поле plugins добавить dc_cmd (на хостинге - dc_cmd.so)
3. После строки #include <a_samp> добавить подключение инклуда
   

   #include <dc_cmd> 

   Внимание: Если вы используете команды на DC_CMD в фильтрскрипте, не забудьте в самом верху кода указать #define FILTERSCRIPT.
   Выглядеть это должно примерно так:
   

   #define FILTERSCRIPT // сама строка
   
   #include <a_samp> // дальше - инклуды
   #include <dc_cmd> 

4. В моде создавать команды, как для ZCMD:
   

   // тестовая команда
   CMD:info(playerid, params[])
   {
       return SendClientMessage(playerid, -1, "Плагин dc_cmd успешно установлен.");
   } 

Функционал плагина:

1. Можно создавать команды с альтернативными именами 3 разными способами:
     Открыть/закрыть

   1. Макрос ALTX
      
       Описание

      
      Данным способом можно создавать любые альт. имена для команд (в т.ч. и русские).
      Использование:
      

      ALTX:<команда>(<альт. имена>);

      Здесь <альт. имена> - одно или несколько альт. названий для команды.
      Пример:
      

      CMD:help(playerid, params[])
      {
          // ...
      }
      ALTX:help("/info", "/помощь", "/инфо");
      
      CMD:menu(playerid, params[])
      {
          return ShowPlayerDialog(playerid, ...);
      }
      ALTX:menu("/меню"); 

      
      
   2. Функция RegisterAlt
      
       Описание

      
      

      RegisterAlt(оригинальная команда, команда на русском языке)

      RegisterAlt(оригинальная команда, команда на русском языке (1), команда на русском языке (2), команда на русском языке (3), ...)

      Пример:
      

      public OnGameModeInit()
      {
          RegisterAlt("/family", "/f");
          RegisterAlt("/help", "/info", "/hlp", "/помощь", "/h"); // теперь, если в игре набрать "/h" или "/помощь", будет вызвана команда /help
          //...
      } 

      
      
   3. Макрос ALT
      
       Описание

      
      Использование:
      

      ALT:<имя команды>:<имя альт. команды>;

      Пример: допустим, мы создали команду "/info" и нужно сделать сокращённый вариант "/i".
      Пример использования ALT:
      

      // тестовая команда
      CMD:info(playerid, params[])
      {
          return SendClientMessage(playerid, -1, "Плагин dc_cmd успешно установлен.");
      }
      ALT:info:i; // "/i" - альтернативный вариант для "/info" 

      
      

   
   На данный момент рекоментуется использовать 1-й способ. Остальные 2 оставлены лишь для совместимости с предыдущими версиями DC_CMD.
   
   
   
   
2. Коллбэки OnPlayerCommandReceived и OnPlayerCommandPerformed:
   
    Описание

   • OnPlayerCommandReceived:
     

     OnPlayerCommandReceived(playerid, cmdtext[]) 

     Вызывается перед обработкой команды. В ней можно указать условия выполнения команды.
     При этом с помощью return 1/0 можно разрешить/запретить выполнение команды.
     Пример:
     

     public OnPlayerCommandReceived(playerid, cmdtext[])
     {
         if(PlayerInfo[playerid][pMute] == 1) // если у игрока затычка (/mute)
         {
             SendClientMessage(playerid, -1, "Дождитесь окончания действия заглушки!");
             return 0; // передать плагину, чтобы он не выполнял команду
         }
         return 1; // разрешить выполнение команды
     } 

   • OnPlayerCommandPerformed:
     

     OnPlayerCommandPerformed(playerid, cmdtext[], success); 

     Вызывается после выполнения команды.
     При этом если success = 1 - команда выполнилась успешно, success = 0 - с ошибкой, success = -1 - команда не найдена.
     Таким образом можно самостоятельно сделать поддержку стандартных команд:
     

     public OnPlayerCommandPerformed(playerid, cmdtext[], success)
     {
         if(success == -1) // если команда не найдена
         {
             return OnPlayerCommandText(playerid, cmdtext);
         }
         return 1; // разрешить выполнение команды
     } 

     Либо можно сделать сообщение о несуществующей команде:
     

     public OnPlayerCommandPerformed(playerid, cmdtext[], success)
     {
         if(success == -1) // если команда не найдена
         {
             return SendClientMessage(playerid, -1, "Несуществующая команда. Используйте /help, чтобы узнать список команд сервера.");
         }
         return 1;
     } 

   
   
   
3. Вызов команд напрямую из мода:
   
    Описание

   
   В версии 2.02 был добавлен макрос "cmd::", благодаря которому можно удобно вызывать команды из любого места в моде.
   Пример использования:
   

   // без параметров
   cmd::help(playerid, "");
   
   // с параметрами
   new param_str[11]; // размер строки зависит от параметров
   format(param_str, sizeof(param_str), "%d", targetid);
   cmd::invite(playerid, param_str); 

   
   
4. Динамическое переименование и удаление команд:
   
    Описание

   
   В версии 2.8 были добавлены функции RenameCmd и RemoveCmd для переименования и удаления команд соответственно.
   Примеры использования:
   

   RenameCmd("/help", "/menu"); // команда /help будет переименована в /menu 

   RemoveCmd("/makeadmin"); // команда /makeadmin будет удалена и больше не будет работать 

Тест скорости: http://rghost.ru/56431688

 Шindoшs 7

Скачать:

Плагин (.dll, .so, .inc): https://www.dropbox.com/s/5bfm5tfgli...D_2.8.zip?dl=1

Автор: Daniel_Cortez

Специально для Pro-Pawn.ru

Копирование данной статьи на других ресурсах без разрешения автора запрещено!

[Mark_Twein]

DC - Daniel_Cortez. А так посмотрю, + поставлю.

[Nixson_West]

как раз искал,большое спасибо.

[Daniel_Cortez]

Плагин обновлён до версии 2.0.
Добавлена поддержка команд на русском языке и колбэки OnPlayerCommandPerformed и OnPlayerCommandReceived.
Подробности в 1 посте.

[ZabreDun]

Судя по тестам, процессор довольно шустрый.

[JDeax]

Вот как раз искал!

[Mike]

То что нужно!

[Daniel_Cortez]

И плагин снова обновлён.

Исправлена критическая ошибка, возникавшая после рестарта сервера.
Добавлен макрос "cmd::" для удобства вызова команд из мода.

Всем, кто использует плагин, просьба обновить его до самой последней версии (новые ссылки, как всегда, в 1 посте).

[OKStyle]

Тему в важные) В последнем примере разве не надо strval() добавить в параметр? Или там строка сама по себе входной аргумент?

Можно, в принципе, убрать ALT, т.к. есть RegisterAlt. И не мешало бы пример использования с параметрами (с и без sscanf) привести. Например, на этой команде:

if(strcmp(cmd, "/setadmin", true) == 0)
{
    new tmp[32];
    tmp = strtok(cmdtext, idx);
    new targetid = strval(tmp);
    tmp = strtok(cmdtext, idx);
    new level = strval(tmp);
    SetPVarInt(targetid, "Admin", level);
    new string[128];
    format(string, sizeof(string), "Администратор %s назначил игроку %s админ-уровень %d", PlayerInfo[playerid][pName], PlayerInfo[targetid][pName], level);
    SendAdminMessage(string);
    format(string, sizeof(string), "Администратор %s назначил Вам админ-уровень %d", PlayerInfo[playerid][pName], level);
    SendClientMessage(targetid, COLOR_RED_WARNING, string);
    return 1;
} 

[Salvacore]

Спасибо