zomboid_rcon

Zomboid-rcon: Python RCon для проекта Zomboid Servers

Версия: 1.1.0

Zomboid-Rcon позволяет легко общаться с вашим проектом Zomboid Servers через RCON. С Zomboid-RCON вы можете отправлять команды на свой сервер, управлять игроками и многое другое, все из вашего сценария Python.

• GitHub Repo
• PYPI пакет

Установка

Чтобы начать, просто установите Zomboid-rcon с помощью PIP:

pip install zomboid-rcon

Использование

Использовать Zomboid-RCN легко. Вот основной пример:

 from zomboid_rcon import ZomboidRCON

if __name__ == "__main__" :
    pz = ZomboidRCON ( ip = 'localhost' , port = 12345 , password = 'myPassword' )
    command = pz . serverMsg ( "You dead yet?" )
    print ( command . response )

Этот пример подключается к серверу, работающему на вашей локальной машине, и отправляет сообщение «Вы уже мертвы?».

Zomboid-Rcon предоставляет несколько встроенных методов для общих задач по управлению сервером, таких как получение списка подключенных игроков:

 from zomboid_rcon import ZomboidRCON

if __name__ == "__main__" :
    pz = ZomboidRCON ( ip = 'localhost' , port = 12345 , password = 'myPassword' )
    print ( pz . players (). response )

Этот пример печатает список всех игроков, которые в настоящее время подключены к серверу.

Доступные команды

Zomboid-Rcon предоставляет встроенные методы для доступных команд RCon в рамках проекта Zomboid.

Общие команды

• additem("user", "item") : элементы можно найти на PZ Wiki: https://pzwiki.net/wiki/items
• addvehicle("user") : порождает транспортное средство.
• addxp("user", "perk", xp) : дает XP игроку.
• alarm() : звучит строительная тревога в положении администратора. Должен быть в комнате.
• changeoption("option", "newOption") : изменяет опцию сервера.
• chopper() : размещает вертолетное событие на случайного игрока.
• changepwd("pwd", "newPwd") : изменяет ваш пароль.
• createhorde("number") : порождает орду возле игрока.
• godmode("user") : делает игрока непобедимым.
• gunshot() : издает огнестрельный шум возле игрока.
• help() : поднимает меню помощи. (Перечисляет нативные команды RCON. Для всех команд Zomboid_rcon см. В этом списке)
• invisible("user") : делает игрока невидимым для зомби.
• noclip("user") : позволяет игроку проходить через твердые объекты.
• quit() : сохраняет и выходит на сервер.
• releasesafehouse() : выпускает сейф -домик, который у вас есть.
• reloadlua("filename") : Перезагрузите сценарий LUA на сервере.
• reloadoptions() : Reloads Server параметры.
• replay("user", [-record | -play | -stop], "filename") : записывает и воспроизводит повтор для движущегося игрока.
• save() : спасает текущий мир.
• sendpulse() : переключать информацию о производительности отправки сервера клиенту.
• showoptions() : показывает список текущих параметров и значений сервера.
• startrain() : начинает дождь на сервере.
• stoprain() : останавливает дождь на сервере.
• teleport("user", "toUser") : Телепорт игроку.
• teleportto(x, y, z) : Телепорт до определенных координат.

Команды модерации

• addalltowhitelist() : добавляет всех текущих пользователей, подключенных к паролю к белому списку.
• adduser("user", "pwd") : добавляет нового пользователя в белый список.
• addusertowhitelist("user") : добавляет одного пользователя, подключенного к паролю к белому списку.
• removeuserfromwhitelist("user") : удаляет одного пользователя, подключенного к паролю к белому списку.
• banid("SteamID") : запретить парному идентификатору.
• unbanid("SteamID") : отказаться от парного идентификатора.
• banuser("user") : запрещает пользователя.
• unbanuser("user") : Отказ от пользователя.
• checkModsNeedUpdate() : указывает, был ли обновлен мод. Пишет ответ на файл журнала.
• grantadmin("user") : дает права администратора пользователю.
• removeadmin("user") : удаляет права администратора для пользователя.
• kickuser("user") : пинает пользователя с сервера.
• players() : перечисляет всех подключенных игроков.
• servermsg("message") : транслируйте сообщение всем игрокам. (Пространства заменяются подставками для совместимости)
• setaccesslevel("user", [admin | moderator | overseer | gm | observer]) : Установите уровень доступа/разрешения игрока.
• voiceban("user", [-true | -false]) : запретить пользователю использовать голосовую функцию.

Команда не указана?

Вы можете выполнить любую пользовательскую команду, используя метод команды:

 pz . command ( "command" , "arg1" , "arg2" , "etc" )

Демонстрация

Известные проблемы

Обратите внимание, что Zomboid-Rcon использует пакет Timeout_decorator, который в настоящее время совместим только с системами Unix/Linux. В результате таймауты могут вызывать ошибки на машинах Windows . Мы активно работаем над поиском альтернативного решения для пользователей Windows.

Внося

Мы приветствуем взносы от всех! Если вы хотите внести свой вклад в проект, пожалуйста, откройте проблему или отправьте запрос на привлечение на GitHub.

Лицензия

Zomboid-Rcon лицензирован по лицензии GPL-3.0.