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.

lion.yml

commands.yml

config.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento dos pets. 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 pets 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/yPets/data.db.

Tempo de espera em ticks antes de carregar os dados do jogador após o login. Isso é essencial quando você usa o plugin em uma rede BungeeCord/Velocity com servidores separados.

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

Quando usar delay maior:

Rede BungeeCord/Velocity com múltiplos servidores
Servidor de mina/farm/floresta separado do principal
Problemas de sincronização de dados entre servidores

20 ticks = 1 segundo. Aumente para 40-60 se houver problemas de sincronização.

general

Configurações gerais que controlam o comportamento dos pets.

general:
  # Este servidor é o principal?
  # Exemplo: servidor rankup
  # Caso esse servidor for uma mina, floresta, campo, etc, deixe false.
  main-server: true
  # Poder stackar PETS de tipos e atributos idênticos
  stack-equal: false
  # Quantos pets do mesmo tipo o jogador pode possuir e equipar ao mesmo tempo
  # Use 0 para permitir ilimitado, respeitando apenas slots e equip-slots.
  same-type-limit: 1
  # Mundos em que não irá mostrar o PET para outros jogadores
  target-world-blacklist: []

main-server

Define se este servidor é o principal onde os menus de pets funcionam completamente.

true - Servidor principal (rankup, lobby, spawn). Menu funciona normalmente.
false - Servidor secundário (mina, farm). Menu é bloqueado mas bônus continuam ativos.

Exemplo de configuração em rede:

# No servidor principal (rankup)
main-server: true

# Nos servidores secundários (mina, farm, floresta)
main-server: false

stack-equal

Permite stackar pets idênticos (mesmo tipo, tier e nível) no inventário.

# false = Cada pet ocupa um slot separado
# true = Pets idênticos empilham no mesmo slot
stack-equal: false

Ativar stack pode causar confusão se jogadores tiverem pets do mesmo tipo em níveis diferentes.

same-type-limit

Limita quantos pets do mesmo tipo o jogador pode possuir e equipar ao mesmo tempo.

# 0 = ilimitado, respeitando apenas slots e equip-slots
same-type-limit: 1

Use 0 para permitir quantidade ilimitada do mesmo tipo.

target-world-blacklist

Lista de mundos onde o pet não será visível para outros jogadores, mas o jogador dono ainda verá.

# Útil para mundos PvP ou eventos onde pets causam poluição visual
target-world-blacklist: ['world_pvp', 'arena']

slots

Sistema de slots que determina quantos pets diferentes um jogador pode ter.

# Slots de pet (quantidade de pets que o jogador pode POSSUIR)
slots:
  # Quantia padrão de slots que o jogador irá ter
  default: 1
  # Quantia máxima de slots que o jogador poderá ter
  max: 20
  # Item do slot que será ativável
  item:
    material: 'HOPPER'
    name: '&bSlots'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Clique com botão direito para ativar.'

# Slots de equip (quantidade de pets que o jogador pode EQUIPAR SIMULTANEAMENTE)
equip-slots:
  # Quantia padrão de slots de equip que o jogador irá ter
  default: 1
  # Quantia máxima de slots de equip que o jogador poderá ter
  max: 4
  # Distância entre cada pet no formato U (atrás do jogador)
  distance-between: 1.5
  # Item do slot de equip que será ativável
  item:
    material: 'GOLD_INGOT'
    name: '&6Slot de Equip'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Permite equipar mais pets'
      - '&7simultaneamente.'
      - ''
      - '&7Clique com botão direito para ativar.'

Como funciona:

Jogadores começam com default slots (padrão: 1)
Podem aumentar até max slots usando o item ou comando
Use /pets giveslot <player> <quantidade> para dar slots

Exemplo prático:

Um jogador com 3 slots pode ter até 3 pets diferentes (ex: Leão, Dragão, Lobo). Para usar mais pets, precisa aumentar os slots.

Placeholder {amount} mostra a quantidade de slots no item.

food

Configuração do item de ração usado para alimentar e evoluir os pets.

food:
  material: 'INK_SACK:3'
  name: '&eRação para Pet'
  lore:
    - '&7Utilize esta ração para alimentar'
    - '&7o seu Pet, fazendo-o evoluir.'
    - ''
    - '&eComo usar?'
    - '&fAlimente o seu Pet mirando nele.'

Como usar a ração:

Pegue ração com /pets givefood <player> <quantidade>
Mire no pet equipado
Clique com botão direito para alimentar
O pet ganhará experiência e evoluirá

A quantidade de XP por ração é configurada em cada arquivo de pet (exp-per-food).

bowl

Sistema de pote de ração que permite armazenar ração para alimentação automática ou manual.

bowl:
  material: 'FLOWER_POT_ITEM'
  name: '&ePote de Ração'
  lore:
    - '&7Utilize este item para obter'
    - '&7o pote de ração.'
    - ''
    - '&aClique para ativar.'

Como funciona:

Dê o pote com /pets givebowl <player> 1
Jogador clica no item para ativar
Pode armazenar ração no pote através do menu
Alimenta o pet diretamente pelo menu usando a ração armazenada

Vantagens do pote:

Armazena grandes quantidades de ração
Alimentação rápida pelo menu
Não ocupa muito espaço no inventário

progress-bar

Configuração visual da barra de progresso de experiência dos pets.

progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-no: '&7'

amount

Quantidade de símbolos na barra de progresso.

amount: 10
# Resultado: ::::::::::

symbol

Caractere usado para representar a barra. Pode usar qualquer caractere ou símbolo Unicode.

symbol: ':'   # Resultado: ::::::::::
symbol: '■'   # Resultado: ■■■■■■■■■■
symbol: '█'   # Resultado: ██████████

color-yes / color-no

Cores da parte preenchida (color-yes) e vazia (color-no) da barra.

color-yes: '&a'  # Verde para preenchido
color-no: '&7'   # Cinza para vazio

Exemplo visual:

Com 50% de progresso e configuração padrão:

&a:::::&7:::::

Resultado: :::::

A barra de progresso aparece nos menus e mensagens usando o placeholder {progressbar}.

Nesta página