AlliedModders Wiki - User contributions [en]

Ru:Vectors Explained (Scripting)

2017-11-13T16:17:32Z

R1KO: Created page with "=Введение= Есть три разных типа векторов: - '''Позиционные векторы''' - '''Угловые векторы''' - '''Вект..."

=Введение=
Есть три разных типа векторов:

- '''Позиционные векторы'''

- '''Угловые векторы'''

- '''Векторы скорости'''

В большинстве случаев вы, вероятно, будете использовать только один из них за раз, но вам не мешает узнать, для чего нужны другие два типа. Вот пример стандартной функции «TeleportEntity», чтобы показать вам, как она выглядит:

<pawn>
native int TeleportEntity(int entity, const float origin[3], const float angles[3], const float velocity[3]);
</pawn>

'''Вектор положения''': Первый вектор в этом нативе, объявленном как origin[3], является вектором положения. Это просто говорит нам абсолютные позиции сущностей в мире. Вектор положения мог бы выглядеть примерно так {15.0, 30.0, 15.0}, и это означало бы, что объект имеет 15 единиц вдоль оси X, 30 единиц вдоль оси Y и 15 единиц вдоль оси Z.

'''Угловой вектор''': Второй вектор в этой нативной, объявленной как angles[3], является угловым вектором. Это указывает на вращение объекта. Этот вектор будет соответствовать формату {pitch, yaw, roll}, который изменяет углы указанного объекта.
«Pitch» - это углы вращения вверх и вниз, «Yaw» - влево и вправо, а «Roll» - это вращение вдоль вектора вверх / вниз / влево / вправо.

'''Вектор скорости''': Последний вектор в нативе представляет собой вектор скорости, объявленный как velocity[3] в примере. Этот вектор сообщает игре, где объект будет находиться в следующем кадре (фрейме). Таким образом, в следующем игровом кадре вектор положения этого объекта будет представлять собой сумму вектора положения и вектора скорости из нашего текущего кадра.

==Векторы скорости==
<pawn>
float vecOrigin[3], vecVelocity[3], vecResult[3];

AddVectors(vecOrigin, vecVelocity, vecResult);
</pawn>

Ru:AutoConfigs (SourceMod Scripting)

2015-07-07T15:47:09Z

R1KO:

__FORCETOC__
SourceMod обеспечивает простую систему для плагинов, которая автоматически генерирует конфигурационные файлы, которые загружаются при загрузке. Это обеспечивается с помощью <tt>AutoExecConfig</tt> размещенной в <tt>scripting/include/sourcemod.inc</tt>.

После того как все конфиг файлы исполнены, будет вызвано событие <tt>OnConfigsExecuted</tt>. Оно будет вызыватся всегда, даже если у вашего плагина не было конфигов или они были загружены позже.

=Использование=
Есть три параметра для вызова:
*''autoCreate'' - Если true, SourceMod запишет все ConVars созданные плагином в конфиг если он отсутствует.
*''name'' - Имя конфиг файла (включая .cfg расширение). Если пусто имя плагина, то будет использоваться с <tt>plugin.</tt> пометкой. Пример: для плагина <tt>hat.smx</tt> будет создан <tt>plugin.hat.cfg</tt>.
*''folder'' - При желание можно сменить папку в главной <tt>cfg</tt> папки. По умолчанию это <tt>sourcemod</tt>, и конфиги будут в <tt>cfg/sourcemod/</tt>. Если пусто, конфиг будет расположен в <tt>cfg/</tt>.

''Примичание'': Возможно создать вложенные папки; SourceMod будет пытаться создать каждую из них.

''Примичание'': Если у вас несколько <tt>AutoExecConfig</tt> вызовов помеченных '''autoCreate''' то будет создан только первый, а все следующие будут проигнорированы. Таким образом, нет возможности автоматически разделить cvars между несколькими файлами.

=Пример Dump=
autoCreate функция создает конфиг файл, который выглядит так:

<pre>
// This file was auto-generated by SourceMod (v1.0.0.986)
// ConVars for plugin "hat.smx"

// MySQL database
// -
// Default: ""
mysqlk_database ""

// MySQL host, use this to configure various
// things for your server.
// -
// Default: "localhost"
mysqlk_host "localhost"
</pre>

[[Category:Ru:SourceMod Scripting]]

Ru:AutoConfigs (SourceMod Scripting)

2015-07-07T15:43:27Z

R1KO:

__FORCETOC__
SourceMod обеспечивает простую систему для плагинов, которая автоматически генерирует конфиг файлы, которые загружаются при загрузке. Это обеспечивается с помощью <tt>AutoExecConfig</tt> размещенной в <tt>scripting/include/sourcemod.inc</tt>.

После того как все конфиг файлы исполнены, <tt>OnConfigsExecuted</tt> должно вызываться. This forward will always be called, even if your plugin had no configs or if it was loaded late.

=Использование=
Эти три параметра для вызова:
*''autoCreate'' - Если true, SourceMod will dump all ConVars created by the plugin into a config file if the specified config file does not exist.
*''name'' - Имя конфиг файла (включая .cfg расширение). Если пусто имя плагина, то будет использоваться с <tt>plugin.</tt> пометкой. Пример: для плагина <tt>hat.smx</tt> будет создан <tt>plugin.hat.cfg</tt>.
*''folder'' - При желание можно сменить папку в главной <tt>cfg</tt> папки. По умолчанию это <tt>sourcemod</tt>, и конфиги будут в <tt>cfg/sourcemod/</tt>. Если пусто, конфиг будет расположен в <tt>cfg/</tt>.

''Примичание'': Возможно создать вложенные папки; SourceMod будет пытаться создать каждую из них.

''Примичание'': Если у вас несколько <tt>AutoExecConfig</tt> вызовов помеченных '''autoCreate''' то будет создан только первый, а все следующие будут проигнорированы. Таким образом, нет возможности автоматически разделить cvars между несколькими файлами.

=Пример Dump=
autoCreate функция создает конфиг файл, который выглядит так:

<pre>
// This file was auto-generated by SourceMod (v1.0.0.986)
// ConVars for plugin "hat.smx"

// MySQL database
// -
// Default: ""
mysqlk_database ""

// MySQL host, use this to configure various
// things for your server.
// -
// Default: "localhost"
mysqlk_host "localhost"
</pre>

[[Category:Ru:SourceMod Scripting]]

ConVars (SourceMod Scripting)/ru

2014-01-06T20:50:54Z

R1KO:

Квары - ''это консольные переменные.'' Они могут иметь числовое или строчное значение. Их значения могут быть изменены через консоль или с помощью .cfg файлов, а иногда сохраняются для всех сеансов сервера.

=Введение=
Квары доступны через Handle`s. Есть 2 способа получить Handle квара. Создать новый квар или найти существующий. Если вы создадите уже существующий квар, автоматически будет использоваться старый.

''Примечание: Handle`s для кваров являются уникальными, их не нужно закрывать или присваивать INVALID_HANDLE. Они должны существовать пока SourceMod запущен.''

==Поиск кваров==
Искать квары очень просто. Например, вы хотите найти <tt>mp_startmoney</tt> из Counter-Strike:Source:

<pawn>new g_hStartMoney

public OnPluginStart()
{
g_hStartMoney = FindConVar("mp_startmoney")
}</pawn>

''Примечание: FindConVar() вернет ''<tt>INVALID_HANDLE</tt>'' если квар не найден. Keep this in mind if you are trying to read ConVars from other plugins.''

==Создание кваров==
Простейший квар требует всего 2 значения: имя и значение по умолчанию. Тем не менее, он может содержать описание:

<pawn>new Handle:g_hEnabled

public OnPluginStart()
{
g_hEnabled = CreateConVar("myplugin_enabled", "1", "Включение/Выключение плагина.")
}</pawn>

Вы так же имеете возможностю ограничить значение. Например, давайте создадим квар названием <tt>myplugin_ratio</tt>, который не может быть выше 1,0 и ниже 0,1.
<pawn>new Handle:g_hEnabled

public OnPluginStart()
{
g_hEnabled = CreateConVar("myplugin_ratio",
"0.6",
"Sets a vote ratio",
_, /* Флаги (будут обсуждаться позже) */
true, /* Включить минимальное значение */
0.1,
true, /* Включить максимальное значение */
1.0)
}</pawn>

Значение по умолчанию может иметь любой тип данных, и оно не ограничивает будущие типы данных, которые можно использовать. Тем не менее, минимальные и максимальные ограничения всегда должны быть числом с плавающей точкой (float).

Если вы создаете квар, который уже существует, вы получите Handle на этот квар. Кроме того, сами Handle будут идентичны, поскольку плагин будет владеть Handle. Описание, значение по умолчанию, или ограничения не будут изменены.

=Использование/Изменение значений=
Использовать квары очень просто. Например, мы хотим изменить <tt>mp_startmoney</tt>, но сохранить старое значение и восстановить его позже. Повторно используем наш код <tt>mp_startmoney</tt> от раздела <tt>Получение кваров</tt>:

<pawn>new g_oldmoney

SetStartMoney(newmoney)
{
g_oldmoney = GetConVarInt(g_hStartMoney)
SetConVarInt(g_hStartMoney, newmoney)
}

RestoreStartMoney()
{
SetConVarInt(g_hStartMoney, g_oldmoney)
}</pawn>

Хотя существуют различные функции для типов значений (с плавающей точкой, строки, и так далее), внутренние данные всегда сохраняются так же. Например, этот код будет работать:

<pawn>public GetStartMoney()
{
decl String:buffer[128]

GetConVarString(g_hStartMoney, buffer, sizeof(buffer))

return StringToInt(buffer)
}</pawn>

Несмотря на то, что <tt>mp_startmoney</tt> целое число, он может использоваться как строка.

=Флаги=
Квары могут иметь ряд флагов, в зависимости от которых могут менять свое поведение. Основные флаги:
*<tt>FCVAR_PROTECTED</tt> - Секретная информация (не должны подвергаться воздействию клиентов или логов).
*<tt>FCVAR_NOTIFY</tt> - Уведомление клиентов об изменении.
*<tt>FCVAR_CHEAT</tt> - Могут использоваться только в случае если <tt>sv_cheats</tt> равно 1.
*<tt>FCVAR_REPLICATED</tt> - Принудительная установка значения квара на клиенте.

Например, мы хотим изменить значение квара с флагом FCVAR_CHEAT. The following two functions could be used:
<pawn>UnsetCheatVar(Handle:hndl)
{
new flags = GetConVarFlags(hndl)
flags &= ~FCVAR_CHEAT
SetConVarFlags(hndl, flags)
}

SetCheatVar(Handle:hndl)
{
new flags = GetConVarFlags(hndl)
flags |= FCVAR_CHEAT
SetConVarFlags(hndl, flags)
}</pawn>

=Change Callbacks=
As of Half-Life 2, it is possible to know when ConVars change. While this is a very powerful feature, you must be careful not to set a ConVar inside a ConVar change hook such that it re-invokes he same callback. This results in ''infinite recursion''.

For example, let's say you want to detect when <tt>bot_quota</tt> changes and to prevent it from going below 2:

<pawn>new Handle:g_hBotQuota

public OnPluginStart()
{
g_hBotQuota = FindConVar("bot_quota")
if (g_hBotQuota != INVALID_HANDLE)
{
HookConVarChange(g_hBotQuota, OnBotQuotaChange)
}
}

public OnBotQuotaChange(Handle:cvar, const String:oldVal[], const String:newVal[])
{
if (StringToInt(newVal) < 2)
{
SetConVarInt(cvar, 2)
}
}</pawn>

'''Note 1:''' You do not need to explicitly unhook ConVarChange functions on shutdown. These hooks are removed when your plugin unloads.

'''Note 2:''' You cannot prevent cvar changes from happening; you can only change the value again. If the engine or game mod already have a change function installed for a ConVar, that function will always be called first.

[[Category:Ru:SourceMod Scripting]]

ConVars (SourceMod Scripting)/ru

2014-01-06T20:44:03Z

R1KO:

Квары - ''это консольные переменные.'' Они могут иметь числовое или строчное значение. Их значения могут быть изменены через консоль или с помощью .cfg файлов, а иногда сохраняются для всех сеансов сервера.

=Введение=
Квары доступны через Handle`s. Есть 2 способа получить Handle квара. Создать новый квар или найти существующий. Если вы создадите уже существующий квар, автоматически будет использоваться старый.

''Примечание: Handle`s для кваров являются уникальными, их не нужно закрывать или присваивать INVALID_HANDLE. Они должны существовать пока SourceMod запущен.''

==Поиск кваров==
Искать квары очень просто. Например, вы хотите найти <tt>mp_startmoney</tt> из Counter-Strike:Source:

<pawn>new g_hStartMoney

public OnPluginStart()
{
g_hStartMoney = FindConVar("mp_startmoney")
}</pawn>

''Примечание: FindConVar() вернет ''<tt>INVALID_HANDLE</tt>'' если квар не найден. Keep this in mind if you are trying to read ConVars from other plugins.''

==Создание кваров==
Простейший квар требует всего 2 значения: имя и значение по умолчанию. Тем не менее, он может содержать описание:

<pawn>new Handle:g_hEnabled

public OnPluginStart()
{
g_hEnabled = CreateConVar("myplugin_enabled", "1", "Включение/Выключение плагина.")
}</pawn>

Вы так же имеете возможностю ограничить значение. Например, давайте создадим квар названием <tt>myplugin_ratio</tt>, который не может быть выше 1,0 и ниже 0,1.
<pawn>new Handle:g_hEnabled

public OnPluginStart()
{
g_hEnabled = CreateConVar("myplugin_ratio",
"0.6",
"Sets a vote ratio",
_, /* Флаги (будут обсуждаться позже) */
true, /* Включить минимальное значение */
0.1,
true, /* Включить максимальное значение */
1.0)
}</pawn>

Значение по умолчанию может иметь любой тип данных, и оно не ограничивает будущие типы данных, которые можно использовать. Тем не менее, минимальные и максимальные ограничения всегда должны быть числом с плавающей точкой (float).

Если вы создаете квар, который уже существует, вы получите Handle на этот квар. Кроме того, сами Handle будут идентичны, поскольку плагин будет владеть Handle. Описание, значение по умолчанию, или ограничения не будут изменены.

=Использование/Изменение значений=
Использовать квары очень просто. Например, мы хотим изменить <tt>mp_startmoney</tt>, но сохранить старое значение и восстановить его позже. Повторно используем наш код <tt>mp_startmoney</tt> от раздела <tt>Получение кваров</tt>:

<pawn>new g_oldmoney

SetStartMoney(newmoney)
{
g_oldmoney = GetConVarInt(g_hStartMoney)
SetConVarInt(g_hStartMoney, newmoney)
}

RestoreStartMoney()
{
SetConVarInt(g_hStartMoney, g_oldmoney)
}</pawn>

Хотя существуют различные функции для типов значений (с плавающей точкой, строки, и так далее), внутренние данные всегда сохраняются так же. Например, этот код будет работать:

<pawn>public GetStartMoney()
{
decl String:buffer[128]

GetConVarString(g_hStartMoney, buffer, sizeof(buffer))

return StringToInt(buffer)
}</pawn>

Несмотря на то, что <tt>mp_startmoney</tt> целое число, он может использоваться как строка.

=Флаги=
ConVars can have a number of flags to change their behaviour. A few of the important flags are:
*<tt>FCVAR_PROTECTED</tt> - Sensitive information (should not be exposed to clients or logs).
*<tt>FCVAR_NOTIFY</tt> - Clients are notified of changes.
*<tt>FCVAR_CHEAT</tt> - Can only be use if <tt>sv_cheats</tt> is 1.
*<tt>FCVAR_REPLICATED</tt> - Setting is forced to clients.

Let's say we wanted to toggle whether a cvar had FCVAR_CHEAT. The following two functions could be used:
<pawn>UnsetCheatVar(Handle:hndl)
{
new flags = GetConVarFlags(hndl)
flags &= ~FCVAR_CHEAT
SetConVarFlags(hndl, flags)
}

SetCheatVar(Handle:hndl)
{
new flags = GetConVarFlags(hndl)
flags |= FCVAR_CHEAT
SetConVarFlags(hndl, flags)
}</pawn>

=Change Callbacks=
As of Half-Life 2, it is possible to know when ConVars change. While this is a very powerful feature, you must be careful not to set a ConVar inside a ConVar change hook such that it re-invokes he same callback. This results in ''infinite recursion''.

For example, let's say you want to detect when <tt>bot_quota</tt> changes and to prevent it from going below 2:

<pawn>new Handle:g_hBotQuota

public OnPluginStart()
{
g_hBotQuota = FindConVar("bot_quota")
if (g_hBotQuota != INVALID_HANDLE)
{
HookConVarChange(g_hBotQuota, OnBotQuotaChange)
}
}

public OnBotQuotaChange(Handle:cvar, const String:oldVal[], const String:newVal[])
{
if (StringToInt(newVal) < 2)
{
SetConVarInt(cvar, 2)
}
}</pawn>

'''Note 1:''' You do not need to explicitly unhook ConVarChange functions on shutdown. These hooks are removed when your plugin unloads.

'''Note 2:''' You cannot prevent cvar changes from happening; you can only change the value again. If the engine or game mod already have a change function installed for a ConVar, that function will always be called first.

[[Category:Ru:SourceMod Scripting]]

ConVars (SourceMod Scripting)/ru

2014-01-06T20:38:23Z

R1KO:

Квары - ''это консольные переменные.'' Они могут иметь числовое или строчное значение. Их значения могут быть изменены через консоль или с помощью .cfg файлов, а иногда сохраняются для всех сеансов сервера.

=Введение=
Квары доступны через Handle`s. Есть 2 способа получить Handle квара. Создать новый квар или найти существующий. Если вы создадите уже существующий квар, автоматически будет использоваться старый.

''Примечание: Handle`s для кваров являются уникальными, их не нужно закрывать или присваивать INVALID_HANDLE. Они должны существовать пока SourceMod запущен.''

==Поиск кваров==
Искать квары очень просто. Например, вы хотите найти <tt>mp_startmoney</tt> из Counter-Strike:Source:

<pawn>new g_hStartMoney

public OnPluginStart()
{
g_hStartMoney = FindConVar("mp_startmoney")
}</pawn>

''Примечание: FindConVar() вернет ''<tt>INVALID_HANDLE</tt>'' если квар не найден. Keep this in mind if you are trying to read ConVars from other plugins.''

==Создание кваров==
Простейший квар требует всего 2 значения: имя и значение по умолчанию. Тем не менее, он может содержать описание:

<pawn>new Handle:g_hEnabled

public OnPluginStart()
{
g_hEnabled = CreateConVar("myplugin_enabled", "1", "Включение/Выключение плагина.")
}</pawn>

Вы так же имеете возможностю ограничить значение. Например, давайте создадим квар названием <tt>myplugin_ratio</tt>, который не может быть выше 1,0 и ниже 0,1.
<pawn>new Handle:g_hEnabled

public OnPluginStart()
{
g_hEnabled = CreateConVar("myplugin_ratio",
"0.6",
"Sets a vote ratio",
_, /* Флаги (будут обсуждаться позже) */
true, /* Включить минимальное значение */
0.1,
true, /* Включить максимальное значение */
1.0)
}</pawn>

Значение по умолчанию может иметь любой тип данных, и оно не ограничивает будущие типы данных, которые можно использовать. Тем не менее, минимальные и максимальные ограничения всегда должны быть числом с плавающей точкой (float).

Если вы создаете квар, который уже существует, вы получите Handle на этот квар. Кроме того, сами Handle будут идентичны, поскольку плагин будет владеть Handle. Описание, значение по умолчанию, или ограничения не будут изменены.

=Использование/Изменение значений=
Использовать квары очень просто. Например, мы хотим изменить <tt>mp_startmoney</tt>, но сохранить старое значение и восстановить его позже. Повторно используем наш код <tt>mp_startmoney</tt> от раздела <tt>Получение кваров</tt>:

<pawn>new g_oldmoney

SetStartMoney(newmoney)
{
g_oldmoney = GetConVarInt(g_hStartMoney)
SetConVarInt(g_hStartMoney, newmoney)
}

RestoreStartMoney()
{
SetConVarInt(g_hStartMoney, g_oldmoney)
}</pawn>

Although there are different functions for value types (float, string, et cetera), the internal data is always stored the same way. For example, this code will work:

<pawn>public GetStartMoney()
{
decl String:buffer[128]

GetConVarString(g_hStartMoney, buffer, sizeof(buffer))

return StringToInt(buffer)
}</pawn>

Even though <tt>mp_startmoney</tt> is an integer, it can still be retrieved as a string.

=Flags=
ConVars can have a number of flags to change their behaviour. A few of the important flags are:
*<tt>FCVAR_PROTECTED</tt> - Sensitive information (should not be exposed to clients or logs).
*<tt>FCVAR_NOTIFY</tt> - Clients are notified of changes.
*<tt>FCVAR_CHEAT</tt> - Can only be use if <tt>sv_cheats</tt> is 1.
*<tt>FCVAR_REPLICATED</tt> - Setting is forced to clients.

Let's say we wanted to toggle whether a cvar had FCVAR_CHEAT. The following two functions could be used:
<pawn>UnsetCheatVar(Handle:hndl)
{
new flags = GetConVarFlags(hndl)
flags &= ~FCVAR_CHEAT
SetConVarFlags(hndl, flags)
}

SetCheatVar(Handle:hndl)
{
new flags = GetConVarFlags(hndl)
flags |= FCVAR_CHEAT
SetConVarFlags(hndl, flags)
}</pawn>

=Change Callbacks=
As of Half-Life 2, it is possible to know when ConVars change. While this is a very powerful feature, you must be careful not to set a ConVar inside a ConVar change hook such that it re-invokes he same callback. This results in ''infinite recursion''.

For example, let's say you want to detect when <tt>bot_quota</tt> changes and to prevent it from going below 2:

<pawn>new Handle:g_hBotQuota

public OnPluginStart()
{
g_hBotQuota = FindConVar("bot_quota")
if (g_hBotQuota != INVALID_HANDLE)
{
HookConVarChange(g_hBotQuota, OnBotQuotaChange)
}
}

public OnBotQuotaChange(Handle:cvar, const String:oldVal[], const String:newVal[])
{
if (StringToInt(newVal) < 2)
{
SetConVarInt(cvar, 2)
}
}</pawn>

'''Note 1:''' You do not need to explicitly unhook ConVarChange functions on shutdown. These hooks are removed when your plugin unloads.

'''Note 2:''' You cannot prevent cvar changes from happening; you can only change the value again. If the engine or game mod already have a change function installed for a ConVar, that function will always be called first.

[[Category:Ru:SourceMod Scripting]]