Plugin de Minecraft DiscordSRV

🔌 Acerca de DiscordSRV

DiscordSRV es un plugin de Minecraft que conecta un servidor de Minecraft y un servidor de Discord. Reenvía el chat del juego a Discord (y los mensajes de Discord al juego), admite la vinculación de cuentas entre cuentas de Minecraft y de Discord, y proporciona ganchos de sincronización para roles/grupos y varios eventos del servidor.

🎯 Propósito

El objetivo principal de DiscordSRV es ofrecer un puente fiable y configurable entre un servidor de Minecraft y Discord para que las comunidades puedan comunicarse en ambas plataformas, mantener informado al personal y sincronizar la información de membresía/roles cuando se configure.

⚙️ Características

• Sincronización bidireccional del chat entre canales de Minecraft y Discord (configurable por canal).
• Vinculación de cuentas Minecraft <-> Discord para jugadores.
• Ganchos de sincronización de roles/grupos (puntos de integración para plugins de permisos como LuckPerms).
• Mensajes de broadcast y del personal desde Minecraft a Discord.
• Comandos para vincular, comprobar el estado del vínculo y acciones administrativas (reload, resync, debug).
• Varios archivos de configuración para el mapeo de canales, idioma/mensajes, sincronización y funciones de voz.
• Código de código abierto con un rastreador público de issues y lanzamientos.

🧩 Para quién es

• Propietarios y administradores de servidores que quieren unificar el chat de la comunidad entre Minecraft y Discord.
• Equipos de moderación que necesitan visibilidad de los eventos del servidor en Discord.
• Redes que usan plugins de permisos y quieren sincronización de roles o grupos con Discord.

🏗️ Casos de uso de ejemplo

• Reenviar el chat global o por canal de Minecraft a canales específicos de Discord para que los usuarios fuera del servidor sigan las conversaciones.
• Vincular cuentas de jugadores a IDs de Discord para conceder roles de Discord o verificar usuarios entre plataformas.
• Enviar registros de entrada/salida/consola del servidor a un canal de moderación de Discord.

⌨️ Comandos

Subcomandos de jugador:

Comandos del personal:

(Los comandos obsoletos relacionados con el antiguo sistema de suscripción están documentados en el historial, pero se han eliminado del funcionamiento actual.)

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el .jar oficial de DiscordSRV desde una distribución oficial (página del proyecto / catálogo / lanzamientos).
• Coloca el jar en la carpeta plugins/ de tu servidor, para un servidor compatible con Bukkit/Spigot.
• Reinicia el servidor y revisa los registros de la consola para confirmar que DiscordSRV se cargó.
• Completa la configuración inicial (token del bot, asignación de canales, opciones de vinculación) usando los archivos de configuración generados.

📦 Archivos de configuración

DiscordSRV usa varios archivos de configuración; los nombres confirmados incluyen:

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Edita los archivos adecuados para establecer el token del bot de Discord, la asignación de canales y los ajustes de sincronización. Algunas funciones (sincronización de roles/grupos, integración de voz) requieren configuración adicional.

🧠 Notas técnicas

• El código fuente y los lanzamientos se mantienen en un repositorio público.
• El proyecto se publica bajo GPL-3.0.
• Las integraciones opcionales confirmadas incluyen LuckPerms (contexts/sincronización de grupos) y PlaceholderAPI (placeholders).
• Los comandos y permisos están documentados en la documentación oficial; existen operaciones administrativas como resync y reload y pueden requerir privilegios de operador.

🤝 Cuándo es útil este plugin

Si necesitas chat bidireccional consistente y configurable, además de vinculación de cuentas entre un servidor de Minecraft y una comunidad de Discord, DiscordSRV ofrece el puente, los ganchos de integración y los archivos de configuración para operar esas funciones mientras se integra con plugins comunes del servidor.