Безопасная инициализация и работа с SAMP [3]

12.09.2021, 20:42

kin4stat

Флудер

Регистрация: 06.11.2017

Сообщений: 2,759

С нами: 4483143

Репутация: 183

В этом гайде будет рассказано как инициализироваться без потоков, а также как работать с SAMP'ом

При использовании на других ресурсах необходимо указание авторства и ссылки на оригинальную темы!

Все действия производились на Visual Studio 2019 с параметром

Код:

/std:c++17

, в других версиях интерфейс может отличаться.

И так, начнем:

Создаем новый проект, настраиваем его.

В свойствах проекта, в вкладке общие, стандарт языка C++ ставим /std:c++17

Добавляем sampapi в наш проект:

Первый способ:

В верхнем меню жмем Git -> Создать репозиторий Git(Create git repository)
В открывшемся окне выбираем либо github репозиторий, либо локальный репозиторий и жмем Создать.
Снова жмем Git -> Открыть в командной строке (Open in command line).

В консоли пишем

Код:

git submodule add https://github.com/BlastHackNet/SAMP-API.git

Ждем завершения операции и далее жмем Файл(File) -> Добавить(Add) -> Существующий проект (Existing projeect). Открываем папку с нашим проектом, заходим в папку SAMP-API и выбираем sampapi.vcxproj.
Открываем настройки проекта, выбираем C/C++ -> Общие -> Дополнительные каталоги включаемых файлов(Additional directories of included files). Жмем изменить

В открывшемся окне жмем на иконку файла со звездочкой, и жмем на появившуюся кнопку
Код:
```
...
```
Переходим в директорию
Код:
```
path_to_project\SAMP-API\include
```
и жмем выбор папки.
Переходим в настройки проекта
Код:

sampapi

Набор инструментов платформы(Build tools) - выбираем свое(у меня это v142

Версия пакета SDK для Windows - выбираем свое(у меня это 10.0)
Заходим в настройки нашего основного проекта, Компоновщик(Linker) -> Дополнительные каталоги библиотек(Additional library directories)

Повторяем те же самые операции что в шаге 6, но выбираем папку
Код:
```
path_to_project\SAMP-API\build\bin
```
Далее переходим в вкладку Ввод(Input) и в поле Дополнительные зависимости(Additional dependecies) в начало вписываем
Код:
```
Release\sampapi.lib;
```
для Release конфигурации проект, и
Код:
```
Debug\sampapi.lib;
```
. Точка с запятой ОБЯЗАТЕЛЬНА
Жмем правой кнопкой по проекту sampapi, Только проект -> Собрать только sampapi(делаем это для Release и Debug конфигураций)

Второй способ:

Скачиваем репозиторий, распаковываем по пути

Код:

path_to_project

Повторяем шаги 5-10 из первого способа.

Готово, мы подключили sampapi

Теперь добавим библиотеку для хуков в наш проект:

Начну свое описание с подключения моей библиотеки для хуков - kthook

Скачиваем kthook из репозитория и распаковываем в себе в папку с кодом(Пкм по проекту -> открыть папку в проводнике).

Папку tests перекидывать к себе не нужно.
Скачиваем ktsignal из репозитория и распаковываем содержимое
Код:
```
ktsignal-master
```
в папку
Код:
```
kthook\ktsignal
```
Жмем показать все файлы

Цитата:

Сообщение от Спойлер

ПКМ по папке kthook -> Включить в проект
Т.к. мы не используем CMake, тогда мы должны вручную переназначить все зависимости для kthook
Добавляем папку kthook в Дополнительные каталоги включаемых файлов(Additional directories of included files) (как в шаге 6 у sampapi)

В kthook.hpp изменяем

Код:

#include "ktsignal/ktsignal.hpp"

на

Код:

#include "ktsignal/include/ktsignal/ktsignal.hpp"

Также ради собственного удобства добавляем
Код:
```
kthook/include
```
Дополнительные каталоги включаемых файлов(Additional directories of included files)

Вместо kthook могу посоветовать вам SRHook либо MinHook

SRHook подключается также как и kthook, MinHook можно подключить также двумя способами, как и sampapi.

Но я рекомендую установить его через vcpkg.

Код:

vcpkg install minhook

И теперь перейдем к написанию кода:

SAMP инициализирует свои структуры в вызове

Код:

CHud::DrawRadar

, поэтому мы перехватим эту функцию, и после ее вызова будем уверены что самп инициализировался.

Для инициализации плагина лично я обычно использую хук на

Код:

CTimer::Update

Цитата:

Сообщение от Спойлер

C++:

Код:

using
CTimer__Update
=
void
(
__cdecl
*
)
(
)
;
void
*
func_addr
=
reinterpret_cast

(
0x561B10
)
;

Создаем хук:

C++:

Код:

#include "kthook/kthook.hpp"
using
CHud__DrawRadar
=
void
(
__cdecl
*
)
(
)
;
// Прототип CHud::DrawRadar
kthook
::
kthook_simple_t

samp_init_hook
{
reinterpret_cast

(
0x58A330
)
}
;
// хук на CHud::DrawRadar

Создаем функцию-коллбэк для хука:

C++:

Код:

#include "sampapi/CChat.h"
void
HOOK_after_samp_init
(
)
{
static
bool
inited
=
false
;
// переменная инициализации
namespace
samp
=
sampapi
::
v037r3
;
// Ваша версия сампа, у меня это 037r3
if
(
!
inited
&&
samp
::
RefChat
(
)
!=
nullptr
)
{
// если еще не инициализировались, и чат сампа уже инициализировался
samp
::
RefChat
(
)
->
AddMessage
(
0xFFFFFFFF
,
"Этот текст выведен после инициализации сампа"
)
;
// Выводим сообщение
samp
::
RefChat
(
)
->
m_debugColor
=
0xFFFF0000
;
// Меняем цвет системных сообщений сампа на красный
inited
=
true
;
// отмечаем что иницализировались
}
}

Код:

samp::RefChat()

аналогичен

Код:

SF->getSAMP()->getChat()

Подключаем нашу функцию к хуку:

C++:

Код:

BOOL APIENTRY
DllMain
(
HMODULE hModule
,
DWORD ul_reason_for_call
,
LPVOID lpReserved
)
{
switch
(
ul_reason_for_call
)
{
case
DLL_PROCESS_ATTACH
:
DisableThreadLibraryCalls
(
hModule
)
;
samp_init_hook
.
after
.
connect
(
HOOK_after_samp_init
)
;
// Подключаем нашу функцию-коллбэк после вызова CHud::DrawRadar
break
;
case
DLL_PROCESS_DETACH
:
break
;
}
return
TRUE
;
}

Цитата:

Сообщение от Спойлер

C++:

Код:

#include 
#include "sampapi/CChat.h"
#include "kthook/kthook.hpp"
using
CHud__DrawRadar
=
void
(
__cdecl
*
)
(
)
;
// Прототип CHud::DrawRadar
kthook
::
kthook_simple_t

samp_init_hook
{
reinterpret_cast

(
0x58A330
)
}
;
// хук на CHud::DrawRadar
void
HOOK_after_samp_init
(
)
{
static
bool
inited
=
false
;
// переменная инициализации
namespace
samp
=
sampapi
::
v037r3
;
// Ваша версия сампа, у меня это 037r3
if
(
!
inited
&&
samp
::
RefChat
(
)
!=
nullptr
)
{
// если еще не инициализировались, и чат сампа уже инициализировался
samp
::
RefChat
(
)
->
AddMessage
(
0xFFFFFFFF
,
"Этот текст выведен после инициализации сампа"
)
;
// Выводим сообщение
samp
::
RefChat
(
)
->
m_debugColor
=
0xFFFF0000
;
// Меняем цвет системных сообщений сампа на красный
inited
=
true
;
// отмечаем что иницализировались
}
}
BOOL APIENTRY
DllMain
(
HMODULE hModule
,
DWORD ul_reason_for_call
,
LPVOID lpReserved
)
{
switch
(
ul_reason_for_call
)
{
case
DLL_PROCESS_ATTACH
:
DisableThreadLibraryCalls
(
hModule
)
;
samp_init_hook
.
after
.
connect
(
HOOK_after_samp_init
)
;
// Подключаем нашу функцию-коллбэк после вызова CHud::DrawRadar
break
;
case
DLL_PROCESS_DETACH
:
break
;
}
return
TRUE
;
}

Компилируем, запускаем и видим:

Цитата:

Сообщение от Спойлер

𝕏 Twitter Reddit Telegram Копировать ссылку