Плагін Minecraft SCore

🔌 Про SCore

SCore — це ядровий/бібліотечний плагін, створений Ssomar для централізації спільної функціональності, що використовується в усьому їхньому наборі плагінів. Він надає внутрішньоігрові редактори та функції під час роботи, на які спираються інші плагіни Ssomar, а також може використовуватися окремо для створення й запуску кастомних снарядів, керування змінними та виконання упакованих кастомних команд.

🎯 Призначення

SCore існує, щоб забезпечити повторно використовувану основу для авторів плагінів (зокрема для сімейства плагінів Ssomar), щоб функції реалізовувалися один раз і використовувалися кількома плагінами. Він орієнтований на розробників і адміністраторів серверів, які запускають один або кілька плагінів Ssomar або хочуть мати його повторно використовувані механіки на своєму сервері.

⚙️ Можливості

• Внутрішньоігровий редактор для створення та редагування кастомних снарядів.
• Кастомні снаряди під час роботи, які можна запускати або тригерити.
• Глобальні та персональні змінні з типами (NUMBER, STRING, LIST).
• Підтримка плейсхолдерів для змінних (токени placeholder для використання в інших плагінах/конфігураціях).
• Фреймворк виконання упакованих/кастомних команд, доступний із консолі сервера або інших плагінів.
• Розроблений для використання як залежність іншими плагінами Ssomar.

🧩 Для кого це

• Власники серверів, які запускають плагіни Ssomar (ExecutableItems, ExecutableBlocks тощо).
• Розробники, яким потрібна повторно використовувана бібліотека для снарядів, змінних і виконання кастомних команд.
• Адміністратори, які хочуть легкі внутрішньосерверні редактори для цих функцій.

🏗️ Приклади використання

• Сервер використовує SCore разом із ExecutableItems, щоб визначати й запускати поведінку кастомних снарядів.
• Адміністратор створює глобальні або персональні змінні та відкриває їх як плейсхолдери для меню чи інших плагінів.
• Розробник плагіна залежить від SCore, щоб повторно використовувати сховище змінних і пакування команд у кількох плагінах.

⌨️ Команди

Примітки: офіційна документація також описує токени плейсхолдерів для змінних (наприклад %score_variables_<var_name>% і %score_variables_<var_name>_int%). Ноди дозволів не вказані в метаданих згаданого плагіна.

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний .jar SCore для відповідної версії плагіна.
• Розмістіть файл .jar у каталозі plugins/ сервера.
• Перезапустіть сервер і перевірте консоль сервера, щоб переконатися, що SCore завантажився.
• Якщо ви використовуєте інші плагіни Ssomar, встановіть збірку SCore, що відповідає їхньому версійному суфіксу, як радить проєкт (зіставлення збірки SCore зі збіркою залежного плагіна).

🧠 Технічні примітки

• Підтверджені підтримувані платформи: Bukkit, Spigot, Paper, Purpur, Folia.
• Підтверджені версії Minecraft включають: 1.21.x до 1.8.x (за списком проєкту).
• Метадані проєкту містять позначку суворої ліцензії (ARR / All Rights Reserved), тоді як у розповсюдженні проєкту також згадується Git-репозиторій для внесків; ці елементи присутні разом в офіційних метаданих.
• SCore призначений для встановлення як бібліотека/залежність для інших плагінів Ssomar; він надає функції, які інші плагіни викликають під час роботи.

🤝 Коли цей плагін корисний

Якщо ви використовуєте плагіни Ssomar або вам потрібна готова внутрішньосерверна система для кастомних снарядів і плейсхолдерів змінних, SCore надає спільний runtime та редактори, на які спираються ці плагіни, без потреби реалізовувати ті самі механіки самостійно.