AgrupaBIM

Agrupa, renomeia e organiza os conflitos do Clash Detective do Navisworks Manage. O que hoje é feito grupo a grupo, no braço, vira uma passada só: os conflitos saem organizados por nível ou eixo, com nomes padronizados e responsável já atribuído.

Apresentação

O Clash Detective entrega uma lista crua de conflitos. Um teste de porte médio traz centenas deles, todos com nomes como Conflito1, Conflito2, sem divisão por disciplina nem por região do modelo. Transformar isso em algo que a equipe consiga atacar é trabalho manual e repetitivo.

O AgrupaBIM cobre esse trecho do processo:

O plugin reorganiza, não resolve O AgrupaBIM não altera a geometria do modelo nem decide o que mover. Ele organiza os resultados do Clash Detective para que a decisão de projeto fique mais fácil de distribuir e acompanhar.

Requisitos

ItemRequisito
SoftwareAutodesk Navisworks Manage 2026 (64 bits)
SistemaWindows 10 ou superior
ModeloUm teste do Clash Detective já executado, com resultados
PermissãoConfirmação do Windows apenas para instalar
Precisa ser o Manage O Clash Detective só existe no Navisworks Manage. O plugin não funciona no Navisworks Simulate nem no Freedom, porque a funcionalidade que ele organiza não existe nessas edições.

Instalação

  1. Feche o Navisworks.
  2. Execute o instalador AgrupaBIM_v2.2.0_Setup.exe.
  3. Confirme a solicitação do Windows.
  4. Abra o Navisworks Manage. A aba AgrupaBIM aparece na faixa de opções.
Atualizar para uma versão nova Rode o instalador novo por cima. Não é preciso desinstalar o anterior, e a licença ativada continua valendo.

Licença e avaliação

O AgrupaBIM funciona por 14 dias em avaliação, contados a partir do primeiro uso. No período todos os recursos ficam liberados, e as janelas mostram no topo quantos dias restam:

Versão de avaliação — 9 dia(s) restante(s)

Ativar

  1. Abra Ajuda → Sobre na aba AgrupaBIM. Ali aparece o identificador desta máquina (HWID).
  2. Envie esse código ao solicitar a licença.
  3. Com a chave em mãos, use o botão de ativação e cole o código recebido.
A licença é vinculada ao computador O identificador é calculado a partir da placa de rede, da data de instalação do Windows e do número de série do disco C:. Trocar a placa, formatar o Windows ou mudar de máquina gera um identificador novo e exige reemissão da chave. A mensagem, nesse caso, é "Licença vinculada a outro computador", mostrando os dois códigos.
A validação acontece uma vez por sessão Se a licença vencer com o Navisworks aberto, você termina o expediente sem interrupção. A verificação só volta a acontecer na próxima abertura.

Outras mensagens que podem aparecer:

MensagemO que significa
Período de avaliação encerradoOs 14 dias acabaram
Licença expirou em dd/mm/aaaaA validade da chave passou
Relógio do sistema está atrasado em relação ao último usoA data do Windows foi movida para trás; acerte data e hora
Registro de instalação foi removido ou alteradoReinstale pelo instalador oficial

A barra AgrupaBIM

Depois de instalado, o plugin cria a aba AgrupaBIM, com os comandos em quatro painéis:

Agrupar ConflitosOrganiza por nível, eixo, elemento…
DesagruparDesfaz os grupos
Renomear ConflitosNomes padronizados e responsável
Revisão de ConflitosPercorre e marca o que foi tratado
Exportar BCFLeva os conflitos a outros programas
Limpeza de ViewpointsRemove texto repetido dos nomes
PropriedadesPerfis, códigos e responsáveis
AjudaEste manual
SobreLicença e identificador da máquina
PainelBotões
ConflitosAgrupar Conflitos (com Desagrupar no menu suspenso) · Renomear Conflitos
RevisãoRevisão de Conflitos · Exportar BCF
OrganizaçãoLimpeza de Viewpoints
ConfiguraçãoPropriedades · Ajuda (com Sobre no menu suspenso)

Fluxo de trabalho

Os comandos são independentes, mas a ordem abaixo é a que aproveita melhor o encadeamento entre eles.

  1. Rode o Clash Detective normalmente, no Navisworks.
  2. Agrupe por nível ou eixo, para separar o modelo em regiões que fazem sentido para a obra.
  3. Renomeie: cada grupo recebe nome padronizado e responsável.
  4. Exporte BCF ou distribua a lista para as disciplinas.
  5. Revise conforme as respostas chegam, marcando o que foi tratado.
Renomeie depois de agrupar, nunca antes Agrupar reescreve o teste inteiro e descarta os nomes de grupo existentes (a menos que você marque Manter grupos existentes). Renomear antes é trabalho perdido.

1. Agrupar conflitos

Agrupar Conflitos reorganiza os resultados de um teste segundo o critério escolhido. É o comando central do plugin.

O que ele espera encontrar: um documento aberto com pelo menos um teste do Clash Detective já executado e com resultados.

Janela de agrupamento de conflitos
Os testes do documento, os dois critérios e a caixa que decide se os grupos atuais sobrevivem.

Como usar

  1. Abra Agrupar Conflitos. A janela lista os testes do documento.
  2. Selecione um teste — ou vários, a lista aceita seleção múltipla.
  3. Escolha o critério em Agrupar por.
  4. Se quiser, escolha um segundo critério em Depois por (leia a ressalva adiante).
  5. Clique em Agrupar.

Os dez critérios

CritérioComo decide o grupoQuando usar
NoneNão agrupaÉ o valor inicial dos dois campos
LevelO nível da interseção de eixos mais próxima do centro do conflitoEdificação com pavimentos definidos
GridIntersectionA interseção de eixos mais próxima do centro do conflitoObra grande, para dividir por região
SelectionAO elemento do lado A do conflitoAgrupar pelo que colide
SelectionBO elemento do lado BIdem, pelo outro lado
ModelAO arquivo de origem do elemento ASeparar por disciplina, quando cada uma é um arquivo
ModelBO arquivo de origem do elemento BIdem
AssignedToO campo Atribuído a do conflitoVer a carga de cada responsável
ApprovedByO campo Aprovado porAuditoria de aprovações
StatusO status do conflitoSeparar o que já foi tratado
Os nomes aparecem em inglês A lista mostra Level, GridIntersection, SelectionA e assim por diante, porque vêm direto da API do Navisworks. A tabela acima é a tradução.
Level e GridIntersection exigem eixos no modelo Os dois dependem de um sistema de eixos ativo. Se o modelo não tiver, essas opções não aparecem na lista — não ficam acinzentadas, somem. Se você não as encontra, o motivo é esse.
Nível e eixo usam o centro do conflito, não a peça Um conflito no meio de um vão pode cair no eixo vizinho ao que você esperava, porque o que decide é o ponto central da interseção entre os dois elementos.

Quando o critério não consegue resolver, o conflito vai para um grupo de exceção:

SituaçãoNome do grupo
Sem nível identificávelSem nível
Sem interseção de eixos próximaSem interseção de eixos
Nível ou interseção sem nomeNível sem nome / Interseção sem nome
Elemento sem nomePai sem nome
Arquivo sem nomeModelo sem nome
Sem Atribuído aNão especificado

Manter grupos existentes

A caixa Manter grupos existentes vem desmarcada, e é a decisão mais importante da janela:

EstadoO que acontece
Desmarcada (padrão)Os grupos antigos são desfeitos e tudo é reagrupado do zero. Os nomes que você tinha dado se perdem
MarcadaOs grupos existentes são preservados com seus nomes, e só os conflitos que estavam soltos são agrupados
Reagrupar apaga o trabalho de renomeação Se você já renomeou os grupos e rodar Agrupar de novo sem marcar essa caixa, os nomes padronizados desaparecem junto com os grupos. Marque a caixa, ou refaça a renomeação depois.

Agrupar em dois níveis

O campo Depois por aplica um segundo critério dentro de cada grupo. Mas o resultado não é uma hierarquia de dois níveis: o Navisworks recebe uma lista plana, com o nome dos dois critérios unidos por sublinhado.

Agrupar por: Level        →   Pavimento 3
Depois por:  ModelA       →   Pavimento 3_HIDRAULICA
                              Pavimento 3_ELETRICA
                              Pavimento 4_HIDRAULICA

Na prática funciona bem para leitura e ordenação alfabética, mas não espere poder recolher o nível superior na árvore do Clash Detective.

Comportamentos que surpreendem

Antes de rodar, vale saber
  • Grupo de um conflito só é desfeito. Sempre. O conflito volta a ficar solto na raiz do teste — é proposital, para não poluir a árvore com grupos de um item.
  • Com os dois campos em None, nada acontece e nenhuma mensagem aparece. Se o clique em Agrupar pareceu não fazer nada, confira os dois campos.
  • Teste vazio também não avisa. O botão simplesmente não faz efeito.
  • Testes dentro de pastas do Clash Detective não aparecem na lista. Só testes na raiz são listados.
  • O teste é reconstruído por completo a cada execução. Em teste com muitos milhares de resultados, a operação leva tempo proporcional; a barra de progresso pode ser cancelada, e aí o teste volta ao estado anterior.

2. Desagrupar

Desagrupar desfaz todos os grupos do teste, deixando os conflitos soltos. Nenhum conflito é perdido — apenas os grupos e seus nomes.

Janela de desagrupamento
Cada teste mostra quantos grupos serão desfeitos antes de você confirmar. Teste sem grupo aparece desabilitado.

Há dois caminhos, e eles se comportam de forma diferente:

CaminhoComportamento
Menu Agrupar Conflitos → Desagrupar na faixaAbre uma janela com a lista de testes, mostrando quantos grupos e conflitos cada um tem, e pede confirmação
Botão Desagrupar dentro da janela de agrupamentoAge direto nos testes selecionados, sem confirmação
O botão da janela não pergunta nada Se quiser a rede de proteção da confirmação, use o comando da faixa de opções.

3. Renomear conflitos

Renomear Conflitos dá aos grupos um nome padronizado, montado a partir de um modelo de texto, e preenche o campo Atribuído a com o responsável da disciplina. É o comando que transforma a lista do Clash Detective em algo distribuível.

O que ele espera encontrar: um teste com conflitos, e os elementos precisam trazer o nome do arquivo de origem (para descobrir a disciplina) e a categoria do Revit (para escolher o texto da ação).

Janela de renomeação de conflitos
A prévia mostra nome antigo → nome novo e o responsável de cada grupo, antes de aplicar. A janela abre com 500 pixels de altura, e nesse tamanho a prévia fica com uma faixa de poucos pixels: arraste a alça do canto inferior direito, como nesta figura.

Como usar

  1. Abra Renomear Conflitos.
  2. Escolha o teste no campo superior.
  3. Confira a prévia: ela mostra nome antigo → nome novo e o responsável de cada grupo.
  4. Ajuste o que for preciso e clique em Aplicar.
CampoO que fazPadrão
Teste de ConflitoQual teste renomear; trocar recalcula a préviao selecionado no painel
Origem da AçãoAutomático (Prioridade), Seleção A (Fixo) ou Seleção B (Fixo)Automático
PrefixoTexto colado antes do nome geradovazio
FormatoO modelo de nome, com os campos entre chavesvem da configuração
Arquivos detectados A / BSomente leitura: mostra até cinco arquivos encontrados
Código A / Código BForça um código específico em todos os gruposvazio

O modelo de nome

Existem quatro campos, e apenas quatro:

CampoResolve paraSe não encontrar
{Index}Número sequencial do grupo, começando em 1sempre existe
{CodeA}Código da disciplina do elemento AXXX
{CodeB}Código da disciplina do elemento BXXX
{Action}Texto da ação, conforme o tipo do elementoVerificar conflito

O formato padrão é:

{Index}-{CodeA}x{CodeB} - {Action}

que produz nomes como:

1-ARQxEST - Mover tubulação
2-HIDxELE - Verificar conflito
Não existe formatação de número Escrever {Index:000} esperando 001 não funciona: o texto sai literalmente como 1:000. Só o campo {Index} exato é reconhecido. Se precisar de ordenação alfabética correta com mais de nove grupos, essa limitação vale ser considerada.
A numeração é por grupo, e depende do filtro Cada grupo recebe um número, não cada conflito. Grupos que não passam no filtro de status são pulados sem consumir número. Isso significa que, se alguém mudar o status de um grupo e você renomear de novo, a numeração muda.

Códigos de disciplina

O código sai do nome do arquivo de onde o elemento veio. O plugin procura, na lista de códigos configurada, alguma chave que esteja contida no nome do arquivo, testando as chaves mais longas primeiro.

Arquivo:  PROJ-ELE-BT-MT-R03.nwc
Chaves:   ELE, ELE-BT-MT
Resultado: ELE-BT-MT  (a mais longa vence)

Não encontrando nenhuma, usa XXX. Os códigos são editáveis — veja o arquivo de configuração.

Textos de ação

O campo {Action} vem da categoria do elemento (a propriedade Element > Category do Revit). Uma tubulação vira Mover tubulação, um duto vira Mover duto, e assim por diante, conforme a lista configurada.

A busca de ação não prioriza a chave mais longa Diferente dos códigos de disciplina, aqui vale a primeira chave encontrada. Se a lista tiver Pipe e Pipes, qual vence depende da ordem no arquivo. Evite chaves em que uma é começo da outra.

Prioridades e responsáveis

Com Origem da Ação em Automático, o plugin decide sozinho qual disciplina deve agir: compara a prioridade das duas e a ação recai sobre a de menor prioridade — a ideia é que quem tem prioridade maior (a estrutura, por exemplo) fica parado e o outro se desvia.

Nesse caso, os códigos aparecem invertidos no nome: {CodeA} passa a ser o da disciplina que fica parada. Havendo empate, a ação recai sobre A.

Código sem prioridade configurada vale zero Ele perde para qualquer disciplina que tenha prioridade definida. Se os resultados parecerem invertidos, confira se todos os códigos que você usa estão na lista de prioridades.

Comportamentos que surpreendem

Antes de aplicar
  • Não há como desfazer pelo plugin. O nome antigo não é guardado. Confira a prévia antes de aplicar.
  • Só grupos com status New ou Active são renomeados. Os marcados como revisado, aprovado ou resolvido são ignorados sem aviso e nem aparecem na prévia.
  • Não há verificação de nomes repetidos. Se o formato não contiver {Index}, vários grupos podem terminar com o mesmo nome.
  • Caracteres especiais passam direto. Barras e dois-pontos nos textos de ação vão parar no nome do grupo.
  • A mensagem de sucesso aparece mesmo com falhas parciais. Se algum grupo não puder ser renomeado, o processo segue e a confirmação aparece do mesmo jeito. Confira o resultado na árvore.
  • Rodar duas vezes com as mesmas opções é seguro — o nome é sempre construído do zero, não acumula prefixo.

4. Revisão de conflitos

Revisão de Conflitos lista todos os conflitos de todos os testes numa janela só. Clicar num item leva a câmera até ele e isola o par em conflito, para você avaliar e marcar o que já foi tratado.

Painel de revisão de conflitos
Cada conflito traz o teste, o grupo, o status nativo entre colchetes e, à direita, a marcação de revisão. O comentário aparece na faixa amarelada. O rodapé de contagem fica logo abaixo da busca.
RecursoO que fazPadrão
BuscaFiltra por nome, teste, grupo, descrição e comentáriosvazia
Isolar ao focarDeixa o resto do modelo translúcido e o par em conflito opacomarcado
Cores do sistemaMantém as cores originais; desmarcado pinta o par de vermelho e verdemarcado
Ocultar tratadosEsconde resolvidos e falsos positivosdesmarcado
MarcaçõesRevisado · Falso positivo · Resolvido · Limpar

O rodapé resume a situação: 142 conflitos • 20 resolvidos • 5 falsos positivos • 33 revisados • exibindo 84.

"Ocultar tratados" não esconde os revisados Só resolvidos e falsos positivos sao ocultados. O revisado continua na lista, porque ainda aguarda decisão.
As marcações são suas, e ficam nesta máquina Revisado, falso positivo e resolvido são gravados num arquivo local (clash_review.json), não no modelo. Isso quer dizer:
  • a equipe não enxerga suas marcações;
  • elas não vão junto no .nwf ou .nwd;
  • se o conflito se deslocar porque o modelo mudou, ou se o teste ou o grupo for renomeado, a marcação se perde e o conflito reaparece sem status.
Esse último ponto merece atenção: renomear os grupos depois de revisar apaga as marcações. Revise por último, ou aceite refazer.
Rodou o Clash Detective de novo? Use o botão Atualizar. A janela não percebe sozinha que os resultados mudaram.

5. Exportar BCF

Exportar BCF gera um arquivo .bcfzip no padrão BCF 2.1, com um tópico por conflito, para abrir no Revit, Solibri, BIMcollab e outros programas que leem o formato.

Não há janela de opções: o comando pergunta apenas onde salvar. O nome sugerido combina o nome do modelo com a data — Torre-A-20260807.bcfzip.

Cada tópico leva:

Três limites que valem conhecer
  • Os elementos não vêm selecionados. O BCF leva a câmera até o conflito, mas quem abrir não recebe a peça destacada — é preciso identificá-la visualmente.
  • Exporta tudo, inclusive resolvidos e falsos positivos. Não há filtro.
  • Cada exportação gera tópicos novos. Exportar duas vezes e importar as duas cria duplicatas no destino, porque os identificadores mudam a cada geração.

6. Limpeza de viewpoints

Limpeza de Viewpoints remove um trecho de texto do nome dos viewpoints salvos. Serve para limpar sufixos repetidos que o Navisworks e o Clash Detective acrescentam automaticamente.

Janela de limpeza de viewpoints
A contagem embaixo da árvore é a prévia: confira-a antes de executar, porque não há como desfazer.
  1. Escolha a pasta na árvore, à esquerda.
  2. Digite o texto a remover (o padrão é - Overview).
  3. Confira a prévia: os itens afetados aparecem destacados, com a contagem.
  4. Clique em Executar Limpeza.
Remove em qualquer posição, não só no fim Apesar do uso mais comum ser tirar sufixo, o comando apaga todas as ocorrências do texto, onde quer que estejam no nome. Um texto curto demais (por exemplo - ou 01) destrói a nomenclatura inteira. Confira sempre a prévia e a contagem.
Age nas subpastas e renomeia as próprias pastas A limpeza percorre tudo abaixo da pasta escolhida, e o nome das subpastas também é alterado. Selecionando a raiz, o modelo inteiro é afetado.
Diferencia maiúsculas de minúsculas - Overview e - overview são textos distintos. Se a contagem vier zerada, confira a grafia.

Esta operação altera o documento: salve o .nwf ou .nwd depois.

7. Propriedades e perfis

Propriedades reúne a configuração de renomeação — códigos, prioridades e responsáveis — e o estado da licença.

Janela de propriedades e perfis
O seletor de perfil no topo, a tabela de códigos com prioridade e responsável, e o estado da licença no rodapé. Prioridade maior é a disciplina que fica parada.

As configurações são salvas em perfis, o que permite manter conjuntos diferentes por tipo de obra. Na primeira abertura, a configuração existente é convertida no perfil Infraestrutura - Masterplan.

BotãoO que faz
SalvarGrava no perfil selecionado e o torna o perfil ativo
Salvar Como…Cria um perfil novo com o conteúdo atual
ExcluirRemove o perfil selecionado, com confirmação
Trocar o perfil no seletor não o ativa Selecionar outro perfil apenas mostra o conteúdo dele na tabela. Para passar a usá-lo de fato, clique em Salvar. Sem isso, a renomeação continua usando o perfil anterior.
A tabela edita três colunas Código, prioridade e responsável. O formato do nome e os textos de ação são editados diretamente no arquivo de configuração.

O arquivo de configuração

Toda a inteligência da renomeação está num arquivo de texto simples, na pasta do plugin, dividido em seções. Ele pode ser editado em qualquer editor de texto.

[General]
Format = {Index}-{CodeA}x{CodeB} - {Action}
DefaultAction = Verificar conflito
DefaultCode = XXX

[SelectionCodes]
ARQ = ARQ
EST = EST
ELE-BT-MT = ELE
DRN = DRN

[Actions]
Pipe = Mover tubulação
Duct = Mover duto

[Priorities]
EST = 100
ARQ = 80

[Assignees]
EST = joao@empresa.com.br
ARQ = maria@empresa.com.br
SeçãoPara que serve
[General]Formato do nome e os valores usados quando nada é encontrado
[SelectionCodes]De nome de arquivo para código de disciplina
[Actions]De categoria do elemento para texto de ação
[Priorities]Quem cede na hora de decidir a ação (número maior = fica parado)
[Assignees]De código para responsável, preenchido em Atribuído a
Carregar um arquivo substitui tudo As listas do arquivo não completam as internas: elas as substituem. Um arquivo sem a seção [Actions] faz todas as ações virarem Verificar conflito. Ao criar um perfil novo, copie um existente e edite, em vez de começar do zero.
O comentário do arquivo diz "EXACT MATCH required" Isso não corresponde ao comportamento: a busca é por trecho contido no nome, e não por igualdade exata. É o que permite ELE casar com PROJ-ELE-R02.nwc.

Onde ficam os arquivos

O quêOnde
Licença ativada%APPDATA%\AgruparClashes\license.json
Marcações da revisão%APPDATA%\AgruparClashes\clash_review.json
Configuração de renomeaçãorename_config.ini, na pasta do plugin
Perfissubpasta Profiles, na pasta do plugin
Plugin instalado%APPDATA%\Autodesk\ApplicationPlugins\AgrupaBIM.bundle
Levar a configuração para outro computador Copie a pasta Profiles e o rename_config.ini. As marcações da revisão também podem ser copiadas, mas a licença não: ela é vinculada à máquina.

Todos os comandos

ComandoO que fazAltera o modelo?
Agrupar ConflitosReorganiza os conflitos por nível, eixo, elemento, modelo, status ou responsávelSim, reescreve o teste
DesagruparDesfaz os grupos, preservando os conflitosSim
Renomear ConflitosNomes padronizados e responsável por grupoSim
Revisão de ConflitosPercorre os conflitos e marca o que foi tratadoNão, grava fora do modelo
Exportar BCFGera .bcfzip para outros programasNão
Limpeza de ViewpointsRemove um texto do nome dos viewpoints e pastasSim
PropriedadesPerfis, códigos, prioridades e responsáveisNão
AjudaAbre este manualNão
SobreLicença, versão e identificador da máquinaNão

Solução de problemas

A aba AgrupaBIM não aparece

Confirme que a instalação foi feita com o Navisworks fechado e que a edição é o Manage 2026 — no Simulate e no Freedom o plugin não carrega, porque não existe Clash Detective. Feche e reabra o programa; persistindo, reinstale.

Cliquei em Agrupar e nada aconteceu

Três causas, todas silenciosas: os dois campos de critério estão em None; o teste selecionado não tem conflitos; ou nenhum teste foi selecionado na lista.

Não encontro as opções Level e GridIntersection

Elas só aparecem quando o modelo tem um sistema de eixos ativo. Sem eixos, são removidas da lista.

Os grupos que eu havia renomeado sumiram

Agrupar reescreve o teste e descarta os grupos anteriores. Para preservá-los, marque Manter grupos existentes antes de agrupar.

Alguns grupos não foram renomeados

Só grupos com status New ou Active entram. Verifique se os que ficaram de fora estão marcados como revisado, aprovado ou resolvido.

O nome saiu com XXX no lugar da disciplina

Nenhum código configurado foi encontrado no nome do arquivo de origem. Abra Propriedades e acrescente um código que corresponda ao padrão de nomenclatura dos seus arquivos.

O nome saiu com 1:000

O campo de numeração não aceita formatação. Use {Index} puro.

As marcações da revisão desapareceram

Elas são vinculadas à posição do conflito e ao nome do teste e do grupo. Se o modelo mudou, ou se os grupos foram renomeados depois da revisão, a ligação se perde. Deixe a revisão como última etapa.

A limpeza de viewpoints não encontrou nada

O texto diferencia maiúsculas de minúsculas e precisa bater exatamente com o trecho existente. Confira a grafia e os espaços.

O programa pede a licença de novo

Provavelmente o identificador da máquina mudou — troca de placa de rede, formatação ou computador novo. Abra Sobre, veja o identificador atual e compare com o que foi usado na emissão da chave.