---
title: "Filmsquare para Blender"
description: "Leve os elementos e o still de um plano para o Blender para marcação em 3D, e envie de volta um still ou um playblast como uma nova versão no plano."
url: https://www.filmsquare.ai/docs/pt-br/plugins/blender/
lang: pt-BR
section: plugins
updated: 2026-11-09
---

# Filmsquare para Blender

O add-on do Filmsquare para o Blender 4.2 ou mais novo leva um plano para a sua cena: o elenco, as locações e os objetos de cena que ele
usa, e o seu still. Quando a marcação está pronta, ele envia um still ou um playblast de volta ao mesmo plano como uma nova
versão. O trabalho aparece em **Storyboard → 3D** da produção.

O add-on está em beta. É grátis e licenciado sob GPL-3.0-or-later.

## Instalar

1. Baixe o `blender.zip` na página de Plugins.
2. No Blender, abra **Edit → Preferences → Get Extensions**.
3. Abra o menu no canto superior direito e escolha **Install from Disk**, depois escolha o zip.
4. Em **Preferences → System**, ligue **Allow Online Access**. Sem isso o add-on não conecta.

## Entrar com uma chave pessoal

O add-on trabalha em seu nome, com a sua função, em um espaço de trabalho. Ele usa uma chave pessoal, do mesmo tipo que você usa para
o Claude Code.

1. No Filmsquare, abra **Settings → Claude** e escolha **Use a personal key instead**.
2. Dê a ela um **Name of the key** (por exemplo "Blender na minha estação") e escolha **Create a personal key**.
3. Copie a chave. Ela começa com `fsk_` e aparece uma vez só.
4. No Blender, abra **Edit → Preferences → Add-ons**, expanda **Filmsquare** e cole a chave em **Key**.
5. Escolha **Test**. O add-on mostra o espaço de trabalho e a sua função.

A chave fica guardada nas preferências do seu Blender, só neste computador. Quem tiver a chave pode trabalhar como você neste
espaço de trabalho: desconecte-a em **Settings → Claude** se ela vazar.

> [!NOTE]
> Trazer um plano exige qualquer função. Enviar trabalho de volta exige a função de artista ou acima.

## Escolher um plano

Abra a barra lateral na viewport 3D (aperte `N`) e escolha a aba **Filmsquare**. Escolha, de cima para baixo:

1. **Production**
2. **Episode**
3. **Scene**. Uma produção sem cenas nomeadas tem uma cena, **All shots**.
4. **Shot**

O botão de atualizar recarrega a lista de produções.

## Trazer os elementos e o still

Em **Import**, escolha como as referências chegam, depois **Import elements and still**:

| Opção | O que você recebe |
| --- | --- |
| **Empties** | Empties de imagem: leves, não renderizados. |
| **Planes** | Planos de imagem com um material: eles renderizam. |

O add-on faz uma coleção `Filmsquare` com uma coleção por plano, guardando **Cast**, **Locations**, **Props**
e **Stills**. Por elemento, ele pega a versão que o plano usa (a versão fixada, ou a atual) e as duas melhores
referências dela: primeiro as canônicas, depois frente ou corpo inteiro para elenco, plano aberto para locações. Elementos de estilo
ficam de fora.

O still do plano (o keyframe escolhido, ou o mais novo) também vira o fundo da câmera da cena.
Com **Use shot lens** ligado, a câmera assume a distância focal do plano. Importar de novo acrescenta só o que é novo.

## Enviar um still de volta

1. Enquadre o plano com a câmera da cena.
2. Em **Send**, escolha **Still from**: **Render** (o motor de render) ou **Viewport** (rápido, um frame da viewport
   pela câmera da cena).
3. Opcionalmente, descreva o **Move** (movimento de câmera), por exemplo "aproximação lenta".
4. Escolha **Send still**.

O frame cai no plano em **Storyboard → 3D** com a distância focal da câmera e a altura acima do chão
(metros). Cada still que você envia é uma nova versão do frame de marcação do plano; a mais nova vale. No Filmsquare,
um take pode então ser feito a partir dele, com o frame como referência de estrutura.

Na primeira vez que você envia trabalho, o Filmsquare pede uma vez que você declare que tem os direitos sobre os seus arquivos. O add-on
então mostra essa declaração em **Send** com **Confirm**. Escolha **Confirm**, depois envie de novo.

## Enviar um playblast de volta

Escolha **Send playblast**. O add-on renderiza a animação da viewport do intervalo de frames da cena em um MP4 e o acrescenta
ao plano como um clipe 3D em **Storyboard → 3D**. Enviar de novo do mesmo plano faz uma nova versão desse
clipe. Arquivos acima de 64 MB sobem em partes, então um playblast longo funciona também.

## O que fica no Filmsquare

O add-on só chama a [API](https://www.filmsquare.ai/docs/pt-br/api/overview/) pública com a sua chave. Versões de elemento, takes escolhidos, aprovações e
custos ficam no Filmsquare; o add-on os lê e nunca os altera. Ele não faz takes e não gasta
créditos.
