Bug Tracker (.bg)
English below · 
Português mais abaixo
English
A VS Code extension that opens .bg files in a visual editor to track the bugs of a game: table or Kanban board, statuses, priorities, labels, image and video attachments, change history and reproducibility details.
Getting started
- Create a file with the
.bg extension (for example bugs.bg), or run Bug Tracker: New .bg file (Ctrl+Shift+P).
- Type a title in the box at the top and press Enter to add a bug quickly, or use + New bug to fill in everything.
- Click a bug to edit it.
Everything is saved in the .bg file itself (JSON), so Ctrl+Z, Save and Git work like with any other file. To see the raw JSON: Bug Tracker: Open as text (JSON).
Features
- Table and Kanban: switch at the top. In Kanban you drag cards between status columns; with several cards selected they all move. Each column has a box to add bugs directly. The layout always fits the window: on narrow windows secondary columns are hidden instead of showing a scroll bar.
- Labels: type and press Enter (or comma). Filter by label in the toolbar.
- Bulk editing: tick bugs with the checkboxes (table or cards). A bar lets you change status and priority, add or remove labels, and delete. Esc clears the selection.
- Reproducibility: frequency, platform, version/build, steps, expected and actual behaviour.
- Image and video attachments: Attach… button, paste a screenshot (Ctrl+V) or drag files into the dialog. Files are copied to a folder next to the
.bg (bugs.bg → bugs.anexos/). Click a thumbnail to view it large. If a video does not play inside VS Code, use Open in system. Removing an attachment or deleting a bug does not delete the file from the .anexos folder.
- History: every bug records when its status, priority, labels, attachments and other fields changed (History tab). The last 200 changes per bug are kept.
- Status bar: shows how many bugs are unresolved (open, in progress or testing) across all
.bg files in the workspace. Click to open the list; with several files you choose which one. It gets a warning background when there are unresolved critical bugs.
- English / Português: the flags at the top right of the editor switch the language. By default the editor uses the language of VS Code (Portuguese if VS Code is in Portuguese, English otherwise). Your choice is remembered.
{
"version": 1,
"nextId": 2,
"bugs": [
{
"id": 1,
"title": "Character walks through the wall",
"description": "",
"steps": "1. …",
"expected": "",
"actual": "",
"area": "Physics",
"version": "0.3.1",
"platform": "Windows",
"frequency": "frequente",
"labels": ["collisions"],
"attachments": [{ "name": "screenshot.png", "path": "bugs.anexos/xyz_screenshot.png", "kind": "image" }],
"status": "aberto",
"priority": "alta",
"createdAt": "2026-10-26T10:00:00.000Z",
"updatedAt": "2026-10-26T10:00:00.000Z",
"history": [{ "at": "2026-10-26T10:00:00.000Z", "field": "created" }]
}
]
}
Statuses: aberto (open), progresso (in progress), teste (testing), resolvido (resolved), nao-corrigir (won't fix).
Priorities: critica (critical), alta (high), media (medium), baixa (low).
Frequencies: sempre (always), frequente (frequent), as-vezes (sometimes), raro (rare), uma-vez (once).
The identifiers stay the same in both languages, so a .bg file can be shared between people using different languages. Files from earlier versions keep opening: new fields stay empty until you fill them in.
Português
Extensão para o VS Code que abre ficheiros .bg num editor visual para acompanhar os bugs de um jogo: tabela ou quadro Kanban, estados, prioridades, etiquetas, anexos de imagem e vídeo, histórico de alterações e dados de reprodutibilidade.
Como começar
- Cria um ficheiro com extensão
.bg (por exemplo bugs.bg), ou corre Bug Tracker: Novo ficheiro .bg (Ctrl+Shift+P).
- Escreve um título na caixa de cima e prime Enter para adicionar rapidamente, ou usa + Novo bug para preencher tudo.
- Clica num bug para o editar.
Tudo é guardado no próprio ficheiro .bg (JSON), por isso Ctrl+Z, Guardar e Git funcionam como em qualquer ficheiro. Para ver o JSON em bruto: Bug Tracker: Abrir como texto (JSON).
Funcionalidades
- Tabela e Kanban: alterna no topo. No Kanban arrastas os cartões entre colunas de estado; se tiveres vários selecionados, movem-se todos. Cada coluna tem uma caixa para adicionar bugs diretamente. O layout ajusta-se sempre à janela: em janelas estreitas escondem-se colunas secundárias em vez de aparecer uma barra de scroll.
- Etiquetas: escreve e prime Enter (ou vírgula). Filtro por etiqueta na barra de ferramentas.
- Edição em massa: marca bugs com as caixas (na tabela ou nos cartões). Aparece uma barra para mudar estado e prioridade, adicionar ou remover etiquetas e apagar. Esc limpa a seleção.
- Reprodutibilidade: frequência, plataforma, versão/build, passos, comportamento esperado e observado.
- Anexos de imagem e vídeo: botão Anexar…, colar uma captura de ecrã (Ctrl+V) ou arrastar ficheiros para o diálogo. Os ficheiros são copiados para uma pasta ao lado do
.bg (bugs.bg → bugs.anexos/). Clica numa miniatura para ver em ponto grande. Se um vídeo não reproduzir no VS Code, usa Abrir no sistema. Remover um anexo ou apagar um bug não apaga o ficheiro da pasta .anexos.
- Histórico: cada bug regista quando mudou o estado, a prioridade, as etiquetas, os anexos e os outros campos (separador Histórico). Guarda as últimas 200 alterações por bug.
- Barra de estado: mostra quantos bugs estão por resolver (aberto, em progresso ou em teste) em todos os
.bg do workspace. Clica para abrir a lista; se houver vários ficheiros, escolhes qual. Fica com fundo de aviso quando há bugs críticos por resolver.
- English / Português: as bandeiras no canto superior direito do editor mudam o idioma. Por defeito o editor usa o idioma do VS Code (português se o VS Code estiver em português, inglês nos restantes casos). A tua escolha fica guardada.
O formato é o mesmo descrito na secção em inglês. Os identificadores (aberto, progresso, teste, resolvido, nao-corrigir, critica, alta, media, baixa, …) mantêm-se iguais nos dois idiomas, por isso um .bg pode ser partilhado entre pessoas que usam idiomas diferentes. Os ficheiros das versões anteriores continuam a abrir: os campos novos ficam vazios até os preencheres.
