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.

default.yml

animals.yml

bungeecord.yml

commands.yml

config.yml

crops.yml

economies.yml

enchants.yml

menus.yml

messages.yml

tools.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla XP, taxa, enxada, holograma, plantações em packet e scoreboard. 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 das fazendas 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/yFazenda/data.db.

redis

Configurações do servidor Redis. Deixe enabled: false se não for usar.

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: ''

Delay em ticks para carregar os dados do jogador após o login. Necessário para usar em servidor de mina separado.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

20 ticks equivale a 1 segundo.

general

Sistemas gerais da fazenda. Este bloco controla XP, taxa, enxada, limites, holograma e sons.

general:
  # XP base usado no cálculo do próximo nível. Fórmula: xp-base * (nível ^ xp-exponent)
  xp-base: 100.0
  # Expoente da curva de XP. Valores maiores deixam o level-up mais difícil.
  xp-exponent: 1.45
  # Taxa padrão (%) cobrada de visitantes/amigos sobre o ganho da colheita. Destinada ao dono.
  default-tax: 10.0
  # Máximo de amigos que um jogador pode autorizar na fazenda.
  max-friends: 10
  # Se true, só é possível colher usando a enxada da fazenda (NBT yFazenda-Hoe).
  hoe-required: true
  # Se true, entrega a enxada automaticamente ao entrar na fazenda.
  give-hoe-on-enter: true
  # Se true, remove a enxada do inventário ao sair da fazenda.
  remove-hoe-on-exit: true
  # Limite de colheitas por segundo (anti-abuso). 0 = sem limite.
  harvest-limit-per-second: 20
  # Intervalo (em ticks) para processar a produção dos animais virtuais. 100 ticks = 5 segundos.
  animal-check-interval-ticks: 100
  # Intervalo (em ticks) para regenerar plantações colhidas. 20 ticks = 1 segundo.
  regen-check-interval-ticks: 20
  # Se true, entrar na cuboid da fazenda carrega os packets automaticamente. Desativado: só /fazenda ir e /fazenda sair.
  auto-enter: false
  # Máximo de visitantes simultâneos em fazendas públicas.
  max-public-visitors: 8
  # Fly ao entrar na fazenda (desliga ao sair).
  fly: true

Destaques importantes:

xp-base / xp-exponent: próximo nível = xp-base * (nível ^ xp-exponent)
default-tax: taxa padrão (%) cobrada de visitantes/amigos, destinada ao dono
hoe-required: se true, só colhe com a enxada (NBT yFazenda-Hoe)
harvest-limit-per-second: 0 = sem limite
auto-enter: se false, só entra/sai com /fazenda ir e /fazenda sair

Exemplo: nível 5 com os valores padrão:

XP necessário: 100.0 * (5 ^ 1.45)

Menu de encantamentos ao clicar com a enxada.

  hoe-enchants-menu:
    # Se true, botão direito na enxada abre o menu de encantamentos
    enabled: true
    # Se true, precisa shift + botão direito. Se false, só botão direito.
    require-shift: true

enabled: true — botão direito na enxada abre o menu
require-shift: true — precisa shift + botão direito
require-shift: false — só botão direito

hologram

Holograma em packet ao colher.

  hologram:
    # Se true, mostra holograma em packet ao colher
    enabled: true
    # Offset Y da primeira linha acima do bloco colhido
    offset: -1
    # Espaço entre linhas do holograma
    line-spacing: 0.25
    # Linhas do holograma. Placeholders: {crop} {amount} {coins} {tax} {xp} {player}
    lines:
      - '&6+{coins}'
      - '&7{crop} &fx{amount}'
      - '&e+{xp} XP'

Placeholders das linhas: {crop} {amount} {coins} {tax} {xp} {player}

plant-blocks

Materiais usados no /fazendaadmin define para achar onde cada planta fica. A plantação em packet é colocada 1 bloco acima deste material.

  plant-blocks:
    - SOIL
    - FARMLAND

1.8: SOIL
1.13+: FARMLAND

sounds

Sons (nomes de Sound do Bukkit). Use aspas.

  sounds:
    # Som ao concluir uma ação com sucesso (compra, level-up, entrar).
    action-success: 'ENTITY_EXPERIENCE_ORB_PICKUP'
    # Som ao falhar uma ação (sem saldo, sem permissão).
    action-fail: 'ENTITY_VILLAGER_NO'
    # Som ao colher uma plantação.
    harvest: 'BLOCK_GRASS_BREAK'
    # Som ao ativar encantamento com animação.
    enchant: 'ENTITY_LIGHTNING_THUNDER'

Som	Quando dispara
`action-success`	Compra, level-up, entrar
`action-fail`	Sem saldo, sem permissão
`harvest`	Colher uma plantação
`enchant`	Ativar encantamento com animação

scoreboard

Scoreboard exibida ao entrar na fazenda.

scoreboard:
  enabled: true
  title: '&a&lFazenda'
  lines:
    - '&7     Área de cultivo'
    - ''
    - '&f Fazenda: &7{farm}'
    - '&f Dono: &7{owner}'
    - ''
    - '&e Progresso'
    - '&8  ❘&f Nível: &7{level}'
    - '&8  ❘&f XP: &7{xp}/{xp_next}'
    - '&8  ❘&f Colhido: &7{harvested}'
    - ''
    - '&f Moedas: &a{coins}'
    - '&f Plantação: &7{crop}'
    - '&f Expansão: &7{expansion}'
    - ''
    - '&a    ystoreplugins.com.br'

Placeholders: {player} {owner} {farm} {coins} {level} {xp} {xp_next} {harvested} {expansion} {crop} {tax} {friends} {animals} {tool}

Nesta página