CogWorks

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

CogWorks предоставляет инструменты для бесшовного управления плагинами и файлами сервера непосредственно из игры. Основная функциональность включает загрузку файлов из сети, поиск и установку дополнений через Modrinth, а также полноценный файловый менеджер с поддержкой графического интерфейса.

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

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

Проект находится в стадии Alpha, что подразумевает наличие потенциальных ошибок в работе. Для обеспечения стабильности и помощи в разработке автор рекомендует включать подробный вывод ошибок в консоль при обнаружении проблем.

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

При поиске и просмотре плагинов через Modrinth система генерирует сообщения с гиперссылками. Подчеркнутый текст в чате ведет на страницы проектов или конкретных версий дополнений, что упрощает процесс выбора подходящего ПО для сервера.

Механика установки через URL требует от пользователя предоставления прямой ссылки на скачивание файла. Плагин автоматически устанавливает расширение .jar и помещает файл в директорию ./plugins. Для корректной работы необходимо указывать именно ссылку на файл, а не на страницу описания проекта.

Система автоматического разрешения зависимостей (ADR) активируется при запуске сервера. Если плагин обнаруживает отсутствие необходимых компонентов, он ищет их на Modrinth, скачивает в временную папку, проверяет соответствие имен и перемещает в основную директорию плагинов. Если совпадение не найдено, повторные попытки не предпринимаются.

Удаление плагинов через команду /plugin remove сопровождается интеллектуальной проверкой. Система анализирует наличие конфигурационных папок и проверяет, не зависят ли другие установленные дополнения от удаляемого проекта. В случае обнаружения зависимостей пользователю предлагается выбор: удалить только целевой плагин, удалить его вместе со всеми зависимыми проектами или отменить операцию.

Удаленные файлы не стираются мгновенно, а перемещаются в специальную директорию для восстановления. Это позволяет вернуть данные в случае ошибки. Время хранения и максимальный объем папки с удаленными файлами настраиваются в конфигурации, позволяя гибко управлять местом на диске.

Графический файловый менеджер (GUI) визуализирует структуру папок с помощью шерсти: белая шерсть обозначает файлы, а желтая — папки. В этом режиме реализованы инструменты для навигации, просмотра содержимого (с возможностью прокрутки и поиска по фразам), создания новых объектов и редактирования текста через интерфейс наковальни.

Для редактирования файлов в GUI используется система слотов: нажатие на пустой слот в строке открывает наковальню для добавления текста, а нажатие на существующий текст позволяет изменить его содержимое. Удаление объектов в GUI происходит в специальном режиме, при котором визуальные индикаторы меняют цвет на оранжевый и красный соответственно.

Плагин поддерживает систему прав доступа (permissions), позволяя гибко распределять полномочия между администраторами. Разделение прав идет на уровни: общая установка по URL, поиск и установка через Modrinth, управление правами на чтение, редактирование, создание и удаление файлов, а также восстановление удаленных данных.

Настройки конфигурации позволяют адаптировать поведение плагина под нужды сервера. Можно выбрать файл локализации, включить или выключить автоматическое разрешение зависимостей (ADR), настроить отображение сводки критических ошибок для операторов при входе в игру и задать параметры очистки корзины удаленных файлов.

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

Для корректной работы команды /plugin install необходимо использовать прямые ссылки на файлы, заканчивающиеся на .jar. Ссылки на веб-страницы или страницы описания плагинов не будут обработаны.

Может ли плагин редактировать любые файлы на компьютере?
Плагин может получить доступ только к тем файлам и папкам, чей абсолютный путь начинается с пути к папке сервера.

Можно ли восстановить случайно удаленный файл?
Удаленные файлы хранятся в папке .data/deletePending до тех пор, пока не истечет установленное время или не будет превышен лимит размера.

Можно ли ограничить доступ к файловому менеджеру?
Да, плагин поддерживает систему прав доступа, включая отдельные права на чтение, редактирование, создание и удаление файлов.