Tiers

Visão geral

O arquivo tiers.yml define os níveis da conta bancária. A quantidade de tiers é ilimitada — basta adicionar/remover seções em tiers: e recarregar com /banco reload.

Exemplo completo de configuração

default-tier: 1

tiers:
  '1':
    name: '&7Inicial'
    permission: ''
    upgrade-cost: 0
    max-balance: 50000000
    max-yield-per-cycle: 250000
    withdraw-tax-discount: 0.0
    interest-brackets:
      - max: 10000000
        rate: 2.0
      - max: 15000000
        rate: 1.0
    icon:
      material: 'IRON_INGOT'
      name: '&7Nível 1 — Inicial'
      lore:
        - ''
        - ' &7Saldo máximo: &f{max_balance}'
        - ' &7Rendimento máximo: &f{max_yield}'
        - ' &7Desconto de taxa: &f{tax_discount}%'
        - ''

default-tier

Tier inicial atribuído a novos jogadores.

default-tier: 1

Opções de cada tier

Opção	Descrição
`name`	Nome exibido do tier.
`permission`	Permissão necessária para evoluir até este tier (vazio = livre).
`upgrade-cost`	Custo para alcançar este tier (pago na economia com `upgrade-currency: true`). O tier inicial deve ter `0`.
`max-balance`	Saldo máximo no banco (`0` = ilimitado).
`max-yield-per-cycle`	Teto de rendimento por ciclo (anti-inflação).
`withdraw-tax-discount`	% de desconto na taxa de saque/cheque.
`interest-brackets`	Faixas de juros regressivos.
`icon`	Item exibido no menu de upgrades.

interest-brackets

O saldo é dividido em faixas e cada faixa rende à sua própria taxa (regressivo — faixas altas rendem menos %).

Campo	Descrição
`max`	Teto da faixa em valor absoluto (`-1` = ilimitado / resto).
`rate`	% de rendimento daquela faixa por ciclo.

interest-brackets:
  - max: 10000000
    rate: 2.0
  - max: 15000000
    rate: 1.0

icon

Placeholders disponíveis na lore do ícone: {max_balance}, {max_yield}, {tax_discount}, {upgrade_cost}.

icon:
  material: 'GOLD_INGOT'
  name: '&6Nível 2 — Gold'
  lore:
    - ''
    - ' &7Saldo máximo: &f{max_balance}'
    - ' &7Rendimento máximo: &f{max_yield}'
    - ' &7Desconto de taxa: &f{tax_discount}%'
    - ' &7Custo do upgrade: &e{upgrade_cost}'
    - ''

Exemplo com vários tiers

default-tier: 1

tiers:
  '1':
    name: '&7Inicial'
    permission: ''
    upgrade-cost: 0
    max-balance: 50000000
    max-yield-per-cycle: 250000
    withdraw-tax-discount: 0.0
    interest-brackets:
      - max: 10000000
        rate: 2.0
      - max: 15000000
        rate: 1.0
    icon:
      material: 'IRON_INGOT'
      name: '&7Nível 1 — Inicial'
      lore: []

  '2':
    name: '&6Gold'
    permission: ''
    upgrade-cost: 5000000
    max-balance: 100000000
    max-yield-per-cycle: 300000
    withdraw-tax-discount: 0.0
    interest-brackets:
      - max: 10000000
        rate: 2.0
      - max: 15000000
        rate: 1.0
    icon:
      material: 'GOLD_INGOT'
      name: '&6Nível 2 — Gold'
      lore: []

A taxa efetiva de saque/cheque é: max(0, taxa_base - desconto_do_tier). A taxa base vem de economies.yml (se definida) ou de tax.yml.