Recompensas Diárias

Exemplo completo de configuração

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

daily-rewards:
  daily_reward1:
    order: 1
    display: '&7Membro'
    permission: ''
    delay: 60 # em segundos
    # Tempo online necessário para coletar a recompensa
    # Em segundos (yTempoOnline)
    online-time-need: 0
    item:
      can:
        material: 'c5a9cd58d4c67bccc8fb1f5f756a2d381c9ffac2924b7f4cb71aa9fa13fb5c'
        name: '&aRecompensa de &7Membros'
        lore: [ '', '&7Recompensa: &f1x Pedra', '', '&aClique para pegar.', '' ]
      cant:
        material: 'c5a9cd58d4c67bccc8fb1f5f756a2d381c9ffac2924b7f4cb71aa9fa13fb5c'
        name: '&aRecompensa de &7Membros'
        lore: [ '', '&7Recompensa: &f1x Pedra', '', '&cVocê precisa aguardar &f{time}&c antes.', '&cde pegar novamente.', '' ]
      permission:
        material: 'c5a9cd58d4c67bccc8fb1f5f756a2d381c9ffac2924b7f4cb71aa9fa13fb5c'
        name: '&aRecompensa de &7Membros'
        lore: [ '', '&7Recompensa: &f1x Pedra', '', '&cVocê não tem permissão para pegar.', '' ]
    message:
      title: '&aRecompensa &7MEMBRO<nl>&eColetada!'
      actionbar: '&aRecompensa &7MEMBRO &ecoletada!'
      chat: |
        <nl>
        &aRecompensa &7MEMBRO &ecoletada!
        <nl>
    rewards:
      - '100.0,reward1'

Estrutura de recompensas diárias

Cada recompensa diária é identificada por uma chave única (ex: daily_reward1, daily_reward2) e possui configurações específicas de exibição, permissões e recompensas.

order

Define a ordem de exibição da recompensa no menu.

Exemplo:

order: 1

Recompensas com ordem menor aparecem primeiro no menu.

display

Nome de exibição da recompensa.

Exemplo:

display: '&7Membro'

permission

Permissão necessária para coletar a recompensa. Deixe vazio ('') para não exigir permissão.

Exemplo:

permission: ''

Exemplo com permissão:

permission: 'vip.gold'

delay

Tempo de espera em segundos entre cada coleta da recompensa.

Exemplo:

delay: 60 # 60 segundos = 1 minuto

Exemplo de valores: 60 = 1 minuto, 3600 = 1 hora, 86400 = 1 dia

online-time-need

Tempo online necessário (em segundos) para coletar a recompensa. Requer o plugin yTempoOnline.

Exemplo:

online-time-need: 0

Exemplo com tempo necessário:

online-time-need: 3600 # 1 hora de tempo online

Esta funcionalidade requer o plugin yTempoOnline instalado no servidor.

item

Configuração dos itens exibidos no menu em diferentes estados.

can

Item exibido quando o jogador pode coletar a recompensa.

Exemplo:

item:
  can:
    material: 'c5a9cd58d4c67bccc8fb1f5f756a2d381c9ffac2924b7f4cb71aa9fa13fb5c'
    name: '&aRecompensa de &7Membros'
    lore: [ '', '&7Recompensa: &f1x Pedra', '', '&aClique para pegar.', '' ]

O material pode ser um tipo do Minecraft (ex: DIAMOND:0) ou uma textura de cabeça (código de 64 caracteres).

cant

Item exibido quando o jogador não pode coletar a recompensa (ainda está no delay).

Exemplo:

item:
  cant:
    material: 'c5a9cd58d4c67bccc8fb1f5f756a2d381c9ffac2924b7f4cb71aa9fa13fb5c'
    name: '&aRecompensa de &7Membros'
    lore: [ '', '&7Recompensa: &f1x Pedra', '', '&cVocê precisa aguardar &f{time}&c antes.', '&cde pegar novamente.', '' ]

Placeholder disponível: {time} - Tempo restante formatado até poder coletar novamente

permission

Item exibido quando o jogador não tem permissão para coletar a recompensa.

Exemplo:

item:
  permission:
    material: 'c5a9cd58d4c67bccc8fb1f5f756a2d381c9ffac2924b7f4cb71aa9fa13fb5c'
    name: '&aRecompensa de &7Membros'
    lore: [ '', '&7Recompensa: &f1x Pedra', '', '&cVocê não tem permissão para pegar.', '' ]

message

Configuração das mensagens exibidas quando o jogador coleta a recompensa.

Exemplo:

message:
  title: '&aRecompensa &7MEMBRO<nl>&eColetada!'
  actionbar: '&aRecompensa &7MEMBRO &ecoletada!'
  chat: |
    <nl>
    &aRecompensa &7MEMBRO &ecoletada!
    <nl>

title

Mensagem exibida como título na tela.

Exemplo:

title: '&aRecompensa &7MEMBRO<nl>&eColetada!'

Use <nl> para quebrar linha em títulos.

actionbar

Mensagem exibida na barra de ação (acima da hotbar).

Exemplo:

actionbar: '&aRecompensa &7MEMBRO &ecoletada!'

chat

Mensagem exibida no chat. Use | após os dois pontos para múltiplas linhas.

Exemplo:

chat: |
  <nl>
  &aRecompensa &7MEMBRO &ecoletada!
  <nl>

rewards

Lista de recompensas que o jogador receberá ao coletar. Formato: 'chance,reward_id'

Exemplo:

rewards:
  - '100.0,reward1'
  - '50.0,reward2'
  - '25.0,reward3'

O primeiro valor é a chance percentual (0.0-100.0) e o segundo é o ID da recompensa configurado em rewards.yml.

Criando novas recompensas diárias

Defina a chave

Escolha uma chave única para a recompensa diária.

daily-rewards:
  daily_reward_vip:

Configure as opções básicas

Defina ordem, display, permissão e delay.

    order: 2
    display: '&6VIP'
    permission: 'vip.gold'
    delay: 3600 # 1 hora
    online-time-need: 0

Configure os itens

Defina os itens para os três estados (can, cant, permission).

    item:
      can:
        material: 'DIAMOND:0'
        name: '&6Recompensa VIP'
        lore: [ '', '&7Recompensa especial!', '', '&aClique para pegar.', '' ]
      cant:
        material: 'COAL:0'
        name: '&6Recompensa VIP'
        lore: [ '', '&cAguarde &f{time}', '' ]
      permission:
        material: 'BARRIER:0'
        name: '&6Recompensa VIP'
        lore: [ '', '&cApenas VIP!', '' ]

Configure as mensagens

Defina as mensagens de coleta.

    message:
      title: '&6Recompensa VIP<nl>&eColetada!'
      actionbar: '&6Recompensa VIP &ecoletada!'
      chat: |
        <nl>
        &6Recompensa VIP &ecoletada!
        <nl>

Configure as recompensas

Defina quais recompensas serão entregues.

    rewards:
      - '100.0,reward2'
      - '100.0,reward3'

Salve e recarregue

Reinicie o servidor ou use /dailyreward reload.

Exemplos práticos

Recompensa Membro (24 horas)

daily-rewards:
  daily_member:
    order: 1
    display: '&7Membro'
    permission: ''
    delay: 86400 # 24 horas
    online-time-need: 0
    item:
      can:
        material: 'CHEST:0'
        name: '&aRecompensa Diária'
        lore: [ '', '&7Disponível a cada 24h', '', '&aClique para coletar!', '' ]
      cant:
        material: 'ENDER_CHEST:0'
        name: '&cRecompensa Diária'
        lore: [ '', '&cPróxima recompensa em:', '&f{time}', '' ]
      permission:
        material: 'BARRIER:0'
        name: '&cRecompensa Diária'
        lore: [ '', '&cSem permissão!', '' ]
    message:
      title: '&aRecompensa Diária<nl>&eColetada!'
      actionbar: '&aVocê coletou sua recompensa diária!'
      chat: |
        <nl>
        &a▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
        &aRecompensa diária coletada com sucesso!
        &a▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
        <nl>
    rewards:
      - '100.0,reward1'
      - '50.0,reward2'

Recompensa VIP (6 horas)

daily-rewards:
  daily_vip:
    order: 2
    display: '&6VIP'
    permission: 'group.vip'
    delay: 21600 # 6 horas
    online-time-need: 3600 # 1 hora de tempo online
    item:
      can:
        material: 'GOLD_BLOCK:0'
        name: '&6Recompensa VIP'
        lore: [ '', '&7Exclusivo para VIPs', '&7Disponível a cada 6h', '', '&aClique para coletar!', '' ]
      cant:
        material: 'COAL_BLOCK:0'
        name: '&6Recompensa VIP'
        lore: [ '', '&cPróxima recompensa em:', '&f{time}', '' ]
      permission:
        material: 'BARRIER:0'
        name: '&6Recompensa VIP'
        lore: [ '', '&cApenas VIPs podem coletar!', '&7Adquira VIP em:', '&bloja.seuservidor.com', '' ]
    message:
      title: '&6Recompensa VIP<nl>&eColetada!'
      actionbar: '&6Você coletou sua recompensa VIP!'
      chat: |
        <nl>
        &6▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
        &6Recompensa VIP coletada com sucesso!
        &6▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
        <nl>
    rewards:
      - '100.0,reward2'
      - '100.0,reward3'
      - '75.0,money_reward'

Recompensa MVP (1 hora com tempo online)

daily-rewards:
  daily_mvp:
    order: 3
    display: '&b&lMVP+'
    permission: 'group.mvp'
    delay: 3600 # 1 hora
    online-time-need: 1800 # 30 minutos de tempo online
    item:
      can:
        material: 'DIAMOND_BLOCK:0'
        name: '&b&lRecompensa MVP+'
        lore: [ '', '&7Exclusivo para MVP+', '&7Requer 30min de tempo online', '&7Disponível a cada hora', '', '&aClique para coletar!', '' ]
      cant:
        material: 'IRON_BLOCK:0'
        name: '&b&lRecompensa MVP+'
        lore: [ '', '&cPróxima recompensa em:', '&f{time}', '' ]
      permission:
        material: 'BARRIER:0'
        name: '&b&lRecompensa MVP+'
        lore: [ '', '&cApenas MVP+ podem coletar!', '&7Adquira MVP+ em:', '&bloja.seuservidor.com', '' ]
    message:
      title: '&b&lRecompensa MVP+<nl>&eColetada!'
      actionbar: '&b&lVocê coletou sua recompensa MVP+!'
      chat: |
        <nl>
        &b▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
        &b&lRecompensa MVP+ coletada com sucesso!
        &b▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
        <nl>
    rewards:
      - '100.0,reward1'
      - '100.0,reward2'
      - '100.0,reward3'
      - '100.0,money_reward'
      - '50.0,rare_reward'

Sempre teste suas configurações em um ambiente de testes antes de aplicar em produção!

Nesta página