Как скомпилировать плагин для SourceMod. SP в SMX [CS, TF2, L2D, др.]

Приветствую! Некоторые плагины для SourceMod, которые вы можете найти, например, на всем известном форуме alliedmods.net, доступны только в формате .sp, то есть исходного кода. Конечно же, такие плагины не заработают на вашем сервере – их нужно скомпилировать в .smx. В этом небольшом руководстве я покажу, как это сделать. Материал рассчитан на самых обычных «админов серваков», которые не хотят влезать в дебри кодинга под SourceMod. Приятного прочтения!

1. Подготовка

Зависимости

Итак, для начала нужно достать все зависимости, которые требует плагин. Обычно они прилагаются на странице проекта или в README.md (в зависимости, откуда вы скачали). Об этом позже.

Пример зависимостей плагина taunt 'em

Компилятор

Компилятор поставляется вместе с SourceMod и располагается в папке /addons/sourcemod/scripting. Это файл compile.sh (Linux-версия) или compile.exe (Windows). Поэтому вы можете компилировать плагины прямо на игровом сервере, если у вас есть ssh-доступ.

Для простой компиляции можно просто скачать SourceMod в качестве архива с официального сайта. Файлы сервера игры не понадобятся, ошибок не будет.

2. Компиляция

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

Перекидываем файл .sp в папку /addons/sourcemod/scripting/. Обратите внимание, что некоторые плагины могут иметь дополнительные файлы, такие как конфиги gamedata, .dll или .so. Их тоже нужно переместить в те папки, которые описаны в прилагающейся инструкции.

Итак, чтобы скомпилировать, открываем консоль (командную строку) в директории /addons/sourcemod/scripting/ и прописываем следующее:

Для windows:

compile.exe [filename].sp

Для linux:

./compile.sh [filename].sp

Компилятор – это консольная утилита. Вот пример успешной компиляции стандартного плагина nextmap.sp на Линуксе:

Линукс

Ваш .smx будет ждать вас в папке compiled, которая находится здесь же. Вот он:

Линукс

Теперь можно использовать этот плагин, перекинув его в /addons/sourcemod/plugins. Не забудьте установить зависимости и на игровой сервер, если вы компилировали у себя на компьютере. Это все, спасибо за прочтение.

Полезные ссылки:

• Официальный гайд (англ.)
• Онлайн-компилятор (англ.)