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.