언리얼 브리지

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

플러그인 설치

1. 플러그인 내려받기 (.zip 파일).
2. 언리얼 프로젝트의 Plugins 폴더에 압축을 풉니다 (폴더가 없으면 직접 만듭니다).
3. 프로젝트를 엽니다. 언리얼이 플러그인 활성화를 물으면 Yes를 선택합니다.
4. Edit → Plugins에서 PicoBerry Bridge가 켜져 있는지 확인합니다.

언리얼과 PicoBerry 연결

플러그인은 에디터가 로드될 때 로컬 리스너를 자동으로 시작합니다.

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

에셋을 언리얼로 보내기

1. PicoBerry 워크스페이스에서 완성된 3D 모델을 엽니다.
2. 툴바의 보내기(종이비행기 아이콘)를 눌러 메뉴를 엽니다.
3. 메뉴의 Unreal 행이 연결됨(Connected) 으로 표시되면 그 행(또는 우측 종이비행기 아이콘)을 클릭합니다.
4. 에셋을 받아서 가져오는 동안 진행률 토스트가 표시됩니다.
5. 언리얼의 Content Browser에 PicoBerry / <이름> 아래로 모델이 나타나며(메시·머티리얼·텍스처 함께) 열려 있는 레벨에 배치됩니다.

문제 해결

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

• Edit → Plugins에서 PicoBerry Bridge 플러그인과 Python Editor Script Plugin이 모두 켜져 있는지 확인하세요.
• 언리얼보다 PicoBerry를 먼저 열었다면 페이지가 스스로 찾는 데 잠시 걸릴 수 있습니다. 다른 탭으로 갔다가 돌아오거나 페이지를 새로고침하면 바로 다시 검색합니다.
• 언리얼 엔진 5.4 이상인지 확인하세요.
• 다른 프로그램이 60611–60620 포트를 쓰고 있지 않은지 확인하세요.

그래도 안 되면

• 에디터의 Output Log(PicoBerry로 필터)에서 플러그인이 남긴 내용을 확인한 뒤, 그 내용과 함께 지원팀에 문의하세요.