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 é onde você controla todos os aspectos do funcionamento do auto-pickup. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

database

Define como e onde os dados dos jogadores serão armazenados. O plugin suporta três tipos de armazenamento:

• SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
• MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
• HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

login-delay

Delay em ticks para carregar os dados do jogador após o login. Essencial quando usa servidor de mina separado com proxy.

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks
login-delay: 20

Quando ajustar:

• Servidores com proxy (BungeeCord/Velocity): mantenha em 20 ticks
• Servidor único: pode reduzir para 5 ticks
• Problemas de sincronia: aumente para 40 ticks

general

Configurações gerais que controlam o comportamento do sistema de auto-pickup.

general:
  # Lista de mundos que o plugin não irá funcionar
  world-blacklist: []
  # Lista de blocos que não serão afetados pelo auto-pickup
  block-blacklist:
    - 'SHULKER_BOX'
  # Lista de blocos com certas metadatas que não serão afetados pelo auto-pickup
  metadata-blacklist:
    - 'yfactions-tnt-impulse'
  # Lista de blocos que a fortuna irá aplicar
  fortune-whitelist:
    - 'COAL_ORE'
    - 'REDSTONE_ORE'
    - 'GLOWING_REDSTONE_ORE'
    - 'DIAMOND_ORE'
    - 'EMERALD_ORE'
  # Lista de blocos que a fortuna irá aplicar quando o smelt estiver ativado
  smelt-fortune-whitelist:
    - 'IRON_ORE'
    - 'GOLD_ORE'
  # Lista de blocos que a silk-touch irá aplicar
  silk-touch-whitelist:
    - 'COAL_ORE'
    - 'REDSTONE_ORE'
    - 'GLOWING_REDSTONE_ORE'
    - 'DIAMOND_ORE'
    - 'EMERALD_ORE'

Explicação dos parâmetros:

• world-blacklist: Desabilita o plugin em mundos específicos. Útil para lobbies ou mundos de eventos.

  world-blacklist:
    - 'world_lobby'
    - 'world_evento'

• block-blacklist: Blocos que nunca serão coletados automaticamente, mesmo com auto-pickup ativo. Previne problemas com shulker boxes e outros itens especiais.

• metadata-blacklist: Ignora blocos com metadatas específicas. Exemplo: yfactions-tnt-impulse previne coleta de TNT de cannons.

• fortune-whitelist: Blocos onde o encantamento Fortuna será aplicado. Apenas minérios que dropam múltiplos itens devem estar aqui.

• smelt-fortune-whitelist: Blocos onde Fortuna funciona mesmo com auto-smelt ativo. Por padrão, ferro e ouro derreteriam sem multiplicar, mas esta lista permite a multiplicação.

• silk-touch-whitelist: Blocos que respeitam o encantamento Toque Suave. Permite minerar o bloco inteiro ao invés dos drops normais.

block-creative

Desativa o auto-pickup quando o jogador está no modo criativo. Evita problemas com jogadores em modo criativo coletando itens indesejadamente.

general:
  # Desativar o auto-pickup caso esteja no criativo
  block-creative: false
  # Ativar o auto-pickup ao logar
  auto-pickup-on-login: false
  # Ativar o auto-smelt ao logar
  auto-smelt-on-login: false
  # Ativar o auto-compact ao logar
  auto-compact-on-login: false

Quando usar:

• true - Auto-pickup é desativado para jogadores em modo criativo
• false - Auto-pickup funciona normalmente, mesmo em criativo

Exemplo prático:

general:
  block-creative: true

Com esta configuração:

• Jogadores em modo criativo não coletarão itens automaticamente
• Apenas jogadores em modo survival/adventure terão auto-pickup ativo
• Evita interferências com testes de staff ou construção

hooks

Sistema de integração com outros plugins da yStore.

hooks:
  # Ativar o AutoPickup nas minas do yMinas
  yminas: true

Quando ativado, o auto-pickup funciona perfeitamente com o sistema de minas do yMinas, respeitando configurações específicas de cada mina.

entity

Sistema de auto-pickup para drops de entidades mortas. Coleta automaticamente itens de mobs.

entity:
  enabled: true
  # Lista de entidades que não serão afetados pelo auto-pickup
  blacklist: []
  # Lista de entidades que serão afetados pelo auto-pickup
  # deixe [] para desativar
  whitelist: ['ZOMBIE', 'COW', 'SHEEP', 'SKELETON', 'SPIDER', 'PIG', 'PIG_ZOMBIE', 'BLAZE']
  # Lista de entidades com certas metadatas que não serão afetados pelo auto-pickup
  metadata-blacklist:
    - 'ySpawnersV2-MobStacked'
    - 'ySpawners-MobStacked'

Explicação:

• enabled: Ativa/desativa o auto-pickup de entidades.
• blacklist: Entidades específicas que não terão drops coletados automaticamente.

  blacklist:
    - 'IRON_GOLEM'
    - 'VILLAGER'

• whitelist: Entidades específicas que apenas terão drops coletados automaticamente. Se a whitelist estiver vazia ([]), o auto-pickup funcionará com todas as entidades (exceto as da blacklist).

  # Apenas drops de Zombie, Skeleton e Creeper serão coletados
  whitelist:
    - 'ZOMBIE'
    - 'SKELETON'
    - 'CREEPER'

• metadata-blacklist: Ignora mobs com metadatas específicas. Essencial para compatibilidade com plugins de spawners que empilham mobs.

Como funcionam blacklist e whitelist:

1. Se whitelist está vazia ([]):

   • Auto-pickup funciona com todas as entidades
   • Exceto aquelas listadas em blacklist

2. Se whitelist tem valores:

   • Auto-pickup funciona apenas com entidades listadas
   • A blacklist é ignorada neste caso

Exemplo prático:

entity:
  enabled: true
  # Apenas mobs de farm (sem bosses)
  whitelist:
    - 'ZOMBIE'
    - 'SKELETON'
    - 'SPIDER'
    - 'COW'
    - 'PIG'
    - 'SHEEP'
  blacklist: []

Com esta configuração:

• Apenas drops de Zombie, Skeleton, Spider, Cow, Pig e Sheep serão coletados
• Bosses e outros mobs não terão drops coletados
• Perfeito para farms específicas

block-mcmmo-xp-list

Integração com mcMMO para dar experiência ao quebrar blocos com auto-pickup ativo. Formato: BLOCO,SKILL-XP

block-mcmmo-xp-list:
  - 'COAL_ORE,MINING-1'
  - 'REDSTONE_ORE,MINING-1'
  - 'GLOWING_REDSTONE_ORE,MINING-1'
  - 'IRON_ORE,MINING-2'
  - 'GOLD_ORE,MINING-3'
  - 'DIAMOND_ORE,MINING-4'
  - 'EMERALD_ORE,MINING-5'

Como funciona:

• Primeiro valor: Material do bloco
• Segundo valor: Skill do mcMMO
• Terceiro valor: Quantidade de XP concedida

Skills disponíveis: MINING, EXCAVATION, WOODCUTTING, HERBALISM

Exemplo prático:

• DIAMOND_ORE,MINING-4 = Quebrar diamante dá 4 XP de mineração
• OAK_LOG,WOODCUTTING-1 = Quebrar tronco dá 1 XP de woodcutting

entity-mcmmo-xp-list

Integração com mcMMO para dar experiência ao matar entidades com auto-pickup ativo. Formato: ENTIDADE,SKILL-XP

entity-mcmmo-xp-list:
  - 'ZOMBIE,SWORDS-1'
  - 'SKELETON,SWORDS-1'
  - 'SPIDER,SWORDS-1'
  - 'IRON_GOLEM,SWORDS-2'
  - 'SNOW_GOLEM,SWORDS-3'
  - 'ENDERMAN,SWORDS-4'
  - 'CREEPER,SWORDS-5'

Skills de combate disponíveis: SWORDS, AXES, ARCHERY, TAMING

Exemplo prático:

• CREEPER,SWORDS-5 = Matar creeper dá 5 XP de espadas
• SKELETON,ARCHERY-2 = Matar esqueleto com arco dá 2 XP de arquearia

auto-smelt-list

Define quais blocos são automaticamente derretidos quando quebrados com auto-smelt ativo. Formato: BLOCO,RESULTADO-QUANTIA

auto-smelt-list:
  - 'IRON_ORE,IRON_INGOT-1'
  - 'GOLD_ORE,GOLD_INGOT-1'

Como funciona:

Quando um jogador com auto-smelt ativo quebra minério de ferro, ao invés de receber o minério bruto, recebe diretamente a barra de ferro.

Adicionando novos itens:

auto-smelt-list:
  - 'IRON_ORE,IRON_INGOT-1'
  - 'GOLD_ORE,GOLD_INGOT-1'
  - 'SAND,GLASS-1'
  - 'COBBLESTONE,STONE-1'
  - 'NETHERRACK,NETHER_BRICK-1'

Formato:

• Primeiro valor: Material original
• Segundo valor: Material resultante após derretimento
• Terceiro valor: Quantidade do resultado

custom-drops

Permite configurar drops customizados por bloco. Use quando quiser substituir ou complementar drops específicos, incluindo blocos com data em versões antigas.

# Sistema de drops customizados por bloco
# block: BLOCO ou BLOCO:DATA
# drops: MATERIAL-QUANTIA ou MATERIAL:DATA-QUANTIA
# Exemplo de drop com data: 'INK_SACK:3-1'
custom-drops:
  trigo:
    block: 'CROPS:7'
    drops:
      - 'WHEAT-1'
      - 'SEEDS-1'

Formato:

• block: bloco que será detectado pelo sistema.
• drops: lista de itens entregues ao quebrar o bloco.
• Cada drop segue o formato MATERIAL-QUANTIA ou MATERIAL:DATA-QUANTIA.

auto-compact

Sistema de auto-compactação de itens. Quando o jogador segura SHIFT e tem auto-compact ativo, converte automaticamente itens agrupáveis.

auto-compact:
  item1:
    need-item:
      material: 'IRON_INGOT'
      amount: 9
      hideAttributes: false
      hidePotionEffects: false
      hideUnbreakable: false
      hideDestroys: false
      hidePlacedOn: false
      hideEnchants: false
      disableMetadata: true
    give-item:
      material: 'IRON_BLOCK'
      amount: 1
      hideAttributes: false
      hidePotionEffects: false
      hideUnbreakable: false
      hideDestroys: false
      hidePlacedOn: false
      hideEnchants: false
      disableMetadata: true

Como funciona:

Quando o jogador pressiona SHIFT com auto-compact ativo, o plugin verifica o inventário. Se houver 9 barras de ferro, automaticamente converte em 1 bloco de ferro.

Criando novas conversões:

auto-compact:
  item1:
    need-item:
      material: 'IRON_INGOT'
      amount: 9
    give-item:
      material: 'IRON_BLOCK'
      amount: 1
  item2:
    need-item:
      material: 'GOLD_INGOT'
      amount: 9
    give-item:
      material: 'GOLD_BLOCK'
      amount: 1
  item3:
    need-item:
      material: 'DIAMOND'
      amount: 9
    give-item:
      material: 'DIAMOND_BLOCK'
      amount: 1

Propriedades dos itens:

• material: Material do item (obrigatório)
• amount: Quantidade necessária ou dada (obrigatório)
• hideAttributes: Oculta atributos como dano/velocidade de ataque
• hidePotionEffects: Oculta efeitos de poções
• hideUnbreakable: Oculta a tag "Inquebrável"
• hideDestroys: Oculta lista de blocos que pode destruir
• hidePlacedOn: Oculta lista de blocos onde pode ser colocado
• hideEnchants: Oculta encantamentos
• disableMetadata: Se true, ignora NBT/metadata do item na conversão

Exemplo de conversão customizada:

auto-compact:
  compact_emerald:
    need-item:
      material: 'EMERALD'
      amount: 9
      disableMetadata: true
    give-item:
      material: 'EMERALD_BLOCK'
      amount: 1
      disableMetadata: true