# Meta do mês

A meta do mês mostra na página inicial da loja quanto a comunidade já comprou e
quanto falta para um valor, com recompensas em cada marco. É um jeito de
transformar vendas em evento: "batendo R$ 5.000, tem mapa novo de BedWars".

Tudo fica em **Loja > Meta do Mês**.

![A tela Meta do Mês: valor, datas e recompensas com a recompensa no jogo](shots/products-goal.webp)

## Criar a meta

1. Em **Loja > Meta do Mês**, ligue **Ativar Meta do Mês**.
2. Informe o **Valor da Meta (R$)**, a **Data de Início** e a **Data de
   Término**.
3. Em **Recompensas**, clique em **Adicionar Recompensa** para cada marco. Cada
   uma tem a **Descrição da Recompensa** e o **Valor Necessário (R$)**.
4. Salve. A prévia, na mesma tela, mostra como a meta aparece na loja.

O valor arrecadado soma sozinho os pedidos confirmados (pagos, em processamento,
enviados ou entregues) a partir da data de início.

## Recompensa no jogo

Nas lojas de Minecraft e Hytale (plugin 2.7.0 ou mais novo), cada marco pode ter a
**Recompensa no jogo quando a loja passar deste marco**:

- **Quem recebe**: **Quem está online no servidor** (recebe quem estiver
  jogando na hora) ou **Todos do servidor, mesmo offline** (quem está offline
  recebe ao entrar, até 30 dias depois; só quem já tinha jogado antes do marco;
  no Hytale, só quem está online).
- **Para cada jogador que recebe**: um comando por linha, sem a barra, com
  `{player}` onde vai o nick.
- **Uma vez no console**: comandos sem jogador, que rodam uma vez em cada
  servidor.

```text Para cada jogador que recebe
give {player} diamond 5
eco give {player} 500
```

```text Uma vez no console
say A meta foi batida! Obrigado, comunidade!
```

Quando a loja passa do marco, o chat avisa todo mundo e os comandos rodam uma
vez só por meta; estorno e edição da meta não repetem. Até 20 comandos em cada
caixa, de até 500 caracteres.

> [!NOTE]
> Marco que a loja já tinha passado quando os comandos foram salvos fica marcado
> como alcançado, e os comandos dele não rodam. Editar os comandos pede a
> permissão de configurar o plugin.

## A meta na tela do jogo

No cartão **Meta da loja no jogo** (plugin 2.5.0 ou mais novo), a cada compra que
move a meta, a barra do topo e a barra de baixo da tela mostram quanto falta: só
quando alguém compra (pelo tempo escolhido, de 3 a 300 segundos) ou fixas na tela
o tempo todo. Escolha as duas, só uma ou nenhuma, a cor e o desenho da barra.

O mesmo desenho vale para os placeholders do PlaceholderAPI:
`%hystore_meta_barra%`, `%hystore_meta%`, `%hystore_meta_atual%`,
`%hystore_meta_alvo%` e `%hystore_meta_falta%`.

> [!TIP]
> Metas que funcionam têm recompensas para todos, não só para quem comprou:
> evento de XP em dobro, kit para o servidor inteiro, mapa novo. Assim quem não
> compra também torce, e divulga.