Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

commands.yml

config.yml

economies.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento do sistema de trocas. Abaixo estão todas as opções disponíveis com explicações detalhadas.

general

Configurações gerais do sistema de trocas entre jogadores.

general:
  # Ativar enviar pedido de troca ao interagir com um jogador
  # (clicar com o botão direito nele)
  interact-trade: true
  # Ativar enviar pedido de troca ao interagir com um jogador
  # (clicar com o shift+botão direito nele)
  interact-shift-trade: true
  # Distância máxima entre blocos que irá permitir a troca entre jogadores
  # deixe 0 para não usar
  max-distance: 0

interact-trade

Permite que jogadores enviem solicitação de troca ao clicar com o botão direito em outro jogador.

true - Ativa o sistema de interação (recomendado)
false - Desativa, apenas /trocar [player] funcionará

Quando usar:

Mantenha ativado para proporcionar uma experiência mais intuitiva aos jogadores. Útil especialmente em servidores survival e RPG.

interact-shift-trade

Permite que jogadores enviem solicitação de troca ao clicar com shift + botão direito em outro jogador.

true - Ativa o sistema de interação com shift
false - Desativa a interação com shift

Diferença entre interact-trade e interact-shift-trade:

Você pode ativar ambos para dar aos jogadores duas formas de interação, ou escolher apenas uma para evitar solicitações acidentais.

max-distance

Define a distância máxima em blocos entre os jogadores para realizar trocas.

general:
  max-distance: 0  # Sem limite de distância

Exemplos de uso:

general:
  max-distance: 10  # Apenas jogadores a até 10 blocos podem trocar

general:
  max-distance: 0  # Jogadores podem trocar de qualquer lugar do mundo

Defina 0 para permitir trocas sem limite de distância. Útil em servidores onde jogadores estão espalhados pelo mapa.

Recomendações:

Servidores Survival/RPG: max-distance: 5 a 10 para manter realismo
Servidores Economy/Skyblock: max-distance: 0 para facilitar comércio à distância

black-list

Sistema de blacklist para bloquear itens específicos do sistema de trocas. Útil para prevenir a circulação de itens proibidos ou valiosos demais.

black-list:
  # Materiais que estarão na black-list
  materials: [ 'STONE', 'LOG:0' ]
  # NBTTags que estarão na black-list
  nbt-tags: []

materials

Lista de materiais que não podem ser trocados entre jogadores.

Formato de materiais:

'MATERIAL' - Bloqueia o material em qualquer data/variação
'MATERIAL:DATA' - Bloqueia apenas a variação específica

Exemplos práticos:

black-list:
  # Bloquear itens comuns e baratos
  materials: [ 'STONE', 'DIRT', 'COBBLESTONE' ]

black-list:
  # Bloquear itens valiosos e raros
  materials: [ 'BEDROCK', 'COMMAND_BLOCK', 'BARRIER', 'STRUCTURE_BLOCK' ]

black-list:
  # Bloquear spawners específicos
  materials: [ 'MOB_SPAWNER:0', 'SPAWNER' ]

nbt-tags

Lista de NBT tags que não podem ser trocadas. Útil para bloquear itens customizados específicos.

Exemplo de uso:

black-list:
  nbt-tags: [ 'CustomItem', 'RareWeapon', 'EventReward' ]

Qualquer item que contenha essas tags NBT será bloqueado do sistema de trocas.

Cuidado ao bloquear itens muito comuns. Isso pode frustrar os jogadores. Bloqueie apenas itens que realmente não devem circular.

Recomendações:

Bloqueie itens administrativos: BEDROCK, COMMAND_BLOCK, BARRIER
Bloqueie itens de eventos especiais via NBT tags
Evite bloquear recursos básicos como madeira, pedra, etc.

white-list

Sistema de whitelist para restringir o sistema de trocas a apenas itens específicos. Quando ativado, apenas os itens listados poderão ser trocados.

white-list:
  # Ativar a whitelist
  enabled: false
  # Materiais que estarão na white-list
  materials: [ 'LOG:1', 'TRIPWIRE_HOOK' ]

enabled

Ativa ou desativa o sistema de whitelist.

true - Apenas itens listados podem ser trocados
false - Todos os itens podem ser trocados (exceto os da blacklist)

Quando a whitelist está ativada, apenas os materiais listados em materials poderão ser trocados. Use com cuidado!

materials

Lista de materiais que podem ser trocados quando a whitelist está ativa.

Exemplo - Apenas recursos básicos:

white-list:
  enabled: true
  materials: [ 'DIAMOND', 'EMERALD', 'GOLD_INGOT', 'IRON_INGOT' ]

Exemplo - Apenas itens de fazenda:

white-list:
  enabled: true
  materials: [ 'WHEAT', 'CARROT', 'POTATO', 'BEETROOT', 'MELON', 'PUMPKIN' ]

Quando usar whitelist:

Servidores com economia muito controlada
Eventos específicos onde apenas certos itens devem circular
Servidores temáticos (ex: apenas itens de fazenda, apenas minérios, etc)

Diferença entre blacklist e whitelist:

Sistema	Comportamento
Blacklist	Todos os itens são permitidos, exceto os listados
Whitelist	Todos os itens são bloqueados, exceto os listados

Você não pode usar blacklist e whitelist ao mesmo tempo. Se whitelist estiver ativa (enabled: true), a blacklist será ignorada.

Recomendação:

Para a maioria dos servidores, use apenas a blacklist e deixe a whitelist desativada. A whitelist é muito restritiva e deve ser usada apenas em casos específicos.

Nesta página