Docs / Inicio

Documentación de EnginePlugins

Especificaciones técnicas y guía de configuración desarrollada por sasukelol21.

EnginePlugins es una suite modular orientada al rendimiento para servidores Paper, Purpur y Spigot. El código está diseñado de forma asíncrona, preparado para Java 25 y compatible con Minecraft 1.21.x hasta 26.3.

CE ChatEngine (v1.3.0)

Canales de chat, menciones directas con audio (@Player), filtros de moderación y formato RGB.

GE GUIEngine

Motor base e interfaz de inventarios optimizado para la creación de menús interactivos.

PE PollEngine (v2.0.0)

Encuestas interactivas con interfaz gráfica (GUI), conteo en vivo y anuncio automático de ganadores.

ME MotdEngine (v2.0.0)

Lista de servidores con rotación asíncrona, menú hover multilínea y modo mantenimiento.

Estructura y Diseño

  • Sin dependencias externas: Plugins autónomos listos para colocar en la carpeta plugins/.
  • Formato universal: Soporte de sintaxis MiniMessage y códigos tradicionales con ampersand (&).
  • Bajo consumo: Las tareas de parseo y cálculo corren fuera del hilo principal del servidor.

Instalación

Requisitos de entorno y proceso de despliegue.

Requisitos

  • Minecraft: 1.21.x – 26.3
  • Software: Paper (recomendado), Purpur, Spigot
  • Java Runtime: Java 25 (o Java 21)

Instalación

  1. Descarga el archivo .jar desde el repositorio oficial en Modrinth.
  2. Mueve el archivo al directorio plugins/ de tu servidor.
  3. Inicia el servidor para generar los archivos de configuración predeterminados.
  4. Modifica los archivos config.yml según las necesidades de tu red.
Toolchain Java 25: Compilado con bytecode version 69, garantizando compatibilidad nativa con Minecraft 26.3.
ChatEngine

ChatEngine

Gestor de chat con canales, menciones y moderación (v1.3.0).
Descargar ChatEngine en Modrinth ↗

Características

  • Canales: Soporte de ámbitos GLOBAL, WORLD o personalizados en channels.yml.
  • Menciones: Etiqueta jugadores con @Nombre, aplicando resaltado y alerta de sonido.
  • Filtros: Detección de enlaces, palabras restringidas y control de repetición.
  • LuckPerms: Consulta prefijos, sufijos y grupos primarios en tiempo real.
  • Java 25 Nativo: Arquitectura asíncrona compatible con Minecraft 1.21.x hasta 26.3.

Compatibilidad de Versiones

Versión Plugin Versiones Minecraft Soportadas Java Estado
1.3.0 (Última) 1.21.x – 26.3 (Paper, Purpur, Spigot) Java 21 – 25+ Estable
1.2.1 1.21.0 – 1.21.4 Java 21 Soportada
1.1.0 1.21.0 – 1.21.1 Java 21 Heredada
1.0.0 1.20.4 – 1.21.0 Java 17 – 21 Descontinuada

Comandos

Comando Permiso Función
/chatengine reload chatengine.admin.reload Recarga las configuraciones y canales.
/chatengine clearchat chatengine.admin.clearchat Limpia el chat del servidor para todos los jugadores.
/chatengine mutechat chatengine.admin.mutechat Mutea o desmutea el chat global.
/channel [canal] [mensaje] Variable Cambia de canal activo o envía un mensaje rápido.

Configuración Principal (config.yml)

Archivo de configuración generado automáticamente en plugins/ChatEngine/config.yml:

Configuración de Canales (channels.yml)

Permite definir canales de chat independientes en plugins/ChatEngine/channels.yml:

Lista Completa de Permisos

Permiso Por Defecto Descripción
chatengine.admin OP Acceso total a todos los comandos de ChatEngine.
chatengine.admin.reload OP Permite recargar archivos de configuración.
chatengine.admin.clearchat OP Permite limpiar el chat global.
chatengine.admin.mutechat OP Permite silenciar o habilitar el chat global.
chatengine.bypass.cooldown OP Omite el tiempo de espera entre mensajes.
chatengine.bypass.repeat OP Omite el bloqueo de mensajes repetidos.
chatengine.bypass.moderation OP Omite los filtros de palabras y enlaces prohibidos.
chatengine.mentions true Permite mencionar a otros usuarios con @Jugador.
chatcolor.color.legacy OP Permite usar códigos clásicos (&0-&f).
chatcolor.color.hex OP Permite usar colores hexadecimales (&#RRGGBB).

Placeholders Soportados

Placeholder Descripción
{player} Nombre del jugador que envía el mensaje.
{prefix} Prefijo del jugador obtenido de LuckPerms o Vault.
{suffix} Sufijo del jugador obtenido de LuckPerms o Vault.
{world} Nombre del mundo en el que se encuentra el jugador.
{message} Contenido del mensaje enviado.
PlaceholderAPI Soporte total para cualquier placeholder de PAPI.

Registro de Cambios (Logs)

Versión Detalles del Cambio
1.3.0 Compilado y optimizado para Java 25 (bytecode 69) y Minecraft 1.21.x-26.3. Pipeline de procesamiento asíncrono y sistema de menciones @player con alertas sonoras.
1.2.1 Integración nativa con LuckPerms y PlaceholderAPI. Soporte para formato MiniMessage y gradientes hexadecimales RGB.
1.1.0 Soporte multicanal personalizable mediante channels.yml y rangos de chat por mundo.
1.0.0 Versión inicial con moderación (/clearchat, /mutechat) y filtro anti-spam.
GUIEngine

GUIEngine

Framework de interfaces de inventario y menús interactivos.
Descargar GUIEngine en Modrinth ↗

Características

  • Motor de Menús Seguro: Previene la extracción, duplicación o movimiento indebido de ítems en interfaces.
  • Renderizado de Componentes: Soporte directo de texto Adventure y MiniMessage en nombres y descripciones.
  • Modular: Diseñado para servir como base para sistemas de tiendas, selección de modalidad y votaciones.
  • Gestión de Eventos Automática: Cancelación de eventos no deseados en clics rápidos o atajos de teclado.

Compatibilidad de Versiones

Versión Plugin Versiones Minecraft Soportadas Java Estado
1.0.0 (Core) 1.21.x – 26.3 (Paper, Purpur, Spigot) Java 21 – 25+ Estable

Seguridad y Protección Antidupe

GUIEngine implementa una capa estricta de validación sobre el ciclo de vida de los inventarios:

  • Cancelación Obligatoria: InventoryClickEvent y InventoryDragEvent están blindados contra robos de ítems.
  • Control de Cierre: Manejo seguro con InventoryCloseEvent para limpieza de memoria.
  • Prevención de Clicks Fantasma: Verificación por identificador único (UUID) en cada sesión.

Ejemplo de Integración (API para Desarrolladores)

Ejemplo de creación de un menú interactivo protegido con callbacks usando la API de GUIEngine:

Registro de Cambios (Logs)

Versión Detalles del Cambio
1.0.0 Lanzamiento del motor central. Protección contra robo de ítems en GUI, compatibilidad con Adventure API y callbacks asíncronos para clics en inventarios.
PollEngine

PollEngine

Sistema de encuestas interactivas con interfaz gráfica (v2.0.0).
Descargar PollEngine en Modrinth ↗

Características

  • Interfaz GUI Interactiva: Los usuarios votan haciendo clic en el menú sin tener que escribir comandos complejos.
  • Temporizador y Anuncio Automático: Cuenta atrás configurable con anuncio en el chat y pantalla al terminar.
  • Cambio de Voto Flexible: Opción para permitir a los jugadores rectificar su elección mientras la encuesta siga activa.
  • Recuento en Vivo: Consulta los porcentajes y votos totales en cualquier momento con /poll results.

Compatibilidad de Versiones

Versión Plugin Versiones Minecraft Soportadas Java Estado
2.0.0 (Última) 1.21.x – 26.3 (Paper, Purpur, Spigot) Java 21 – 25+ Estable
1.0.0 1.20.x – 1.21.2 Java 17 – 21 Descontinuada

Configuración Principal (config.yml)

Configuración completa con soporte de sonidos, mensajes y temporizador en plugins/PollEngine/config.yml:

Creación de Encuestas

Sintaxis del comando para administradores:

Comandos

Comando Permiso Función
/poll (o /poll vote) pollengine.vote Abre el menú interactivo para votar.
/poll results Todos Muestra el recuento de la encuesta actual o previa.
/poll start <...> pollengine.admin.start Inicia una votación con temporizador.
/poll end pollengine.admin.end Cierra la encuesta y anuncia al ganador.
/poll reload pollengine.admin.reload Recarga el archivo config.yml.

Permisos

Permiso Por Defecto Descripción
pollengine.vote true Permite abrir el menú y emitir un voto en encuestas activas.
pollengine.admin OP Acceso administrativo completo a PollEngine.
pollengine.admin.start OP Permite iniciar nuevas encuestas.
pollengine.admin.end OP Permite finalizar manualmente una encuesta activa.
pollengine.admin.reload OP Permite recargar la configuración del plugin.

Registro de Cambios (Logs)

Versión Detalles del Cambio
2.0.0 Reescritura completa para Java 25 y Paper 26.3. Menú de votación en GUI con recuento en tiempo real, soporte de cambio de voto y anuncio de resultados automatizado.
1.0.0 Versión inicial de encuestas por chat con temporizador básico.
MotdEngine

MotdEngine

Personalizador de servidor, lista de jugadores y mantenimiento (v2.0.0).
Descargar MotdEngine en Modrinth ↗

Modos de Operación

  • ROTATING: Rotación periódica asíncrona cada X segundos.
  • RANDOM: Selecciona un mensaje al azar en cada ping.
  • STATIC: Muestra un único mensaje fijo.

Compatibilidad de Versiones

Versión Plugin Versiones Minecraft Soportadas Java Estado
2.0.0 (Última) 1.21.x – 26.3 (Paper, Purpur, Spigot) Java 21 – 25+ Estable
1.0.0 1.20.x – 1.21.1 Java 17 – 21 Descontinuada

Configuración Principal (config.yml)

Configuración completa para MOTD, hover de jugadores y mantenimiento en plugins/MotdEngine/config.yml:

Comandos

Comando Permiso Función
/motd maintenance [on|off] motdengine.admin Activa o desactiva el mantenimiento.
/motd preview motdengine.admin Muestra en el chat el MOTD activo.
/motd set <mensaje> motdengine.admin Configura un mensaje estático directo.
/motd reload motdengine.admin Recarga configuraciones y mensajes.

Permisos

Permiso Por Defecto Descripción
motdengine.admin OP Permite usar todos los comandos administrativos de /motd.
motdengine.maintenance.bypass OP Permite conectarse y jugar en el servidor mientras el modo mantenimiento esté activado.

Registro de Cambios (Logs)

Versión Detalles del Cambio
2.0.0 Adaptación completa a Java 25 y Paper Profile API (ServerListPingEvent). Modos ROTATING, RANDOM y STATIC. Modo de mantenimiento con bypass para administradores y hover personalizado.
1.0.0 Lanzamiento inicial de gestor de mensajes MOTD para la lista de servidores.

Formatos y Colores

Sintaxis compatible entre todos los módulos.
# Gradientes RGB (MiniMessage)
<gradient:#00FFAA:#00A2FF>Texto con degradado suave</gradient>

# Colores Hexadecimales
<#FFAA00>Texto Naranja Hex o &#FFAA00

# Efecto Rainbow
<rainbow>Texto con ciclo de color continuo</rainbow>

# Códigos tradicionales
&aVerde &bAqua &cRojo &eAmarillo
&lNegrita &oCursiva &nSubrayado &rReset

Preguntas Frecuentes

Resolución de dudas frecuentes.

¿Cómo configurar el acceso durante el mantenimiento?

Asigna el permiso motdengine.maintenance.bypass mediante tu plugin de permisos al grupo de administradores.

¿Se puede permitir el cambio de voto?

Sí, la clave allow-change-vote en el archivo config.yml de PollEngine habilita o deshabilita esta opción.