Descontos

Este arquivo permite configurar descontos para jogadores com permissões específicas. Jogadores com desconto pagam menos ao comprar máquinas na loja.

Localização

plugins/yMaquinasVirtuais/discounts.yml

Estrutura Básica

discounts:
  member:
    order: 1
    permission: 'ymaquinasvirtuais.member'
    display: '&7[Membro]'
    discount: 10.0  # em % do valor total

Parâmetros

Como Funciona

Quando um jogador compra uma máquina na loja:

1. O plugin verifica todas as permissões de desconto do jogador
2. Aplica o desconto com a maior order (prioridade)
3. Reduz a porcentagem configurada do valor da compra

Exemplo: Se uma máquina custa 1000 coins e o jogador tem 10% de desconto, ele pagará apenas 900 coins.

Exemplos

Desconto Básico

discounts:
  member:
    order: 1
    permission: 'ymaquinasvirtuais.member'
    display: '&7[Membro]'
    discount: 10.0

Múltiplos Descontos por Rank

discounts:
  member:
    order: 3
    permission: 'ymaquinasvirtuais.member'
    display: '&7[Membro]'
    discount: 10.0
  
  vip:
    order: 2
    permission: 'ymaquinasvirtuais.vip'
    display: '&6[VIP]'
    discount: 20.0
  
  vip-plus:
    order: 1
    permission: 'ymaquinasvirtuais.vipplus'
    display: '&6[VIP&e+&6]'
    discount: 35.0

Descontos para Ranks Especiais

discounts:
  moderador:
    order: 2
    permission: 'ymaquinasvirtuais.discount.moderador'
    display: '&9[Moderador]'
    discount: 40.0
  
  admin:
    order: 1
    permission: 'ymaquinasvirtuais.discount.admin'
    display: '&c[Admin]'
    discount: 50.0

Sistema de Prioridade

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

Exemplo:

discounts:
  vip:
    order: 2
    permission: 'ymaquinasvirtuais.vip'
    display: '&6[VIP]'
    discount: 20.0
  
  vip-plus:
    order: 1  # Menor order = maior prioridade
    permission: 'ymaquinasvirtuais.vipplus'
    display: '&6[VIP&e+&6]'
    discount: 35.0

Se um jogador tiver ambas as permissões, receberá apenas o desconto de 35% (VIP+).

Cálculo do Desconto

O desconto é calculado subtraindo a porcentagem do valor base:

Valor Final = Valor Base - (Valor Base × Desconto / 100)

Exemplos:

• Máquina de 1000 coins com 10% de desconto = 900 coins
• Máquina de 5000 coins com 20% de desconto = 4000 coins
• Máquina de 10000 coins com 35% de desconto = 6500 coins

Diferença entre Desconto e Bônus

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

Placeholder na Loja

O desconto do jogador pode ser exibido na loja usando o placeholder {discount} nos itens do menu shop.

Exemplo em menus.yml:

shop:
  items:
    info:
      lore:
        - '&fDesconto: &7{discount}% ( {group} &7)&f.'

Notas Importantes

• Apenas um desconto é aplicado por vez (o de maior prioridade)
• O desconto é aplicado automaticamente ao comprar máquinas
• O parâmetro display é usado nas mensagens e no placeholder {group}
• Use order menor para dar prioridade a ranks mais altos
• O desconto não se acumula com outros descontos
• O desconto se aplica ao valor total da compra (incluindo múltiplas máquinas)