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.

bungeecord.yml

classes.yml

commands.yml

config.yml

data.yml

economies.yml

enchantments.yml

fishs.yml

menus.yml

messages.yml

rewards.yml

rods.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento da pesca. 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

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

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

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

redis

Configurações do servidor Redis para sincronização de dados entre múltiplos servidores. Necessário apenas em redes BungeeCord/Velocity para manter os dados sincronizados em tempo real.

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

Redis é essencial se você tem múltiplos servidores com yPesca conectados via BungeeCord/Velocity para manter os dados de pesca sincronizados.

Configurações de sistema

invisibility

Ativa a invisibilidade na área de pesca. Jogadores não verão outros jogadores pescando.

invisibility: false

evolute-crescent

Define se o jogador deverá evoluir uma vara por vez, seguindo ordem crescente.

evolute-crescent: true

true - Jogador deve ter vara nível 1 antes de comprar nível 2
false - Pode comprar qualquer vara diretamente

sum-evolute

Somar um nível a mais na evolução da vara.

sum-evolute: true

Ativa o menu de confirmação de compra. Evita compras acidentais.

confirm-menu: true

bolsa

Ativa integração com plugins de bolsa de valores (yBolsa, StormEconomy ou HeroBolsa).

bolsa: true

Quando ativado, os valores de venda de peixes flutuam conforme a bolsa.

pvp

Ativa ou desativa o PvP na área de pesca.

pvp: false

Mantenha desativado para criar uma zona segura de pesca.

classes

Ativa o sistema de classes. Jogadores podem evoluir classes para ganhar bônus.

classes: true

classes-ordered

Define se para evoluir as classes o jogador deverá seguir a ordem delas.

classes-ordered: true

Sistema de NPC

Configuração do NPC que marca a área de pesca.

npc:
  skin: 'Pitombaa'
  hologram:
    offset: 3.4
    hologram:
      - '&6&lPESCA'
      - '&7Pesque peixes no servidor!'
      - '[item]EMERALD'

Opções:

skin: Nome de jogador do Minecraft para usar como skin do NPC
offset: Altura do holograma acima do NPC (em blocos)
hologram: Linhas do holograma (use [item]MATERIAL para exibir itens)

Sistema de pesca (fishing)

Configurações relacionadas ao ato de pescar.

fishing:
  # Raio de detecção de água perto ou quando clicar para pescar (em blocos)
  water-radius: 10.0
  # Ativar a verificação de água por perto (quando se afastar, para de pescar)
  # Pode gerar lag
  verify-has-water: false
  # Cancelar quando o peixe vanila encostar na vara
  cancel-fish-interact: false

Detalhes importantes:

water-radius: Distância máxima da água para começar a pescar
verify-has-water: Se true, verifica constantemente se há água próxima (pode causar lag)
cancel-fish-interact: Cancela o sistema de pesca vanilla do Minecraft

Sistema de horário

Limite o horário em que os jogadores podem pescar.

fishing:
  time:
    enabled: false
    # Calibre o horário do plugin (Brasil: GMT-3)
    gmt-offset: -3
    # Horário de início
    from: '10:00'
    # Horário de término
    to: '18:00'

Exemplo de uso:

fishing:
  time:
    enabled: true
    gmt-offset: -3  # Horário de Brasília
    from: '06:00'   # 6h da manhã
    to: '22:00'     # 10h da noite

Jogadores só poderão pescar entre 6h e 22h.

Sacola de peixes (fishing-net)

Sistema que armazena temporariamente os peixes pescados.

fishing:
  fishing-net:
    # Limite padrão de peixes que poderá ser armazenado
    # Recomendado: 30
    # Deixe 0 para ser infinito
    limit: 40
    # Limite máximo de peixes que poderá ser armazenado
    limit-max: 200
    # Limite adquirido por upgrade na sacola
    limit-per-level: 10
    # Multiplicar o preço pelo nível do upgrade
    # Cálculo: (nível + 1) * amount
    multiply-per-level: false
    # Preços para upar a sacola de peixe
    # Todas as economias listadas serão cobradas (AND)
    limit-prices:
      price1:
        provider: 'money'
        amount: 100.0

Como funciona:

Jogador começa com limite de 40 peixes
Pode fazer upgrade pagando 100 coins
Cada upgrade aumenta +10 peixes no limite
Limite máximo absoluto: 200 peixes

Sistema de sell-all

Configuração para vender todos os peixes de uma vez.

fishing:
  sell-all:
    # Ativar o sell-all em async (recomendado para muitos peixes)
    async: true
    # Fechar o menu ao vender tudo
    close-menu: true
    # Limite de itens vendidos pelo sell-all
    # Recomendado: 40
    # Deixe 0 para ser infinito
    limit: 40
  # Fechar o menu ao vender um peixe individual
  sell-close-menu: true

O modo async: true processa a venda em segundo plano, evitando travamentos quando há muitos peixes.

Sistema de scoreboard

Scoreboard personalizada exibida na área de pesca.

scoreboard:
  enabled: true
  title: '&b&lyStore'
  # Delay para atualizar a scoreboard (em segundos)
  delay: 1
  lines:
    - '&7         Área de pesca'
    - ''
    - '&f Status: &r{status}'
    - ''
    - '&f Peixes pescados: &7{fished}'
    - '&f Tempo pescando: &7{time}'
    - ''
    - '&e Vara'
    - '&8  ❘&f Nível: &7{level}'
    - '&8  ❘&f Corais: &7{coin_has}/{coin_next}'
    - '&8  ❘ {progressbar}'
    - ''
    - '&f Coins: &2$&a{money}'
    - ''
    - '&b    ystoreplugins.com.br'

Placeholders disponíveis:

Placeholder	Descrição
`{status}`	Status atual (Pescando/Inativo)
`{fished}`	Quantidade de peixes pescados
`{time}`	Tempo total pescando
`{level}`	Nível da vara atual
`{coin_has}`	Corais atuais
`{coin_next}`	Corais necessários para próximo nível
`{progressbar}`	Barra de progresso
`{money}`	Saldo do jogador

Itens padrões do jogador

Itens que aparecem no inventário do jogador na área de pesca.

items:
  rod-slot: 1
  # Item utilizado para que o jogador veja os drops (peixes) armazenados/pescados
  fishing-net:
    material: '4cb3acdc11ca747bf710e59f4c8e9b3d949fdd364c6869831ca878f0763d1787'
    slot: 4
    name: '&bSacola de peixes'
    lore:
      - '&7Clique para gerenciar os'
      - '&7seus peixes pescados.'
  # Item utilizado para que o jogador saia da pesca
  exit:
    material: 'BARRIER:0'
    slot: 7
    name: '&cSair da pesca'
    lore:
      - '&7Clique para sair da'
      - '&7área de pesca.'
  # Item de acesso às classes
  classes:
    material: 'LEATHER_CHESTPLATE:0'
    slot: 6
    name: '&bClasses'
    lore:
      - ' &7As classes irão te dar mais'
      - ' &7chance e coins ao pescar!'
      - ''
      - '&fSua classe: &7{classe}'
      - ''
      - '&aClique para upar sua classe'
  # Item utilizado para ativar a visibilidade
  visibility-off:
    material: INK_SACK:8
    slot: 8
    name: '&eVisibilidade'
    lore:
      - '&7Atualmente a visibilidade dos'
      - '&7jogadores está desabilitada.'
      - ''
      - '&aClique para habilitar.'
  # Item utilizado para desativar a visibilidade
  visibility-on:
    material: INK_SACK:10
    slot: 8
    name: '&eVisibilidade'
    lore:
      - '&7Atualmente a visibilidade dos'
      - '&7jogadores está habilitada.'
      - ''
      - '&aClique para desabilitar.'

Clique nos itens visibility-off / visibility-on na hotbar para alternar se outros jogadores ficam visíveis na área de pesca.

Slots do inventário:

Slot 0 = primeiro slot do inventário (canto superior esquerdo)
Slot 8 = último slot da primeira linha
Slot 1 = vara de pesca (padrão)

Sistema de comandos na pesca

Controle quais comandos podem ser usados durante a pesca.

commands:
  # Lista de comandos permitidos na pesca
  allowed: [ '/g', '/l', '/pesca' ]
  # Lista de comandos para sair da pesca
  exit: [ '/sair', '/spawn', '/exit' ]

Como funciona:

Apenas comandos em allowed podem ser usados
Comandos em exit automaticamente tiram o jogador da pesca
Outros comandos são bloqueados

Barra de progresso

Personalização da barra de progresso visual.

progress-bar:
  amount: 10
  symbol: ':'
  color-full: '&a'
  color-empty: '&7'

Resultado visual:

&a::::::&7:::: (60% completo)
10 símbolos no total
Verde para completo, cinza para vazio

Sistema de status

Mensagens de status na scoreboard.

status:
  fishing: '&aPescando... {delay_now}s'
  not-fishing: '&cInativo'

Placeholder {delay_now} mostra quanto tempo falta para pescar o próximo peixe.

Sistema de boosters

Boosters temporários que aumentam as chances de pescar peixes melhores.

boosters:
  booster1:
    time: 60 # em segundos
    bonus: 10.0 # porcentagem a mais
    items:
      interact:
        material: 'EXP_BOTTLE:0'
        name: '&aBônus de pesca'
        lore:
          - '&7Este booster permite que você tenha'
          - '&7mais chances de pescar algo melhor.'
          - ''
          - '&aTempo: &e{time}'
          - '&aPorcentagem: &e{bonus}%'
          - ''
      menu:
        material: 'EXP_BOTTLE:0'
        name: '&aBônus de pesca'
        lore:
          - '&aVocê possui um booster ativo'
          - ''
          - '&7Este booster permite que você tenha'
          - '&7mais chances de pescar algo melhor.'
          - ''
          - '&aTempo: &e{time}'
          - '&aPorcentagem: &e{bonus}%'
          - ''

Como criar um booster:

Defina um ID único (ex: booster1, booster_vip)
Configure tempo de duração em segundos
Configure bônus em porcentagem
Item interact é o que o jogador usa
Item menu é como aparece no menu quando ativo

Exemplo de uso:

60 segundos = 1 minuto
3600 segundos = 1 hora
10.0 = +10% de chance

Sistema de bônus

Bônus permanentes baseados em permissões. Aumenta o valor de venda dos peixes.

bonus:
  member:
    priority: 1
    # Permissão para ser reconhecido
    permission: 'ypesca.bonus.member'
    # Quantia do bônus em %
    bonus: 10.0

Como funciona:

Jogador com permissão ypesca.bonus.member recebe +10% ao vender peixes
Bônus é aplicado automaticamente
Pode criar múltiplos bônus com diferentes permissões

Exemplo de múltiplos bônus:

bonus:
  vip:
    priority: 1
    permission: 'ypesca.bonus.vip'
    bonus: 15.0
  vip_plus:
    priority: 2
    permission: 'ypesca.bonus.vipplus'
    bonus: 25.0
  staff:
    priority: 3
    permission: 'ypesca.bonus.staff'
    bonus: 50.0

O jogador receberá o bônus de maior prioridade que ele tiver permissão.

Item de coin ativável

Item físico que contém corais para ativar.

usable-item:
  material: '1ba16c3890af39c3f2d576586cff443de07dad32b2315e2ff6f0d5d6a3c663dd'
  name: '&b+{amount} Corais'
  lore:
    - ''
    - '&fQuantia: &b{amount}'
    - ''
    - '&7Clique com botão direito para ativar.'
    - ''
    - '&7Clique com shift + botão direito para compactar'
    - '&7todos os seus corais no inventário em 1 só.'
    - ''

Funcionalidades:

Botão direito: Ativa o item e adiciona corais ao jogador
Shift + botão direito: Compacta todos os itens de coral em um único item

Use /corais give <player> <quantidade> para dar este item.

Sistema de formatação

Formatação de números grandes no plugin.

format:
  type: 'LETTER' # Tipos: LETTER - NUMBER
  max-decimals: 4
  formats:
    - ''
    - ''
    - 'K'
    - 'M'
    - 'B'
    - 'T'
    - 'Q'
    - 'QQ'
    - 'S'
    - 'SS'
    - 'O'
    - 'N'
    - 'D'