San Andreas Multiplayer (SAMP) — многопользовательская модификация для игры Grand Theft Auto: San Andreas. Она позволяет игрокам подключаться к серверу и играть вместе. Для создания скриптов в SAMP используется язык программирования Pawn. В этой статье мы рассмотрим его особенности и примеры использования.

Основные возможности языка Pawn

Pawn — высокоуровневый язык программирования, который поддерживает структурное, объектно-ориентированное и процедурное программирование. Он обладает следующими возможностями:
— Поддержка типов данных: целые числа, вещественные числа, строки, массивы, структуры, классы, перечисления.
— Операции над типами данных: арифметические операции, сравнение, логические операции, преобразование типов.
— Управление потоком выполнения программы: условные операторы, циклы, рекурсия.
— Работа со строками: конкатенация строк, поиск подстроки, форматирование строк.
— Работа с файлами: чтение, запись, удаление файлов.
— Работа с сетевыми соединениями: отправка и приём сообщений через TCP/IP.
— Работа с памятью: управление выделением и освобождением памяти.
— Встроенная поддержка ООП: классы, объекты, методы, свойства.
— Многопоточность: создание и управление потоками выполнения.

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

Использование директивы «include»

Директива «include» позволяет включить код из другого файла в текущий файл скрипта. Это удобно, когда нужно разделить большой скрипт на несколько частей. Проще говоря, сделать модульный мод. Удобно ведь, когда все не в одном файле?

// main.pwn
include "vehicles.pwn"; // Включаем файл с функциями для работы с автомобилями

void main() {
    CreateVehicle(GetPlayerPed(-1), 4, 0.0, 0.0, 0.0, true, false);
}

// vehicles.pwn
CreateVehicle(ped, model, x, y, z, noCamera, noRope) {
    // Код для создания автомобиля
}

Создание автомобиля

Функция «CreateVehicle» используется для создания автомобиля в игре. Она принимает следующие параметры:
— «ped»: идентификатор игрока, которому принадлежит автомобиль.
— «model»: номер модели автомобиля.
— «x», «y», «z»: координаты центра автомобиля в мире.
— «noCamera»: если «true», то игрок не будет видеть автомобиль изнутри.
— «noRope»: если «true», то автомобиль нельзя будет зацепить крюком.

CreateVehicle(GetPlayerPed(-1), 4, 0.0, 0.0, 0.0, true, false);

Этот код создаёт автомобиль модели 4 рядом с игроком и не позволяет ему сесть внутрь или зацепить автомобиль крюком.

Назначение скина

Для назначения скина игроку используется функция «SetPlayerSkin». Эта функция принимает индекс скина и индекс мода одежды.

SetPlayerSkin(GetPlayerId(), skinIndex, clothingSetIndex);

Назначение организации

Для назначения организации игроку используется функция «SetPlayerOrganization». Эта функция принимает идентификатор организации и уровень игрока в ней.

SetPlayerOrganization(GetPlayerId(), organizationId, level);