Recompensas

Exemplo completo de configuração

Aqui está um exemplo de como configurar as recompensas do plugin:

#   ____                            _
# |  _ \ _____      ____ _ _ __ __| |___
# | |_) / _ \ \ /\ / / _` | '__/ _` / __|
# |  _ <  __/\ V  V / (_| | | | (_| \__ \
# |_| \_\___| \_/\_/ \__,_|_|  \__,_|___/
#

rewards:
  reward1:
    # Item que aparecerá no preview.
    preview:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!' ]
      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}' ]
  reward2:
    preview:
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 1
      lore: [ '&bQuem não adora uma pedra preciosa?!' ]
      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}' ]
  reward3:
    preview:
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEsmeraldas valem muito?' ]
      enchants: []
    collect:
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEsmeraldas valem muito?', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEu valho muito!' ]
      enchants: []

Estrutura de uma recompensa

Cada recompensa possui três seções principais: preview, collect e os sistemas de entrega (item e command).

preview

Item que será exibido no menu de visualização dos cubos antes de serem abertos.

Exemplo:

rewards:
  reward1:
    preview:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!' ]
      enchants: []

collect

Item que será exibido no menu de coleta quando o jogador 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: {amount} - Quantidade acumulada desta recompensa.

item

Configuração do item físico 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. Valores: true ou false.

command

Configuração dos comandos que serão executados quando o jogador coletar a recompensa.

Exemplo:

rewards:
  reward1:
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: true
      list: 
        - 'give {player} stone {amount}'
        - 'say {player} ganhou pedras!'

give

Define se os comandos serão executados. Valores: true ou false.

placeholder-amount

Valor base da placeholder {amount} nos comandos.

multiply-placeholder

Define se a placeholder {amount} será multiplicada pela quantidade de recompensas acumuladas.

list

Lista de comandos a serem executados. Use {player} para o nome do jogador e {amount} para a quantidade.

Criando novas recompensas

Defina o identificador

Escolha um identificador único para a recompensa (ex: reward4, diamante_raro, etc).

Configure o preview

Defina como o item aparecerá no menu antes de ser aberto.

Configure o collect

Defina como o item aparecerá no menu de coleta.

Configure a entrega

Escolha se a recompensa será entregue como item físico, comando, ou ambos.

Adicione aos cubos

Referencie a recompensa nos arquivos de cubos usando o identificador escolhido.

Formato de materiais

Para especificar materiais, use o formato: MATERIAL:DATA

Exemplos:

STONE:0 - Pedra normal
DIAMOND:0 - Diamante
WOOL:14 - Lã vermelha

Encantamentos

Para adicionar encantamentos, use o formato: ENCANTAMENTO:NÍVEL

Exemplo:

rewards:
  espada_encantada:
    preview:
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Diamante'
      amount: 1
      lore: [ '&7Uma espada poderosa!' ]
      enchants: 
        - 'DAMAGE_ALL:5'
        - 'FIRE_ASPECT:2'
        - 'DURABILITY:3'

Os encantamentos devem ser válidos para a versão do Minecraft do seu servidor.

Recompensas múltiplas

Você pode configurar quantas recompensas quiser. Cada cubo pode ter múltiplas recompensas com chances diferentes:

rewards:
  comum:
    preview:
      material: 'STONE:0'
      name: '&7Recompensa Comum'
      amount: 1
      lore: []
      enchants: []
    collect:
      material: 'STONE:0'
      name: '&7Recompensa Comum'
      amount: 1
      lore: []
      enchants: []
    item:
      give: true
      material: 'STONE:0'
      name: '&7Recompensa Comum'
      amount: 1
      lore: []
      enchants: []
  rara:
    preview:
      material: 'DIAMOND:0'
      name: '&bRecompensa Rara'
      amount: 1
      lore: []
      enchants: []
    collect:
      material: 'DIAMOND:0'
      name: '&bRecompensa Rara'
      amount: 1
      lore: []
      enchants: []
    item:
      give: true
      material: 'DIAMOND:0'
      name: '&bRecompensa Rara'
      amount: 1
      lore: []
      enchants: []

As chances de cada recompensa são configuradas nos arquivos de cubos, não no arquivo de recompensas.

Nesta página