Исходник Гайд LuaRak - RakNet в Lua!

[whyega52]

Доброго времени суток.​

Представьте, что вы молодой пацан и скачиваете себе LuaRak - библиотеку для Lua, позволяющую взаимодействовать с сетевым движком RakNet внутри ваших скриптов. Данная библиотека заточена первым делом под SAMP (DDOS, DOS, BotNet, мини-прикольчики), но это не мешает использовать ее для реализации собственных проектов, требующих сетевое взаимодействие (онлайн-игры, сетевая часть приложений и т.д.).

Исходный код: GitHub
Примеры использования: GitHub

Зависимости: LuaJIT, Windows.
Библиотека также без проблем работает внутри MoonLoader и RakSAMP Lite.

В связи с ограниченным временем, библиотека выходит только в Alpha-версии. Дальнейшее развитие зависит от вашего фидбека.​

Спойлер: Документация

Спойлер: LuaRak

LuaRak - таблица, возвращаемая при вызове require для библиотеки в вашем скрипте.

Использование	Параметры	Описание
local proxy = LuaRak:proxy()	Принимает: IP и порт прокси-сервера; если
local nickname = "LuaRak" local client = LuaRak:client(nickname)	Принимает: имя персонажа, которое будет использовано при подключении к серверу Возвращает: экземпляр класса LuaClient	Создает объект класса LuaClient (обертка RakClient)
local maxPlayers = 282 local port = 7777 local proxy = LuaRak:proxy() local server= LuaRak:client(maxPlayers, port, proxy)	Принимает: максимально количество игроков; порт, на котором будет располагаться сервер; экземпляр класса LuaProxy (если не указывать - сервер будет на основном порту). Возвращает: экземпляр класса LuaServer	Создает объект класса LuaServer (обертка RakServer)
local bs1 = LuaRak:BitStream() local bs2 = LuaRak:BitStream(bs) local data = "test" local lengthInBytes = 4 local copyData = false local bs3 = LuaRak:BitStream(data, lengthInBytes, true)	Принимает: 1 - ничего. 2 - экземпляр BitStream. 3 - указатель на данные; длина данных в байтах; будет ли создана копия данных Возвращает: экземпляр класса BitStream	Создает объект класса BitStream

Спойлер: LuaClient

Класс для работы на стороне клиента. Именно с помощью него можно можно творить полную грязь на серверах.
Помимо тех функций, что указаны в таблице, также есть функции для работы с RPC, их задокументирую позже

Использование​	Параметры​	Описание​
local client = LuaRak:client("Test") local ip = "127.0.0.1" local port = 7777 local proxy LuaRak:proxy() client:connect(ip, port, proxy)	Принимает: строку с IP или доменом сервера; порт сервера; ссылка на объект LuaProxy. Возвращает: true - если подключение не вызвало ошибок, false - если возникли какие-либо ошибки​	Подключает клиент к серверу​
local client = LuaRak:client("Test") local timeout = 10 client:disconect(timeout)	Принимает: время ожидания перед отключением, если оно не указано, клиент отключается мгновенно​	Отключает клиент от сервера​
local client = LuaRak:client("Test") local bs = LuaRak:BitStream() client:sendPacket(bs) local data = "hello" local length = #hello client:sendPacket(data, length)	Принимает: 1 - объект BitStream. 2 - указатель на данные; длину данных​	Отправляет пакет на сервер​
local client = LuaRak:client("Test") local bs = LuaRak:BitStream() client:sendRPC(bs) local data ="test" local length = #data client:sendRPC(data, length)	Принимает: 1 - объект BitStream; 2 - указатель на данные; длину данных​	Отправляет RPC на сервер​
local client = LuaRak:client("Test") while true do client:updateNetwork() end	​	Обрабатывает данные сети (входящие пакеты и другие обработчики)​
local function handler(...) print(...) end local client = LuaRak:client("Test") client:addEventHandler("onReceivePacket", handler) client:addEventHandler("onReceiveRPC", handler)	Принимает: тип обработчика; ссылку на функцию-обработчик​	Регистрирует новый обработчик на какое-либо событие​
local client = LuaRak:client("Test") local rakClient = client:getRakClient() print(rakClient:GetLastPing())	Возвращает: объект RakClient​	Получает объект RakClient, который использует обертка​
local client = LuaRak:client("Test") print(client:getNickname())	Возвращает: никнейм клиента​	Получает строку с ником клиента​
local client = LuaRak:client("Test") client:setSAMPVersion("SAMP2009.9-282")	Принимает: строку с версией SAMP​	Устанавливает версию SAMP, которую бот будет использовать при подключении на сервер​
local client = LuaRak:client("Test") print(client:getId())	Возвращает: ID клиента на сервере​	Получает ID, установленный сервером для клиента​

Спойлер: LuaProxy

Использование​	Параметры​	Описание​
local address = "123.43.98.50" local port = 1993 local user = "user123" local password = "qwerty123" local proxy = LuaRak:proxy(address, port, user, password, false) proxy:setReceiving(true)	Принимает: адрес прокси-сервера; порт прокси-сервера; пользователь (необязательно); пароль от прокси (необязательно) ; запуск передачи данных;​	Подключается к proxy-серверу и установка обмена данными​
local proxy = LuaRak:proxy(...) local originalProxy = proxy:getProxy() print(originalProxy:IsValidProxy())	Возвращает: ссылку на оригинальный прокси-класс​	Получает доступ к оригинальному прокси-классу, написанному на C++​

Спойлер: BitStream

Использование​	Параметры​	Описание​
local bs = LuaRak:BitStream()	​	Создает экземпляр класса BitStream​
bs:reset()	​	Сбрасывает указатель чтения и записи в начало битового потока​
bs:resetReadPointer()	​	Сбрасывает указатель чтения в начало битового потока​
bs:resetWritePointer()	​	Сбрасывает указатель записи в начало битового потока​
bs:setWriteOffset(offset)	offset: number	Устанавливает указатель записи на указанное смещение​
bs:getWriteOffset()	​	Возвращает текущее смещение указателя записи​
bs:setReadOffset(offset)	offset: number	Устанавливает указатель чтения на указанное смещение​
bs:getReadOffset()	​	Возвращает текущее смещение указателя чтения​
bs:getNumberOfBitsUsed()	​	Возвращает количество использованных битов​
bs:getNumberOfBytesUsed()	​	Возвращает количество использованных байтов​
bs:getNumberOfUnreadBits()	​	Возвращает количество непрочитанных битов​
bs:getNumberOfUnreadBytes()	​	Возвращает количество непрочитанных байтов​
bs:ignoreBits(bits)	bits: number	Пропускает указанное количество битов​
bs:ignoreBytes(bytes)	bytes: number	Пропускает указанное количество байтов​
bs:writeUInt8(value)	value: number	Записывает беззнаковое 8-битовое целое число​
bs:writeUInt16(value)	value: number	Записывает беззнаковое 16-битовое целое число​
bs:writeUInt32(value)	value: number	Записывает беззнаковое 32-битовое целое число​
bs:writeInt8(value)	value: number	Записывает знаковое 8-битовое целое число​
bs:writeInt16(value)	value: number	Записывает знаковое 16-битовое целое число​
bs:writeInt32(value)	value: number	Записывает знаковое 32-битовое целое число​
bs:writeFloat(value)	value: number	Записывает число с плавающей запятой​
bs:writeVector3D(vector)	vector: table	Записывает трехмерный вектор (table с тремя числами)​
bs:writeString(value)	value: string	Записывает строку​
bs:readUInt8()	​	Считывает беззнаковое 8-битовое целое число​
bs:readUInt16()	​	Считывает беззнаковое 16-битовое целое число​
bs:readUInt32()	​	Считывает беззнаковое 32-битовое целое число​
bs:readInt8()	​	Считывает знаковое 8-битовое целое число​
bs:readInt16()	​	Считывает знаковое 16-битовое целое число​
bs:readInt32()	​	Считывает знаковое 32-битовое целое число​
bs:readFloat()	​	Считывает число с плавающей запятой​
bs:readString(size)	​	Считывает строку указанного размера​
bs:getBitStream()	​	Возвращает оригинальный класс BitStream​
bs:getDataPtr()	​	Возвращает указатель на данные битового потока​

​

Спойлер: TODO

Доработка серверной обертки, на данный момент работает некорректно
Фикс багов в обертке и самом RakNet (максимальное приближении к тому, что использует SAMP)
Добавить поддержку UNIX систем
Постепенный порт сетевого движка на Lua. На данный момент необходима обертка, написанная на C++ (core.dll)

​

---

Благодарность:
@AdCKuY_DpO4uLa - модификация RakNet
@#Northn помощь в некоторых аспектах, касаемо sol2
@lainban поставщик прокси
А также всем lua-seniors за поддержку​

Спойлер: 🥰

 

[Nekit Walker]

Чувствую он получит все 600к

 

[whyega52]

Документацию надо будет подправить, но это уже не сегодня

 

[ernestik]

скрипт топ! эга топ! забрали кота моник и комп! скрипт топ!

 

[tfornik]

залутал кэш

 

[01EG]

Чувствую он получит все 600к

это 100% номинация проект с уникальной идеей
вопрос какое место

 

[whyega52]

Спасибо @ChromiusJ за небольшую интеграцию

 

[chromiusj]

Спасибо @ChromiusJ за небольшую интеграцию Посмотреть вложение 225389

ради коллеги готов на все

 

[whyega52]

ради коллеги готов на все
Посмотреть вложение 225391

Чат луа техлидов. Пропуск осуществляется строго по документам

 

[Sargon]

и в чем все же практическая польза и уникальность данной библиотеки, учитывая, что мы уже имеем moonbot?

Постепенный порт сетевого движка на Lua

смешно

 

[etereon]

и в чем все же практическая польза и уникальность данной библиотеки, учитывая, что мы уже имеем moonbot?

вдруг модеры придумают, для чего они нужны, пока будут выбирать между моей и его либой

 

[whyega52]

в чем все же практическая польза и уникальность данной библиотеки, учитывая, что мы уже имеем moonbot?

Прокси (знаю, что это делается не так и сложно, можно даже через либу хуков от ртд реализовать, но к чему это? ), независимость от Мун апи (можно реализовать заглушками, но опять пахнет говном), работа не только на клиенте, но и на сервере (пока что до конца не реализовано, надо сделать квери и допилить дешифрование трафикатрафика; опенсорс; Криптон, как мы видим, забил на либу.

смешно

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

 

[etereon]

В плане? Если я правильно понимаю, в луа(жите) есть всё для этого (псевдо асинхронность тоже благодаря либам, но с этим надо будет разобраться подробнее).

Это всё очень криво работает там(

 

[whyega52]

Это всё очень криво работает там(

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

 

[Sargon]

работа не только на клиенте, но и на сервере

и опять утыкаемся в вопрос о пользе. кто в здравом уме будет пользоваться возможностью запустить псевдосервер в данной либе?)