고도 브리지

고도 브리지는 PicoBerry 워크스페이스의 3D 에셋을 클릭 한 번으로 열려 있는 고도(Godot) 씬에 바로 넣어 줍니다 — 파일을 받아서 다시 가져올 필요가 없습니다. 블렌더·언리얼 브리지와 마찬가지로 모든 처리가 내 컴퓨터 안에서만 일어나며, API 키도 유료 제한도 없어서 어떤 요금제에서나 사용할 수 있습니다.

애드온 설치

1. 애드온 내려받기 (.zip 파일).
2. 고도 프로젝트 루트에 압축을 풉니다. addons/picoberry_bridge/ 폴더가 추가됩니다 (기존 addons/ 폴더가 있으면 그 안에 합쳐집니다).
3. 고도에서 Project → Project Settings → Plugins를 열고 PicoBerry Bridge 옆의 Enable에 체크합니다.
4. 오른쪽 아래에 PicoBerry Bridge 독이 나타나고 Listening on 127.0.0.1:60621로 표시됩니다.

고도와 PicoBerry 연결

애드온을 켜는 순간(그리고 에디터가 로드될 때마다) 로컬 리스너가 자동으로 시작됩니다.

• 고도에서 — 브리지가 내 컴퓨터의 포트(60621–60630)에서 대기합니다. 별도의 창이나 로그인은 필요 없으며, 독에서 상태를 볼 수 있습니다.
• PicoBerry에서(브라우저) — 3D 에셋을 열고 툴바의 보내기(종이비행기) 메뉴를 클릭합니다. 메뉴의 Godot 행이 연결됨(Connected) 으로 표시되면 보낼 준비가 된 것입니다. 아직 연결되지 않았다면 그 행에 Install 링크가 보입니다.

에셋을 고도로 보내기

1. PicoBerry 워크스페이스에서 완성된 3D 모델을 엽니다.
2. 툴바의 보내기(종이비행기 아이콘)를 눌러 메뉴를 엽니다.
3. 메뉴의 Godot 행이 연결됨(Connected) 으로 표시되면 그 행(또는 우측 종이비행기 아이콘)을 클릭합니다.
4. 에셋을 받아서 가져오는 동안 진행률 토스트가 표시되고, 독에도 같은 진행률이 나타납니다.
5. 모델이 res://PicoBerry/<이름>/ 으로 임포트되고(메시·머티리얼·텍스처가 한 GLB 안에) 현재 열려 있는 씬(열린 씬이 없으면 새 3D 씬)에 노드로 추가됩니다. 추가된 노드는 자동으로 선택됩니다.

독에 각 단계가 로그로 남아서 전송을 처음부터 끝까지 확인할 수 있습니다 — 다운로드, 가져오기, 그리고 씬에 노드 추가까지:

문제 해결

보내기 메뉴에 연결됨이 안 뜨거나 연결되지 않아요.

• Project → Project Settings → Plugins에서 PicoBerry Bridge 플러그인이 켜져 있고, 독이 Listening on 127.0.0.1:60621로 표시되는지 확인하세요.
• 애드온을 켜기 전에 PicoBerry를 먼저 열었다면 페이지가 스스로 찾는 데 잠시 걸릴 수 있습니다. 다른 탭으로 갔다가 돌아오거나 페이지를 새로고침하면 바로 다시 검색합니다.
• 고도 4.2 이상인지 확인하세요.
• 다른 프로그램이 60621–60630 포트를 쓰고 있지 않은지 확인하세요.

그래도 안 되면

• PicoBerry Bridge 독을 열어 로그를 확인하고(모든 단계가 거기에 기록됩니다), 그 내용과 함께 지원팀에 문의하세요.