Из этого мануала вы узнаете как нужно создавать плагины (plugins) для Counter-Strike сервера. Вы научитесь азам этого.
Этот плагин пишется под мод HL - Counter- Strike. Примите это к сведению.

Начнем написание вашего первого плагина.

Давайте начнем с простого: вывод сообщений на экран.

Придумаем команду, которая это будет делать


Надо что бы админ смог, когда захочет, вписать соответствующую команду и на экран выводилось соответствующая надпись:






Готовы? Ну тогда начнем!

Откройте блокнот и сохраните под названием, например, myplugin.sma. Заготовка уже есть, осталось наполнить её командами.
Начинаем с секции "комментарий", в самом начале файла myplugin. sma. Секция комментарий – часть кода, не являющаяся кодом. Это всего на всего комментарий. Обычно здесь указывают название плагина, его версию. Позже можно более детально описать работу вашего плагина, его установку и т.д. Но пока начнём с малого:




Любой плагин должен иметь функцию plugin_ init().
Всё то, что вставлено в эту данную функцию будет регистрироваться в AMX, что бы он мог использовать ваш плагин:




Но этого не достаточно, для нашей цели. Должна быть команда которую админ сможет использовать и для этого мы должны её зарегистрировать в plugin_ init() функции. Команды, которые вводятся в консоле сервера или от клиента должны быть внутри plugin_ init() для того, что бы ей могли пользоваться. plugin_ init() важен по многим другим причинам, о которых вы узнаете из более поздних уроках. Функция plugin_ init() это как сообщение для AMXMod, что существует ваш плагин.


Допишите данную строку в секцию функции


С помощью этой строки мы регистрируем команду, которую будем в последствии использовать. Первый параметр в ковычках - это команда, которую мы будет вбивать в консоле. Следующий параметр в кавычках – это функция в нашем плагине, когда команда будет введена будет выполнена данная функция. Эту функцию мы напишем позже. На самом деле назвать можно как угодно. Название не должно быть очень большим, тогда данное название не подходит ( ). Назвал её так для простоты и непринужденности прочтения текста. Следующий параметр – уровень доступа. Т.е. кто на сервере имеет права для выполнения данной команды. В данном случае админ ( ADMIN_VOTE ). Зачем простым игрокам разводить флуд . Но можно сделать доступ всем: надо указать 0 вместо ADMIN _ VOTE. Замете кавычек нет! Таким образом командой могут пользоваться админы с уровнем доступа к голосованию (vote). И последний параметр – это комментарий. Он будет отображен когда вы введёте amx_help. НЕ ТЕРЯЙТЕ КАВЫЧЕК!!!

Таким образом функция plugin_ init() выглядит так:




Добавьте данные строки. Они должны обязательно присутствовать в плагине:
#include
#include

Данные строки помещаются сразу после комментариев и перед plugin_ init() функцией. Таким образом мы добавляем модули CS.

Мы уже довольно много написали. Должно быть, похоже вот на это:


Всегда сохраняйте написанное. Кто знает когда отключат электричество. Попробуйте откомпилировать данный плагин. Если есть ошибки, то их проще найти сейчас. Это значительно упрощает поиск ошибок. (Как откомпилировать плагин?)

Нам осталось написать последнюю функцию – вывод сообщения на экран. Мы зарегистрировали команду которая будет выполнятся в консоли, сообщение выводимое на экран тоже зарегистрировали. Теперь осталось создать функцию которая будет всё это делать:


Я не буду расписывать как работает функция cmd_access(). Скажу только, что она проверяет, может ли клиент использовать данную команду.


Id используется по разному. В cmd_ access() через id проверяется уровень доступа этого текучего пользователя, и никого другого. Надеюсь это понятно.

Следующая линия кода:




Мы почти написали наш первый плагин. Осталось только дописать следующую строчку в функцию


Поэтому всегда заканчивайте функцию return PLUGIN_HANDLED.
Полностью наш плагин выглядит так:


Всё, плагин готов. Откомпилируйте его и убедитесь, что нет ошибок во время компиляции.
Если при компиляции вы получаете сообщение


перейдите на указанную строчку и проследите что бы углубление (" tab" – помните…) было одинаково везде в вашем плагине.

Теперь можете поместить файл myplugin.amx в папку plugins и прописать плагин в config/plugins.ini. Не забудьте перезагрузить ваш сервер.

Теперь заходите в игру и пропишите amx_helloworld и убедитесь что всё отображается как надо.
Удостоверьтесь, что при вводе команды amx_help описание соответствует тому, что использовали мы.
Если плагин не работает, в консоле сервера введите amx plugins и убедитесь, что плагин загружен.
Возможно вы забыли прописать себя админом.