블렌더 브리지는 PicoBerry 워크스페이스의 3D 에셋을 Blender로 곧장 보내주는 무료 Blender 애드온입니다. 파일을 받아 다시 불러올 필요 없이 클릭 한 번이면 됩니다. 모든 동작이 내 컴퓨터 안에서만 이뤄지고, API 키나 유료 잠금이 없어 누구나 어떤 요금제에서든 사용할 수 있습니다.
애드온 설치
- 애드온 다운로드 (
.zip파일). 압축을 풀 필요는 없습니다. - Blender에서 Edit → Preferences → Add-ons를 엽니다.
- Install(또는 Install from Disk)을 누르고, 받은
.zip을 선택해 확인합니다. - 목록에서 PicoBerry Bridge를 찾아 체크박스를 켜서 활성화합니다.
Blender와 PicoBerry 연결
애드온은 활성화하면 자동으로 시작되므로 대개 바로 준비됩니다.
- Blender에서 — 3D 뷰포트 헤더(View · Select · Add · Object 메뉴 옆)에 PicoBerry 칩이 보입니다. 누르면 패널이 열리고, 상태 줄에 Ready 또는 Listening on port 60601이 표시됩니다. Stopped로 보이면 Start를 누르세요.
- PicoBerry에서 (브라우저) — 워크스페이스에서 3D 에셋을 열고 툴바의 보내기(종이비행기) 메뉴를 누르면, Send to Blender 행이 초록색 연결됨으로 바뀝니다. 이러면 보낼 준비가 끝난 것입니다.
에셋을 Blender로 보내기
- PicoBerry 워크스페이스에서 완성된 3D 모델을 엽니다.
- 툴바에서 보내기(종이비행기 아이콘)를 눌러 메뉴를 엽니다.
- Send to Blender가 연결됨으로 표시되면 그 행을 누릅니다.
- 에셋을 내려받아 가져오는 동안 진행 상황 알림이 표시됩니다.
- Blender의 Outliner에 새 PicoBerry / <이름> 컬렉션이 생기고 그 안에 모델이 — 텍스처까지 — 들어옵니다.
Blender 패널
3D 뷰포트의 PicoBerry 칩을 누르면 모든 기능이 한곳에 모인 패널이 열립니다.
- 상태 — 가장 최근 상태 메시지를 보여줍니다 (예: Listening on port 60601, Ready). 연결이 꺼져 있으면 Stopped, 문제가 있으면 오류 메시지가 표시됩니다.
- Start / Stop — 로컬 연결을 켜거나 끕니다.
- Copy URL —
ws://주소를 복사합니다 (브라우저 개발자 도구로 연결을 확인할 때 유용). - Open Log — 애드온 로그 파일을 엽니다.
- Open Discovery Folder — 애드온이 자신을 알리는 데 쓰는 폴더를 엽니다.
- Preferences(톱니바퀴) — 아래의 애드온 설정으로 바로 이동합니다.
설정
Edit → Preferences → Add-ons → PicoBerry Bridge를 열거나 패널의 톱니바퀴를 누르세요. 대부분은 여기서 아무것도 바꿀 필요가 없습니다.
- Auto-start — Blender를 열 때 연결을 자동으로 시작합니다 (기본 켜짐).
- Port — 애드온이 수신 대기하는 로컬 포트(
60601이며, 사용 중이면 다음 몇 개로 자동 이동). - Allowed origins — 연결을 허용할 사이트 목록.
picoberry.ai는 이미 포함돼 있습니다.
문제 해결
보내기 메뉴에 연결됨이 안 떠요 / 연결이 안 돼요.
- Blender에서 연결이 켜져 있는지 확인하세요 — PicoBerry 칩을 누르고 Stopped면 Start를 누릅니다.
- PicoBerry를 Blender보다 먼저 열어두셨다면, 웹이 스스로 다시 찾을 때까지 잠깐 걸릴 수 있습니다. 다른 탭에 갔다가 돌아오거나 페이지를 새로고침하면 바로 다시 찾습니다.
- Blender 4.0 이상인지 확인하세요.
- 다른 프로그램이 포트
60601을 쓰고 있지 않은지 확인하세요.
연결되기 전에는 보내기 메뉴의 Send to Blender가 회색으로 비활성화되고 그 아래에 Bridge 애드온 설치 링크가 보입니다.
사이트가 Blender에 닿지 못해요.
- Preferences → Allowed origins를 열어 사용 중인 사이트(예:
picoberry.ai)가 목록에 있는지 확인하세요. - 브라우저를 최신으로 유지하세요 —
https에서 내 컴퓨터로 연결하는 건 최신 브라우저의 예외 처리에 기댑니다.
그래도 안 되면?
- 패널을 열어 Open Log를 누르면 애드온이 기록한 내용을 볼 수 있습니다. 그 파일과 함께 지원팀에 문의하세요.