Repolode
Enviar
yasirkula

yasirkula/UnityIngameDebugConsole

Um console in-game baseado em uGUI para Unity que exibe logs em tempo de execução e permite executar comandos de debug registrados em builds.

Ver no GitHub
Estrelas
2,746
Forks
267
Issues abertas
9
Último commit
mês passado

O que é?

Este asset para Unity exibe mensagens de debug, como logs, avisos, erros e exceções, em tempo de execução em um build, além de mostrar assertions no editor. Ele inclui um console de comandos em que você digita funções registradas e seus parâmetros para executá-las durante o jogo, o que ajuda nos testes e na depuração sem precisar gerar um novo build. No Android, também pode encaminhar mensagens do logcat para o console.

A interface é feita com uGUI e usa uma lista reciclada que chama Instantiate com pouca frequência. Durante o jogo, a janela pode ser redimensionada ou ocultada, e um pequeno popup arrastável mostra quantos logs novos chegaram enquanto ela estava fechada. No editor do Unity, clicar com o botão direito em uma entrada de log abre a linha correspondente do script.

Os comandos podem ser registrados com o atributo ConsoleMethod, chamadas AddCommand com tipagem forte ou registro de métodos estáticos e de instância com tipagem fraca. É possível adicionar tipos de parâmetro personalizados com uma função parser, permitindo que o console aceite objetos específicos do projeto.

Recursos principais

  • 01Exibe logs, avisos, erros e exceções em tempo de execução nos builds.
  • 02Executa funções registradas a partir de um campo de entrada de comandos in-game.
  • 03Encaminha mensagens do logcat do Android para o console.
  • 04Feito com uGUI e uma lista reciclada para renderização eficiente.
  • 05Aceita tipos de parâmetro personalizados para comandos por meio de funções parser.

Casos de uso

  • Depurar problemas de gameplay em dispositivos de teste sem conectar ao editor.
  • Acionar funções do jogo, como gerar objetos, durante sessões de QA.
  • Consultar a saída do logcat do Android junto com os logs do jogo.

Início rápido

  1. 1

    Baixe o unitypackage na página de releases

  2. 2

    Ou adicione o pacote pelo Package Manager usando a URL do git

    https://github.com/yasirkula/UnityIngameDebugConsole.git
  3. 3

    Ou instale pelo OpenUPM CLI

    openupm add com.yasirkula.ingamedebugconsole
  4. 4

    Coloque o prefab do IngameDebugConsole na cena

Antes de usar

  • Versões mais antigas do Unity exigem configurações adicionais, como definir símbolos manualmente ou remover a referência de assembly do New Input System.
  • Pode ser necessário ajustar o Gradle ou o Proguard para que as compilações para Android funcionem corretamente.

Tópicos

#unity#csharp#debugging#game-development#logging#developer-console#ugui

Perguntas frequentes

O que é UnityIngameDebugConsole?
Um console in-game baseado em uGUI para Unity que exibe logs em tempo de execução e permite executar comandos de debug registrados em builds. Este asset para Unity exibe mensagens de debug, como logs, avisos, erros e exceções, em tempo de execução em um build, além de mostrar assertions no editor. Ele inclui um console de comandos em que você digita funções registradas e seus parâmetros para executá-las durante o jogo, o que ajuda nos testes e na depuração sem precisar gerar um novo build. No Android, também pode encaminhar mensagens do logcat para o console.
UnityIngameDebugConsole é gratuito? Qual é a licença?
UnityIngameDebugConsole é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
UnityIngameDebugConsole ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de UnityIngameDebugConsole foi em 6 de set. de 2026.
Para que posso usar UnityIngameDebugConsole?
Depurar problemas de gameplay em dispositivos de teste sem conectar ao editor. Acionar funções do jogo, como gerar objetos, durante sessões de QA. Consultar a saída do logcat do Android junto com os logs do jogo.
Como instalar UnityIngameDebugConsole?
Baixe o unitypackage na página de releases Ou adicione o pacote pelo Package Manager usando a URL do git: https://github.com/yasirkula/UnityIngameDebugConsole.git Ou instale pelo OpenUPM CLI: openupm add com.yasirkula.ingamedebugconsole Coloque o prefab do IngameDebugConsole na cena
Onde consigo UnityIngameDebugConsole?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yasirkula/UnityIngameDebugConsole

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados