LogoyStore

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.

parkour.yml
H2.sql
MARIADB.sql
MYSQL.sql
SQLITE.sql
colors.yml
commands.yml
config.yml
custom-commands.yml
data.yml
json-messages.json
menus.yml
messages.yml
servers.yml

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: false

Mantenha 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: true

Se 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: 0

Destaques 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:

ChaveQuando toca
music-selectAo selecionar uma música
music-stopAo 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 último

Sistema 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.0

double-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: true

Como funciona:

  1. Jogador tenta entrar em servidor cheio
  2. É colocado automaticamente na fila
  3. A cada delay segundos, um jogador da fila entra
  4. 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: 6000

Horá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: 12000

12000 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.highlight terã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: 25

Como 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:

ChaveDescrição
portal-setMensagem ao criar um portal com sucesso
portal-delMensagem ao deletar um portal
portal-no-frameMensagem quando não há moldura detectada
portal-too-smallMensagem quando a moldura está abaixo do min-size
portal-too-largeMensagem 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.

Nesta página