Настройка RCON на сервере Minecraft

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

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: