Bundles

Exemplo completo de configuração

Aqui está um exemplo de como configurar um bundle:

# Nome nas mensagens
display-name: '&eBundle Padrão'

# Ordem no menu
order: 1

# Mostrar ícone no shop mesmo com a compra desativada
always-show: true

# Preços do bundle
prices:
  price1:
    # Economia registrada na economies.yml
    provider: 'money'
    # Quantia a ser cobrada
    amount: 1000.0

# Ícones nos menus
icons:
  cant:
    material: 'd421b446e53e9f375111b43d6d77abaa584a8963639ab7d5488efee6fd406a46'
    name: '&cBundle Padrão'
    lore:
      - ''
      - '&7Você não pode comprar este bundle.'
      - '&7Motivo: tempo expirado ou limite atingido.'
      - ''
  buy:
    material: 'd421b446e53e9f375111b43d6d77abaa584a8963639ab7d5488efee6fd406a46'
    name: '&eBundle Padrão'
    lore:
      - '&7Este é o Bundle Padrão do servidor'
      - '&7contendo itens básicos para iniciar.'
      - ''
      - '&fPreço: &2$ &a{money} coins&f.'
      - ''
      - '&f&lTEMPO RESTANTE: &b&l{time}&f&l.'
      - '&f&lCOMPRAS RESTANTES: &b&l{remaining}&f&l.'
      - '&f&lLIMITE: &b&l{limit}&f&l.'
      - ''
      - '&aClique para comprar.'
  owned:
    material: 'd421b446e53e9f375111b43d6d77abaa584a8963639ab7d5488efee6fd406a46'
    name: '&eBundle Padrão'
    lore:
      - '&7Este é o Bundle Padrão do servidor'
      - '&7contendo itens básicos para iniciar.'
      - ''
      - '&fQuantia Armazenada: &b{amount}'
      - ''
      - '&aClique para ativar.'

# Itens que serão dados ao ativar o bundle
items:
  item1:
    material: 'DIAMOND'
    amount: 1
    name: '&bItem Exemplo'
    lore:
      - '&7Este é um item de exemplo no'
      - '&7bundle padrão do MLNivel.'

# Comandos que serão dados ao ativar o bundle
commands:
  - 'alert {player} Comprou um Bundle Padrão!'

# Mensagens que serão enviadas para o jogador
messages:
  started:
    title: '&aBundle Ativado!'
    actionbar: '&aUm novo Bundle foi ativado para você.'
    chat: '<nl>&aUm novo Bundle foi ativado para você!<nl>&aAcesse em: &f/bundles&a.<nl>'
  buy:
    title: '&aBundle Comprado!'
    actionbar: '&aVocê comprou um novo Bundle.'
    chat: '<nl>&aVocê comprou um novo Bundle!<nl>&aAcesse em: &f/bundles&a.<nl>'
  collected:
    title: '&aBundle Coletado!'
    actionbar: '&aVocê coletado o seu Bundle.'
    chat: '<nl>&aVocê coletou o seu Bundle!<nl>&aItens enviados para o seu &finventário&a.<nl>'

# Mensagens que serão enviadas para todos os jogadores
broadcast:
  buy:
    title: ''
    actionbar: ''
    chat: ''

Estrutura de bundles

Os bundles são configurados em arquivos YAML individuais dentro da pasta bundles/.

display-name

Nome do bundle exibido nas mensagens.

Exemplo:

display-name: '&eBundle Padrão'

order

Ordem de exibição do bundle no menu (menor número = aparece primeiro).

Exemplo:

order: 1

always-show

Define se o bundle deve ser exibido no menu mesmo quando não está disponível para compra.

Exemplo:

always-show: true

Preços (prices)

Define os preços do bundle usando as economias configuradas.

Exemplo:

prices:
  price1:
    provider: 'money'
    amount: 1000.0
  price2:
    provider: 'points'
    amount: 500

Você pode adicionar múltiplos preços. O jogador precisará pagar todos eles para comprar o bundle.

Ícones (icons)

Define os ícones exibidos no menu em diferentes estados.

cant

Ícone exibido quando o bundle não pode ser comprado.

Exemplo:

icons:
  cant:
    material: 'd421b446e53e9f375111b43d6d77abaa584a8963639ab7d5488efee6fd406a46'
    name: '&cBundle Padrão'
    lore:
      - ''
      - '&7Você não pode comprar este bundle.'
      - '&7Motivo: tempo expirado ou limite atingido.'
      - ''

buy

Ícone exibido quando o bundle está disponível para compra.

Exemplo:

icons:
  buy:
    material: 'd421b446e53e9f375111b43d6d77abaa584a8963639ab7d5488efee6fd406a46'
    name: '&eBundle Padrão'
    lore:
      - '&7Este é o Bundle Padrão do servidor'
      - '&7contendo itens básicos para iniciar.'
      - ''
      - '&fPreço: &2$ &a{money} coins&f.'
      - ''
      - '&f&lTEMPO RESTANTE: &b&l{time}&f&l.'
      - '&f&lCOMPRAS RESTANTES: &b&l{remaining}&f&l.'
      - '&f&lLIMITE: &b&l{limit}&f&l.'
      - ''
      - '&aClique para comprar.'

Placeholders disponíveis: {money}, {time}, {remaining}, {limit}

owned

Ícone exibido no menu de bundles armazenados.

Exemplo:

icons:
  owned:
    material: 'd421b446e53e9f375111b43d6d77abaa584a8963639ab7d5488efee6fd406a46'
    name: '&eBundle Padrão'
    lore:
      - '&7Este é o Bundle Padrão do servidor'
      - '&7contendo itens básicos para iniciar.'
      - ''
      - '&fQuantia Armazenada: &b{amount}'
      - ''
      - '&aClique para ativar.'

Placeholder disponível: {amount} - Quantidade de bundles armazenados

Itens (items)

Define os itens que serão dados ao jogador quando ativar o bundle.

Exemplo:

items:
  item1:
    material: 'DIAMOND'
    amount: 1
    name: '&bItem Exemplo'
    lore:
      - '&7Este é um item de exemplo no'
      - '&7bundle padrão do MLNivel.'
  item2:
    material: 'EMERALD'
    amount: 5
    name: '&aEsmeraldas'
    lore:
      - '&7Esmeraldas do bundle.'

Comandos (commands)

Define os comandos que serão executados quando o bundle for ativado.

Exemplo:

commands:
  - 'alert {player} Comprou um Bundle Padrão!'
  - 'give {player} diamond_sword 1'

Placeholder disponível: {player} - Nome do jogador

Mensagens (messages)

Define as mensagens exibidas em diferentes momentos.

started

Mensagens exibidas quando o bundle é iniciado para o jogador.

Exemplo:

messages:
  started:
    title: '&aBundle Ativado!'
    actionbar: '&aUm novo Bundle foi ativado para você.'
    chat: '<nl>&aUm novo Bundle foi ativado para você!<nl>&aAcesse em: &f/bundles&a.<nl>'

buy

Mensagens exibidas quando o jogador compra o bundle.

Exemplo:

messages:
  buy:
    title: '&aBundle Comprado!'
    actionbar: '&aVocê comprou um novo Bundle.'
    chat: '<nl>&aVocê comprou um novo Bundle!<nl>&aAcesse em: &f/bundles&a.<nl>'

collected

Mensagens exibidas quando o jogador coleta o bundle.

Exemplo:

messages:
  collected:
    title: '&aBundle Coletado!'
    actionbar: '&aVocê coletado o seu Bundle.'
    chat: '<nl>&aVocê coletou o seu Bundle!<nl>&aItens enviados para o seu &finventário&a.<nl>'

Use <nl> para quebrar linha nas mensagens.

Broadcast (broadcast)

Define as mensagens enviadas para todos os jogadores.

buy

Mensagens de broadcast quando alguém compra o bundle.

Exemplo:

broadcast:
  buy:
    title: '&aBundle Comprado!'
    actionbar: '&e{player} comprou um bundle!'
    chat: '&e{player} comprou o bundle &f{bundle}&e!'

Placeholders disponíveis: {player}, {bundle}

Criando um novo bundle

Crie o arquivo

Crie um novo arquivo YAML na pasta plugins/yBundles/bundles/ com o nome do seu bundle (ex: vip.yml).

Configure as propriedades

Defina o nome, ordem e preços do bundle.

Configure os ícones

Defina os ícones para os diferentes estados do bundle.

Adicione itens e comandos

Configure os itens e comandos que serão dados ao ativar o bundle.

Configure as mensagens

Personalize as mensagens para cada evento do bundle.

Reinicie o servidor

Reinicie o servidor para carregar o novo bundle.

O nome do arquivo (sem a extensão .yml) será usado como ID do bundle nos comandos.

Nesta página