> For the complete documentation index, see [llms.txt](https://docs.morpheusmuweb.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpheusmuweb.com/conteudo-do-site/guides.md).

# Guias

Este guia explica, de forma simples, o que são os Guias do seu servidor, como o jogador usa e como você configura tudo pelo painel administrativo. Não é necessário conhecimento técnico.

***

## O que são os Guias?

Os Guias são uma **central de conteúdo e tutoriais** dentro do seu site: uma seção onde você publica textos explicativos para os jogadores, como *"Como começar no servidor"*, *"Sistema de combo"*, *"Onde upar em cada nível"*, *"Regras do servidor"* ou *"Como funciona o VIP"*.

É uma ferramenta de **suporte e retenção**:

* Reduz dúvidas repetidas no chat e nos tickets. O jogador encontra a resposta sozinho.
* Ajuda o **jogador novo** a entender o servidor e ficar mais tempo.
* Mostra profissionalismo e organização do seu projeto.
* O próprio jogador indica **se o guia foi útil**, votando com 👍 ou 👎.

Os guias ficam organizados por **categorias** e aparecem em uma seção dedicada do site.

***

## Conceitos principais

### As categorias

São os **grupos** que organizam os guias (ex.: *"Primeiros passos"*, *"Sistemas do jogo"*, *"Eventos"*, *"Regras"*). Toda categoria tem um **Nome** (em cada idioma do site) e o interruptor **Ativo**. No site, as categorias aparecem em um menu lateral e o jogador navega entre elas. Só categorias ativas aparecem no site e podem receber guias. Você pode **reordenar** as categorias arrastando as linhas da lista.

### Os guias

É o conteúdo em si. Cada guia tem:

* Um **Título**, em cada idioma do site.
* O conteúdo, no campo **Guia**: texto formatado, com parágrafos, listas, imagens e links, escrito num editor parecido com um editor de texto comum. Também pode ser preenchido em cada idioma.
* Uma **Categoria** à qual pertence.
* O endereço da página, no campo **URL**. Ele é gerado automaticamente a partir do título quando o guia é criado e pode ser ajustado depois, na edição.
* O interruptor **Ativo**. Só guias ativos aparecem no site.

Assim como nas categorias, você pode **reordenar** os guias arrastando as linhas da lista.

### Os votos (útil / não útil)

Em cada guia, o jogador logado pode dar um **voto positivo** (👍) ou **negativo** (👎). Isso te dá um termômetro de **quais guias estão ajudando** e quais talvez precisem ser reescritos. Cada jogador vota **uma vez** por guia. Quem tenta votar de novo recebe o aviso "Você já votou".

### Estatísticas

A tela **Estatísticas** resume o desempenho da seção: quantos guias estão ativos, o total de votos positivos e negativos, quantas categorias existem e a lista dos **Guias mais votados**.

### Vários idiomas

O título e o conteúdo de cada guia, e o nome das categorias, podem ser preenchidos em **vários idiomas**. O jogador vê o conteúdo no idioma do site dele.

### Bloco para páginas personalizadas (opcional)

Se você usa o sistema de **Páginas** do painel, pode inserir um bloco de **Guias** dentro de uma página personalizada, por exemplo para destacar os guias de uma categoria na sua página inicial. O bloco mostra cartões com o título e um trecho do texto de cada guia.

***

## Como o jogador usa

* O jogador acessa a seção de **Guias** do site. A primeira categoria ativa já vem aberta.
* No menu lateral, escolhe a **categoria** que quer. No celular, o menu fica atrás do botão **Ver categorias**.
* Vê a **lista de guias** daquela categoria, já com a contagem de votos positivos e negativos de cada um. Listas longas são divididas em páginas.
* Clica em um guia para abrir a página com o **conteúdo completo**.
* Se estiver **logado**, pode votar 👍 ou 👎 para indicar se o guia foi útil. Quem não está logado vê apenas a contagem.

***

## Como configurar (passo a passo)

Tudo é feito no item **Guias** do menu lateral do painel, que tem dois subitens: **Guias** e **Categorias**.

### 1. Criar as categorias

1. Vá em **Guias → Categorias** e clique em **Adicionar**.
2. Preencha o **Nome** da categoria, nos idiomas que desejar.
3. Ligue o interruptor **Ativo** e clique em **Salvar**.
4. Repita para cada categoria. Na lista, arraste as linhas para definir a ordem em que aparecem no site.

A lista de categorias mostra o **Nome** e o **Status** (Ativo ou Inativo) de cada uma, com busca e botões de editar e excluir.

### 2. Criar os guias

1. Vá em **Guias** e clique em **Adicionar**.
2. Preencha o **Título**, nos idiomas que desejar, e ligue o interruptor **Ativo**.
3. Escolha a **Categoria** do guia. Só categorias ativas aparecem na lista.
4. Escreva o conteúdo no campo **Guia**, usando o editor, nos idiomas que desejar.
5. Clique em **Salvar**. O endereço da página é gerado automaticamente a partir do título.

### 3. Editar e organizar

* Abra um guia pela lista para **editar** o conteúdo, trocar a categoria ou ajustar o campo **URL**, que só aparece na edição.
* Arraste as linhas da lista de guias para definir a ordem.
* Desligue **Ativo** para tirar um guia do ar sem apagá-lo.
* Na edição de uma categoria também é possível ajustar a **URL** dela.

A lista de guias mostra **Título**, **Categoria**, **Votos** (positivos e negativos) e **Status** (Ativo ou Inativo). No topo da lista ficam os botões **Estatísticas** e **Categorias**.

### 4. Acompanhar os resultados

Clique no botão **Estatísticas** no topo da lista de guias. A tela mostra os cartões **Guias ativos** (ativos / total), **Votos positivos**, **Votos negativos** e **Categorias**, além da tabela **Guias mais votados**, com título, categoria e votos de cada um.

### 5. Destacar guias numa página (opcional)

No editor do sistema de **Páginas**, adicione o bloco **Guias** e informe o título da seção (opcional), a categoria e a quantidade de guias a exibir (de 1 a 12). Os campos desse bloco aparecem em inglês: **Title**, **Category** e **Limit**.

***

## Onde configurar cada coisa

| O que você quer fazer                         | Onde, no painel                                              |
| --------------------------------------------- | ------------------------------------------------------------ |
| Criar/editar categorias                       | **Guias → Categorias → Adicionar / Editar**                  |
| Ativar ou desativar uma categoria             | Interruptor **Ativo** na categoria                           |
| Ordenar as categorias                         | Arrastar as linhas na lista de categorias                    |
| Ajustar o endereço de uma categoria           | Campo **URL** na edição da categoria                         |
| Criar/editar guias                            | **Guias → Adicionar / Editar**                               |
| Definir a categoria de um guia                | Campo **Categoria** no guia                                  |
| Escrever o conteúdo                           | Campo **Guia** (editor de texto)                             |
| Traduzir título, conteúdo e nome da categoria | Seletor de idioma dos campos **Título**, **Guia** e **Nome** |
| Ajustar o endereço de um guia                 | Campo **URL** na edição do guia                              |
| Ordenar os guias                              | Arrastar as linhas na lista de guias                         |
| Tirar do ar sem apagar                        | Desligar **Ativo**                                           |
| Ver os votos de cada guia                     | Coluna **Votos** na lista de guias                           |
| Ver totais e guias mais votados               | Botão **Estatísticas** no topo da lista de guias             |
| Ir para as categorias a partir da lista       | Botão **Categorias** no topo da lista de guias               |
| Destacar guias numa página                    | Bloco **Guias** no editor de Páginas                         |

***

## Dicas e boas práticas

* Crie uma categoria **"Primeiros passos"** e mantenha nela os guias essenciais para quem está chegando.
* **Títulos diretos** ("Como resgatar o VIP") funcionam melhor do que títulos vagos.
* Use o editor para deixar o conteúdo **escaneável**: subtítulos, listas e imagens ajudam muito.
* Acompanhe os **votos** e a tela de **Estatísticas**: um guia com muitos 👎 provavelmente está confuso ou desatualizado e vale reescrever.
* Mantenha os guias **atualizados** após mudanças no servidor (rates, eventos, sistemas).
* Preencha os **idiomas** que sua comunidade usa para alcançar todos os jogadores.
* Evite trocar a **URL** de um guia já divulgado, para não quebrar links compartilhados no Discord ou nas redes.

***

## Perguntas frequentes

**Onde os guias aparecem para o jogador?** Em uma seção de **Guias** no site, com as categorias no menu lateral e a lista de guias de cada categoria.

**Quem pode votar nos guias?** Apenas jogadores **logados**. Quem não está logado vê a contagem de votos, mas não pode votar.

**O jogador pode votar várias vezes no mesmo guia?** Não. Cada jogador vota **uma única vez** por guia.

**Posso escrever os guias em mais de um idioma?** Sim. Título e conteúdo dos guias, e o nome das categorias, podem ser preenchidos em vários idiomas. O jogador vê no idioma do site.

**Como tiro um guia do ar sem apagar?** Basta desligar **Ativo** na edição do guia. Ele some do site, mas continua salvo para você reativar quando quiser.

**Dá para mudar a ordem em que os guias aparecem?** Sim. Tanto as categorias quanto os guias são reordenados **arrastando as linhas** nas listas do painel.

**Por que não vejo o campo URL ao criar um guia?** Porque o endereço é gerado automaticamente a partir do título. Depois de salvar, abra o guia na edição para ajustar a **URL**, se quiser.

**Posso colocar guias dentro de uma página personalizada?** Sim, se você usa o sistema de **Páginas**: há um bloco de **Guias** que pode ser inserido em qualquer página, escolhendo a categoria e a quantidade de guias.

**Posso colocar imagens dentro de um guia?** Sim. O conteúdo é escrito num editor que aceita texto formatado, listas, links e imagens.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.morpheusmuweb.com/conteudo-do-site/guides.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
