# Vincular e comandos

Esta página mostra como o jogador liga a conta da loja ao personagem do servidor, quais
comandos o plugin tem e quem pode usar cada um.

## Vincular a conta ao jogo

Vincular prova que a conta da loja e o jogador do servidor são a mesma pessoa. É isso que
libera resgatar presentes no jogo e comprar com saldo pela `/loja`. Pede o plugin 2.8.0 ou
mais novo.

1. Na loja, o jogador abre **Perfil > Jogo** e clica em **Gerar código**.
2. No servidor, entra com o mesmo nick da conta e digita o comando com o código:

   ```text No chat do jogo
   /vincular K7QM2P
   ```

3. Pronto. Em **Perfil > Jogo**, ele vê desde quando está vinculado e pode **Desvincular**.

> [!NOTE]
> O código vale 10 minutos e uma vez só, e o nick no jogo precisa ser o da conta. Errar o
> código muitas vezes trava novas tentativas por alguns minutos.

Vinculado, o jogador resgata presentes com `/resgatar <código>`. Veja
[Presentes](/pt/products/gifts/).

## Os comandos

| Comando | O que faz | Permissão |
| --- | --- | --- |
| `/vip` | Menu do VIP do jogador | `hystore.vip` |
| `/vip upgrade` | Mostra para qual VIP dá para subir e quanto custa | `hystore.vip.upgrade` |
| `/tempovip [jogador]` | Quanto falta de VIP. Ver o de outro pede `hystore.vip.tempo.outros` | `hystore.vip` |
| `/loja` | A [loja no jogo](/pt/plugins/shop/) | `hystore.loja` |
| `/vincular <código>` | Liga a conta da loja ao jogador | `hystore.vincular` |
| `/resgatar <código>` ou `/usarkey` | Resgata um presente | `hystore.resgatar` |
| `/vip admin <jogador>` | Painel do VIP de um jogador (Minecraft) | `hystore.admin.vip` |
| `/darvip <jogador> <vip> <dias>` | Dá um VIP | `hystore.admin.vip` |
| `/removervip <jogador> <vip>` | Tira um VIP | `hystore.admin.vip` |
| `/congelarvip <jogador> <vip>` | Congela um VIP | `hystore.admin.vip` |
| `/hystorereload` | Recarrega o plugin | `hystore.reload` |
| `/hystore aviso` | Usado pela loja, só no console | |

## Quem pode usar: as permissões

Os comandos são usados dentro do jogo, então quem decide é o plugin de permissões do seu
servidor, como o LuckPerms, e não os cargos do painel.

| Permissão | Quem tem sem configurar |
| --- | --- |
| `hystore.vip`, `hystore.vip.upgrade`, `hystore.loja`, `hystore.vincular`, `hystore.resgatar` | Todos |
| `hystore.vip.tempo.outros`, `hystore.admin.vip`, `hystore.notify`, `hystore.notify.tickets`, `hystore.reload` | Só OP |

![Plugin > Permissões e comandos: as tabelas de permissões e comandos](shots/plugins-permissions.webp)

Para dar à sua equipe os comandos de VIP com o LuckPerms:

```text Console do servidor
lp group moderador permission set hystore.admin.vip true
```

Troque `moderador` pelo nome do grupo da sua equipe.

> [!NOTE]
> O que a equipe faz pelo jogo também passa pela loja: a API confere o pedido e cada ação
> fica no histórico do VIP, com o nick de quem fez.

## Trocar o nome de um comando

Serve para quando outro plugin do servidor já usa o mesmo comando, como `/loja`.

1. Em **Plugin > Permissões e comandos**, vá até **Nomes dos comandos**.
2. Troque o nome e, se quiser, crie até 3 apelidos, separados por vírgula.
3. Clique em **Salvar nomes**.

![O cartão Nomes dos comandos](shots/plugins-command-names.webp)

O plugin passa a usar o nome novo na hora, sem reiniciar, e solta o nome antigo para o
outro plugin. O nome original continua funcionando com o prefixo, como `/hystore:loja`. Os
textos do plugin e da loja que citam o comando mostram o nome novo.

- Os nomes aceitam de 2 a 20 letras minúsculas, números, `_` e `-`.
- Não dá para usar comandos do servidor, como `/help` e `/tp`, nem o mesmo nome em dois
  comandos.
- Se o nome novo já for de outro plugin, o console avisa e o comando fica como
  `/hystore:<nome>`.
- A seta ao lado de cada linha volta ao nome padrão.

Mudar pede a permissão **Configurar o plugin**, em
[Cargos de acesso](/pt/store/team/).