Настройка RCON на сервере Minecraft
RCON — способ отправлять серверу Minecraft команды консоли по сети: из скрипта, из другой программы или с другого компьютера. С ним перезапуск по расписанию предупреждает игроков заранее, резервная копия сначала сохраняет мир, а бот или сайт может показать, кто сейчас на сервере. В статье — включение RCON на сервере Minecraft: Java Edition, программа mcrcon, примеры команд и готовый скрипт перезапуска с предупреждением. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4 с сервером Paper 26.3; снимки экрана сняты с настоящего сервера.
Сервер установлен по статье Установка и настройка Spigot-Paper сервера: каталог /opt/minecraft/server, служба minecraft. Для обычного сервера (Vanilla), Spigot и сборок с модами всё делается так же — настройка RCON у них общая.
Чем RCON отличается от консоли
| Консоль сервера | RCON | |
|---|---|---|
| Как попасть | Только с самого VDS: sudo -u minecraft tmux attach -t minecraft |
По сети, с паролем |
| Кто пользуется | Человек | Скрипты и программы: расписание, копии, боты, панели |
| Ответ команды | На экране консоли | Возвращается тому, кто отправил, — его можно разобрать в скрипте |
1. Включение
Остановите сервер, поменяйте три строки в server.properties и запустите снова. Вместо ВАШ_ПАРОЛЬ подставьте свой пароль — длинный, из латинских букв и цифр:
sudo systemctl stop minecraft
sudo -u minecraft sed -i 's/^enable-rcon=.*/enable-rcon=true/; s/^rcon.password=.*/rcon.password=ВАШ_ПАРОЛЬ/; s/^rcon.port=.*/rcon.port=25575/' /opt/minecraft/server/server.properties
grep -E "^(enable-rcon|rcon\.|broadcast-rcon)" /opt/minecraft/server/server.properties
sudo systemctl start minecraft
grep -E "RCON running|Done \(" /opt/minecraft/server/logs/latest.log | cut -c1-90
sudo ss -lntp | grep -E ":(25565|25575) " | awk '{print $1, $4}'
| Строка | Что означает |
|---|---|
enable-rcon=true |
Включить RCON |
rcon.password |
Пароль. С пустым паролем RCON не включится |
rcon.port=25575 |
Порт (TCP) |
broadcast-rcon-to-ops=true |
Показывать операторам в игре команды, выполненные через RCON. Удобно для контроля; false — не показывать
|
В журнале появилась строка «RCON running on 0.0.0.0:25575», сервер слушает два порта: 25565 — игра, 25575 — RCON.
Порт 25575 в файрволе не открывайте. RCON передаёт пароль и команды без шифрования, а тот, кто знает пароль, может всё, что может консоль: выдать себе права оператора, остановить сервер, стереть мир. Скриптам на самом VDS порт снаружи не нужен — они обращаются по адресу 127.0.0.1. Если RCON нужен с другого сервера, разрешите порт только его адресу: sudo ufw allow from 198.51.100.20 to any port 25575 proto tcp.
2. Программа mcrcon
mcrcon — небольшая программа, которая отправляет команды по RCON из командной строки. В хранилище Ubuntu её нет, она собирается из исходного кода за несколько секунд:
sudo apt install -y gcc make git git clone -q https://github.com/Tiiffi/mcrcon.git && cd mcrcon make && sudo make install mcrcon -v cd ~
3. Команды
mcrcon -H 127.0.0.1 -P 25575 -p ВАШ_ПАРОЛЬ "list" mcrcon -H 127.0.0.1 -P 25575 -p ВАШ_ПАРОЛЬ "say Hello from RCON" "difficulty" "whitelist list" mcrcon -H 127.0.0.1 -P 25575 -p ВАШ_ПАРОЛЬ "tps" "save-all"
- Команды пишутся так же, как в консоли сервера, — без косой черты в начале. Каждая — в своих кавычках; несколько команд выполняются по порядку.
- Ответ сервера возвращается в терминал: число игроков, сложность, скорость работы (TPS), «Saved the game».
- Последняя строка снимка — что будет при неверном пароле: «Authentication failed!».
| Команда | Что делает |
|---|---|
list |
Кто на сервере |
say текст |
Сообщение всем игрокам |
save-all |
Сохранить мир на диск |
save-off, save-on |
Выключить и включить автосохранение — на время резервной копии |
whitelist add имя, whitelist remove имя |
Белый список |
kick имя причина, ban имя причина, pardon имя |
Отключить, заблокировать, разблокировать |
op имя, deop имя |
Выдать и снять права оператора |
stop |
Остановить сервер (служба запустит его снова, если это не остановка через systemctl)
|
Запуск mcrcon -H 127.0.0.1 -P 25575 -p ВАШ_ПАРОЛЬ -t открывает построчный режим: команды вводятся одна за другой, выход — Ctrl+C.
Пароль в командной строке остаётся в истории команд и виден в списке процессов. Для скриптов надёжнее файл с переменными — mcrcon читает их сам:
sudo nano /etc/mcrcon.env
MCRCON_HOST=127.0.0.1 MCRCON_PORT=25575 MCRCON_PASS=ВАШ_ПАРОЛЬ
sudo chmod 600 /etc/mcrcon.env
4. Перезапуск с предупреждением игроков
sudo nano /usr/local/bin/mc-restart.sh
#!/bin/bash # Перезапуск сервера Minecraft с предупреждением игроков set -a; . /etc/mcrcon.env; set +a mcrcon "say Server restart in 60 seconds" > /dev/null sleep 50 mcrcon "say Server restart in 10 seconds" "save-all" > /dev/null sleep 10 systemctl restart minecraft
sudo chmod +x /usr/local/bin/mc-restart.sh
sudo /usr/local/bin/mc-restart.sh
zcat -f /opt/minecraft/server/logs/*.log.gz | grep -E "\[Rcon\] Server|Rcon: Saved|Stopping server" | tail -n 4 | cut -c1-100
grep "Done (" /opt/minecraft/server/logs/latest.log | cut -c1-80; systemctl is-active minecraft
По журналу видно весь ход: предупреждение за минуту, второе за десять секунд, сохранение мира, остановка — и сервер снова запущен. Текст сообщений можно писать и по-русски.
Чтобы перезапуск шёл каждую ночь, добавьте задание в расписание root (sudo crontab -e):
0 5 * * * /usr/local/bin/mc-restart.sh
Подробнее о расписаниях — Автообновление и перезапуск игрового сервера по расписанию; о копиях мира с командами save-off и save-on — Настройка автоматических бэкапов Minecraft.
Что не проверено
Проверены: включение RCON, сборка mcrcon, команды и их ответы, отказ при неверном пароле, файл с переменными, скрипт перезапуска с предупреждениями. Не проверены: подключение по RCON с другого сервера и то, как сообщения say выглядят у игрока, — для этого нужна сама игра.
Если что-то пошло не так
| Что видите | Причина и решение |
|---|---|
| «Connection failed» | RCON не включён или сервер ещё не запустился. В журнале должна быть строка «RCON running»; в server.properties — enable-rcon=true и непустой пароль
|
| «Authentication failed!» | Неверный пароль. Сверьте с rcon.password; после правки файла сервер нужно перезапустить
|
Правка server.properties не действует |
Файл правили при работающем сервере — при остановке он записал старые значения. Остановите сервер, поправьте, запустите |
mcrcon: command not found |
Не выполнена команда sudo make install — шаг 2
|
| Команда отвечает «Unknown or incomplete command» | Команда написана с косой чертой или с ошибкой. Через RCON — без косой черты |
| Скрипт из расписания не работает, а вручную работает | В расписании нет доступа к файлу /etc/mcrcon.env: задание должно быть в расписании root
|
Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов