Инструкция ниже — для чистой установки на Linux-сервер (Ubuntu 22.04+ / Debian 12+). Для других ОС логика та же, отличаться будут только команды установки пакетов.

1. Требования

Linux с systemd (Ubuntu / Debian / Rocky / Arch — любой современный).
Обычный пользователь с правом sudo (например, mrleo1nid).
Java 21 в PATH (см. ниже).
Открытый порт 25565 (или тот, что в server.properties).
~10 ГБ свободного места под Java + NeoForge + моды + мир.

2. Получить репозиторий

Каталог /opt обычно принадлежит root, поэтому первый клон делается через sudo, а затем владельца передаём своему пользователю:

sudo git clone https://github.com/<...>/PupaMLupa.git /opt/PupaMLupa
sudo chown -R "$USER:$USER" /opt/PupaMLupa
cd /opt/PupaMLupa/Server
chmod +x start.sh run.sh install-service.sh install_java.sh

Дальше все команды — без sudo, кроме явно указанных.

3. Установить Java 21

Используйте системный пакет — он виден и в shell, и в systemd, и не требует Jabba:

sudo apt update
sudo apt install -y openjdk-21-jre-headless
java -version       # должно показать "21.x.x"

Альтернатива: Eclipse Temurin от Adoptium (temurin-21-jre через Adoptium APT-репозиторий) — поведение идентично openjdk.

Скрипт install_java.sh (Jabba) тоже работает, но ставит Java в ~/.jabba и требует интерактивного I agree. Для systemd-сервиса это неудобно — лучше системный пакет.

4. Первый запуск (вручную, один раз)

run.sh — это лёгкий лаунчер java @user_jvm_args.txt @libraries/.../unix_args.txt, он не умеет ничего скачивать. Поэтому первый запуск надо сделать через start.sh, чтобы он:

скачал и развернул NeoForge в libraries/;
сгенерировал user_jvm_args.txt;
скачал server.jar;
спросил про EULA.

cd /opt/PupaMLupa/Server
echo 'eula=true' > eula.txt          # принимаем EULA заранее
./start.sh

Дождитесь, когда в логе появится:

[Server thread/INFO]: Done (Xs)! For help, type "help"

После этого остановите сервер:

stop

(или нажмите Ctrl+C). Сервер сохранит мир и завершится.

5. Установить systemd-сервис

sudo ./install-service.sh

Что произойдёт:

скрипт проверит, что вы — root (через sudo);
определит пользователя сервиса по $SUDO_USER (= ваш юзер);
проверит наличие run.sh, NeoForge, user_jvm_args.txt, server.jar, принятый EULA, наличие java в PATH;
создаст /etc/systemd/system/minecraft.service;
сделает daemon-reload, enable, start;
покажет статус сервиса.

Теперь сервер будет автоматически:

запускаться при загрузке системы;
перезапускаться при падении (через 10 секунд);
писать логи в journald.

Флаги install-service.sh

Флаг	Описание
`--name <имя>`	Имя сервиса (по умолчанию `minecraft`)
`--user <user>`	Переопределить пользователя сервиса
`--dir <путь>`	Каталог сервера (по умолчанию — каталог скрипта)
`--uninstall`	Остановить и удалить сервис
`-h`, `--help`	Справка

6. Управление сервером

sudo systemctl status   minecraft     # текущее состояние
sudo systemctl stop     minecraft     # остановить
sudo systemctl start    minecraft     # запустить
sudo systemctl restart  minecraft     # перезапустить
sudo systemctl disable  minecraft     # убрать из автозапуска
sudo systemctl enable   minecraft     # вернуть в автозапуск

sudo journalctl -u minecraft -f                  # живые логи
sudo journalctl -u minecraft -n 200 --no-pager   # последние 200 строк
sudo journalctl -u minecraft --since "1 hour ago"

Внимание: при Type=simple ввод команд в консоль сервера (/op, /say) напрямую не работает — у systemd нет stdin. Если нужна интерактивная консоль, используйте RCON (включается в server.properties: enable-rcon=true, rcon.password=...) и подключайтесь утилитой mcrcon.

7. Обновление сервера

Поскольку сервис работает от вашего пользователя, обновление — обычные git-команды без sudo:

cd /opt/PupaMLupa
git pull

# если изменились моды/конфиги — перезапустить
sudo systemctl restart minecraft
sudo journalctl -u minecraft -f

Если при git pull приехали новые версии модов, и сервер падает с ошибками вроде Module xxx not found, проверьте что список модов синхронизирован с клиентом (см. sync-mods-from-client.ps1).

8. Удалить сервис

cd /opt/PupaMLupa/Server
sudo ./install-service.sh --uninstall

Скрипт остановит сервис, отключит автозапуск, удалит unit-файл и сделает daemon-reload. Файлы сервера (мир, конфиги, моды) НЕ трогаются — их можно удалить вручную, если нужно.

9. Полезные пути

Путь	Что внутри
`/opt/PupaMLupa/Server/`	корень сервера
`/opt/PupaMLupa/Server/world/`	мир
`/opt/PupaMLupa/Server/logs/`	свежие логи Minecraft
`/opt/PupaMLupa/Server/server.properties`	настройки сервера
`/opt/PupaMLupa/Server/variables.txt`	настройки `start.sh` (RAM, версия)
`/opt/PupaMLupa/Server/user_jvm_args.txt`	финальные JVM-аргументы
`/etc/systemd/system/minecraft.service`	unit-файл systemd

10. Решение типовых проблем

`status=200/CHDIR`

Каталог сервера лежит в /home/<user>/. systemd по умолчанию блокирует /home. Скрипт сам ослабляет ProtectHome, если видит такой путь, но рекомендуется хранить сервер в /opt.

`User did not agree to Jabba installation`

В PATH нет java, и start.sh пытается поставить её через интерактивный Jabba. Решение — поставить системную Java (см. раздел 3) и перезапустить сервис.

`Error: could not open user_jvm_args.txt` / `Permission denied`

Файлы сервера принадлежат не вашему пользователю (например, после sudo git clone остался владелец root). Вернуть себе:

sudo chown -R "$USER:$USER" /opt/PupaMLupa

`Module io.netty.buffer not found, required by netty_endec` (и подобные)

Не хватает мода или библиотеки на сервере, которая есть на клиенте. Сравните mods/ на клиенте и в Server/mods/. Скрипт sync-mods-from-client.ps1 помогает копировать недостающие jar.

EULA не принят

Сервер в systemd не сможет интерактивно спросить согласие. Создайте файл вручную:

echo 'eula=true' > /opt/PupaMLupa/Server/eula.txt

README.md Unescape Escape

PupaMLupa — серверная часть