Версия для печати темы

Нажмите сюда для просмотра этой темы в обычном формате

MyDC.ru _ Разработчикам [PtokaX] _ Функции ===> Читаем, Дабы Не Задавать Вопросов <===

Автор: Svyat 29.6.2008, 21:10

Функции, вызываемые PtokaX

В этой теме я постепенно буду постить примеры использования той или иной функции.

OnStartup() - Вызывается при запуске скрипта.
Аналог API 1: Main()

OnExit() - Вызывается при завершении скрипта.
Аналог API 1: OnExit()

OnTimer(nTimerId) - Функция по умолчанию, которая вызывается по таймеру заданного интервала.
Аналог API 1: OnTimer()

UserConnected(tUser) - Вызывается когда пользователь подключается к хабу.
Аналог API 1: NewUserConnected(tUser)

UserDisconnected(tUser) - Вызывается когда пользователь отключается или был отключен от хаба.
Аналог API 1: UserDisconnected(tUser)

RegConnected(tUser) - Вызывается когда зарегистрированный пользователь подключается к хабу.
Аналог API 1: NewUserConnected(tUser)

RegDisconnected(tUser) - Вызывается когда зарегистрированный пользователь отключается или был отключен от хаба.
Аналог API 1: UserDisconnected(tUser)

OpConnected(tUser) - Вызывается когда пользователь со статусом оператор подключается к хабу.
Аналог API 1: OpConnected(tUser)

OpDisconnected(tUser) - Вызывается когда пользователь со статусом оператор отключается или был отключен от хаба.
Аналог API 1: OpDisconnected(tUser)

OnError(sErrorMsg) - Вызывается когда найдена ошибка в скрипте.
Аналог API 1: OnError(sErrorMsg)

SupportsArrival(tUser, sData) - Поступившее от пользователя сообщение о поддерживаемых дополнения.
Аналог API 1: SupportsArrival(tUser, sData)

ChatArrival(tUser, sData) - Сообщение, поступившее в чат от пользователя. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: ChatArrival(tUser, sData)

KeyArrival(tUser], sData) - Поступившее от пользователя сообщение с ключём доступа на хаб.
Аналог API 1: KeyArrival(tUser], sData)

ValidateNickArrival(tUser, sData) - Поступившая от пользователя команда с запросом на проверку ника на правильность при входе на хаб.
Аналог API 1: ValidateNickArrival(tUser, sData)

PasswordArrival(tUser, sData) - Поступившее от пользователя сообщение с паролем.
Аналог API 1: PasswordArrival(tUser, sData)

VersionArrival(tUser, sData) - Поступившее от пользователя сообщение с версией протокола.
Аналог API 1: VersionArrival(tUser, sData)

GetNickListArrival(tUser, sData) - Поступившее от пользователя сообщение с запросом на получение списка пользователей.
Аналог API 1: GetNickListArrival(tUser, sData)

MyINFOArrival(tUser, sData) - Поступившее от пользователя сообщение с информацией о его клиенте (MyINFO). Функция выполняется после поступления на хаб строки MyINFO и до отправки этой строки всем пользователям хаба.
Аналог API 1: MyINFOArrival(tUser, sData)

GetINFOArrival(tUser, sData) - Поступившее от пользователя сообщение с запросом на получение информации о другом пользователе.
Аналог API 1: GetINFOArrival(tUser, sData)

SearchArrival(tUser, sData) - Поступившее от пользователя сообщение с поисковым запросом. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: SearchArrival(tUser, sData)

MultiSearchArrival(tUser, sData) - Поступившее от пользователя сообщение с поисковым запросом на линкованый хаб. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: нету

ToArrival(tUser, sData) - Поступившее приватное сообщение от пользователя. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: ToArrival(tUser, sData)

ConnectToMeArrival(tUser, sData) - Поступившее от пользователя сообщение с запросом на активное соединение. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: ConnectToMeArrival(tUser, sData)

MultiConnectToMeArrival(tUser, sData) - Поступившее от пользователя сообщение с запросом на множественное соединение (применяется в случае слинкованых хабов). Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: MultiConnectToMeArrival(tUser, sData)

RevConnectToMeArrival(tUser, sData) - Поступившее от пользователя сообщение с запросом на пассивное соединение. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: RevConnectToMeArrival(tUser, sData)

SRArrival(tUser, sData) - Поступившее от пользователя сообщение с ответом на поисковой запрос. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: SRArrival(tUser, sData)

UDPSRArrival(tUser, sData) - Поступившее от пользователя сообщение с ответом на поисковой запрос. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: UDPSRArrival(tUser, sData)

KickArrival(tUser, sData) - Поступившее от пользователя сообщение с командой о кике. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: KickArrival(tUser, sData)

OpForceMoveArrival(tUser, sData) - Поступившее от пользователя сообщение с командой о редиректе. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: OpForceMoveArrival(tUser, sData)

UnknownArrival(tUser, sData) - Поступившее от пользователя сообщение с неизвестной командой. Если скрипт возвращает true, хаб не обрабатывает данные (но не отключает пользователя).
Аналог API 1: UnknownArrival(tUser, sData)

BotINFOArrival(tUser, sData) - Поступившее от пользователя сообщение с запросом на пинг хаблиста. Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: BotINFOArrival(tUser, sData)

CloseArrival(tUser, sData) - Поступившая от пользователя на хаб команда о закрытии соединения другого пользователя (drop). Если скрипт возвращает true, хаб не обрабатывает данные.
Аналог API 1: CloseArrival(tUser, sData)

http://mydc.ru/r/?http://wiki.mydc.ru/События_Lua_API_в_PtokaX.

Автор: Svyat 29.6.2008, 21:19

function OnStartup() - Это функция вызывается (выполняется) при запуске скрипта. Как правило при запуске скрипта "регистрируют" бота. пример:

function OnStartup()
Core.RegBot("Василий", "", "", true)
end

или догружать и выполнять необходимые модули (файлы):

function OnStartup()
if loadfile(file) then
dofile(file)
end
end

Автор: Setuper 1.7.2008, 23:09

SupportsArrival(tUser, sData)
Важная функция (с её помошью я смог устроить автоматическую регистрация по ip).
В данной функции происходить объявление основных полей таблицы пользователя, а также проверяется поддержка дополнений.
пример команды: "$Supports UserCommand NoGetINFO NoHello UserIP2 TTHSearch ZPipe0 |" - клиент говорит, что он поддерживает:

UserCommand - контекстные команды менюшек,
NoGetINFO - не нужна отсылка команды GetINFO для получения MyINFO,
NoHello - не обязательна отсылка команд $Hello и $NickList,
UserIP2 - поддержка технологии UserIP2,
TTHSearch - поддержка поиска по TTH,
ZPipe0 - поддержка команды $ZOn - команды сжатия данных (библиотека zlib)

Автор: Setuper 26.9.2008, 18:42

Продолжение разбора интерфейса PtokaX.

Функции API 2 и их аналоги в API 1:

Core.Version - Получить версию PtokaX.
Аналог API 1: второе значение функции getHubVresion()

Core.Restart() - Перезапустить хаб.
Аналог API 1: frmHub:Restart()

Core.Shutdown() - Отключить хаб.
Аналог API 1: нету

Core.ResumeAccepts() - Продолжать прослушивать сокет(ы), если их прослушивание не было приостановлено.
Аналог API 1: нету

Core.SuspendAccepts() - Приостановить прослушивание сокета(ов). Хаб выглядит так, как будто не работает.
Аналог API 1: SuspendAccepts(0)

Core.SuspendAccepts(nTime) - Приостановить прослушивание сокета(ов) на указанное время в секундах. Хаб выглядит так, как будто не работает.
Аналог API 1: SuspendAccepts(nTime)

Core.RegBot(sBotName, sDescription, sEmail, bHaveKey) - Регистрирует бота на хабе. Максимальная длина строковых параметров - 64 символа !!! В нике недопустимы символы: $|<>:?*"/\ и пробел. В параметрах Description и Email недопустимы символы $ и |. Функция возвращает nil в случае невозможности зарегистрировать бота, в случае удачной регистрации возвращает true.
Аналог API 1: frmHub:RegBot(sBotName, bHaveKey, sDescription, sEmail)

Core.UnregBot(sBotName) - Удаление бота. Функция возвращает nil в случае невозможности разрегистрировать бота, в случае удачной разрегистрации возвращает true.
Аналог API 1: frmHub:UnregBot(sBotName)

Core.GetBots() - Возвращает таблицу со всеми ботами, зарегистрированными скриптами, как таблицу с полями sNick, sMyINFO, bIsOP and sScriptName.
Аналог API 1: нету

Core.GetActualUsersPeak() - Возвращает фактический пик пользователей.
Аналог API 1: frmHub:GetActualUsersPeak()

Core.GetMaxUsersPeak() - Возвращает максимальный пик пользователей.
Аналог API 1: frmHub:GetMaxUsersPeak()

Core.GetCurrentSharedSize() - Возвращает суммарную шару хаба в байтах.
Аналог API 1: frmHub:GetCurrentShareAmount()

Core.GetHubIP() - Возвращает IP хаба, если он доступен, иначе возвращает nil.
Аналог API 1: frmHub:GetHubIp()

Core.GetHubSecAlias() - Возвращает фактический псевдоним Hub-Security бота.
Аналог API 1: frmHub:GetHubSecAliasName()

Core.GetPtokaXPath() - Возвращает путь до файла PtokaX.exe.
Аналог API 1: frmHub:GetPtokaXLocation()

Core.GetUsersCount() - Возвращает число пользователей на хабе.
Аналог API 1: frmHub:GetUsersCount()

Core.GetUpTime() - Возвращает время работы хаба в секундах.
Аналог API 1: frmHub:GetUpTime()

Core.GetOnlineNonOps() - Возвращает таблицу со всеми таблицами онлайн пользователей без статуса оператора.
Аналог API 1: frmHub:GetOnlineNonOperators()

Core.GetOnlineNonOps(bAllData) - Возвращает таблицу со всеми таблицами онлайн пользователей без статуса оператора. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: frmHub:GetOnlineNonOperators()

Core.GetOnlineOps() - Возвращает таблицу со всеми таблицами онлайн пользователей со статусом оператора.
Аналог API 1: frmHub:GetOnlineOperators()

Core.GetOnlineOps(bAllData) - Возвращает таблицу со всеми таблицами онлайн пользователей со статусом оператора. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: frmHub:GetOnlineOperators()

Core.GetOnlineRegs() - Возвращает таблицу со всеми таблицами зарегистрированных (profile > -1) онлайн пользователей.
Аналог API 1: frmHub:GetOnlineRegUsers()

Core.GetOnlineRegs(bAllData) - Возвращает таблицу со всеми таблицами зарегистрированных (profile > -1) онлайн пользователей. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: frmHub:GetOnlineRegUsers()

Core.GetOnlineUsers() - Возвращает таблицу со всеми таблицами онлайн пользователей.
Аналог API 1: frmHub:GetOnlineUsers()

Core.GetOnlineUsers(bAllData) - Возвращает таблицу со всеми таблицами онлайн пользователей. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: frmHub:GetOnlineUsers()

Core.GetOnlineUsers(nProfileNumber) - Возвращает таблицу пользователей с указанным профилем.
Аналог API 1: frmHub:GetOnlineUsers(nProfileNumber)

Core.GetOnlineUsers(nProfileNumber, bAllData) - Возвращает таблицу пользователей с указанным профилем. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: frmHub:GetOnlineUsers(nProfileNumber)

Core.GetUser(sNick) - Возвращает таблицу онлайн пользователя по нику.
Аналог API 1: GetItemByName(sNick)

Core.GetUser(sNick, bAllData) - Возвращает таблицу онлайн пользователя по нику. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: GetItemByName(sNick)

Core.GetUserAllData(tUser) - Добавляет или обновляет все данные в таблице пользователя. Возвращает nil в случае неудачи (пользователь оффлайн) или true в случае успеха.
Аналог API 1: нету

Core.GetUserData(tUser, nValueId) - Добавляет или обновляет данные с указанным идентификатором в таблице пользователя. Возвращает nil в случае неудачи (пользователь оффлайн) или true в случае успеха.
Аналог API 1: нету

Core.GetUserValue(tUser, nValueId) - Возвращает данные с указанным идентификатором или nil в случае неудачи (пользователь оффлайн).
Аналог API 1: нету

Core.GetUsers(sIP) - Возвращает онлайн пользователей с указанным ip как таблицу с таблицами пользователей или nil в случае, если пользователь с указанным ip не найден или ip введен неверно.
Аналог API 1: нету

Core.GetUsers(sIP, bAllData) - Возвращает онлайн пользователей с указанным ip как таблицу с таблицами пользователей или nil в случае, если пользователь с указанным ip не найден или ip введен неверно. Используйте true для параметра bAllData, если вы хотите, чтобы таблицы содержали все данные.
Аналог API 1: нету

Core.Disconnect(sNick) - Разъединяет пользователя с указанным ником. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: DisconnectByName(sNick)

Core.Disconnect(tUser) - Разъединяет указанного пользователя. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: tUser:Disconnect()

Core.Kick(tUser, sKickerNick, sReason) - Кикает пользователя. Максимальная длина параметра KickerNick - 64 символа, максимальная длина парамерта Reason - 128000 символов. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: tUser:Kick(sKickerNick, sReason)

Core.Redirect(tUser, sAddress, sReason) - Перенаправляет пользователя на указанный адрес с указанной причиной. Максимальная длина параметра Address - 1024 символа. Максимальная длина параметра Reason - 128000 символов. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: tUser:Redirect(sAddress, sReason)

Core.DefloodWarn(tUser) - Предупреждение пользователю по причини флуда. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: нету

Core.SendToAll(sData) - Послать данные всем пользователям. Максимальная длина параметра sData - 128000 символов. Если данные не содержат в конце символа |, то он автоматически добавляется.
Аналог API 1: SendToAll(sData)

Core.SendToNick(sNick, sData) - Послать данные пользователю с указанным ником. Максимальная длина параметра sData - 128000 символов. Если данные не содержат в конце символа |, то он автоматически добавляется.
Аналог API 1: SendToNick(sNick, sData)

Core.SendToOpChat(sData) - Послать данные, как приват сообщение, в ОпЧат. Максимальная длина параметра sData - 128000 символов. Если ОпЧат не разрещен - не посылает ничего.
Аналог API 1: SendToOpChat(sData)

Core.SendToOps(sData) - Послать данные всем операторам. Максимальная длина параметра sData - 128000 символов. Если данные не содержат в конце символа |, то он автоматически добавляется.
Аналог API 1: SendToOps(sData)

Core.SendToProfile(nProfileNumber, sData) - Послать данные пользователям с указанным профилем. Максимальная длина параметра sData - 128000 символов. Если данные не содержат в конце символа |, то он автоматически добавляется.
Аналог API 1: нету

Core.SendToUser(tUser, sData) - Послать данные указанному пользователю. Максимальная длина параметра sData - 128000 символов. Если данные не содержат в конце символа |, то он автоматически добавляется.
Аналог API 1: tUser:SendData(sData)

Core.SendPmToAll(sFromNick, sData) - Послать данные как приват сообщение всем пользователям. Максимальная длина параметра FromNick - 64 символа, максимальная длина параметра Data - 128000 символов.
Аналог API 1: SendPmToAll(sFromNick, sData)

Core.SendPmToNick(sToNick, sFromNick, sData) - Послать данные как приват сообщение пользователю с указанным ником. Максимальная длина параметра FromNick - 64 символа, максимальная длина параметра Data - 128000 символов.
Аналог API 1: SendPmToNick(sToNick, sFromNick, sData)

Core.SendPmToOps(sFromNick, sData) - Послать данные как приват сообщение всем операторам. Максимальная длина параметра FromNick - 64 символа, максимальная длина параметра Data - 128000 символов.
Аналог API 1: SendPmToOps(sFromNick, sData)

Core.SendPmToProfile(nProfileNumber, sFromNick, sData) - Послать данные как приват сообщение пользователям с указанным профилем. Максимальная длина параметра FromNick - 64 символа, максимальная длина параметра Data - 128000 символов.
Аналог API 1: нету

Core.SendPmToUser(tUser, sFromNick, sData) - Послать приват сообщение указанному пользователю. Максимальная длина параметра FromNick - 64 символа, максимальная длина параметра Data - 128000 символов.
Аналог API 1: tUser:SendPM(sFromNick, sData)

-------------------
SetMan.Save() - Принудительно сохраняет настройки.
Аналог API 1: нету

SetMan.GetMOTD() - Возвращает сообщение дня MOTD.
Аналог API 1: frmHub:GetMOTD()

SetMan.SetMOTD(sString) - Устанавливает сообщение дня MOTD. Символ | не допустим в сообщении.
Аналог API 1: frmHub:SetMOTD()

SetMan.GetBool(nBoolId) - Возвращает Булево знаечение парамерта настроек true или nil с указанным идентификатором.
Аналог API 1: нету

SetMan.SetBool(nBoolId, bBoolean) - Устанавливает Булево значение параметру настроек с указанным идентификатором.
Аналог API 1: нету

SetMan.GetNumber(nNumberId) - Возвращает числовое значение параметра с указанным идентификатором.
Аналог API 1: нету

SetMan.SetNumber(nNumberId, nNumber) - Устанавливает числовое значение параметру с указанным идентификатором.
Аналог API 1: нету

SetMan.GetString(nStringId) - Возвращает строковое значение параметра с указанным идентификатором. Возвращает строку или nil.
Аналог API 1: нету

SetMan.SetString(nStringId, sString) - Устанавливает строковое значение параметру с указанным идентификатором.
Аналог API 1: нету

SetMan.GetMinShare() - Возвращает минимальную шару в байтах.
Аналог API 1: frmHub:GetMinShare()

SetMan.SetMinShare(nShareInBytes) - Устанавливает минимальную шару в байтах.
Аналог API 1: frmHub:SetMinShare(nShareInBytes)

SetMan.SetMinShare(nMinShare, nShareUnits) - Устанавливает минимальную шару. Максимальное значение параметра nMinShare - 9999. Параметр nShareUnits может принимать следующие значения: 0 = Б, 1 = КБ, 2 = МБ, 3 = ГБ, 4 = ТБ.
Аналог API 1: frmHub:SetMinShare(nShareInBytes, nShareUnits)

SetMan.GetMaxShare() - Возвращает максимальную шару в байтах.
Аналог API 1: frmHub:GetMaxShare()

SetMan.SetMaxShare(nShareInBytes) - Устанавливает максимальную шару в байтах.
Аналог API 1: frmHub:SetMaxShare(nShareInBytes)

SetMan.SetMaxShare(nMaxShare, nShareUnits) - Устанавливает максимальную шару. Максимальное значение параметра nMinShare - 9999. Параметр nShareUnits может принимать следующие значения: 0 = Б, 1 = КБ, 2 = МБ, 3 = ГБ, 4 = ТБ.
Аналог API 1: frmHub:SetMaxShare(nShareInBytes, nShareUnits)

SetMan.SetHubSlotRatio(nHubs, nSlots) - Устанавливает соотношение хабы/слоты.
Аналог API 1: frmHub:SetHubSlotRatio(nHubs, nSlots)

SetMan.GetOpChat() - Возвращает таблицу ОпЧата с полями: sNick, sDescription, sEmail, bEnabled.
Аналог API 1: нету

SetMan.SetOpChat(bEnabled, sNewOpChatName, sNewDescription, sNewEmail) - Устанавливает параметры ОпЧата. Максимальная длина строковых параметров - 64 символа !!! В нике недопустимы символы: $|<>:?*"/\ и пробел. В параметрах Description и Email недопустимы символы $ и |. Возвращает nil в случае неудачи, иначе возвращает true.
Аналог API 1: frmHub:SetOpChatData(sNewOpChatName, sNewDescription, sNewEmail)

SetMan.GetHubBot() - Возвращает таблицу параметров главного бота с полями: sNick, sDescription, sEmail, bEnabled, bUsedAsHubSecAlias.
Аналог API 1: нету

SetMan.SetHubBot(bEnabled, sNewHubBotName, sNewDescription, sNewEmail, bUseAsHubSecAlias) - Устанавливает параметры главного бота. Максимальная длина строковых параметров - 64 символа !!! В нике недопустимы символы: $|<>:?*"/\ и пробел. В параметрах Description и Email недопустимы символы $ и |. Возвращает nil в случае неудачи, иначе возвращает true.
Аналог API 1: frmHub:SetHubBotData(sNewHubBotName, sNewDescription, sNewEmail)

-------------------
RegMan.Save() - Принудительно сохраняет зарегистрированных пользователей.
Аналог API 1: нету

RegMan.GetRegsByProfile(nProfileNumber) - Возвращает таблицу со всеми зарегистрированными пользователями с указанным профилем как таблицы RegisteredUser.
Аналог API 1: нету

RegMan.GetNonOps() - Возвращает таблицу со всеми зарегистрированными пользователями, которые не имеют статуса оператора как таблицы RegisteredUser.
Аналог API 1: frmHub:GetNonOperators()

RegMan.GetOps() - Возвращает таблицу со всеми зарегистрированными пользователями, которые имеют статус оператора как таблицы RegisteredUser.
Аналог API 1: frmHub:GetOperators()

RegMan.GetReg(sNick) - Возвращает таблицу пользователя как таблицу RegisteredUser или nil, если пользователь с указанным ником не зарегистрирован.
Аналог API 1: нету

RegMan.GetRegs() - Возвращает таблицу со всеми зарегистрированными пользователями, как таблицы RegisteredUser.
Аналог API 1: frmHub:GetRegisteredUsers()

RegMan.AddReg(sNick, sPass, nProfileNumber) - Регистрирует пользователя с указанным ником, паролем и профилем. Символы $|<>:?*"/\ и пробел не допустимы в нике. Символ | не допустим в пароле. Миксимальная длина ника/пароля - 64 символа. Возвращает nil в случае неудачи, true в случае успеха.
Аналог API 1: frmHub:AddRegUser(sNick, sPass, nProfileNumber)

RegMan.DelReg(sNick) - Удаляет регистрацию указанного пользователя. Возвращает nil в случае неудачи, true в случае
успеха.
Аналог API 1: frmHub:DelRegUser(sNick)

RegMan.ChangeReg(sNick, sPass, nProfileNumber) - Изменяет регистрацию указанного пользователя. Возвращает nil в случае неудачи, true в случае успеха.
Аналог API 1: frmHub:ChangeRegUser(sNick, sPass, nProfileNumber)

RegMan.ClrRegBadPass(sNick) - Очищает количество неудачных вводов пароля для указанного ника. Возвращает nil в случае неудачи, true в случае успеха.
Аналог API 1: ClrRegBadPass(sNick)

-------------------
BanMan.Save() - Принудительно cохраняет баны.
Аналог API 1: нету

BanMan.GetBans() - Возвращает таблицу банов.
Аналог API 1: нету

BanMan.GetTempBans() - Возвращает таблицу временных банов.
Аналог API 1: frmHub:GetTempBanList()

BanMan.GetPermBans() - Возвращает таблицу постоянных банов.
Аналог API 1: frmHub:GetPermBanList()

BanMan.GetBan(sNick/sIP) - Возвращает таблицу бана для указанного ника/ip или nil если таковой таблицы нет.
Аналог API 1: нету

BanMan.GetPermBan(sNick/sIP) - Возвращает таблицу постоянного бана для указанного ника/ip или nil если таковой таблицы нет.
Аналог API 1: нету

BanMan.GetTempBan(sNick/sIP) - Возвращает таблицу временного бана для указанного ника/ip или nil если таковой таблицы нет.
Аналог API 1: нету

BanMan.GetRangeBans() - Возвращает таблицу забаненных рангов.
Аналог API 1: нету

BanMan.GetTempRangeBans() - Возвращает таблицу временно забаненных рангов.
Аналог API 1: frmHub:GetTempRangeBans()

BanMan.GetPermRangeBans() - Возвращает таблицу постоянно забаненных рангов.
Аналог API 1: frmHub:GetPermRangeBans()

BanMan.GetRangeBan(sIPFrom, sIPTo) - Возвращает таблицу забаненных рангов для данного ранга или nil в случае отсутствия таковой.
Аналог API 1: нету

BanMan.GetRangePermBan(sIPFrom, sIPTo) - Возвращает таблицу постоянно забаненных рангов для данного ранга или nil в случае отсутствия таковой.
Аналог API 1: нету

BanMan.GetRangeTempBan(sIPFrom, sIPTo) - Возвращает таблицу временно забаненных рангов для данного ранга или nil в случае отсутствия таковой.
Аналог API 1: нету

BanMan.Unban(sNick/sIP) - Снятие бана с указанного ника или ip. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: нету

BanMan.UnbanPerm(sNick/sIP) - Снятие постоянного бана с указанного ника или ip. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: UnBan(sNick/sIP)

BanMan.UnbanTemp(sNick/sIP) - Снятие временного бана с указанного ника или ip. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: TempUnBan(sNick/sIP)

BanMan.UnbanAll(sIP) - Снятие всех банов с указанного ip.
Аналог API 1: нету

BanMan.UnbanPermAll(sIP) - Снятие всех поятоянных банов с указанного ip.
Аналог API 1: нету

BanMan.UnbanTempAll(sIP) - Снятие всех временных банов с указанного ip.
Аналог API 1: нету

BanMan.RangeUnban(sIPFrom, sIPTo) - Снятие бана с указанного ранга. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: RangeUnban(sIPFrom, sIPTo)

BanMan.RangeUnbanPerm(sIPFrom, sIPTo) - Снятие постоянного бана с указанного ранга. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: RangePermUnban(sIPFrom, sIPTo)

BanMan.RangeUnbanTemp(sIPFrom, sIPTo) - Снятие временного бана с указанного ранга. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: RangeTempUnban(sIPFrom, sIPTo)

BanMan.ClearBans() - Очистка таблицы банов.
Аналог API 1: нету

BanMan.ClearPermBans() - Очистка таблицы постоянных банов.
Аналог API 1: ClearPermBans()

BanMan.ClearTempBans() - Очистка таблицы временных банов.
Аналог API 1: ClearTempBans()

BanMan.ClearRangeBans() - Очистка таблицы бан-рангов.
Аналог API 1: ClearRangeBans()

BanMan.ClearRangePermBans() - Очистка таблицы постоянных бан-рангов.
Аналог API 1: ClearRangePermBans()

BanMan.ClearRangeTempBans() - Очистка таблицы временных бан-рангов.
Аналог API 1: ClearRangeTempBans()

BanMan.Ban(tUser, sReason, sBy, bFull) - Дать постоянный бан пользователю. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: tUser:Ban(sReason, sBy, bFull)

BanMan.BanIP(sIP, sReason, sBy, bFull) - Дать постоянный бан пользователям с указанным ip. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: Ban(sIP, sReason, sBy, bFull)

BanMan.BanNick(sNick, sReason, sBy) - Дать постоянный бан пользователю с указанным ником. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: NickBan(sNick, sReason, sBy)

BanMan.TempBan(tUser, nTime, sReason, sBy, bFull) - Дать временный бан пользователю. Параметр nTime - время в минутах (0 = время бана берётся из настроек). Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: tUser:TempBan(nTime, sReason, sBy, bFull)

BanMan.TempBanIP(sIP, nTime, sReason, sBy, bFull) - Дать временный бан пользователям с указанным ip. Параметр nTime - время в минутах (0 = время бана берётся из настроек). Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: TempBan(sIP, nTime, sReason, sBy, bFull)

BanMan.TempBanNick(sNick, nTime, sReason, sBy) - Дать временный бан пользователю с указанным ником. Параметр nTime - время в минутах (0 = время бана берётся из настроек). Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: NickTempBan(sNick, nTime, sReason, sBy)

BanMan.RangeBan(sIPFrom, sIPTo, sReason, sBy, bFull) - Постоянный бан для указанного ранга ip. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: RangeBan(sIPFrom, sIPTo, sReason, sBy, bFull)

BanMan.RangeTempBan(sIPFrom, sIPTo, nTime, sReason, sBy, bFull) - Временный бан для указанного ранга ip. Параметр nTime - время в минутах (0 = время бана берётся из настроек). Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: RangeTempBan(sIPFrom, sIPTo, nTime, sReason, sBy, bFull)

-------------------
ProfMan.AddProfile(sProfileName) - Добавляет профиль в менеджер профилей, возвращает номер профиля в случае успеха или nil, если такой профиль уже есть.
Аналог API 1: AddProfile(sProfileName,0)

ProfMan.RemoveProfile(sProfileName) - Удаляет профиль их менеджера профилей, возвращает true в случае успеха или nil, если указанный профиль не существует или наоборот существует и используется.
Аналог API 1: RemoveProfile(sProfileName)

ProfMan.MoveDown(nProfileNumber) - Сдвиг профиля вниз. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: нету

ProfMan.MoveUp(nProfileNumber) - Сдвиг профиля вверх. Возвращает nil в случае неудачи, true - в случае успеха.
Аналог API 1: нету

ProfMan.GetProfile(sProfileName/nProfileNumber) - Возвращает профиль как таблицу профиля или nil, если такого профиля нет.
Аналог API 1: нету

ProfMan.GetProfiles() - Возвращает таблицу с профилями как профильные таблицы.
Аналог API 1: GetProfiles()

ProfMan.GetProfilePermission(nProfileNumber, nPermissionId) - Возвращает true, если настройка разрешена, иначе возвращает nil.
Аналог API 1: нету

ProfMan.GetProfilePermissions(nProfileNumber) - Возвращает таблицу с настройками профиля.
Аналог API 1: GetProfilePermissions(nProfileNumber)

ProfMan.SetProfileName(nProfileNumber, sProfileName) - Изменяет имя профиля, возвращает true в случае удачи или nil, если указанного профиля не существует.
Аналог API 1: нету

ProfMan.SetProfilePermission(nProfileNumber, nPermissionId, bBoolean) - Изменяет настройку профиля с указанным идентификатором, возвращает true в случае удачи или nil, если указанного профиля не существует.
Аналог API 1: нету

-------------------
TmrMan.AddTimer(nTimerInterval) - Добавляет новый таймер для скрипта. Параметр nTimerInterval - время в милисекундах. Возвращает nil - в случае неудачи или nTimerId - в случае успеха.
Аналог API 1: SetTimer(nTimerInterval) StartTimer()

TmrMan.AddTimer(nTimerInterval, sFunctionName) - Добавляет новый таймер для скрипта. Параметр nTimerInterval - время в милисекундах. Параметр sFunctionName - это имя функции выполняемой таймером. Возвращает nil - в случае неудачи или nTimerId - в случае успеха.
Аналог API 1: нету

TmrMan.RemoveTimer(nTimerId) - Удаляет таймер с указанным идентификатором из скрипта.
Аналог API 1: StopTimer()

-------------------
UDPDbg.Reg(sIp, nPort, bAllData) - Регистрирует получателя данных от PtokaX через UDP, если параметр bAllData равен false, то получать данные только от этого скрипта. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

UDPDbg.Unreg() - Удалить получателя данных.
Аналог API 1: нету

UDPDbg.Send(sData) - Отправить данные через UDP. Если скрипт зарегистрирован, то только от зарегистрированного скрипта, иначе от всех скриптов. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

-------------------
ScriptMan.GetScript() - Возвращает таблицу этого скрипта с полями sName, bEnabled, iMemUsage.
Аналог API 1: нету

ScriptMan.GetScripts() - Возвращает таблицу всех скриптов с полями sName, bEnabled, iMemUsage.
Аналог API 1: нету

ScriptMan.MoveUp(sScriptName) - Сдвинуть указанный скрипт выше. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

ScriptMan.MoveDown(sScriptName) - Сдвинуть указанный скрипт ниже. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

ScriptMan.StartScript(sScriptName) - Запустить скрипт с указанным именем. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

ScriptMan.RestartScript(sScriptName) - Перезапустить указанный скрипт. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

ScriptMan.StopScript(sScriptName) - Остановить указанный скрипт. Возвращает nil в случае неудачи или true в случае успеха.
Аналог API 1: нету

ScriptMan.Restart() - Перезапустить все скрипты.
Аналог API 1: frmHub:RestartScripts()

ScriptMan.Refresh() - Обновить скрипт-лист.
Аналог API 1: нету

-------------------
IP2Country.GetCountryCode(sIP) - Возвращает код страны для указанного ip или nil, если ip не действителен.
Аналог API 1: нету

IP2Country.GetCountryName(sIP) - Возвращает имя страны для указанного ip или nil, если ip не действителен.
Аналог API 1: нету

IP2Country.GetCountryName(tUser) - Возвращает имя страны для указанного пользователя.
Аналог API 1: нету

Автор: Setuper 27.1.2009, 12:45

ВНИМАНИЕ!!!
Все доступные для программирования под хаб функции находятся:
для API1 в папке с PtokaX.exe в файле Scripting-Interface.txt
для API2 в папке scripting.docs в файле scripting-interface.txt

Описания функций для работы с файлами, строками, таблицами и другими элементами lua языка находятся в мануале по lua: manual.html ( 248.66 килобайт ) : 244

Если вы не знаете синтаксис языка lua, то почитайте его на русском сайте lua: http://mydc.ru/r/?http://www.lua.ru/doc/

Автор: Invisible 10.10.2010, 20:37

Здравствуйте Друзья Скриптеры. А будет ли продолжение банкет с примерами функций, и всего Api? к примеру как http://mydc.ru/topic118.html?view=findpost&p=512. Синтаксис не объязателен ;)

Автор: Nickolya 11.10.2010, 15:50

Вряд ли, вроде все понятно и так, тестируй, тогда разберешься быстро! На голой теории выехать вряд ли вообще получится. Если что неясно - есть http://mydc.ru/topic173.html.