# Sua casa em 3D no Home Assistant: NeonPlan 3D do zero

> Do download à planta funcionando: desenhe a casa, ligue luzes, sensores e portas, e monte um painel com a planta 3D ao lado de energia e temperatura.

- Autor: Douglas Baptista
- Publicado em: 2 nov 2026 · atualizado em 2 nov 2026
- Assunto: Painéis e cartões
- Vídeo: https://dougsmarthome.com.br/videos/sua-casa-em-3d-no-home-assistant-neonplan-3d-do-zero-gratis (YouTube: https://www.youtube.com/watch?v=5L1WHrgQPXg)
- Página: https://dougsmarthome.com.br/artigos/neonplan-3d-home-assistant-passo-a-passo

A planta 3D resolve o problema clássico do painel cheio de cartões: em vez de caçar qual cartão é de qual cômodo, você enxerga a casa como ela é. A lâmpada acesa brilha no lugar dela, a janela aberta aparece aberta e o portão abre na tela.

O NeonPlan 3D é **gratuito e de código aberto**, criado pelo desenvolvedor Mastershort. Eu não sou o autor: uso na minha casa e mostro o caminho. Existem pacotes pagos opcionais, mas **nada deste passo a passo precisa deles**.

## Antes de começar

Duas palavras aparecem o tempo todo:

- **Integração** é o conector que ensina o Home Assistant a conversar com alguma coisa (uma marca de lâmpada, um aplicativo).
- **Entidade** é cada coisinha que ele enxerga: uma lâmpada, um sensor de porta, um termômetro.

Você vai precisar de:

- Home Assistant **2025.1 ou mais novo** (de preferência atualizado);
- um navegador comum, como o Chrome;
- as **áreas** da casa cadastradas no Home Assistant (sala, cozinha, quarto). Não é obrigatório, mas ajuda muito.

> A partir do Home Assistant 2026.11, o HACS já vem embutido como **Marketplace**. Se a sua versão for mais antiga, siga o [passo a passo oficial do HACS](https://www.hacs.xyz/docs/use/download/download/) e, se puder, atualize o Home Assistant.

## 1. Baixar o NeonPlan 3D

1. Abra **Configurações › Marketplace**.
2. Pesquise **NeonPlan**, abra o resultado e clique em **Baixar**. Confirme a versão mais recente.
3. Quando terminar, a janela de configuração abre sozinha. Ela só avisa que uma página será adicionada na barra lateral: clique em **Enviar**.

Pronto: o **NeonPlan 3D** aparece na barra lateral, sem reiniciar nada.

## 2. Desenhar a planta

A tela tem duas abas: **Vista 3D** (onde você enxerga a casa) e **Editor** (onde você desenha). Vá para o Editor.

1. **Adicionar piso**: cada andar é um piso. Casa térrea, um piso; sobrado, um por andar.
2. **Divisão** é o cômodo. Arraste para desenhar um retângulo ou use a forma livre, ponto a ponto, para cômodos em L.
3. Atalho bom: **Adicionar divisões a partir das áreas do HA** cria os cômodos já com o nome certo.
4. Precisa de precisão? Use **Por medidas** e digite largura e comprimento em metros. Também dá para colocar a planta da casa como imagem de fundo e desenhar por cima.

As paredes aparecem sozinhas em volta das divisões. Se duas divisões se sobrepõem, o editor avisa que as paredes ficam incompletas: encaixe uma ao lado da outra.

### Portas e janelas com sensor

Escolha **Portas e janelas** e toque na parede. Ajuste largura, altura, lado da dobradiça e se abre para dentro ou para fora. Tem porta simples, de correr, janela e portão de garagem.

O pulo do gato: selecione a porta, escolha o tipo de sensor (por exemplo, contato de janela) e procure a entidade pelo nome. Quando a porta abrir na vida real, ela abre na tela também.

> Errou? O editor tem desfazer, refazer e guarda **pontos de restauro** sozinho.

## 3. Luzes, sensores, botões e móveis

- **Luzes**: selecione o cômodo, abra a lista de dispositivos (ele mostra as entidades da área) e posicione a luz na planta. Acesa, ela brilha; um toque liga e desliga.
- **Sensores**: temperatura, umidade, presença e consumo viram marcadores. Escolha mostrar nenhum, só os importantes ou todos.
- **Botões próprios**: dê nome, ícone e uma ação (cena, script ou abrir os detalhes da entidade). Eu uso para abrir o portão da garagem.
- **Móveis**: a versão gratuita traz 40 itens. A TV na planta mostra se está ligada; a persiana, se está aberta.
- **Exterior**: jardim, terraço, piscina, muro e portão.

Quando terminar, **exporte uma cópia de segurança** da planta.

## 4. A planta dentro de um painel

1. Abra o painel e clique no lápis para editar.
2. **Adicionar cartão › NeonPlan 3D**. O editor é visual: piso inicial, nome dos cômodos, ocupar o espaço todo e até o modo tablet de parede.
3. O truque: use uma visão do tipo **seções**, coloque a planta numa seção larga (três colunas) e, ao lado, os cartões que importam, como gasto de energia no mês, consumo de água e temperatura.

Cada cartão pode abrir outro painel ao toque: tocar no gasto de energia abre o painel de energia completo.

## 5. Extras gratuitos

- **Câmeras na planta**, na parede ou no teto; um toque abre a imagem ao vivo.
- **Pesquisa**: digite o nome de um dispositivo ou cômodo e a planta leva você até lá.
- **Voz**: o microfone no canto da Vista 3D entende "mostra a sala" e manda "liga a luz do corredor" para o Assist. Exige HTTPS e um assistente de voz configurado.
- **Cenas e scripts por cômodo** viram botões embaixo da vista 3D.
- **Tablet de parede**: quando nada muda na casa, o NeonPlan para de desenhar quadros (fica a 0 fps) e o tablet agradece.

## Links

- [NeonPlan 3D: projeto e manual](https://mastershort.de/en/neonplan3d/manual/)
- [Repositório do projeto](https://github.com/mastershort/neonplan3d)
- [Guia oficial de instalação do Home Assistant](https://www.home-assistant.io/installation/)

Ficou dúvida em alguma etapa? Comenta aqui embaixo que eu respondo.

## Veja também

- [Cards Incríveis no Home Assistant: Stack-in-Card, Mushroom & Card-Mod](https://dougsmarthome.com.br/videos/cards-incriveis-no-home-assistant-stack-in-card-mushroom-card-mod.md): Personalize sua interface do Home Assistant com Mushroom Template Card e Mushroom Chips! 🚀
- [Picture Elements Card - Home Assistant](https://dougsmarthome.com.br/videos/picture-elements-card-home-assistant.md): vídeo do canal
- [Card de notificações com condições e markdown no Home Assistant](https://dougsmarthome.com.br/videos/card-de-notificacoes-com-condicoes-e-markdown-no-home-assistant.md): Neste vídeo mostro como configurar notificações do meu projeto. Utilizando os cards markdown e conditional.
- [Novo Layout - Home Assistant [Pt-BR]](https://dougsmarthome.com.br/videos/novo-layout-home-assistant-pt-br.md): vídeo do canal
- [Gasto de energia do mês em reais](https://dougsmarthome.com.br/codigos/gasto-de-energia-no-mes-em-reais.md): Utility meter que zera todo mês + tarifa editável na tela + sensor de quanto o mês já custou.
- [Blueprint: sincroniza luz e interruptor nos dois sentidos](https://dougsmarthome.com.br/codigos/blueprint-sincroniza-luz-e-interruptor.md): Liga a luz pelo interruptor e o interruptor pela luz, sem loop. Uso na escada e na garagem aqui de casa.

---
Fonte: Doug Smart Home (https://dougsmarthome.com.br), por Douglas Baptista. Canal no YouTube: https://www.youtube.com/@dougsmarthome