Roletas

Exemplo completo de configuração

Aqui está um exemplo de como configurar uma roleta (arquivo em roulettes/default.yml):

display: '&eRoleta da Sorte &7(Básica)'

# Permissão para poder usar a roleta
permission: ''

# Cabeças que irão aparecer na roleta
# Pode ser qualquer bloco (além da skull)
skulls:
  - '8534b17d2d3b5a64c57f5f080dd777945761d9f71d82e8f599f242976e4d0c05'
  - 'c133414759f9e5315156017023a8b1b31cfbf177dcafb0603b8e9d94036a23f1'
  - '300c817432585fadcbd9ca8cfedfeedbce5851b7c07d1b073fb52fa8283e8f23'
  - 'f171a0c0572824da80366d71c5413a7e3355abec79b8f529f1dc9dad2632f485'
  - '6ab180e820f71629f01f25b62bdeb9c324d50a38af74e6a9321439471046dc41'
  - '65fed46b39c6c34d491143b72ce728797d16f9b5aa40bbdec61667f5ff9d3d45'
  - '17bc1b64cba3dc4cefe4e121c3cdbbb0fa99aba0e113b5c916815fc9b304e636'
  - '29942dd1338abeae8b8274a41ae1dcdf2b7be449f28d6b650ec06e491e70f570'

# Configuração do holograma
hologram:
  off-set: 2.2
  lines: [ '&a{reward}', '[item]{reward_preview}' ]

# Sistema de partículas
# Lista disponível: https://github.com/retrooper/packetevents/blob/f0b15c3f949ce80577420e64c6ff973ce5a218bd/api/src/main/java/com/github/retrooper/packetevents/protocol/particle/type/ParticleTypes.java#L43
particles:
  # Partícula ao aparecer as skulls na roleta
  appear: 'ENCHANT'
  # Partícula ao sumir as skulls da roleta
  disappear: 'LARGE_SMOKE'
  # Partícula de sorteando a recompensa
  sorting: 'HAPPY_VILLAGER'
  # Partícula ao receber a recompensa e apagar a última skull
  appear-reward: 'CLOUD'

# Sistema de sons
# Lista disponível:
sounds:
  # Som ao aparecer as skulls na roleta
  appear: 'NOTE_PLING'
  # Som ao sumir as skulls da roleta
  disappear: 'NOTE_BASS'
  # Som enquanto a roleta estiver rodando
  running: 'NOTE_STICKS'
  # Som de sorteando a recompensa
  sorting: 'FIRE_IGNITE'
  # Som ao receber a recompensa e apagar a última skull
  appear-reward: 'LEVEL_UP'

# Item da roleta
# use apenas blocos
item:
  material: '8534b17d2d3b5a64c57f5f080dd777945761d9f71d82e8f599f242976e4d0c05'
  name: '&eRoleta da Sorte &7(Básica)'
  lore:
    - '&7Nível: &fBásica'
    - '&7* você irá ganhar itens comuns.'
    - ''
    - '&aColoque no chão para ativar'

# Mensagens da roleta
messages:
  # Mensagem ao aparecer as skulls na roleta
  appear:
    title: ''
    actionbar: '&f&l.&c&l.&f&l.'
    chat: ''
  # Mensagem enquanto a roleta estiver rodando
  running:
    title: ''
    actionbar: '&f&lG&c&lI&f&lR&c&lA&f&lN&c&lD&f&lO&c&l.'
    chat: ''
  # Mensagem de sorteando a recompensa
  sorting:
    title: ''
    actionbar: '&f&lS&c&lO&f&lR&c&lT&f&lE&c&lA&f&lN&c&lD&f&lO&c&l.'
    chat: ''

# chance,recompensa-raridade
# a raridade, caso não tenha, deixe: none
rewards:
  - '20.0,reward1-none'
  - '30.0,reward2-none'
  - '50.0,reward3-none'

Opções disponíveis na configuração

display

Nome de exibição da roleta usado em mensagens.

Exemplo:

display: '&eRoleta da Sorte &7(Básica)'

permission

Permissão necessária para poder colocar esta roleta. Deixe vazio ('') para não exigir permissão.

Exemplo:

permission: ''

Ou com permissão:

permission: 'yroleta.roulette.vip'

skulls

Lista de texturas de cabeças ou blocos que irão aparecer na animação da roleta.

Exemplo:

skulls:
  - '8534b17d2d3b5a64c57f5f080dd777945761d9f71d82e8f599f242976e4d0c05'
  - 'c133414759f9e5315156017023a8b1b31cfbf177dcafb0603b8e9d94036a23f1'
  - '300c817432585fadcbd9ca8cfedfeedbce5851b7c07d1b073fb52fa8283e8f23'

Você pode usar texturas de cabeças (apenas o código) ou materiais de blocos. Para obter texturas de cabeças, visite sites como minecraft-heads.com.

hologram

Configurações do holograma que aparece acima da recompensa.

Exemplo:

hologram:
  off-set: 2.2
  lines: [ '&a{reward}', '[item]{reward_preview}' ]

off-set: Altura do holograma acima da recompensa
lines: Linhas do holograma (use [item] seguido de uma placeholder para exibir um item)

Placeholders disponíveis: {reward} - Nome da recompensa, {reward_preview} - Item de preview da recompensa

particles

Sistema de partículas da roleta. Veja a lista completa de partículas.

Exemplo:

particles:
  appear: 'ENCHANT'
  disappear: 'LARGE_SMOKE'
  sorting: 'HAPPY_VILLAGER'
  appear-reward: 'CLOUD'

appear: Partícula ao aparecer as cabeças na roleta
disappear: Partícula ao sumir as cabeças da roleta
sorting: Partícula enquanto sorteia a recompensa
appear-reward: Partícula ao receber a recompensa

sounds

Sistema de sons da roleta.

Exemplo:

sounds:
  appear: 'NOTE_PLING'
  disappear: 'NOTE_BASS'
  running: 'NOTE_STICKS'
  sorting: 'FIRE_IGNITE'
  appear-reward: 'LEVEL_UP'

appear: Som ao aparecer as cabeças na roleta
disappear: Som ao sumir as cabeças da roleta
running: Som enquanto a roleta estiver rodando
sorting: Som ao sortear a recompensa
appear-reward: Som ao receber a recompensa

item

Configurações do item da roleta que o jogador receberá.

Exemplo:

item:
  material: '8534b17d2d3b5a64c57f5f080dd777945761d9f71d82e8f599f242976e4d0c05'
  name: '&eRoleta da Sorte &7(Básica)'
  lore:
    - '&7Nível: &fBásica'
    - '&7* você irá ganhar itens comuns.'
    - ''
    - '&aColoque no chão para ativar'

material: Material do item (use textura de cabeça ou bloco)
name: Nome do item
lore: Descrição do item

Use apenas blocos como material, pois o item precisa ser colocado no chão para ativar a roleta.

messages

Mensagens exibidas durante a animação da roleta.

Exemplo:

messages:
  appear:
    title: ''
    actionbar: '&f&l.&c&l.&f&l.'
    chat: ''
  running:
    title: ''
    actionbar: '&f&lG&c&lI&f&lR&c&lA&f&lN&c&lD&f&lO&c&l.'
    chat: ''
  sorting:
    title: ''
    actionbar: '&f&lS&c&lO&f&lR&c&lT&f&lE&c&lA&f&lN&c&lD&f&lO&c&l.'
    chat: ''

appear: Mensagem ao aparecer as cabeças
running: Mensagem enquanto a roleta estiver rodando
sorting: Mensagem ao sortear a recompensa

Cada seção possui:

title: Título na tela (use <nl> para quebrar linha)
actionbar: Mensagem na actionbar
chat: Mensagem no chat

rewards

Lista de recompensas que podem ser sorteadas nesta roleta.

Exemplo:

rewards:
  - '20.0,reward1-none'
  - '30.0,reward2-none'
  - '50.0,reward3-none'

O formato é: chance,recompensa-raridade

chance: Peso da chance (não precisa somar 100)
recompensa: ID da recompensa configurada em rewards.yml
raridade: Raridade da recompensa (use none se não houver)

O sistema de chances funciona com pesos. Por exemplo, se você tiver três recompensas com chances 20, 30 e 50, a chance real será: 20/(20+30+50) = 20%, 30/(20+30+50) = 30%, 50/(20+30+50) = 50%.

Criando múltiplas roletas

Para criar uma nova roleta, basta criar um novo arquivo na pasta roulettes/:

Crie o arquivo

Crie um novo arquivo .yml na pasta roulettes/ (ex: vip.yml, legendary.yml)

Configure a roleta

Copie a estrutura da configuração e personalize os valores

Vincule as recompensas

Configure a seção rewards com as recompensas desejadas

Reinicie o servidor

Reinicie o servidor para carregar a nova roleta

Exemplo de estrutura:

plugins/
  yRoleta/
    roulettes/
      default.yml
      vip.yml
      legendary.yml

Após alterar a configuração das roletas, é necessário reiniciar o servidor para aplicar as mudanças.

Nesta página