MineCker

О MineCker

Обзор

Этот мод позволяет операторам серверов Minecraft Java Edition (загрузчик NeoForge, сервер Spigot, сервер Paper, сервер Purpur) выполнять команды Docker прямо из игрового чата. При отправке сообщения, начинающегося с !docker, остальная часть сообщения передаётся в системный Docker CLI, а вывод (как stdout, так и stderr) отправляется обратно игроку.

Возможности

• Только для OP: команду могут использовать только игроки с уровнем OP 4.
• Кроссплатформенность: автоматически определяет Windows или Linux и использует cmd /c или bash -c соответственно.
• Безопасность: блокирует опасные символы (|, &, &&, ;, $, ` и т. д.) для предотвращения инъекций команд.
• Полный вывод: захватывает как стандартный вывод, так и вывод ошибок. Если команда выполняется успешно, но не выдаёт вывода, показывается дружелюбное сообщение.
• Без встроенного Docker: мод не поставляет бинарные файлы Docker; он полагается на рабочую команду docker в хост-системе.

Использование

1. Убедитесь, что docker ps работает из командной строки сервера.
2. Поместите мод в папку mods и запустите сервер.
3. Зайдите как OP и введите в чат: !docker ps — это выведет список всех запущенных контейнеров.
4. Любая подкоманда Docker работает, например:

• !docker images
• !docker run hello-world
• `!docker stop `

Уведомление о безопасности

• Используйте только в доверенной среде: любой OP может выполнять произвольные команды Docker. Убедитесь, что ваш список OP полностью доверенный.
• Опасные символы блокируются (например, |, &&), но это не предотвращает все вредоносные команды (например, docker rm -f $(docker ps -aq) всё ещё опасна). Выдавайте OP только тем игрокам, которым доверяете.

Требования

• Сервер: Minecraft 1.21.8/1.21.1 + NeoForge или Minecraft 1.21.x + Spigot/Paper/Purpur
• ОС: Windows (с Docker Desktop) или Linux (с Docker Engine, и пользователь сервера должен иметь права на запуск Docker)
• Docker: любая версия, предоставляющая рабочую команду docker в системном PATH.

Автоматически создаваемая папка

При первом запуске сервера мод создаёт папку LocalDockerAPI в корневой директории сервера (можно использовать для скриптов или конфигураций).

Лицензия и товарные знаки

Этот мод распространяется под [лицензией MIT]. Docker является товарным знаком Docker, Inc. Использование логотипа Docker соответствует правилам использования медиаресурсов Docker

Прочее

DeepSeek помог мне создать этот мод. Сделано в MCreator. Если вы хотите использовать эту библиотеку для своего мода, это очень просто: вам нужно всего лишь отправить сообщение "!docker (команда)"!