HumanitZ Server Manager (HSM) v1.1

Descrição de Elite

Aplicativo e API para instalar, iniciar, monitorar e automatizar servidores HumanitZ. O HSM v1.1 evoluiu de um simples gerenciador de processos para um ecossistema completo de economia, bilinguismo e integração Discord.

📸 Demonstração Visual (Screenshots)

Novidades da Versão 1.1 (Infraestrutura & UX)

• Economia de Z-Coins: Sistema de ganhos por hora (earn_rate) integrado ao chat do jogo e logs do Discord.
• Sistema VIP Resiliente: Autorização de kits VIP com sincronização de cargos no Discord via Role ID, garantindo que renomeações no servidor não quebrem o acesso.
• Logs Militares Segregados: Logs rotativos (hsm_main.log) e específicos por servidor, garantindo performance e rastreabilidade total.
• Registro Inteligente: Fluxo de vinculação Discord (!reg) otimizado com detecção via Regex.
• Autoatendimento (Self-Service): Teleporte de resgate (Unstuck) via Discord com detecção automática de NetID e controle de cooldown.
• Resiliência Anti-Crash: Lógica aprimorada para diferenciar reinícios programados de quedas reais, evitando alertas falsos durante manutenções.
• Auto-Healing (RCON Sync): Sistema de auto-correção que restaura o status RUNNING caso o servidor responda via RCON, mesmo que a detecção de processo falhe no Windows.
• Loja Virtual v1.2 (Visual & Sync):
  • Gestão de Imagens: Upload direto de miniaturas para itens da loja com armazenamento local em shop_assets.
  • Sincronização em Lote: Interface baseada em pipe (|) para importação e atualização massiva de itens do items_master.db.
  • UX Premium: Interface de shop otimizada com tooltips de NetID e controle de pacotes (bundle amount).

Estrutura

• src/controller.py: Lógica de SteamCMD, monitoramento contínuo e detecção de crashes.
• src/api_routes/economy.py: Motor de economia, gestão de saldo e autorização VIP.
• src/webhooks.py: Sincronização em tempo real com o Discord e logs de chat in-game.
• frontend/: Interface moderna em React, Vite e Tailwind com micro-animações táteis.

Instalação e Execução (Modo Híbrido)

O HSM v1.1 utiliza o modo combined para simplificar o firewall:

cd "C:\Users\paulo\Desktop\Cursor Ai\HSM"
.\dev.bat  # Inicia API (3000) e Frontend (5173) sincronizados

Como funciona o Bilinguismo de Elite

• Interface: Troca de idioma dinâmica (PT-BR/EN) no painel administrativo.
• Discord: Logs e mensagens de feedback respeitam o idioma configurado para o servidor/jogador.

Roadmap v1.2 (Próximos Passos)

• Manutenção Automática: Loop de expiração VIP com revogação de cargos Discord.
• Auditoria de Chat: Painel para busca e exportação de logs de chat históricos.
• Z-Coins Shop: Interface para os jogadores trocarem saldo por itens via RCON.