Recompensas

Exemplo completo de configuração

Aqui está um exemplo de como configurar as recompensas das roletas:

rewards:
  reward1:
    # Item que aparecerá no preview.
    preview:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', '&fChance: &6{chance}%' ]
      enchants: []
    # Item que aparecerá para coletar.
    collect:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []
    # Item que será dado ao player
    item:
      give: true
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEu valho muito!' ]
      enchants: []
    # Comandos que será dado ao player
    command:
      give: false
      # quantia padrão da placeholder {amount} no comando (valor base)
      placeholder-amount: 1
      # multiplicar a placeholder {amount} pela quantia de recompensas do mesmo tipo
      multiply-placeholder: true
      list: [ 'give {player} stone {amount}' ]
    # Mensagens da recompensa
    messages:
      title: ''
      actionbar: '&7Você ganhou pedras!'
      chat: ''

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

Criando uma recompensa

Para criar uma nova recompensa, adicione uma nova entrada em rewards:

rewards:
  reward1:
    preview:
      # configurações do item de preview
    collect:
      # configurações do item de coleta
    item:
      # configurações do item a ser dado
    command:
      # configurações dos comandos
    messages:
      # configurações das mensagens

preview

Item que aparecerá no menu de preview da roleta (ao clicar com shift no item da roleta).

Exemplo:

rewards:
  reward1:
    preview:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', '&fChance: &6{chance}%' ]
      enchants: []

material: Material do item (use o formato MATERIAL:DATA ou texture de cabeça)
name: Nome do item
amount: Quantidade do item
lore: Descrição do item (array de linhas)
enchants: Lista de encantamentos (array vazio se não houver)

Placeholder disponível no lore: {chance} - Chance de ganhar a recompensa

collect

Item que aparecerá no menu de coleta após ganhar a recompensa.

Exemplo:

rewards:
  reward1:
    collect:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []

Placeholder disponível no lore: {amount} - Quantidade de recompensas acumuladas do mesmo tipo

item

Configurações do item que será dado ao jogador.

Exemplo:

rewards:
  reward1:
    item:
      give: true
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEu valho muito!' ]
      enchants: []

give: Define se o item será dado ao jogador (true/false)
material: Material do item
name: Nome do item
amount: Quantidade do item
lore: Descrição do item
enchants: Lista de encantamentos

Se give for false, o item não será dado ao jogador. Útil quando você quer dar apenas comandos.

command

Configurações dos comandos que serão executados ao coletar a recompensa.

Exemplo:

rewards:
  reward1:
    command:
      give: false
      placeholder-amount: 1
      multiply-placeholder: true
      list: [ 'give {player} stone {amount}' ]

give: Define se os comandos serão executados (true/false)
placeholder-amount: Valor base da placeholder {amount}
multiply-placeholder: Se true, multiplica {amount} pela quantidade de recompensas acumuladas
list: Lista de comandos a executar (sem a barra inicial)

Placeholders disponíveis: {player} - Nome do jogador, {amount} - Quantidade calculada

messages

Mensagens exibidas ao coletar a recompensa.

Exemplo:

rewards:
  reward1:
    messages:
      title: ''
      actionbar: '&7Você ganhou pedras!'
      chat: ''

title: Mensagem exibida como título (use <nl> para quebrar linha)
actionbar: Mensagem exibida na actionbar
chat: Mensagem enviada no chat (use | para múltiplas linhas)

Exemplo de recompensa com comandos

Aqui está um exemplo de uma recompensa que executa comandos em vez de dar itens:

rewards:
  reward2:
    preview:
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 1
      lore: [ '&bQuem não adora uma pedra preciosa?!', '', '&fChance: &6{chance}%' ]
      enchants: []
    collect:
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 1
      lore: [ '&bQuem não adora uma pedra preciosa?!', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: true
      list: [ 'give {player} diamond {amount}' ]
    messages:
      title: ''
      actionbar: '&bVocê ganhou diamantes!'
      chat: ''

Vinculando recompensas às roletas

Para vincular recompensas a uma roleta, você precisa especificá-las na configuração da roleta em roulettes/default.yml:

Exemplo:

rewards:
  - '20.0,reward1-none'
  - '30.0,reward2-none'
  - '50.0,reward3-none'

O formato é: chance,recompensa-raridade

chance: Peso da chance (não precisa somar 100)
recompensa: ID da recompensa configurada em rewards.yml
raridade: Raridade da recompensa (use none se não houver)

O sistema de chances funciona com pesos. Por exemplo, se você tiver três recompensas com chances 20, 30 e 50, a chance real será: 20/(20+30+50) = 20%, 30/(20+30+50) = 30%, 50/(20+30+50) = 50%.

Após alterar a configuração das recompensas, é necessário reiniciar o servidor para aplicar as mudanças.

Nesta página