LogoyStore

Cubos

Configure os cubos individuais e suas recompensas.

Exemplo completo de configuração

Aqui está um exemplo de como configurar um cubo:

# Ordem do tipo de cubo
# O jogador começa no cubo de ordem 1
# Ele evolui o nível assim que termina de coletar todos
order: 1

# Nome nas mensagens
display: '&fCubo Básico'

# Permissão para abrir os cubos
permission: ''

# Item do cubo coletado
collected:
  material: 'BARRIER'
  name: '&cCubo resgatado!'
  lore: [ '&7Este cubo já foi resgatado', '&7tente abrir outro cubo!' ]

# Configurações do menu
menu:
  name: '&8Cubos'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 16, 20, 21, 22, 23, 24, 25, 29, 30, 31, 32, 33, 34, 38, 39, 40, 41, 42, 43 ]
  previous-slot: 48
  next-slot: 50
  items:
    info-slot: 0
    collect-slot: 45
    top-slot: 53
    info:
      material: '9a3cc25a16c97b4fc63858ad1a8f5d293ecf285f702efdc4caa31a8cea9e4621'
      name: '&eCubos aleatórios'
      lore: [ '&7Sua recompensa está oculta', '&7em um dos mistérios aqui.', '', '&e* Gaste &l10&e fragmentos para', '&e abrir um cubo.', '', '&fSeu saldo de fragmentos: &e{fragments}' ]
    collect:
      material: 'QUARTZ'
      name: '&eFragmento'
      lore: [ '&7Clique para recolher os', '&7fragmentos que você possui.', '', '&fSeu saldo de fragmentos: &e{fragments}' ]
    top:
      material: 'GOLD_INGOT'
      name: '&eTOP Cubos'
      lore: [ '&7Clique para ver os usuários', '&7que mais ativaram cubos.' ]
  facing:
    1:
      material: 'STAINED_GLASS_PANE:15'
      name: '&r'
      slot: 9
    2:
      material: 'STAINED_GLASS_PANE:15'
      name: '&r'
      slot: 18
    3:
      material: 'STAINED_GLASS_PANE:15'
      name: '&r'
      slot: 27
    4:
      material: 'STAINED_GLASS_PANE:15'
      name: '&r'
      slot: 36

# Configuração de cada cubo
cubos:
  cubo1:
    material: '925aca61e1b8beca9befcadd08262c5821e275be414d94f0b27e8580f20dbf3a'
    name: '&e&kaaaaaaaaaaaa'
    lore: [ '&7Um item misterioso está oculto aqui.', '', '&fRequisitos p/ abrir:', '&e* &f&l{ycubos}x &ffragmentos.', '', '&fClique para abrir.' ]
    # Preços do cubo
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0
    # Quantia máxima de recompensas que o cubo pode dar
    # Deixe 0 para rodar toda a lista
    max-rewards: 0
    # chance,recompensa
    rewards: [ '100.0,reward1' ]
  cubo2:
    material: '925aca61e1b8beca9befcadd08262c5821e275be414d94f0b27e8580f20dbf3a'
    name: '&e&kaaaaaaaaaaaa'
    lore: [ '&7Um item misterioso está oculto aqui.', '', '&fRequisitos p/ abrir:', '&e* &f&l{ycubos}x &ffragmentos.', '', '&fClique para abrir.' ]
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0
    max-rewards: 0
    rewards: [ '100.0,reward2' ]
  cubo3:
    material: '925aca61e1b8beca9befcadd08262c5821e275be414d94f0b27e8580f20dbf3a'
    name: '&e&kaaaaaaaaaaaa'
    lore: [ '&7Um item misterioso está oculto aqui.', '', '&fRequisitos p/ abrir:', '&e* &f&l{ycubos}x &ffragmentos.', '', '&fClique para abrir.' ]
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0
    max-rewards: 0
    rewards: [ '100.0,reward3' ]

Estrutura do arquivo

Cada arquivo de cubo na pasta cubos/ representa um menu completo de cubos.

order

Define a ordem de progressão dos cubos. O jogador começa no cubo de ordem 1 e progride conforme completa os cubos.

Exemplo:

order: 1

display

Nome do menu de cubos que aparecerá nas mensagens.

Exemplo:

display: '&fCubo Básico'

permission

Permissão necessária para acessar este menu de cubos. Deixe vazio para não exigir permissão.

Exemplo:

permission: 'ycubos.basic'

ou

permission: ''

collected

Configuração do item que aparece quando um cubo já foi coletado.

Exemplo:

collected:
  material: 'BARRIER'
  name: '&cCubo resgatado!'
  lore: 
    - '&7Este cubo já foi resgatado'
    - '&7tente abrir outro cubo!'

Configuração do menu

Título do inventário do menu.

Exemplo:

menu:
  name: '&8Cubos'

Tamanho do inventário (deve ser múltiplo de 9, máximo 54).

Exemplo:

menu:
  size: 54

Lista de slots onde os cubos serão exibidos.

Exemplo:

menu:
  slots: [ 11, 12, 13, 14, 15, 16, 20, 21, 22, 23, 24, 25 ]

Posição dos botões de página anterior e próxima.

Exemplo:

menu:
  previous-slot: 48
  next-slot: 50

Itens do menu

items.info

Item informativo sobre os cubos.

Exemplo:

menu:
  items:
    info-slot: 0
    info:
      material: '9a3cc25a16c97b4fc63858ad1a8f5d293ecf285f702efdc4caa31a8cea9e4621'
      name: '&eCubos aleatórios'
      lore: 
        - '&7Sua recompensa está oculta'
        - '&7em um dos mistérios aqui.'
        - ''
        - '&e* Gaste &l10&e fragmentos para'
        - '&e abrir um cubo.'
        - ''
        - '&fSeu saldo de fragmentos: &e{fragments}'

Placeholder disponível: {fragments} - Saldo de fragmentos do jogador.

items.collect

Item para coletar fragmentos acumulados.

Exemplo:

menu:
  items:
    collect-slot: 45
    collect:
      material: 'QUARTZ'
      name: '&eFragmento'
      lore: 
        - '&7Clique para recolher os'
        - '&7fragmentos que você possui.'
        - ''
        - '&fSeu saldo de fragmentos: &e{fragments}'

items.top

Item para acessar o ranking de cubos.

Exemplo:

menu:
  items:
    top-slot: 53
    top:
      material: 'GOLD_INGOT'
      name: '&eTOP Cubos'
      lore: 
        - '&7Clique para ver os usuários'
        - '&7que mais ativaram cubos.'

facing

Itens decorativos do menu.

Exemplo:

menu:
  facing:
    1:
      material: 'STAINED_GLASS_PANE:15'
      name: '&r'
      slot: 9
    2:
      material: 'STAINED_GLASS_PANE:15'
      name: '&r'
      slot: 18

Configuração dos cubos individuais

Cada cubo dentro do menu possui suas próprias configurações.

material

Material do cubo. Pode ser um item do Minecraft ou uma textura de cabeça customizada.

Exemplo:

cubos:
  cubo1:
    material: 'CHEST:0'

ou com textura customizada:

cubos:
  cubo1:
    material: '925aca61e1b8beca9befcadd08262c5821e275be414d94f0b27e8580f20dbf3a'

name

Nome do cubo.

Exemplo:

cubos:
  cubo1:
    name: '&e&kaaaaaaaaaaaa'

lore

Descrição do cubo.

Exemplo:

cubos:
  cubo1:
    lore: 
      - '&7Um item misterioso está oculto aqui.'
      - ''
      - '&fRequisitos p/ abrir:'
      - '&e* &f&l{ycubos}x &ffragmentos.'
      - ''
      - '&fClique para abrir.'

Placeholder disponível: {ycubos} - Quantidade de fragmentos necessários.

prices

Preço para abrir o cubo.

Exemplo:

cubos:
  cubo1:
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0

Você pode adicionar múltiplos preços:

cubos:
  cubo1:
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0
      price2:
        provider: 'money'
        amount: 1000.0

max-rewards

Quantidade máxima de recompensas que o cubo pode dar. Use 0 para rodar toda a lista de recompensas.

Exemplo:

cubos:
  cubo1:
    max-rewards: 1

ou

cubos:
  cubo1:
    max-rewards: 0

rewards

Lista de recompensas possíveis no formato: 'chance,recompensa'

Exemplo:

cubos:
  cubo1:
    rewards: 
      - '50.0,reward1'
      - '30.0,reward2'
      - '20.0,reward3'

A chance é em porcentagem. Use 100.0 para garantir a recompensa.

Criando novos menus de cubos

Crie o arquivo

Crie um novo arquivo .yml na pasta plugins/yCubos/cubos/.

Defina a ordem

Configure a order para definir quando este menu será desbloqueado.

Configure o menu

Ajuste o tamanho, slots e itens do menu conforme necessário.

Adicione os cubos

Crie quantos cubos quiser dentro da seção cubos:.

Configure as recompensas

Defina as chances e recompensas para cada cubo.

Reinicie o servidor

Reinicie o servidor para carregar o novo menu.

Exemplos de configuração

Cubo com múltiplas recompensas

cubos:
  cubo_sortudo:
    material: 'CHEST:0'
    name: '&6Cubo Sortudo'
    lore: 
      - '&7Este cubo pode dar múltiplas recompensas!'
      - ''
      - '&fPreço: &e10 fragmentos'
      - ''
      - '&aClique para abrir!'
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0
    max-rewards: 3
    rewards: 
      - '80.0,reward1'
      - '50.0,reward2'
      - '20.0,reward3'

Cubo com preço em dinheiro

cubos:
  cubo_premium:
    material: 'ENDER_CHEST:0'
    name: '&5Cubo Premium'
    lore: 
      - '&7Um cubo especial com recompensas únicas!'
      - ''
      - '&fPreço: &e10 fragmentos &7+ &a$5000'
      - ''
      - '&dClique para abrir!'
    prices:
      price1:
        provider: 'ycubos'
        amount: 10.0
      price2:
        provider: 'money'
        amount: 5000.0
    max-rewards: 1
    rewards: 
      - '100.0,reward_raro'

Cubo com chance baixa

cubos:
  cubo_raro:
    material: 'TRAPPED_CHEST:0'
    name: '&cCubo Raro'
    lore: 
      - '&7Cuidado! Este cubo tem poucos vencedores.'
      - ''
      - '&fPreço: &e5 fragmentos'
      - ''
      - '&cClique para tentar a sorte!'
    prices:
      price1:
        provider: 'ycubos'
        amount: 5.0
    max-rewards: 1
    rewards: 
      - '5.0,reward_lendario'
      - '95.0,reward_comum'

As recompensas referenciadas devem estar configuradas no arquivo rewards.yml.

Nesta página