Battle Pass

Descrição

O Battle Pass (Passe de Batalha) é um sistema de progressão por temporadas onde os jogadores ganham XP ao completar missões e sobem de nível para desbloquear recompensas exclusivas. O sistema suporta múltiplas temporadas configuradas simultaneamente, com transição automática entre elas.

Este sistema requer o addon yMissoesBattlePass instalado.

Estrutura de arquivos

O Battle Pass é configurado no arquivo battlepass.yml dentro da pasta do plugin.

battlepass.yml

config.yml

rewards.yml

Exemplo completo de configuração

Aqui está um exemplo de como configurar o Battle Pass:

# ============================================
# yMissoes - Sistema de Battle Pass (Addon)
# ============================================
# Este sistema funciona de forma independente das missoes normais.
# Os jogadores ganham XP ao completar missoes e sobem de nivel no passe.
#
# MULTI-SEASON: Configure varias temporadas de uma vez!
# O sistema automaticamente seleciona a temporada ativa baseado nas datas.
# Quando uma temporada termina, a proxima comeca automaticamente.

# Ativar/Desativar o sistema de Battle Pass
enabled: true

# Configuracoes do passe premium (global para todas as temporadas)
premium:
  permission: 'ymissoes.battlepass.premium'
  placeholder: ''
  placeholder-value: ''

# XP ganho por acao (global para todas as temporadas)
xp-rewards:
  mission-complete: 50
  flash-mission-complete: 100
  milestone-complete: 25
  secret-achievement: 150
  no-death-bonus: 25
  first-complete-bonus: 50

# Temporadas
seasons:
  season_1:
    name: '&6&lTemporada 1 - Guerreiros'
    description:
      - '&7Complete missoes para ganhar XP'
      - '&7e desbloquear recompensas exclusivas!'
    start-date: '01/01/2025 00:00'
    end-date: '01/02/2026 23:59'
    max-level: 50
    base-xp: 100
    xp-multiplier: 1.15
    tiers:
      1:
        xp-required: 100
        free-rewards:
          - '100.0,reward1'
        premium-rewards:
          - '100.0,reward2'
      5:
        xp-required: 750
        free-rewards:
          - '100.0,reward2'
        premium-rewards:
          - '100.0,reward3'

Opções disponíveis na configuração

enabled

Ativa ou desativa completamente o sistema de Battle Pass.

Exemplo:

enabled: true

Configuração Premium

O sistema de passe premium permite oferecer recompensas exclusivas para jogadores VIP.

premium.permission

Permissão necessária para ter acesso ao passe premium.

Exemplo:

premium:
  permission: 'ymissoes.battlepass.premium'

premium.placeholder

Alternativa à permissão: verifica um placeholder do PlaceholderAPI. Deixe vazio para usar apenas permissão.

Exemplo:

premium:
  placeholder: '%vip_status%'
  placeholder-value: 'true'

Recompensas de XP

Configurações globais de XP ganho por diferentes ações. Estas configurações se aplicam a todas as temporadas.

xp-rewards.mission-complete

XP ganho ao completar uma missão normal.

Exemplo:

xp-rewards:
  mission-complete: 50

xp-rewards.flash-mission-complete

XP ganho ao completar uma missão relâmpago (flash mission).

Exemplo:

xp-rewards:
  flash-mission-complete: 100

xp-rewards.milestone-complete

XP ganho ao completar um milestone de missão.

Exemplo:

xp-rewards:
  milestone-complete: 25

xp-rewards.secret-achievement

XP ganho ao desbloquear uma conquista secreta.

Exemplo:

xp-rewards:
  secret-achievement: 150

xp-rewards.no-death-bonus

XP bônus por completar missão sem morrer (se a missão tiver essa condição).

Exemplo:

xp-rewards:
  no-death-bonus: 25

xp-rewards.first-complete-bonus

XP bônus por ser o primeiro a completar uma missão relâmpago.

Exemplo:

xp-rewards:
  first-complete-bonus: 50

Temporadas

O sistema suporta múltiplas temporadas configuradas simultaneamente. O plugin automaticamente detecta qual temporada está ativa baseado nas datas.

`seasons.{id}`

Cada temporada é identificada por um ID único (ex: season_1, season_2).

name

Nome da temporada exibido no menu.

Exemplo:

seasons:
  season_1:
    name: '&6&lTemporada 1 - Guerreiros'

description

Descrição da temporada exibida no menu.

Exemplo:

seasons:
  season_1:
    description:
      - '&7Complete missoes para ganhar XP'
      - '&7e desbloquear recompensas exclusivas!'

start-date e end-date

Datas de início e término da temporada no formato dd/MM/yyyy HH:mm.

Exemplo:

seasons:
  season_1:
    start-date: '01/01/2025 00:00'
    end-date: '01/02/2026 23:59'

Quando uma temporada termina, a próxima temporada configurada começa automaticamente.

max-level

Nível máximo que os jogadores podem atingir nesta temporada.

Exemplo:

seasons:
  season_1:
    max-level: 50

base-xp

XP base necessário para subir do nível 1 para o nível 2.

Exemplo:

seasons:
  season_1:
    base-xp: 100

xp-multiplier

Multiplicador de XP aplicado a cada nível. O XP necessário para o próximo nível é calculado como: xp_anterior * xp-multiplier.

Exemplo:

seasons:
  season_1:
    xp-multiplier: 1.15

Com base-xp: 100 e xp-multiplier: 1.15:

Nível 1→2: 100 XP
Nível 2→3: 115 XP
Nível 3→4: 132 XP
E assim por diante...

tiers

Configuração dos níveis (tiers) e suas recompensas.

Exemplo:

seasons:
  season_1:
    tiers:
      1:
        xp-required: 100
        free-rewards:
          - '100.0,coins-500'
        premium-rewards:
          - '100.0,coins-1000'
          - '50.0,legendary-key'
      5:
        xp-required: 750
        free-rewards:
          - '100.0,coins-1000'
        premium-rewards:
          - '100.0,coins-2500'
          - '75.0,epic-sword'

As recompensas usam o formato chance,recompensa e devem estar definidas no arquivo rewards.yml.

Personalize a aparência do menu do Battle Pass.

menu.title

Título do menu. Use {season_name} para exibir o nome da temporada atual.

Exemplo:

menu:
  title: '&8Passe de Batalha - {season_name}'

menu.rows

Número de linhas do menu (1-6).

Exemplo:

menu:
  rows: 6

menu.player-info-slot

Slot onde aparece o item com informações do jogador.

Exemplo:

menu:
  player-info-slot: 4

menu.tier-slots

Lista de slots onde os níveis são exibidos.

Exemplo:

menu:
  tier-slots:
    - 19
    - 20
    - 21
    - 22
    - 23
    - 24
    - 25

menu.previous-slot e next-slot

Slots para navegação entre páginas.

Exemplo:

menu:
  previous-slot: 45
  next-slot: 53

menu.collect-all-slot

Slot do botão para coletar todas as recompensas pendentes.

Exemplo:

menu:
  collect-all-slot: 49

Configure a aparência dos itens no menu.

icons.player-info

Ícone que exibe o progresso do jogador. Use {player} para exibir a cabeça do jogador.

Exemplo:

icons:
  player-info:
    material: "{player}"
    name: '&6&lSeu Progresso'
    lore:
      - ''
      - '&7Temporada: &f{season_name}'
      - '&7Nivel: &e{level}&7/&e{max_level}'
      - '&7XP: &b{xp}&7/&b{xp_next}'
      - ''
      - '&7Passe Premium: {premium_status}'
      - ''
      - '&7Tempo restante: &c{time_remaining}'

Placeholders disponíveis:

Placeholder	Descrição
`{season_name}`	Nome da temporada atual
`{level}`	Nível atual do jogador
`{max_level}`	Nível máximo da temporada
`{xp}`	XP atual do jogador
`{xp_next}`	XP necessário para o próximo nível
`{premium_status}`	Status do passe premium
`{time_remaining}`	Tempo restante da temporada

icons.tier-locked

Ícone para níveis que ainda não foram desbloqueados.

Exemplo:

icons:
  tier-locked:
    material: 'STAINED_GLASS_PANE:7'
    name: '&c&lNivel {level} - Bloqueado'
    lore:
      - ''
      - '&7Faltam &c{xp_remaining} XP &7para desbloquear.'
      - ''
      - '&7Recompensas Gratis:'
      - '{free_rewards}'
      - ''
      - '&7Recompensas Premium:'
      - '{premium_rewards}'

icons.tier-unlocked

Ícone para níveis desbloqueados com recompensas disponíveis para coleta.

Exemplo:

icons:
  tier-unlocked:
    material: 'STAINED_GLASS_PANE:5'
    glow: true
    name: '&a&lNivel {level} - Desbloqueado!'
    lore:
      - ''
      - '&aClique para coletar suas recompensas!'
      - ''
      - '&7Recompensas Gratis:'
      - '{free_rewards}'
      - ''
      - '&7Recompensas Premium:'
      - '{premium_rewards}'

icons.tier-collected

Ícone para níveis cujas recompensas já foram coletadas.

Exemplo:

icons:
  tier-collected:
    material: 'STAINED_GLASS_PANE:4'
    name: '&e&lNivel {level} - Coletado'
    lore:
      - ''
      - '&7Voce ja coletou as recompensas deste nivel.'
      - ''
      - '&7Recompensas Gratis:'
      - '{free_rewards}'
      - ''
      - '&7Recompensas Premium:'
      - '{premium_rewards}'

icons.previous e next

Ícones de navegação entre páginas.

Exemplo:

icons:
  previous:
    material: ARROW
    name: '&ePagina Anterior'
    lore:
      - '&7Clique para voltar.'
  next:
    material: ARROW
    name: '&eProxima Pagina'
    lore:
      - '&7Clique para avancar.'

icons.collect-all

Ícone para coletar todas as recompensas pendentes de uma vez.

Exemplo:

icons:
  collect-all:
    material: CHEST
    name: '&6&lColetar Todas as Recompensas'
    lore:
      - ''
      - '&7Clique para coletar todas as'
      - '&7recompensas pendentes de uma vez.'
      - ''
      - '&eRecompensas pendentes: &f{pending_count}'

Mensagens

Configure todas as mensagens do sistema de Battle Pass.

messages.xp-gained

Mensagem exibida ao ganhar XP.

Exemplo:

messages:
  xp-gained: '&a+{xp} XP &7no Passe de Batalha!'

messages.level-up

Mensagem exibida ao subir de nível.

Exemplo:

messages:
  level-up: |
    
    &6&l* PASSE DE BATALHA *
    &eVoce subiu para o &6&lNivel {level}&e!
    &7Use &f/missoes passe &7para coletar suas recompensas.

messages.level-up-title e level-up-subtitle

Título e subtítulo exibidos na tela ao subir de nível.

Exemplo:

messages:
  level-up-title: '&6&lNIVEL {level}'
  level-up-subtitle: '&eVoce subiu de nivel no Passe de Batalha!'

messages.rewards-collected

Mensagem ao coletar recompensas de um nível.

Exemplo:

messages:
  rewards-collected: '&aVoce coletou as recompensas do nivel &e{level}&a!'

messages.tier-locked-message

Mensagem ao tentar coletar recompensas de um nível bloqueado.

Exemplo:

messages:
  tier-locked-message: '&cVoce ainda nao desbloqueou este nivel!'

messages.already-collected

Mensagem ao tentar coletar recompensas já coletadas.

Exemplo:

messages:
  already-collected: '&cVoce ja coletou as recompensas deste nivel!'

messages.season-ended

Mensagem quando a temporada já terminou.

Exemplo:

messages:
  season-ended: '&cA temporada atual ja terminou! Aguarde a proxima temporada.'

messages.season-not-started

Mensagem quando a próxima temporada ainda não começou.

Exemplo:

messages:
  season-not-started: '&cA proxima temporada ainda nao comecou!'

messages.no-pending-rewards

Mensagem quando não há recompensas pendentes para coletar.

Exemplo:

messages:
  no-pending-rewards: '&cVoce nao tem recompensas pendentes para coletar!'

messages.premium-locked

Mensagem ao tentar coletar recompensa premium sem ter o passe.

Exemplo:

messages:
  premium-locked: '&cEsta recompensa requer o Passe Premium!'

messages.no-active-season

Mensagem quando nenhuma temporada está ativa.

Exemplo:

messages:
  no-active-season: '&cNenhuma temporada esta ativa no momento!'

messages.time-ended

Texto exibido quando o tempo da temporada acabou.

Exemplo:

messages:
  time-ended: '&cEncerrado'

messages.premium-enabled e premium-disabled

Texto do status premium no menu.

Exemplo:

messages:
  premium-enabled: '&a&lATIVADO'
  premium-disabled: '&c&lDESATIVADO'

messages.no-rewards

Texto exibido quando um tier não possui recompensas.

Exemplo:

messages:
  no-rewards: '&7Nenhuma recompensa'

seasons:
  # Temporada 1
  season_1:
    name: '&6&lTemporada 1 - Guerreiros'
    start-date: '01/01/2025 00:00'
    end-date: '01/03/2025 23:59'
    max-level: 50
    base-xp: 100
    xp-multiplier: 1.15
    tiers:
      # ... configuração dos tiers
  
  # Temporada 2
  season_2:
    name: '&b&lTemporada 2 - Exploradores'
    start-date: '01/03/2025 00:00'
    end-date: '01/06/2025 23:59'
    max-level: 60
    base-xp: 120
    xp-multiplier: 1.12
    tiers:
      # ... configuração dos tiers
  
  # Temporada de Verão
  summer_2025:
    name: '&e&lTemporada de Verao 2025'
    start-date: '01/06/2025 00:00'
    end-date: '01/09/2025 23:59'
    max-level: 75
    base-xp: 100
    xp-multiplier: 1.10
    tiers:
      # ... configuração dos tiers

Certifique-se de que as datas das temporadas não se sobreponham. O sistema usa a primeira temporada ativa encontrada.

Dicas de configuração

Para servidores casuais

xp-rewards:
  mission-complete: 100        # Mais XP por missão
  flash-mission-complete: 200

seasons:
  season_1:
    max-level: 30              # Menos níveis
    base-xp: 50                # Menos XP necessário
    xp-multiplier: 1.10        # Progressão mais suave

Para servidores competitivos

xp-rewards:
  mission-complete: 25         # Menos XP por missão
  flash-mission-complete: 50

seasons:
  season_1:
    max-level: 100             # Mais níveis
    base-xp: 150               # Mais XP necessário
    xp-multiplier: 1.20        # Progressão mais íngreme

O comando para acessar o Battle Pass é /missoes passe ou o configurado em commands.yml.

Nesta página