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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml controla todo o comportamento do sistema de stack de drops. Abaixo estão todas as opções disponíveis com explicações detalhadas.

general

Configurações gerais do sistema de stack de itens.

general:
  # Raio para stackar os itens
  # em blocos
  stack-radius: 5
  # Som ao pegar um item
  sound: ITEM_PICKUP
  # Lista de mundos que o plugin não irá funcionar
  world-blacklist: []
  # Lista de materiais que não serão stackados
  material-blacklist: []
  # Lista de NBT-TAGS que não serão stackadas
  nbt-tag-blacklist: []

stack-radius

Define o raio em blocos para agrupar itens próximos. Quanto maior o valor, mais itens distantes serão agrupados juntos.

general:
  stack-radius: 5

Valores recomendados:

• Servidores pequenos (até 50 players): 5-7 blocos
• Servidores médios (50-150 players): 3-5 blocos
• Servidores grandes (150+ players): 2-3 blocos

sound

Som reproduzido quando um jogador coleta um item stackado.

general:
  sound: ITEM_PICKUP

Sons populares:

• ITEM_PICKUP - Som padrão de coleta (recomendado)
• ENTITY_EXPERIENCE_ORB_PICKUP - Som de experiência
• BLOCK_NOTE_BLOCK_PLING - Som agudo de nota musical

world-blacklist

Lista de mundos onde o plugin não funcionará. Útil para desativar o sistema em lobbies ou mundos específicos.

general:
  world-blacklist: []

Exemplo de uso:

general:
  world-blacklist: ['world_the_end', 'lobby', 'spawn']

material-blacklist

Lista de materiais que não serão stackados. Use para itens especiais que precisam permanecer separados.

general:
  material-blacklist: []

Exemplo de uso:

general:
  material-blacklist: ['DIAMOND', 'EMERALD', 'NETHERITE_INGOT', 'NETHER_STAR']

Quando usar:

• Itens raros que você quer que os jogadores vejam individualmente
• Itens com valor especial no servidor (tokens, moedas customizadas)
• Itens de eventos especiais

nbt-tag-blacklist

Lista de NBT tags que não serão stackadas. Itens com essas tags permanecerão separados mesmo se forem do mesmo tipo.

general:
  nbt-tag-blacklist: []

Exemplo de uso:

general:
  nbt-tag-blacklist: ['CustomModelData', 'display', 'custom_item']

Quando usar:

• Itens customizados de plugins (ex: itens de RPG com atributos únicos)
• Itens com texturas personalizadas (CustomModelData)
• Itens renomeados ou com lore especial

spawn-blacklist

Sistema de blacklist específico para itens spawnados naturalmente pelo jogo (como cactos de farms, cana-de-açúcar, etc). Esta blacklist não afeta itens dropados por jogadores.

spawn-blacklist:
  # Lista de materiais que não serão stackados naturalmente
  material: [ 'CACTUS' ]
  # Lista de NBT-TAGS que não serão stackadas naturalmente
  nbt-tag: []

material

Lista de materiais que não serão stackados quando spawnados naturalmente.

spawn-blacklist:
  material: ['CACTUS']

Exemplo avançado:

spawn-blacklist:
  material: ['CACTUS', 'SUGAR_CANE', 'KELP', 'BAMBOO']

Diferença entre blacklists:

Caso de uso prático:

# Cactos de farms não stackam, mas cactos quebrados por jogadores stackam normalmente
spawn-blacklist:
  material: ['CACTUS']

nbt-tag

Lista de NBT tags que não serão stackadas quando spawnadas naturalmente.

spawn-blacklist:
  nbt-tag: []

Exemplo de uso:

spawn-blacklist:
  nbt-tag: ['farm_item', 'generator_drop']

Útil se outros plugins adicionam tags NBT em itens gerados automaticamente.

custom-name

Sistema de nome customizado exibido acima dos itens stackados no chão. Permite visualizar a quantidade de itens agrupados.

custom-name:
  # Ativar o sistema
  enabled: true
  # Formato do nome
  format: '&f{amount}x &a{material}'

enabled

Ativa ou desativa a exibição de nomes acima dos stacks.

custom-name:
  enabled: true

• true - Exibe nomes customizados (recomendado)
• false - Itens ficam sem identificação visual

format

Define o formato do nome exibido acima dos itens stackados.

custom-name:
  format: '&f{amount}x &a{material}'

Placeholders disponíveis:

Exemplos de formatação:

# Formato simples e limpo
custom-name:
  format: '&f{amount}x &a{material}'
# Resultado: 64x DIAMOND

# Formato destacado com colchetes
custom-name:
  format: '&e&l[&6{amount}x&e&l] &f{material}'
# Resultado: [64x] DIAMOND

# Formato minimalista
custom-name:
  format: '&7{amount}x &e{material}'
# Resultado: 64x DIAMOND

# Formato com símbolos
custom-name:
  format: '&a⚡ &f{amount}x &b{material}'
# Resultado: ⚡ 64x DIAMOND

Códigos de cor disponíveis:

Formatação adicional:

• &l - Negrito
• &o - Itálico
• &n - Sublinhado
• &m - Riscado

Exemplo de configuração otimizada

Abaixo está uma configuração recomendada para a maioria dos servidores:

general:
  stack-radius: 4
  sound: ITEM_PICKUP
  world-blacklist: ['world_lobby']
  material-blacklist: ['NETHER_STAR', 'DIAMOND', 'EMERALD']
  nbt-tag-blacklist: ['CustomModelData', 'custom_item']

spawn-blacklist:
  material: ['CACTUS', 'SUGAR_CANE']
  nbt-tag: []

custom-name:
  enabled: true
  format: '&e&l[&6{amount}x&e&l] &f{material}'

Esta configuração:

• Usa raio de 4 blocos (balanceado)
• Desativa o plugin no lobby
• Não stacka itens raros e customizados
• Previne stack de itens de farms de cacto/cana
• Exibe nomes destacados e legíveis