Предисловие

Когда появилась идея написать свой сервер, это было страшно. Нет какой-то понятной статьи, не всегда понятно, что гуглить. Эта статья написана специально для таких новичков чтобы хоть немного осветить эту тему и дать вектор развития в этой области.

Глава 1: Дистрибутив

Работать будем с версией 0.3.7, так как она самая последняя и стабильная. Переходим на sa-mp.com, ищем с левой стороны раздел Navigation, под ним кнопку Downloads. После перехода нас будут интересовать два нижних раздела. "SA-MP Windows Server Download" и "SA-MP Linux Server Download"..

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

В архиве находится ряд файлов и папок. Пройдёмся по основным:

• filterscripts - подключаемые скрипты. вы можете выносить отдельные участки кода в отдельные файлы. если они автономны и не участвуют в основном моде, их можно вынести сюда

• gamemodes - игровые режимы сервера. Здесь будет находиться главный файл нашего мода

• include - подключаемые из кода мода файлы.

• pawno - папка, имеющая в себе редактор IDE pawno и собственную папку includes. Настоятельно рекомендую использовать её. Отсюда легче подключать файлы

• scriptfiles - хранилище. здесь расположены конфигурационные файлы скрптов.

• samp-server.exe (Windows) - исполняемый файл, запускающий сервер

• server.cfg - конфигурационный файл сервера

Глава 2: Конфигурация сервера и первый запуск

server.cfg как было сказано ранее - файл конфигурации сервера. Здесь подключаются моды, фильтерскрипты, плагины; устанавливаются название сервера, порт, язык, вебсайт и многое другое.

Значение всех его полей описано в файле server-readme.txt. Вот его перевод:

После того, как конфигурация будет завершена, запустите samp-server.exe для запуска серверного процесса

• hostname (String) - указывает имя хоста, отображаемое в браузере серверов.

• port (int) - указывает порт для прослушивания. Этот порт используется для игровых соединений, соединений rcon и для запросов.

• maxplayers (int) - указывает максимальное количество игроков на сервере

• announce (int 1/0) - добавляет ваш сервер в список серверов «Интернет» в браузере SA:MP. Вкл. (1) или Выкл. (0).

• weburl (String) - указывает URL-адрес, отображаемый в обозревателе серверов, который связан с сервером.

• gamemode0 - gamemode15 (String + int) - задает параметры ротации. Первый параметр задает имя игрового режима. Во-вторых, количество повторений. Вы можете использовать gamemode0 для указания первого игрового режима, gamemode1 для указания второго и т. д.

И вот, о чём в readme не написали:

• rcon_password (String) - пароль админа сервера. ввод этого пароля при подключении в игру даёт игроку статус админа.

• filtersripts (String[]) - через пробел описанные названия скриптов из папки filterscripts, которые будут запущены при запуске сервера

• plugins (String[]) - список включенных плагинов (обязательно указывать форматы .so или .dll в зависимости от ОС сервера)

• lanmode (int 0/1) - определяет возможность подключения к серверу только из локальной сети (1) или извне (0)

• language (String) - устанавливает язык сервера (влияет только на отображение в браузере серверов)

После завершения конфигурации, запускаем файл samp-server.exe, смотрим в красивую консоль и..

Глава 2.1: Первое подключение

Я буду считать, что читатели этой статьи знакомы с SAMP и его интерфейсом. В поле IP прямого подключения или добавления сервера в Favorites вводим такой адрес:

[Local IP]:[Port]

И можем подключаться! (по умолчанию там уже стоит игровой мод grandlarc)

Глава 3: Pawn.. Pawno?

Pawn это простой Си-подобный язык программирования. Даже на википедии в спектре использований этого языка SAMP стоит на первом месте. В интернете информация по чистому языку и использованию в программировании игровых режимов. О хороших IDE и редакторах кода можете забыть. Для VS Code ещё можно накатить плагины поддержки Pawn, но он не так удобен как стандартный редактор кода, который лежит в дистрибутиве сервера в папке pawno. В подробности языка и его особенности углубляться не будем. Поверхностное представление того, с чем мы имеем дело можно сложить по статье на википедии.

Открываем Pawncc.exe, млева сверху ищем пустой белый лист, нажимаем на него и перед нашим взором предстаёт "чистый" лист шаблона мода..

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

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

вы можете создавать внешние .inc файлы и подключать их через #include. файлы создавайте в папке pawno/include. да, кажется, что это просто дистрибутив редактора кода, но здесь лежат даже главные файлы кода сервера. так как отсюда их можно подключать, указав в include тмя файла. если вы будете подключать свои файлы из папки include в корне сервера, вам будет необходимо указать относительный путь до этой папки из дирректории pawn/include (.. /.. /include/file.inc)

Глава 3.1: Компиляция, подключение, запуск

После того, как режим был прописан и готов к встраиванию на сервер, сохраняем его в папку mods и жмём на зелёную стрелку. Если компиляция прошла успешно, необходимо указать название файла мода в server.cfg и цифру 1 в поле gamemode0 пример

gamemode0 mymode 1

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

Эпилог

Тут наверное стоит рассказать про коммьюнити. Все сервера предпочитают сохранять свой исходный код в тайне, не делятся скомпилированными результатами. Форумы уже заглохли, часто это просто зеркало другого форума, и если возникнет проблема, то решение может искаться очень долго. Активных чатов и бесед нет, документация не весьма удобная. Даже если нашли какой-то отличный плагин, даже довольно крупный и в обиходе на серверах.. Скорее всего будет трудно найти информацию о нём кроме оригинального сообщения на форуме. Но чёрт! это очень интересная и затягивающая тема, в которой мне понравилось разбираться. Если вам будет интересно узнать подробнее о создании сервера (Сторонние плагины, инклады, маппинг) проявите фидбек под этим постом. В этом посте я попытался только дать вектор развития и хоть как-то осветить эту тему комплексно. Спасибо за то, что прочитали этот туториал!

Ссылки и полезности

Ниже приведены ссылки на форумы и разделы документации, которые будут полезны во время работы над сервером.

• Официальная документация по скриптингу

• Список всех функций

• SAMP раздел на форуме Pawn Wiki

• Русская документация (неполная)

• Pawn.CMD - Удобный командный процессор (о нём позже)