BungeeCord

Exemplo completo de configuração

Esta configuração permite que você tenha o sistema de minas em um servidor separado, conectado via BungeeCord ou Velocity:

# Ativar o sistema de bungeecord
enabled: false

# Modo deste servidor
# LOBBY (ex: servidor de RankUP)
# SERVER (ex: servidor que contém a mina)
mode: 'LOBBY'

# Nome do servidor na config do BungeeCord em que o jogador vai ao sair da mina
exit: 'rankup'

# Delay para enviar a picareta ao trocar para o servidor da mina
# em ticks
delay: 3

# Bloquear ações neste servidor caso esteja fora da mina
# Somente caso o "Modo" for "SERVER"
# permissão de bypass: yminaspackets.blocked.bypass
block-actions: true

Opções de configuração

enabled

Ativa ou desativa o sistema de integração com BungeeCord/Velocity.

enabled: false  # Desativado (servidor único)
enabled: true   # Ativado (rede BungeeCord/Velocity)

mode

Define o modo de operação deste servidor na rede.

mode: 'LOBBY'   # Servidor principal (RankUP, Survival, etc.)
mode: 'SERVER'  # Servidor dedicado da mina

Modos disponíveis:

• LOBBY - Servidor principal onde os jogadores ficam (ex: RankUP, Factions, Survival)
• SERVER - Servidor dedicado exclusivamente para a mina

exit

Nome do servidor (configurado no BungeeCord/Velocity) para onde o jogador será enviado ao sair da mina.

exit: 'rankup'     # Envia para o servidor chamado "rankup"
exit: 'lobby'      # Envia para o servidor chamado "lobby"
exit: 'survival'   # Envia para o servidor chamado "survival"

delay

Tempo de espera em ticks antes de enviar a picareta ao jogador quando ele entra no servidor da mina.

delay: 3   # 3 ticks (~0.15 segundos)
delay: 20  # 20 ticks (1 segundo)

Conversão:

• 1 segundo = 20 ticks
• 3 ticks = ~0.15 segundos (padrão)

block-actions

Bloqueia ações da picareta quando o jogador está fora da área da mina (apenas para modo SERVER).

block-actions: true   # Bloqueia ações fora da mina
block-actions: false  # Permite ações em qualquer lugar

Permissão de bypass:

yminaspackets.blocked.bypass

Jogadores com esta permissão podem usar a picareta em qualquer lugar, mesmo com block-actions: true.

Configurando uma rede BungeeCord/Velocity

Cenário 1: Servidor de RankUP com mina dedicada

Servidor RankUP (LOBBY):

enabled: true
mode: 'LOBBY'
exit: 'rankup'
delay: 3
block-actions: false

Servidor Mina (SERVER):

enabled: true
mode: 'SERVER'
exit: 'rankup'
delay: 3
block-actions: true

Cenário 2: Múltiplos servidores LOBBY

Servidor RankUP:

enabled: true
mode: 'LOBBY'
exit: 'rankup'
delay: 3
block-actions: false

Servidor Factions:

enabled: true
mode: 'LOBBY'
exit: 'factions'
delay: 3
block-actions: false

Servidor Mina (compartilhado):

enabled: true
mode: 'SERVER'
exit: 'rankup'  # Servidor padrão de retorno
delay: 3
block-actions: true

Cenário 3: Servidor único (sem BungeeCord)

Configuração:

enabled: false
mode: 'LOBBY'
exit: 'lobby'
delay: 3
block-actions: false

Como funciona

Fluxo de entrada na mina

1. Jogador usa comando /mina entrar no servidor LOBBY
2. Plugin envia dados da picareta via Redis/MySQL para sincronização
3. Jogador é teleportado para o servidor SERVER (mina)
4. Após o delay configurado, jogador recebe a picareta
5. Jogador pode minerar normalmente

Fluxo de saída da mina

1. Jogador usa comando /mina sair no servidor SERVER
2. Plugin salva dados da picareta
3. Jogador é enviado de volta para o servidor configurado em exit
4. Dados são sincronizados automaticamente

Requisitos

Configuração necessária em config.yml:

# Redis (recomendado para redes)
redis:
  enabled: true
  host: 'localhost'
  port: 6379
  password: ''

# OU MySQL
database:
  type: 'MYSQL'
  host: 'localhost'
  port: 3306
  database: 'yminaspackets'
  user: 'root'
  password: ''

Comandos relacionados

Para entrar na mina (servidor LOBBY):

/mina entrar

Para sair da mina (servidor SERVER):

/mina sair

Configuração do BungeeCord/Velocity

BungeeCord (config.yml)

servers:
  rankup:
    motd: 'Servidor RankUP'
    address: localhost:25566
    restricted: false
  mina:
    motd: 'Servidor Mina'
    address: localhost:25567
    restricted: false

Velocity (velocity.toml)

[servers]
rankup = "localhost:25566"
mina = "localhost:25567"

[forced-hosts]
"play.seuservidor.com" = [
    "rankup"
]

Permissões

Para usar o sistema de minas:

yminaspackets.use

Para ignorar bloqueio de ações fora da mina:

yminaspackets.blocked.bypass

Troubleshooting

Problema: Picareta não aparece ao entrar na mina

Solução:

1. Verifique se Redis/MySQL está configurado corretamente
2. Aumente o valor de delay para 10 ou 20 ticks
3. Verifique os logs de ambos os servidores

Problema: Jogador não é enviado de volta ao servidor correto

Solução:

1. Verifique se o nome em exit está correto
2. Confirme que o servidor está registrado no BungeeCord/Velocity
3. Teste conexão manual: /server rankup (ou nome do seu servidor)

Problema: Dados não sincronizam entre servidores

Solução:

1. Certifique-se que Redis está rodando: redis-cli ping (deve retornar "PONG")
2. Verifique credenciais de MySQL se estiver usando banco de dados
3. Confirme que enabled: true em todos os servidores
4. Verifique se o Redis/MySQL está acessível de todos os servidores

Problema: "Você já está na mina" ao tentar entrar

Solução:

1. Execute /minaadm reload em todos os servidores
2. Limpe o cache do Redis se necessário
3. Reinicie os servidores se o problema persistir

Dicas de performance

Vantagens do Redis:

• ✅ Muito mais rápido que MySQL
• ✅ Menor latência de sincronização
• ✅ Ideal para dados temporários e cache
• ✅ Suporta pub/sub para comunicação em tempo real

Instalação do Redis:

# Ubuntu/Debian
sudo apt install redis-server
sudo systemctl start redis
sudo systemctl enable redis

# CentOS/RHEL
sudo yum install redis
sudo systemctl start redis
sudo systemctl enable redis