# Instalar o plugin

O plugin liga o seu servidor à loja. É ele que entrega as compras, cuida do VIP no jogo e
leva anúncios e a `/loja` para dentro do servidor. Esta seção só aparece nas lojas de
Minecraft e Hytale.

O mesmo plugin de Minecraft roda da versão 1.8.8 à mais nova, em Spigot, Paper e Folia.

![Plugin > Como funciona: o download, o que o plugin faz e como instalar](shots/plugins-overview.webp)

## Passo a passo

Você vai precisar de acesso aos arquivos do servidor, normalmente pelo painel da sua
hospedagem.

### 1. Crie o servidor na loja

1. Em **Loja > Servidores**, clique em **Novo Servidor**.
2. Dê um nome, como `Survival`. A foto é opcional.
3. Clique em **Criar Servidor**.

![A janela de novo servidor](shots/plugins-server-new.webp)

### 2. Copie o token

Ao criar, a tela mostra o **token**, a senha que liga o plugin a este servidor. Copie
agora: ele aparece uma única vez nesta janela. Perdeu? Abra o servidor e use **Regenerar
Token** para gerar outro.

![O token do servidor logo depois de criar](shots/plugins-server-token.webp)

> [!WARNING]
> O token é uma senha. Não mande em ticket, print ou grupo. Se vazar, use **Regenerar
> Token** na tela do servidor: o antigo para na hora e o plugin só volta com o novo.

### 3. Baixe e instale o plugin

1. Em **Plugin > Como funciona**, clique em **Baixar o plugin**.
2. Coloque o arquivo na pasta `plugins` do servidor.
3. Ligue o servidor uma vez. O plugin cria o arquivo `plugins/Hystore/config.yml`.

### 4. Cole o token

Abra `plugins/Hystore/config.yml` e cole o token no campo `token`:

```yaml plugins/Hystore/config.yml
token: "COLE_O_SEU_TOKEN_AQUI"
```

No Hytale, o arquivo é o `config.json`, na pasta do plugin, com os mesmos campos.

### 5. Recarregue e confira

1. No console do servidor, digite `/hystorereload`, ou reinicie o servidor.
2. Em **Loja > Servidores**, confira a **Última conexão do plugin**. Se mostra agora há
   pouco, deu certo.

![A lista de servidores com a última conexão de cada um](shots/plugins-servers.webp)

> [!TIP]
> **Nunca conectou** quer dizer que o plugin ainda não falou com a loja. Sem token, ou com
> um token errado, o plugin fica ligado e os comandos dizem o que falta. Confira se o token
> foi colado inteiro e entre aspas.

## Opções do arquivo de configuração

Depois de mudar o arquivo, use `/hystorereload` ou reinicie o servidor.

| Opção | Padrão | O que faz |
| --- | --- | --- |
| `token` | | A senha do servidor |
| `poll-interval-seconds` | `30` | De quantos em quantos segundos o plugin busca entregas |
| `require-online` | `true` | `true`: a entrega espera o jogador estar online. `false`: roda na hora, mesmo offline |
| `notify-player` | `true` | Avisa o jogador quando ele recebe uma entrega |
| `auto-update` | `true` | Baixa versões novas sozinho |
| `vip.language` | `auto` | Idioma do VIP: `auto` usa o idioma do jogo de cada jogador. Ou fixe `pt`, `en` ou `es` |
| `vip.announce-activation` | `true` | Anuncia no chat quando alguém ativa um VIP |
| `vip.warn-every-hours` | `6` | Com o VIP perto de acabar, avisa a cada tantas horas |
| `debug` | `false` | Escreve mais detalhes no console |

## Atualizações

Instale uma vez. Quando sai uma versão nova, o plugin baixa sozinho, confere a assinatura
da Hystore e a versão nova vale no próximo reinício do servidor. Em **Plugin > Novidades**
você vê o que mudou em cada versão.

![As novidades do plugin, versão por versão](shots/plugins-changelog.webp)

## Conferir o servidor

Em **Loja > Servidores > Ver Detalhes**, o cartão **No servidor** mostra o que o plugin
contou: a versão dele, se está desatualizado, o software do servidor e os plugins ligados.
Há um aviso quando falta o LuckPerms, que o VIP de produto pode usar.

Continue em [Vincular e comandos](/pt/plugins/linking/).