Pets

Exemplo completo de configuração

Aqui está um exemplo de como configurar um pet:

# Nome do PET
display-name: '&6&lLeão &8[Nvl. {level}]'

# Permissão para equipar o PET
permission: ''

# Tipo de exibição do PET
# 'skull' (padrão): exibe como ArmorStand com a cabeça customizada definida em 'skull'
# 'mob'           : exibe como um mob vanilla do Minecraft via packet
display-type: 'skull'

# Configuração do mob (usado apenas quando display-type: mob)
# Lista de tipos disponíveis: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
# Exemplos: ZOMBIE, CREEPER, SKELETON, SPIDER, GUARDIAN, ENDER_DRAGON, WOLF, etc.
#mob:
#  type: 'ZOMBIE'

# Cabeça do PET (usado apenas quando display-type: skull)
skull:
  material: '85b70944ef8967762d53064d21dfe1e260eacfa7b29788c3e3abb45bcf650577'

# Distância entre o player e o PET
distance-between: 1.3

# Nível padrão do PET
default-level: 0

# Nível máximo do PET
max-level: 100

# Quantia BASE de XP necessária para upar
exp-base: 10.0

# Quantia ADICIONAL POR NÍVEL de XP necessária para upar
exp-per-level: 10.0

# Quanto de EXP cada comida irá dar
exp-per-food: 1.0

Opções de configuração

display-name

Nome do pet que será exibido no jogo.

Exemplo:

display-name: '&6&lLeão &8[Nvl. {level}]'

Placeholder disponível: {level}

permission

Permissão necessária para equipar o pet. Deixe vazio para permitir que todos possam usar.

Exemplo:

permission: ''
# ou
permission: 'ypets.pet.lion'

display-type

Define como o pet será exibido visualmente para os jogadores.

Valores disponíveis:

skull (padrão): Exibe o pet como um ArmorStand com uma cabeça customizada
mob: Exibe o pet como um mob vanilla do Minecraft via packet

Exemplo:

display-type: 'skull'

Ao usar display-type: 'skull', configure a cabeça do pet na seção skull. Ao usar display-type: 'mob', configure o tipo de mob na seção mob.

mob

Configuração do mob para quando display-type está definido como 'mob'.

Exemplo:

mob:
  type: 'ZOMBIE'

Tipos de mob disponíveis: Qualquer tipo de entidade vanilla do Minecraft. Veja a lista completa de EntityType

Exemplos de tipos: ZOMBIE, CREEPER, SKELETON, SPIDER, GUARDIAN, ENDER_DRAGON, WOLF, PIG, COW, etc.

Esta seção é ignorada quando display-type está definido como 'skull'. Remova ou deixe comentada caso não use este tipo de exibição.

distance-between

Distância entre o jogador e o pet.

Exemplo:

distance-between: 1.3

skull

Configuração da cabeça/textura do pet.

Exemplo:

skull:
  material: '85b70944ef8967762d53064d21dfe1e260eacfa7b29788c3e3abb45bcf650577'

Use o valor da textura base64 da cabeça do Minecraft. Você pode obter texturas em sites como minecraft-heads.com

default-level

Nível inicial do pet quando é obtido.

Exemplo:

default-level: 0

max-level

Nível máximo que o pet pode atingir.

Exemplo:

max-level: 100

exp-base

Quantidade base de experiência necessária para subir de nível.

Exemplo:

exp-base: 10.0

exp-per-level

Quantidade adicional de experiência por nível. A fórmula é: exp-base + (level * exp-per-level)

Exemplo:

exp-per-level: 10.0

Por exemplo, com exp-base de 10 e exp-per-level de 10, o nível 1 precisará de 20 XP (10 + 110), o nível 2 precisará de 30 XP (10 + 210), etc.

exp-per-food

Quantidade de experiência que cada ração fornece ao pet.

Exemplo:

exp-per-food: 1.0

Sistema de sons

Configure os sons reproduzidos em diferentes eventos.

sounds:
  # Som ao evoluir o nível
  up: 'LEVEL_UP'

Lista de sons disponíveis: Sounds 1.8

Sistema de holograma

Configure o holograma que aparece sobre o pet.

hologram:
  enabled: false
  off-set: 2.5
  lines: [ '&6&lLeão &8[Nvl. {level}]' ]

hologram.enabled

Ativa ou desativa o holograma sobre o pet.

Exemplo:

hologram:
  enabled: true

hologram.off-set

Altura do holograma acima do pet.

Exemplo:

hologram:
  off-set: 2.5

hologram.lines

Linhas de texto do holograma.

Exemplo:

hologram:
  lines: 
    - '&6&lLeão &8[Nvl. {level}]'
    - '&7Clique para interagir'

Placeholder disponível: {level}

Item ativável

Configuração do item que o jogador recebe para ativar o pet.

item:
  material: '85b70944ef8967762d53064d21dfe1e260eacfa7b29788c3e3abb45bcf650577'
  name: '&6&lPet Leão &8[{tier_display}&8]'
  lore:
    - '&7Este pet é um multiplicador'
    - '&7de &fspawners&7.'
    - ''
    - '&6Informações'
    - ' &fNível: &7{level}'
    - ' &fBônus &6(spawners)&f: &7{bonus_spawners}%'
    - ' &fDesconto &6(spawners)&f: &7{discount_spawners}%'
    - ' &fProgresso: &7{progressbar} &7{percentage}'
    - ''
    - '&6Clique para ativar'

Placeholders disponíveis: {tier_display}, {level}, {bonus_spawners}, {discount_spawners}, {progressbar}, {percentage} e todos os outros bônus configurados

Configuração do ícone do pet quando não está equipado.

icon:
  material: '85b70944ef8967762d53064d21dfe1e260eacfa7b29788c3e3abb45bcf650577'
  name: '&6&lPet Leão &8[{tier_display}&8]'
  lore:
    - '&7Este pet é um multiplicador'
    - '&7de &fspawners&7.'
    - ''
    - '&6Informações'
    - ' &fNível: &7{level}'
    - ' &fBônus &6(spawners)&f: &7{bonus_spawners}%'
    - ''
    - '&6Botão esquerdo &8-> &fEquipar'
    - '&6Botão direito &8-> &fRecolher'

Ícone equipado

Configuração do ícone do pet quando está equipado.

icon-equipped:
  material: '85b70944ef8967762d53064d21dfe1e260eacfa7b29788c3e3abb45bcf650577'
  name: '&6&lPet Leão &8[{tier_display}&8]'
  lore:
    - '&7Este pet é um multiplicador'
    - '&7de &fspawners&7.'
    - ''
    - '&6Informações'
    - ' &fNível: &7{level}'
    - ''
    - '&6Botão esquerdo &8-> &fDesequipar'

Sistema de tiers

Configure os diferentes tiers (evolução) do pet.

tiers:
  tier-1:
    # Ordenação dos tiers
    order: 1
    # Nível necessário para formar este tier
    need-level: 0
    # Nome do tier
    display-name: '&7Comum'
    # Buffs que irá dar ao jogador
    buffs:
      base:
        bonus-spawners: 10.0
        discount-spawners: 5.0
      per-level:
        bonus-spawners: 0.01
        discount-spawners: 0.005
      effect-list: [ 'INCREASE_DAMAGE:1', 'SPEED:1' ]
      fly-worlds: [ 'PlotWorld' ]

order

Ordem do tier na sequência de evolução.

Exemplo:

order: 1

need-level

Nível necessário para que pets possam se juntar e formar este tier.

Exemplo:

need-level: 0

O tier 1 normalmente usa 0, o tier 2 pode usar 10, tier 3 pode usar 20, etc.

display-name

Nome formatado do tier.

Exemplo:

display-name: '&7Comum'

buffs

Sistema de bônus e buffs fornecidos pelo pet.

base

Bônus base fornecido pelo pet neste tier.

buffs:
  base:
    # Bônus de Venda de drops de Spawners -> ySpawners
    bonus-spawners: 10.0
    # Bônus de Venda de drops de Máquinas -> yMaquinas e yMaquinasVirtuais
    bonus-machines: 0.0
    # Bônus de Venda na mina -> yMinas e yMinasPackets
    bonus-mines: 0.0
    # Bônus de Venda no armazém -> yArmazem
    bonus-storage: 0.0
    # Bônus de Venda nas plantas -> yCampo e yPlantacoes
    bonus-farm: 0.0
    # Bônus de Venda na floresta -> yFloresta
    bonus-forest: 0.0
    # Bônus de Venda -> yVender
    bonus-sell: 0.0
    # Bônus de Venda na pesca -> yPesca
    bonus-fish: 0.0
    # Bônus de Almas -> yAlmas
    bonus-almas: 0.0
    # Desconto na compra de spawners -> ySpawnersShop
    discount-spawners: 5.0
    # Desconto na compra de máquinas -> yMaquinas e yMaquinasVirtuais
    discount-machines: 0.0

per-level

Bônus adicional por nível do pet.

buffs:
  per-level:
    bonus-spawners: 0.01
    bonus-machines: 0.0
    bonus-mines: 0.0
    bonus-storage: 0.0
    bonus-farm: 0.0
    bonus-forest: 0.0
    bonus-sell: 0.0
    bonus-fish: 0.0
    bonus-almas: 0.0
    discount-spawners: 0.005
    discount-machines: 0.0

O bônus total é calculado como: base + (level * per-level)

effect-list

Lista de efeitos de poção que o jogador receberá enquanto o pet estiver equipado.

Exemplo:

buffs:
  effect-list: [ 'INCREASE_DAMAGE:1', 'SPEED:1' ]
  # false = efeitos sempre ativos (comportamento padrão)
  # true = aplica os efeitos por effects-duration e só reativa após effects-cooldown
  effects-timed: false
  # true = clicar no pet (dono) ativa os efeitos (usa duration + cooldown abaixo)
  # false = clique não ativa efeitos (só info / alimentar)
  effects-click: false
  # Duração dos efeitos em segundos
  effects-duration: 10
  # Cooldown em segundos entre ativações
  # Usado quando effects-timed e/ou effects-click estão true
  effects-cooldown: 300

Formato: EFEITO:NIVEL. Lista de efeitos: PotionEffectType

effects-timed / effects-click

effects-timed: false — efeitos sempre ativos
effects-timed: true — aplica os efeitos por effects-duration e só reativa após effects-cooldown
effects-click: true — clicar no pet (dono) ativa os efeitos
effects-click: false — clique não ativa efeitos

fly-worlds

Lista de mundos onde o jogador poderá voar com o pet equipado.

Exemplo:

buffs:
  fly-worlds: [ 'PlotWorld', 'plots' ]

respawn-commands

Comandos executados quando o jogador renascer com o pet equipado.

Exemplo:

buffs:
  respawn-commands: 
    - 'give {player} diamond 1'

Placeholder disponível: {player}

Comandos executados quando o jogador equipar o pet ou logar com ele equipado.

Exemplo:

buffs:
  equip-login-commands: 
    - 'effect {player} speed 999999 1'

unequip-quit-commands

Comandos executados quando o jogador desequipar o pet ou deslogar.

Exemplo:

buffs:
  unequip-quit-commands: 
    - 'effect {player} clear'

Nesta página