Исходник SA-MP API 0.3 (BETA) (Last update: 30.01.2021)

[_razor]

Всем привет. Хоть я и не разработчик данной библиотеки, я решил обновить ее и добавил туда несколько функций для SA:MP 0.3.DL. Если @LUCHARE будет против этого, я удалю тему.

Новые функции в 0.3 версии:

dl.isChatOpen() -- проверяет открыт ли чат, возвращает true/false
dl.setLocalUsername(pLocalPlayerName) -- устанавливает визуально ник локальному игроку, принимает pLocalPlayerName (string)
dl.isScoreboardOpen() -- проверяет открыт ли Scoreboard, возвращает true/false
dl.getServerWeather() -- возвращает номер погоды установленной сервером
dl.isDialogOnScreen(pDialogId) -- проверяет находится ли диалог с определенным ID на экране, принимает pDialogId (int)
dl.isAnyDialogOnScreen() -- проверяет находится ли любой диалог на экране, возвращает true/false
dl.getDialogId() -- возвращает ID диалога который находится на экране (использовать в связке с isAnyDialogOnScreen)
dl.getDialogStyle() -- возвращает номера стиля диалога который находится на экране
dl.getDialogCaption() -- возвращает заголовок диалога который находится на экране
dl.getDialogText() -- возвращает текст диалога который находится на экране
dl.isPlayerConnected(playerId) -- проверяет, подключен ли игрок с определенным ID на сервер, возвращает true/false (на ID локального игрока выдает false)

Подключение библиотеки:

local dl = require "SA-MP API.init"

В файле "demo SAMP-API 0.2.lua" есть применение всех этих функций
Так же в теме вы можете предложить улучшения для библиотеки и идеи по добавлению новых функций в нее!
Автор модуля: @LUCHARE . Автор доработки: @S E V E N

Спойлер: Актуальные функции

dl.GetIsAvailable() -- проверка на загруженность SA:MP
dl.Get() -- загружает струкруты SA:MP 0.3.DL с которыми можно будет работать
dl.SendChat(text) -- отправляет текст в чат (если это в text будет команда, он отправит команду)
dl.ToggleCursor(toggle) -- включение/выключение рендера курсора
dl.RegisterClientCommand(cmd, func, replaceOld) -- регистрирует команду для SA:MP 0.3.DL (всего может быть 144 клиентских команд)
dl.DeleteClientCommand(cmd) -- удаляет команду по ее названию
dl._RegisterClientCommand(cmd, func) -- регистрирует команду, в отличии от RegisterClientCommand, данная функция не может заменять команды
dl.TakeScreenshot() -- делает скриншот
dl.RequestSpawn() -- отправляет RPC о спавне игрока
dl.Spawn() -- спавнит игрока
dl.SetInputMode(mode, disable_cursor) -- открытие/закрытие строки ввода текста SAMP
dl.UnlockActorCam() -- возвращает управление персонажем (использовать если скрыт курсор)
dl.AddMessageToChat(msgType, msg, prefix, msgColor, prefixColor) -- отправляет сообщение в чат
dl.UpdateScoreboardData()-- отправляет RPC UpdateScoreboardData
dl.Say(msg) -- отправляет текст в чат
dl.SendCommand(cmd) -- отправляет команду на сервер
dl.SendInteriorChange(intID) -- отправляет RPC о смене интерьера
dl.RequestClass(classID) -- отправляет RPC о смене класса
dl.DisableScoreboard(enable) -- отключает Tab
dl.SetSpecialAction(actionId) -- выдает игроку специальное действие
dl.getLocalUsername() -- возвращает ник локального игрока
dl.getLocalPlayerId() -- возвращает ID локального игрока
dl.getLocalPlayerPing() -- возвращает пинг локального игрока
dl.getLocalPlayerScore() -- возвращает уровень локального игрока
dl.getMaxPlayerId() -- возвращает максимальный ID на сервере
dl.getServerIp() -- возвращает IP сервера к которому подключен игрок
dl.getServerHostname() -- возвращает название сервера к которому подключен игрок
dl.getServerPort() -- возвращает порт сервера к которому подключен игрок
dl.getGameState() -- возвращает текущее состоянии SAMP (отключен, ожидает подключения и т.д)
dl.isChatOpen() -- проверяет открыт ли чат, возвращает true/false
dl.setLocalUsername(pLocalPlayerName) -- устанавливает визуально ник локальному игроку, принимает pLocalPlayerName (string)
dl.isScoreboardOpen() -- проверяет открыт ли Scoreboard, возвращает true/false
dl.getServerWeather() -- возвращает номер погоды установленной сервером
dl.isDialogOnScreen(pDialogId) -- проверяет находится ли диалог с определенным ID на экране, принимает pDialogId (int)
dl.isAnyDialogOnScreen() -- проверяет находится ли любой диалог на экране, возвращает true/false
dl.getDialogId() -- возвращает ID диалога который находится на экране (использовать в связке с isAnyDialogOnScreen)
dl.getDialogStyle() -- возвращает номера стиля диалога который находится на экране
dl.getDialogCaption() -- возвращает заголовок диалога который находится на экране
dl.getDialogText() -- возвращает текст диалога который находится на экране
dl.isPlayerConnected(playerId) -- проверяет, подключен ли игрок с определенным ID на сервер, возвращает true/false (на ID локального игрока выдает false)

 

[_razor]

зочем, на дл никто не играет 😭
по теме - годно.

Читы никто не отменял под эту версию + у меня в планах перенести SAMP.lua под 0.3.DL и добавить больше функции которые были доступны в SAMPFUNCS

 

[Carrentine]

Читы никто не отменял под эту версию + у меня в планах перенести SAMP.lua под 0.3.DL

я про то что эту библиотеку будут использовать максимум 5 человек 😂

 

[_razor]

я про то что эту библиотеку будут использовать максимум 5 человек 😂

Думаю, что когда Arizona перейдет на 0.3.DL она кому-нибудь и понадобится

 

[Carrentine]

Думаю, что когда Arizona перейдет на 0.3.DL она кому-нибудь и понадобится

аризона никогда не перейдет на дл, а лаунчер будет на 0.3.7 🤦‍♂️

 

[_razor]

аризона никогда не перейдет на дл, а лаунчер будет на 0.3.7 🤦‍♂️

Ну и бог тогда с ней, все равно читы/модификации надо продвигать и в 0.3.DL

 

[DarkP1xel]

Читы никто не отменял под эту версию + у меня в планах перенести SAMP.lua под 0.3.DL и добавить больше функции которые были доступны в SAMPFUNCS

Ну и бог тогда с ней, все равно читы/модификации надо продвигать и в 0.3.DL

Нормальная тема. Я когда то тоже начал заморачиваться с адаптацией своих плагинов под разные версии SA:MP'a и отвязки от публичных API в сторону написания своего собственного. Вся эта затея привела меня в кризис в лице программиста. Ведь теперь я зависимый от лучше и лучше и написать так просто как раньше уже просто не могу себе позволить. Дорога на льду и она очень скользкая и по ней нужно идти очень уверенно, а иначе пинаешь это всё на себя.

 

[Flect]

адаптация под 0.3 dl актуальна, после того, как арз написали в своем посте о переходе в будущем на эту версию сампа, вероятно другие крупные проекты после этого также перейдут

 

[#Northn]

адаптация под 0.3 dl актуальна, после того, как арз написали в своем посте о переходе в будущем на эту версию сампа, вероятно другие крупные проекты после этого также перейдут

Другие крупные проекты зависимы от аризоны? Пфф, это обычный крах для проекта, поскольку на эти версии сампа нет нормальных скриптов и плагинов

 

[Sargon]

адаптация под 0.3 dl актуальна, после того, как арз написали в своем посте о переходе в будущем на эту версию сампа, вероятно другие крупные проекты после этого также перейдут

Они не писали о переходе на 0.3.DL, это всего лишь предположения, которые уже опровергнуты, будет 0.3.7.

 

[_razor]

Добавил несколько новых функций:
(обновил потому, что просили добавить isPlayerConnected и работу с диалогами)

dl.isChatOpen() -- проверяет открыт ли чат, возвращает true/false
dl.setLocalUsername(pLocalPlayerName) -- устанавливает визуально ник локальному игроку, принимает pLocalPlayerName (string)
dl.isScoreboardOpen() -- проверяет открыт ли Scoreboard, возвращает true/false
dl.getServerWeather() -- возвращает номер погоды установленной сервером
dl.isDialogOnScreen(pDialogId) -- проверяет находится ли диалог с определенным ID на экране, принимает pDialogId (int)
dl.isAnyDialogOnScreen() -- проверяет находится ли любой диалог на экране, возвращает true/false
dl.getDialogId() -- возвращает ID диалога который находится на экране (использовать в связке с isAnyDialogOnScreen)
dl.getDialogStyle() -- возвращает номера стиля диалога который находится на экране
dl.getDialogCaption() -- возвращает заголовок диалога который находится на экране
dl.getDialogText() -- возвращает текст диалога который находится на экране
dl.isPlayerConnected(playerId) -- проверяет, подключен ли игрок с определенным ID на сервер, возвращает true/false (на ID локального игрока выдает false)

 

[RTD]

А почему ты так делаешь?

if tostring(this.iIsEnabled) == "0" then
    return false
elseif tostring(this.iIsEnabled) == "1" then
    return true
end

Просто

return this.iIsEnabled == 1

не работает?
И

if tostring(this.iIsActive) == "1" then
    if tonumber(this.uiDialogID) == tonumber(pDialogId) then
        return true
    end
end

return this.iIsActive == 1 and this.uiDialogID == pDialogId

 

[_razor]

А почему ты так делаешь?

if tostring(this.iIsEnabled) == "0" then
    return false
elseif tostring(this.iIsEnabled) == "1" then
    return true
end

Просто

return this.iIsEnabled == 1

не работает?
И

if tostring(this.iIsActive) == "1" then
    if tonumber(this.uiDialogID) == tonumber(pDialogId) then
        return true
    end
end

return this.iIsActive == 1 and this.uiDialogID == pDialogId

Делаю как мне нравится и как мне удобно

 

[RTD]

Делаю как мне нравится и как мне удобно

Так делать экономически не выгодно и не очень то и правильно, ты все таки в общий доступ залил

 

[KepchiK]

Так делать экономически не выгодно и не очень то и правильно, ты все таки в общий доступ залил

да просто кое кто любит сговнокодить 🙂