Como instalar o MuCMS e configurar temas no site do servidor de MU

Depois que o servidor de MU Online está de pé, o site é o rosto do projeto. Um site bonito, rápido e organizado transmite seriedade e faz o jogador confiar antes mesmo de criar a conta. O MuCMS é um dos gerenciadores de conteúdo mais populares entre servidores brasileiros e latinos justamente porque combina instalação simples com uma boa variedade de temas prontos. Neste tutorial, de nível intermediário, você vai aprender a instalar o MuCMS do zero e, principalmente, a configurar e personalizar temas: trocar logo, ajustar cores, colocar banners e adaptar o layout sem quebrar os módulos do sistema.

A lógica por trás de qualquer CMS de MU é sempre a mesma: uma aplicação PHP que lê e escreve nas tabelas do banco do emulador (contas, personagens, rankings) e apresenta tudo em páginas web. O que muda entre CMS é a facilidade de uso, o idioma do painel e a oferta de temas. O MuCMS se destaca no último ponto, e é por isso que dominar a parte visual dele agrega tanto valor ao seu projeto.

Pré-requisitos

Garanta estes itens antes de começar. A maioria dos problemas de instalação vem de pular um destes pontos.

• Servidor de MU já rodando com o banco de dados acessível. Se você ainda está montando a base, veja primeiro o guia de como criar servidor de MU Online.
• Servidor web com PHP (Apache/Nginx/IIS). A versão exigida varia por versão do MuCMS.
• Driver de banco compatível com o SGBD do seu emulador (normalmente SQL Server via sqlsrv/PDO).
• Credenciais de um usuário de banco de baixo privilégio.
• Acesso FTP ou ao sistema de arquivos do servidor web.
• Um editor de código (VS Code, Sublime) para editar CSS e templates.

> Aviso: nomes de pastas, arquivos e tabelas citados adiante são exemplos. A estrutura real varia por versão do MuCMS e por emulador. Confirme sempre no painel ou na documentação da sua versão.

Passo 1: Baixar o MuCMS

Baixe o pacote do MuCMS da fonte oficial ou de um autor confiável. Evite versões "modificadas" de fórum sem auditoria, pois são vetor clássico de backdoor. Descompacte localmente e observe a estrutura, que costuma ser assim:

mucms/
├── index.php
├── config/            # configuração do site e banco
├── system/            # núcleo do CMS
├── themes/            # <- aqui ficam os temas
│   ├── default/
│   └── dark/
├── admin/             # painel administrativo
└── install/           # assistente (apagar depois!)

Repare na pasta themes/: é o coração deste tutorial. Cada subpasta é um tema independente.

Passo 2: Subir os arquivos e ajustar permissões

Envie o conteúdo para o diretório público do servidor web via FTP. Ajuste as permissões: pastas 755, arquivos 644, e permissão de escrita apenas onde o CMS precisa gravar (cache, uploads). Evite 777, que é uma falha de segurança desnecessária.

# Exemplo no Linux
find /var/www/mucms -type d -exec chmod 755 {} \;
find /var/www/mucms -type f -exec chmod 644 {} \;
chmod -R 775 /var/www/mucms/cache /var/www/mucms/uploads

Passo 3: Rodar o instalador

Acesse http://seudominio.com/install/ no navegador. O assistente vai pedir, em etapas (o fluxo varia por versão):

1. Verificação de requisitos (PHP, extensões, permissões).
2. Dados de conexão do banco (host, porta, nome, usuário, senha).
3. Mapeamento das tabelas do emulador.
4. Criação do administrador do painel.

Ao final, o instalador grava o arquivo de configuração, que se parece com:

<?php
// config/database.php (exemplo — varia por versão)
return [
    'host'   => '203.0.113.10',
    'port'   => 1433,
    'dbname' => 'MuOnline',
    'user'   => 'web_mu',
    'pass'   => 'SenhaForte#2024',
    'driver' => 'sqlsrv',
];

Passo 4: Apagar a pasta de instalação

Assim como em qualquer CMS, apague a pasta install/ imediatamente após concluir. Ela permite reconfigurar o site inteiro, incluindo credenciais de banco, e deixá-la acessível é entregar o servidor.

rm -rf /var/www/mucms/install/

Passo 5: Entender a estrutura de um tema

Agora chegamos à parte central. Um tema do MuCMS é uma pasta dentro de themes/ com uma estrutura previsível (varia por versão):

themes/meutema/
├── theme.json         # metadados: nome, autor, versão
├── css/
│   └── style.css      # cores, fontes, espaçamentos
├── js/
├── images/            # logo, banners, ícones
└── templates/         # arquivos .php de layout (header, footer, home)

• theme.json identifica o tema no painel.
• css/style.css controla toda a aparência: cores, tipografia, layout.
• images/ guarda logo e banners.
• templates/ são os arquivos que misturam HTML com chamadas do CMS (ranking, notícias, login). Mexer aqui exige mais cuidado.

Passo 6: Ativar um tema

No painel administrativo (/admin/), vá em Aparência/Temas e selecione o tema desejado. Alternativamente, alguns CMS definem o tema ativo por config:

// config/site.php (exemplo)
$config['active_theme'] = 'meutema';

Sempre teste a troca em um ambiente de homologação antes de aplicar em produção, e faça backup. Um tema mal construído pode quebrar módulos como ranking e registro.

Passo 7: Personalizar cores e logo

Aqui está o trabalho mais comum e gratificante. Para trocar a logo, substitua o arquivo em images/ mantendo o mesmo nome e proporção, ou atualize o caminho no template do header.

Para ajustar cores, edite o style.css. Um padrão saudável é usar variáveis CSS para não caçar cor por cor:

/* themes/meutema/css/style.css */
:root {
  --cor-primaria: #c8102e;   /* vermelho MU */
  --cor-fundo:    #0d0d0f;
  --cor-texto:    #e8e8e8;
  --cor-destaque: #f2b705;   /* dourado */
}

body {
  background-color: var(--cor-fundo);
  color: var(--cor-texto);
  font-family: 'Segoe UI', Arial, sans-serif;
}

.btn-registro {
  background-color: var(--cor-primaria);
  color: #fff;
  border-radius: 6px;
  transition: background-color .2s;
}

.btn-registro:hover {
  background-color: var(--cor-destaque);
  color: #000;
}

Com variáveis, mudar toda a identidade visual do site é questão de trocar quatro valores no topo do arquivo.

Passo 8: Colocar banners e destaques

Banners de eventos, top donation ou boss timers costumam ser blocos no template da home. Para trocar a imagem de um banner, substitua o arquivo em images/ e confirme o caminho no template:

<!-- themes/meutema/templates/home.php (trecho de exemplo) -->
<div class="banner-evento">
  <img src="<?php echo THEME_URL; ?>/images/banner-evento.jpg" alt="Evento de fim de semana">
</div>

Sempre otimize as imagens (comprima JPG/PNG ou use WebP) para o site carregar rápido. Banner pesado é a causa mais comum de home lenta.

Passo 9: Ajustar responsividade

Boa parte dos jogadores acessa o site pelo celular. Confirme que o tema é responsivo testando em telas pequenas. Se precisar ajustar, use media queries no CSS:

@media (max-width: 768px) {
  .menu-lateral { display: none; }
  .conteudo { width: 100%; padding: 0 12px; }
}

Passo 10: Segurança ao usar temas de terceiros

Se você baixar um tema pronto, revise os arquivos .php antes de subir. Temas maliciosos escondem shells que dão acesso ao servidor. Procure por funções suspeitas como eval, base64_decode, system, exec em lugares que não fazem sentido em um template. Na dúvida, não suba.

Erros comuns e soluções

Checklist de lançamento

• Servidor de jogo e banco funcionando antes do site
• PHP na versão exigida pela sua build do MuCMS
• Driver de banco carregado e confirmado
• Usuário de banco dedicado de baixo privilégio
• Arquivos subidos com permissões corretas (sem 777)
• Instalador concluído e pasta install/ apagada
• Tema ativado e testado em homologação antes de produção
• Logo, cores e banners personalizados
• Imagens otimizadas para carregamento rápido
• Site testado em desktop e celular
• Módulos de ranking, registro e login validados
• Arquivos .php de temas de terceiros revisados
• Backup do site e do banco agendado

Instalar o MuCMS é a parte fácil; o que diferencia um servidor amador de um profissional é o capricho no tema. Cores coerentes, logo nítida, banners atualizados e carregamento rápido passam confiança e convertem visitantes em jogadores. Comece pelas personalizações simples de CSS e imagens, ganhe segurança e só depois mexa nos templates. E lembre: sempre teste em homologação, mantenha backup e revise qualquer código de terceiros antes de colocá-lo no ar.

Perguntas frequentes