Введение в Pawn

Описание: Основы скриптинга
Модератор: SJplayer

Jerry
Автор темы, Рядовой
Рядовой
Аватара
Jerry
Автор темы, Рядовой
Рядовой
Сообщения: 6
Зарегистрирован: 12 мая 2013
С нами: 10 лет 10 месяцев

#1 Jerry » 13 мая 2013, 7:18

Введение.

Для начала надо знать:

1. Pawn - язык программирования. Приспособлен для создание модов и скриптов в SA-MP.
2. Чтобы использовать данный язык, нужна программа Pawno.

Неплохо знать английский язык, т.к. именно на нём записаны все функции и колбеки.


Оглавление:

Урок 1. Начало.
Урок 2. Паблики.
Урок 3. Функции.
Урок 4. Переменные.
Урок 5. Проверки.
Урок 6. Создание новых пабликов.
Урок 7. Таймер.
Урок 8. Циклы.
Урок 9. #define.
Урок 10. enum.
Дополнение 1. Работа с dcmd.
Дополнение 2. Работа с strtok.

Урок 1. Начало.

Если вы делаете мод, то сначала стоит записать данные строки:

Код: Выделить всё

#include <a_samp>//Включение в мод все функций и калбеков sa-mp.

main(){}

a_samp.inc - это файл, содержащий в себе все функции и паблики sa-mp.


Урок 2. Паблики.

Паблики (public), иногда их называют калбеки (callbacks).
Callback, переводится как "функция, вызываемая автоматически".
Это процедуы, которые определяют, что будет
выполняться при данном действии, будь то игрока написал что то в чате,
или запустился мод. Каждый калбек имеет определённое название и определённые параметры.
Пример паблика:

Код: Выделить всё

public OnPlayerDeath(playerid,killerid,reason)//Строка определяет, что это за паблик, его параметры.
{//Начало действия.
 
}//Конец действи  
я

Данный паблик паблик отвечает за то, что будет, когда игрок сдохнет.

Код: Выделить всё

playerid - ИД того, кто погиб
killerid 
- ИД того, кто убил игрока
reason 
- причина (в смысле, каким оружием)
 
public OnPlayerDeath
(playerid,killerid,reason) //Игрок умер.
{
    //здесь описывается то, что будет, если игрок умер
}


В конце каждого паблика должен стоять return.
Если паблик находится в моде, то вводим return 1;
Если паблик находится в скрипте, то вводим return 0;
Если установить return 1; в скрипте, то выйдет такая ситуация:
паблик в скрипте работать не будет!
Исключение: OnPlayerText.


Основные паблики.

OnGameModeInit() - события, когда загружается мод

OnGameModeExit() - события, когда выгружается мод

OnPlayerConnect(playerid) - события, когда игрок подключается к серверу

OnPlayerDisconnect(playerid,reason) - события, когда игроку отключается от сервера. reason - причина отключения.

OnPlayerDeath(playerid, killerid, reason) - события, когда игрок погибает. reason - причина гибели.

OnPlayerRequestClass(playerid, classid) - события, когда игрок выбирает скина. classid - какой скин выбран на данный
момент.

OnPlayerCommandText(playerid,cmdtext[]) - события, когда игрок ввёл команду. cmdtext - команда, используется в strcmp.

OnPlayerPickUpPickup(playerid, pickupid) - события, когда игрок поднял пикап. pickupid - ID пикапа

OnPlayerText(playerid,text[]) - события, когда игрок ввёл текст в чат.
Типы return-ов. Если return1; - текст игрока отображается в чате,
если return 0; - текст игрока не отображается в чате.

Код: Выделить всё

OnPlayerSpawn(playerid) - события, когда игрок отправился на спавн.
 
OnFilterScriptInit
() - события, когда скрипт загружается на сервер
 
OnFilterScriptExit
() - события, когда скрипт выгружается из памяти сервера


Практика.

Код: Выделить всё

public OnPlayerDeath(playerid,killerid,reason)//Игрок умер.
{
    //некий код
    return 1;//т.к. стоит в моде
}


Урок 3. Функции.

Функции - они и в Африке функции. Каждая функция, как и паблик,
имеет определённые параметры. Синтаксис нативной функции:

GivePlayerMoney(playerid,money);

Данная функция даёт игроку playerid деньги money.

Может быть функция с одним параметром, например:

GetPlayerMoney(playerid);

Данная функция определяет число денег у игрока playerid. Cама по себе бесполезна,
используется для других фукнций.

Основные функции.

Код: Выделить всё

SetPlayerHealth(playerid,health); - установить игроку playerid здоровье health
 
SetPlayerArmour
(playerid,armour); - установить игроку playerid уровень брони armour
 
GivePlayerMoney
(playerid,money); - дать игроку playerid деньги money
 
ResetPlayerMoney
(playerid); - все деньги игроку обнуляются
 
ResetPlayerWeapons
(playerid); - игрок лишается всего оружие
 
GivePlayerWeapon
(playerid,weaponid,var1); - игроку playerid даётся оружие weaponid с патронами var1


CreatePickup(model,type,Float:X,Float:Y,Float:Z); - создаёт пикап (разбросанное оружие) с ид model, с типом пикапа type
и с координатами X,Y,Z
Если пикап будет перерождаться, то ставим type 2. Если создаётся только один раз - type 3.

AddStaticPickup(model,type,Float:X,Float:Y,Float:Z); - создаётся пикап model с типом type и координатами X,Y,Z

CreateVehicle(modelid, Float:x, Float:y,Float:z, Float:angle, color1, color2, respawn_delay); - создаётся автомобиль modelid,
x,y,z - координаты, angle - угол поворота, color1, color2 - цвета, respawn_delay - время в секундах, через которое
автомобиль будет респавниться после того, как оно было покинуто водителем.

Код: Выделить всё

AddStaticVehicle(modelid, Float:spawn_x, Float:spawn_y,Float:spawn_z, Float:angle, color1, color2); - создаётся автомобиль
modelid
,
spawn_x, spawn_y, spawn_z - координаты, angle - угол поворота, color1, color2 - цвета авто. Используется только в
OnGameModeInit
().
 
SendClientMessage
(playerid, 0xDEEE20FF, "Hello."); - отправляет текст в чат игроку playerid с определённом цветом, и с
текстом
"Hello."
 
SendClientMessageToAll
(0xDEEE20FF, "Hello."); - аналогично, только тот же текст отправляется всем игрокам в общий чат.


И теперь практика!

Код: Выделить всё

public OnPlayerDeath(playerid,killerid,reason)//Игрок умер.
{
//Начало действия паблика
GivePlayerMoney(killerid,GetPlayerMoney(playerid));//Игроку killerid (тот кто убил) даются все деньги playerid (тот, кто умер).
//Конец действия
}


Урок 4. Переменные.

Строго говоря это адреса памяти, имеющие определённое значение.
Говоря проще, это некое слово, имеющие числовое значение

Существуют несколько видов переменных:
1. серверные переменные,
2. переменные игроков,
3. текстовые переменные.

1. Серверные переменные.

Так будем называть общие переменные.

new server_players=0;

Создана перменная server_players со значением 0.

Присвоение значения:

server_players=5;

Переменной server_players присвоено значение 5.

Функция прибавление к значению опред. числа:

server_players+=5;

Функция отнятия из значения опред. числа:

server_players-=5;

+1 к значению:

server_players++;

-1 к значению:

server_players--;

К переменной можно присвоить значение функции.

Код: Выделить всё

server_players=GetPlayerMoney(playerid);//переменной server_players присвоено значение денег игрока playerid  


Также к переменной можно присвоить ИД, например, транспорта.

Код: Выделить всё

new vehicle;//Создаётся переменная.
vehicle=CreateVehicle(522, 1683, 785,0, 0, 6, 9,-1);//Переменной 'vehicle' присвоено значение ИД транспорта.

Код: Выделить всё

DestroyVehicle(vehicle);//Транспорт уничтожается.  



Практика.

Код: Выделить всё

public OnPlayerDeath(playerid,killerid,reason)//Паблик
{//Начало выполнения
server_players++;//+ 1 к значению server_players
}//Конец выполнения  


2. Переменные игроков.

Переменная, которая приклепляется к каждому игроку на сервере.

Код: Выделить всё

new player[MAX_PLAYERS]=0;


Создана переменная player со значением 0.

На данном этапе каждый игрок имеет значение 0.

Код: Выделить всё

player[playerid]=5;


Переменной player одного игрока playerid присваивается значение 5.

Также с данной переменной совершаются все действия серверной переменной.

Практика.


Код: Выделить всё

new kills[MAX_PLAYERS]=0;//Создана переменная kills. Для всех игроков установлено значение 0.
new deaths[MAX_PLAYERS]=0;//Создана переменная deaths. Для всех игроков установлено значение 0  
.

Код: Выделить всё

public OnPlayerDeath(playerid,killerid,reason)//Паблик
{
kills[killerid]++;//+1 к значению kills у игрока killerid
deaths[playerid]++;//+1 к значению deaths у игрока playerid
}

3. Текстовые переменные.

Текстовые переменные - переменные, значением которых может быть только текст.

Код: Выделить всё

new string[256];//cоздана переменная string  


Такая переменная в основном используется для создания форматированного текста.

Код: Выделить всё

format(string,256," Ваши деньги: %d",GetPlayerMoney(playerid));


%d - некое числовое значение
%s - некое текстовое значение

Переменной string присвоено текстовое значение, указанное в кавычках.

Есть ещё переменная, используемая для имени:

Код: Выделить всё

new name[MAX_PLAYER_NAME];


Cоздана переменная name.

Практика.

Код: Выделить всё

GetPlayerName(playerid,name,256);//Получено имя игрока
format(string,256," Ваше имя: %s",name);//Форматирование текста
SendClientMessage(playerid,0xAAFF00,string);//Отправлено сообщение  



Урок 5. Проверки.

Проверка - функция, проверящая, выполняется ли данная функция. Если выполняется функция,
то и выполняется определённый код.

Код: Выделить всё

if(некая_функция)
{
// код, который должен выполняться, при выполнение некая_функция
}


В качестве проверки может использоваться:
1. сравнению переменных, либо значений функций,
2. выполняеться ли некая функция.

1. Сравнение переменных.

Код: Выделить всё

if(GetPlayerMoney(playerid) >= money)
{
выполнение_кода;
}


В данной проверка произведено сравнение:
ЕСЛИ деньги_игрока >= (больше или равно) money
ТО выполнение_кода

Есть разных виды сравнений:

!= - не равно
>= - больше или равно
<= - меньше или равно
> - больше
< - меньше
== - равно

Практика.

Код: Выделить всё

new kills[MAX_PLAYERS]=0;//Создана переменная kills. Для всех игроков установлено значение 0.
new string[256];
 
public OnPlayerDeath
(playerid,killerid,reason)//Паблик
{
kills[killerid]++;//+1 к значению kills у игрока killerid
if(kills[killerid] == 10)//Если значение kills игрока killerid равно 10
        {//Начало выполнения кода
              SendClientMessage(playerid,0x000FFF,"Вы убили уже 10 раз, вы получили бонус $10000.");//Сообщение
              GivePlayerMoney(playerid,10000);//Выдаются деньги
        }//Конец выполнения кода  

}

2. Выполнение определённой фукнции.

Проверяет, выполняеться ли данная функция.

Код: Выделить всё

if(IsPlayerConnected(playerid))
{
 
}


Выполняется проверка, подключён ли игрок к серверу.

Практика.

Код: Выделить всё

public OnPlayerCommandText(playerid,cmdtext[])//Паблик
{
    if(strcmp(cmdtext,"/testmessage",true)==0)//Проверка, выполнена ли данная комманда.
    {//Начало выполнения кода
            SendClientMessage(playerid,0xAFF00000,"Команда выполнена.");
            return 1;//Здесь тоже нужен return.
    }//Конец выполнения кода
    return 1;
}


Конечно, есть функия, использующаяся при невыполнениии проверки.

Называется else. Используется так.

Код: Выделить всё

public OnPlayerCommandText(playerid,cmdtext[])
{
    if(strcmp(cmdtext,"/testmessage",true)==0)
    {
            if(IsPlayerAdmin(playerid))//Являеться ли игрок ркон-админом.
            {
            SendClientMessage(playerid,0xAFF00000,"Команда выполнена.");//Если да, то выполняеться данная функция.
            }
            else SendClientMessage(playerid,0xAFF00000,"Вы не являетесь ркон админом.");//Если нет, то выполняется другая функция..
            return 1;
    }
    return 1;
}


Урок 6. Создание новых пабликов.

Новый паблик создаётся так:

Код: Выделить всё

forward SetPlayerMoney(playerid,money);


Создаётся он для того, чтобы вызвать некоторые функции одновременно.

Например, функция установки денег.

Код: Выделить всё

forward SetPlayerMoney(playerid,money);//Создан паблик
 
public SetPlayerMoney
(playerid,money)
{
    ResetPlayerMoney(playerid);//Все деньги у игрока отбираются.
    GivePlayerMoney(playerid,money);//Игрок получат деньги.
}
 

Урок 7. Таймер.

Таймер - функция, вызвающая определённый паблик в определённое время.
Функция может вызваться единожды, либо повторяться через
заданные промежутки времени.

Для того, чтобы повесить таймер на определённый паблик,
создаётся такая фукнция.

Код: Выделить всё

SetTimer("NewPublic",1000,1);


В 1 секунде - 1000 миллисекунд.

1000 - заданный промежуток времени в миллисекундах, после которого паблик запускается заново.
1 - тип таймер. Если установлено 1, то таймер перезапускается бесконечное кол-во раз. Если 0, то таймер вызывает
паблик только первый раз.

Примечание: не стоит ставить значение таймера < 100, это может вызвать нагрузку на процессор.


Пример использования:

Код: Выделить всё

public OnGameModeInit()
{
    SetTimer("AllMessage",120000,1);//Cоздан таймер, поставленный на паблик NewPublic.
    //Таймер запускается каждые 2 минуты
}
 
forward AllMessage
();
 
public AllMessage
()
{
  SendClientMessageToAll(0xAFDAFD00," >> Серверу требуются модераторы.");
    //Cообщение. Отправляется всем игрокам каждые 2 минуты.  


Урок 8. Циклы.

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

Код цикла:

Код: Выделить всё

for(new i=0;i<50;i++)//Цикл
{//Начало действия цикла
 
    GivePlayerMoney
(i,1000);//Даются деньги
    GameTextForPlayer(i,"~r~bonus!",1000,1);//Сообщение
    //Перебираюся все значения i, выходит,  что функция выполняется для всех игроков с ID < 50
 
//Конец действия цикла
}

Примечание: не стоит ставить ограничение цикла на MAX_PLAYERS (500). Это вызывает большую
нагрузку на процессор.

Пример использования цикла.


Код: Выделить всё

public OnGameModeInit()
{
    SetTimer("TTimer",120000,1);//Создаётся таймер.
}
 
forward TTimer
();//Создаётся паблик.
 
public TTimer
()
{
    for(new i=0;i<50;i++)//Цикл, просматриваются все значения i до 50.
    {
        SendClientMessage(i,0xAFAFAF," >> Серверу требуются модераторы.");//Всем игрокам с ID < 50 отправляется сообщение.
    }
}

Урок 9. #define.

Данная функция используется довольно редко. Позволяет на одно слово "поставить" другое.

Код: Выделить всё

#define COLOR_ZEL 0x00FF00AA  


Слово COLOR_ZEL теперь понимается компилятором как определённый код цвета.
Урок 10. enum

enum - это вещь, позволяющая создавать большее количество адресов одной переменной.

Пример:

Код: Выделить всё

enum PVar
{
    PHealth,
    PArmour
}

Здесь у адреса PVar создаются подразделы PHealth, PArmour.

Код: Выделить всё

new PlayerVar[MAX_PLAYERS][PVar];


Теперь игрок может на одну переменную игрока ставить несколько адресов.
Под PVar подразумевается PHealth, либо PArmour.

Разумеется, enum можно юзать и в общей (серверной) переменной.

Код: Выделить всё

enum SVar//Создан адрес SVar с подразделами Players и AllPlayers
{
    Players,
    AllPlayers
}
 
new PlayerServer
[SVar];


Пример использования.

Код: Выделить всё

enum Var1//Создан адрес Var1 с подразделами PBank, PKills и PDeaths.
{
    PBank,
    PKills,
    PDeaths
}
 
new PlayerVar
[MAX_PLAYERS][Var1];//Создана переменная с данными адресами
 
public OnPlayerDeath
(playerid,killerid,reason)
{
    PlayerVar[playerid][PDeaths]+=1;//К адресу PDeaths переменной игрока ставиться +1
    PlayerVar[killerid][PKills]+=1;//К адресу PKills переменной игрока ставиться +1
}


Дополнение 1. Работа с dcmd.


dcmd - командный процессор, с помощью которого можно более просто (обходя strtok) создавать команды с переменными.

Вообще сама функция dcmd создаётся при помощи define. Код:

Код: Выделить всё

#define dcmd(%1,%2,%3) if (!strcmp((%3)[1], #%1, true, (%2)) && ((((%3)[(%2) + 1] == '\0') && (dcmd_%1(playerid, ""))) || (((%3)[(%2) + 1] == ' ') && (dcmd_%1(playerid, (%3)[(%2) + 2]))))) return 1  


Перед созданием самой команды надо обозначить её в OnPlayerCommandText(playerid,cmdtext[])

Код: Выделить всё

public OnPlayerCommandText(playerid,cmdtext[])
{
    dcmd(healplayer,10,cmdtext);
    return 1;
}


healplayer - название команды, 10 - кол-во символов в команде.

Сама команда создаётся так:

Код: Выделить всё

dcmd_healplayer(playerid,params[])//Создана команда healplayer
{
    new player1;//создана переменная
    player1 = strval(params[0]);//к player1 присваивается числовое значение params[0]
    if(IsPlayerConnected(player1))//Проверка, подключён ли игрок к серверу
    {
        if(IsPlayerAdmin(playerid))//Проверка, является ли игрок, вводивший команду, rcon-админом
            {
                SetPlayerHealth(player1,100);//ХП того игрока становиться 100
            }
    }
}


Дополнение 2. Работа с strtok.


strtok - функция, аналогичная dcmd. Позволяет создать команды с переменными.

Сама функция strtok .

Код: Выделить всё

strtok(const string[], &index)
{
    new length = strlen(string);
    while ((index < length) && (string[index] <= ' '))
    {
        index++;
    }
 
    new offset 
= index;
    new result[20];
    while ((index < length) && (string[index] > ' ') && ((index - offset) < (sizeof(result) - 1)))
    {
        result[index - offset] = string[index];
        index++;
    }
    result[index - offset] = EOS;
    return result;
}

Переходим к паблику OnPlayerCommandText. Сначала пишем там код:

Код: Выделить всё

new cmd[256],idx;
cmd = strtok(cmdtext,idx);


Создаём саму команду:

Код: Выделить всё

if(strcmp(cmd,"/healplayer",true)==0)//Проверка на введёную команду
{
    new tmp[256];//Создаём 1 переменную tmp[256]. Обязательна для strtok
    new splayer;//Создаём общую переменную  


//Далее код переменной в команде. splayer можно заменить любой другой подходящей переменной

Код: Выделить всё

    tmp = strtok(cmdtext,idx);
    if(!strlen(tmp))
    {
        SendClientMessage(playerid,0xFFFFF00,"Юзайте: /healplayer [playerid]");
    }
    splayer = strval(tmp);
 
    if
(IsPlayerConnected(splayer))//На сервере ли игрок?
    {
        if(IsPlayerAdmin(playerid))//Являетесь ли вы rcon-админом?
        {
            SetPlayerHealth(splayer,100);//Игроку даётся 100 хп.
        }
        else SendClientMessage(playerid,0xFFFFF00,"Вы не являетесь RCON-админом!");//Иначе мисага
    }
    else SendClientMessage(playerid,0xFFFFF00,"Игрок не находится на сервере.");//Иначе мисага
    return 1;
}

Всё, команда создана.


Вернуться в «Основы скриптинга»

Кто сейчас на форуме (по активности за 5 минут)

Сейчас этот раздел просматривают: 2 гостя