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

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o comportamento dos blocos de farm customizados. 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.

# Modo de depuração para correção de problemas no plugin.
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados dos blocos plantados 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: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yFarmBlock/data.db.

Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity). Essencial para redes onde jogadores podem plantar em um servidor e os blocos precisam persistir ao trocar de servidor.

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Quando usar Redis:

Rede BungeeCord/Velocity com múltiplos servidores
Sincronização em tempo real de blocos plantados entre servidores
Prevenir duplicação de itens ao trocar de servidor

Certifique-se de que o servidor Redis está acessível por todos os servidores da rede.

general

Configurações gerais do sistema de blocos customizados.

general:
  # Permitir quebrar blocos customizados somente com a "Removedora de Sementes"
  remove-only-with-seed-remover: true
  # Remover drops ao quebrar blocos que não estão com a "Removedora de Sementes"
  drop-break-remover: true
  # Item da removedora de sementes
  seed-remover:
    material: 'IRON_HOE'
    name: '&cRemovedora de Sementes'
    lore:
      - '&7Use esta ferramenta para'
      - '&7remover blocos plantados'
  # Lista de blocos que não poderá colocar no chão
  blocked-place-blocks:
    - 'CACTUS'
  # Lista de plantações que crescem verticalmente
  vertical-crops:
    - 'CACTUS'
    - 'SUGAR_CANE'
    - 'CANES'
    - 'BAMBOO'

remove-only-with-seed-remover

Quando ativado (true), blocos customizados só podem ser removidos usando a ferramenta especial "Removedora de Sementes". Isso impede que jogadores quebrem plantações acidentalmente ou que outros jogadores roubem suas plantações.

Recomendado: true para proteger investimentos dos jogadores.

drop-break-remover

Controla se os blocos customizados soltar drops quando quebrados sem usar a "Removedora de Sementes".

true (padrão): Não solta drops quando quebrados incorretamente. O bloco é perdido.
false: Solta drops normalmente mesmo sem usar a "Removedora de Sementes".

Exemplo:

drop-break-remover: true

Quando ativado, jogadores que tentarem quebrar blocos sem a ferramenta adequada perderão os itens plantados. Use true para punir quebramentos indevidos ou false para permitir acesso livre.

seed-remover

Configuração da ferramenta especial usada para remover blocos customizados.

material: Material do item (use nomes do Minecraft/Bukkit)
name: Nome exibido do item (suporta códigos de cor com &)
lore: Lista de linhas de descrição do item

Exemplo personalizado:

seed-remover:
  material: 'DIAMOND_HOE'
  name: '&6&lRemovedor Premium'
  lore:
    - '&7Ferramenta especial para'
    - '&7remover plantações customizadas'
    - ''
    - '&eClique direito para usar'

blocked-place-blocks

Lista de materiais vanilla (do Minecraft) que não podem ser plantados normalmente. Use esta lista para forçar jogadores a usar apenas as versões customizadas.

Exemplo:

blocked-place-blocks:
  - 'CACTUS'
  - 'SUGAR_CANE'
  - 'POTATO'
  - 'CARROT'

Com esta configuração, jogadores não conseguirão plantar cactos, cana-de-açúcar, batatas e cenouras vanilla - apenas as versões customizadas.

vertical-crops

Lista de plantações que crescem verticalmente (empilham para cima). O plugin usa esta lista para aplicar proteção anti-dupe, impedindo que blocos customizados se multipliquem ao crescer.

Importante: Sempre adicione aqui todos os blocos que crescem verticalmente.

vertical-crops:
  - 'CACTUS'        # Cacto cresce para cima
  - 'SUGAR_CANE'    # Cana cresce para cima (1.13+)
  - 'CANES'         # Cana cresce para cima (1.12 e inferior)
  - 'BAMBOO'        # Bambu cresce para cima

Se um bloco que cresce verticalmente não estiver nesta lista, jogadores podem explorar um dupe bug! Sempre adicione blocos verticais aqui.

material-mapping

Mapeamento de materiais vanilla para blocos customizados. Este sistema é usado pela API do plugin para converter plantios normais em plantios customizados automaticamente.

material-mapping:
  CACTUS: 'cactus'
  SUGAR_CANE: 'cane'
  CANES: 'cane'
  MELON_STEM: 'melon_seeds'
  PUMPKIN_STEM: 'pumpkin_seeds'
  POTATO: 'potato'
  CARROT: 'carrot'
  CROPS: 'wheat_seeds'

Formato: MATERIAL_VANILLA: 'id-do-bloco-customizado'

Como funciona:

Um jogador ou plugin tenta plantar CACTUS
O plugin verifica o mapeamento e encontra cactus
O bloco customizado cactus (definido em blocks) é plantado ao invés do vanilla

Exemplo de uso com a API:

// Quando um plugin externo planta um bloco, o yFarmBlock 
// converte automaticamente para a versão customizada
player.getWorld().getBlockAt(location).setType(Material.CACTUS);
// → O plugin detecta e converte para o bloco customizado 'cactus'

O mapeamento é essencial para integração com outros plugins e para converter plantios vanilla em customizados automaticamente.

blocks

Configuração de cada bloco customizado. Você pode criar quantos blocos quiser seguindo o padrão abaixo.

blocks:
  cactus:
    # Nome nas mensagens
    display-name: '&aCacto Customizado'
    # Item customizado
    item:
      material: 'CACTUS'
      name: '&aCacto Customizado'
      lore:
        - '&7Um cacto especial que'
        - '&7pode ser plantado no chão.'

Estrutura de cada bloco

Cada bloco customizado possui:

ID do bloco (exemplo: cactus, wheat_seeds) - Usado no comando /farmblock give
display-name: Nome exibido em mensagens do plugin
item: Configuração do item que o jogador recebe
- material: Material do Minecraft
- name: Nome do item no inventário
- lore: Descrição do item (múltiplas linhas)

Exemplos de blocos

Bloco vertical (Cacto):

blocks:
  cactus:
    display-name: '&aCacto Customizado'
    item:
      material: 'CACTUS'
      name: '&aCacto Customizado'
      lore:
        - '&7Um cacto especial que'
        - '&7pode ser plantado no chão.'
        - ''
        - '&aCactos customizados não causam dano!'

Sementes (Melancia):

blocks:
  melon_seeds:
    display-name: '&aSemente de Melancia Customizada'
    item:
      material: 'MELON_SEEDS'
      name: '&aSemente de Melancia Customizada'
      lore:
        - '&7Uma semente de MELANCIA especial que'
        - '&7pode ser plantada no chão.'
        - ''
        - '&eDrop: &f1-3 Melancias'

Cultivo (Batata):

blocks:
  potato:
    display-name: '&aBatata Customizada'
    item:
      material: 'POTATO_ITEM'
      name: '&aBatata Customizada'
      lore:
        - '&7Uma BATATA especial que'
        - '&7pode ser plantada no chão.'
        - ''
        - '&7Tempo de crescimento: &f5 minutos'

blocks:
  super_wheat:
    display-name: '&6Super Trigo'
    item:
      material: 'SEEDS'
      name: '&6&lSuper Trigo'
      lore:
        - '&7Trigo turbinado que cresce'
        - '&72x mais rápido!'

Adicione ao material-mapping (se necessário)

Se quiser que o plugin converta trigo vanilla para seu bloco:

material-mapping:
  CROPS: 'super_wheat'

Adicione às proteções (se vertical)

Se o bloco cresce para cima, adicione em vertical-crops:

vertical-crops:
  - 'BAMBOO'
  - 'SUPER_BAMBOO'  # Seu bloco customizado

Distribua para os jogadores

Use o comando:

/farmblock give <jogador> super_wheat 64

Blocos incluídos por padrão

O plugin vem com os seguintes blocos pré-configurados:

ID	Material	Tipo	Vertical?
`cactus`	CACTUS	Cacto	✅ Sim
`cane`	SUGAR_CANE	Cana-de-açúcar	✅ Sim
`melon_seeds`	MELON_SEEDS	Semente	❌ Não
`pumpkin_seeds`	PUMPKIN_SEEDS	Semente	❌ Não
`potato`	POTATO_ITEM	Cultivo	❌ Não
`carrot`	CARROT_ITEM	Cultivo	❌ Não
`wheat_seeds`	SEEDS	Semente	❌ Não

Use códigos de cor (&a, &6, &l, etc.) nos nomes e lores para deixar os itens mais atrativos!

Exemplo de configuração completa

Aqui está um exemplo de configuração completa e otimizada:

debug-mode: false

database:
  storage-type: HIKARI
  data:
    host: localhost
    port: 3306
    database: 'minecraft'
    username: 'root'
    password: 'senha123'

redis:
  enabled: true
  host: 'localhost'
  port: 6379
  username: ''
  password: ''

general:
  remove-only-with-seed-remover: true
  drop-break-remover: true
  seed-remover:
    material: 'DIAMOND_HOE'
    name: '&c&lRemovedora de Sementes'
    lore:
      - '&7Ferramenta especial para remover'
      - '&7blocos plantados customizados'
      - ''
      - '&cUse com cuidado!'
  blocked-place-blocks:
    - 'CACTUS'
    - 'SUGAR_CANE'
    - 'POTATO'
    - 'CARROT'
  vertical-crops:
    - 'CACTUS'
    - 'SUGAR_CANE'
    - 'CANES'
    - 'BAMBOO'

material-mapping:
  CACTUS: 'cactus'
  SUGAR_CANE: 'cane'
  POTATO: 'potato'
  CARROT: 'carrot'
  CROPS: 'wheat_seeds'

blocks:
  cactus:
    display-name: '&2Cacto Premium'
    item:
      material: 'CACTUS'
      name: '&2&lCacto Premium'
      lore:
        - '&7Cacto especial que não'
        - '&7causa dano aos jogadores!'