Ru:Commands (SourceMod Scripting) - Revision history

HolyHender: /* Добавление команд */

2021-02-11T09:36:39Z

‎Добавление команд

HolyHender: /* Блокирование серверных команд */

2021-02-11T09:35:21Z

‎Блокирование серверных команд

MAGNAT2645 at 14:53, 20 August 2016

2016-08-20T14:53:58Z

MAGNAT2645: /* Чат триггеры */

2016-08-20T14:49:17Z

‎Чат триггеры

MAGNAT2645: /* Добавление команд */

2016-08-20T14:40:58Z

‎Добавление команд

MAGNAT2645: /* Добавление команд */

2016-08-20T14:39:32Z

‎Добавление команд

MAGNAT2645 at 14:38, 20 August 2016

2016-08-20T14:38:18Z

MAGNAT2645 at 14:25, 20 August 2016

2016-08-20T14:25:52Z

Show changes

Klarg: /* Chat Triggers */

2011-07-19T10:04:05Z

‎Chat Triggers

Klarg: /* Консольные команды */

2011-07-19T09:55:42Z

‎Консольные команды

@@ Line 77: / Line 77: @@
 <pawn>public void OnPluginStart()
+{
-	RegConsoleCmd("test_command", Command_Test)
+	RegConsoleCmd("test_command", Command_Test);
+}
 public Action Command_Test(int client, int args)
+{
-	char arg[128]
+	char arg[128], full[256];
 	GetCmdArgString(full, sizeof(full))
@@ Line 89: / Line 88: @@
 	if (client)
+	{
-		char name[32]
+		char name[32];
-		GetClientName(client, name, sizeof(name))
+		GetClientName(client, name, sizeof(name));
-		PrintToServer("Команда от клиента: %s", name)
+		PrintToServer("Команда от клиента: %s", name);
 	} else {
-		PrintToServer("Команда от сервера.")
+	else
+	}
-	PrintToServer("Строка аргументов: %s", full)
+	PrintToServer("Строка аргументов: %s", full);
-	PrintToServer("Количество аргументов: %d", args)
+	PrintToServer("Количество аргументов: %d", args);
 	for (int i = 1; i <= args; i++)
+	{
-		GetCmdArg(i, arg, sizeof(arg))
+		GetCmdArg(i, arg, sizeof(arg));
-		PrintToServer("Аргумент %d: %s", i, arg)
+		PrintToServer("Аргумент %d: %s", i, arg);
+	}
 }</pawn>

@@ Line 50: / Line 50: @@
 public void OnPluginStart()
+{
-	RegServerCmd("kickid", Command_KickId)
+	RegServerCmd("kickid", Command_KickId);
+}
 public Action Command_Kickid(int args)
+{
-	return Plugin_Handled
+	return Plugin_Handled;
+}
 </pawn>

@@ Line 8: / Line 8: @@
 **Любой из методов ввода серверных команд
-Для серверных команд не существует клиентского индекса.  Для консольных/клиентских команд, существует клиентский индекс, но он может быть 0 что-бы показать что команда с сервера.
+Для серверных команд не существует клиентского индекса.  Для консольных/клиентских команд, существует клиентский индекс, но он может быть 0, чтобы показать, что команда с сервера.
 Обратите внимание, что кнопка-бинд "commands", такие как +attack и +duck, они не консольные команды.  Эти команды отдельно передаются, посколько они отдельно привязаны.
 =Серверные команды=
-Как отмечалось выше, серверные команды срабатывают через консоль сервера, будь то удалённую, локальную, или через движок Source. Индекс клиента не связан со серверными командами.
+Как отмечалось выше, серверные команды срабатывают через консоль сервера, будь то удалённую, локальную, или через движок Source. Индекс клиента не связан с серверными командами.
 Серверные команды регистрируются через <tt>RegServerCmd()</tt> функцию, расположенную в <tt>console.inc</tt>. При регистрации команды, вы можете записать поверх существующей команды, и таким образом, возвращаемое значение становится важным.

@@ Line 304: / Line 304: @@
 *"<tt>/</tt>" является ''скрытым'' триггером по умолчанию (<tt>SilentChatTrigger</tt> в <tt>configs/core.cfg</tt>) и ваша команда не будет показана остальным клиентам
-SourceMod будет исполнять только те команды, которые зарегистрированы с <tt>RegConsoleCmd</tt> или <tt>RegAdminCmd</tt>, и только если эти комнды уже не используются Half-life 2 движком или другим игровым модом. Если команда идет с префиксом "sm_" то "sm_" можно исключить, из написания в чате.
+SourceMod будет исполнять только те команды, которые зарегистрированы с <tt>RegConsoleCmd</tt> или <tt>RegAdminCmd</tt>, и только если эти команды уже не используются Half-life 2 движком или другим игровым модом. Если команда идет с префиксом "sm_", то "sm_" можно исключить, из написания в чате.
-Console commands which wish to support usage as a chat trigger should not use <tt>PrintTo*</tt> natives.  Instead, they should use <tt>ReplyToCommand()</tt>, which will automatically print your message either as a chat message or to the client's console, depending on the source of the command.
+Консольные команды, которые хотят поддерживать использование в качестве триггера чата, не должны использовать нативы вроде <tt>PrintTo*</tt>. Вместо этого, они должны использовать <tt>ReplyToCommand()</tt>, которая будет автоматически печатать ваше сообщение либо в виде сообщения чата либо в виде консоли клиента, в зависимости от источника команды.
 [[Category:Ru:SourceMod Scripting]]

@@ Line 96: / Line 96: @@
+	}
-	PrintToServer("Argument string: %s", full)
+	PrintToServer("Строка аргументов: %s", full)
-	PrintToServer("Argument count: %d", args)
+	PrintToServer("Количество аргументов: %d", args)
-	for (new i = 1; i <= args; i++)
+	for (int i = 1; i <= args; i++)
+	{
 		GetCmdArg(i, arg, sizeof(arg))
-		PrintToServer("Argument %d: %s", i, arg)
+		PrintToServer("Аргумент %d: %s", i, arg)
+	}
 }</pawn>

@@ Line 75: / Line 75: @@
 Создать клиентские команды очень просто.  Давайте переделаем нашу тест команду, чтобы можно было отобразить информацию о клиенте.
-<pawn>public OnPluginStart()
+<pawn>public void OnPluginStart()
+{
 	RegConsoleCmd("test_command", Command_Test)

@@ Line 82: / Line 82: @@
 public Action Command_Test(int client, int args)
+{
-	char arg[128];
+	char arg[128]
-	char full[256];
+	char full[256]
 	GetCmdArgString(full, sizeof(full))
@@ Line 91: / Line 91: @@
 		char name[32]
 		GetClientName(client, name, sizeof(name))
-		PrintToServer("Команда от клиента: %s", name);
+		PrintToServer("Команда от клиента: %s", name)
 	} else {
-		PrintToServer("Команда от сервера.");
+		PrintToServer("Команда от сервера.")
+	}
@@ Line 105: / Line 105: @@
 }</pawn>
-==Hooking Commands==
+==Захват команд==
-A common example is hooking the say command.  Let's say we want to tell players whether FF is enabled when they say '/ff' in game.
+Пример: захват типичной команды say. Let's say we want to tell players whether FF is enabled when they say '/ff' in game.
 Before we implement this, a common point of confusion with the 'say' command is that Half-Life 2 (and Half-Life 1), by default, send it with the text in one big quoted string.  This means if you say "I like hot dogs," your command will be broken down as such:
@@ Line 122: / Line 122: @@
 Thus, to take into account both of these situations, we are going to use <tt>GetCmdArgString</tt> and manually parse the input.
-<pawn>public OnPluginStart()
+<pawn>public void OnPluginStart()
+{
 	RegConsoleCmd("say", Command_Say)
+}
-public Action:Command_Say(client, args)
+public Action Command_Say(int client, int args)
+{
-	new String:text[192]
+	char text[192]
 	GetCmdArgString(text, sizeof(text))
-	new startidx = 0
+	int startidx = 0
 	if (text[0] == '"')
+	{
 		startidx = 1
-		/* Strip the ending quote, if there is one */
+		/* Лишаем ковычки от окончания, если есть */
-		new len = strlen(text);
+		int len = strlen(text);
 		if (text[len-1] == '"')
+		{
@@ Line 146: / Line 146: @@
 	if (StrEqual(text[startidx], "/ff"))
+	{
-		new Handle:ff = FindConVar("mp_friendlyfire")
+		Handle ff = FindConVar("mp_friendlyfire")
 		if (GetConVarInt(ff))
+		{
-			PrintToConsole(client, "Friendly fire is enabled.")
+			PrintToConsole(client, "Огонь по товарищам включен.")
 		} else {
-			PrintToConsole(client, "Friendly fire is disabled.")
+			PrintToConsole(client, "Огонь по товарищам выключен.")
+		}
-		/* Block the client's messsage from broadcasting */
+		/* Блокирование сообщения клиента от вещания */
 		return Plugin_Handled
+	}
-	/* Let say continue normally */
+	/* Пусть работает как обычно */
 	return Plugin_Continue
 }</pawn>
 ==Создание Админской команды==
-Давай-те создадим простую админскую команду, которая позволяет кикнуть игрока, по его полному имени.
+Давайте создадим простую админскую команду, которая позволяет кикнуть игрока, по его полному имени.
-<pawn>public OnPluginStart()
+<pawn>public void OnPluginStart()
+{
 	RegAdminCmd("admin_kick",
 		Command_Kick,
 		ADMFLAG_KICK,
-		"Kicks a player by name")
+		"Кикает игрока по нику")
+}
-public Action:Command_Kick(client, args)
+public Action Command_Kick(int client, int args)
+{
 	if (args < 1)
+	{
-		PrintToConsole(client, "Usage: admin_kick <name>")
+		PrintToConsole(client, "Использование: admin_kick <ник>")
 		return Plugin_Handled
+	}
-	new String:name[32], maxplayers, target = -1
+	char name[32]
 	GetCmdArg(1, name, sizeof(name))
 	maxplayers = GetMaxClients()
-	for (new i=1; i<=maxplayers; i++)
+	for (int i = 1; i <= maxplayers; i++)
+	{
 		if (!IsClientConnected(i))
@@ Line 190: / Line 191: @@
 			continue
+		}
-		decl String:other[32]
+		char other[32]
 		GetClientName(i, other, sizeof(other))
 		if (StrEqual(name, other))
@@ Line 200: / Line 201: @@
 	if (target == -1)
+	{
-		PrintToConsole(client, "Could not find any player with the name: \"%s\"", name)
+		PrintToConsole(client, "Не могу найти игрока с ником: \"%s\"", name)
 		return Plugin_Handled
+	}
@@ Line 211: / Line 212: @@
 ==Иммунитет==
 В нашем прошлом примере, мы не сделали иммунитет. Иммунитет является гораздно сложной системой в SourceMod, чем это было в AMX Mod X, и не существует просто флага, чтобы обозначить его.  Вместо, этого существует две функции:
-*<tt>CanAdminTarget</tt>: Tests raw AdminId values for immunity.
+*<tt>CanAdminTarget</tt>: Проверяет исходные значения AdminId для иммунитета.
-*<tt>CanUserTarget</tt>: Tests in-game clients for immunity.
+*<tt>CanUserTarget</tt>: Проверяет внутриигровых клиентов для иммунитета.
 While immunity is generally tested ''player versus player'', it is possible you might want to check for immunity and not have a targetting client.  While there is no convenience function for this yet, a good idea might be to check for either ''default'' or ''global'' immunity on the player's groups (these can be user-defined for non-player targeted scenarios).

@@ Line 291: / Line 291: @@
-=Chat Triggers=
+=Чат триггеры=
-SourceMod will automatically create chat triggers for every command you make (as of revision 900).  For example, if you create a console command called "sm_megaslap," administrators will be able to type any of the following commands in <tt>say</tt>/<tt>say_team</tt> message modes:
+SourceMod будет автоматически создавать, чат триггеры, для каждой команды, которую вы сделали (по ревизии 900).  Для примера, если вы создали консольную команду "sm_megaslap," администраторы смогут набрать ее и в  <tt>say</tt>/<tt>say_team</tt> режимах:
 <pre>!sm_megaslap
 !megaslap
@@ Line 298: / Line 298: @@
 /megaslap</pre>
-SourceMod then executes this command and its arguments as if it came from the client console.
+SourceMod будет выполнять эту команду и ее аргументы, как если бы она пришла из консоли клиента.
-*"<tt>!</tt>" is the default ''public'' trigger (<tt>PublicChatTrigger</tt> in <tt>configs/core.cfg</tt>) and your entry will be displayed to all clients as normal.
+*"<tt>!</tt>" is the default ''public'' trigger (<tt>PublicChatTrigger</tt> in <tt>configs/core.cfg</tt>) и ваша команда будет отображена всем клиентам.
-*"<tt>/</tt>" is the default ''silent'' trigger (<tt>SilentChatTrigger</tt> in <tt>configs/core.cfg</tt>) and your entry will be blocked from being displayed.
+*"<tt>/</tt>" is the default ''silent'' trigger (<tt>SilentChatTrigger</tt> in <tt>configs/core.cfg</tt>) и ваша команда не будет показана остальным клиентам
-SourceMod will only execute commands registered with <tt>RegConsoleCmd</tt> or <tt>RegAdminCmd</tt>, and only if those commands are not already provided by Half-Life 2 or the game mod.  If the command is prefixed with "sm_" then the "sm_" can be omitted from the chat trigger.
+SourceMod будет исполнять только те команды, которые зарегистрированы с  <tt>RegConsoleCmd</tt> или <tt>RegAdminCmd</tt>, и только если эти комнды уже не используются Half-life 2 движком или другим игровым модом. Если команда идет с префиксом "sm_" то "sm_" можно исключить, из написания в чате.
 Console commands which wish to support usage as a chat trigger should not use <tt>PrintTo*</tt> natives.  Instead, they should use <tt>ReplyToCommand()</tt>, which will automatically print your message either as a chat message or to the client's console, depending on the source of the command.
 [[Category:Ru:SourceMod Scripting]]

@@ Line 67: / Line 67: @@
 *<tt>Plugin_Stop</tt>: Same as <tt>Plugin_Handled</tt>, except that this will be the last hook called.
-Note that, unlike AMX Mod X, SourceMod does not allow you to register command filters.  I.e., there is no equivalent to this notation:
+Обратите внимание, в отличие от AMX Mod X, SourceMod не сможет зарегистрировать командные фильтры. т.е. нет эквиалента этой команды:
 <pawn>register_clcmd("say /ff", "Command_SayFF");</pawn>
-This notation was removed to make our internal code simpler and faster.  Writing the same functionality is easy, and demonstrated below.
+Это было удаленно, что-бы сделать наш код проще и быстрее.  Writing the same functionality is easy, and demonstrated below.
-==Adding Commands==
+==Добавление команд==
-Adding client commands is very simple.  Let's port our earlier testing command to display information about the client as well.
+Создать клиентские команды очень просто.  Давайте переделаем нашу тест команду,что-бы можно было отобразить информацию о клиенте.
 <pawn>public OnPluginStart()
@@ Line 91: / Line 91: @@
 		new String:name[32]
 		GetClientName(client, name, sizeof(name))
-		PrintToServer("Command from client: %s", name);
+		PrintToServer("команда от клиента: %s", name);
 	} else {
-		PrintToServer("Command from server.");
+		PrintToServer("команда от сервера.");
+	}
@@ Line 161: / Line 161: @@
 }</pawn>
-==Creating Admin Commands==
+==Создание Админской команды==
-Let's create a simple admin command which kicks another player by their full name.
+Давай-те создадим простую админскую команду, которая позволяет кикнуть игрока, по его полному имени.
 <pawn>public OnPluginStart()
@@ Line 209: / Line 209: @@
 }</pawn>
-==Immunity==
+==Иммунитет==
-In our previous example, we did not take immunity into account.  Immunity is a much more complex system in SourceMod than it was in AMX Mod X, and there is no simple flag to denote its permissions.  Instead, two functions are provided:
+В нашем прошлом примере, мы не сделали иммунитет. Иммунитет является гораздно сложной системой в SourceMod, чем это было в AMX Mod X, и не существует просто флага, чтобы обозначить его.  Вместо, этого существует две функции:
 *<tt>CanAdminTarget</tt>: Tests raw AdminId values for immunity.
 *<tt>CanUserTarget</tt>: Tests in-game clients for immunity.
@@ Line 270: / Line 270: @@
 	return Plugin_Handled
 }</pawn>
 =Client-Only Commands=