LAN Command Pipe: документация плагина lan_pipe.sp

LAN Command Pipe — плагин SourceMod для локального обмена командами между игрой и инструментами на том же компьютере. Он читает строки из файла, выполняет их как серверные команды или возвращает запрошенное состояние в журнал. В репозитории представлен исходный файл tools/src/lan_pipe.sp; це не готовий бінарний плагін і не підтвердження успішної збірки.

Возможности

• Опрашивает файл команд с заданным интервалом и передает обычные строки в серверную консоль через ServerCommand().
• Поддерживает запрос значения CVAR через префикс ?, а также запросы состояния ~status і ~players.
• Записывает результаты в отдельный текстовый журнал с временными метками. Для статуса предусмотрены данные о карте, количестве игроков и ботов, времени, счете команд и времени заморозки; для игроков — слот, имя, команда, состояние жизни и признак бота.
• После обработки хотя бы одной строки с командой очищает файл, чтобы эти строки не выполнялись повторно.

README объясняет, что файловый канал используется вместо RCON: в упомянутой сборке CS:GO Legacy отсутствует connectionless RCON, а внешний инструмент и игра могут обмениваться данными через общий диск.

Требования и безопасность

В исходном коде указаны зависимости SourceMod sourcemod і cstrike. Проект предназначен для локальной работы и работы по LAN с CS:GO Legacy; README требует запускать игру с параметром -insecure, чтобы загружались неподписанные DLL из addons. Не используйте этот инструмент в официальных матчах или на чужих серверах.

Файл команд является каналом выполнения серверных команд, то есть фактически локальным каналом выполнения кода. Храните его только на компьютере, который находится под вашим контролем. Чтобы остановить опрос, установите sm_lanpipe_enable 0.

Установка

README проекта предлагает запускать python toolscsgotool.py install для установки стороннего набора плагинов; перед этим можно использовать python toolscsgotool.py install --dry-run. Это описанный способ работы с набором, а не инструкция по сборке именно lan_pipe.sp. Архив содержит исходный код, поэтому наличие готового lan_pipe.smx не гарантируется.

Настройка

Плагин создает конфигурационные переменные со следующими начальными значениями:

• sm_lanpipe_enable — 1, опрос включен.
• sm_lanpipe_interval — 0.2 секунды; допустимый диапазон — от 0.05 до 5.0.
• sm_lanpipe_file — data/lan_pipe.txt, путь относительно addons/sourcemod.
• sm_lanpipe_log — data/lan_exec.log, путь относительно addons/sourcemod.
• sm_lanpipe_version — версия плагина; в исходном коде это 1.3.0.

Формат файла команд

Каждая строка обрабатывается отдельно. Пустые строки, а также строки, начинающиеся с #, ; или //, игнорируются. Примеры запросов:

?mp_freezetime
~status
~players
mp_freezetime 5

Первая строка считывает значение CVAR, следующие запрашивают состояние матча и список игроков, а последняя передает команду серверу. Результаты появляются в файле, заданном параметром sm_lanpipe_log.

Загрузка

Версия: v1.0.1.

ZIP содержит исходный репозиторий; готовая сборка не гарантируется. Файл плагина: tools/src/lan_pipe.sp.