Como integrar um fórum phpBB ao site do seu servidor de MU Online

Um fórum é a espinha dorsal de comunidades de MU Online que querem durar: guias, discussões de build, anúncios oficiais e histórico de eventos ficam registrados e pesquisáveis, diferente do chat efêmero do Discord. O phpBB continua sendo a escolha mais comum para servidores privados por ser gratuito, extensível e com uma comunidade de plugins madura. Mas o valor real aparece quando o fórum não vive isolado — quando ele compartilha login com a conta de jogo, mostra o nível e reset do personagem como assinatura, e a moderação do fórum conversa com a staff do jogo. Este tutorial cobre a instalação, a integração de login único, a exibição de dados de jogo no perfil e a sincronização de moderação.

Por que integrar o fórum à conta de jogo

Sem integração, o jogador precisa criar duas contas separadas (jogo e fórum), o que reduz a adesão à comunidade. Com integração, o cadastro é único, o jogador vê seu personagem representado no fórum (nível, reset, guild) e a staff do jogo consegue moderar de forma coerente entre os dois ambientes — banir no jogo e no fórum ao mesmo tempo, por exemplo.

Pré-requisitos

• VPS ou hospedagem com PHP 7.4+ e MySQL/MariaDB, já rodando o site do servidor.
• Acesso ao banco de dados do MuServer (leitura, ao menos) a partir do servidor web.
• Domínio ou subdomínio dedicado ao fórum (ex.: forum.seuservidor.com).
• Backup do banco de dados antes de qualquer integração.

Passo 1 — Instalar o phpBB

1. Baixe a versão estável mais recente do site oficial do phpBB.
2. Extraia os arquivos no subdomínio escolhido (ex.: /var/www/forum.seuservidor.com).
3. Crie um banco de dados dedicado ao fórum (não reutilize o banco do MuServer):

CREATE DATABASE phpbb_forum CHARACTER SET utf8mb4;
CREATE USER 'phpbb_user'@'localhost' IDENTIFIED BY 'senha-forte-aqui';
GRANT ALL PRIVILEGES ON phpbb_forum.* TO 'phpbb_user'@'localhost';

1. Acesse install/app.php pelo navegador e siga o assistente de instalação, apontando para esse banco.
2. Após instalar, remova ou proteja a pasta install/ — deixá-la acessível é uma das falhas de segurança mais comuns em fóruns phpBB.

Passo 2 — Planejar a integração de contas (SSO)

Existem dois níveis de integração, do mais simples ao mais robusto:

Para a maioria dos servidores, começar pela sincronização de cadastro já resolve o principal atrito (duplo cadastro), evoluindo para SSO depois.

Passo 3 — Sincronizar cadastro via hook de registro

No fluxo de criação de conta do seu site (o mesmo que grava na tabela de contas do MuServer), adicione uma chamada à API de autenticação do phpBB para criar o usuário correspondente:

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

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

Use a mesma política de hash de senha ou uma tabela de mapeamento se as senhas do MuServer e do phpBB usarem algoritmos diferentes — nunca tente reaproveitar o hash bruto entre sistemas incompatíveis.

Passo 4 — Implementar login único (SSO)

Para SSO completo, gere um token assinado no login do site/launcher e valide-o em uma extensão de autenticação customizada do phpBB (auth_customsso é o padrão usado como base):

// extensão de autenticação customizada do 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];
}

O token deve ter expiração curta (ex.: 15 minutos) e ser assinado com HMAC usando uma chave secreta compartilhada apenas entre o site e o fórum, nunca exposta no cliente.

Passo 5 — Exibir dados do personagem no perfil do fórum

Crie campos de perfil customizados no phpBB (Painel de Administração → Perfis de usuário → Campos customizados) para Nível, Reset, Classe e Guild, e um script agendado que atualiza esses campos consultando o banco do 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

Passo 6 — Sincronizar moderação e cargos

Mapeie os cargos de staff do jogo (GM, Admin, Moderador) para grupos correspondentes no phpBB, e automatize a adição/remoção via o mesmo script de sincronização, garantindo que quem é banido no jogo por trapaça também perca acesso a áreas exclusivas do fórum, se essa for a política do servidor.

Passo 7 — Personalizar o tema (estilo) do fórum

Ajuste o tema do phpBB para manter identidade visual com o site principal — cores, logo e tipografia consistentes reduzem a sensação de "site colado" e aumentam a confiança do jogador na comunidade. phpBB usa o sistema de estilos próprio; personalize o template/ do estilo ativo em vez de editar o core, para sobreviver a atualizações.

Passo 8 — SEO e integração de conteúdo

Habilite URLs amigáveis no phpBB (mod_rewrite) e inclua o fórum no sitemap do site principal. Tópicos de guias e discussões bem escritas rankeiam no Google organicamente, trazendo tráfego novo para o servidor — um benefício que o Discord sozinho não oferece.

Manutenção e segurança contínua

Mantenha o phpBB e todas as extensões sempre atualizados — é um dos alvos mais comuns de scanners automatizados por ser software conhecido e amplamente documentado. Configure backups diários do banco do fórum separadamente do banco do jogo, e monitore o log de tentativas de login para identificar ataques de força bruta.

Erros comuns e soluções

Checklist de integração do fórum

• phpBB instalado em subdomínio próprio, com banco de dados dedicado.
• Pasta install/ removida ou protegida após a instalação.
• Sincronização de cadastro entre site/conta de jogo e fórum funcionando.
• SSO implementado (ou ao menos sincronização de cadastro, como primeira etapa).
• Campos de perfil (nível, reset, guild) exibidos e atualizados periodicamente.
• Cargos de staff e moderação sincronizados entre jogo e fórum.
• Tema do fórum alinhado visualmente ao site principal.
• Backups separados e atualizações de segurança agendadas.

Com o fórum integrado e alimentando a comunidade organicamente, o próximo passo natural é conectar também o Discord da guild e do servidor a esse mesmo ecossistema de identidade única — veja o guia de criação de servidor de MU Online para revisar a arquitetura completa do projeto.

Perguntas frequentes