- Документация
- https://modrinth.com/plugin/skonic
Назначение
Skonic — серверный плагин-дополнение для Skript, расширяющий существующие плагины и выражения. В опубликованном описании выделены три направления: Citizens, головы игроков и данные скинов. Клиентская сторона помечена как неподдерживаемая, серверная — как обязательная. Проект распространяется по лицензии Apache-2.0, автор выбранных версий — NagasonicDev.
Skonic не вводит самостоятельный игровой режим. Он предоставляет элементы, из которых администратор собирает Skript-сценарии: NPC-механики, декоративные головы, получение и обработку сведений о скинах. Итоговое поведение зависит от написанных скриптов и связанных компонентов сервера.
Скриншоты и внешний вид
Для кого предназначен
Проект подходит администраторам, которые уже используют Skript и хотят связать его с дополнительными игровыми объектами. Практические сценарии:
• квесты и лобби с NPC;
• выдача или анализ голов игроков;
• косметические функции на основе скинов;
• небольшие механики без отдельной разработки Java-плагина;
• постепенное расширение существующих Skript-сценариев.
Если сборка не использует Skript, польза Skonic ограничена. Он также не заменяет полноценную систему NPC, редактор сценариев или отдельное хранилище скинов.
Подтверждённые функции
Для голов игроков заявлено получение головы по значению, имени, адресу, UUID или объекту игрока, а также определение владельца. Интеграция с Citizens включает создание NPC с типом сущности и именем, назначение скина по имени или адресу, атаку цели, получение сущности и идентификатора NPC, удаление, выгрузку и повторное появление ранее созданного NPC, обращение к последнему созданному NPC и чтение имени.
Раздел скинов охватывает загрузку и получение скина игрока, чтение подписи и значения, поиск по UUID и формирование скина из значения с подписью. Это перечень доступных операций, а не готовые игровые сценарии: права, условия запуска и обработка ошибок задаются отдельно.
Совместимость
В метаданных перечислены Bukkit, Paper, Purpur и Spigot. Подтверждённые версии Minecraft охватывают 1.19–1.19.4, 1.20–1.20.6, 1.21–1.21.11, а также обозначения 26.1, 26.1.1, 26.1.2 и 26.2. Этот перечень относится к проекту в целом и не гарантирует, что любой отдельный JAR подходит ко всем перечисленным выпускам.
Перед установкой сопоставляют:
• версию Minecraft и серверного ядра;
• конкретную версию Skonic;
• версию Skript;
• версию компонента, с которым работает сценарий;
• синтаксис уже используемых скриптов.
Обязательные project dependencies в выбранных метаданных не указаны. Однако Skonic прямо назван аддоном Skript, а часть функций относится к Citizens. Поэтому отсутствие формально перечисленной зависимости не означает автономную работу всех выражений. Поддерживаемые версии базовых компонентов в исходной основе не уточнены.
Файлы и хеши
Зафиксированы два артефакта:
• Skonic-1.2.8-b1.jar, версия 1.2.8-b1, 401337 байт;
• Skonic-1.2.8.jar, версия 1.2.8, 269460 байт.
Для 1.2.8-b1 опубликован SHA-512 6867e76b20afaa2d3ffdb2d3628e46eb14288086638003da1d8d071abe1679114d9ef3c9422dfde6ecb6a309772374b565b762a3e5f265ef0e6d93ebdb45e088, SHA-1 699be2d5ef68e0d8e8c4f33122a7a39a1fe67c03.
Для 1.2.8 опубликован SHA-512 1646d133a17257c9cacc9d8e24f018961335c4f8624e9847a0d3d64b1d6a00e984c53afe0d9952d8abc38afc21453f6a0a71b857a1f24a5b1be0c4a15f6f56c9, SHA-1 22f3a5a4c1a5ac712284e6521bf027947a2bbd11.
Файлы получены по официальному HTTPS, локально сверены по хешам и статически проверены по структуре. Динамический запуск не проводился. Совпадение хеша подтверждает идентичность артефакта, но не совместимость с конкретной сборкой.
Установка и первичная проверка
JAR помещают в папку plugins совместимого сервера. Рекомендуемая последовательность:
• остановить сервер;
• сохранить текущий JAR, скрипты и связанные данные;
• проверить имя, размер и хеш нового файла;
• убрать прежнюю версию, не оставляя два JAR одновременно;
• скопировать выбранный файл в plugins;
• запустить сервер и проверить журнал;
• выполнить изолированные тесты.
Горячая замена усложняет диагностику, поэтому предпочтителен полный перезапуск. После старта нужно проверить не только наличие Skonic в списке плагинов, но и загрузку простого Skript-сценария. Затем отдельно тестируют одну операцию с головой, создание и удаление тестового NPC, получение скина и повторный запуск сервера.
Для Citizens полезны отрицательные тесты: обращение к отсутствующему NPC, уже удалённому объекту и недоступной сущности. Для скинов — неизвестный UUID, пустое значение и недоступные данные. Ожидаемую реакцию должен задавать скрипт.
Ограничения
Skonic увеличивает число связей между Skript, ядром и интегрируемыми плагинами. Ошибка может находиться в любом из этих слоёв. В предоставленных данных не описаны производительность при массовом создании NPC, лимиты параллельной загрузки скинов и правила миграции между 1.2.8-b1 и 1.2.8.
Следует учитывать:
• список версий проекта не равен гарантии для каждой комбинации;
• клиентская установка не поддерживается;
• будущие функции нельзя считать уже реализованными;
• статическая проверка JAR не заменяет запуск;
• внешние значения, UUID и адреса требуют проверки в сценарии;
• частые операции желательно ограничивать и журналировать.
Безопасное обновление
Обновление сначала проверяют на копии сервера. До замены сохраняют предыдущий JAR, Skript-файлы, данные связанных плагинов и журнал последнего успешного запуска. На тестовой копии повторяют ключевые сценарии: загрузку скриптов, работу с головой, жизненный цикл NPC, получение скина и перезапуск.
По предоставленной основе нельзя определить точное соотношение сборок 1.2.8-b1 и 1.2.8, совместимость их синтаксиса и назначение суффикса b1. Поэтому выбирать файл только по имени или размеру не следует.
Откат
План отката готовят заранее. Минимальный комплект состоит из прежнего JAR, копии скриптов, связанных данных и сведений о версии ядра. При проблеме сервер останавливают, новый файл удаляют, возвращают прежний и восстанавливают изменённые материалы.
После запуска проверяют, что загружен один экземпляр Skonic и прежние тесты снова проходят. Если новый сценарий успел создать NPC или изменить связанные данные, одного возврата JAR может быть недостаточно: такие объекты проверяют отдельно.
Диагностика
Разбор начинают с первой ошибки в журнале. Рабочий порядок:
• зафиксировать версии Minecraft, ядра, Java, Skript и Skonic;
• исключить дубли JAR;
• оставить минимальный тестовый сценарий;
• проверить распознавание одного выражения;
• повторить запуск без сторонних скриптов;
• отдельно протестировать Citizens, головы и скины;
• сравнить результат с чистой тестовой копией.
Если простое выражение работает, а сложный сценарий нет, вероятная область поиска — условия, типы данных или последовательность действий. Если Skonic не загружается, сначала проверяют совместимость, целостность файла и первую причину отказа в журнале.
Лицензия
Skonic опубликован под Apache-2.0. При локализации и переработке необходимо сохранять название проекта, авторство и лицензионную информацию. Рекомендации по резервному копированию и тестированию являются редакционными и не должны приписываться автору.
FAQ
Требуется ли установка игрокам?
Нет. Метаданные указывают обязательную серверную сторону и неподдерживаемую клиентскую. Иные требования могут исходить только от других компонентов сборки.
Заменяет ли Skonic Citizens?
Нет. Описаны Skript-операции, связанные с Citizens, но не самостоятельная реализация полной NPC-системы.
Какой JAR выбрать?
Нужно сопоставить версию с ядром и проверить файл на копии. Одних названий недостаточно.
Почему совпавший хеш не гарантирует запуск?
Хеш подтверждает идентичность файла опубликованному артефакту, но не совместимость с версиями Java, ядра, Skript, Citizens и пользовательских сценариев.
Можно ли обновить без остановки?
Для контролируемого результата предпочтительны остановка, замена единственного JAR и полный запуск с проверкой журнала.
Что тестировать первым?
Сначала загрузку плагина и минимального скрипта, затем по одной функции для голов, Citizens и скинов. Массовые сценарии включают позже.
