Luminesk CLI (ранее LumiNESK) - Развертывание серверов MCBE без лишних сложностей

Композитор серверов Minecraft Bedrock Edition (MCBE)

CI GitHub Release PyPI Version Python License Docs GitHub Repository


Что такое Luminesk CLI?

Luminesk CLI (nesk) — это инструмент командной строки для развертывания и управления серверами MCBE.
Он объединяет создание серверов, настройку среды выполнения, загрузку, обновление, диагностику и управление жизненным циклом серверов в едином интерфейсе.

Основные возможности

  • Создание и управление несколькими экземплярами серверов MCBE с использованием тегов.
  • Загрузка поддерживаемых серверных ядер и их обновление при выходе новых версий.
  • Запуск серверов с использованием локальной среды выполнения в Docker.
  • Проверка окружения и доступности провайдеров с помощью встроенной диагностики.
  • Просмотр состояния серверов, журналов и метаданных через команды CLI.
  • Единообразный набор команд для Linux, macOS и Windows.

С чего начать

Установка

Linux / macOS

curl -fsSL https://luminesk.taskov1ch.xyz/sh | sh

Windows (PowerShell)

iwr -useb https://luminesk.taskov1ch.xyz/ps1 | iex

PyPI

pip install luminesk-cli

Быстрый старт

nesk --help
nesk diagnostic
nesk create -n "My Server" -d ./servers/my -c nukkit -t my-server
nesk start my-server
nesk list

Подробное описание всех команд доступно в разделе Command Reference.

Разработка

  • Руководство для контрибьюторов: CONTRIBUTING.md
  • Дополнительная информация по разработке и документации: Development & Contributing

Статус проекта

Luminesk находится в стадии активной разработки и имеет статус beta.
Перед использованием в критически важных производственных средах обязательно проверьте его работу в собственном окружении.

Лицензия

GPL-3.0-or-later. Подробнее см. в LICENSE.

2 лайка

image
ого

Ага. Полезная штука для генерации документации

ладно, но ■■■■■ ты запарился
документацию к какой-то панели, когда есть докер

Не понял тебя

Крч. Больше вообще не вспоминайте начало поста. Ниже ИИ сводка:


Luminesk CLI 2.0 — сервер Minecraft из рецепта, без ручной сборки окружения

Luminesk CLI (nesk) — инструмент для установки, запуска и безопасного
обновления серверов Minecraft Java и Bedrock в Docker.

Вы выбираете ядро, Luminesk показывает, что именно будет скачано и запущено,
фиксирует точные версии и хеши, а затем создаёт отдельный серверный instance.
Без ручного поиска JAR/PHAR, без случайных shell-скриптов из рецепта и без
непонятного состояния после неудачного обновления.

Что умеет

  • каталог готовых рецептов для Java и Bedrock;
  • установка официального, GitHub- или локального рецепта;
  • nesk info заранее показывает inputs, а wizard спрашивает
    недостающие значения, включая принятие Minecraft EULA;
  • Docker как единая среда запуска на Linux, macOS и Windows;
  • точные SHA-256 артефактов и immutable digest Docker-образа в luminesk.lock;
  • preview и --dry-run перед установкой или обновлением;
  • сохранение миров, плагинов и пользовательских конфигов по правилам ownership;
  • автоматический rollback при ошибке транзакции или readiness-проверки;
  • список локальных серверов, статус, история логов и фильтры;
  • полноценный attach TUI: история консоли, live-вывод, ввод команд и прокрутка;
  • видимый статус на долгих скачиваниях, сборках, транзакциях и
    readiness-проверках — без ощущения, что CLI завис;
  • стабильный --json --non-interactive для автоматизации.

Быстрый старт

Нужен Docker Engine или Docker Desktop. Git для обычной установки не
нужен. One-line installer ставит готовый бинарник и не требует Python.

Linux / macOS:

curl -fsSL https://luminesk.taskov1ch.xyz/sh | sh -s -- --yes

Windows PowerShell:

irm https://luminesk.taskov1ch.xyz/ps1 | iex

Тот же installer можно запустить повторно для обновления. Он определяет платформу,
загружает latest release и проверяет SHA-256 перед установкой.
--yes в Unix-команде относится только к installer: он не принимает Minecraft
EULA и не подтверждает будущие операции nesk.

Альтернатива через PyPI требует Python 3.13+:

uv tool install luminesk-cli

Первичная настройка:

nesk doctor
nesk catalog update
nesk search --type core
nesk info paper
nesk install paper --dir ./servers/example

nesk info paper заранее покажет все параметры рецепта. При обычной установке
wizard спросит недостающие значения и покажет plan перед записью файлов. Для
Paper нужно явно принять EULA — Luminesk не делает это за пользователя.

После установки:

nesk start --dir ./servers/example
nesk status --dir ./servers/example
nesk attach --dir ./servers/example

В attach всегда видны горячие клавиши:

  • Ctrl+C — корректно остановить сервер;
  • Ctrl+D — выйти из attach, оставив сервер запущенным;
  • Ctrl+K — принудительно завершить сервер;
  • Ctrl+L — очистить локальное окно;
  • PageUp / PageDown — прокрутка, End — вернуться к live-выводу.

Обычные логи тоже сразу показывают последние 200 строк:

nesk logs --dir ./servers/example
nesk logs --dir ./servers/example --tail 500 --since 10m --timestamps
nesk logs --dir ./servers/example --follow

Где конфиги сервера?

Редактируемые конфиги создаёт само ядро при первом запуске. Официальные рецепты
не подсовывают урезанный server.properties и не затирают целый конфиг парой
строк. Остановите сервер, измените созданный ядром файл и запустите сервер снова:

nesk stop --dir ./servers/example
# редактируем ./servers/example/server.properties
nesk start --dir ./servers/example

Для Paper и Purpur EULA — исключение: рецепт создаёт только полный
eula.txt после явного согласия пользователя.

Обновления без прыжка в неизвестность

nesk outdated --dir ./servers/example
nesk diff --dir ./servers/example
nesk update --dir ./servers/example --dry-run
nesk update --dir ./servers/example --yes

Luminesk сначала собирает и проверяет новый пакет, показывает изменения и только
потом применяет их транзакционно. Локально изменённый managed-файл вызывает
конфликт, а не молча перезаписывается. Если обновлённый сервер не проходит
readiness, Luminesk пытается вернуть предыдущие файлы и предыдущий runtime.
Для важных миров всё равно нужен отдельный проверенный backup.

Автоматизация

nesk install paper --dir ./servers/example \
  --set eula=true --dry-run --json --non-interactive

nesk install paper --dir ./servers/example \
  --set eula=true --yes --json --non-interactive

Важно для пользователей 1.1

2.0 — полная переработка. Кодовая база, конфиги Luminesk, registry/state,
lock-файлы и структура instance несовместимы с 1.1. Обновления поверх старой
директории нет: сделайте backup, установите 2.0-сервер рядом и перенесите только
миры, плагины и пользовательские данные по инструкции миграции.

Ссылки

Luminesk распространяется под лицензией GPL-3.0-or-later.

Если очень коротко, то Luminesk-CLI стал yay в мире майнкрафт серверов

и это все vi$$$code

а в чем собственно минус? он прекрасно понимает питон, и знает что ии ему пишет;

нет, притензий к самому проекту нет
но я так почитал описание в этой теме, чутка проперделся)
столько слов, которые фундаментально непонятны даже среднему уровню программиста скорее всего, какая речь идет о простых людей, которые хотят администрировать свой сервер
еще и докер накатывать наверно)
все описание написано с ии, без негатива если что, не осуждаем, но и не одобряю

сам проект даже полезен я считаю

  1. Лишь меньшая часть написано ИИ (по типу “выеби проект под всеми сценариями, составь отчёт, и сам же этот отчёт рассоси, желательно составив план для меня”)
  2. Да, вся документация держится на ИИ (ну простите, мне лень)

ахах, понимаю (со вторым, упд)