VIPs

Exemplo completo de configuração

Aqui está um exemplo de como configurar um VIP no plugin:

vips:
  iron:
    display: '&f[VIP Ferro]'
    prefix: '&f&l✔'
    time-type: 'SERVER'
    credit: 10.0
    party-vip-value: 10.0
    activation-menu: false
    activation-collect-message: '&aVocê recolheu a ativação do {vip_display}&a.'
    allow-sell: true
    yleague:
      points: 10.0
      embed-title: 'VIP Ferro Ativado'
    upgrade:
      vip-type: 'ouro'
      command: []
      message: |

        &b&lUPGRADE
        &aVocê upou do &f[VIP Ferro] &apara o &e&lVIP OURO
        &aVocê pagou &2$&a 10k em coins

      message-broadcast: ''
      price:
        price1:
          provider: 'money'
          price: 10000
    icon:
      material: 'IRON_INGOT'
      name: '&fVIP Ferro'
      lore: []
    announces:
      sound: ''
      effect: ''
      actionbar: '&7{player}&b acaba de ativar o &fVIP Ferro'
      title: '&7{player}&b ativou o<nl>&fVIP Ferro'
      chat: |

        &a&lVIPS
        &bO jogador &7{player} &bacaba de
        &bse tornar &7(&fVIP Ferro&7)&b.

      chat-private: |

        &a&lVIPS
        &7Recolha sua ativação no /vip

    discord:
      discordhook:
        enable: true
        dm-embed: ''
      webhook:
        enable: true
        chat-embed: 'activated'
    item:
      key-preview:
        material: TRIPWIRE_HOOK
        name: '&f[VIP Ferro] &8{id}'
        lore: [ '', ' &7Vip: &f[VIP Ferro]', ' &7ID: &f{id}', ' &7Duração: &f{expire_remaining}', '', '&aBotão &fESQUERDO &apara ativar', '&aBotão &fDIREITO &apara vender' ]
    group-command:
      add: [ 'lp user {player} parent add vip_ferro' ]
      remove: [ 'lp user {player} parent remove vip_ferro' ]
      addtime: [ 'lp user {player} parent addtemp vip_ferro {time} accumulate' ]
      removetime: [ 'lp user {player} parent removetemp vip_ferro {time}' ]
    activation-commands: [ '100.0,give {player} iron_ingot 64' ]
    activation-items:
      item-1:
        chance: 100.0
        material: 'IRON_INGOT'
        name: '&fFerro do VIP'
        lore: []
        enchants: ['DURABILITY:1']
    bungee-activation:
      bungee1:
        server: 'mina'
        commands: [ '100.0,give {player} diamond 64' ]
        items: {}

Estrutura de VIPs

Cada VIP possui diversas propriedades configuráveis.

Propriedades básicas

display

Nome de exibição do VIP usado em mensagens e menus.

Exemplo:

display: '&f[VIP Ferro]'

prefix

Prefixo especial do VIP usado em integrações com yClans e yRankup.

Exemplo:

prefix: '&f&l✔'

time-type

Define como o tempo do VIP será descontado.

Valores possíveis:

ONLINE: Desconta apenas quando o jogador está online
SERVER: Desconta apenas quando o servidor está online
BASIC: Desconta sempre, mesmo com servidor offline

Exemplo:

time-type: 'SERVER'

Escolha o tipo de tempo adequado para seu modelo de negócio. BASIC é mais justo para jogadores, mas ONLINE garante que eles aproveitem todo o tempo.

credit

Quantidade de créditos VIP dados ao jogador ao ativar este VIP.

Exemplo:

credit: 10.0

party-vip-value

Valor que será acumulado no party-vip ao ativar este VIP.

Exemplo:

party-vip-value: 10.0

Define se a ativação será enviada para o menu de ativações do jogador.

Exemplo:

activation-menu: false

activation-collect-message

Mensagem enviada quando o jogador recolhe a ativação pelo menu de ativações.

activation-collect-message: '&aVocê recolheu a ativação do {vip_display}&a.'

Use {vip_display} para mostrar o nome formatado do VIP recolhido.

allow-sell

Define se as keys deste VIP podem ser vendidas entre jogadores.

Exemplo:

allow-sell: true

Quando allow-sell é false, os jogadores não conseguem vender suas VIP keys no marketplace. Isto é útil para VIPs especiais que devem ser únicos ou para prevenir abuso de economia.

yleague

Integração com o plugin yLeague.

yleague:
  # Pontos que será dado no yLeague
  points: 10.0
  # Título da embed que é enviada no discord
  # Deixe '' para não enviar
  embed-title: 'VIP Ferro Ativado'

upgrade

Sistema de upgrade de VIP.

upgrade:
  # Tipo de VIP para qual será upado
  vip-type: 'ouro'
  # Comandos executados ao upar
  command: []
  # Mensagem enviada ao jogador
  message: |

    &b&lUPGRADE
    &aVocê upou do &f[VIP Ferro] &apara o &e&lVIP OURO
    &aVocê pagou &2$&a 10k em coins

  # Mensagem broadcast (deixe '' para desabilitar)
  message-broadcast: ''
  # Preços para realizar o upgrade
  price:
    price1:
      provider: 'money'
      price: 10000

Você pode configurar múltiplos preços usando diferentes providers de economia.

icon

Ícone do VIP usado em menus.

icon:
  material: 'IRON_INGOT'
  name: '&fVIP Ferro'
  lore: []

announces

Anúncios ao ativar o VIP.

announces:
  # Som executado (deixe '' para desabilitar)
  sound: ''
  # Efeito de partículas (deixe '' para desabilitar)
  effect: ''
  # Mensagem na actionbar
  actionbar: '&7{player}&b acaba de ativar o &fVIP Ferro'
  # Título exibido (<nl> para quebra de linha)
  title: '&7{player}&b ativou o<nl>&fVIP Ferro'
  # Mensagem no chat (broadcast)
  chat: |

    &a&lVIPS
    &bO jogador &7{player} &bacaba de
    &bse tornar &7(&fVIP Ferro&7)&b.

  # Mensagem privada quando activation-menu está ativo
  chat-private: |

    &a&lVIPS
    &7Recolha sua ativação no /vip

Placeholder disponível: {player} - Nome do jogador que ativou o VIP

bungee-announces

Anúncios enviados em ambiente BungeeCord/Velocity para servidores específicos ou para a rede, dependendo da configuração do campo server.

bungee-announces:
  bungee1:
    server: ''
    sound: ''
    effect: ''
    actionbar: '&7{player}&b acaba de ativar o &fVIP Ferro'
    title: '&7{player}&b ativou o<nl>&fVIP Ferro'
    chat: |

      &a&lVIPS
      &bO jogador &7{player} &bacaba de
      &bse tornar &7(&fVIP Ferro&7)&b.

    chat-private: |

      &a&lVIPS
      &7Recolha sua ativação no /vip

Deixe server: '' para usar o comportamento padrão da rede ou informe o servidor desejado quando quiser limitar o anúncio.

discord

Integração com Discord via webhooks.

discord:
  # Integração com yDiscordHook
  discordhook:
    enable: true
    # ID do embed para envio no privado
    dm-embed: ''
  # Webhook direto
  webhook:
    enable: true
    # ID do embed configurado em discord.yml
    chat-embed: 'activated'

item

Configuração de como as keys e VIPs aparecem em menus.

key-preview

Aparência da key no inventário do jogador.

key-preview:
  material: TRIPWIRE_HOOK
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '', ' &7Vip: &f[VIP Ferro]', ' &7ID: &f{id}', ' &7Duração: &f{expire_remaining}', '', '&aBotão &fESQUERDO &apara ativar', '&aBotão &fDIREITO &apara vender' ]

Placeholders disponíveis: {id}, {expire_remaining}, {player}, {activation_date}, {activation_hour}, {price}, {provider_abbreviated}

key-sell-preview

Aparência da key quando está sendo vendida (visão do dono).

key-sell-preview:
  material: TRIPWIRE_HOOK
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '', ' &7Vip: &f[VIP Ferro]', ' &7ID: &f{id}', ' &7Duração: &f{expire_remaining}', ' &fStatus: &aVendendo por {price} {provider_abbreviated}', '', '&aBotão &fESQUERDO &apara ativar', '&aBotão &fDIREITO &apara cancelar a venda' ]

key-sell

Aparência da key no menu de compra.

key-sell:
  material: TRIPWIRE_HOOK
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '', ' &7Vip: &f[VIP Ferro]', ' &7ID: &f{id}', ' &7Duração: &f{expire_remaining}', '', ' &fStatus: &aVendendo por {price} {provider_abbreviated}', ' &fVendedor: &7{player}', '', '&aBotão &fESQUERDO &apara comprar' ]

key-bonus-preview

Aparência da key bônus.

key-bonus-preview:
  material: TRIPWIRE_HOOK
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '', ' &7Vip: &f[VIP Ferro]', ' &7ID: &f{id}', ' &7Duração: &f{expire_remaining}', '', '&aBotão &fESQUERDO &apara ativar', '&aBotão &fDIREITO &apara enviar' ]

active

Aparência do VIP ativo.

active:
  material: IRON_INGOT
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '' ,' &fAtivado por: &a{player}', '&f Status: &aAtivo', '', '&7 Ativado em: &f{activation_date} às {activation_hour}' , ' &7Expira em: &f {expire_remaining}' , '', '&eClique para copiar a KEY do vip']

change

Aparência do VIP aguardando para ser equipado.

change:
  material: IRON_INGOT
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '', ' &fStatus: &eAGUARDANDO', ' &7Expira em: &f{expire_remaining}', ' &7Ativado em: &f{activation_date} às {activation_hour}', '', '&cClique para usar este vip' ]

expired

Aparência do VIP expirado.

expired:
  material: IRON_INGOT
  name: '&f[VIP Ferro] &8{id}'
  lore: [ '', ' &fStatus: &cEXPIRADO', ' &7Ativado em: &f{activation_date} às {activation_hour}', ''  ]

activation

Aparência da ativação pendente no menu.

activation:
  material: IRON_INGOT
  name: '&f[VIP Ferro]'
  lore: [ '&7Clique para coletar a ativação' ]

upgrade

Aparência do item de upgrade no menu.

upgrade:
  material: GOLD_INGOT
  name: '&f[VIP Ferro] -> &e&lVIP OURO'
  lore: [ '&7Faça o upgrade para o VIP OURO.', '', '&fPreço: &2$&a 10k em coins', '', '&aClique para upar' ]

group-command

Comandos executados para adicionar/remover o grupo de permissão.

group-command:
  # Comandos ao ativar o VIP
  add: [ 'lp user {player} parent add vip_ferro' ]
  # Comandos ao remover o VIP
  remove: [ 'lp user {player} parent remove vip_ferro' ]
  # Comandos ao adicionar tempo temporário ao VIP
  addtime: [ 'lp user {player} parent addtemp vip_ferro {time} accumulate' ]
  # Comandos ao remover tempo temporário do VIP
  removetime: [ 'lp user {player} parent removetemp vip_ferro {time}' ]

Placeholders disponíveis: {player} - Nome do jogador, {time} - Tempo temporário aplicado ou removido

activation-commands

Comandos executados ao ativar o VIP.

activation-commands: [ '100.0,give {player} iron_ingot 64' ]

Formato: chance,comando

Exemplo: 100.0,give {player} iron_ingot 64 - 100% de chance de dar 64 iron ingots

activation-items

Itens dados ao ativar o VIP.

activation-items:
  item-1:
    chance: 100.0
    material: 'IRON_INGOT'
    name: '&fFerro do VIP'
    lore: []
    enchants: ['DURABILITY:1']

chance: Porcentagem de chance do item ser dado (0.0 a 100.0)

enchants: Lista de encantamentos no formato ENCANTAMENTO:NÍVEL

bungee-activation

Comandos e itens executados em outros servidores da rede BungeeCord.

bungee-activation:
  bungee1:
    # Nome do servidor na proxy
    server: 'mina'
    # Comandos executados nesse servidor
    commands: [ '100.0,give {player} diamond 64' ]
    # Itens dados nesse servidor
    items: {}

Nesta página