Módulo Segurança¶
O módulo Segurança fornece autenticação BCrypt, proteção anti-bot com CAPTCHA, gerenciamento de sessões, anti-duplicação e ferramentas anti-lag — projetado para servidores offline/cracked.
Sub-sistemas¶
| Sub-sistema | Descrição |
|---|---|
| Auth | Registro/login com senhas BCrypt, sessões persistentes |
| Anti-Bot | Limitação de taxa por IP, CAPTCHA em mapa, blacklist de nomes, detecção de VPN |
| Anti-Dupe | Detecta e previne exploits comuns de duplicação de itens |
| Anti-Lag | Limpador de mundo agendado, empilhador de entidades |
Autenticação¶
Jogadores em servidores cracked devem /register no primeiro acesso e /login nos acessos seguintes. Contas premium ignoram a autenticação somente depois que o handshake de sessão da Mojang prova que são donas do nome (veja Verificação Premium).
Comandos¶
| Comando | Uso | Permissão |
|---|---|---|
/register <senha> <confirmar> |
Registrar uma conta | (todos) |
/login <senha> |
Entrar na conta | (todos) |
/changepassword <antiga> <nova> |
Alterar senha | (autenticado) |
/auth premiumclaim <nome> |
Torna um nome somente-premium (todo login precisa passar pelo handshake) | OP |
/auth premiumunclaim <nome> |
Remove um claim (dono perdeu a conta, ou nome reivindicado por engano) | OP |
Configuração Auth (security/auth.yml)¶
storage: sqlite # sqlite | postgres
session-timeout-minutes: 30 # Re-login após 30min inativo
persistent-session-hours: 2 # Auto-login em 2h após última sessão
max-failed-attempts: 5 # Bloqueio após 5 senhas erradas
lockout-minutes: 10
login-spawn:
enabled: false # Teleportar para lobby enquanto não autenticado
Verificação Premium¶
Um nome que existe na Mojang não prova nada: qualquer um pode digitá-lo. A única prova de que o jogador é dono da conta é o handshake de sessão da Mojang, feito pelo módulo FastLogin (exige ProtocolLib 5.4.0+): o cliente entra com a conta na Mojang e o servidor confirma por sessionserver.mojang.com/session/minecraft/hasJoined. O resultado vale para um único login e fica preso ao nome exato e ao UUID real (versão 4) da Mojang.
Um cliente cracked não consegue responder ao handshake, então ele só é exigido de nomes que o dono reivindicou (claim):
- Um cliente cracked entra com um nome que parece premium (ainda sem claim): não é logado. Recebe o prompt SIM/NÃO e o fluxo normal de
/registere/login. - O dono verdadeiro clica SIM. O nome é reivindicado e o jogador é expulso para reconectar pelo launcher oficial. Um clique nunca loga ninguém. Um nome que já tem conta com senha no servidor não pode ser reivindicado por clique; o admin usa
/auth premiumclaim. - Dali em diante todo login desse nome precisa passar pelo handshake. Passando, pula o CAPTCHA e o
/logine joga com o UUID real. Quem falha (cliente cracked, Mojang fora do ar, tempo esgotado) é desconectado e nunca cai no/login. Sem o FastLogin carregado, nomes reivindicados são recusados.
premium-uuid-required: false (premium só pelo nome) foi removido; a chave é ignorada e o log de inicialização avisa. Nomes Bedrock (começam com .) não podem ser reivindicados.
Chaves opcionais no config.yml principal: fastlogin.handshake-timeout-seconds (20), fastlogin.mojang-timeout-ms (5000), fastlogin.max-handshakes-per-minute-per-ip (10), fastlogin.messages.failed|busy|unavailable.
Cache e Resiliência¶
| Camada | Detalhe |
|---|---|
| Cache em memória | TTL de 24 horas; limpo ao reiniciar |
| Cache persistente SQLite | Sobrevive a reinicializações — arquivo: security/premium-cache.db |
| Limitador de taxa | Máx. 50 chamadas à API da Mojang por janela de 10 minutos |
| Backoff exponencial | Recua até 60 s em caso de falhas repetidas na API |
| Fallback | Usa o último resultado em cache quando a API estiver inacessível |
O cache só diz se o nome existe
O cache e a API acima respondem apenas se existe uma conta Mojang com aquele nome. Isso nunca dispensa o /login: quem dispensa é o handshake.
Anti-Bot¶
Configuração (security/antibot.yml)¶
rate-limit:
window-seconds: 10
max-joins: 3 # Máximo de entradas por IP na janela
name-blacklist-patterns:
- "[A-Za-z]{1,3}[0-9]{5,}"
- "bot[0-9]+"
captcha:
enabled: true
timeout-seconds: 60
session-hours: 24 # Pular CAPTCHA por 24h após aprovação
premium-check:
enabled: true # Contas premium ignoram o CAPTCHA
alt-detection:
max-accounts-per-ip: 3 # Alertar admins se um IP tiver 3+ contas
Anti-Lag¶
Comandos¶
| Comando | Uso | Permissão |
|---|---|---|
/cleanworld |
Executar limpeza manual do mundo | nexusprism.security.cleanworld |
Configuração (security/antilag.yml)¶
cleaner:
interval-seconds: 300 # Limpeza automática a cada 5 minutos
warn-seconds: 5 # Aviso antes da limpeza
item-age-ticks: 6000 # Remover itens com mais de 5 minutos
worlds:
- world
- world_nether
- world_the_end
stacker:
radius: 5.0 # Fundir mobs em raio de 5 blocos
max-stack: 50 # Máximo de 50 mobs por pilha
Comandos de Staff¶
| Comando | Uso | Permissão |
|---|---|---|
/vanish |
Alternar invisibilidade (OP) | nexusprism.staff.vanish |
/invsee <jogador> |
Inspecionar inventário (OP) | nexusprism.staff.invsee |
/spy |
Alternar espionagem de chat (OP) | nexusprism.staff.spy |
Permissões¶
| Permissão | Descrição | Padrão |
|---|---|---|
nexusprism.security.cleanworld |
Limpeza manual do mundo | OP |
nexusprism.staff.vanish |
Ficar invisível | OP |
nexusprism.staff.invsee |
Inspecionar inventários | OP |
nexusprism.staff.spy |
Modo spy de chat | OP |
Mobs com Nível¶
Todo mob hostil que aparece no mundo recebe automaticamente um nível que escala de acordo com o perigo do ambiente. Mobs de nível mais alto causam mais dano, têm mais vida e concedem mais XP.
Tabela de Rolagem de Nível¶
Os níveis são rolados no spawn com base na altura Y, dimensão e bioma. Os bônus se acumulam.
| Condição | Faixa / Bônus |
|---|---|
| Y > 64 (superfície) | Nv. 1–4 |
| Y ≤ 64 | Nv. 3–6 |
| Y ≤ 30 | Nv. 5–8 |
| Y ≤ 0 (subterrâneo profundo) | Nv. 8–12 |
| Dimensão Nether | +3 ao resultado |
| The End | +4 ao resultado |
| Bioma Deep Dark | +5 ao resultado |
| Lua de Sangue ativa | +2 a todos os resultados |
Todos os resultados são limitados ao intervalo [1, max-level] da configuração.
Formato do Nome¶
| Situação | Nome exibido |
|---|---|
| Empilhado + com nível | 3x [Nv.5] Zumbi |
| Único + com nível | [Nv.5] Zumbi |
| Nível 1 (qualquer pilha) | 3x Zumbi (sem tag de nível) |
Fórmulas de Atributo¶
| Atributo | Fórmula |
|---|---|
| Dano | danoBase × (1 + (nível-1) × multiplicadorDanoPorNível) × contadorPilha |
| XP | xpBase × contadorPilha × (1 + (nível-1) × multiplicadorXPPorNível) |
| Vida | Escalada por multiplicadorVidaPorNível por nível acima de 1 |
Configuração (security/antilag.yml)¶
leveled-mobs:
enabled: true
max-level: 20
xp-multiplier-per-level: 0.20 # +20% XP por nível acima de 1
damage-multiplier-per-level: 0.15 # +15% dano por nível acima de 1
health-multiplier-per-level: 0.10 # +10% vida por nível acima de 1
Integração com Lua de Sangue
Quando a Lua de Sangue está ativa (veja o módulo Events), todas as rolagens de nível recebem um bônus de +2, tornando os mobs de superfície significativamente mais perigosos à noite.
PlaceholderAPI¶
| Placeholder | Descrição |
|---|---|
%nexusprism_authenticated% |
true se o jogador está autenticado |
%nexusprism_auth_status% |
Status de auth legível (Autenticado, Pendente) |