MWeb

Плагин MWeb - это удобный инструмент для администраторов серверов Minecraft, который решает проблему раздачи файлов игрокам. Вместо того чтобы вручную загружать файлы на сторонние хостинги или возиться с FTP, вы можете прямо из игры создавать ссылки на любые файлы или папки сервера, управлять ими и даже отправлять ресурспаки одним кликом.

Возможности MWeb

Плагин полностью управляется через GUI или команды. Вот что он умеет:

• Просматривать файлы на сервере прямо в игре (только через GUI)
• Создавать публичные ссылки на любой файл или папку
• Создавать ограниченные ссылки (по пользователю, паролю, времени или количеству скачиваний)
• Редактировать и включать/отключать созданные ссылки
• Отправлять папки или архивы игрокам как ресурспак
• Архивировать и распаковывать папки прямо в игре
• Удалять и переименовывать файлы
• Задавать папки для загрузки файлов (с такими же ограничениями, как для скачивания)

Для продвинутых пользователей:

• Кастомные HTML/CSS/JS страницы ошибок
• Настройка прокси-домена (например, mutils.net/<id> вместо 1.2.3.4:1234/<id>)
• Разграничение каждого действия по правам (permissions)

Создание ссылки для скачивания

Создать ссылку можно буквально в один клик:

1. Откройте GUI через /ws whitelist или /ws -> manage download access
2. Перейдите к нужному файлу или папке
3. Нажмите кнопку для создания ссылки

Вы можете создать глобальную ссылку или персональную (только для вас) прямо из навигатора с помощью горячих клавиш 1 и 2. После обработки (большие папки архивируются дольше) появится новая ссылка - скопируйте её и поделитесь с кем угодно.

Для одного файла можно создать несколько ссылок. Нажмите клавишу 4 на файле или папке, чтобы управлять всеми ссылками: включать/отключать, удалять или редактировать.

Управление файлами

MWeb добавляет простые инструменты для редактирования файлов прямо с сервера. Откройте GUI через /ws:

• Переименовать файл или папку (клавиша 1)
• Заархивировать папку (клавиша 2)
• Распаковать архив (клавиша 4)
• Удалить файл или папку (клавиша 3)

Также вы сразу видите информацию о файле: размер, тип (подсвечен цветом предмета), дату последнего изменения и путь.

Интеграция с ресурспаками

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

1. Скопируйте путь к папке или архиву ресурспака
2. Введите команду /ws texturepack "<путь>" <цель>
3. Игроки должны принять ресурспак при первом подключении

Можно принудительно заставить игроков использовать ресурспак, добавив true в конец команды: /ws texturepack "rp/test" @a true

Техническая информация и настройка

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

Важно: каждое действие защищено отдельным разрешением (permission), чтобы обезопасить ваши файлы. OP обходит все разрешения! Рекомендуется использовать менеджер прав вроде LuckPerms.

Если вы не хотите видеть IP-адрес в ссылке, используйте прокси-сервер (например, nginx) и пропишите его в конфиге MWeb.

API

Хотите использовать возможности MWeb в своём плагине или моде? API позволяет создавать и управлять ссылками, а также динамически формировать и отправлять ресурспаки. Лучше всего работать с API через Kotlin (Java тоже поддерживается, но менее удобно).

dependencies {
    compileOnly("de.miraculixx:mweb:1.1.0")
}

API находится в Maven Central. Не подключайте его как shade в свой проект!