Добро пожаловать на BlackSAMP - ФОРУМ

[DarkPhantom]

sampfuncs api - это набор инструментов и библиотек позволяющий делать скрипты для GTA San Andreas Multiplayer (SAMP) на языке программирования C++.

Давайте я расскажу , что надо для работы .
1. Visual Studio
2. DirectX SDK
3. Sampfuncs
После того , как вы все скачали вам надо распаковать архив . После откройте проект в Visual Studio.
У вас появится ошибка . Для её устранения вам надо подключить DirectX.
Для этого перейдите в свойства и установите версию SDK для вашей винды. Набор инструментов платформы ставим последний.
Затем переходим в каталоги VC++ и в пункте "Включаемые каталоги " указываем путь до папки include в DirectX sdk . Дальше мы видим пункт подключаемые библиотеки и указываем путь до папки lib опять же в DirectX sdk.

Затем открываем main.cpp .
И нас встречает готовый проект , который в чат выводит "Sampfuncs plugin loaded" .

Давайте напишем простой скрипт , состоящий из команды и вывода текста в чат .
Для регистрации команды , в функции mainloop , во 2 условии где идёт проверка на инициализацию игры и САМПа вставляем эту строку .

SF->getSAMP()->rergisterChatCommand("cmd",func);

Что тут происходит ?
Мы обращаемся к сампфунксу , к функции getSAMP и функции registerChatCommand.
Первым параметром идёт команда (без слеша ) , вторым функция , которая будет вызываться каждый раз при вводе команды в чат .
Есть 3 способа , как объявить функцию .
1. Лямбда функция
2. Объявить в заголовочном файле .
3. Зарегистрировать функцию в начале, а обращаться в конце .
1

SF->getSAMP()->rergisterChatCommand("cmd",[](std::string){
     SF->getSAMP()->getChat->AddChatMessage(-1,"Hi");

});

2. В файле main.h

void __stdcall func(std::string);

И в main.cpp после функции mainloop

void __stdcall func(std::string)
{
     SF->getSAMP()->getChat->AddChatMessage(-1,"Hi");
}

3. Так же , как и во 2.
Давайте скомпилируем проект и убедимся ,что все работает (сборка->собрать решение)

Тему буду дополнять . В планах создать полноценный гайд по imgui , диалогам и ракнету

 

[DarkPhantom]

Аргументы для команды + нажатые клавиши .​

Передать аргументы в команду очень легко . Для этого после std::string напишите название переменной , в моем случае param.
Код :

SF->getSAMP()->rergisterChatCommand("cmd",[](std::string){
     SF->getSAMP()->getChat->AddChatMessage(-1,"Hi %s",param.c_str());
});

Функция c_str нужна для перевода в тип char .
Для реализации нажатия на клавиши , пишем else для if(!initialized).
Пример :

if(!initialized)
{
    //Тут код
}
else
{

}

В этом условии напишем отслеживание нажатых клавиш .
Всего есть два вида нажатия :
1. Обычное нажатие .
2. Нажатие с удержанием .
Давайте рассмотрим обычное нажатие.

if(SF->getGame()->isKeyPressed(191))
{
   SF->getSAMP()->getChat()->AddChatMessage("Вы нажали клавишу",-1);
}

В функции isKeyPressed надо указать id клавиши .

Спойлер: Их айдишники

2. Тип нажатия - удержание .
Вот код :

if(SF->getGame()->isKeyDown(191))
{

   SF->getSAMP()->getChat()->AddChatMessage("Вы нажали и удерживаете клавишу",-1);
}

 

[DarkPhantom]

Как работать с диалогами ?​

Всего есть 4 вида часто используемых диалогов:
1. DIALOG_STYLE_LIST

2. DIALOG_STYLE_MSGBOX

3. DIALOG_STYLE_INPUT

4. DIALOG_STYLE_PASSWORD

Ещё есть DIALOG_STYLE_HEADER:

Но он используется крайне редко .

Давайте приступим к созданию диалога .
Для этого объявим указатель в начале кода :

stDialogInfo* DIALOG = nullptr;

За

dialog = SF->getSAMP->getDialog();
dialog->registerDialogCallback(OnDialogRes);
SF->getSAMP()->registerChatCommand("cmd",[](std::string){
   dialog->ShowDialog(4,DIALOG_STYLE_LIST,"название","пункт 1\nПункт 2","+","-");
});

Для обработки событий используем функцию OnDialogRes:

void __stdcall OnDialogRes(int dialogId, int buttonId ,int listItem , const char* input)
{
    
}

Тут все как в pawn .

if(dialogId==4 & buttonId==1)
{
    switch(listItem)
    {
       case 0:
       {
           SF->getSAMP()->getChat()->AddChatMessage("Вы выбрали пункт 1");
       }
       case 2:
       {
           SF->getSAMP()->getChat()->AddChatMessage("Вы выбрали пункт 2");
       }
    }
}

Спойлер: :foxКак реализовать показ диалога при нажатии на столбец из пункта:fox

На данный момент нельзя реализовать обычный показ диалога в этом обработчике и нужно идти на хитрости :

bool __showDialog = false;

if(dialogId==4 & buttonId==1)



{



    switch(listItem)



    {



       case 0:



       {



           SF->getSAMP()->getChat()->AddChatMessage("Вы выбрали пункт 1");



       }



       case 2:



       {



             __showDialog=true;



       }



    }



}

В основной функции

if(__showDialog)
{
   __showDialog=false;
   dialog->ShowDialog(6,DIALOG_STYLE_MSGBOX,"Заголовок","Содержание","кнопка  1" , "кнопка 2");
}

Дальше обрабатываем в нашем методе ,как и с обычным диалогом.