Плагин SimpleCloud API Plugin 0.1.0-platform.52 +0.1.0-platform.52

SimpleCloud API Plugin — библиотечный серверный проект для упрощённого доступа к API экосистемы SimpleCloud. Он не заявлен как самостоятельный игровой модуль: его задача — предоставить другим плагинам и разработкам общий платформенный компонент и уменьшить прежние проблемы с зависимостями.

В выбранной публикации подтверждены Velocity, Paper и Spigot, а также два JAR версии 0.1.0-platform.52: сборка для Velocity и legacy-сборка для Spigot. Поля сторон клиента и сервера не определены, хотя установка этих файлов относится к серверной папке plugins.

Назначение и роль​

Категория library описывает место проекта в инфраструктуре. Обычный игрок может не увидеть новых предметов или правил: результат зависит от программ, которые обращаются к SimpleCloud API.

Автор предлагает установить платформенный JAR на сервер, а нужный API подключать в разработке как provided-артефакт. Таким образом библиотека присутствует в среде выполнения и не должна без необходимости дублироваться внутри каждого зависимого плагина.

Скриншоты и внешний вид​

Текущее состояние возможностей​

В официальном перечне отмечены простой способ использования API и поддержка нескольких платформ. При этом пункт о доступе ко всем предоставляемым API через единый интерфейс ещё не отмечен как завершённый.

Поэтому текущий релиз нельзя считать окончательно завершённым универсальным слоем для всех функций. Наличие библиотеки также не гарантирует совместимость любого стороннего расширения с любой версией SimpleCloud. Нужные методы и артефакты следует сверять с версией, использованной разработчиком зависимого плагина.

Платформы и версии Minecraft​

В выбранных метаданных указаны Velocity, Paper и Spigot. Перечень охватывает 1.8.8 и 1.8.9, релизы 1.9–1.19.4 с указанными промежуточными обновлениями, ряд 1.20–1.20.6, версии 1.21–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2.

Широкий список не означает, что оба JAR взаимозаменяемы или что проверена каждая комбинация ядра, прокси и стороннего плагина. Сначала выбирают файл по платформе, затем сверяют версию сервера и требования интеграции.

Файлы релиза​

Для 0.1.0-platform.52 представлены:

• cloud-api-velocity.jar, 14 083 997 байт;
• cloud-api-spigot-legacy.jar, 14 705 904 байта.

Velocity-сборка предназначена для соответствующей прокси-платформы. Spigot legacy-сборка относится к серверному окружению Spigot и совместимому пути API. Устанавливать оба файла в одну среду без отдельного основания не следует.

Общее описание проекта упоминает также Folia, BungeeCord, Fabric, Quilt и NeoForge. Однако выбранная карточка содержит только два названных JAR, поэтому использовать их на других платформах нельзя лишь на основании этого списка.

Установка​

Подтверждённая процедура — поместить подходящий JAR в папку plugins совместимого сервера или прокси. Дополнительные команды и обязательные конфигурационные ключи не приведены.

Практический порядок:

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

Если сторонний плагин требует конкретную версию API, это требование важнее предположения о взаимозаменяемости релизов.

Подключение в разработке​

Официальный материал показывает варианты для Gradle Kotlin, Gradle Groovy и Maven. API предлагается объявлять как provided-зависимость, а значение версии разработчик подставляет самостоятельно. Универсальная готовая версия в примерах не зафиксирована.

Перед сборкой полезно:

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

Точные методы программного интерфейса в основе не раскрыты, поэтому примеры вызовов здесь не приводятся.

Ограничение для Paper​

Автор отдельно предупреждает, что Paper-специфичный API экспериментален и нестабилен. Для сервера Paper рекомендуется использовать Spigot API.

Перед обновлением следует установить, использует ли зависимый плагин общие Spigot-интерфейсы или экспериментальные Paper-методы. Для рабочей среды разумно сохранять предыдущий комплект и проверять новую комбинацию отдельно.

В выбранных файлах нет артефакта с отдельным названием Paper. Переименовывать Spigot-сборку или придумывать отсутствующий файл не требуется.

Зависимости и стороны​

В выбранных метаданных обязательные project dependencies не указаны. Это относится к двум опубликованным файлам и не распространяется автоматически на плагины, использующие SimpleCloud API Plugin.

Поля client=unknown и server=unknown означают отсутствие определённой классификации сторон. Они не подтверждают клиентскую установку и не отменяют серверную инструкцию для JAR.

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

Практическое внедрение​

Библиотечный компонент лучше обновлять согласованно с зависимыми плагинами. Минимальный сценарий контроля:

• записать версии сервера, прокси, SimpleCloud и расширений;
• удалить дублирующиеся редакции API из тестовой среды;
• выбрать Velocity- или Spigot-файл;
• выполнить чистый запуск;
• проверить ошибки классов и зависимостей;
• протестировать используемые функции;
• сравнить журнал с предыдущей рабочей версией;
• предусмотреть возврат к сохранённому комплекту.

Такая последовательность помогает локализовать проблему, но не гарантирует безошибочную работу.

Хеши и статическая проверка​

Для cloud-api-velocity.jar SHA-1 равен b7b73af6e755831f22c293064c0343bebdc291a1, SHA-512 — 3471abb6228f146cdf088dd524577d03d0dd5b41a933d24b7ebaa0f6903b9d2624ed61be66bd9c86252fbb4e7efb92ba9b91b6e4fa0719b28d39f164cfa71b0e.

Для cloud-api-spigot-legacy.jar опубликованы SHA-1 a16671c18bd78e232e3dd7de3b7d4fdce8a03461 и SHA-512 a7b1d1f6efa2170de0a4e5e1689144384fd9c0fbe65045b0a6562043680e9cceb85ba2fdb6191e7b6bc4cd31c8ae9c8a452b0b6f95ab9ac95c7f1f66e5e10a04.

Оба файла получены по официальному HTTPS, сверены с опубликованными хешами и статически проверены по структуре и путям. Динамический запуск не выполнялся.

Лицензия и пределы выводов​

Проект распространяется по Apache-2.0. При создании собственного плагина необходимо учитывать также лицензии SimpleCloud, подключаемых API и других библиотек.

Сведения не позволяют обещать стабильность экспериментального Paper API, совместимость со всеми платформами из общего описания или автоматическое исправление проблем стороннего кода.

Безопасная проверка​

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

FAQ​

Какой файл нужен для Velocity?​

Используется cloud-api-velocity.jar. Spigot legacy-сборка предназначена для другого окружения.

Что выбирать на Paper?​

Официальная рекомендация — использовать Spigot API, поскольку Paper-специфичный API обозначен как экспериментальный и нестабильный.

Есть ли обязательные зависимости?​

В выбранных метаданных они не указаны. У плагинов, обращающихся к API, могут быть собственные требования.

Нужно ли ставить JAR игрокам?​

Клиентская сторона не определена. Подтверждённая инструкция касается установки выбранного JAR на сервер или прокси в plugins.

Проводился ли динамический тест?​

Нет. Выполнены получение по официальному HTTPS, сверка хешей и статическая проверка структуры.