Cómo integrar tu guild de MU Online con Discord y bots

Discord se convirtió en el centro de comunicación de prácticamente toda guild activa de MU Online, pero la mayoría lo trata como un chat genérico, desconectado de lo que realmente pasa dentro del juego. Un Discord bien integrado sabe quién está en la guild en tiempo real, avisa sobre boss y eventos automáticamente, muestra el ranking de reset de los miembros y notifica ataques de Castle Siege sin que nadie tenga que escribir nada manualmente. Este tutorial muestra cómo estructurar ese Discord, elegir entre bots listos y bot propio, sincronizar miembros y cargos con la base del MuServer, y configurar las alertas más valiosas para una guild competitiva.

Por qué integrar (y no solo usar un Discord genérico)

Un servidor de Discord sin integración depende de que alguien recuerde avisar sobre el boss, actualizar manualmente quién entró o salió de la guild, y revisar el ranking en el sitio aparte. Eso funciona en guilds pequeñas, pero no escala. Una integración básica con la base del juego resuelve las tres mayores fricciones: presencia desactualizada, falta de alerta automática y ranking manual.

Estructura recomendada de canales

Paso 1 — Elegir entre bot listo y bot propio

Los bots genéricos (MEE6, Carl-bot, Dyno) cubren bien la moderación, cargos por reacción y bienvenidas, pero no tienen acceso a los datos de tu MuServer. Para presencia de guild, ranking y alertas de boss, necesitas un bot propio (discord.js o discord.py) conectado a una API que consulta la base del juego con permiso de lectura.

Paso 2 — Crear la aplicación del bot en Discord

1. Accede al Portal de Desarrolladores de Discord y crea una nueva aplicación.
2. En la pestaña Bot, genera el token y guárdalo como variable de entorno, nunca en el código.
3. Invita al bot al servidor con los permisos mínimos necesarios: gestionar cargos, enviar mensajes, leer historial.

# .env del bot
DISCORD_TOKEN=tu-token-aqui
API_MU_BASE_URL=https://tuservidor.com/api

Paso 3 — Exponer una API propia sobre la base del MuServer

Nunca conectes el bot directamente a la base de producción del juego. Crea endpoints dedicados, solo lectura:

<?php
// api/guild_membros.php
header('Content-Type: application/json');
$guildName = $_GET['guild'] ?? '';
$membros = consultarMembrosGuild($guildName); // SELECT Name, cLevel, Resets FROM Character WHERE G_Name = ?
echo json_encode($membros);

Paso 4 — Sincronizar miembros y cargos automáticamente

Corre una rutina periódica en el bot que compare la lista de miembros de la guild en el juego con quién tiene el cargo correspondiente en Discord, aplicando y removiendo cargos según corresponda:

async function sincronizarCargosGuild() {
  const membrosJogo = await fetch(`${API_BASE}/guild_membros.php?guild=Legends`).then(r => r.json());
  const guild = client.guilds.cache.get(GUILD_DISCORD_ID);
  const cargoGuild = guild.roles.cache.find(r => r.name === 'Legends');

  for (const membro of guild.members.cache.values()) {
    const estaNaGuildJogo = membrosJogo.some(m => m.discordId === membro.id);
    if (estaNaGuildJogo && !membro.roles.cache.has(cargoGuild.id)) {
      await membro.roles.add(cargoGuild);
    } else if (!estaNaGuildJogo && membro.roles.cache.has(cargoGuild.id)) {
      await membro.roles.remove(cargoGuild);
    }
  }
}

setInterval(sincronizarCargosGuild, 10 * 60 * 1000); // cada 10 minutos

La vinculación entre la cuenta de Discord y el personaje in-game debe existir previamente, normalmente vía un comando de vínculo (/vincular <nombredelpersonaje>) que graba la relación en una tabla propia.

Paso 5 — Alertas automáticas de boss

Para bosses con horario fijo, una programación simple resuelve el problema:

const bossSchedule = [
  { nome: 'Kundun', horario: '20:00' },
  { nome: 'Selupan', horario: '21:30' },
];

cron.schedule('*/1 * * * *', () => {
  const agora = formatarHoraAtual();
  const bossAgora = bossSchedule.find(b => proximoDe(b.horario, agora, 5)); // 5 min antes
  if (bossAgora) {
    canalBossAlertas.send(`⚔️ **${bossAgora.nome}** nace en 5 minutos! Prepárense.`);
  }
});

Para bosses con spawn dentro de una ventana aleatoria, consulta la tabla de monstruos activos del GameServer (si tu emulador expone esa información) o trátalo como aviso de ventana ("Kundun puede nacer entre las 20h y las 20h30").

Paso 6 — Notificación de Castle Siege

Castle Siege es el evento más competitivo del juego, y vale la pena un canal dedicado con notificaciones de inicio de inscripción, inicio de la guerra y resultado final:

async function notificarCastleSiege(status) {
  const embed = new EmbedBuilder()
    .setTitle('🏰 Castle Siege')
    .setDescription(status.mensagem)
    .addFields({ name: 'Guild actual dueña del castillo', value: status.guildDona })
    .setColor(status.emGuerra ? 0xff0000 : 0x00ff00);
  canalCastleSiege.send({ embeds: [embed] });
}

Dispara esta función desde un script que monitorea el estado del Castle Siege en la base del juego o vía webhook disparado por el propio GameServer, si el emulador lo soporta.

Paso 7 — Ranking de reset actualizado en Discord

Publica un ranking automático de los miembros de la guild, actualizado periódicamente, en lugar de depender del sitio:

async function publicarRanking() {
  const membros = await fetch(`${API_BASE}/guild_membros.php?guild=Legends`).then(r => r.json());
  const ordenado = membros.sort((a, b) => b.resets - a.resets).slice(0, 10);
  const texto = ordenado.map((m, i) => `${i + 1}. **${m.nome}** — Reset ${m.resets}, Lv ${m.nivel}`).join('\n');
  canalRanking.send(`📊 **Ranking de la Guild — actualizado ahora**\n${texto}`);
}

Paso 8 — Comandos útiles para los miembros

Ofrece comandos de barra (slash commands) para autoservicio, reduciendo preguntas repetidas en el chat:

Errores comunes y soluciones

Lista de verificación de integración de la guild con Discord

• Estructura de canales definida (anuncios, boss, castle siege, ranking, reclutamiento).
• Bot propio creado con los permisos mínimos necesarios en el servidor.
• API de solo lectura expuesta sobre la base del MuServer para que el bot la consuma.
• Comando de vínculo entre la cuenta de Discord y el personaje implementado.
• Sincronización automática de cargos corriendo periódicamente.
• Alertas de boss y Castle Siege configuradas y probadas.
• Ranking automático publicado en un canal dedicado.
• Comandos de autoservicio (slash commands) disponibles para los miembros.

Con la guild operando de forma automatizada en Discord, vale la pena revisar también la integración del servidor en su conjunto con la comunidad, desde el foro hasta la página pública de estado. Consulta la guía de creación de servidor de MU Online para revisar la base completa del proyecto.

Preguntas frecuentes