AlliedModders Wiki - User contributions [en]

Talk:Оптимизация Плагинов (AMX Mod X Scripting)

2008-11-22T11:10:51Z

VEN: note

Без префикса Ru: статья не отображается в сводке статей (см. http://wiki.alliedmods.net/Category:Russian )

Ru AMX Mod X FAQ

2008-10-22T15:05:54Z

VEN:

[[Category:Russian]]
[[Category:Ru:AMX Mod X]]

= Общие положения, термины, сокращения и условные обозначения =
:* HL или HL1 - аббревиатура от [[Half-Life 1|Half-Life]] (часть первая);
:* Mod - "мод", модификация - дополнение к чему-либо, как правило, расширяющее/изменяющее функциональность;
:* HL Engine - "движок" Half-Life - "центральный модуль", осуществляющий выполнение базовых "общемодовых" задач;
:* MM - [[Metamod]] - сторонний мод особого типа, является промежуточным звеном в системе "HL движок - HL мод";
:* AMXX - аббревиатура от [[AMX Mod X]] - Metamod plugin ("плагин"), своего рода Metamod мод;
:* Map - "карта" - определяет внешний вид территории, на которой происходит игровое действие;
:* World - "мир" - все пространство, которое занимает карта, а также область, находящаяся за картой;
:* Spawn - "спавн" - момент, когда игрок появляется в мире, обретая физическое тело;
:* SinglePlayer - "синглплеер" - игровой тип, когда одновременно в игре может участвовать только один игрок;
:* MultiPlayer - "мультиплеер" - игровой тип, когда одновременно в игре может участвовать несколько игроков;
:* DM - аббревиатура от Death Match - динамичный мультиплеер тип игры, когда после "смерти" игрока происходит его скорый спавн ("респавн");
:* HLDM - аббревиатура от Half-Life Death Match - оригинальный HL мод DM типа;
:* CS - аббревиатура от [[Counter-Stirke]] - наиболее популярный HL мод;
:* VALVE - [[VALVe Software|корпорация, разработчик HL и CS]], также редко используется как синоним HLDM, подчеркивая название директории мода ("valve");
:* $MODDIR - способ условного обозначения корневой директории мода, например: ''cstrike'', ''valve'';
:* $MMDIR - способ условного обозначения относительного пути (относительно пути к $MODDIR) к корневой директории Metamod, по умолчанию: ''addons\metamod'';
:* $AMXMODX - способ условного обозначения относительного пути (относительно пути к $MODDIR) к корневой директории AMX Mod X, по умолчанию: ''addons\amxmodx''.

= Общие вопросы =

=== Где скачать последнюю версию AMX Mod X? ===
: Последнюю версию всегда можно скачать на официальном сайте AMX Mod X в [http://www.amxmodx.org/downloads.php разделе закачек].

=== А что именно качать? ===
: Качайте либо инсталлятор (AMX Mod X Full Installer), который включает базовый AMX Mod X пакет, все AMX Mod X дополнения для HL модов, а также AMXX-Studio (специализированный редактор AMX Mod X плагинов), либо, если готовы произвести установку AMX Mod X вручную, а также не желаете закачивать все существующие AMX Mod X дополнения для HL модов, качайте базовый архив (AMX Mod X Base), а затем дополнение для интересующего вас HL мода. Сама по себе базовая поставка практически во всех случаях будет достаточна только для HLDM мода.

=== Чем отличается AMX Mod X от AMX Mod? ===
: Буквой X ;). На самом деле отличий очень много:
:* AMX Mod X поддерживается до сих пор, а поддержка AMX Mod была завершена примерно в 2006 году;
:* функциональность AMX Mod X значительно превосходит AMX Mod, это также касается и расширенной поддержки других модов, в то время как AMX Mod поддерживал только HLDM, CS и CZ;
:* AMX Mod X принято считать быстрее AMX Mod;
:* плагины AMX Mod X не совместимы с плагинами AMX Mod;
:* плагины AMX Mod 0.9.9 совместимы с AMX Mod X, если последний работает в режиме совместимости(?);
:* плагины для AMX Mod имеют расширение ''.amx'', а плагины AMX Mod X - ''.amxx'';
:* ''TODO: дополнить список''

=== Как полностью отключить AMX Mod X? ===
: В файле ''$MMDIR\plugins.ini'' (по умолчанию: ''addons\metamod\plugins.ini'') необходимо закомментировать строку типа:
<pre>win32 addons\amxmodx\dlls\amxmodx_mm.dll</pre>
: т.е. добавить в начало строки cимвол(ы) начала комментария (''#'' или ''//''), например:
<pre>//win32 addons\amxmodx\dlls\amxmodx_mm.dll</pre>
: После чего следует сохранить изменения в файле и перезапустить сервер.

=== Как найти причину "падений" сервера? ===
: Прежде всего следует искать причину "падений" сервера в сообщениях об ошибках AMX Mod X, которые могут содержаться непосредственно в файлах AMX Mod X логов, находящихся в директории ''$AMXMODX\logs''.

: Если режим ''HL logging'' был активирован (серверная консольная команда ''log on''), следует попытаться найти причину "падений" в последних по дате изменения файлах директории HL логов - ''$MODDIR/logs'' (например, для ''cstrike'' мода по умолчанию: ''cstrike\logs'').

: Также, возможно, имеет смысл проверить системный журнал на наличие записей об ошибке самого приложения ''hl.exe'', перейдя в ''Панель управления(Control Panel)'' -> ''Администрирование(Administration)'' -> ''Просмотр событий(Event viewer)''.

: Чтобы убедиться, что причина "падений" действительно в AMX Mod X, необходимо полностью его [[#Как полностью отключить AMX Mod X?|отключить]]. После чего посредством серверной консольной команды ''meta list'' следует убедиться, что AMX Mod X не запущен. Теперь необходимо снова попытаться воспроизвести "падение" сервера. Если этого удалось достигнуть вновь, очевидно, что истоки проблемы кроются за пределами AMX Mod X.

: Иначе виновником "падений" может являться один из плагинов, поэтому для подтверждения данного предположения следует [[#Как полностью отключить/включить плагин (модуль)?|отключить]] все плагины без исключения. После чего посредством серверной консольной команды ''amxx plugins'' необходимо убедиться, что ни один из плагинов не запущен. Теперь следует снова попытаться воспроизвести "падение" сервера. Если этого удалось достигнуть вновь, очевидно, что истоки проблемы кроются за пределами плагинов - в самом AMX Mod X либо его модулях.

: Иначе виновником "падений" является один из плагинов, который необходимо локализовать. Если подозреваемых плагинов большое количество, то следует последовательно [[#Как полностью отключить/включить плагин (модуль)?|включать]] половину (т.е. сначала 1/2, затем 1/4, после чего 1/8 и так далее) отключенных плагинов с последующей проверкой на "падение". При возникновении "падений", очевидно, что плагин-виновник находится в последней группе включенных плагинов, поэтому необходимо последовательно [[#Как полностью отключить/включить плагин (модуль)?|выключать]] половину (т.е. сначала 1/2, затем 1/4, после чего 1/8 и так далее) плагинов именно последней группы с последующей проверкой на "падение". При исчезновении "падений" следует снова повторить вариант со включением/выключением плагинов, описанный выше, но уже для локализованной группы, которая с каждым повторением данных действий будет уменьшаться вдвое, и в конечном итоге в ней останется только один плагин, который и является причиной "падений".

: Метод проверки модулей на причастность к "падению" сервера аналогичен приведенному выше методу для плагинов.

=== Как запустить два различных сервера AMX Mod X? ===
: К примеру, вы хотите запустить два различных сервера из одной ''cstrike'' директории на базе различных AMX Mod X/Metamod плагинов, настроек и прочего. Это решаемо. Один из примеров для win32 системы приведен ниже:
:* cоздать отдельную AMX Mod X директорию с необходимыми файлами, например: ''.\addons\amxmodx2'';
:* в ''.\addons\amxmodx2\configs\core.ini'' везде изменить ''amxmodx'' на ''amxmodx2'';
:* создать отдельный файл загрузки Metamod плагинов, например: ''.\addons\metamod\plugins2.ini'';
:* в созданный ''plugins2.ini'' файл вписать: ''win32 addons\amxmodx2\dlls\amxmodx_mm.dll'';
:* создать в директории ''cstrike'' файл, например, с именем ''amxmodx2.cfg'', его содержимое должно быть следующим:
<pre>localinfo mm_pluginsfile "addons/metamod/plugins2.ini"
localinfo amxx_basedir "addons/amxmodx2"
localinfo amxx_cfg "addons/amxmodx2/configs/core.ini"
localinfo amxx_configsdir "addons/amxmodx2/configs"
localinfo amxx_customdir "addons/amxmodx2/custom"
localinfo amxx_datadir "addons/amxmodx2/data"
localinfo amxx_logdir "addons/amxmodx2/logs"
localinfo amxx_logs "addons/amxmodx2/logs"
localinfo amxx_modules "addons/amxmodx2/configs/modules.ini"
localinfo amxx_modulesdir "addons/amxmodx2/modules"
localinfo amxx_plugins "addons/amxmodx2/configs/plugins.ini"
localinfo amxx_pluginsdir "addons/amxmodx2/plugins"
localinfo amxx_vault "addons/amxmodx2/data/vault.ini"
localinfo csstats "addons/amxmodx2/data/csstats.dat"
localinfo csstats_score "addons/amxmodx2/data/csstats.amxx"
localinfo amx_basedir "addons/amxmodx2"
localinfo amx_configdir "addons/amxmodx2/configs"
localinfo amx_langdir "addons/amxmodx2/data/amxmod-lang"
localinfo amx_logdir "addons/amxmodx2/logs"
localinfo amx_modulesdir "addons/amxmodx2/modules"
localinfo amx_pluginsdir "addons/amxmodx2/plugins"</pre>
: Теперь второй сервер необходимо будет запускать с параметром командной строки: ''+exec amxmodx2.cfg''.

= Вопросы по плагинам =

== Общие вопросы ==

=== Где и как искать плагины? ===
: Предварительно отметим, что условно AMX Mod X плагины можно разделить на следующие категории: стандартные, официально одобренные, официально отклоненные и неофициальные.

: Одобренные плагины можно искать с помощью специальной [http://www.amxmodx.org/compiler.php поисковой системы AMX Mod X плагинов].

: Также имеется возможность использовать [http://forums.alliedmods.net/search.php поисковую систему официального форума] (примечание: было замечено, что в последнее время эта система функционирует не совсем корректно). В поле '''Search in Forum(s)''' отметьте '''Approved Plugins''', также, зажав клавишу Ctrl, можно отметить интересующие вас секции из подраздела '''High-Traffic Plugins'''. Чтобы искать неофициальные плагины, следует также воспользоваться [http://forums.alliedmods.net/search.php поисковой системой официального форума], правда, в поле '''Search in Forum(s)''' необходимо выбрать '''Unapproved/Old Plugins'''. Если для вас не имеет значения статус плагина, и вы склонны к экспериментам, осуществляйте поиск по категории '''Plugins''', которая включает в себя одобренные, отклоненные, недавно опубликованные, вполне возможно, "сырые" плагины, а также темы-запросы, в которых могут быть "быстро написанные" плагины.

: Особенность поиска на официальных форумах еще состоит в том, что при вводе слова система ищет именно слова (без учета регистра), т.е. фрагменты, разделенные слева и справа пробелами. Т.о., к примеру, набрав для поиска слово ''FCOS'' вы не найдете нужного вам плагина, хотя есть тема, в которой присутствует текст ''[fcos]''. Для этого необходимо использовать в поиске строку ''*FCOS*''. Немного поработав с поисковой формой форума, вы легко освоите эту систему. Единственное возможное для некоторых неудобство - практически все описания плагинов написаны на английском языке.

: Неофициальные плагины также можно попробовать искать с помощью общеизвестных поисковых систем: Google, Yandex, Rambler и др.

=== Сколько плагинов сейчас выпущено под AMX Mod X? ===
: "Тонны" плагинов. Но, к сожалению, качеством и надежностью б'''о'''льшая половина из них не белещет. К тому же некоторые плагины, "заброшены" авторами и не обновляются, что приводит даже к несовместимости с новыми версиями AMX Mod X.

=== Как устанавливать/удалять плагины? ===
: Обратитесь к статье [[Ru Configuring AMX Mod X|Кофигурирование AMX Mod X]].

=== Как полностью отключить/включить плагин (модуль)? ===
: Чтобы полностью отключить плагин (модуль), в файле ''$AMXMODX\configs\plugins.ini'' (''$AMXMODX\configs\modules.ini'') необходимо закомментировать имя плагина (модуля), т.е. поставить перед ним символ комментария - точку с запятой. Примеры для плагина и модуля приведены ниже:
<pre>;myplugin.amxx</pre>
<pre>;fakemeta</pre>
: Затем следует сохранить изменения в файле и перезапустить сервер. Для случая с плагином в перезапуске сервера необходимости нет - достаточно лишь смены карты.
: Чтобы включить плагин (модуль), следует проделать действия, являющиеся обратными вышеописанным, при этом смена карты является достаточным условием и для случая с модулем.

=== Что такое стандартные плагины? ===
: Это плагины, которые входят в стандартную поставку AMX Mod X, т.е. те, которые находятся непосредственно после установки AMX Mod X в папках: ''$AMXMODX\plugins'' (''.amxx'' - откомпилированные плагины) и ''$AMXMODX\scripting'' (''.sma'' - исходные коды плагинов).

=== Как узнать, в каком плагине зарегистрирована та или иная переменная (команда)? ===
: В серверной консоли наберите команду ''amxx cvars'' ( ''amxx cmds'' ). Выделите текст, скопируйте в файл, там сделайте поиск искомой переменной (команды). В правой колонке будет стоять имя плагина, в котором она и зарегистрирована.

: Примечание: если сервер запущен с параметром -console, то поиск можно осуществлять непосредственно в окне сервера посредством доступа к диалоговому окну поиска через оконное меню.

=== Как активировать/отключить плагин(ы) лишь на конкретной(ых) карте(ах)? ===
: Чтобы активировать плагин(ы) ''плагин1.amxx, плагин2.amxx, <...>, плагинN.amxx'' на всех картах, кроме конкретной(ых) ''карта1, карта2, <...>, картаN'', помимо добавления в ''$AMXMODX\consfigs\plugins.ini'' строк:
<pre>плагин1.amxx
плагин2.amxx
<...>
плагинN.amxx</pre>
: необходимо также создать файлы:
<pre>$AMXMODX\consfigs\maps\plugins-карта1.ini
$AMXMODX\consfigs\maps\plugins-карта2.ini
<...>
$AMXMODX\consfigs\maps\plugins-картаN.ini</pre>
: с содержанием:
<pre>плагин1.amxx disabled
плагин2.amxx disabled
<...>
плагинN.amxx disabled</pre>

: Чтобы активировать плагин(ы) ''плагин1.amxx, плагин2.amxx, <...>, плагинN.amxx'' лишь на конкретной(ых) ''карта1, карта2, <...>, картаN'', необходимо только лишь создать файлы:
<pre>$AMXMODX\consfigs\maps\plugins-карта1.ini
$AMXMODX\consfigs\maps\plugins-карта2.ini
<...>
$AMXMODX\consfigs\maps\plugins-картаN.ini</pre>
: с содержанием:
<pre>плагин1.amxx
плагин2.amxx
<...>
плагинN.amxx</pre>

: Примечания:
:* ''плагин1.amxx, плагин2.amxx, <...>, плагинN.amxx'' - это имена файлов ваших плагинов, количество которых может быть один и более;
:* ''карта1, карта2, <...>, картаN'' - это имена файлов (без расширения ''.bsp'') ваших карт, количество которых может быть одна и более;

=== Я перевел на русский языковой файл плагина, а текст в игре отображается криво ===
: Скорее всего вы не сохранили файл в UTF-8 кодировке. Даже если вы это сделали, проверьте что в начале файла нет маркера кодировки, потому что некоторые редакторы его вставляют без предупреждения. Для этого надо использовать редактор или режим, который НЕ понимает UTF-8, потому что unicode редактор не отображает такой маркер.
: Имейте в виду, что в консоли сервера, работающего в режиме ''-console'', переведенный текст не будет отображаться по-русски.

== Вопросы по стандартным плагинам ==

=== Как увеличить число карт в стандартном голосовании? ===
: Откройте файл ''$AMXMODX\scripting\mapchooser.sma'', замените число ''3'' в строке:
<pawn>#define SELECTMAPS 3</pawn>
: на требуемое, затем [[#Как компилировать плагины?|откомпилируйте]] плагин и замените исходный.

=== Как увеличить число администраторов? ===
: В файле ''$AMXMODX\scripting\admin.sma'' замените число ''64'' на требуемое значение в строке:
<pawn>#define MAX_ADMINS 64</pawn>
: Не ставьте слишком большие значения. Не забудьте [[#Как компилировать плагины?|перекомпилировать]] плагин и заменить исходный новым.
: В AMX Mod X 1.8.X и выше такой проблемы не существует, т.к. там реализован динамический список админов.

=== Почему клиент не получает права админа по IP? ===
:Данная проблема возникает на публичных Non-Steam (патченных) интернет-серверах c значением ''sv_lan'' равным ''0'' при подключении Steam/Non-Steam клиентов.
: Сначала убедитесь, что у вас нединамический внешний IP. Динамический IP означает, что каждый раз, подключась к Интернету, вам назначается новый внешний IP (обычно из какого-то фиксированного диапазона). Для этого обратитесь к вашему провайдеру. Далее необходимо сверить, правильно ли вы прописали доступ в файле users.ini. Для этого проверьте свой внешний IP на страничке [http://myip.ru/ myip.ru]. Запомните его. Откройте файл user.ini и убедитесь что там есть такая запись:
"<ваш_ip>" "<ваш_пароль>" "<ваши_флаги>" "d<другие_модификаторы>"
:В поле ''<ваш_ip>'' должен быть вбит запомненный ранее IP. Обратите внимание на модификатор '''d'''. Без него проверка на IP проводиться НЕ будет. При указании IP старайтесь не использовать номер порта (знак двоеточия и то, что справа от него).
: Если все правильно, а вы все равно не становитесь администратором на сервере, то, скорее всего, проблема в том, что вы не прошли авторизацию на сервере. Для этого выполните команду ''users'' или ''stat'' в консоли сервера и обратите внимание на значение в колонке ''userid''. Если напротив потенциального админа стоит '''STEAM_ID_PENDING''', то это означает, что сервер криво заломан, и он не авторизовал данного игрока. В свою очередь это значит, что функция ''client_authorized(id)'' не была вызвана для всех(!) активных AMX Mod X плагинов. Если открыть файл ''admin.sma'', то можно увидеть следующее:
<pawn>public client_authorized(id) {
return get_cvar_num("amx_mode") ? accessUser(id) : PLUGIN_CONTINUE
}</pawn>
: Это и есть проверка клиента на админа. Чтобы эта функция вызывалась всегда, ''client_authorized'' надо переименовать в ''client_putinserver'', а существующую функцию ''client_putinserver'' либо удалить, либо [[Ru_Fundamental_Basics_of_AMX_Mod_X_Scripting#Комментарии|закомментировать]].

=== Как заставить команду amx_who выводить IP вместо ID? ===
: В файле ''admincmd.sma'' в указанном ниже месте
<pawn>public cmdWho(id, level, cid)
{
//...
console_print(id, "^n%s:^n # %-16.15s %-20s %-8s %-4.3s %-4.3s %s", cl_on_server, "nick", "authid", "userid", lImm, lRes, lAccess)
for (new a = 0; a < inum; ++a)
{
get_user_authid(players[a], authid, 31)
//...
}
//...
}</pawn>
: замените:
<pawn>console_print(id, "^n%s:^n # %-16.15s %-20s %-8s %-4.3s %-4.3s %s", cl_on_server, "nick", "authid", "userid", lImm, lRes, lAccess)</pawn>
: на:
<pawn>console_print(id, "^n%s:^n # %-16.15s %-20s %-8s %-4.3s %-4.3s %s", cl_on_server, "nick", "ip", "userid", lImm, lRes, lAccess)</pawn>
: а также:
<pawn>get_user_authid(players[a], authid, 31)</pawn>
: на:
<pawn>get_user_ip(players[a], authid, 31, 1)</pawn>
: Сохраните файл и [[#Как компилировать плагины?|перекомпилируйте]] плагин.

=== А как дать всем доступ к команде amx_who? ===
: По умолчанию, команда доступна только игрокам с правами '''y''' (т.е. это признак админа). Чтобы разрешить пользоваться ею всем игрокам, надо открыть файл ''admincmd.sma'', и в строке
<pawn>register_concmd("amx_who", "cmdWho", ADMIN_ADMIN, "- displays who is on server")</pawn>
: заменить ''ADMIN_ADMIN'' на ''ADMIN_ALL'' и [[#Как компилировать плагины?|перекомпилировать]] плагин.
: В AMX 1.8.X и выше доступны стандартные средства переопределения прав доступа к командам без исправления самих плагинов (''TODO: ссылка?'').

= Вопросы по StatsX =

=== Что такое StatsX? ===
: ''StatsX'' - это статистическое расширение AMX Mod X, предназначенное исключительно для Counter-Strike мода, реализованное в виде плагинов ''statsx.amxx'', ''statscfg.amxx'', ''stats_logging.amxx'', а также в модуле ''csx'', являющимся необходимым для работы данных плагинов.

=== Как изменять конфигурацию StatsX? ===
: Изменять конфигурацию StatsX можно тремя способами:
:* посредством HUD-меню, вызываемого консольной командой ''amx_statscfgmenu'';
:* посредством расширенных возможностей консольной команды ''amx_statscfg'';
:* посредством редактирования текстового файла конфигурации StatsX - ''$AMXMODX\configs\stats.ini''.

=== Как редактировать данные статистики StatsX? ===
: Данные статистики StatsX хранятся в файле ''$AMXMODX\data\csstats.dat'', который не является текстовым, поэтому редактировать данные можно либо с помощью утилиты ''WinCSX'' (для платформы MS Windows), расположенной по адресу ''$AMXMODX\data\wincsx.exe'', либо с помощью сторонних методов, основанных на принципе работы со [[Stats File Formats (AMX Mod X)|структурой данных файла csstats.dat]].

=== Как очистить данные статистики StatsX? ===
: Очистить данные статистики StatsX можно тремя способами:
:* штатным методом StatsX, заключающимся в установке значения ''1'' для серверной консольной переменной ''csstats_reset'' и последующей смене карты;
:* посредством нажатия кнопки ''Clear stats'' утилиты WinCSX;
:* посредством удаления файла данных статистики ''$AMXMODX\data\csstats.dat''.

= Вопросы по компилированию =

=== Что такое компиляция? ===
: Это процесс, который переводит текстовые файлы (*.sma), содержащие исходный код (т.е. инструкции для AMX Mod X, который их исполняет), в формат, более пригодный для исполнения. За счет этого скорость выполнения плагинов возрастает многократно, упрощается разработка "движка", который эти плагины исполняет, а также в некотором смысле защищается авторский код. Почему в "некотором смысле"? Потому что все AMX Mod X плагины должны публиковаться под лицензией GNU General Public License. В случае публикации плагина лицензия обязывает также публиковать и его исходный код. Откомпилированные плагины имеют расширение .amxx. Именно файлы этого типа, а не .sma, должны указываться в файле plugins.ini для последующей корректной загрузки плагина.

=== Как компилировать плагины? ===
: Базовую информацию вы можете найти в статье [[Ru Compiling Plugins (AMX Mod X)|Компилирование плагинов]].

=== Как упростить процесс компилирования? ===
: Можно написать стороннюю программу или скрипт, например такой, как пакетный Batch файл. Например, создайте файл ''make.bat'' со следующим содержимым:
<pre>@amxxpc.exe %1 -i.\include -o.\compiled\%1</pre>
: Чтобы с помощью него откомпилировать плагин, необходимо выполнить следующую команду:
<pre>make.bat my_plugin.sma</pre>
: В итоге откомпилированный файл будет помещен в каталог ''compiled'' текущей директории. Если его там нет, значит в процессе компилирования возникли фатальные ошибки, которые выводятся на экран.
: Если вам необходимо (например, в случае ошибок) отправить кому-нибудь результат компиляции, можете перенаправить вывод информации о процессе компилирования в файл, например таким образом:
<pre>make.bat my_plugin.sma > my_plugin.log</pre>

=== Компилятор выводит "max. usage is unknown, due to recursion" ===
: Ничего страшного - просто компилятор не может вычислить предполагаемый объем памяти, используемый вашим плагином.

= Вопросы по скриптингу =

=== С чего начать? ===
: С со статьи [[Ru Fundamental Basics of AMX Mod X Scripting|Фундаментальные основы AMX Mod X скриптинга]].

=== А стоит ли вообще начинать? ===
: В зависимости от того, какую цель вы преследуете, а также от вашего желания и потенциала. Знание английского языка (чтение) будет огромным плюсом во время обучения, иначе постигать азы будет очень сложно. CS является закрытым проектом без исходных кодов, поэтому многие новые (неизученные) элементы приходится постигать через проведение экспериментов.

Ru AMX Mod X FAQ

2008-10-19T15:31:11Z

VEN: /* Как полностью отключить/включить плагин (модуль)? */

[[Category:Russian]]
[[Category:Ru:AMX Mod X]]

= Общие положения, термины, сокращения и условные обозначения =
:* HL или HL1 - аббревиатура от [[Half-Life 1|Half-Life]] (часть первая);
:* Mod - "мод", модификация - дополнение к чему-либо, как правило, расширяющее/изменяющее функциональность;
:* HL Engine - "движок" Half-Life - "центральный модуль", осуществляющий выполнение базовых "общемодовых" задач;
:* MM - [[Metamod]] - сторонний мод особого типа, является промежуточным звеном в системе "HL движок - HL мод";
:* AMXX - аббревиатура от [[AMX Mod X]] - Metamod plugin ("плагин"), своего рода Metamod мод;
:* Map - "карта" - определяет внешний вид территории, на которой происходит игровое действие;
:* World - "мир" - все пространство, которое занимает карта, а также область, находящаяся за картой;
:* Spawn - "спавн" - момент, когда игрок появляется в мире, обретая физическое тело;
:* SinglePlayer - "синглплеер" - игровой тип, когда одновременно в игре может участвовать только один игрок;
:* MultiPlayer - "мультиплеер" - игровой тип, когда одновременно в игре может участвовать несколько игроков;
:* DM - аббревиатура от Death Match - динамичный мультиплеер тип игры, когда после "смерти" игрока происходит его скорый спавн ("респавн");
:* HLDM - аббревиатура от Half-Life Death Match - оригинальный HL мод DM типа;
:* CS - аббревиатура от [[Counter-Stirke]] - наиболее популярный HL мод;
:* VALVE - [[VALVe Software|корпорация, разработчик HL и CS]], также редко используется как синоним HLDM, подчеркивая название директории мода ("valve");
:* $MODDIR - способ условного обозначения корневой директории мода, например: ''cstrike'', ''valve'';
:* $MMDIR - способ условного обозначения относительного пути (относительно пути к $MODDIR) к корневой директории Metamod, по умолчанию: ''addons\metamod'';
:* $AMXMODX - способ условного обозначения относительного пути (относительно пути к $MODDIR) к корневой директории AMX Mod X, по умолчанию: ''addons\amxmodx''.

= Общие вопросы =

=== Где скачать последнюю версию AMX Mod X? ===
: Последнюю версию всегда можно скачать на официальном сайте AMX Mod X в [http://www.amxmodx.org/downloads.php разделе закачек].

=== А что именно качать? ===
: Качайте либо инсталлятор (AMX Mod X Full Installer), который включает базовый AMX Mod X пакет, все AMX Mod X дополнения для HL модов, а также AMXX-Studio (специализированный редактор AMX Mod X плагинов), либо, если готовы произвести установку AMX Mod X вручную, а также не желаете закачивать все существующие AMX Mod X дополнения для HL модов, качайте базовый архив (AMX Mod X Base), а затем дополнение для интересующего вас HL мода. Сама по себе базовая поставка практически во всех случаях будет достаточна только для HLDM мода.

=== Чем отличается AMX Mod X от AMX Mod? ===
: Буквой X ;). На самом деле отличий очень много:
:* AMX Mod X поддерживается до сих пор, а поддержка AMX Mod была завершена примерно в 2006 году;
:* функциональность AMX Mod X значительно превосходит AMX Mod, это также касается и расширенной поддержки других модов, в то время как AMX Mod поддерживал только HLDM, CS и CZ;
:* AMX Mod X принято считать быстрее AMX Mod;
:* плагины AMX Mod X не совместимы с плагинами AMX Mod;
:* плагины AMX Mod 0.9.9 совместимы с AMX Mod X, если последний работает в режиме совместимости(?);
:* плагины для AMX Mod имеют расширение ''.amx'', а плагины AMX Mod X - ''.amxx'';
:* ''TODO: дополнить список''

=== Как полностью отключить AMX Mod X? ===
: В файле ''$MMDIR\plugins.ini'' (по умолчанию: ''addons\metamod\plugins.ini'') необходимо закомментировать строку типа:
<pre>win32 addons\amxmodx\dlls\amxmodx_mm.dll</pre>
: т.е. добавить в начало строки cимвол(ы) начала комментария (''#'' или ''//''), например:
<pre>//win32 addons\amxmodx\dlls\amxmodx_mm.dll</pre>
: После чего следует сохранить изменения в файле и перезапустить сервер.

=== Как найти причину "падений" сервера? ===
: Чтобы убедиться, что причина "падений" действительно в AMX Mod X, необходимо полностью его [[#Как полностью отключить AMX Mod X?|отключить]]. После чего посредством серверной консольной команды ''meta list'' следует убедиться, что AMX Mod X не запущен. Теперь необходимо снова попытаться воспроизвести "падение" сервера. Если этого удалось достигнуть вновь, очевидно, что истоки проблемы кроются за пределами AMX Mod X.

: Иначе виновником "падений" может являться один из плагинов, поэтому для подтверждения данного предположения следует [[#Как полностью отключить/включить плагин (модуль)?|отключить]] все плагины без исключения. После чего посредством серверной консольной команды ''amxx plugins'' необходимо убедиться, что ни один из плагинов не запущен. Теперь следует снова попытаться воспроизвести "падение" сервера. Если этого удалось достигнуть вновь, очевидно, что истоки проблемы кроются за пределами плагинов - в самом AMX Mod X либо его модулях.

: Иначе виновником "падений" является один из плагинов, который необходимо локализовать. Если подозреваемых плагинов большое количество, то следует последовательно [[#Как полностью отключить/включить плагин (модуль)?|включать]] половину (т.е. сначала 1/2, затем 1/4, после чего 1/8 и так далее) отключенных плагинов с последующей проверкой на "падение". При возникновении "падений", очевидно, что плагин-виновник находится в последней группе включенных плагинов, поэтому необходимо последовательно [[#Как полностью отключить/включить плагин (модуль)?|выключать]] половину (т.е. сначала 1/2, затем 1/4, после чего 1/8 и так далее) плагинов именно последней группы с последующей проверкой на "падение". При исчезновении "падений" следует снова повторить вариант со включением/выключением плагинов, описанный выше, но уже для локализованной группы, которая с каждым повторением данных действий будет уменьшаться, и в конечном итоге в ней останется только один плагин, который и является причиной "падений".

: Метод проверки модулей на причастность к "падению" сервера аналогичен приведенному выше методу для плагинов.

: Если ничего из вышеописанного не прояснило ситуацию, и если режим ''HL logging'' был активирован (серверная консольная команда ''log on''), следует попытаться найти причину в последних по дате изменения файлах директории HL логов - ''$MODDIR/logs'' (например, для ''cstrike'' мода - по умолчанию ''cstrike\logs'').

: Также, возможно, есть смысл проверить системный журнал на наличие записей об ошибке самого приложения ''hl.exe'', перейдя в ''Панель управления(Control Panel)'' -> ''Администрирование(Administration)'' -> ''Просмотр событий(Event viewer)''.

=== Как запустить два различных сервера AMX Mod X? ===
: К примеру, вы хотите запустить два различных сервера из одной ''cstrike'' директории на базе различных AMX Mod X/Metamod плагинов, настроек и прочего. Это решаемо. Один из примеров для win32 системы приведен ниже:
:* cоздать отдельную AMX Mod X директорию с необходимыми файлами, например: ''.\addons\amxmodx2'';
:* в ''.\addons\amxmodx2\configs\core.ini'' везде изменить ''amxmodx'' на ''amxmodx2'';
:* создать отдельный файл загрузки Metamod плагинов, например: ''.\addons\metamod\plugins2.ini'';
:* в созданный ''plugins2.ini'' файл вписать: ''win32 addons\amxmodx2\dlls\amxmodx_mm.dll'';
:* создать в директории ''cstrike'' файл, например, с именем ''amxmodx2.cfg'', его содержимое должно быть следующим:
<pre>localinfo mm_pluginsfile "addons/metamod/plugins2.ini"
localinfo amxx_basedir "addons/amxmodx2"
localinfo amxx_cfg "addons/amxmodx2/configs/core.ini"
localinfo amxx_configsdir "addons/amxmodx2/configs"
localinfo amxx_customdir "addons/amxmodx2/custom"
localinfo amxx_datadir "addons/amxmodx2/data"
localinfo amxx_logdir "addons/amxmodx2/logs"
localinfo amxx_logs "addons/amxmodx2/logs"
localinfo amxx_modules "addons/amxmodx2/configs/modules.ini"
localinfo amxx_modulesdir "addons/amxmodx2/modules"
localinfo amxx_plugins "addons/amxmodx2/configs/plugins.ini"
localinfo amxx_pluginsdir "addons/amxmodx2/plugins"
localinfo amxx_vault "addons/amxmodx2/data/vault.ini"
localinfo csstats "addons/amxmodx2/data/csstats.dat"
localinfo csstats_score "addons/amxmodx2/data/csstats.amxx"
localinfo amx_basedir "addons/amxmodx2"
localinfo amx_configdir "addons/amxmodx2/configs"
localinfo amx_langdir "addons/amxmodx2/data/amxmod-lang"
localinfo amx_logdir "addons/amxmodx2/logs"
localinfo amx_modulesdir "addons/amxmodx2/modules"
localinfo amx_pluginsdir "addons/amxmodx2/plugins"</pre>
: Теперь второй сервер необходимо будет запускать с параметром командной строки: ''+exec amxmodx2.cfg''.

= Вопросы по плагинам =

== Общие вопросы ==

=== Где и как искать плагины? ===
: Предварительно отметим, что условно AMX Mod X плагины можно разделить на следующие категории: стандартные, официально одобренные, официально отклоненные и неофициальные.

: Одобренные плагины можно искать с помощью специальной [http://www.amxmodx.org/compiler.php поисковой системы AMX Mod X плагинов].

: Также имеется возможность использовать [http://forums.alliedmods.net/search.php поисковую систему официального форума] (примечание: было замечено, что в последнее время эта система функционирует не совсем корректно). В поле '''Search in Forum(s)''' отметьте '''Approved Plugins''', также, зажав клавишу Ctrl, можно отметить интересующие вас секции из подраздела '''High-Traffic Plugins'''. Чтобы искать неофициальные плагины, следует также воспользоваться [http://forums.alliedmods.net/search.php поисковой системой официального форума], правда, в поле '''Search in Forum(s)''' необходимо выбрать '''Unapproved/Old Plugins'''. Если для вас не имеет значения статус плагина, и вы склонны к экспериментам, осуществляйте поиск по категории '''Plugins''', которая включает в себя одобренные, отклоненные, недавно опубликованные, вполне возможно, "сырые" плагины, а также темы-запросы, в которых могут быть "быстро написанные" плагины.

: Особенность поиска на официальных форумах еще состоит в том, что при вводе слова система ищет именно слова (без учета регистра), т.е. фрагменты, разделенные слева и справа пробелами. Т.о., к примеру, набрав для поиска слово ''FCOS'' вы не найдете нужного вам плагина, хотя есть тема, в которой присутствует текст ''[fcos]''. Для этого необходимо использовать в поиске строку ''*FCOS*''. Немного поработав с поисковой формой форума, вы легко освоите эту систему. Единственное возможное для некоторых неудобство - практически все описания плагинов написаны на английском языке.

: Неофициальные плагины также можно попробовать искать с помощью общеизвестных поисковых систем: Google, Yandex, Rambler и др.

=== Сколько плагинов сейчас выпущено под AMX Mod X? ===
: "Тонны" плагинов. Но, к сожалению, качеством и надежностью б'''о'''льшая половина из них не белещет. К тому же некоторые плагины, "заброшены" авторами и не обновляются, что приводит даже к несовместимости с новыми версиями AMX Mod X.

=== Как устанавливать/удалять плагины? ===
: Обратитесь к статье [[Ru Configuring AMX Mod X|Кофигурирование AMX Mod X]].

=== Как полностью отключить/включить плагин (модуль)? ===
: Чтобы полностью отключить плагин (модуль), в файле ''$AMXMODX\configs\plugins.ini'' (''$AMXMODX\configs\modules.ini'') необходимо закомментировать имя плагина (модуля), т.е. поставить перед ним символ комментария - точку с запятой. Примеры для плагина и модуля:
<pre>;myplugin.amxx</pre>
<pre>;fakemeta</pre>
: После чего следует сохранить изменения в файле и перезапустить сервер. Для случая с плагином в перезапуске сервера необходимости нет - достаточно лишь смены карты.
: Чтобы включить плагин (модуль) следует проделать действия, являющиеся обратными вышеописанным, при этом смена карты является достаточным условием и для случая с модулем.

=== Что такое стандартные плагины? ===
: Это плагины, которые входят в стандартную поставку AMX Mod X, т.е. те, которые находятся непосредственно после установки AMX Mod X в папках: ''$AMXMODX\plugins'' (''.amxx'' - откомпилированные плагины) и ''$AMXMODX\scripting'' (''.sma'' - исходные коды плагинов).

=== Как узнать, в каком плагине зарегистрирована та или иная переменная (команда)? ===
: В серверной консоли наберите команду ''amxx cvars'' ( ''amxx cmds'' ). Выделите текст, скопируйте в файл, там сделайте поиск искомой переменной (команды). В правой колонке будет стоять имя плагина, в котором она и зарегистрирована. Примечание: если сервер запущен с параметром -console, то поиск можно осуществлять непосредственно в окне сервера посредством доступа к диалоговому окну поиска через оконное меню.

=== Как активировать/отключить плагин(ы) лишь на конкретной(ых) карте(ах)? ===
: Чтобы активировать плагин(ы) ''плагин1.amxx, плагин2.amxx, <...>, плагинN.amxx'' на всех картах, кроме конкретной(ых) ''карта1, карта2, <...>, картаN'', помимо добавления в ''$AMXMODX\consfigs\plugins.ini'' строк:
<pre>плагин1.amxx
плагин2.amxx
<...>
плагинN.amxx</pre>
: необходимо также создать файлы:
<pre>$AMXMODX\consfigs\maps\plugins-карта1.ini
$AMXMODX\consfigs\maps\plugins-карта2.ini
<...>
$AMXMODX\consfigs\maps\plugins-картаN.ini</pre>
: с содержанием:
<pre>плагин1.amxx disabled
плагин2.amxx disabled
<...>
плагинN.amxx disabled</pre>

: Чтобы активировать плагин(ы) ''плагин1.amxx, плагин2.amxx, <...>, плагинN.amxx'' лишь на конкретной(ых) ''карта1, карта2, <...>, картаN'', необходимо только лишь создать файлы:
<pre>$AMXMODX\consfigs\maps\plugins-карта1.ini
$AMXMODX\consfigs\maps\plugins-карта2.ini
<...>
$AMXMODX\consfigs\maps\plugins-картаN.ini</pre>
: с содержанием:
<pre>плагин1.amxx
плагин2.amxx
<...>
плагинN.amxx</pre>

: Примечания:
:* ''плагин1.amxx, плагин2.amxx, <...>, плагинN.amxx'' - это имена файлов ваших плагинов, количество которых может быть один и более;
:* ''карта1, карта2, <...>, картаN'' - это имена файлов (без расширения ''.bsp'') ваших карт, количество которых может быть одна и более;

=== Я перевел на русский языковой файл плагина, а текст в игре отображается криво ===
: Скорее всего вы не сохранили файл в UTF-8 кодировке. Даже если вы это сделали, проверьте что в начале файла нет маркера кодировки, потому что некоторые редакторы его вставляют без предупреждения. Для этого надо использовать редактор или режим, который НЕ понимает UTF-8, потому что unicode редактор не отображает такой маркер.
: Имейте в виду, что в консоли сервера, работающего в режиме ''-console'', переведенный текст не будет отображаться по-русски.

== Вопросы по стандартным плагинам ==

=== Как увеличить число карт в стандартном голосовании? ===
: Откройте файл ''$AMXMODX\scripting\mapchooser.sma'', замените число ''3'' в строке:
<pawn>#define SELECTMAPS 3</pawn>
: на требуемое, затем [[#Как компилировать плагины?|откомпилируйте]] плагин и замените исходный.

=== Как увеличить число администраторов? ===
: В файле ''$AMXMODX\scripting\admin.sma'' замените число ''64'' на требуемое значение в строке:
<pawn>#define MAX_ADMINS 64</pawn>
: Не ставьте слишком большие значения. Не забудьте [[#Как компилировать плагины?|перекомпилировать]] плагин и заменить исходный новым.
: В AMX Mod X 1.8.X и выше такой проблемы не существует, т.к. там реализован динамический список админов.

=== Почему клиент не получает права админа по IP? ===
:Данная проблема возникает на публичных Non-Steam (патченных) интернет-серверах c значением ''sv_lan'' равным ''0'' при подключении Steam/Non-Steam клиентов.
: Сначала убедитесь, что у вас нединамический внешний IP. Динамический IP означает, что каждый раз, подключась к Интернету, вам назначается новый внешний IP (обычно из какого-то фиксированного диапазона). Для этого обратитесь к вашему провайдеру. Далее необходимо сверить, правильно ли вы прописали доступ в файле users.ini. Для этого проверьте свой внешний IP на страничке [http://myip.ru/ myip.ru]. Запомните его. Откройте файл user.ini и убедитесь что там есть такая запись:
"<ваш_ip>" "<ваш_пароль>" "<ваши_флаги>" "d<другие_модификаторы>"
:В поле ''<ваш_ip>'' должен быть вбит запомненный ранее IP. Обратите внимание на модификатор '''d'''. Без него проверка на IP проводиться НЕ будет. При указании IP старайтесь не использовать номер порта (знак двоеточия и то, что справа от него).
: Если все правильно, а вы все равно не становитесь администратором на сервере, то, скорее всего, проблема в том, что вы не прошли авторизацию на сервере. Для этого выполните команду ''users'' или ''stat'' в консоли сервера и обратите внимание на значение в колонке ''userid''. Если напротив потенциального админа стоит '''STEAM_ID_PENDING''', то это означает, что сервер криво заломан, и он не авторизовал данного игрока. В свою очередь это значит, что функция ''client_authorized(id)'' не была вызвана для всех(!) активных AMX Mod X плагинов. Если открыть файл ''admin.sma'', то можно увидеть следующее:
<pawn>public client_authorized(id) {
return get_cvar_num("amx_mode") ? accessUser(id) : PLUGIN_CONTINUE
}</pawn>
: Это и есть проверка клиента на админа. Чтобы эта функция вызывалась всегда, ''client_authorized'' надо переименовать в ''client_putinserver'', а существующую функцию ''client_putinserver'' либо удалить, либо [[Ru_Fundamental_Basics_of_AMX_Mod_X_Scripting#Комментарии|закомментировать]].

=== Как заставить команду amx_who выводить IP вместо ID? ===
: В файле ''admincmd.sma'' в указанном ниже месте
<pawn>public cmdWho(id, level, cid)
{
//...
console_print(id, "^n%s:^n # %-16.15s %-20s %-8s %-4.3s %-4.3s %s", cl_on_server, "nick", "authid", "userid", lImm, lRes, lAccess)
for (new a = 0; a < inum; ++a)
{
get_user_authid(players[a], authid, 31)
//...
}
//...
}</pawn>
: замените:
<pawn>console_print(id, "^n%s:^n # %-16.15s %-20s %-8s %-4.3s %-4.3s %s", cl_on_server, "nick", "authid", "userid", lImm, lRes, lAccess)</pawn>
: на:
<pawn>console_print(id, "^n%s:^n # %-16.15s %-20s %-8s %-4.3s %-4.3s %s", cl_on_server, "nick", "ip", "userid", lImm, lRes, lAccess)</pawn>
: а также:
<pawn>get_user_authid(players[a], authid, 31)</pawn>
: на:
<pawn>get_user_ip(players[a], authid, 31, 1)</pawn>
: Сохраните файл и [[#Как компилировать плагины?|перекомпилируйте]] плагин.

=== А как дать всем доступ к команде amx_who? ===
: По умолчанию, команда доступна только игрокам с правами '''y''' (т.е. это признак админа). Чтобы разрешить пользоваться ею всем игрокам, надо открыть файл ''admincmd.sma'', и в строке
<pawn>register_concmd("amx_who", "cmdWho", ADMIN_ADMIN, "- displays who is on server")</pawn>
: заменить ''ADMIN_ADMIN'' на ''ADMIN_ALL'' и [[#Как компилировать плагины?|перекомпилировать]] плагин.
: В AMX 1.8.X и выше доступны стандартные средства переопределения прав доступа к командам без исправления самих плагинов (''TODO: ссылка?'').

= Вопросы по StatsX =

=== Что такое StatsX? ===
: ''StatsX'' - это статистическое расширение AMX Mod X, предназначенное исключительно для Counter-Strike мода, реализованное в виде плагинов ''statsx.amxx'', ''statscfg.amxx'', ''stats_logging.amxx'', а также в модуле ''csx'', являющимся необходимым для работы данных плагинов.

=== Как изменять конфигурацию StatsX? ===
: Изменять конфигурацию StatsX можно тремя способами:
:* посредством HUD-меню, вызываемого консольной командой ''amx_statscfgmenu'';
:* посредством расширенных возможностей консольной команды ''amx_statscfg'';
:* посредством редактирования текстового файла конфигурации StatsX - ''$AMXMODX\configs\stats.ini''.

=== Как редактировать данные статистики StatsX? ===
: Данные статистики StatsX хранятся в файле ''$AMXMODX\data\csstats.dat'', который не является текстовым, поэтому редактировать данные можно либо с помощью утилиты ''WinSCX'' (для платформы MS Windows), расположенной по адресу ''$AMXMODX\data\wincsx.exe'', либо с помощью сторонних методов, основанных на принципе работы со [[Stats File Formats (AMX Mod X)|структурой данных файла csstats.dat]].

=== Как очистить статистику StatsX? ===
: Очистить статистику StatsX можно тремя способами:
:* штатным методом StatsX, заключающимся в установке значения ''1'' для серверной консольной переменной ''csstats_reset'' и последующей смене карты;
:* посредством нажатия кнопки ''Clear stats'' утилиты WinSCX;
:* посредством удаления файла ''$AMXMODX\data\csstats.dat''.

= Вопросы по компилированию =

=== Что такое компиляция? ===
: Это процесс, который переводит текстовые файлы (*.sma), содержащие исходный код (т.е. инструкции для AMX Mod X, который их исполняет), в формат, более пригодный для исполнения. За счет этого скорость выполнения плагинов возрастает многократно, упрощается разработка "движка", который эти плагины исполняет, а также в некотором смысле защищается авторский код. Почему в "некотором смысле"? Потому что все AMX Mod X плагины должны публиковаться под лицензией GNU General Public License. В случае публикации плагина лицензия обязывает также публиковать и его исходный код. Откомпилированные плагины имеют расширение .amxx. Именно файлы этого типа, а не .sma, должны указываться в файле plugins.ini для последующей корректной загрузки плагина.

=== Как компилировать плагины? ===
: Базовую информацию вы можете найти в статье [[Ru Compiling Plugins (AMX Mod X)|Компилирование плагинов]].

=== Как упростить процесс компилирования? ===
: Можно написать стороннюю программу или скрипт, например такой, как пакетный Batch файл. Например, создайте файл ''make.bat'' со следующим содержимым:
<pre>@amxxpc.exe %1 -i.\include -o.\compiled\%1</pre>
: Чтобы с помощью него откомпилировать плагин, необходимо выполнить следующую команду:
<pre>make.bat my_plugin.sma</pre>
: В итоге откомпилированный файл будет помещен в каталог ''compiled'' текущей директории. Если его там нет, значит в процессе компилирования возникли фатальные ошибки, которые выводятся на экран.
: Если вам необходимо (например, в случае ошибок) отправить кому-нибудь результат компиляции, можете перенаправить вывод информации о процессе компилирования в файл, например таким образом:
<pre>make.bat my_plugin.sma > my_plugin.log</pre>

=== Компилятор выводит "max. usage is unknown, due to recursion" ===
: Ничего страшного - просто компилятор не может вычислить предполагаемый объем памяти, используемый вашим плагином.

= Вопросы по скриптингу =

=== С чего начать? ===
: С со статьи [[Ru Fundamental Basics of AMX Mod X Scripting|Фундаментальные основы AMX Mod X скриптинга]].

=== А стоит ли вообще начинать? ===
: В зависимости от того, какую цель вы преследуете, а также от вашего желания и потенциала. Знание английского языка (чтение) будет огромным плюсом во время обучения, иначе постигать азы будет очень сложно. CS является закрытым проектом без исходных кодов, поэтому многие новые (неизученные) элементы приходится постигать через проведение экспериментов.

Ru AMX Mod X FAQ

2008-10-19T15:29:24Z

Half-Life 1 Game Events

2008-10-19T08:39:56Z

VEN: /* ClCorpse */ - info about coord and delay (*128)

[[Category:Half-Life 1]]
[[Category:Scripting (AMX Mod X)]]

= Introduction =

In [[AMX Mod X]] you are able to hook in-game messages/events with [http://www.amxmodx.org/funcwiki.php?search=register_message&go=search register_message] / [http://www.amxmodx.org/funcwiki.php?go=func&id=26 register_event]. Here are the list of messages/events and their arguments which can be read with [http://www.amxmodx.org/funcwiki.php?search=get_msg_arg_&go=search get_msg_arg_*] / [http://www.amxmodx.org/funcwiki.php?go=func&id=132 read_data]. 
 
*See the [[Advanced Scripting (AMX Mod X)#Events.2FMessages|Advanced Scripting]] article for more on events and messages. 
*See messages.inc and message_const.inc from amxmodx/scriptong/include folder or [http://www.amxmodx.org/funcwiki.php?go=inc&id=47 Messaging functions] and [http://www.amxmodx.org/funcwiki.php?go=inc&id=48 Message constants] for full messages control including blocking, argument alteration and much more. 
 

= ADStop =
{{qnotice|No Information available for this message.}} 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|ADStop}}
{{end-hl1msg}}

= AllowSpec =
Changes whether or not "SPECTATE" appears on the change team menu. Called whenever the allow_spectators CVar is changed, with its new value sent as the byte. 

{{qnotice|This changes how the change team menu appears, but spectating functionality is based off of the actual CVar value.}} 
{{begin-hl1msg|AllowSpec|byte}}
{{hl1msg|byte|Allowed}}
{{end-hl1msg}}

= AmmoPickup =
Temporarily draws [[HUD]] ammo amount and correspoding ammo [[HUD]] icon in the middle of the right side of the screen. 

{{qnotice|Draw time is depend on the ''hud_drawhistory_time'' client CVar value.}} 

{{qnotice|See [[CS Weapons Information]] for more information.}} 
{{begin-hl1msg|AmmoPickup|byte, byte}}
{{hl1msg|byte|AmmoID}}
{{hl1msg|byte|Ammount}}
{{end-hl1msg}}

= AmmoX =
Updates the green bar indicator in the [[HUD]] weapons list. Also updates [[HUD]] backpack ammo number in the lower right corner of the screen in case the given ammo type are compatible with the current weapon. 

{{qnotice|See [[CS Weapons Information]] for more information.}} 
{{begin-hl1msg|AmmoX|byte, byte}}
{{hl1msg|byte|AmmoID}}
{{hl1msg|byte|Ammount}}
{{end-hl1msg}}

= ArmorType =
Draws/removes helmet [[HUD]] icon. If flag is set to 1 the helmet [[HUD]] icon will be drawn (located right on the armor icon). 
{{begin-hl1msg|ArmorType|byte}}
{{hl1msg|byte|Flag}}
{{end-hl1msg}}

= BarTime =
Draws a [[HUD]] progress bar which is filled from 0% to 100% for the time Duration seconds. Once the bar is fully filled it will be removed from the screen automatically. 

{{qnotice|Set Duration to 0 to hide the bar.}} 
{{begin-hl1msg|BarTime|short}}
{{hl1msg|short|Duration}}
{{end-hl1msg}}

= BarTime2 =
The same as BarTime but StartPercents is specify how many per cents of the bar are (already) filled. 

{{qnotice|Display time can be calculated with this formula: ''(1 - (StartPercents / 100)) / Duration''}} 
{{begin-hl1msg|BarTime2|short, short}}
{{hl1msg|short|Duration}}
{{hl1msg|short|StartPercents}}
{{end-hl1msg}}

= Battery =
Updates the icon and the number of armor on the [[HUD]]. 
{{begin-hl1msg|Battery|short}}
{{hl1msg|short|Armor}}
{{end-hl1msg}}

= BlinkAcct =
Makes a player's money display flash rapidly, until it flashes a total of BlinkAmt times. 
{{begin-hl1msg|BlinkAcct|byte}}
{{hl1msg|byte|BlinkAmt}}
{{end-hl1msg}}

= BombDrop =
The first three arguments are the origin of the dropped bomb. The last argument is set to 1 if the bomb has been planted. It is 0 if the bomb was dropped due to voluntary dropping or death/disconnect. Setting the last argument 1, will also trigger the round timer to hide. It also will show the dropped bomb on the Terrorist team's radar in the location specified by the first three arguments. 
{{begin-hl1msg|BombDrop|coord, coord, coord, byte}}
{{hl1msg|coord|CoordX}}
{{hl1msg|coord|CoordY}}
{{hl1msg|coord|CoordZ}}
{{hl1msg|byte|Flag}}
{{end-hl1msg}}

= BombPickup =
This message just tells the game that the bomb has been picked up. It will cause the dropped/planted bomb to disappear from the Terrorist team's radar. 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|BombPickup}}
{{end-hl1msg}}

= BotProgress =
Used by CZ's bots when learning a new map. Displays a progress bar in the middle of the screen, with some header text. The bar doesn't move, and you can't do anything while the bar is displayed. This is a different style of progress bar than from the BarTime event. This really doesn't display well in CS. 

{{qnotice|Flag can be 0 (update bar), 1 (create new bar), or 2 (remove bar). When using flag 0, send all arguments. When using flag 1, send only Flag and Header. When using flag 2, send only Flag.}} 
{{begin-hl1msg|BotProgress|byte, byte, string}}
{{hl1msg|byte|Flag}}
{{hl1msg|byte|Progress}}
{{hl1msg|string|Header}}
{{end-hl1msg}}

= BotVoice =
Displays (or hides) the voice icon above a user's head and the talking icon on the right side of the screen. This is called by CZ for bots; it's not called by regular players, although you can specify a regular player (non-bot) for the PlayerIndex. Status is 1 for talking, or 0 for not talking. 
{{begin-hl1msg|BotVoice|byte, byte}}
{{hl1msg|byte|Status}}
{{hl1msg|byte|PlayerIndex}}
{{end-hl1msg}}

= Brass =
Creates a brass shell. Used, for example, by the AWP, after firing. 
{{begin-hl1msg|Brass|byte, coord, coord, coord, coord, coord, coord, coord, coord, coord, angle, short, byte, byte, byte}}
{{hl1msg|byte|Unknown}}
{{hl1msg|coord|StartX}}
{{hl1msg|coord|StartY}}
{{hl1msg|coord|StartZ}}
{{hl1msg|coord|VelocityX?}}
{{hl1msg|coord|VelocityY?}}
{{hl1msg|coord|VelocityZ?}}
{{hl1msg|coord|UnknownX}}
{{hl1msg|coord|UnknownY}}
{{hl1msg|coord|UnknownZ}}
{{hl1msg|angle|Life?}}
{{hl1msg|short|Model?}}
{{hl1msg|byte|Unknown}}
{{hl1msg|byte|Unknown}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= BuyClose =
Forces the buy menu to close. This is not called when the player closes the buy menu by himself; it's only called when the game forces him to do so (ie: he walks outside of the buy zone, gets killed, etcetera). 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|BuyClose}}
{{end-hl1msg}}

= ClCorpse =
Spawns a player's corpse. ModelName is the player's model name, for example: "leet". Delay is a delay before animation plaback, can be negative value. 

{{qnotice|Coord and Delay == (default units) * 128.}} 

{{qnotice|In CS argument #10 is always equal to 0.}} 

*See [http://www.amxmodx.org/funcwiki.php?go=module&id=4#const_teams CS Team Constants] for team indeces constants list. 
{{begin-hl1msg|ClCorpse|string, long, long, long, coord, coord, coord, long, byte, byte, byte, byte}}
{{hl1msg|string|ModelName}}
{{hl1msg|long|CoordX}}
{{hl1msg|long|CoordY}}
{{hl1msg|long|CoordZ}}
{{hl1msg|coord|Angle0}}
{{hl1msg|coord|Angle1}}
{{hl1msg|coord|Angle2}}
{{hl1msg|long|Delay}}
{{hl1msg|byte|Sequence}}
{{hl1msg|byte|ClassID?}}
{{hl1msg|byte|TeamID}}
{{hl1msg|byte|PlayerID}}
{{end-hl1msg}}

= Crosshair =
Draws/removes a crosshair. If Flag is set to 1 the crosshair will be drawn. 

{{qnotice|This crossair looks not like the regular one but like the one that is drawn in the spectator mode.}} 
{{begin-hl1msg|Crosshair|byte}}
{{hl1msg|byte|Flag}}
{{end-hl1msg}}

= CurWeapon =
Updates the clip ammo number and weapon's corresponding ammo type icon on the [[HUD]]. 

{{qnotice|See [[CS Weapons Information]] for more information.}} 
{{begin-hl1msg|CurWeapon|byte, byte, byte}}
{{hl1msg|byte|IsActive}}
{{hl1msg|byte|WeaponID}}
{{hl1msg|byte|ClipAmmo}}
{{end-hl1msg}}

= CZCareer =
Supplies certain updates to the player regarding Condition Zero singleplayer missions. 

{{qnotice|See the [[CZCareer]] page for more information.}} 

{{qnotice|Using an invalid type has no repercussions whatsoever. Therefore, you can use this to make your own custom communications (you can send any number of arguments of any type after the first string).}} 

{{qnotice|The Type argument is case-sensitive.}} 

{{qnotice|This event does nothing in CS and CZ multiplayer.}} 
{{begin-hl1msg|CZCareer|string,*}}
{{hl1msg|string|Type}}
{{hl1msg|*|Parameters}}
{{end-hl1msg}}

= CZCareerHUD =
Displays certain [[HUD]] elements regarding Condition Zero singleplayer missions. 

{{qnotice|See the [[CZCareerHUD]] page for more information.}} 

{{qnotice|Using an invalid type has no repercussions whatsoever. Therefore, you can use this to make your own custom communications (you can send any number of arguments of any type after the first string).}} 

{{qnotice|The Type argument is case-sensitive.}} 

{{qnotice|This event has some limited functionality in CS and CZ multiplayer (albeit better in CZ).}} 
{{begin-hl1msg|CZCareerHUD|string,*}}
{{hl1msg|string|Type}}
{{hl1msg|*|Parameters}}
{{end-hl1msg}}

= Damage =
Called when a player takes damage, to display the red locational indicators. The last three arguments is the origin of the damage inflictor or victim origin if inflictor isn't found. DamageType is a bitwise value usually consist of a single bit. 
{{begin-hl1msg|Damage|byte, byte, long, coord, coord, coord}}
{{hl1msg|byte|DamageSave}}
{{hl1msg|byte|DamageTake}}
{{hl1msg|long|DamageType}}
{{hl1msg|coord|CoordX}}
{{hl1msg|coord|CoordY}}
{{hl1msg|coord|CoordZ}}
{{end-hl1msg}}

= DeathMsg =
Fired to all players (MSG_ALL or MSG_BROADCAST) to notify them of a death. This generates the [[HUD]] message the client sees in the upper right corner of their screen. 
Also prints the console text message "KillerName killed VictimName with TruncatedWeaponName" or "*** KillerName killed VictimName with a headshot from TruncatedWeaponName ***" 

{{qnotice|TruncatedWeaponName doesn't contain a "weapon_" prefix. See [[CS Weapons Information]] for more information.}} 

{{qnotice|For grenade kill TruncatedWeaponName isn't "hegrenade" but "grenade", in fact it's an actual classname of a throwed grenade.}} 

{{qnotice|For KillerID it's not necessarily should be a PlayerID, it could be 0 if player dies from fall/acid/radiation/fire/etc damage/lack of oxygen or from touch to a "trigger_hurt" entity, in this case TruncatedWeaponName will be "worldspawn" and "trigger_hurt" respectively.}} 

{{qnotice|For vehicle kills TruncatedWeaponName could be "vehicle", "tank" et cetera.}} 
{{begin-hl1msg|DeathMsg|byte, byte, byte, string}}
{{hl1msg|byte|KillerID}}
{{hl1msg|byte|VictimID}}
{{hl1msg|byte|IsHeadshot}}
{{hl1msg|string|TruncatedWeaponName}}
{{end-hl1msg}}

= FlashBat =
Updates the flashlight battery charge on the [[HUD]]. 
{{begin-hl1msg|FlashBat|byte}}
{{hl1msg|byte|ChargePercents}}
{{end-hl1msg}}

= Flashlight =
Updates the flashlight state and battery charge on the [[HUD]]. If Flag is set to 1 the flashlight [[HUD]] icon will be shown as active. 
{{begin-hl1msg|Flashlight|byte, byte}}
{{hl1msg|byte|Flag}}
{{hl1msg|byte|ChargePercents}}
{{end-hl1msg}}

= Fog =
{{qnotice|mp_Fog 1 for fog in counter-strike}} 

{{begin-hl1msg|Fog|byte, byte, byte}}
{{hl1msg|byte|FogValue}}
{{hl1msg|byte|FogValue}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= ForceCam =
Called whenever mp_forcecam or mp_forcechasecam are changed, with their new values passed. There is assumedly a third CVar that this tracks, but it is yet unknown. Note that this message doesn't actually change any of the spectating rules for the client. 

{{qnotice|Even if mp_forcechasecam is set to 2, it is sent by this message as 1.}} 
{{begin-hl1msg|ForceCam|byte, byte, byte}}
{{hl1msg|byte|ForcecamValue}}
{{hl1msg|byte|ForcechasecamValue}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= GameMode =
{{qnotice|No Information available for this message.}} 
{{begin-hl1msg|GameMode|byte}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= GameTitle =
{{qnotice|No Information available for this message.}} 

= Geiger =
Notifies about radiation level through special sound signals. Distance is a distance to hazard area. 
{{begin-hl1msg|Geiger|byte}}
{{hl1msg|byte|Distance}}
{{end-hl1msg}}

= Health =
Updates the number of health on the [[HUD]]. 
{{begin-hl1msg|Health|byte}}
{{hl1msg|byte|Health}}
{{end-hl1msg}}

= HideWeapon =
Hides the specified [[HUD]] elements. 
Flags:
1 (1<<0) - crosshair, ammo, weapons list
2 (1<<1) - flashlight, +
4 (1<<2) - ALL
8 (1<<3) - radar, health, armor, +
16 (1<<4) - timer, +
32 (1<<5) - money, +
64 (1<<6) - crosshair
128 (1<<7) - +
Symbol + mean that an additional crosshair will be drawn. That crosshair looks exactly like the one from Crosshair message. 
{{begin-hl1msg|HideWeapon|byte}}
{{hl1msg|byte|Flags}}
{{end-hl1msg}}

= HLTV =
{{qnotice|No Information available for this message.}} 

{{qnotice|On new round is fired with both arguments equal to 0.}} 
{{begin-hl1msg|HLTV|byte, byte}}
{{hl1msg|byte|ClientID}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= HostageK =
Temporarily draws a blinking red dot on the CT players' radar when a hostage is killed. 
{{begin-hl1msg|HostageK|byte}}
{{hl1msg|byte|HostageID}}
{{end-hl1msg}}

= HostagePos =
Draws/updates the blue mark on the CT players' radar which is indicate the corresponding hostage position. 

{{qnotice|Is called with Flag set to 1 on player [[HUD]] full update.}} 
{{begin-hl1msg|HostagePos|byte, byte, coord, coord, coord}}
{{hl1msg|byte|Flag}}
{{hl1msg|byte|HostageID}}
{{hl1msg|coord|CoordX}}
{{hl1msg|coord|CoordY}}
{{hl1msg|coord|CoordZ}}
{{end-hl1msg}}

= HudText =
{{qnotice|No Information available for this message.}} 

= HudTextArgs =
Prints [[HUD]] text. 

{{qnotice|An example of TextCode could be "#Hint_you_have_the_bomb".}} 

{{qnotice|If you have a problems with specifing the last two arguments use 1 and 0 respectively.}} 
{{begin-hl1msg|HudTextArgs|string, byte, byte}}
{{hl1msg|string|TextCode}}
{{hl1msg|byte|Unknown}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= HudTextPro =
{{qnotice|No Information available for this message.}} 

= InitHUD =
Initializes the [[HUD]]. 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|InitHUD}}
{{end-hl1msg}}

= ItemPickup =
Temporarily draws correspoding item [[HUD]] icon in the middle of the right side of the screen. 

{{qnotice|Draw time is depend on the ''hud_drawhistory_time'' client CVar value.}} 
{{begin-hl1msg|ItemPickup|string}}
{{hl1msg|string|ItemName}}
{{end-hl1msg}}

= ItemStatus =
Notifies about carried items. 
Example of some item bits:
1 (1<<0) - nightvision goggles
2 (1<<1) - defusal kit
{{begin-hl1msg|ItemStatus|byte}}
{{hl1msg|byte|ItemsBitSum}}
{{end-hl1msg}}

= Location =
{{qnotice|No Information available for this message.}} 
{{begin-hl1msg|Location|byte, string}}
{{hl1msg|byte|Unknown}}
{{hl1msg|string|Unknown}}
{{end-hl1msg}}

= Money =
Updates the Amount of money on the [[HUD]]. If the Flag is 1, the additional new-old [[HUD]] money amount difference will be also displayed. 
{{begin-hl1msg|Money|long, byte}}
{{hl1msg|long|Amount}}
{{hl1msg|byte|Flag}}
{{end-hl1msg}}

= MOTD =
Displays MOTD window. 

{{qnotice|Max. Text length is 60. Large MOTD is sent in multiple messages. For the message that is send a last MOTD part the Flag will be set to 1 and 0 otherwise.}} 
{{begin-hl1msg|MOTD|byte, string}}
{{hl1msg|byte|Flag}}
{{hl1msg|string|Text}}
{{end-hl1msg}}

= NVGToggle =
Toggles night vision mode. For Flag: 1 is on, 0 is off. 
{{begin-hl1msg|NVGToggle|byte}}
{{hl1msg|byte|Flag}}
{{end-hl1msg}}

= Radar =
Draws/updates the dot on the [[HUD]] radar which is indicate the given player position. 

{{qnotice|Works for teammates only.}} 
{{begin-hl1msg|Radar|byte, coord, coord, coord}}
{{hl1msg|byte|PlayerID}}
{{hl1msg|coord|CoordX}}
{{hl1msg|coord|CoordY}}
{{hl1msg|coord|CoordZ}}
{{end-hl1msg}}

= ReceiveW =
{{qnotice|No Information available for this message.}} 

= ReloadSound =
{{qnotice|No Information available for this message.}} 
{{begin-hl1msg|ReloadSound|byte, byte}}
{{hl1msg|byte|Unknown}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= ReqState =
{{qnotice|No Information available for this message.}} 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|ReqState}}
{{end-hl1msg}}

= ResetHUD =
Resets the [[HUD]]. 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|ResetHUD}}
{{end-hl1msg}}

= RoundTime =
Updates the round timer on the [[HUD]]. Time is in seconds. 
{{begin-hl1msg|RoundTime|short}}
{{hl1msg|short|Time}}
{{end-hl1msg}}

= SayText =
Prints say [[HUD]] text. Second argument can be a predefined string or a custom one. In the last case the last two arguments isn't required. 
An examples of a predifined Counter-Strike string values: #Cstrike_Chat_AllDead, #Cstrike_Name_Change 

{{qnotice|For #Cstrike_Name_Change String2 is an old name and String3 is a new name.}} 
{{begin-hl1msg|SayText|byte, string, string, string}}
{{hl1msg|byte|SenderID}}
{{hl1msg|string|String1}}
{{hl1msg|string|String2}}
{{hl1msg|string|String3}}
{{end-hl1msg}}

= Scenario =
If Active is 0, this display will be hidden. If Active is 1, displays Sprite (valid names listed in sprites/hud.txt) to the right of the round timer with an alpha value of Alpha (100-255). If FlashRate is nonzero, then the sprite will flash from the given alpha to an alpha of 100, at a rate of FlashRate (measured in ???). This is used by CZ to display how many hostages remain unrescued, and also to display the ticking bomb when it is planted. 

{{qnotice|If Active is 0, don't send any other arguments afterwards. Also, you don't need to send either short if FlashRate is just going to be 0.}} 

[[image:Cs_scenario_msg.jpg|frame|right|Scenario message in CS, using the following parameters: 1, d_mp5navy, 150]]

{{qnotice|Works in both CS and CZ!}} 

{{qnotice|In CZ (and possibly CS), if someone respawns after the bomb has been planted, their Scenario event will not work at all until the next round.}} 
{{begin-hl1msg|Scenario|byte, string, byte, short, short}}
{{hl1msg|byte|Active}}
{{hl1msg|string|Sprite}}
{{hl1msg|byte|Alpha}}
{{hl1msg|short|FlashRate}}
{{hl1msg|short|Unknown}}
{{end-hl1msg}}

= ScoreAttrib =
Updates the scoreboard's attribute for the specified player. For the 2nd argument, 0 is nothing, (1<<0) i.e. 1 is dead, (1<<1) i.e. 2 is bomb, (1<<2) i.e. 4 is VIP. 

{{qnotice|Flags is a bitwise value so if VIP player is dying with the bomb the Flags will be 7 i.e. bit sum of all flags.}} 
{{begin-hl1msg|ScoreAttrib|byte, byte}}
{{hl1msg|byte|PlayerID}}
{{hl1msg|byte|Flags}}
{{end-hl1msg}}

= ScoreInfo =
Updates the scoreboard with the given player's Frags and Deaths. 

{{qnotice|In CS the 4th argument is always equal to 0.}} 

*See [http://www.amxmodx.org/funcwiki.php?go=module&id=4#const_teams CS Team Constants] for team indeces constants list. 
{{begin-hl1msg|ScoreInfo|byte, short, short, short, short}}
{{hl1msg|byte|PlayerID}}
{{hl1msg|short|Frags}}
{{hl1msg|short|Deaths}}
{{hl1msg|short|ClassID?}}
{{hl1msg|short|TeamID}}
{{end-hl1msg}}

= ScreenFade =
Fades the screen. 

{{qnotice|Duration and HoldTime is in special units. 1 second is equal to (1<<12) i.e. 4096 units.}} 

Flags (from HLSDK):
FFADE_IN 0x0000 // Just here so we don't pass 0 into the function
FFADE_OUT 0x0001 // Fade out (not in)
FFADE_MODULATE 0x0002 // Modulate (don't blend)
FFADE_STAYOUT 0x0004 // ignores the duration, stays faded out until new ScreenFade message received
{{begin-hl1msg|ScreenFade|short, short, short, byte, byte, byte, byte}}
{{hl1msg|short|Duration}}
{{hl1msg|short|HoldTime}}
{{hl1msg|short|Flags}}
{{hl1msg|byte|ColorR}}
{{hl1msg|byte|ColorG}}
{{hl1msg|byte|ColorB}}
{{hl1msg|byte|Alpha}}
{{end-hl1msg}}

= ScreenShake =
Shakes the screen. 

{{qnotice|All arguments is in special units. 1 second is equal to (1<<12) i.e. 4096 units.}} 
{{begin-hl1msg|ScreenShake|short, short, short}}
{{hl1msg|short|Amplitude}}
{{hl1msg|short|Duration}}
{{hl1msg|short|Frequency}}
{{end-hl1msg}}

= SendAudio =
Plays the specified audio. An example of AudioCode could be "%!MRAD_rounddraw". 
{{begin-hl1msg|SendAudio|byte, string, short}}
{{hl1msg|byte|SenderID}}
{{hl1msg|string|AudioCode}}
{{hl1msg|short|Pitch}}
{{end-hl1msg}}

= ServerName =
Sends a server name to a client. 
{{begin-hl1msg|ServerName|string}}
{{hl1msg|string|ServerName}}
{{end-hl1msg}}

= SetFOV =
Sets the specified field of view. 
{{begin-hl1msg|SetFOV|byte}}
{{hl1msg|byte|Degrees}}
{{end-hl1msg}}

= ShadowIdx =
{{qnotice|No Information available for this message.}} 
{{begin-hl1msg|ShadowIdx|long}}
{{hl1msg|long|Unknown}}
{{end-hl1msg}}

= ShowMenu =
Displays a "menu" to a player (text on the left side of the screen). Acts like AMXX's show_menu (in fact, this is how AMXX shows a menu). 

{{qnotice|Multipart should be 1 if your menu takes up multiple messages (i.e.: string is too big to fit into one). On the final message, Multipart should be 0.}} 
{{begin-hl1msg|ShowMenu|short, char, byte, string}}
{{hl1msg|short|KeysBitSum}}
{{hl1msg|char|Time}}
{{hl1msg|byte|Multipart}}
{{hl1msg|string|Text}}
{{end-hl1msg}}

= ShowTimer =
Forces the round timer displaying. 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|ShowTimer}}
{{end-hl1msg}}

= SpecHealth =
{{qnotice|No Information available for this message.}} 
{{begin-hl1msg|SpecHealth|byte}}
{{hl1msg|byte|Health?}}
{{end-hl1msg}}

= SpecHealth2 =
Updates the observer's screen with a name and health of the given player. 
{{begin-hl1msg|SpecHealth2|byte, byte}}
{{hl1msg|byte|Health}}
{{hl1msg|byte|PlayerID}}
{{end-hl1msg}}

= Spectator =
Called when player becomes an observer/spectator. 

{{qnotice|On join to Spectators usually is fired twice in a row.}} 
{{begin-hl1msg|Spectator|byte, byte}}
{{hl1msg|byte|ClientID}}
{{hl1msg|byte|Unknown}}
{{end-hl1msg}}

= StatusIcon =
Draws/removes the specified status [[HUD]] icon. For Status, 0 is Hide Icon, 1 is Show Icon, 2 is Flash Icon. Color arguments are optional and is required only if Status aren't equal to 0. 
{{begin-hl1msg|StatusIcon|byte, string, byte, byte, byte}}
{{hl1msg|byte|Status}}
{{hl1msg|string|SpriteName}}
{{hl1msg|byte|ColorR}}
{{hl1msg|byte|ColorG}}
{{hl1msg|byte|ColorB}}
{{end-hl1msg}}

= StatusValue =
Sends/updates the status values. For the Flag 1 the Value is TeamRelation, for 2 is PlayerID, for 3 is Health. For TeamRelation, 1 is Teammate player, 2 is Non-Teammate player, 3 is Hostage. If TeamRelation is Hostage, PlayerID will be 0 or will be not sent at all. 
Usually is fired as a triple message, for example:
{1, 2} - non-teammate player
{2, 17} - player index is 17
{3, 59} - player health is 59
{{begin-hl1msg|StatusValue|byte, short}}
{{hl1msg|byte|Flag}}
{{hl1msg|short|Value}}
{{end-hl1msg}}

= StatusText =
Specifies the status text format. 
{{begin-hl1msg|StatusText|byte, string}}
{{hl1msg|byte|Unknown}}
{{hl1msg|string|Text}}
{{end-hl1msg}}

= TaskTime =
Displays a secondary timer above the round timer. Used for Condition Zero singleplayer missions. 
If Time is -1, timer dissappears. If Time is any other negative value, it is displayed as green instead of yellow, and considered positive. 
If Active is true, timer counts down. Otherwise, it is paused. If Fade is above zero, the timer will slowly fade out after that many seconds have passed (even if the timer is inactive). 

{{qnotice|This event can only be used on missions that have an objective requiring a secondary timer!}} 
{{begin-hl1msg|TaskTime|short, byte, byte}}
{{hl1msg|short|Time}}
{{hl1msg|byte|Active}}
{{hl1msg|byte|Fade}}
{{end-hl1msg}}

= TeamInfo =
Sets the team information for the given player. 

{{qnotice|In CS TeamName is either "UNASSIGNED", "TERRORIST", "CT" or "SPECTATOR".}} 
{{begin-hl1msg|TeamInfo|byte, string}}
{{hl1msg|byte|PlayerID}}
{{hl1msg|string|TeamName}}
{{end-hl1msg}}

= TeamScore =
Updates the team score on the score board. 

{{qnotice|In CS TeamName is either "TERRORIST" or "CT".}} 
{{begin-hl1msg|TeamScore|string, short}}
{{hl1msg|string|TeamName}}
{{hl1msg|short|Score}}
{{end-hl1msg}}

= TextMsg =
Prints a cutom/or predefined text message. 
There does not necessarily have to be a total of 6 arguments, there could be as little as 2. For example you can send a message with the following:
Arg1: 1
Arg2: #Game_join_ct
Arg3: Pimp Daddy
{{begin-hl1msg|TextMsg|byte, string, string, string, string, string}}
{{hl1msg|byte|DestinationType}}
{{hl1msg|string|Message}}
{{hl1msg|string|Submsg}}
{{hl1msg|string|Submsg}}
{{hl1msg|string|Submsg}}
{{hl1msg|string|Submsg}}
{{end-hl1msg}}

= Train =
Displays the speed bar used for controlling a train. 

{{qnotice|Speed is as follows: 0 (disable display), 1 (reverse), 2 (neutral), 3 (slow speed), 4 (medium speed), 5 (maximum speed)}} 
{{begin-hl1msg|Train|byte}}
{{hl1msg|byte|Speed}}
{{end-hl1msg}}

= TutorClose =
Closes all CZ-style tutor popups. 

= TutorLine =
{{qnotice|No Information available for this message.}} 

= TutorState =
{{qnotice|No Information available for this message.}} 

= TutorText =
Used to display a CZ-style tutor popup. 
{{begin-hl1msg|TutorText|string, byte, short, short, short}}
{{hl1msg|string|Unknown}}
{{hl1msg|byte|Unknown}}
{{hl1msg|short|Unknown}}
{{hl1msg|short|Unknown}}
{{hl1msg|short|Unknown}}
{{end-hl1msg}}

= ViewMode =
{{qnotice|No Information available for this message (HLSDK says this switches to first-person view, but it doesn't seem to function as so).}} 

{{qnotice|This message has no arguments.}} 
{{begin-hl1msg|ViewMode}}
{{end-hl1msg}}

= VGUIMenu =
Displays a predefined VGUI menu. 
{{begin-hl1msg|VGUIMenu|byte, short, char, byte, string}}
{{hl1msg|byte|MenuID}}
{{hl1msg|short|KeysBitSum}}
{{hl1msg|char|Time?}}
{{hl1msg|byte|Multipart?}}
{{hl1msg|string|Name?}}
{{end-hl1msg}}

= VoiceMask =
Used to tell a client who he can hear over the microphone. 
{{begin-hl1msg|VoiceMask|long, long}}
{{hl1msg|long|AudiblePlayersIndexBitSum}}
{{hl1msg|long|ServerBannedPlayersIndexBitSum}}
{{end-hl1msg}}

= WeaponList =
Configures the [[HUD]] weapons list. 

{{qnotice|Fired on map initialization.}} 

{{qnotice|SlotID starts from 0.}} 

Flags (from HLSDK):
ITEM_FLAG_SELECTONEMPTY 1
ITEM_FLAG_NOAUTORELOAD 2
ITEM_FLAG_NOAUTOSWITCHEMPTY 4
ITEM_FLAG_LIMITINWORLD 8
ITEM_FLAG_EXHAUSTIBLE 16 // A player can totally exhaust their ammo supply and lose this weapon.
{{qnotice|See [[CS Weapons Information]] for more information.}} 
{{begin-hl1msg|WeaponList|string, byte, byte, byte, byte, byte, byte, byte, byte}}
{{hl1msg|string|WeaponName}}
{{hl1msg|byte|PrimaryAmmoID}}
{{hl1msg|byte|PrimaryAmmoMaxAmount}}
{{hl1msg|byte|SecondaryAmmoID}}
{{hl1msg|byte|SecondaryAmmoMaxAmount}}
{{hl1msg|byte|SlotID}}
{{hl1msg|byte|NumberInSlot}}
{{hl1msg|byte|WeaponID}}
{{hl1msg|byte|Flags}}
{{end-hl1msg}}

= WeapPickup =
Temporarily draws correspoding weapon [[HUD]] icon in the middle of the right side of the screen. 

{{qnotice|Draw time is depend on the ''hud_drawhistory_time'' client CVar value.}} 

{{qnotice|Is fired right before weapon is picked up (notice ''"before"'').}} 

{{qnotice|See [[CS Weapons Information]] for more information.}} 
{{begin-hl1msg|WeapPickup|byte}}
{{hl1msg|byte|WeaponID}}
{{end-hl1msg}}

AMX Mod X 1.8.0 Changes

2007-08-28T16:14:53Z

VEN: cs_[g|s]et_hostage_nextuser to cs_[g|s]et_hostage_nextuse (no last "r")

AMX Mod X 1.8 is a large release with many changes, both to the development API and user-mode features.
=Per-Map Features=
You can now have per-map prefix-based configuration files for plugins and .cfg scripts.
*<tt>configs/maps/prefix_<prefix>.cfg</tt> (for example)
**<tt>configs/maps/prefix_de.cfg</tt> will run on any de_* map.
*<tt>configs/maps/plugins-<prefix>.ini</tt> (for example)
**<tt>configs/maps/plugins-de.ini</tt> will load all contained plugins on any de_* map.

=Command Flag Changing=
You can now change the access flags required by commands without recompiling or editing scripts. AMX Mod X caches all command flags in <tt>configs/cmdaccess.ini</tt>, where they can be easily edited.

=Ham Sandwich=
Ham Sandwich is a very powerful module by [[User:Sawce|sawce]] which can hook and call virtual CBaseEntity functions on a variety of mods. For more information, see the [http://svn.alliedmods.net/viewvc.cgi/trunk/plugins/include/hamsandwich.inc?root=amxmodx&view=log hamsandwich.inc] file.

=Dynamic Global Arrays=
Also by [[User:Sawce|sawce]], dynamic global arrays are now available in AMX Mod X. You can read the full specs in [http://svn.alliedmods.net/viewvc.cgi/trunk/plugins/include/cellarray.inc?root=amxmodx&view=log cellarray.inc].

Additionally, the hardcoded limits of a few plugins have been lifted:
*Admins are now dynamic and not limited to <tt>MAX_ADMINS</tt>.
*Mapchooser no longer has a predefined map limit.
*Maps menu no longer has a predefined map limit.
*imessage no longer has a predefined message limit.

=Changelog=
==Overall Changes==
*Added a new module, Ham Sandwich, for hooking and calling virtual CBaseEntity functions in mods.
*Command flags are now initially dumped to disk and can be edited via <tt>configs/cmdaccess.ini</tt>.
*Added {{AMBug|48738}}: Romanian translation from X-5173.
*Added {{AMBug|50741}} and {{AMBug|43830}}: per-map plugins files can now be prefixed based.
*Added {{amb|17}}: New menu rendering is now more consistent; non-consistent controls are deprecated.
*Added {{amb|32}}: The server console commands "amxx cvars" and "amxx cmds" can now filter by plugin.
*Added {{amb|122}}: Log file names now include a four-digit year.
*Fixed {{amb|18}}: New menus are now properly destroyed if overridden.
*Fixed {{amb|46}}: <tt>is_user_bot</tt> had some false positives.
*Fixed {{amb|69}}: Fixed Metamod trying to reload AMX Mod X against a poorly configured clock.
*Fixed {{amb|207}}: New menus now display "0" instead of "10."
*Fixed {{amb|208}}: New menus did not reset callback results after each call.
*Fixed {{amb|200}}: Dynamic/fake natives were not re-entrant.
*Fixed {{amb|244}}: Run-time errors blocked forwards.
*Fixed {{amb|305}}: Core crashed on mods that removed the standard <tt>mp_timelimit</tt> cvar.
*Fixed many various internal new menu rendering and item selection bugs.

==Scripting Changes==
*All include files are now #pragma semicolon safe.
*New menu functions are now in a separate, newly documented include file (newmenus.inc).
*Added natives for dynamic global arrays.
*Added a new, magic <tt>any</tt> tag from [[SourceMod]].
*Added a <tt>charsmax</tt> macro for safe sizeof(string)-1 usage.
*Added <tt>set_pcvar_string</tt>().
*Added <tt>LookupLangKey</tt>().
*Added <tt>SQL_QuoteString</tt>().
*Added <tt>[g|s]et_pdata_cbase[_safe]</tt>() to the Ham Sandwich module.
*Added <tt>geoip_code[2|3]_ex</tt>(), which address a serious issue in the now deprecated <tt>geoip_code[2|3]</tt>().
*Added <tt>lookup_sequence</tt>(), <tt>set_controller</tt>(), <tt>set_pev_string</tt>(), and <tt>pev_serial</tt>() to Fakemeta.
*Added <tt>ns_get_user_team</tt>.
*Added a menu property to change the numbering color.
*Added {{amb|27}}: <tt>SQL_Rewind</tt>().
*Added {{amb|37}}: <tt>cs_[g|s]et_user_submodel</tt>().
*Added {{amb|38}}: <tt>cs_[g|s]et_user_lastactivity</tt>().
*Added {{amb|39}}: <tt>cs_[g|s]et_hostage_lastuse</tt>() and <tt>cs_[g|s]et_hostage_nextuse</tt>().
*Added {{amb|63}}: <tt>floatmin</tt>(), <tt>floatmax</tt>(), and <tt>floatclamp()</tt>.
*Added {{amb|76}}: Formatting functions can now use %x or %X for hexadecimal numbers.
*Added {{amb|92}}: <tt>create_tr2</tt>() and <tt>free_tr2</tt>().
*Added {{amb|205}}: <tt>cs_[g|s]et_c4_explode_time</tt>().
*Added {{amb|216}}: <tt>SQL_MakeStdTuple</tt>() now has a timeout parameter.
*Added {{amb|237}}: Fakemeta can now call "ServerPrint."
*Added {{amb|242}}: <tt>cs_[g|s]et_user_hostagekills</tt>().
*Added {{amb|245}}: <tt>precache_sound</tt> now returns a precache index.
*Added {{amb|261}}: <tt>has_flag</tt>() and <tt>has_all_flags</tt>().
*Added {{amb|291}}: <tt>cs_[g|s]et_c4_defusing</tt>().
*Added {{amb|673}}: <tt>regex_compile</tt>() and <tt>regex_match_c</tt> for pre-compiling expressions.
*Added {{AMBug|46213}}: <tt>player_menu_info</tt>() now returns a page number.
*Added {{AMBug|51064}}: Some parameters to <tt>get_plugin</tt> are now optional.
*Added {{AMBug|50610}}: Some parameters to <tt>get_user_weapon</tt> are now optional.
*Added {{AMBug|48841}}: <tt>tfc_is_user_feigning</tt>().
*Added {{AMBug|45664}}: <tt>tfc_is_team_ally</tt>().
*Fixed {{AMBug|49337}}: <tt>get_pcvar_float</tt>() malfunctioned on high numbers.
*Fixed {{amb|78}}: <tt>get_concmdsnum</tt> could return an incorrect result.
*Fixed {{amb|85}}: Tag mismatches on <tt>ShowSyncHudMsg</tt>().
*Fixed {{amb|90}}: <tt>set_native_filter</tt>() did not work in rare cases.
*Fixed {{amb|107}}: <tt>socket_open</tt>() didn't return an error by reference.
*Fixed {{amb|110}}: <tt>socket_change</tt>() could return 1 on certain failures.
*Fixed {{amb|116}}: <tt>DispatchKeyValue</tt>() did not work on worldspawn (entity 0).
*Fixed {{amb|230}}: <tt>radius_damage</tt>() didn't kill players on all mods.
*Fixed {{amb|257}}: <tt>get_user_origin</tt>() mode 4 had false positives.
*Fixed {{amb|343}}: <tt>TFC_ClearModel</tt>() did not function as documented.
*Fixed {{amb|421}}: <tt>get_user_weapons</tt>() could omit a weapon on Day of Defeat.
*Fixed {{amb|437}}: <tt>dod_set_user_kills</tt>() and <tt>dod_set_user_score</tt>() could mess up the scoreboard.
*Fixed {{amb|519}}: <tt>geoip_code[2|3]</tt>() buffer overflowed on error.
*Fixed {{amb|736}}: <tt>find_entity</tt>() was defined twice.
*Fixed a memory leak in <tt>SortCustom1D</tt>().
*Fixed a crash bug in <tt>fwrite_blocks</tt>().

==Plugin Changes==
*There is no longer a hardcoded limit to the number of admins.
*There is no longer a hardcoded limit to the map list.
*There is no longer a hardcoded limit to the number of "imessages."
*Added {{amb|34}}: There are now plugin command/cvar menus.
*Added {{AMBug|45044}}: amx_banmenu now prints the ban time length.
*Added {{AMBug|43757}}: amx_addadmin now writes a comment with the player's name.
*Added {{AMBug|29353}}: amx_plugins now prints paginated output.
*Added {{AMBug|50742}}: admin.sma now supports prefix based per-map configs.
*Added {{amb|28}}: statscfg.sma can now use translations.
*Added {{amb|30}}: <tt>csstats_rankbots</tt> prevents bots from showing on <tt>/top15</tt>.
*Added {{amb|31}}: plmenu.sma ban and slap options are now configurable.
*Added {{amb|42}}: Added new values for <tt>amx_show_activity</tt>.
*Added {{amb|51}}: amx_vote can now take more than two options.
*Added {{amb|64}}: amx_voteban autodetects whether it should IP ban.
*Added {{amb|307}}: amx_addban now caches the last ten connections.
*Added {{amb|311}}: mapcycle file now ignores .bsp extensions.
*Added {{amb|340}}: amx_ban/amx_banip now display a reason in the activity.
*Added {{amb|427}}: Additional weapons to <tt>dod_[g|s]et_user_ammo</tt>().
*Added {{amb|743}}: plmenu for cstrike has an option to move to spectator.
*Fixed {{amb|29}}: pausecfg.sma did not translate two phrases.
*Fixed {{amb|91}}: miscstats.sma truncated some language translations.
*Fixed {{amb|94}}: amx_psay sometimes sent truncated messages.
*Fixed {{amb|109}}: mapsmenu.sma now checks <tt>mapcyclefile</tt> before reverting to <tt>mapcycle.txt</tt>.
*Fixed {{amb|118}}: amx_help would not list <tt>ADMIN_ADMIN</tt> commands.
*Fixed {{amb|130}}: Various menus did not take <tt>ADMIN_ALL</tt> or <tt>ADMIN_ADMIN</tt> into account.
*Fixed {{amb|183}}: plmenu.sma did not work on Natural Selection.
*Fixed {{amb|196}}: amx_modules did not handle invalid modules properly.
*Fixed {{amb|222}}: cl_rebuy could exploit CS weapon restrictions. This also makes CZ bots obey restrictions.
*Fixed {{amb|228}}: amxmod_compat could cause <tt>set_user_hitzones</tt>() to break.
*Fixed {{amb|350}}: <tt>traceline_set_float</tt> from the AMX Mod Compat layer was broken.
*Fixed {{amb|467}}: <tt>conmotd.txt</tt> is now removed.
*Fixed {{amb|633}}: Immune admins can now target themselves.
*Fixed {{amb|790}}: admin.sma parsed beginning spaces incorrectly in users.ini.
*Fixed a potential exploit in adminslots.sma.
*SQL cvars are now protected.

==Module Changes==
*Fixed {{amb|108}}: IP-based stats no longer include a port when saving.
*Fixed {{amb|503}}: CSX did not set a META_RESULT when paused.

Talk:Ru AMX Mod X FAQ

2007-03-19T10:36:11Z

VEN:

[[User:Slogic|Slogic]]: может убрать определения и оставить только сокращения, а определение терминов реализовать используя возможности WIKI? Или даже сокращения убрать, а в процессе написания делать ссылки на описание этих слов/сокращений.
: "По-хорошему", конечно, нужны отдельные страницы-определения. Насчет второго тезиса: смотря, как реализовать. Если указывать аббревиатуры на самих страницах-определяниях, это не будет достаточно полезно, т.к. это усложнит поиск значения аббревиатуры. Для каждой аббревиатуры лучше создавать отдельную страницу или страницу-редирект, которая в свою очередь направляет на страницу-определение. Т.о. поиск значения аббревиатуры значительно упрощается.
: --[[User:VEN|VEN]] 05:36, 19 March 2007 (CDT)

VEN: indentation

[[User:Slogic|Slogic]]: Если вставить шаблон на русской странце, то шаблон не понимает, что мы создали его на русской странице и не правильно создает ссылки: должен на английскую версию, а создает опять на русскую.
:Да, замечал, есть такая вещь. Выход: помещать ссылку на оригинал, не используя шаблон, например:
:* [[Something|Просмотреть оригинал]]
:--[[User:VEN|VEN]] 05:52, 19 January 2007 (CST)

2006-12-31T15:37:35Z

VEN:

== Purpose? ==

I'm a bit confused as to the purpose of this page. It's titled as Half-Life 1 Game Events, yet it's completey missing (as is not even listed as "No information available") some HL1 event such as Geiger, but has an incredible amount of CS-specific events.

Should this be broken up into base HL events and then CS-specific events?

:In fact some of the HLDM (valve) Game Mod Messages is used by other Game Mods so you can't actually split this article strictly into HLMD and CS messages. But i agree that the title are misleading.--[[User:VEN|VEN]] 09:35, 31 December 2006 (CST)

Talk:Half-Life 1 Game Events

2006-12-31T15:35:15Z

VEN:

== Purpose? ==

I'm a bit confused as to the purpose of this page. It's titled as Half-Life 1 Game Events, yet it's completey missing (as is not even listed as "No information available") some HL1 event such as Geiger, but has an incredible amount of CS-specific events.

Should this be broken up into base HL events and then CS-specific events?

In fact some of the HLDM (valve) Game Mod Messages is used by other Game Mods so you can't actually split this article strictly into HLMD and CS messages. But i agree, title misleading.--[[User:VEN|VEN]] 09:35, 31 December 2006 (CST)