SA-MP · дополнительные скрипты

Как установить filterscript на сервер SA-MP с open.mp

Добавьте filterscript на сервер SA-MP без замены основного режима: загрузка AMX, настройка pawn.side_scripts и проверка после перезапуска.

Filterscript добавляет отдельную функцию поверх основного игрового режима: например, гонку или инструмент администратора. На сервере open.mp дополнительные скрипты перечисляют в pawn.side_scripts файла config.json. Поле «Режим игры» в панели предназначено для основного режима; имя filterscript туда вписывать не нужно.

Объёмная синяя игровая композиция — сервер для совместной игры.

Подключение дополнительного скрипта

  1. Подготовьте скрипт и сохраните конфигурацию

    Прочитайте требования автора: какие плагины нужны, какие файлы данных должны существовать и поддерживается ли open.mp. Нужен скомпилированный файл .amx; исходник .pwn сам по себе сервер не выполняет. Создайте бэкап и скачайте текущий config.json, затем выключите сервер штатной кнопкой.

  2. Файлы

    Загрузите AMX в правильную папку

    Для примера race.amx положите файл в filterscripts/race.amx относительно корня сервера. Соблюдайте регистр: Race.amx и race.amx на Linux — разные имена. Файлы данных из комплекта разместите согласно инструкции автора, сохраняя структуру папок, а не рядом с AMX наугад.

  3. Дополните существующий объект pawn

    В config.json найдите side_scripts внутри pawn и добавьте строку "filterscripts/race" в массив. Если других скриптов нет, получится "side_scripts": ["filterscripts/race"]. Не создавайте второй объект pawn и не стирайте main_scripts или legacy_plugins. Сохраните корректный JSON: без комментариев и лишней запятой после последнего элемента.

  4. Консоль

    Запустите и проверьте действие

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

Ручная правка config.json читается при следующем запуске open.mp. Это отличается от изменения полей формы панели, которые шаблон применяет при переустановке. Ради подключения filterscript переустанавливать сервер не требуется; переустановка может заменить поставочные файлы, поэтому храните свою конфигурацию отдельно.

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

Читайте дальше

SA-MP · подключение

Как зайти на свой сервер SA-MP: адрес и прямое подключение

Как подключиться к своему серверу SA-MP: где взять адрес с портом в панели, что вписать в клиент SA-MP или open.mp и почему сервера может не быть в общем списке.

SA-MP · устройство

SA-MP или open.mp: что мы поднимаем и что это значит для игрока

Сервер SA-MP на voln.io работает на open.mp — продолжении проекта от сообщества: оригинал заморожен с 2023 года, клиенты SA-MP 0.3.7 заходят на open.mp без переделки.

SA-MP · режим

Режим игры на сервере SA-MP: три готовых варианта в поставке

В поставке сервера SA-MP уже лежат три готовых режима — gungame, derby, simpletdm. Как выбрать один из них полем «Режим игры» и что произойдёт при смене.

SA-MP · режим

Свой режим на сервере SA-MP: как поставить вместо готового

Как загрузить свой gamemode на сервер SA-MP: скомпилированный файл в каталог gamemodes через файловый менеджер и его имя без расширения в поле «Режим игры».

SA-MP · сеть

Один порт сервера SA-MP: игра и веб-сервер моделей на одном номере

У сервера SA-MP один порт вместо двух: игровой протокол UDP и веб-сервер моделей artwork по TCP используют один и тот же номер — так устроено умолчание самой игры.

SA-MP · управление

RCON на сервере SA-MP: пароль и почему он выключен по умолчанию

RCON на сервере SA-MP включается только когда задан пароль в панели — пустое поле означает выключенный RCON, а не забытую настройку.

SA-MP · доступ

Пароль на сервер SA-MP: как закрыть вход для посторонних

Пароль на сервер SA-MP задаётся полем «Пароль входа на сервер» в панели. Пустое поле — сервер без пароля, публичный для всех, кто нашёл адрес.

SA-MP · видимость

Почему сервер SA-MP не виден в общем списке

Показ сервера SA-MP в общем списке включается полем «Объявлять сервер в общем списке». Выключено — подключение прямым адресом всё равно работает.

SA-MP · слоты

Максимум игроков на сервере SA-MP: до какого числа можно поднять

Поле «Максимум игроков» на сервере SA-MP принимает значения от 1 до 1000 — верхний предел задаёт сама игра, а не тариф хостинга.

SA-MP · настройки

Почему настройки сервера SA-MP применяются только через переустановку

Настройки сервера SA-MP хранятся в config.json — панель переписывает его лишь при переустановке, обычный перезапуск изменений не применит.

SA-MP · тариф

Сколько диска нужно под сервер SA-MP

Сервер SA-MP занимает около 100 МБ сразу после установки — минимальный тариф с 1 ГБ диска даёт запас под режимы, скрипты, логи и базы SQLite.

SA-MP · управление

Остановка сервера SA-MP: почему кнопка «Выключить» работает не мгновенно

Сервер SA-MP останавливается командой в консоль, а не обрывом процесса: так он успевает завершиться сам, а не быть снят силой через несколько секунд ожидания.

SA-MP · зависимости

SA-MP: режим не загружается из-за плагина или отсутствующей native-функции

Разберите ошибку загрузки Pawn по журналу: соответствие AMX и include, Linux-библиотеки, legacy plugins и компоненты open.mp.

SA-MP · данные игроков

Где лежат данные SA-MP и как проверить сохранение в scriptfiles

Найдите файлы аккаунтов и настроек своего режима SA-MP, проверьте запись после выхода игрока и сохраните данные перед переносом.