Plugin de Minecraft SCore

🔌 Acerca de SCore

SCore es el plugin núcleo/biblioteca creado por Ssomar para centralizar la funcionalidad compartida que se usa en toda su suite de plugins. Ofrece editores dentro del juego y funciones en tiempo de ejecución de las que dependen otros plugins de Ssomar, y también puede usarse de forma independiente para crear y ejecutar proyectiles personalizados, gestionar variables y ejecutar comandos personalizados empaquetados.

🎯 Propósito

SCore existe para proporcionar una base reutilizable para los autores de plugins (en concreto, la familia de plugins de Ssomar) para que las funciones se implementen una sola vez y puedan ser usadas por varios plugins. Está orientado a desarrolladores y administradores de servidores que ejecutan uno o más plugins de Ssomar o que quieren disponer de sus mecánicas reutilizables en su servidor.

⚙️ Funciones

• Editor dentro del juego para crear y editar proyectiles personalizados.
• Proyectiles personalizados en tiempo de ejecución que se pueden lanzar o activar.
• Variables globales y por jugador con tipos (NUMBER, STRING, LIST).
• Compatibilidad con placeholders para variables (tokens de placeholder para usar en otros plugins/configuraciones).
• Marco para ejecutar comandos empaquetados/personalizados accesible desde la consola del servidor u otros plugins.
• Diseñado para usarse como dependencia por otros plugins de Ssomar.

🧩 Para quién es

• Propietarios de servidores que usan plugins de Ssomar (ExecutableItems, ExecutableBlocks, etc.).
• Desarrolladores que necesitan una biblioteca reutilizable para proyectiles, variables y ejecución de comandos personalizados.
• Administradores que buscan editores ligeros dentro del servidor para esas funciones.

🏗️ Casos de uso de ejemplo

• Un servidor usa SCore junto con ExecutableItems para definir y lanzar comportamientos de proyectiles personalizados.
• Un administrador crea variables globales o por jugador y las expone como placeholders para menús u otros plugins.
• Un desarrollador de plugins depende de SCore para reutilizar el almacenamiento de variables y el empaquetado de comandos en varios plugins.

⌨️ Comandos

Notas: la documentación oficial también documenta tokens de placeholder para variables (por ejemplo, %score_variables_<var_name>% y %score_variables_<var_name>_int%). Los nodos de permiso no aparecen en los metadatos del plugin referenciado.

⚙️ Instalación

📥 Configuración

• Descarga el .jar oficial de SCore para la versión correspondiente del plugin.
• Coloca el archivo .jar en el directorio plugins/ del servidor.
• Reinicia el servidor y comprueba la consola para confirmar que SCore se cargó.
• Si ejecutas otros plugins de Ssomar, instala la build de SCore que coincida con el sufijo de versión de esos plugins, tal como recomienda el proyecto (emparejando la build de SCore con la build del plugin dependiente).

🧠 Notas técnicas

• Plataformas compatibles confirmadas: Bukkit, Spigot, Paper, Purpur, Folia.
• Las versiones de Minecraft compatibles confirmadas incluyen: de 1.21.x a 1.8.x (según indica el proyecto).
• Los metadatos del proyecto indican una etiqueta de licencia restrictiva (ARR / All Rights Reserved), mientras que la distribución del proyecto también hace referencia a un repositorio Git para contribuciones; estos elementos aparecen juntos en los metadatos oficiales.
• SCore está pensado para instalarse como biblioteca/dependencia de otros plugins de Ssomar; expone funciones que otros plugins llaman en tiempo de ejecución.

🤝 Cuándo es útil este plugin

Si usas plugins de Ssomar o necesitas un sistema listo para usar en el servidor para proyectiles personalizados y placeholders de variables, SCore proporciona el runtime compartido y los editores de los que dependen esos plugins sin que tengas que reimplementar las mismas mecánicas.