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

**URL:** <https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858>\
**Category:** Ядра\
**Tags:** pmmp5, гкод, nukkit, python\
**Created:** [07.Июль.2026 12:19:32 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858 "2026-07-07T12:19:32Z")\
**Posts on this page:** 13\
**Page:** 1

<div class="post-metadata">

**Author:** ![Taskovich](https://talk.24serv.pro/user_avatar/talk.24serv.pro/taskovich/32/20096_2.png) [@Taskovich](https://talk.24serv.pro/u/Taskovich)\
**Post date:** [07.Июль.2026 12:19:32 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/1 "2026-07-07T12:19:32Z")

</div>

![67f8ea26-f9af-42a3-8c53-1b6be578d737](https://cdn.talk.24serv.pro/original/3X/3/0/305a9a3bea6fe7c04bccf98701c9916456104e88.jpeg)

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

[![CI](https://img.shields.io/github/actions/workflow/status/task-v1/luminesk-cli/ci.yml?branch=main&label=CI)](https://github.com/task-v1/luminesk-cli/actions/workflows/ci.yml)[![GitHub Release](https://img.shields.io/github/v/release/task-v1/luminesk-cli)](https://github.com/task-v1/luminesk-cli/releases/latest)[![PyPI Version](https://img.shields.io/pypi/v/luminesk-cli)](https://pypi.org/project/luminesk-cli/)[![Python](https://img.shields.io/pypi/pyversions/luminesk-cli)](https://pypi.org/project/luminesk-cli/)[![License](https://img.shields.io/github/license/task-v1/luminesk-cli)](https://github.com/task-v1/luminesk-cli/blob/main/LICENSE)[![Docs](https://img.shields.io/badge/docs-online-0ea5e9)](https://luminesk.taskov1ch.xyz)[![GitHub Repository](https://img.shields.io/badge/GitHub_Repository-%23101411?logo=Github)](https://github.com/task-v1/luminesk-cli)

* * *

## Что такое Luminesk CLI?

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

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

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

## С чего начать

- [Getting Started](https://luminesk.taskov1ch.xyz/docs/getting-started)
- [Installation](https://luminesk.taskov1ch.xyz/docs/installation)
- [Quick Start](https://luminesk.taskov1ch.xyz/docs/quick-start)
- [Command Reference](https://luminesk.taskov1ch.xyz/docs/command-reference)
- [Runtime & Docker Model](https://luminesk.taskov1ch.xyz/docs/runtime-and-docker)
- [Troubleshooting](https://luminesk.taskov1ch.xyz/docs/troubleshooting)

## Установка

### Linux / macOS

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

```

### Windows (PowerShell)

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

```

### PyPI

```bash
pip install luminesk-cli

```

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

```bash
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](https://luminesk.taskov1ch.xyz/docs/command-reference).

## Разработка

- Руководство для контрибьюторов: [CONTRIBUTING.md](https://github.com/task-v1/luminesk-cli/blob/main/CONTRIBUTING.md)
- Дополнительная информация по разработке и документации: [Development & Contributing](https://luminesk.taskov1ch.xyz/docs/development-and-contributing)

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

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

## Лицензия

GPL-3.0-or-later. Подробнее см. в [LICENSE](https://github.com/task-v1/luminesk-cli/blob/main/LICENSE).

---

<div class="post-metadata">

**Author:** ![hexcry](https://talk.24serv.pro/user_avatar/talk.24serv.pro/hexcry/32/19203_2.png) [@hexcry](https://talk.24serv.pro/u/hexcry)\
**Post date:** [07.Июль.2026 12:32:24 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/2 "2026-07-07T12:32:24Z")

</div>

![image](https://cdn.talk.24serv.pro/original/3X/c/5/c50bbde6b3b6dee35dac346126c235ed86f12dac.png)  
ого

---

<div class="post-metadata">

**Author:** ![Taskovich](https://talk.24serv.pro/user_avatar/talk.24serv.pro/taskovich/32/20096_2.png) [@Taskovich](https://talk.24serv.pro/u/Taskovich)\
**Post date:** [07.Июль.2026 12:33:22 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/3 "2026-07-07T12:33:22Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![hexcry](https://talk.24serv.pro/user_avatar/talk.24serv.pro/hexcry/32/19203_2.png) [@hexcry](https://talk.24serv.pro/u/hexcry)\
**Post date:** [07.Июль.2026 12:33:41 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/4 "2026-07-07T12:33:41Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![Taskovich](https://talk.24serv.pro/user_avatar/talk.24serv.pro/taskovich/32/20096_2.png) [@Taskovich](https://talk.24serv.pro/u/Taskovich)\
**Post date:** [07.Июль.2026 13:55:53 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/5 "2026-07-07T13:55:53Z")

</div>

Не понял тебя

---

<div class="post-metadata">

**Author:** ![Taskov1ch](https://talk.24serv.pro/letter_avatar_proxy/v4/letter/t/67e7ee/32.png) [@Taskov1ch](https://talk.24serv.pro/u/Taskov1ch)\
**Post date:** [08.Сентябрь.2026 09:44:36 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/6 "2026-09-08T09:44:36Z")

</div>

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

* * *

# 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:

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

```

Windows PowerShell:

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

```

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

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

```bash
uv tool install luminesk-cli

```

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

```bash
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 не делает это за пользователя.

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

```bash
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 строк:

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

```

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

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

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

```

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

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

```bash
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.

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

```bash
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-сервер рядом и перенесите только  
миры, плагины и пользовательские данные по инструкции миграции.

## Ссылки

- Документация: [https://luminesk.taskov1ch.xyz](https://luminesk.taskov1ch.xyz)
- Быстрый старт: [https://luminesk.taskov1ch.xyz/docs/quick-start](https://luminesk.taskov1ch.xyz/docs/quick-start)
- Установка: [https://luminesk.taskov1ch.xyz/docs/installation](https://luminesk.taskov1ch.xyz/docs/installation)
- Миграция с 1.x: [https://luminesk.taskov1ch.xyz/docs/migrating-to-2.0](https://luminesk.taskov1ch.xyz/docs/migrating-to-2.0)
- GitHub: [https://github.com/task-v1/luminesk-cli](https://github.com/task-v1/luminesk-cli)
- Релизы: [https://github.com/task-v1/luminesk-cli/releases/latest](https://github.com/task-v1/luminesk-cli/releases/latest)

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

---

<div class="post-metadata">

**Author:** ![Taskov1ch](https://talk.24serv.pro/letter_avatar_proxy/v4/letter/t/67e7ee/32.png) [@Taskov1ch](https://talk.24serv.pro/u/Taskov1ch)\
**Post date:** [08.Сентябрь.2026 10:20:29 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/7 "2026-09-08T10:20:29Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![hexcry](https://talk.24serv.pro/user_avatar/talk.24serv.pro/hexcry/32/19203_2.png) [@hexcry](https://talk.24serv.pro/u/hexcry)\
**Post date:** [08.Сентябрь.2026 17:59:09 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/8 "2026-09-08T17:59:09Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![dmitrijafamev](https://talk.24serv.pro/user_avatar/talk.24serv.pro/dmitrijafamev/32/20121_2.png) [@dmitrijafamev](https://talk.24serv.pro/u/dmitrijafamev)\
**Post date:** [08.Сентябрь.2026 18:03:56 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/9 "2026-09-08T18:03:56Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![hexcry](https://talk.24serv.pro/user_avatar/talk.24serv.pro/hexcry/32/19203_2.png) [@hexcry](https://talk.24serv.pro/u/hexcry)\
**Post date:** [08.Сентябрь.2026 18:11:21 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/10 "2026-09-08T18:11:21Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![hexcry](https://talk.24serv.pro/user_avatar/talk.24serv.pro/hexcry/32/19203_2.png) [@hexcry](https://talk.24serv.pro/u/hexcry)\
**Post date:** [08.Сентябрь.2026 18:11:35 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/11 "2026-09-08T18:11:35Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![Taskov1ch](https://talk.24serv.pro/letter_avatar_proxy/v4/letter/t/67e7ee/32.png) [@Taskov1ch](https://talk.24serv.pro/u/Taskov1ch)\
**Post date:** [08.Сентябрь.2026 18:12:44 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/12 "2026-09-08T18:12:44Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![hexcry](https://talk.24serv.pro/user_avatar/talk.24serv.pro/hexcry/32/19203_2.png) [@hexcry](https://talk.24serv.pro/u/hexcry)\
**Post date:** [08.Сентябрь.2026 18:13:05 UTC](https://talk.24serv.pro/t/luminesk-cli-ranee-luminesk-razvertyvanie-serverov-mcbe-bez-lishnih-slozhnostej/33858/13 "2026-09-08T18:13:05Z")

</div>

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