# Gamificação

> O separador Gamificação em Membros, para o proprietário e o administrador. Como ligar e desligar os pontos da comunidade, quanto vale cada ação, o que acontece aos pontos já conquistados e a diferença para o Ranking Global.

A **Gamificação** decide se a participação na comunidade vale pontos e quanto vale cada ação: publicar, comentar, gostar, participar num evento, completar uma lição. Os pontos alimentam o [Ranking](/espacos/ranking) e os níveis dos membros.

Fica em **Membros › Gamificação**: *"Pontos por participação, que alimentam o Ranking e os níveis dos membros."*

## Para que serve

| Comunidade | Como ajustar os pontos |
|---|---|
| Escola online | Dar mais peso a **Completar lição** do que a **Gostar de publicação**, para premiar quem estuda |
| Comunidade de clientes | Valorizar **Responder a comentário**, para reconhecer quem ajuda os outros |
| Comunidade de eventos | Subir **Participar em evento**, para premiar quem aparece |
| Comunidade que não quer competição | Desligar a gamificação |

## Quem pode

**Proprietário** e **administrador**. Moderador e financeiro não veem o separador.

## Como funciona

### Ligar e desligar

O interruptor no topo do separador mostra **Ativa** ou **Desligada**. A gamificação já vem ativa quando a comunidade é criada.

Desligada, *"nenhuma ação conta pontos. Os pontos já conquistados continuam guardados."* Ao ligar de novo, as ações voltam a contar a partir daí; o que aconteceu enquanto estava desligada não conta.

### Pontos por ação

Cada ação tem o seu valor, um número inteiro de 0 para cima. Os valores padrão:

| Ação | Pontos |
|---|---:|
| Login diário | 1 |
| Criar publicação | 10 |
| Gostar de publicação | 1 |
| Comentar publicação | 5 |
| Responder a comentário | 3 |
| Receber gosto | 2 |
| Criar evento | 20 |
| Participar em evento | 20 |
| Criar curso | 30 |
| Inscrever-se em curso | 10 |
| Completar lição | 25 |

Mudar um valor *"vale a partir da próxima ação; os pontos já conquistados não mudam."* Uma ação com **0** deixa de dar pontos, sem desligar as outras.

### Gamificação e Ranking Global

São dois interruptores diferentes:

| Interruptor | Onde | O que faz |
|---|---|---|
| **Gamificação** | **Membros › Gamificação** | Se as ações contam pontos |
| **Ranking Global** | **Definições › Geral** | Se o ranking da comunidade inteira aparece aos membros |

Com a gamificação desligada, o ranking deixa de mudar, porque ninguém ganha pontos novos.

## Passo a passo

### Mudar quanto vale uma ação

*Papel: proprietário ou administrador.*

1. **Membros › Gamificação**.
2. Em **Pontos por ação**, mude o número ao lado da ação (por exemplo, **Completar lição** para *40*).
3. **Guardar**. Aparece *"Guardado."*

### Desligar a gamificação

1. **Membros › Gamificação**.
2. Clique no interruptor até mostrar **Desligada**. Os campos de pontos ficam bloqueados.
3. **Guardar**.

## Exemplo

**Uma escola que quer premiar quem estuda.** A Escola Excel sobe **Completar lição** de 25 para 40 e baixa **Gostar de publicação** de 1 para 0. Na semana seguinte, uma aluna que completa 5 lições ganha 200 pontos por elas; gostar de publicações deixa de contar. Os pontos que ela já tinha continuam iguais.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *"Use um número inteiro de 0 para cima em …"* | O campo da ação indicada tem um número negativo, decimal ou vazio. Corrija e guarde de novo |
| *"Não foi possível carregar a gamificação."* | Clique em **Tentar novamente**. Se persistir, recarregue a página |
| *"Não foi possível guardar. Tente de novo."* | Nada foi guardado. Tente de novo dentro de alguns segundos |

## Perguntas frequentes

**Mudar os pontos recalcula o ranking?**
Não. Os pontos já conquistados ficam como estão; o valor novo vale para as próximas ações.

**Desligar apaga os pontos?**
Não. Ficam guardados e voltam a aparecer no ranking quando voltar a ligar.

**Dá para dar pontos manualmente a alguém?**
Ainda não. Os pontos vêm só das ações da tabela.

## Na API

`GET` e `PUT /api/gamification/config` (proprietário e administrador): `isEnabled` e `actionRules`, com os pontos de cada ação. Ver [Gamification](/api/referencia/gamification).

## Relacionados

- [Ranking](/espacos/ranking)
- [Gerir membros](/membros/gerenciar-membros)
- [Definições gerais](/configuracoes/configuracoes-gerais)