Fragmentos

Exemplo completo de configuração

Aqui está um exemplo de como configurar os fragmentos do plugin:

#    ____           _
#  / ___|_ __ __ _| |_ ___  ___
# | |   | '__/ _` | __/ _ \/ __|
# | |___| | | (_| | ||  __/\__ \
#  \____|_|  \__,_|\__\___||___/
#

fragmentos:
  rocha:
    # Ordem no menu
    order: 1
    # Identificação necessária para a API de Economias do yPlugins
    yplugins-id: 'yfragmentosvirtuais-rocha'
    # Nome nas mensagens
    display: '&8Rocha'
    # Ativar a coleta
    collect: true
    # Comando
    command:
      command: 'rocha'
      aliases: [ 'rochas' ]
    # Mensagem de uso do comando
    usage:
      pay: '&cUse: /{command} {arg} <player> <quantia>'
    # Permissões dos comandos
    permission:
      look: 'yfragmentosvirtuais.rocha.look'
      pay: 'yfragmentosvirtuais.rocha.pay'
    # Mensagens do comando
    message:
      balance: '&aVocê possui: &f{fragment}&a rochas.'
      balance-target: '&aO jogador &7{player}&a possui: &f{fragment}&a rochas.'
      has: '&cVocê não possui esta quantia de rochas.'
      send: '&aVocê enviou &f{fragment}&a rochas para o jogador &7{player}&a.'
      received: '&aVocê recebeu &f{fragment}&a rochas do jogador &7{player}&a.'
    # Item que poderá ser ativado
    usable:
      material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'
      name: '&8Fragmento de rocha &7[{amount}]'
      lore: [ '&7Utilize este fragmento', '&7acessando &f/fragmentos' ]
    # Item da crate no menu
    menu:
      has:
        material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'
        name: '&8Fragmento de rocha'
        lore: [ '&fQuantidade: &7{amount}', '', '&aClique para recolher.' ]
      no-has:
        material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'
        name: '&8Fragmento de rocha'
        lore: [ '', '&cVocê não possui esse fragmento.' ]

Estrutura de fragmentos

Cada fragmento possui diversas configurações que você pode personalizar.

order

Define a ordem de exibição do fragmento no menu.

Exemplo:

order: 1

yplugins-id

Identificação necessária para a API de Economias do yPlugins.

Exemplo:

yplugins-id: 'yfragmentosvirtuais-rocha'

Este ID é usado para integração com outros plugins do yPlugins.

display

Nome do fragmento exibido nas mensagens.

Exemplo:

display: '&8Rocha'

collect

Define se o fragmento pode ser coletado.

Exemplo:

collect: true

command

Configuração do comando específico do fragmento.

Exemplo:

command:
  command: 'rocha'
  aliases: [ 'rochas' ]

Você pode adicionar múltiplas aliases para cada fragmento.

usage

Mensagens de uso dos comandos.

Exemplo:

usage:
  pay: '&cUse: /{command} {arg} <player> <quantia>'

permission

Permissões necessárias para os comandos do fragmento.

Exemplo:

permission:
  look: 'yfragmentosvirtuais.rocha.look'
  pay: 'yfragmentosvirtuais.rocha.pay'

message

Mensagens personalizadas para este fragmento específico.

Exemplo:

message:
  balance: '&aVocê possui: &f{fragment}&a rochas.'
  balance-target: '&aO jogador &7{player}&a possui: &f{fragment}&a rochas.'
  has: '&cVocê não possui esta quantia de rochas.'
  send: '&aVocê enviou &f{fragment}&a rochas para o jogador &7{player}&a.'
  received: '&aVocê recebeu &f{fragment}&a rochas do jogador &7{player}&a.'

Placeholders disponíveis: {fragment}, {player}, {command}, {arg}

usable

Configuração do item físico que representa o fragmento.

Exemplo:

usable:
  material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'
  name: '&8Fragmento de rocha &7[{amount}]'
  lore: [ '&7Utilize este fragmento', '&7acessando &f/fragmentos' ]

O material pode ser o nome do item ou uma textura de cabeça (skin).

Configuração da aparência do fragmento no menu.

has

Item exibido quando o jogador possui o fragmento.

Exemplo:

menu:
  has:
    material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'
    name: '&8Fragmento de rocha'
    lore: [ '&fQuantidade: &7{amount}', '', '&aClique para recolher.' ]

no-has

Item exibido quando o jogador não possui o fragmento.

Exemplo:

menu:
  no-has:
    material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'
    name: '&8Fragmento de rocha'
    lore: [ '', '&cVocê não possui esse fragmento.' ]

Adicionando novos fragmentos

Para adicionar um novo fragmento, basta copiar a estrutura de um fragmento existente e modificá-lo:

fragmentos:
  diamante:
    order: 2
    yplugins-id: 'yfragmentosvirtuais-diamante'
    display: '&bDiamante'
    collect: true
    command:
      command: 'diamante'
      aliases: [ 'diamantes' ]
    usage:
      pay: '&cUse: /{command} {arg} <player> <quantia>'
    permission:
      look: 'yfragmentosvirtuais.diamante.look'
      pay: 'yfragmentosvirtuais.diamante.pay'
    message:
      balance: '&aVocê possui: &f{fragment}&a diamantes.'
      balance-target: '&aO jogador &7{player}&a possui: &f{fragment}&a diamantes.'
      has: '&cVocê não possui esta quantia de diamantes.'
      send: '&aVocê enviou &f{fragment}&a diamantes para o jogador &7{player}&a.'
      received: '&aVocê recebeu &f{fragment}&a diamantes do jogador &7{player}&a.'
    usable:
      material: 'DIAMOND'
      name: '&bFragmento de diamante &7[{amount}]'
      lore: [ '&7Utilize este fragmento', '&7acessando &f/fragmentos' ]
    menu:
      has:
        material: 'DIAMOND'
        name: '&bFragmento de diamante'
        lore: [ '&fQuantidade: &7{amount}', '', '&aClique para recolher.' ]
      no-has:
        material: 'DIAMOND'
        name: '&bFragmento de diamante'
        lore: [ '', '&cVocê não possui esse fragmento.' ]

Após adicionar novos fragmentos, é necessário reiniciar o servidor para aplicar as mudanças.

Nesta página