Loja para Minecraft

A entrega no Minecraft é feita por um plugin que roda no seu servidor. Ele consulta a Nexify de tempos em tempos e aplica as compras aprovadas.

Funciona em Spigot, Paper e Folia, da 1.8 à 1.21+.

1. Crie a loja#

Em Criar loja, escolha o tipo Minecraft. É o tipo que define quais ações aparecem em Comandos.

2. Instale o plugin#

Baixe o plugin
Em Configurações → Integrações, clique em Plugin Minecraft.
Coloque na pasta plugins
Jogue o .jar em plugins/ e reinicie o servidor uma vez para ele gerar a configuração.
Preencha o token
Em plugins/NexifyMinecraft/config.yml:
```
nexify:
  api-token: "SEU_TOKEN_DA_LOJA"
  poll-interval: 30
```
O token fica em Configurações → Integrações.
Reinicie de novo
Agora o plugin começa a consultar as entregas.

A entrega pode levar até 30 segundos

O plugin pergunta à Nexify a cada poll-interval segundos, e o padrão é 30. Não é travamento: é o intervalo. Dá para baixar o número, mas cada consulta é uma chamada à API.

3. Monte os comandos#

Em Comandos, crie uma variável e escolha as ações.

Ação	Argumento	Entrega
`minecraft:command`	o comando, com `{player}`	Roda qualquer comando no console
`minecraft:addItem`	`MATERIAL:quantidade`	Um item
`minecraft:removeItem`	`MATERIAL:quantidade`	Remove um item
`minecraft:addMoney`	valor	Deposita dinheiro
`minecraft:removeMoney`	valor	Retira dinheiro
`minecraft:addGroup`	nome do grupo	Adiciona a um grupo
`minecraft:removeGroup`	nome do grupo	Remove do grupo
`minecraft:addTempGroup`	`grupo:dias`	Grupo por tempo limitado

Dinheiro e grupos dependem do Vault

As ações de addMoney, removeMoney e as de grupo passam pelo Vault. Sem ele instalado (mais o plugin de economia ou de permissões correspondente), elas não têm como agir.

4. Rodar o comando do seu servidor#

É o caso mais comum, e o que resolve praticamente tudo: se o benefício que você vende vem de outro plugin, use minecraft:command.

O argumento é o comando inteiro, e {player} é trocado pelo nickname do comprador:

prismas add {player} 180 Compra na loja

lp user {player} parent addtemp vip 30d

crate give {player} lendaria 1

O comando roda no console, então não depende de o jogador ter permissão.

5. Se o jogador estiver offline#

A entrega não se perde. O plugin guarda numa fila local e aplica assim que ele entrar no servidor. Quando isso acontece, o jogador recebe uma mensagem no chat dizendo o que chegou.

Os textos dessas mensagens ficam no config.yml, em messages, e podem ser alterados.

6. Inventário cheio#

Por padrão, item que não cabe é dropado no chão, aos pés do jogador, com aviso no chat. Se preferir que a entrega espere em vez de dropar, mude no config.yml:

drop-items-when-full: false

7. O campo "Comprador"#

É o nickname do jogador no servidor. Vale reforçar isso na descrição do produto: nick digitado errado é a causa mais comum de compra que não chega.

8. Teste antes de divulgar#

Crie um produto de R$ 1, compre com o seu próprio nick e confira no jogo. Se não chegar, veja Resolvendo problemas.

Vê ações de FiveM na lista?

Confira se a loja está mesmo com o tipo Minecraft em Configurações. As ações do painel seguem o tipo da loja, e uma loja criada como FiveM mostra o vocabulário do FiveM.

AnteriorLoja dentro do jogo Próxima Palworld