Heads

Exemplo completo de configuração

O arquivo heads.yml controla o sistema de heads obtidas ao matar mobs.

heads:
  pig:
    # Ordem no menu
    order: 1
    # Identificação necessária para a API de Economias do yPlugins
    yplugins-id: 'yrankup-head-pig'
    # Pode usar cor
    name: '&dPorco'
    # Permissão para ativar / receber (caso esteja ativada na config.yml) a head
    # Deixe vazio ou apague para não usar.
    permission: ''
    # Dar a head automatico no menu
    # false = dar o item pro jogador
    automatic: false
    # Dar diretamente para o inventário ao invés de dropar no chão
    give-inventory: true
    # Multiplicar a quantia de heads pelo encantamento de fortuna
    fortune: false
    # Ativar o sell
    sell: true
    # Ativar a coleta
    collect: true
    # Mundos que não droparão a head
    world-blacklist: []
    # Preços para vender a head
    prices:
      price1:
        provider: 'money'
        price: 100.0
    # Delays
    delays:
      delay1:
        order: 1
        permission: ''
        delay: 5
    # Mensagens de venda
    messages:
      chat: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      actionbar: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      title: ''
    # Mensagens de coleta
    messages-collect:
      chat: '&aVocê coletou {amount} heads {head}&a.'
      actionbar: '&aVocê coletou {amount} heads {head}&a.'
      title: ''
    # Este item será dado ao jogador
    item:
      material: 621668ef7cb79dd9c22ce3d1f3f4cb6e2559893b6df4a469514e667c16aa4
      name: '&dCabeça de porco'
      lore: [ '&7Quantia armazenada: &f{amount} cabeça(s) de porco.', '', '&7Clique com botão direito para armazenar.' ]
    # Este irá mostrar no /heads
    display:
      material: 621668ef7cb79dd9c22ce3d1f3f4cb6e2559893b6df4a469514e667c16aa4
      name: '&dCabeça de porco'
      lore: [ '&7Quantidade: &f{amount}&7.', '', '&f Valores:', '&f > &a{money} coins por unidade&f.', '', '&b > ${money_total} coins no total', '', '&7Botão &fESQUERDO&a para vender', '&7Botão &fDIREITO&a para coletar' ]

# Entidades que irão dropar as heads
entities:
  pig:
    entity: 'PIG'
    head: 'pig'
    chance: 100.0
    amount: 1

Estrutura de heads

Configure as heads disponíveis no plugin.

Opções de configuração

order

Define a ordem de exibição da head no menu.

heads:
  pig:
    order: 1
  
  cow:
    order: 2

yplugins-id

ID usado para integração com a API de economias do yPlugins. Deve ser único.

heads:
  pig:
    yplugins-id: 'yrankup-head-pig'

Este ID deve corresponder ao provider configurado em economies.yml. Por exemplo: yrankup-head-pig.

name

Nome da head exibido nos menus e mensagens.

heads:
  pig:
    name: '&dPorco'
  
  cow:
    name: '&6Vaca'

permission

Permissão necessária para ativar ou receber a head.

heads:
  pig:
    permission: ''  # Vazio = todos podem usar
  
  vip_head:
    permission: 'yrankup.head.vip'  # Apenas VIPs

automatic

Define se a head é coletada automaticamente ou dada como item ao jogador.

heads:
  pig:
    automatic: false  # Dá o item físico ao jogador
  
  auto_head:
    automatic: true   # Coleta automaticamente

give-inventory

Define se as heads serão entregues diretamente no inventário ao invés de serem dropadas no chão.

heads:
  pig:
    give-inventory: true   # Entrega no inventário
  
  dropped:
    give-inventory: false  # Dropa no chão

Como funciona:

Se true - A head vai direto para o inventário do jogador quando ele mata o mob
Se false - A head é dropada no chão para o jogador coletar manualmente

Vantagens de usar true:

Evita perda de items por área de proteção
Mais rápido para coletar heads em locais cheios
Menos lag por não spawnar entidades de item

Use true para uma melhor experiência de farm, especialmente em servidores com muitos jogadores.

give-vanilla-stack

Define se as heads serão entregues em stacks de 64 (padrão do Minecraft) ao invés de 1 por 1.

heads:
  pig:
    give-vanilla-stack: false   # Entrega 1 por 1 (padrão)
  
  farm:
    give-vanilla-stack: true    # Entrega em stacks de 64

Como funciona:

Se true - Heads são organizadas em stacks de 64, como qualquer bloco vanilla
Se false - Cada head é entregue separadamente (padrão yRankup)

Vantagens de usar true:

Economiza espaço no inventário durante farms longas
Mais semelhante ao comportamento vanilla do Minecraft
Menos spam de notificações de item
Melhor para jogadores que farmeiam muitos items

Desvantagens:

Menos controle sobre quantidade individual
Pode ser menos visível para o jogador que está farmando

Esta opção só funciona quando give-inventory: true também está ativado.

fortune

Define se o encantamento de fortuna do item usado para matar multiplica a quantidade de heads dropadas.

heads:
  pig:
    fortune: false  # Não multiplica por fortuna
  
  rare:
    fortune: true   # Multiplica por fortuna

Como funciona:

Se true - Cada nível de fortuna multiplica a quantidade de heads dropadas
- Fortuna I = ~1.5x
- Fortuna II = ~2.0x
- Fortuna III = ~2.5x
Se false - Ignora o encantamento de fortuna

Exemplo prático:

Com fortune: true e amount: 1:

Sem fortuna: 1 head
Com Fortuna III: ~2-3 heads

O multiplicador de fortuna é baseado no encantamento do item usado para matar o mob, não em uma ferramenta específica.

sell

Ativa ou desativa a venda da head.

heads:
  pig:
    sell: true   # Pode vender
  
  collectible:
    sell: false  # Não pode vender

collect

Ativa ou desativa a coleta da head do menu.

heads:
  pig:
    collect: true   # Pode coletar do menu
  
  permanent:
    collect: false  # Não pode coletar

world-blacklist

Lista de mundos onde a head não será dropada.

heads:
  pig:
    world-blacklist: []  # Dropa em todos os mundos
  
  limited:
    world-blacklist:
      - 'world_nether'
      - 'world_the_end'
      - 'lobby'

prices

Preços para vender a head no menu.

heads:
  pig:
    prices:
      price1:
        provider: 'money'
        price: 100.0
      price2:
        provider: 'points'
        price: 50

Você pode configurar múltiplos preços. O jogador receberá todas as economias ao vender.

delays

Sistema de cooldown para ativar heads.

heads:
  pig:
    delays:
      delay1:
        # Ordem de prioridade (menor = maior prioridade)
        order: 1
        # Permissão necessária (vazio = todos)
        permission: ''
        # Delay em segundos
        delay: 5
      delay2:
        order: 2
        permission: 'yrankup.vip'
        delay: 2  # VIPs têm menos delay

O jogador receberá o delay do primeiro grupo que tiver permissão (ordem menor = maior prioridade).

messages

Mensagens enviadas ao vender heads.

heads:
  pig:
    messages:
      chat: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      actionbar: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      title: ''

Placeholders disponíveis: {amount}, {head}, {money}, {money_total}

messages-collect

Mensagens enviadas ao coletar heads do menu.

heads:
  pig:
    messages-collect:
      chat: '&aVocê coletou {amount} heads {head}&a.'
      actionbar: '&aVocê coletou {amount} heads {head}&a.'
      title: ''

Placeholders disponíveis: {amount}, {head}

item

Item físico que será dado ao jogador.

heads:
  pig:
    item:
      material: 621668ef7cb79dd9c22ce3d1f3f4cb6e2559893b6df4a469514e667c16aa4
      name: '&dCabeça de porco'
      lore:
        - '&7Quantia armazenada: &f{amount} cabeça(s) de porco.'
        - ''
        - '&7Clique com botão direito para armazenar.'

Placeholders disponíveis: {amount}

display

Item exibido no menu /heads.

heads:
  pig:
    display:
      material: 621668ef7cb79dd9c22ce3d1f3f4cb6e2559893b6df4a469514e667c16aa4
      name: '&dCabeça de porco'
      lore:
        - '&7Quantidade: &f{amount}&7.'
        - ''
        - '&f Valores:'
        - '&f > &a{money} coins por unidade&f.'
        - ''
        - '&b > ${money_total} coins no total'
        - ''
        - '&7Botão &fESQUERDO&a para vender'
        - '&7Botão &fDIREITO&a para coletar'

Placeholders disponíveis: {amount}, {money}, {money_total}, qualquer provider configurado

Estrutura de entidades

Configure quais mobs dropam heads.

entities:
  pig:
    # Tipo da entidade
    entity: 'PIG'
    # ID da head a ser dropada
    head: 'pig'
    # Chance de dropar (100.0 = 100%)
    chance: 100.0
    # Quantidade a dropar
    amount: 1

Opções de configuração

entity

Tipo de mob que dropará a head.

entities:
  pig:
    entity: 'PIG'
  
  zombie:
    entity: 'ZOMBIE'
  
  enderdragon:
    entity: 'ENDER_DRAGON'

head

ID da head que será dropada (deve corresponder a uma head configurada acima).

entities:
  pig:
    entity: 'PIG'
    head: 'pig'  # Deve existir em heads:

chance

Porcentagem de chance de dropar a head.

entities:
  common:
    chance: 100.0  # Sempre dropa
  
  rare:
    chance: 50.0   # 50% de chance
  
  very_rare:
    chance: 10.0   # 10% de chance

amount

Quantidade de heads a dropar.

entities:
  pig:
    amount: 1
  
  boss:
    amount: 5

Exemplo completo

heads:
  pig:
    order: 1
    yplugins-id: 'yrankup-head-pig'
    name: '&dPorco'
    permission: ''
    automatic: false
    give-inventory: true
    fortune: false
    sell: true
    collect: true
    world-blacklist: []
    prices:
      price1:
        provider: 'money'
        price: 100.0
    delays:
      delay1:
        order: 1
        permission: ''
        delay: 5
    messages:
      chat: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      actionbar: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      title: ''
    messages-collect:
      chat: '&aVocê coletou {amount} heads {head}&a.'
      actionbar: '&aVocê coletou {amount} heads {head}&a.'
      title: ''
    item:
      material: 621668ef7cb79dd9c22ce3d1f3f4cb6e2559893b6df4a469514e667c16aa4
      name: '&dCabeça de porco'
      lore: [ '&7Quantia armazenada: &f{amount} cabeça(s) de porco.', '', '&7Clique com botão direito para armazenar.' ]
    display:
      material: 621668ef7cb79dd9c22ce3d1f3f4cb6e2559893b6df4a469514e667c16aa4
      name: '&dCabeça de porco'
      lore: [ '&7Quantidade: &f{amount}&7.', '', '&f Valores:', '&f > &a{money} coins por unidade&f.', '', '&b > ${money_total} coins no total', '', '&7Botão &fESQUERDO&a para vender', '&7Botão &fDIREITO&a para coletar' ]
  
  cow:
    order: 2
    yplugins-id: 'yrankup-head-cow'
    name: '&6Vaca'
    permission: ''
    automatic: false
    give-inventory: true
    fortune: false
    sell: true
    collect: true
    world-blacklist: []
    prices:
      price1:
        provider: 'money'
        price: 150.0
    delays:
      delay1:
        order: 1
        permission: ''
        delay: 5
    messages:
      chat: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      actionbar: '&aVocê vendeu {amount} heads {head} por &6{money} money&a.'
      title: ''
    messages-collect:
      chat: '&aVocê coletou {amount} heads {head}&a.'
      actionbar: '&aVocê coletou {amount} heads {head}&a.'
      title: ''
    item:
      material: '5d6c6eda942f7f5f71c3161c7306f4aed307d82895f9d2b07ab4525718edc5'
      name: '&6Cabeça de vaca'
      lore: [ '&7Quantia armazenada: &f{amount} cabeça(s) de vaca.', '', '&7Clique com botão direito para armazenar.' ]
    display:
      material: '5d6c6eda942f7f5f71c3161c7306f4aed307d82895f9d2b07ab4525718edc5'
      name: '&6Cabeça de vaca'
      lore: [ '&7Quantidade: &f{amount}&7.', '', '&f Valores:', '&f > &a{money} coins por unidade&f.', '', '&b > ${money_total} coins no total', '', '&7Botão &fESQUERDO&a para vender', '&7Botão &fDIREITO&a para coletar' ]

entities:
  pig:
    entity: 'PIG'
    head: 'pig'
    chance: 100.0
    amount: 1
  
  cow:
    entity: 'COW'
    head: 'cow'
    chance: 100.0
    amount: 1

Não esqueça de configurar a economia correspondente em economies.yml para cada head criada!

Nesta página