Установка модов на сервер Luanti на Linux

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

Инструкция, как поставить моды на сервер Luanti (прежнее название — Minetest) на своём VDS с Linux. Сервер уже должен быть установлен — это описано в статье Установка игрового сервера Luanti (Minetest) на Linux; пути, пользователь luanti и служба luanti-server взяты из неё. Все команды и снимки экрана сняты с настоящего сервера: инструкция проверена 21 ноября 2026 года на Ubuntu 24.04 с сервером Luanti и игрой Minetest Game.

Моды Luanti собраны в каталоге ContentDB — content.luanti.org. Мод ставят в два шага: папку мода кладут в ~/.minetest/mods и включают её одной строкой в файле мира. Игрокам ставить ничего не нужно: всё, что нужно для мода, игра получает от сервера при входе.

1. Выберите мод

На странице мода в ContentDB посмотрите:

  • поддерживаемые игры — для каких игр мод сделан. Мод для Minetest Game в VoxeLibre или Mineclonia может не заработать, и наоборот;
  • зависимости — моды, без которых этот не запустится. Их ставят так же, рядом.

Адрес страницы мода выглядит так: content.luanti.org/packages/АВТОР/ИМЯ/. Если дописать к нему download/, получится прямая ссылка на архив — её и отдают команде wget.

Для примера взят мод More Ores — он добавляет в мир серебро, олово и мифрил. Его техническое имя — moreores.

2. Скачайте мод в папку mods

Остановите сервер, перейдите под пользователя luanti, скачайте архив в папку ~/.minetest/mods и распакуйте его:

sudo systemctl stop luanti-server
sudo su - luanti
mkdir -p ~/.minetest/mods && cd ~/.minetest/mods
wget -q --show-progress -O moreores.zip https://content.luanti.org/packages/Calinou/moreores/download/
unzip -q moreores.zip && rm moreores.zip
ls ~/.minetest/mods
grep name ~/.minetest/mods/moreores/mod.conf

В папке mods появилась папка мода. Его техническое имя записано в файле mod.conf, в строке name — оно понадобится на следующем шаге. Если команды unzip в системе нет, поставьте её: sudo apt install -y unzip.

3. Включите мод в файле мира

Допишите в конец файла мира world.mt строку с именем мода. Вторая команда включает подробный журнал: по умолчанию сервер о загрузке модов не пишет, а для проверки на следующем шаге эти строки нужны. Затем выйдите из-под пользователя и запустите сервер:

echo "load_mod_moreores = true" >> ~/.minetest/worlds/world/world.mt
echo "debug_log_level = info" >> ~/.minetest/minetest.conf
cat ~/.minetest/worlds/world/world.mt
exit
sudo systemctl start luanti-server

Для каждого мода нужна своя строка. Мод, который лежит в папке, но не вписан в world.mt, сервер не загружает.

4. Проверьте, что мод загрузился

Посмотрите строки о модах в журнале сервера — файле debug.txt:

sudo grep -E 'Loading mods|Mod "moreores"|listening on' /home/luanti/.minetest/debug.txt | tail -n 3 | cut -c1-105

Строка «Mod "moreores" loaded after 3 ms» означает, что мод загружен. В строке «Loading mods» перечислены все моды: остальные имена — это моды, из которых состоит сама игра Minetest Game. При проверке сервер с модом ответил на запрос снаружи, с другого компьютера.

С подробным журналом файл debug.txt быстро растёт. После проверки уберите строку и перезапустите сервер:

sudo -u luanti sed -i '/^debug_log_level/d' /home/luanti/.minetest/minetest.conf
sudo systemctl restart luanti-server

Обновление и удаление модов

Выключить и удалить мод. Остановите сервер, уберите строку мода из world.mt, удалите папку мода и запустите сервер:

sudo systemctl stop luanti-server
sudo -u luanti sed -i '/^load_mod_moreores/d' /home/luanti/.minetest/worlds/world/world.mt
sudo rm -r /home/luanti/.minetest/mods/moreores
sudo systemctl start luanti-server

При проверке после этого мод пропал из списка «Loading mods». Чтобы только выключить мод, достаточно убрать строку из world.mt — папку можно оставить.

Что нужно Как сделать
Обновить мод Остановите сервер, удалите прежнюю папку мода и повторите шаг 2 — ссылка download/ всегда отдаёт свежий выпуск. Строку в world.mt менять не нужно
Поставить набор модов Набор (modpack) — папка с файлом modpack.conf, внутри которой лежат несколько модов. В ~/.minetest/mods кладут всю папку набора, а в world.mt включают каждый мод из неё своей строкой
Настроить мод Настройки модов дописывают в /home/luanti/.minetest/minetest.conf. Названия настроек указаны на странице мода

Перед тем как убирать мод на сервере с готовым миром, сделайте резервную копию по основной статье: блоки и предметы выключенного мода в мире становятся «неизвестными».

Если что-то пошло не так

Что видите Причина и решение
В журнале «The following mods could not be found: "имя"» В world.mt включён мод, которого нет в ~/.minetest/mods, либо имя в строке не совпадает с именем из mod.conf. Сервер при этом запускается, но без мода.
Мода нет в списке «Loading mods» Нет строки load_mod_имя = true в world.mt, либо папка мода вложена глубже: mods/имя/имя. Файл mod.conf должен лежать прямо в папке мода.
Служба не запускается, в журнале «Some mods have unsatisfied dependencies» и ниже «имя is missing: другой_мод» Моду не хватает другого мода — он назван в конце строки. Поставьте и включите его или выключите мод, который его требует. Журнал службы: sudo journalctl -u luanti-server -n 30 --no-pager.
Служба не запускается, в журнале ошибка с именем мода и файлом .lua Мод сделан для другой игры или не подходит к версии Luanti. Уберите его строку из world.mt и проверьте на странице мода, какие игры и версии он поддерживает.

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: