Как написать свой мод для сервера самп

Кратко о том что мы будем делать.
Данные уроки будут посвящены написанию игрового мода sa-mp с new.pwn. Мод будет жанра RPG, написан на файловой системе с использованием инклуда mxINI.

Краткий план разработки на ближайшее время:

Основа Мода.
— Система Регистрации
— Загрузка сохранения аккаунта.
— Система Домов
— Система Бизнесов
— Система Транспорта
— Система Банка.

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

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

Действие Первое. Нужные файлы, и настройка сервера:

Качаем последнюю версию сервера sa-mp с офф. сайта. ссылка
Распаковываем сервер в любую удобную для вас папку.
Открываем server.cfg, и меняем rcon_password changename, на свой пароль, из строки filterscripts, убираем все FS которые включены. Меняем gamemode, на new.
Качаем последнюю версию инклуда mxINI. ссылка
Открываем папку pawno, в папке с вашим сервером, папку include, и ложем инклуд mxINI, в эту папку.
Заходи в папку gamemodes, и удаляем все моды которые там есть ( для удобства ).
Заходим в папку pawno, и открываем программу pawno.exe.
Слева, в углу, нажимаем на кнопку new.
Пред вами то, что в ближайшее время, будет нашим модом.
Нажимаем F5, и нам предлагают выбрать папку, и имя будущего мода. Выбираем папку gamemodes, в папке с вашим сервером, и имя файла задаём new .
Пробуем запустить мод, зайдя в папку с сервером, и запустим файл samp-server.exe .
Если сервер запустился, мы всё сделали правильно, настройка сервера закончена.

Действие второе. Удаление лишнего из мода:

Открываем наш мод. Первое что бросается нам в глаза, это

#if defined FILTERSCRIPT

public OnFilterScriptInit()
{
	print("n--------------------------------------");
	print(" Blank Filterscript by your name here");
	print("--------------------------------------n");
	return 1;
}

public OnFilterScriptExit()
{
	return 1;
}

#else

main()
{
	print("n----------------------------------");
	print(" Blank Gamemode by your name here");
	print("----------------------------------n");
}

#endif

Вот это нам не нужно. Удаляем.
Находим паблик

public OnGameModeInit()
{
	SetGameModeText("Blank Script");
	AddPlayerClass(0, 1958.3783, 1343.1572, 15.3746, 269.1425, 0, 0, 0, 0, 0, 0);
	return 1;
}

И после него, вставляем

main()
{
	print("n----------------------------------");
	print(" Название вашего мода, у меня будет pawn-wiki");
	print("----------------------------------n");
}

В самом начале мода, мы можем видеть такую строку.

#include <a_samp>

Если подумать головой, то можно понять что это подгрузка инклудов в мод. После него добавим наш инклуд:

#include <mxINI>

Нажимаем F5, и компилируем мод, если всё прошло без ошибок, значит вы всё сделали правильно.

Находим строку

SetGameModeText("Blank Script");

Эта строка, устанавливает название мода, которое будет видно в клиенте. Меняем его на своё.

SetGameModeText("Pawn-wiki Mode");

Компилируем мод, и.. мы закончили с подготовкой мода. Теперь нас ждёт система регистрации.

Действие Третье. Сохранение аккаунта.

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

enum pInfo
{
	pPass[64],// Масив с паролем
}
new Player[MAX_PLAYERS][pInfo];

Теперь мы можем записать пароль, определённого игрока, чем мы сейчас и займёмся.

Опускаемся в самый конец мода, и создаём там, вот это:

stock SavePlayer(playerid)
{
    new string[64];// Масив с путём для файла
	new playername[MAX_PLAYER_NAME];// Масив для получения имени игрока
	GetPlayerName(playerid, playername, sizeof(playername));// Получаем Имя игрока
	format(string, sizeof(string), "players/%s.ini", playername);// Добавляем имя игрока, в путь для сохранения
	iniFile = ini_openFile(string);// Открываем файл по тому пути который указали.
	ini_setString(iniFile, "Pass", Player[playerid][pPass]);// Записываем пароль игрока в файл
	ini_closeFile(iniFile);// Закрываем файл
}

Нажимаем F5, и мод компилируется. Если ошибок нет, то вы сделали всё правильно.
Теперь нам надо зайти в папку с сервером, открыть папку scriptfiles, и в ней добавить папку players.
Сохранение готово.

Действие Четвёртое. Создание регистрации и загрузки игрока.

Для создания регистрации, надо узнать, есть ли игрок с таким именем на сервере, для начала нужно после объявления нашего инклуда, вставить следующее:

new PAccount[MAX_PLAYERS];// Есть аккаунт, или нет

Далее ищем паблик OnPlayerConnect. И в него добавляем:

new playername[MAX_PLAYER_NAME];// Масив для имени игрока
new string[128];// Путь до папки с именем игрока
GetPlayerName(playerid,playername,sizeof(playername));// Узнаём имя игрока
format(string,sizeof(string),"players/%s.ini", playername);// Путь к файлу с аккаунтом
if(fexist(string))// Проверка на файл, если он есть то выполняется следующее действие.
{
	PAccount[playerid] = 1;// Аккаунт есть
}
else// Если файла с именем нет, то выполняется это действие.
{
	PAccount[playerid] = 0;// Аккаунта нет
}

Теперь ищем паблик, OnPlayerRequestClass, он покажет нам диалог с логином, или регистрацией, в него добавляем.

if(PAccount[playerid] == 1)// Если аккаунт есть
{
	ShowPlayerDialog(playerid,1,DIALOG_STYLE_INPUT,"Окно Входа","ЗдравствуйтеnВаш аккаунт есть на сервереnВведите свой пароль в окошко","Ввод","");// Показываем диалог входа в игру. Стиль диалога выставляем на ввод текста.
}
else// Если аккаунта нет
{
	ShowPlayerDialog(playerid,2,DIALOG_STYLE_INPUT,"Окно Регистрации","ЗдравствуйтеnВаш аккаунт не найден.nЗарегистрируйтесь введя пароль в окошко","Ввод","");// Показываем диалог регистрации. Стиль диалога выставляем на ввод текста.
}

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

forward OnPlayerRegister(playerid, password[]);
public OnPlayerRegister(playerid, password[])// Паблик регистрации
{
	if(IsPlayerConnected(playerid))
	{
	    new string[64];// Масив с путём для файла
		new playername[MAX_PLAYER_NAME];// Масив для получения имени игрока
		GetPlayerName(playerid, playername, sizeof(playername));// Получаем Имя игрока
		format(string,sizeof(string), "players/%s.ini", playername);// Добавляем имя игрока, в путь для сохранения
		new iniFile = ini_createFile(string);// Создаём файл с именем игрока в папке players
		if(iniFile < 0)// Если Файла нет
		{
			iniFile = ini_openFile(string);// Открываем
		}
		if(iniFile >= 0)// Если файл есть
		{
			strmid(Player[playerid][pPass],password,0,strlen(password),255);// Присваиваем масиву pPass, значение password[]
			ini_setString(iniFile,"Pass",Player[playerid][pPass]);// Записываем пароль игрока в файл
			ini_closeFile(iniFile);// Закрываем файл
			ShowPlayerDialog(playerid,1,DIALOG_STYLE_INPUT,"Окно Входа","ЗдравствуйтеnВаш аккаунт есть на сервереnВведите свой пароль в окошко","Ввод","");// Показываем диалог входа в игру.
		}
	}
	return 1;
}

Функция которая зарегистрирует игрока, готова, теперь функция логина. В конец мода, добавляем.

forward OnPlayerLogin(playerid,password[]);
public OnPlayerLogin(playerid,password[])
{
	if(IsPlayerConnected(playerid))// Проверка на подключение игрока
	{
     	new string[64];// Масив с путём для файла
     	new pass[64];// Масив с паролем
		new playername[MAX_PLAYER_NAME];// Масив для получения имени игрока
		GetPlayerName(playerid, playername, sizeof(playername));// Получаем Имя игрока
		format(string,sizeof(string), "players/%s.ini", playername);// Добавляем имя игрока, в путь для загрузки
		new iniFile = ini_openFile(string);// Открываем файл
  		ini_getString(iniFile,"Pass",pass,64);// Загружаем пароль
    	if(strcmp(pass,password,true) == 0)// Если введёный пароль, соответсвует паролю при регистрации, то загружаем акк
	    {
     		ini_getString(iniFile,"Pass",Player[playerid][pPass],64);// Загружаем пароль
     		ini_closeFile(iniFile);// Закрываем файл
    	}
		else// Если пароль не верен..
		{
		    ini_closeFile(iniFile);// Закрываем файл
	    	ShowPlayerDialog(playerid,1,DIALOG_STYLE_INPUT,"Окно Входа","ЗдравствуйтеnВаш аккаунт есть на сервереnВведите свой пароль в окошко","Ввод","");// Показываем диалог входа в игру.
	    	return 1;
		}
		SendClientMessage(playerid,0xFF00000,"Добро пожаловать на наш сервер");// Выводим игрок сообщение
		SpawnPlayer(playerid);// Спавним игрока
	}
	return 1;
}

Функция регистрации есть, логина есть, осталось заставить их работать, для этого находим паблик OnDialogResponse и вставляем в него:

if(dialogid == 1)// Ид диалога Для Логина
{
	if(response)// Если игрок нажал первую кнопку входа
	{
		if(!strlen(inputtext))// Если окно ввода пустое, выводим диалог снова
		{
			ShowPlayerDialog(playerid,1,DIALOG_STYLE_INPUT,"Окно Входа","ЗдравствуйтеnВаш аккаунт есть на сервереnВведите свой пароль в окошко","Ввод","");// Показываем диалог входа в игру.
			return 1;
		}
		new pass[64];// Масив с паролем
		strmid(pass,inputtext,0,strlen(inputtext),64);// Считываем текст с диалога
		OnPlayerLogin(playerid,pass);// Запускаем паблик входа
	}
	else// Если игрок нажал Esc, вернём ему диалог
	{
		ShowPlayerDialog(playerid,1,DIALOG_STYLE_INPUT,"Окно Входа","ЗдравствуйтеnВаш аккаунт есть на сервереnВведите свой пароль в окошко","Ввод","");// Показываем диалог входа в игру.
	}
}
if(dialogid == 2)// Ид диалога для регистрации
{
	if(response)// Если игрок нажал первую кнопку 
	{
		if(!strlen(inputtext))// Если окно ввода пустое, выводим диалог снова
		{
			ShowPlayerDialog(playerid,2,DIALOG_STYLE_INPUT,"Окно Регистрации","ЗдравствуйтеnВаш аккаунт не найден.nЗарегистрируйтесь введя пароль в окошко","Ввод","");// Показываем диалог регистрации.
			return 1;
		}
		new pass[64];// Масив с паролем
		strmid(pass,inputtext,0,strlen(inputtext),64);// Считываем текст с диалога
		OnPlayerRegister(playerid,pass);// Запускаем паблик регистрации
	}
	else// Если игрок нажал Esc, вернём ему диалог
	{
		ShowPlayerDialog(playerid,2,DIALOG_STYLE_INPUT,"Окно Регистрации","ЗдравствуйтеnВаш аккаунт не найден.nЗарегистрируйтесь введя пароль в окошко","Ввод","");// Показываем диалог регистрации.
	}
}

Конец первой части.
Полезные ссылки:
— Include mxINI
—
new.rar
[1,84К]

Приношу свои извинения за ошибки в тексте.
Понравился урок? Пользуйся на здоровье.
Следующий урок, в ближайшие дни.
Автор урока: Vovan228

Глава I. Файлы, программы нужные нам

Для начала нам понадобится сам сервер. ( http://files.sa-mp.com/samp03z_svr_R1_win32.zip )
Распаковываем все содержимое архива в удобную нам папку.
Далее открываем файл server.cfg (блокнотом) и меняем нужные нам данные на свои, а именно:

Поменяли? Но это ещё не все, приписываем ко всему строку:

— Это плагины, объясню позже
У нас получиться что-то вроде этого:

И так, если вы хотите чтобы ваш мод работал правильно, то вам следующие плагины:

Стример
1. Streamer.inc, который лежит в папке pawno/include закидываем к себе в папку pawno/include вашего сервера.
2. Streamer.dll, который лежит в папке plugins закидываем в папку plugins вашего сервера. Примечание: Если сервер находиться на оси Linux, то закидываем Streamer.so, в server.cfg все плагины должны быть написаны с расширением .so.
Например: Streamer.so
Ну все. Нам нужны только эти два файла.
MySQL R39-2 — Мы будем использовать плагин R39-2
1. a_mysql.inc закидываем к себе в папку pawno/include вашего сервера.
2. mysql.dll закидываем в папку plugins вашего сервера.
3. libmysql.dll обязательно кидаем в папку с сервером
Денвер — И самое главное, это Denwer (Denwer обеспечит нам Базу Данных MySQL PhpMyAdmin).
Устанавливаем Denwer. Думаю, вопросы по его установке не возникнут.

Глава II. Начинаем работу

И так, установили Denwer, закинули плагины? Тогда поехали.

Для начала заходим в папку своего сервера, видим там другую папку «pawno«, заходим в неё. Далее заходим в саму программу pawno.exe Давайте начнем писать наш мод. Нажмем на самую первую иконку «New«. Мы создали новый мод, если мы сохраним его под названием «new» в папку «gamemodes» запустим сервер и зайдем на него ( для захода используйте IP: 127.0.0.1 ), то увидим всем знакомого негра CJ в районе Лас Вентураса, как мы видим это ещё не совсем Role Play мод, так давайте его уже наконец начнем делать! Идем в pawno и начинаем работу. Для начала давайте впишем наши инклуды таким образом:
После строки:

Вставляем:

Для начала давайте удалим ненужные нам строки:

Далее заменим:

На:

Кстати немного о main().
Как вы видите функция print при запуске мода покажет нам текст в консоле который мы с вами ввели. Вы можете добавить ещё полей и написать в них что угодно. Так-же функция print служит для поиска багов в моде. Например у вас не работает функция, постепенно вставляйте print в код
Пример: (при проверке рекомендую использовать print)

Немного истории…
При написании мода используются различные символы и переменные, разберем их.

Но вернемся к моду И так, удаляем строку:

Удалили? Отлично, перейдем к разборке самого мода.

Давайте для начала пропишем данные к базе MySQL, для этого отступаем одну строку после инклудов и пишем следующее:

Далее давайте отступим ещё одну строчку и вставим следующую строку:

Также отступаем одну строку и вставляем:

Далее идем чуть ниже,в public OnGameModeInit() и вставляем туда следующее:

В итоге у нас получится такой паблик (public):

Далее таким же образом вставляем следующее в public OnGameModeExit():

В public OnPlayerConnect(playerid):

В public OnPlayerText(playerid, text[]):

В public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[]):

В самый конец кода:

Этим этапом мы с вами сделали регистрацию, и авторизацию на сервере. Спасибо Jeff_Hardy за данные коды по регистрации и авторизации.
Но это ещё не все, давайте запустим наш Denwer, далее в адресной строке наберем следующую ссылку: http://localhost/Tools/phpMyAdmin/
Создадим нашу Базу Данных samp и зайдем в неё, зайдя в неё мы с вами увидим сверху вкладочку «SQL» или «Структура», жмем на неё.
В появившемся поле мы вставим следующий код:

Все готово! Теперь мы можем скомпилировать мод (F5) и запустить его.
Автор: Pro-Pawn Team
Исходники: Мод

// This is a comment
// uncomment the line below if you want to write a filterscript
//#define FILTERSCRIPT

#include <a_samp>

#if defined FILTERSCRIPT

public OnFilterScriptInit()
{
print(«n—————————————«);
print(» Blank Filterscript by your name here»);
print(«—————————————n»);
return 1;
}

public OnFilterScriptExit()
{
return 1;
}

#else

main()
{
print(«n———————————-«);
print(» Blank Gamemode by your name here»);
print(«———————————-n»);
}

#endif

public OnGameModeInit()
{
// Don’t use these lines if it’s a filterscript
SetGameModeText(«Blank Script»);
AddPlayerClass(0, 1958.3783, 1343.1572, 15.3746, 269.1425, 0, 0, 0, 0, 0, 0);
return 1;
}

public OnGameModeExit()
{
return 1;
}

public OnPlayerRequestClass(playerid, classid)
{
SetPlayerPos(playerid, 1958.3783, 1343.1572, 15.3746);
SetPlayerCameraPos(playerid, 1958.3783, 1343.1572, 15.3746);
SetPlayerCameraLookAt(playerid, 1958.3783, 1343.1572, 15.3746);
return 1;
}

public OnPlayerConnect(playerid)
{
return 1;
}

public OnPlayerDisconnect(playerid, reason)
{
return 1;
}

public OnPlayerSpawn(playerid)
{
return 1;
}

public OnPlayerDeath(playerid, killerid, reason)
{
return 1;
}

public OnVehicleSpawn(vehicleid)
{
return 1;
}

public OnVehicleDeath(vehicleid, killerid)
{
return 1;
}

public OnPlayerText(playerid, text[])
{
return 1;
}

public OnPlayerCommandText(playerid, cmdtext[])
{
if (strcmp(«/mycommand», cmdtext, true, 10) == 0)
{
// Do something here
return 1;
}
return 0;
}

public OnPlayerEnterVehicle(playerid, vehicleid, ispassenger)
{
return 1;
}

public OnPlayerExitVehicle(playerid, vehicleid)
{
return 1;
}

public OnPlayerStateChange(playerid, newstate, oldstate)
{
return 1;
}

public OnPlayerEnterCheckpoint(playerid)
{
return 1;
}

public OnPlayerLeaveCheckpoint(playerid)
{
return 1;
}

public OnPlayerEnterRaceCheckpoint(playerid)
{
return 1;
}

public OnPlayerLeaveRaceCheckpoint(playerid)
{
return 1;
}

public OnRconCommand(cmd[])
{
return 1;
}

public OnPlayerRequestSpawn(playerid)
{
return 1;
}

public OnObjectMoved(objectid)
{
return 1;
}

public OnPlayerObjectMoved(playerid, objectid)
{
return 1;
}

public OnPlayerPickUpPickup(playerid, pickupid)
{
return 1;
}

public OnVehicleMod(playerid, vehicleid, componentid)
{
return 1;
}

public OnVehiclePaintjob(playerid, vehicleid, paintjobid)
{
return 1;
}

public OnVehicleRespray(playerid, vehicleid, color1, color2)
{
return 1;
}

public OnPlayerSelectedMenuRow(playerid, row)
{
return 1;
}

public OnPlayerExitedMenu(playerid)
{
return 1;
}

public OnPlayerInteriorChange(playerid, newinteriorid, oldinteriorid)
{
return 1;
}

public OnPlayerKeyStateChange(playerid, newkeys, oldkeys)
{
return 1;
}

public OnRconLoginAttempt(ip[], password[], success)
{
return 1;
}

public OnPlayerUpdate(playerid)
{
return 1;
}

public OnPlayerStreamIn(playerid, forplayerid)
{
return 1;
}

public OnPlayerStreamOut(playerid, forplayerid)
{
return 1;
}

public OnVehicleStreamIn(vehicleid, forplayerid)
{
return 1;
}

public OnVehicleStreamOut(vehicleid, forplayerid)
{
return 1;
}

public OnDialogResponse(playerid, dialogid, response, listitem, inputtext[])
{
return 1;
}

public OnPlayerClickPlayer(playerid, clickedplayerid, source)
{
return 1;
}

О остальных девяти кнопках, я расскажу позже.

2) Всё, скрипт мы создали, начинаем чистить его.

Удаляем:

// This is a comment
// uncomment the line below if you want to write a filterscript
//#define FILTERSCRIPT

#if defined FILTERSCRIPT

public OnFilterScriptInit()
{
	print("n--------------------------------------");
	print(" Blank Filterscript by your name here");
	print("--------------------------------------n");
	return 1;
}

public OnFilterScriptExit()
{
	return 1;
}

#else

Переходим в паблик OnPlayerRequestClass и удаляем:

SetPlayerPos(playerid, 1958.3783, 1343.1572, 15.3746);
SetPlayerCameraPos(playerid, 1958.3783, 1343.1572, 15.3746);
SetPlayerCameraLookAt(playerid, 1958.3783, 1343.1572, 15.3746);

Переходим в паблик OnPlayerCommandText и удаляем:

if (strcmp(«/mycommand», cmdtext, true, 10) == 0)
{
// Do something here
return 1;
}

В будущем, с этим пабликом мы работать не будем, т.к. командный процессор будет DC_CMD.

Прописываем необходимые функции, и настраиваем мод.​

Всё, мод мы подчистили, теперь пора настроить сердечко нашего мода.

1) Переходим в паблик OnGameModeInit и добавляем:

DisableInteriorEnterExits();

А, собственно, где тут отличие от предыдущих версий? Правильно, их нет.
Даже разработчик сампика это подтверждает:

Я просто тебе выскажу мнение, как человек, который в pawn ушел не намного дальше среднестатистического хелловордера:
Это муть. Стоит рассматривать что-то более существенное, чем разбор интуитивно понятного файла человеку, который хоть чуть чуть владеет логикой и англ.языком.
Давай что то посущественнее и более объёмно, чтоль. Ябпочитал.

В данном уроке мы сделаем шаблон для нашего первого плагина.

Первое что нам понадобится, это Visual Studio с установленными c++ дополнениями, а так же SDK

Установив все самое нужное, можно приступать к созданию проекта

1. Открываем Visual Studio

2. Справа жмем создание проекта

3. Выбираем Библиотека Динамической компоновки ( DLL )

4. Указываем любое название проекта

5. Создав проект, выбираем в самом верху Release, x86 ( SA:MP 32 битный ) 

6. Открываем нашу папку с проектом и разархивируем SDK.zip

7. Включаем отображение всех файлов

8. У нас должна появиться папка SDK, жмем по ней правой кнопкой мыши и включаем в проект

9. Отключаем отображение файлов

10. Создаем plugin.def (для экспорта определения модулей)

Жмем правой кнопкой мыши по нашему проекту -> добавить -> создать элемент

11. Выбираем Visual C++ -> Код -> Файл определения модуля ( .def )

11. Жмем правой кнопкой мыши по проекту -> свойства -> компоновщик -> ввод -> пишем «plugin.def»

12. Открываем dllmain.cpp и вставляем следующий код:

#include "SDK/amx/amx.h"
#include "SDK/plugincommon.h"

extern void *pAMXFunctions;
void *(*logprintf)(const char *fmt, ...);

PLUGIN_EXPORT unsigned int PLUGIN_CALL Supports()
{
	return SUPPORTS_VERSION | SUPPORTS_AMX_NATIVES;
}

PLUGIN_EXPORT bool PLUGIN_CALL Load(void **ppData)
{
	pAMXFunctions = ppData[PLUGIN_DATA_AMX_EXPORTS];
	logprintf = (void *(*)(const char *fmt, ...))ppData[PLUGIN_DATA_LOGPRINTF];
	
	if (NULL == pAMXFunctions || NULL == logprintf)
		return false;

	logprintf("  clear plugin loaded..");
	return true;
}

PLUGIN_EXPORT void PLUGIN_CALL Unload()
{
	logprintf("  clear plugin unloaded..");
}

13 Жмем правой кнопкой мыши по проекту -> собрать

Если сделали все правильно, в выводе должно быть написано следующее:

Копируем из папки Release к себе в папку plugins, прописываем в server.cfg и проверяем

Снизу предоставлен полный собранный проект.

Гайд об pawn и описание всех функций находится тут

SDK.zip

clearPlugin.zip

Любому игростроевцу, который захочет сделать мод для San Andreas, придется продираться через густые скриптовые заросли. Ведь с помощью скриптов можно изменить практически любую игровую составляющую. Хотите добавить в SA безбашенную мини-игру? Не вопрос. Желаете сделать собственный ролик на игровом движке или новую миссию? Тоже не проблема. Главное, научиться разбираться в принципах скриптописания.

Теорию и общие вопросы мы регулярно разбираем в “Самопале” (смотрите цикл статей “Игровое программирование”), на страницах же “Мастерской” займемся целенаправленным изучением скриптового языка конкретно GTA: SA.

Сегодня мы разберемся с основами языка программирования игры и научимся создавать несложные модификации. Самая популярная и распространенная программа для скриптинга под San Andreas — SAMB. Возможности этого редактора безграничны. Впрочем, нет, есть одно серьезное ограничение — ваша фантазия. Но тут мы вам, увы, не помощники. Зато разобраться в редакторе поможем легко. Забирайте SAMB с нашего диска и внемлите.

Важное отступление. При написании скриптов очень большое значение имеет количество пробелов, которое стоит между теми или иными элементами скрина. В статье для удобства восприятия везде стоит по одному пробелу, но если вы хотите, чтобы мод работал, число пробелов должно быть “правильным”. Для этого отправляйтесь на наш диск, где выложены исходные скрипты.

Первый запуск

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

Большую часть редактора занимает текстовое окно (пока оно серое), где мы и будем создавать что-то новое или редактировать уже существующее. Над этим окном располагается очень удобная панель инструментов. Откройте файл main.scm, располагающийся в подпапке игры: Data/Script — для этого в панели инструментов щелкните на значок папки со стрелочкой или зайдите в пункт меню File/Open. Перед вами появится подобие проводника Windows.

В правом окне вы должны указать путь к файлу main.scm. Например: C:GamesGtaSandatascript. После этого напротив поля File type выберите SCM-файлы. В результате в левом окне появится файл main.scm.

Щелкните по нему один раз и нажмите OK. Перед вами появится еще одно меню, в котором необходимо указать путь хранения файла (можно выбрать любой путь). Когда вы определитесь с местом хранения scm-файла, смело нажмите кнопку OK еще раз. Подождите несколько минут, пока программа переведет машинный код в читабельный язык программирования игры.

Синтаксис редактора

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

Все миссии в GTA: SA представляют собой массу связанных между собой команд. Любая строка с необходимой командой, в свою очередь, состоит из трех частей, например 0417: start_mission $test.

Не горим и в воде не тонем!

Разберем эту строчку более подробно:

0417: — это код команды;

start_mission — сама команда, игнорируется редактором;

$test — переменная или число (числа).

Еще один пример: 03D8: show save screen. (03D8: — код команды; show save screen — команда).

Совсем не обязательно запоминать коды всех команд. В редактор встроена подсказка. Например, если вы напишите ключевое слово boat (лодка) и нажмете клавишу F1, программа автоматически подберет нужную команду:

02D3: boat $A88 drive to 171.0578 942.3843 6.0

Нажав клавишу F1 еще несколько раз, редактор будет подбирать коды команд с интересующим вас словом до тех пор, пока не закончатся все варианты. На слово boat будет выведено следующее:

02D3: boat $A88 drive to 171.0578 942.3843 6.0

02D3: boat $A88 drive to 171.0578 942.3843 6.0

Чтобы посмотреть ключевые слова, как, например, в случае с лодкой, откройте документ Keywords, поставляющийся вместе с редактором.

Создание модификаций

Мы плавно подошли к самому ответственному моменту: созданию собственных модификаций. Для начала разберемся, из чего состоит файл любой миссий в San Andreas.

Файл main.scm состоит из четырех частей.

1 часть. Ставит размер памяти для скриптов — нужно только для редактора.

2 часть. Список используемых объектов в игре и скриптах.

3 часть. Указатели на миссии и внутриигровые блоки.

4 часть. Собственно код миссий, мини-игр, путей самолетов/вертолетов.

Пока нас не будут интересовать первые два блока — они не нужны, если вы не собираетесь создавать мегасложную миссию или совершенно новую игру.

Чтобы создать новую модификацию, нужно знать, как и с чего начать и чем закончить проект. Щелкните по “биноклю” в панели инструментов, в меню поиска введите 004F: create_thread ЈЈ и нажмите кнопку Find. Вы увидите список неизвестных пока вам команд. Давайте разберем на примере, как пишется мод.

004F: create_thread ЈЈIgromod1

004F: — это, как мы говорили чуть выше, код команды.

create_thread ЈЈ — это сама команда, отвечающая за создание потока, программы, ответственной за выполнение какого-либо действия, изменять команду нельзя!

Igromod1 — название нашего мода в файле main.scm.

Cj — настоящий медик. Хирург или патологоанатом…

Найдите то место, где заканчивается последняя команда, начинающаяся c 004F, и ниже вставьте свою строчку: 004F: create_thread ЈЈIgromod1;.

Обратите внимание, что символ ЈЈ необходимо копировать только из других команд: то, что вы напишете сами, программа не примет и выдаст ошибку при компиляции!

Далее в меню поиска (для быстрого вызова нажмите клавишу CTRL+F) введите слово orig и снова нажмите кнопку Find. Над строчкой:

;————-Mission 0—————

вы будете размещать все свои модификации, мини-игры, но не миссии — насчет этого будет отдельный разговор.

Любой блок, подпрограмма или мод начинается со строки Igromod1. Она играет роль идентификатора названия, которое вы писали выше. Название Igromod1 должно соответствовать названию Igromod1 в строке 004F: create_thread ЈЈIgromod1;.

Если названия не совпадут, то при компиляции — переводе языка программирования в машинный код игры — редактор снова выдаст ошибку, что блок не найден.

Ниже нужно написать строку с задержкой на определенное время, чтобы игра не зависла: 0001: wait 0 ms.

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

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

0330: set player $PLAYER_CHAR infinite run to 1 (true)

Или сделать его (игрока, конечно) пожароустойчивым:

055D: make player $PLAYER_CHAR fireproof 1

А ведь можно и перекрашиваться совершенно бесплатно:

0335: set free paynspray to 1 (true)

Дадим игроку побольше денег — с ними в SA всегда были проблемы:

0109: player $PLAYER_CHAR money += 9000000

Вам мало брони и жизней — увеличим их стартовый набор на 100 единиц, мало не покажется:

035F: set_actor $PLAYER_ACTOR armour_to 100

055E: set_player $PLAYER_CHAR max_health += 100

Зачем ждать, пока нам в игре любезно предоставят реактивный ранец, создадим его около нашего дома (gRoove Famile Streets) сами!

032B: $jet = create_weapon_pickup 370 15 ammo 1 at 2488.562 -1666.864 12.8757

То, что вы должны увидеть при успешной декомпиляции скрипта.

Загадочные цифры 2488.562 -1666.864 12.8757 представляют собой координаты, по которым будет создан jetpack. О координатах и других непонятных цифрах в этой команде речь пойдет во второй статье цикла.

Думаю, быстрая перезарядка ствола придется всем по вкусу:

0331: unknown_player $PLAYER_CHAR set_fast_reload 1

Самое время научиться менять привычную одежку игрока. Изменить одежду главного героя на любую другую не так сложно. Для смены одежды игрока используются вместе две нижеуказанные команды:

087B: set_player $PLAYER_CHAR clothes «VEST» «VEST» 17

070D: $PLAYER_CHAR

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

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

0629: change_stat 181 (islands unlocked) to 4

И напоследок повысим скиллы персонажа до максимума:

062A: change_stat 165 (energy) to 999.0 ; float

062A: change_stat 230 (cycling skill) to 999.0 ; float

Завершение проекта

Знаний для создания первого несложного мода вам уже хватит. Но чтобы модификация заработала, нужно еще написать команду, которая завершит работу после создания всех бонусных вещей. Выглядит она так: 004E: end thread.

Вид на наше творение из игры.

Если вы решили создать мод, содержащий все модификации, описанные в статье, то в итоге у вас должно получиться следующее:

:Igromod1

004E: end thread

Последние штрихи — нажмите клавишу F7, редактор скомпилирует файл в формат, привычный для игры. Скопируйте его из папки, в которой хранится main.scm (путь для хранения файла main.txt и будущего main.scm вы указывали во второй менюшке, появляющейся при открытии файла main.scm из директории Data/Script установленной игры) в папку Data/Script игры. После чего запускайте San Andreas — и можете играть в модификацию.

* * *

Мы изучили основы скриптового языка GTA: SA. Научились работать с редактором SAMB. Даже с этим базовым уровнем знаний вы уже можете экспериментировать, используя данные текстового файла Keywords.

Мы прощаемся с вами до следующей статьи (будет опубликована в одном из ближайших выпусков “Мастерской”), в которой наши модостроительные интересы значительно расширятся — мы научимся манипулировать персонажами и транспортными средствами, создавать свои видеоролики, познакомимся с понятием цикличности и освоим еще множество интереснейших возможностей.