Lua-интерфейс для PtokaX. Как работают скрипты и что они могут делать

Скрипты позволяют расширить или изменить стандартный функционал, предоставляемый хабом. Чтобы понять, как его можно изменить, надо немного разобраться с самим протоколом DC++. Мы не будем вдаваться в тонкости самого протокола и форматы сообщений, заметим лишь только, что по сути дела работа хаба состоит в следующем:

Прием сообщений (как чатовых, так и служебных) от юзеров;
Рассылка юзерам ответов на эти сообщения;
Обработка входов/выходов юзеров (контроль паролей по базе для зарегистрированных)
Обработка команд хаба, посылаемых пользователями (встроенных и пользовательских);
Обработка банов, контроль IP-адресов, размера шары, слотов и тд, и т.п. (короче, правил хаба).

Для каждого вида сообщений у хаба существует стандартный обработчик -- те действия, которые он выполняет сам без всяких скриптов. Так вот скрипты позволяют перекрыть этот обработчик и написать вместо него свой. Можно сказать хабу, чтобы он (например) при входе юзера выдавал ему сообщение, а потом выполнял стандартный обработчик события "вход юзера". А можно сделать и так, чтобы он просто выполнял какие-то действия и больше ничего не делал.

Комментарий: обработка событий на хабе очень напоминает обработку сообщений в различных оконных системах (Windows, X Window System). Отличие пожалуй в том, что вместо одной большой оконной процедуры (WindowProc) имеется много различных функций, каждая из которых реализует отдельный обработчик.

Чтобы перекрыть какое-либо событие хаба, нам нужно сделать скрипт, в котором есть функция со специальным именем и специальными параметрами. Список этих спец-функций известен и содержится в документации по PtokaX. Мы не будем разбирать абсолютно все, так как их до фига, а разберем основные, наиболее часто используемые.

Итак, начнем с примера, в котором пользователю (незарегистрированному) при входе на хаб выдаётся сообщение "Привет".


function UserConnected(user)
	Core.SendToUser(user, "Привет");
end

Назовем наш файлик example.lua, положим его в папку scripts у PtokaX. Теперь жмем кнопку Scripts, и там кнопку Refresh scripts. Хаб увидит наш файлик и покажет его в списке. Ставим на файлике галочку (это значит, что скрипт активирован). Если вы набрали его без ошибок, хаб напишет внизу, что всё зашибись. Теперь заходим на хаб с каким-нибудь ником и -- о чудо -- видим сообщение "Привет". Заметьте, что оно будет даже без указания ника, от которого оно послано. Мы сами такое сообщение послать не сможем, оно будет проигнорировано хабом как имеющее неверный формат.