Emmanuel Kasper: Solucionando o inesperado: tela preta em Quake devido a botão do mouse oculto

Emmanuel Kasper: Solucionando o inesperado: tela preta em Quake devido a botão do mouse oculto é um relato técnico e uma solução prática para um problema pouco intuitivo que afeta jogos em desktops Linux. Neste artigo você vai entender por que um botão extra do mouse pode causar tela preta no jogo Quake em um sistema baseado em Raspberry Pi com Debian 13 e Mate Desktop, e como mitigar o problema de forma segura e persistente.

Você aprenderá diagnóstico com ferramentas X11, comandos acionáveis para isolar o dispositivo (por exemplo, para um Logitech M720), opções para automatizar a correção no login e melhores práticas para evitar regressões. Ao final, terá passos claros para aplicar imediatamente no seu sistema – siga com mentalidade de teste e automação.

Benefícios de entender e aplicar essa correção

Conhecer a raiz do problema traz vantagens diretas para usuários de hardware com botões extras e para administradores de sistemas que precisam garantir estabilidade em jogos e aplicações gráficas. Emmanuel Kasper: Solucionando o inesperado: tela preta em Quake devido a botão do mouse oculto demonstra que problemas aparentemente gráficos podem ser originados por eventos de entrada.

- Resiliência do sistema – evitar que janelas percam foco inesperadamente reduz interrupções em aplicações em tela cheia como o Quake.

–

- Solução específica e reversível – usar xinput para desabilitar apenas o dispositivo virtual de teclado associado ao mouse evita bloqueios e mantém funcionalidade de ponteiro.

–

- Automação – criar um script de inicialização ou entrada do MATE evita a recorrência sem intervenção manual.

–

Diagnóstico replicável – técnicas aqui descritas são aplicáveis em outros cenários com mouses avançados, como o Logitech M720.

Como resolver passo a passo – diagnóstico e correção

Este procedimento assume que você está usando X11 (comum em Debian 13 + MATE) e que tem acesso ao terminal no seu Raspberry Pi. Mantenha privilégios de usuário normal; a maior parte dos comandos não requer sudo.

1 – Identificar o comportamento

Use uma ferramenta de eventos para confirmar o que o botão extra envia. Execute xev e pressione o botão de polegar do mouse. Se você observar eventos de KeyPress correspondendo a Control e Alt, isso confirma que o dispositivo está se apresentando como teclado.

2 – Localizar dispositivos com xinput

Liste dispositivos: xinput –list. Você deverá ver duas entradas para o mesmo dispositivo – uma como ponteiro e outra como teclado, por exemplo: “Logitech M720 Triathlon”. Anote o id ou, melhor, o nome exato.

3 – Teste de desabilitação temporária

Desative o dispositivo de teclado que corresponde ao mouse: xinput –disable “Logitech M720 Triathlon” ou usando o id numérico obtido. Teste jogando Quake em sessões de ação intensa para confirmar que a tela preta deixou de ocorrer.

4 – Automatizar no login do MATE

Como os ids do xinput mudam entre sessões, use o nome do dispositivo em um script simples e adicione à inicialização do MATE:

- Crie um script em ~/.local/bin/disable-mouse-keyboard.sh com o conteúdo: #!/bin/sh
  xinput –disable “Logitech M720 Triathlon”

–

- Torne executável: chmod +x ~/.local/bin/disable-mouse-keyboard.sh

–

Adicione um atalho em MATE – Menu Sistema – Preferências – Aplicativos de Sessão – Novo, apontando para o script.

5 – Alternativa: remapear ou ignorar eventos específicos

Se você precisa dos botões extras em outras aplicações, considere usar xbindkeys ou ferramentas de mapeamento específicas para capturar o botão de polegar e remapear para uma ação segura, ou use udev/hwdb para ajustar comportamento – técnica mais avançada que exige cuidado.

Leia também: Hamas entrega o corpo do soldado israelense Hadar Goldin, morto e capturado em 2014.

Melhores práticas

Aplicar a correção corretamente evita regressões e mantém comportamento previsível do sistema.

- Teste antes de automatizar – confirme a eficácia do xinput manualmente antes de inserir scripts de inicialização.

–

- Use nomes de dispositivo estáveis – prefira o nome completo do dispositivo em scripts para evitar variações de id entre boots.

–

- Documente mudanças – registre em README no seu diretório home que você desabilitou o “teclado” do mouse, facilitando manutenção futura.

–

- Considere perfis por conexão – alguns mouses bluetooth podem mudar de identificação se reconectados; adapte scripts para tratar reconexões.

–

Backup de configurações – antes de alterar udev/hwdb ou configurações do Xorg, faça backup dos arquivos de configuração.

Erros comuns a evitar

Ao implementar a solução, atenção aos erros que podem causar perda de funcionalidade ou falhas de inicialização.

- Desabilitar o dispositivo errado – verifique o nome exato; desabilitar o teclado físico por engano pode bloquear entrada.

–

- Usar id numérico em scripts – ids mudam entre sessões; isso fará o script falhar ou desabilitar outro dispositivo.

–

- Modificar arquivos do sistema sem backup – alterar Xorg ou udev sem cópia pode dificultar recuperação.

–

Ignorar logs – verifique /var/log/Xorg.0.log ou journalctl para entender efeitos colaterais.

Exemplos práticos

Exemplo 1 – Diagnóstico rápido:
– Abra terminal, rode xev, pressione o botão suspeito. Se aparecerem eventos KeyPress com keycode correspondendo a Alt_L e Control_L, isso indica que o mouse está atuando como teclado.

Exemplo 2 – Comando de correção temporária:
– xinput –disable “Logitech M720 Triathlon”
Após rodar isso, jogue Quake para verificar se a tela preta foi eliminada.

Exemplo 3 – Script de inicialização no MATE:
– Script: ~/.local/bin/disable-mouse-keyboard.sh
– Conteúdo: #!/bin/sh
sleep 3
xinput –disable “Logitech M720 Triathlon”
– Motivo do sleep – garantir que o servidor X já tenha enumerado dispositivos antes do comando rodar.

Perguntas frequentes

Por que o meu jogo fica com a tela preta quando aperto um botão do mouse?

Normalmente a tela preta indica que a janela perdeu o foco ou o compositor reagiu a um evento inesperado. No caso descrito por Emmanuel Kasper: Solucionando o inesperado: tela preta em Quake devido a botão do mouse oculto, o botão de polegar do Logitech M720 foi identificado como um dispositivo de teclado e disparava combinações de teclas (Control + Alt) que causavam mudança de foco no Mate Desktop, resultando na tela preta no Quake.

Como identificar se meu mouse está se apresentando como teclado?

Use xinput –list para ver múltiplas entradas para o mesmo dispositivo – uma como ponteiro e outra como teclado. Em seguida, use xev ou xinput test para observar eventos gerados pelo botão suspeito.

Desabilitar o dispositivo é seguro? Vou perder funcionalidades do mouse?

Desabilitar apenas a entrada de teclado associada ao mouse normalmente mantém o ponteiro funcional. Teste primeiro com xinput –disable manual antes de qualquer automação. Se você depende de botões extras, considere remapear em vez de desabilitar completamente.

Como faço para automatizar a correção no Raspberry Pi com MATE?

Crie um script que execute xinput –disable “Nome do dispositivo” e adicione-o em Aplicativos de Sessão do MATE ou em ~/.xsessionrc. Use o nome do dispositivo em vez do id para garantir persistência entre boots.

Essa solução funciona em Wayland?

As ferramentas citadas – xinput e xev – são específicas do X11. Em Wayland, o diagnóstico e as correções são diferentes e dependem do compositor. Para Wayland, verifique documentação do compositor (por exemplo, Mutter, Weston) e use ferramentas específicas ou ajuste no gerenciador de janelas.

Conclusão

O caso documentado por Emmanuel Kasper: Solucionando o inesperado: tela preta em Quake devido a botão do mouse oculto evidencia que problemas de exibição nem sempre são gráficos – podem ser causados por eventos de entrada inesperados. Principal takeaway – identifique o dispositivo com xinput, confirme eventos com xev, e desative ou remapeie a entrada de teclado associada ao mouse para eliminar a tela preta no Quake.

Próximo passo: teste os comandos no seu ambiente, crie um script de inicialização conforme descrito e documente a mudança. Se precisar de ajuda personalizada com scripts ou com configuração em Wayland, entre em contato ou deixe suas perguntas – eu posso orientar passo a passo.

Fonte Original

Este artigo foi baseado em informações de: https://00formicapunk00.wordpress.com/2025/11/10/troubleshooting-the-unexpected-black-screen-in-quake-due-to-hidden-mouse-button/