Knowledge Base Generator for AI (dnSpy-style)

Tool to decompile .NET assemblies (e.g., Unity’s Assembly-CSharp.dll) and generate a readable, dnSpy-style knowledge base. Ideal for exploring game code and preparing data for LLMs.

— Portuguese version below —

Highlights

• On-demand detail: full, dnSpy-like decompilation for selected classes
• Optimized parallelization: fast analysis for the rest (fields, properties, events, ctors, methods)
• Structured output: namespace → type → members, consistent indentation
• Console UX: progress bar and colored steps ([1/3], [2/3], [3/3])
• Post-processing: removes noisy IL comments (//IL_...)
• Separate index: lists all types and members

Quick start

1. Build: dotnet build
2. Drag and drop your Assembly-CSharp.dll onto the built executable
3. Open the generated .txt files next to the DLL

CLI (PowerShell):

./bin/Debug/net9.0/ConsoleApp2.exe "C:\\Path\\To\\Assembly-CSharp.dll"

Configuration (Program.cs)

• CLASSES_PARA_DETALHE_COMPLETO
• NAMESPACES_PARA_INCLUIR / NAMESPACES_PARA_IGNORAR
• MAXIMO_TOKENS_APROXIMADO

License

MIT

Ferramenta para decompilar assemblies .NET (ex.: Assembly-CSharp.dll de Unity) e gerar uma base de conhecimento legível em estilo dnSpy. Ideal para explorar código de jogos e preparar dados para LLMs.

— Versão em português abaixo —

Destaques

• Detalhe sob demanda: decompilação completa, estilo dnSpy, para classes selecionadas
• Paralelismo otimizado: análise rápida do restante (campos, propriedades, eventos, construtores, métodos)
• Saída organizada: namespace → tipo → membros, com identação consistente
• UX no console: barra de progresso e etapas coloridas ([1/3], [2/3], [3/3])
• Limpeza pós-processamento: remoção de comentários IL ruidosos (//IL_...)
• Índice separado: arquivo com todos os tipos e membros

O que é gerado

• [AssemblyName]-knowledge-base-index.txt: índice legível com namespaces, tipos e membros
• [AssemblyName]-knowledge-base-completo.txt: base principal com o código decompilado

Requisitos

• .NET SDK 9.0+

Como usar

1. Compile o projeto: dotnet build
2. Arraste e solte seu Assembly-CSharp.dll sobre o executável gerado
3. Abra os .txt gerados na mesma pasta do seu DLL

Via terminal (PowerShell):

./bin/Debug/net9.0/ConsoleApp2.exe "C:\\Path\\To\\Assembly-CSharp.dll"

Configuração (em Program.cs)

• CLASSES_PARA_DETALHE_COMPLETO: nomes de classes para decompilação completa
• NAMESPACES_PARA_INCLUIR / NAMESPACES_PARA_IGNORAR: filtros de escopo
• MAXIMO_TOKENS_APROXIMADO: guarda de tamanho para evitar saídas gigantes

Dicas e solução de problemas

• Sem comentários //IL_...: já limpamos automaticamente; caso deseje outros filtros, adapte CleanDecompiledCode()
• Assemblies com dependências: o decompilador foi configurado para não falhar na resolução; ainda assim, copie dependências junto do alvo quando possível
• Unidades muito grandes: ajuste filtros de namespace e a lista de classes detalhadas

Ética e legalidade

Este projeto é para fins educacionais e de pesquisa. Respeite licenças e leis locais sobre engenharia reversa.

Licença

MIT

---

Knowledge Base Generator for AI (dnSpy-style) — EN

A tool to decompile .NET assemblies (e.g., Unity’s Assembly-CSharp.dll) and produce a dnSpy-like, readable knowledge base. Geared towards game code exploration and LLM dataset preparation.

Highlights

• On-demand detail: full, dnSpy-like decompilation for selected classes
• Optimized parallelization: fast analysis for the rest (fields, properties, events, ctors, methods)
• Structured output: namespace → type → members, consistent indentation
• Console UX: progress bar and colored steps ([1/3], [2/3], [3/3])
• Post-processing: removes noisy IL comments (//IL_...)
• Separate index: lists all types and members

Outputs

• [AssemblyName]-knowledge-base-index.txt
• [AssemblyName]-knowledge-base-completo.txt

Requirements

• .NET SDK 9.0+

Usage

1. Build: dotnet build
2. Drag and drop your Assembly-CSharp.dll onto the built executable
3. Open the generated .txt files next to the DLL

CLI (PowerShell):

./bin/Debug/net9.0/ConsoleApp2.exe "C:\\Path\\To\\Assembly-CSharp.dll"

Configuration (Program.cs)

• CLASSES_PARA_DETALHE_COMPLETO
• NAMESPACES_PARA_INCLUIR / NAMESPACES_PARA_IGNORAR
• MAXIMO_TOKENS_APROXIMADO

Notes

• Educational/research use. Respect licenses and local laws.

License

MIT