Cómo integrar un foro phpBB al sitio de tu servidor de MU Online

Un foro es la espina dorsal de las comunidades de MU Online que quieren durar: guías, discusiones de build, anuncios oficiales e historial de eventos quedan registrados y son buscables, a diferencia del chat efímero de Discord. phpBB sigue siendo la elección más común para servidores privados por ser gratuito, extensible y contar con una comunidad de plugins madura. Pero el valor real aparece cuando el foro no vive aislado: cuando comparte login con la cuenta de juego, muestra el nivel y el reset del personaje como firma, y la moderación del foro se comunica con el staff del juego. Este tutorial cubre la instalación, la integración de login único, la visualización de datos de juego en el perfil y la sincronización de moderación.

Por qué integrar el foro con la cuenta de juego

Sin integración, el jugador necesita crear dos cuentas separadas (juego y foro), lo que reduce la adhesión a la comunidad. Con integración, el registro es único, el jugador ve su personaje representado en el foro (nivel, reset, guild) y el staff del juego logra moderar de forma coherente entre ambos entornos: banear en el juego y en el foro al mismo tiempo, por ejemplo.

Prerrequisitos

• VPS u hospedaje con PHP 7.4+ y MySQL/MariaDB, ya corriendo el sitio del servidor.
• Acceso a la base de datos del MuServer (lectura, al menos) desde el servidor web.
• Dominio o subdominio dedicado al foro (ej.: forum.tuservidor.com).
• Backup de la base de datos antes de cualquier integración.

Paso 1 — Instalar phpBB

1. Descarga la versión estable más reciente del sitio oficial de phpBB.
2. Extrae los archivos en el subdominio elegido (ej.: /var/www/forum.tuservidor.com).
3. Crea una base de datos dedicada al foro (no reutilices la base del MuServer):

CREATE DATABASE phpbb_forum CHARACTER SET utf8mb4;
CREATE USER 'phpbb_user'@'localhost' IDENTIFIED BY 'contraseña-fuerte-aqui';
GRANT ALL PRIVILEGES ON phpbb_forum.* TO 'phpbb_user'@'localhost';

1. Accede a install/app.php desde el navegador y sigue el asistente de instalación, apuntando a esa base de datos.
2. Después de instalar, elimina o protege la carpeta install/; dejarla accesible es una de las fallas de seguridad más comunes en foros phpBB.

Paso 2 — Planificar la integración de cuentas (SSO)

Existen dos niveles de integración, del más simple al más robusto:

Para la mayoría de los servidores, empezar por la sincronización de registro ya resuelve el principal fricción (doble registro), evolucionando a SSO después.

Paso 3 — Sincronizar el registro vía hook de registro

En el flujo de creación de cuenta de tu sitio (el mismo que graba en la tabla de cuentas del MuServer), agrega una llamada a la API de autenticación de phpBB para crear el usuario correspondiente:

require($phpbbRoot . 'common.php');
$user->session_begin();
$auth->acl($user->data);

$dadosUsuario = [
    'username' => $novaContaMU,
    'password' => $senhaHash,
    'email' => $emailConta,
];
user_add($dadosUsuario);

Usa la misma política de hash de contraseña o una tabla de mapeo si las contraseñas del MuServer y de phpBB usan algoritmos distintos; nunca intentes reutilizar el hash crudo entre sistemas incompatibles.

Paso 4 — Implementar inicio de sesión único (SSO)

Para un SSO completo, genera un token firmado en el login del sitio/launcher y valídalo en una extensión de autenticación personalizada de phpBB (auth_customsso es el estándar usado como base):

// extensión de autenticación personalizada de phpBB
public function login($username, $password) {
    $token = $_COOKIE['mu_session_token'] ?? null;
    if ($token && validarTokenAssinado($token)) {
        $usuario = decodificarUsuarioDoToken($token);
        return $this->autenticarSemSenha($usuario);
    }
    return ['status' => LOGIN_ERROR_EXTERNAL_AUTH];
}

El token debe tener expiración corta (ej.: 15 minutos) y estar firmado con HMAC usando una clave secreta compartida solo entre el sitio y el foro, nunca expuesta en el cliente.

Paso 5 — Mostrar los datos del personaje en el perfil del foro

Crea campos de perfil personalizados en phpBB (Panel de Administración → Perfiles de usuario → Campos personalizados) para Nivel, Reset, Clase y Guild, y un script programado que actualiza esos campos consultando la base del MuServer:

// cron: atualizar_perfis_forum.php
$personagens = consultarPersonagensPorConta($banco_mu);
foreach ($personagens as $p) {
    atualizarCampoPerfilPhpbb($p['username_forum'], [
        'pf_nivel' => $p['cLevel'],
        'pf_reset' => $p['Resets'],
        'pf_guild' => $p['G_Name'],
    ]);
}

; crontab
*/10 * * * * php /var/www/forum/scripts/atualizar_perfis_forum.php

Paso 6 — Sincronizar moderación y cargos

Mapea los cargos de staff del juego (GM, Admin, Moderador) a grupos correspondientes en phpBB, y automatiza el alta/baja mediante el mismo script de sincronización, garantizando que quien es baneado en el juego por hacer trampa también pierda acceso a áreas exclusivas del foro, si esa es la política del servidor.

Paso 7 — Personalizar el tema (estilo) del foro

Ajusta el tema de phpBB para mantener la identidad visual con el sitio principal: colores, logo y tipografía consistentes reducen la sensación de "sitio pegado" y aumentan la confianza del jugador en la comunidad. phpBB usa su propio sistema de estilos; personaliza el template/ del estilo activo en lugar de editar el core, para sobrevivir a las actualizaciones.

Paso 8 — SEO e integración de contenido

Habilita URLs amigables en phpBB (mod_rewrite) e incluye el foro en el sitemap del sitio principal. Los temas de guías y discusiones bien escritas rankean en Google orgánicamente, trayendo tráfico nuevo al servidor, un beneficio que Discord por sí solo no ofrece.

Mantenimiento y seguridad continua

Mantén phpBB y todas las extensiones siempre actualizadas; es uno de los blancos más comunes de escáneres automatizados por ser software conocido y ampliamente documentado. Configura backups diarios de la base del foro por separado de la base del juego, y monitorea el log de intentos de login para identificar ataques de fuerza bruta.

Errores comunes y soluciones

Lista de verificación de integración del foro

• phpBB instalado en subdominio propio, con base de datos dedicada.
• Carpeta install/ eliminada o protegida después de la instalación.
• Sincronización de registro entre el sitio/cuenta de juego y el foro funcionando.
• SSO implementado (o al menos sincronización de registro, como primer paso).
• Campos de perfil (nivel, reset, guild) mostrados y actualizados periódicamente.
• Cargos de staff y moderación sincronizados entre el juego y el foro.
• Tema del foro alineado visualmente con el sitio principal.
• Backups separados y actualizaciones de seguridad programadas.

Con el foro integrado y alimentando la comunidad orgánicamente, el siguiente paso natural es conectar también el Discord de la guild y del servidor a este mismo ecosistema de identidad única; consulta la guía de creación de servidor de MU Online para revisar la arquitectura completa del proyecto.

Preguntas frecuentes