Bônus

Este arquivo permite configurar bônus de venda para jogadores com permissões específicas. Jogadores com bônus recebem uma porcentagem adicional ao vender drops das máquinas.

Localização

plugins/yMaquinasVirtuais/bonus.yml

Estrutura Básica

bonus:
  membro:
    order: 1
    # Permissão para ser reconhecido
    permission: 'ymaquinasvirtuais.bonus.membro'
    # Nome que irá aparecer nas mensagens
    display: '&7[Membro]'
    # Quantia do bônus em %
    bonus: 10.0

Parâmetros

Como Funciona

Quando um jogador vende drops de suas máquinas:

1. O plugin verifica todas as permissões de bônus do jogador
2. Aplica o bônus com a maior order (prioridade)
3. Adiciona a porcentagem configurada ao valor da venda

Exemplo: Se um drop vale 100 coins e o jogador tem 10% de bônus, ele receberá 110 coins.

Exemplos

Bônus Básico

bonus:
  membro:
    order: 1
    permission: 'ymaquinasvirtuais.bonus.membro'
    display: '&7[Membro]'
    bonus: 10.0

Múltiplos Bônus por Rank

bonus:
  membro:
    order: 3
    permission: 'ymaquinasvirtuais.bonus.membro'
    display: '&7[Membro]'
    bonus: 10.0
  
  vip:
    order: 2
    permission: 'ymaquinasvirtuais.bonus.vip'
    display: '&6[VIP]'
    bonus: 25.0
  
  vip-plus:
    order: 1
    permission: 'ymaquinasvirtuais.bonus.vipplus'
    display: '&6[VIP&e+&6]'
    bonus: 50.0

Bônus para Ranks Especiais

bonus:
  moderador:
    order: 2
    permission: 'ymaquinasvirtuais.bonus.moderador'
    display: '&9[Moderador]'
    bonus: 35.0
  
  youtuber:
    order: 1
    permission: 'ymaquinasvirtuais.bonus.youtuber'
    display: '&c[YouTuber]'
    bonus: 75.0

Sistema de Prioridade

Se um jogador tiver múltiplas permissões de bônus, apenas o bônus com menor order será aplicado.

Exemplo:

bonus:
  vip:
    order: 2
    permission: 'ymaquinasvirtuais.bonus.vip'
    display: '&6[VIP]'
    bonus: 25.0
  
  vip-plus:
    order: 1  # Menor order = maior prioridade
    permission: 'ymaquinasvirtuais.bonus.vipplus'
    display: '&6[VIP&e+&6]'
    bonus: 50.0

Se um jogador tiver ambas as permissões, receberá apenas o bônus de 50% (VIP+).

Cálculo do Bônus

O bônus é calculado multiplicando o valor base pela porcentagem:

Valor Final = Valor Base + (Valor Base × Bônus / 100)

Exemplos:

• Drop de 1000 coins com 10% de bônus = 1100 coins
• Drop de 5000 coins com 25% de bônus = 6250 coins
• Drop de 10000 coins com 50% de bônus = 15000 coins

Diferença entre Bônus e Desconto

• Bônus (bonus.yml): Aumenta o valor recebido ao vender drops das máquinas
• Desconto (discounts.yml): Diminui o valor pago ao comprar máquinas na loja

Notas Importantes

• Apenas um bônus é aplicado por vez (o de maior prioridade)
• O bônus é aplicado automaticamente ao vender drops
• O parâmetro display é usado nas mensagens para mostrar qual grupo recebeu o bônus
• Use order menor para dar prioridade a ranks mais altos
• O bônus não se acumula com outros bônus