SAMP.Lua

Изначально эта библиотека задумывалась как простой апи исключительно для обработки сетевых пакетов, но в процессе было решешо, что лучше бы сделать её полноценной библиотекой для работы с сампом, в будущем это позволит избавить от необходимости использования SAMPFUNCS. Пока реализован только модуль, значительно упрощающий работу с пакетами, так что говорить сейчас будем о нём.

SAMP.Events
Этот модуль добавляет событийную обработку входящих и исходящих RakNet пакетов. Имеет удобный API, полностью кастомизируем, предоставляет те же возможности, что и обычные хуки: чтение, перезапись, игнорирование.


Использование
Простой пример обработки исходящего сообщения в чат:
Lua: 
local sampev = require 'lib.samp.events'

function sampev.onSendChat(msg)
  print('You said: ' .. msg)
end
Да, настолько просто. Нужно лишь загрузить библиотеку и добавить функцию с соответствующими аргументами, вот и всё.
Перезапись данных в пакете настолько же проста, нужно лишь вернуть из функции все значения в том же порядке, занеся их в таблицу.
Lua: 
function sampev.onSendChat(msg)
  return {'I said: ' .. msg}
end
Будет дописывать текст "I said:" в начало каждого отправляемого сообщения.
Если вернуть из функции false, то пакет будет проигнорирован клиентом. Этот код запретит серверу изменять позицию игрока:
Lua: 
function sampev.onSetPlayerPos(position)
  print(string.format('Server tried to change your position to %0.2f %0.2f %0.2f', position.x, position.y, position.z))
  return false
end
Структуры всех пакетов находятся в файле events.lua.

Перезапись исходящих пакетов синхронизации слегка отличается от всех остальных - они не требуют возврата аргументов, а вместо этого данные перезаписываются как в обычной таблице lua. Это сделано для повышения производительности.
Пример перезаписи позиции в исходящих данных синхронизации игрока:
Lua: 
function sampev.onSendPlayerSync(data)
  print('Original position:', data.position.x, data.position.y, data.position.z)
  data.position.x = 1337
  data.position.y = 1488
  data.position.z = 228
end
Это применимо только в событиях onSendPlayerSync, onSendVehicleSync, onSendPassengerSync, onSendAimSync, onSendUnoccupiedSync, onSendTrailerSync, onSendBulletSync, onSendSpectatorSync.
Структуры всех пакетов синхронизации находятся в файле synchronization.lua.


Примеры скриптов
AntiCarJack - перехват и игнорирование входящего RPC и пакета синхронизации
Bubble Sniffer - перехват и обработка входящего RPC
DerpCam - перезапись данных исходящего пакета синхронизации
Chat Bliss - перезапись, игнорирование и обработка исходящего RPC


Кастомизация
API структурирован так, что позволяет вносить в него любые изменения, не прибегая к изменению исходных файлов модулей.
Добавление своего обработчика для серверного пакета проигрывания звука:
Lua: 
local sampev = 'lib.samp.events'
local raknet = 'lib.samp.raknet'
sampev.INTERFACE.INCOMING_RPCS[raknet.RPC.PLAYSOUND] = {'onPlaySound', {soundId = 'int32'}, {x = 'float'}, {y = 'float'}, {z = 'float'}}
И теперь в тот же файл можно добавить функцию для обработки события:
Lua: 
function sampev.onPlaySound(sound, x, y, z)
-- добавляем сообщение в лог
print(string.format('Sound %d at coords %0.2f, %0.2f, %0.2f', sound, x, y, z))
-- и отключаем звук, запрещая дальнейшую обработку пакета
return false
end
Следует сразу разобрать код регистрации события, чтобы стало понятнее.
Lua: 
sampev.INTERFACE. -- поле INTERFACE - это все экспортируемые элементы модуля
INCOMING_RPCS -- обращение к списку входящих RPC
[raknet.RPC.PLAYSOUND] -- обращение к элементу таблицы INCOMING_RPCS по индексу, в данном случае INCOMING_RPCS - это таблица, содержащая список структур всех входящих RPC, а raknet.RPC.PLAYSOUND - идентификатор требуемого RPC
= -- присваиваем ему новое значение - таблицу с информацией о событии и структурой пакета
{'onPlaySound', -- название события, функция события будет использовать это имя
-- структура пакета. каждый параметр должен быть заключен в отдельную таблицу, иметь название и тип в формате {названиеПараметра = 'тип'}
{soundId = 'int32'}, {coords = 'vector3d'}}
Очевидно, что INCOMING_RPCS - это не единственная таблица, их четыре:
INCOMING_RPCS - входящие RPC
OUTCOMING_RPCS - исходящие RPC
INCOMING_PACKETS - входящие пакеты
OUTCOMING_PACKETS - исходящие пакеты

Новый тип тоже можно добавить без изменения исходников библиотеки:
Lua: 
events.INTERFACE.BitStreamIO.fvector3 = { -- название типа после последней точки
   read = function(bs) -- функция чтения. первый аргумент - битстрим
     local vec = {}
     vec.x = raknetBitStreamReadFloat(bs)
     vec.y = raknetBitStreamReadFloat(bs)
     vec.z = raknetBitStreamReadFloat(bs)
     return vec
   end,
   write = function(bs, value) -- функция записи
     raknetBitStreamWriteFloat(bs, value.x)
     raknetBitStreamWriteFloat(bs, value.y)
     raknetBitStreamWriteFloat(bs, value.z)
   end
}
В случае, если пакет имеет какую-то сложную структуру, не описываемую даже с помощью пользовательских типов, то вместо структуры можно передать функцию, которая будет обрабатывать данные. Например как это сделано для RPC InitGame:
Lua: 
INCOMING_RPCS[RPC.INITGAME] = {'onInitGame', onInitGameReader, onInitGameWriter} -- второй и третий аргумент - это функции чтения и записи
Для большего количества примеров смотрите исходный код.

Что касается всей библиотеки в целом, то она ещё находится на зачаточной стадии и обсуждать кроме планов нечего. По сути она должна заменить собой основную часть SAMPFUNCS - моддинг сампа.

Скачать последнюю версию и следить за изменениями всегда можно на GitHub.
Установка: скачать samp.zip из последнего релиза и целиком скопировать папку 'samp' (не содержимое папки!) из архива в каталог 'moonloader/lib/'.

Любая помощь в разработке приветствуется, особенно с добавлением новых структур. Предложите Pull request на гитхабе или напишите в этой теме.

Ну и конечно же крохотное нано-спасибо hnnssy за помощь.
 
Последнее редактирование:
  • Нравится
  • Влюблен
Реакции: Geral B i s, minxty, Mintha и 92 других
Нажмите для раскрытия...
U

ufdhbi

Известный
Проверенный
1,460
866
Если есть несколько скриптов использующих данную библиотеку, то некоторые не будут работать, например у меня в одном скрипт onServerMessage хук стоит, второй onShowDialog, третий cкрипт, в котором так же onShowDialog не работает, почему?
 
AnWu

AnWu

https://t.me/anwublog
Всефорумный модератор
4,770
5,377
ufdhbi написал(а):
Если есть несколько скриптов использующих данную библиотеку, то некоторые не будут работать, например у меня в одном скрипт onServerMessage хук стоит, второй onShowDialog, третий cкрипт, в котором так же onShowDialog не работает, почему?
Нажмите для раскрытия...
не встречал такой трабл. каждый скрипт должен отдельно обрабатывать события. такая тема ток если ты убиваешь rpc
 
CatKnight

CatKnight

Известный
148
55
Из-за чего у юзера может не хукать шоудиалог? Другие ивенты работают стабильно, а вот диалог просто игнорит. Скриптов других вроде нет, которые бы как-то на это влияли.
В логах чисто всё, никаких ошибок нет.
 
Последнее редактирование:
imring

imring

Ride the Lightning
Всефорумный модератор
2,361
2,546
CatKnight написал(а):
Из-за чего у юзера может не хукать шоудиалог? Другие ивенты работают стабильно, а вот диалог просто игнорит. Скриптов других вроде нет, которые бы как-то на это влияли.
В логах чисто всё, никаких ошибок нет.
Нажмите для раскрытия...
установлен addon?
 
qrlk

qrlk

Известный
Друг
411
926
CatKnight написал(а):
Нет. Трабл решил заменой на мои некоторых основных игровых файлов и заработало .-. Игра при этом чистая была. Мистика ебаная.
Нажмите для раскрытия...
Каких именно файлов?

Тоже не работает onShowDialog. Банально этот код не скрывает /mm на срп:
Lua: 
local q = require 'lib.samp.events'

function main()
    repeat wait(0) until isSampAvailable()
    wait(-1)
end

function q.onShowDialog(dialogId, style, title)
    if title:find('Main') then return false end
end
И если тупо без if, тоже молчание. Хз что делать. MoonLoader v.026.5-beta loaded. Лог чистый, ошибок нет.
@FYP
 
Frapsy

Frapsy

Известный
Проверенный
393
227
rubbishman написал(а):
не работает onShowDialog
Нажмите для раскрытия...
Он не хочет работать в случае, если что-то не так в файлах игры(в душе не шарю в каких), когда данная проблема возникала у меня - скачивал абсолютно чистую игру, и из модификаций только СФ, клео, мун. Пробуй хД
 
  • Нравится
Реакции: qrlk
FYP

FYP

Известный
Автор темы
Администратор
1,763
5,913
rubbishman написал(а):
Каких именно файлов?

Тоже не работает onShowDialog. Банально этот код не скрывает /mm на срп:
Lua: 
local q = require 'lib.samp.events'

function main()
    repeat wait(0) until isSampAvailable()
    wait(-1)
end

function q.onShowDialog(dialogId, style, title)
    if title:find('Main') then return false end
end
И если тупо без if, тоже молчание. Хз что делать. MoonLoader v.026.5-beta loaded. Лог чистый, ошибок нет.
@FYP
Нажмите для раскрытия...
какой-то из модов блокирует этот RPC. скорее всего какой-нибудь мод на замену диалогов
 
  • Нравится
Реакции: qrlk
imring

imring

Ride the Lightning
Всефорумный модератор
2,361
2,546
rubbishman написал(а):
Каких именно файлов?

Тоже не работает onShowDialog. Банально этот код не скрывает /mm на срп:
Lua: 
local q = require 'lib.samp.events'

function main()
    repeat wait(0) until isSampAvailable()
    wait(-1)
end

function q.onShowDialog(dialogId, style, title)
    if title:find('Main') then return false end
end
И если тупо без if, тоже молчание. Хз что делать. MoonLoader v.026.5-beta loaded. Лог чистый, ошибок нет.
@FYP
Нажмите для раскрытия...
addon есть?
 
  • Нравится
Реакции: qrlk
Войдите или зарегистрируйтесь для ответа.

Похожие темы

  1. Royan_Millans
    Lua CorrectionWords - Автоисправление в SA:MP
      • Нравится
      • Влюблен
      • Ха-ха
    Ответы
    230
    Просмотры
    96K
    Модификации
    kievdrifter
    K
  2. MrCreepTon
    • Статья
    Софт [2.01] MoonBot - внутриигровые боты для Moonloader
      • Нравится
      • Влюблен
      • Вау
    Ответы
    348
    Просмотры
    107K
    Lua
    Ya Zaregalsya
    Ya Zaregalsya
  3. Rei
    Софт RakSAMP Lite
      • Нравится
      • Влюблен
      • Вау
    Ответы
    2K
    Просмотры
    421K
    C/C++
    игрок сампа
    игрок сампа
  4. Rei
    SC23 Lua Terminator
      • Нравится
      • Вау
      • Влюблен
    Ответы
    82
    Просмотры
    19K
    Читы
    bimba0
    B
  5. Cosmo
    Lua [ARZ] Автобазар
      • Нравится
      • Влюблен
      • Вау
    Ответы
    220
    Просмотры
    106K
    Модификации
    stemheT
    S
Сверху Снизу