Configuração
Conheça as várias opções de configuração.
O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.
Após alterar a configuração, é necessário reiniciar o servidor.
Estrutura de arquivos
Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.
Configuração do plugin (config.yml)
O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento do lobby. Abaixo estão todas as opções disponíveis com explicações detalhadas.
debug-mode
Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.
# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: falseMantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.
database
Define como e onde os dados do lobby serão armazenados. O plugin suporta três tipos de armazenamento:
- SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
- MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
- MARIADB: Usa MariaDB com otimizações. Recomendado para servidores grandes por melhor performance.
database:
# Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, MARIADB (Recomendado)]
storage-type: SQLITE
# Dados para conexão ao banco de dados MYSQL.
data:
# Endereço de conexão do banco de dados. [EX: 127.0.0.1]
host: localhost
# Porta de conexão do banco de dados. [EX: 3306]
port: 3306
# Nome do banco de dados a ser conectado. [EX: minecraft]
database: ''
# Usuário de conexão. [EX: root]
username: ''
# Senha do usuário de conexão: [EX: 123]
password: ''
# Aqui você poderá configurar algumas coisas do HikariCP.
# Por padrão, já são dadas algumas configurações com base na documentação do hikari:
# https://github.com/brettwooldridge/HikariCP/wiki/MySQL-Configuration
properties:
cachePrepStmts: true
prepStmtCacheSize: 250
prepStmtCacheSqlLimit: 2048
useServerPrepStmts: true
useLocalSessionState: true
rewriteBatchedStatements: true
cacheResultSetMetadata: true
cacheServerConfiguration: true
elideSetAutoCommits: true
maintainTimeStats: trueSe usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yLobby/data.db.
redis
Configurações para conectar a um servidor Redis para cache distribuído.
# Configurações do servidor redis
redis:
# Ativar a conexão com o redis
enabled: false
# Endereço de conexão. [EX: 127.0.0.1]
host: 'localhost'
# Porta de conexão. [EX: 6379]
port: 6379
# Usuário de conexão. [EX: root]
username: ''
# Senha do usuário de conexão: [EX: 123]
password: ''O Redis é opcional e recomendado apenas para servidores em rede BungeeCord/Velocity com múltiplas instâncias do yLobby.
Sistemas principais
Configurações básicas que controlam o comportamento do lobby.
# Mundos onde o yLobby NÃO aplica mecânicas (inventário, dano, jump, scoreboard, etc).
# Útil em servidores multi-mundo / minigames no mesmo server.
# Exemplo: [ 'world_pvp', 'bedwars', 'skywars' ]
blacklist-worlds: []
# Ativar o sistema do NPC ficar olhando para o player
npc-look-close: true
# Desativar o fogo de se espalhar no mapa
block-fire-splash: true
# Desativar as folhas de caírem
block-leaf-decay: true
# Desativar as areias e gravel de caírem
block-sand-fall: true
# Desativar o spawn de items no servidor
block-item-spawn: true
# Desativar a chuva/neve no servidor
block-weather: true
# Ativar o controle de dano do plugin
control-damage: true
# Teleportar ao spawn quando logar
login-spawn: true
# Teleportar ao spawn quando morrer
death-spawn: true
# Ativar sistema de auto-reconnect ao ser kickado de um servidor
auto-reconnect: false
# Kickar o jogador ao reiniciar
kick-on-restart: true
# Modo de jogo padrão
gamemode-default: 'ADVENTURE'
# Mobs que poderão spawnar no lobby
mob-spawning-whitelist: [ 'GIANT', 'ARMOR_STAND' ]
# Vida do jogador ao entrar no lobby
# Cada coração são 2.0 pontos de vida
player-health: 2.0
# Velocidade direta do jogador no lobby, sem usar poções.
# Valores válidos: de -1.0 até 1.0. Padrão do Minecraft: walk 0.2, fly 0.1
walk-speed: 0.2
fly-speed: 0.1
# Sons executados em ações específicas.
# Deixe vazio ou 'none' para desativar. Exemplos: 'LEVEL_UP', 'CLICK', 'ORB_PICKUP', 'UI_BUTTON_CLICK'
sounds:
join: ''
npc-click: ''
menu-open: ''
menu-click: ''
queue-enter: ''
preference-toggle: ''
visibility-toggle: ''
color-select: ''
music-select: ''
music-stop: ''
# Sistema de músicas individuais (discos do Minecraft).
# O som toca apenas para o jogador. Preferência salva no banco.
music:
enabled: true
# Restaurar automaticamente a música salva ao entrar no lobby
auto-play: true
# Configuração da boss-bar.
boss-bar:
# Ativar a boss-bar nos sistemas que suportam esse envio.
enabled: true
# Delay de atualização em segundos, seguindo o padrão do yMinasPackets.
delay: 3
# Tempo em segundos que a boss-bar ficará visível em mensagens/anúncios.
duration: 5
# Porcentagem de preenchimento da barra. Valores de 0.0 até 1.0.
progress: 1.0
# Efeitos aplicados automaticamente ao entrar/retornar ao lobby.
# Formato dos efeitos: 'EFEITO:NIVEL'. Exemplo: 'SPEED:2'
# Caso o jogador tenha mais de uma permissão, será usado o último grupo compatível abaixo.
effects:
member:
permission: 'ylobby.member.effects'
effect-list: []
# Recompensas por kill nas arenas
# kill-reward: [ 'points add {player} 1' ]
kill-reward: []
# Y de detecção do void
# Deixe -64 para a 1.16+
void-detect-y: 0Destaques importantes:
- blacklist-worlds: mundos onde o yLobby não aplica mecânicas (inventário, dano, jump, scoreboard, etc). Útil em multi-mundo/minigames
- npc-look-close: Os NPCs criados com Citizens seguirão o jogador com o olhar
- control-damage: O plugin controla quando o jogador pode receber dano (útil para batalhas)
- kick-on-restart: kicka o jogador ao reiniciar o servidor
- player-health: 2.0 = 1 coração. Defina 20.0 para vida completa
- walk-speed e fly-speed: definem a velocidade direta do jogador sem aplicar poções
- sounds: sons executados em ações do lobby (entrada, menus, preferências, músicas, etc)
- music: sistema de músicas individuais (discos); o som toca só para o jogador e a preferência é salva
- boss-bar: configura envio, duração e progresso da boss-bar usada por anúncios compatíveis
- effects: aplica efeitos por grupo/permissão ao entrar ou retornar ao lobby
- auto-reconnect: Útil em redes BungeeCord/Velocity, mas pode causar loops
music
Sistema de músicas individuais com discos do Minecraft. O som toca apenas para o jogador e a preferência é salva no banco de dados.
# Sistema de músicas individuais (discos do Minecraft).
# O som toca apenas para o jogador. Preferência salva no banco.
music:
enabled: true
# Restaurar automaticamente a música salva ao entrar no lobby
auto-play: true- enabled: ativa ou desativa o sistema de músicas
- auto-play: restaura automaticamente a música salva ao entrar no lobby
O menu de músicas é configurado em menus.yml (seção music), o join-item em items.music no config.yml, e o atalho no menu de preferências via music-slot. Cada faixa exige a permissão ylobby.music.<track> (ex: ylobby.music.cat).
Sons relacionados em sounds:
| Chave | Quando toca |
|---|---|
music-select | Ao selecionar uma música |
music-stop | Ao parar a música |
Mensagens relacionadas: music-play, music-stop, music-disabled
tablist
Sistema de TAB do lobby com suporte a PlaceholderAPI.
tablist:
# Ativar ou desativar o sistema de tablist.
enabled: true
# Delay para atualizar o tablist (em segundos)
delay: 3
header: |
&r
&b&lyStorePlugins
&r
&fA melhor loja de plugins.
footer: |
&r
&a❤ &fReceba atualizações e novidades exclusivas
&fdo nosso servidor através do nosso discord:
&9discord.ystoreplugins.com.br
&r
&r&fAdquira &b&lVIP &facessando: &6ystoreplugins.com.br
&r
&7ystoreplugins.com.br
tags:
member:
priority: 1 # decrescente (membros com prioridade maior que dono e admin)
permission: 'ylobby.tags.member'
prefix: '&7[Membro] &7'
suffix: ''
order: 'a' # ordem das tags no tab, sendo o "A" o primeiro e o "Z" o últimoSistema de tags:
- priority: Ordem decrescente (1 = maior prioridade)
- order: Ordem alfabética no TAB (a-z)
- Suporta todos os placeholders do PlaceholderAPI
Exemplo com múltiplas tags:
tags:
dono:
priority: 100
permission: 'ylobby.tags.dono'
prefix: '&4[Dono] &4'
suffix: ''
order: 'a'
admin:
priority: 90
permission: 'ylobby.tags.admin'
prefix: '&c[Admin] &c'
suffix: ''
order: 'b'
vip:
priority: 50
permission: 'ylobby.tags.vip'
prefix: '&6[VIP] &6'
suffix: ''
order: 'c'
member:
priority: 1
permission: 'ylobby.tags.member'
prefix: '&7[Membro] &7'
suffix: ''
order: 'd'Use delay: 1 para atualização mais rápida, mas pode aumentar o uso de CPU em servidores grandes.
scoreboard
Sistema de scoreboard do lobby com atualização automática.
scoreboard:
# Ativar ou desativar o sistema de scoreboard.
enabled: true
# Delay para atualizar a scoreboard (em segundos)
delay: 3
title: '&b&lyStore'
lines:
- ''
- '&a⋄ &fCargo: %vault_prefix%'
- ''
- '&a⋄ &fF. Safira: {factions}'
- '&a⋄ &fR. Mobs: {rankup}'
- ''
- '&a⋄ &fLobby #1: &a{lobby}'
- ''
- '&a⋄ &fCash: &6%playerpoints_points%'
- '&a⋄ &fOnline: &a{rede}'
- ''
- '&eystoreplugins.com.br'Suporta placeholders internos do yLobby e do PlaceholderAPI. Use /sb toggle para ativar/desativar individualmente.
jump-pad
Sistema de jump pads quando o jogador pisa em um bloco específico.
jump-pad:
enabled: true
# Bloco que será a jump pad
block: 'SLIME_BLOCK'
# Multiplicador de velocidade
multiply: 1.5
# Altura que será jogado para cima
offset: 2.0
# Som que será executado
sound: 'FIREWORK_LAUNCH'Exemplo de valores:
# Jump baixo
multiply: 1.0
offset: 1.5
# Jump médio (padrão)
multiply: 1.5
offset: 2.0
# Jump alto
multiply: 2.0
offset: 3.0double-jump
Sistema de double jump (pular duas vezes no ar).
double-jump:
enabled: true
# Multiplicador de velocidade
multiply: 1.5
# Altura que será jogado para cima
offset: 2.0
# Som que será executado
sound: 'FIREWORK_LAUNCH'Os jogadores podem usar o double jump pressionando espaço duas vezes rapidamente.
status
Formatação dos status dos servidores exibidos nos menus e hologramas.
status:
offline: '&cOffline'
maintenance: '&cManutenção'
deployment: '&7Desenvolvimento'
beta-vip: '&eBeta-VIP'
online: '&aOnline'command-manager
Sistema de gerenciamento de comandos bloqueados e AntiTab.
command-manager:
# Comandos bloqueados
# coloque em minúsculo e com /
# permissão de bypass: ylobby.comando.bypass
blocked-commands:
- '/plugin'
# Comandos permitidos no AntiTab
# Permissão de bypass do AntiTab: ylobby.antitab.bypass
anti-tab-whitelist:
- '/points'Exemplo completo:
command-manager:
blocked-commands:
- '/plugin'
- '/plugins'
- '/pl'
- '/ver'
- '/version'
- '/about'
- '/?'
anti-tab-whitelist:
- '/points'
- '/tell'
- '/msg'
- '/reply'O AntiTab bloqueia o autocomplete de comandos com TAB. Use a whitelist para permitir comandos específicos.
queue
Sistema de fila para se conectar a servidores cheios.
queue:
# Ativar ou desativar o sistema de fila.
enabled: true
# Tempo em segundos para que a fila ande.
delay: 3
# Sempre mostrar a posição na fila na actionbar
always-show: trueComo funciona:
- Jogador tenta entrar em servidor cheio
- É colocado automaticamente na fila
- A cada
delaysegundos, um jogador da fila entra - Jogadores VIP (
ylobby.queue.vip) têm prioridade
join
Sistema de entrada no lobby.
join:
# Limpar o chat ao entrar no lobby
clear-chat: true
# Enviar anúncio que o player entrou (deixe vazio para não usar)
announce: '&a+ %vault_prefix% &f{player}&a entrou.'
# Enviar anúncio de entrada em boss-bar (deixe vazio para não usar)
announce-bossbar: ''
# Mundos que não irá receber os Join-Items
join-item-world-blacklist: []Exemplo sem anúncio:
join:
clear-chat: true
announce: ''
announce-bossbar: ''
join-item-world-blacklist: []day-cycle
Sistema de bloqueio de horário.
day-cycle:
# Ativar o bloqueador
enabled: true
# Tempo que permanecerá
time: 6000Horários do Minecraft:
- 0 = Amanhecer
- 6000 = Meio-dia
- 12000 = Anoitecer
- 18000 = Meia-noite
top
Sistema de atualização do ranking de batalhas.
top:
# Ativar o updater do top
enabled: true
# Tempo que irá atualizar o top ( em ticks; 20 ticks = 1s )
time: 1200012000 ticks = 600 segundos = 10 minutos
items
Itens padrões definidos para o jogador na hotbar.
items:
# Item utilizado para selecionar qual servidor o jogador deseja ir.
game-selector:
material: COMPASS:0
slot: 1
name: '&aServidores'
lore:
- '&7Selecione um servidor para jogar.'
# Item utilizado para selecionar qual lobby o jogador deseja ir.
lobby-selector:
material: NETHER_STAR:0
slot: 3
name: '&aLobbies'
lore:
- '&7Selecione um lobby mais vazio.'
# Item utilizado para que o jogador altere suas preferências.
preferences:
material: 'REDSTONE_COMPARATOR:0'
slot: 5
name: '&aPreferências'
lore:
- '&7Altere suas prefêrencias para ter'
- '&7a melhor experiência em nosso servidor.'
# Item utilizado para entrar no modo combate.
combat:
material: DIAMOND_SWORD:0
slot: 7
name: '&cCombate'
lore:
- '&7Se divirta em um belo PvP.'
# Item utilizado para abrir o menu de músicas
music:
material: 'MUSIC_DISC_CAT'
slot: 6
name: '&aMúsicas'
lore:
- '&7Escolha uma música para tocar'
- '&7apenas para você no lobby.'
# Item utilizado para ativar a visibilidade
visibility-off:
material: INK_SACK:8
slot: 8
name: '&eVisibilidade'
lore:
- '&7Atualmente a visibilidade dos'
- '&7jogadores está desabilitada.'
- ''
- '&aClique para habilitar.'
# Item utilizado para desativar a visibilidade
visibility-on:
material: INK_SACK:10
slot: 8
name: '&eVisibilidade'
lore:
- '&7Atualmente a visibilidade dos'
- '&7jogadores está habilitada.'
- ''
- '&aClique para desabilitar.'Criando itens customizados:
items:
# ... itens padrão ...
custom:
material: DIAMOND_SWORD:0
slot: 0
name: '&cMeu Item Custom'
lore:
- '&7Clique para executar comando'
left-command: 'say Clique esquerdo!'
right-command: 'say Clique direito!'
left-perm: 'ylobby.left-perm.custom'
right-perm: 'ylobby.right-perm.custom'Use itens customizados para criar atalhos para comandos importantes do seu servidor!
combat
Sistema de combate nas arenas com itens e armaduras pré-definidos.
combat:
# Slot padrão que ficará a mão do player
held-slot: 0
# Resetar os itens ao matar um jogador (Arena FFA)
reset: true
# Ocultar jogadores do lobby ao entrar na arena FFA
hide-players: true
# Comandos permitidos na arena
allowed-commands: [ '/battle', '/batalhar' ]
# Armadura pré-definida.
armor:
helmet:
material: DIAMOND_HELMET:0
enchants:
- DURABILITY:2
chestplate:
material: DIAMOND_CHESTPLATE:0
enchants:
- DURABILITY:2
leggings:
material: DIAMOND_LEGGINGS:0
enchants:
- DURABILITY:2
boots:
material: DIAMOND_BOOTS:0
enchants:
- DURABILITY:2
# Itens pré-definidos.
items:
espada:
material: DIAMOND_SWORD:0
amount: 1
slot: 0
enchants:
- DAMAGE_ALL:1
- DURABILITY:2
maca:
material: GOLDEN_APPLE:0
amount: 16
slot: 1
enchants: []
exit:
material: BARRIER
amount: 1
slot: 8
nbt-tag: [ 'yLobby-ArenaExit=>sim' ]Configuração para PvP balanceado:
combat:
held-slot: 0
reset: true
allowed-commands: [ '/battle' ]
armor:
helmet:
material: DIAMOND_HELMET:0
enchants:
- PROTECTION_ENVIRONMENTAL:2
- DURABILITY:3
chestplate:
material: DIAMOND_CHESTPLATE:0
enchants:
- PROTECTION_ENVIRONMENTAL:2
- DURABILITY:3
leggings:
material: DIAMOND_LEGGINGS:0
enchants:
- PROTECTION_ENVIRONMENTAL:2
- DURABILITY:3
boots:
material: DIAMOND_BOOTS:0
enchants:
- PROTECTION_ENVIRONMENTAL:2
- DURABILITY:3
items:
espada:
material: DIAMOND_SWORD:0
amount: 1
slot: 0
enchants:
- DAMAGE_ALL:2
- FIRE_ASPECT:1
- DURABILITY:3
maca:
material: GOLDEN_APPLE:0
amount: 32
slot: 1
enchants: []
sopa:
material: MUSHROOM_SOUP:0
amount: 64
slot: 2
enchants: []chat
Sistema de chat integrado com delay anti-spam.
chat:
# Ativar ou desativar o sistema de chat.
enabled: true
# Desativar ou ativar chat do Vanilla, caso não utilize o do plugin.
vanilla-chat: false
# Destacar a mensagem para quem tiver a permissão
highlight: true
# Formato do chat a ser exibido.
format: '&7[Chat] &f%vault_prefix% {player}&7: {msg}'
# Formato do hover a ser exibido
hover: '&eClique aqui para enviar uma mensagem para {player}'
# Comando a ser sugerido ao clicar
suggest: '/tell {player} '
# Delay para falar no chat.
delay: 1- highlight: Jogadores com
ylobby.chat.highlightterão mensagens destacadas - hover: Texto ao passar o mouse sobre o nome
- suggest: Comando sugerido ao clicar no nome
tell
Sistema de mensagens privadas.
tell:
# Formato do tell a ser exibido.
format-send: '&eMensagem para &f{player}&e: &7{msg}'
format-receive: '&eMensagem de &f{player}&e: &7{msg}'
# Formato do tell a ser exibido
hover: '&eClique aqui para responder o(a) {player}'
# Comando a ser sugerido ao clicar
suggest: '/reply 'Jogadores podem desativar tells individualmenten em /preferences.
auto-message
Sistema de mensagens automáticas com suporte a actionbar, título, bossbar e sons.
auto-message:
# Ativar ou desativar o sistema de mensagens automáticas.
enabled: true
# Delay em segundos entre cada mensagem
delay: 15
# mensagens
messages:
msg1:
priority: 1
chat: |
<nl>
&a&l* &fyStorePlugins, a melhor para os melhores.
<nl>
actionbar: '&aAcesse nosso site: &fwww.ystoreplugins.com.br&a.'
title: '' # HEADER<nl>FOOTER
bossbar: '&aAcesse nosso site: &fwww.ystoreplugins.com.br&a.'
sound: 'LEVEL_UP'
msg2:
priority: 2
chat: |
<nl>
&a&l* &fAdquira VIP em nosso servidor!
<nl>
actionbar: '&aAcesse nosso site: &fystoreplugins.com.br&a.'
title: '' # HEADER<nl>FOOTER
bossbar: '&aAdquira VIP em nosso servidor!'
sound: 'LEVEL_UP'Exemplo com título:
messages:
msg1:
priority: 1
chat: ''
actionbar: ''
title: '&b&lYSTORE<nl>&fCompre plugins de qualidade'
bossbar: ''
sound: 'NOTE_PLING'As mensagens são enviadas em ordem de prioridade. Use <nl> para criar novas linhas.
portal
Sistema de portais configuráveis no lobby. Os portais são criados via interface no jogo e salvos automaticamente no data.yml.
portal:
# Tamanho mínimo da moldura do portal (em blocos)
min-size: 4
# Tamanho máximo da moldura do portal (em blocos)
max-size: 25Como funciona:
Os portais são estruturas de blocos (semelhante ao portal do Nether) que teletransportam jogadores ao atravessá-los. Cada portal tem uma moldura que deve estar dentro do intervalo definido por min-size e max-size.
Parâmetros:
- min-size — Número mínimo de blocos que a moldura do portal deve ter para ser válida
- max-size — Número máximo de blocos permitidos na moldura do portal
Mensagens relacionadas:
| Chave | Descrição |
|---|---|
portal-set | Mensagem ao criar um portal com sucesso |
portal-del | Mensagem ao deletar um portal |
portal-no-frame | Mensagem quando não há moldura detectada |
portal-too-small | Mensagem quando a moldura está abaixo do min-size |
portal-too-large | Mensagem quando a moldura excede o max-size |
Os portais criados são salvos em data.yml na chave portals. Para remover um portal, use o comando de administração do plugin ou edite o arquivo manualmente.