Grupos

Grupos de Blocos

Os grupos permitem configurar diferentes blocos com suas respectivas recompensas, experiências e valores. Cada grupo pode ter sua própria permissão e configurações específicas.

Os arquivos de grupo ficam localizados na pasta groups/. Você pode criar vários grupos diferentes como member.yml, vip.yml, premium.yml, etc.

Estrutura Básica

# groups/member.yml
order: 1
world-blacklist: []
permission: ''
messages:
  chat: ''
  title: ''
  actionbar: '&a+ &2$ &f{money}&a coins'
blocks:
  stone:
    material: 'STONE:0'
    fortune: true
    exp: 1.0
    mcmmo:
      exp: 1.0
      skill: 'MINING'
    rewards:
      - '50.0,reward1'
      - '30.0,reward2'
    prices:
      price1:
        provider: 'money'
        amount: 100.0

Configurações do Grupo

order

Tipo: Number
Descrição: Ordem de prioridade para verificação do grupo
Exemplo: 1

Grupos com menor valor de order têm maior prioridade. Se um jogador possui permissão para múltiplos grupos, será usado o de maior prioridade.

world-blacklist

Tipo: List<String>
Descrição: Lista de mundos onde este grupo não funcionará
Exemplo:

world-blacklist:
  - 'world_the_end'
  - 'world_nether'

permission

Tipo: String
Descrição: Permissão necessária para pertencer a este grupo
Exemplo: yvender.group.vip
Padrão: '' (sem permissão, disponível para todos)

messages

Tipo: Object
Descrição: Mensagens customizadas para este grupo ao vender blocos

messages.chat

Tipo: String
Descrição: Mensagem enviada no chat ao vender
Exemplo: '&aVocê vendeu {amount}x {block} por &2$ &f{money}'

messages.title

Tipo: String
Descrição: Mensagem de título ao vender
Exemplo: '&a+ $ {money}'

messages.actionbar

Tipo: String
Descrição: Mensagem na action bar ao vender
Exemplo: '&a+ &2$ &f{money}&a coins'

Placeholders disponíveis:

{money} - Valor recebido
{amount} - Quantidade de blocos vendidos
{block} - Nome do bloco

Configuração de Blocos

material

Tipo: String
Descrição: Material do bloco no formato MATERIAL:DATA
Exemplo: STONE:0, DIAMOND_ORE:0

Certifique-se de usar o nome correto do material para sua versão do Minecraft. Para versões 1.13+, não é necessário especificar o data value.

fortune

Tipo: Boolean
Descrição: Define se a fortuna da picareta afeta a venda deste bloco
Padrão: false

exp

Tipo: Number
Descrição: Quantidade de XP vanilla que o jogador recebe ao vender este bloco
Exemplo: 1.0

mcmmo

Tipo: Object
Descrição: Configurações de XP do mcMMO

mcmmo.exp

Tipo: Number
Descrição: Quantidade de XP do mcMMO
Exemplo: 1.0

mcmmo.skill

Tipo: String
Descrição: Habilidade do mcMMO que receberá a experiência
Valores: MINING, EXCAVATION, WOODCUTTING, etc.

rewards

Tipo: List<String>
Descrição: Lista de recompensas com suas chances no formato chance,recompensa_id
Exemplo:

rewards:
  - '50.0,reward1'  # 50% de chance
  - '30.0,reward2'  # 30% de chance
  - '10.0,reward3'  # 10% de chance

As recompensas devem estar configuradas no arquivo rewards.yml. A chance é verificada para cada bloco vendido.

prices

Tipo: Object
Descrição: Economias que o jogador receberá ao vender este bloco

prices.{id}.provider

Tipo: String
Descrição: ID do provedor de economia (configurado em economies.yml)
Exemplo: money, gems, tokens

prices.{id}.amount

Tipo: Number
Descrição: Quantidade da economia que será recebida
Exemplo: 100.0

Exemplo Completo

# groups/vip.yml
# Ordem para checagem
order: 1

# Mundos onde esse grupo não irá funcionar
world-blacklist:
  - 'world_pvp'

# Permissão para pertencer a esse grupo
permission: 'yvender.group.vip'

# Mensagens de venda
messages:
  chat: '&aVocê vendeu &f{amount}x {block} &apor &2$ &f{money}'
  title: '&a&l+ $ {money}'
  actionbar: '&a+ &2$ &f{money}&a coins'

# Blocos desse grupo
blocks:
  stone:
    material: 'STONE:0'
    fortune: true
    exp: 1.0
    mcmmo:
      exp: 1.0
      skill: 'MINING'
    rewards:
      - '50.0,comum'
      - '30.0,raro'
      - '10.0,epico'
    prices:
      money:
        provider: 'money'
        amount: 150.0
      gems:
        provider: 'gems'
        amount: 5.0
  
  diamond_ore:
    material: 'DIAMOND_ORE:0'
    fortune: true
    exp: 10.0
    mcmmo:
      exp: 15.0
      skill: 'MINING'
    rewards:
      - '80.0,raro'
      - '15.0,epico'
      - '5.0,lendario'
    prices:
      money:
        provider: 'money'
        amount: 1000.0
      gems:
        provider: 'gems'
        amount: 50.0

Múltiplos Grupos

Você pode criar vários arquivos de grupo na pasta groups/:

groups/member.yml - Grupo padrão
groups/vip.yml - Grupo VIP
groups/premium.yml - Grupo Premium
groups/ultimate.yml - Grupo Ultimate

Cada grupo pode ter seus próprios blocos, valores e recompensas. Isso permite criar uma progressão de benefícios baseada em permissões.

Nesta página