언리얼 브리지

PicoBerry에서 완성한 3D 에셋을 클릭 한 번으로 언리얼 엔진으로 보냅니다 — 파일 다운로드도, API 키도 필요 없습니다.

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

플러그인 설치

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

Unreal Editor의 Edit → Plugins 창에서 활성화된 PicoBerry Bridge 플러그인

언리얼과 PicoBerry 연결

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

  • 언리얼에서 — 브리지가 내 컴퓨터의 포트(60611–60620)에서 대기합니다. 별도의 창이나 로그인은 필요 없습니다.
  • PicoBerry에서(브라우저) — 3D 에셋을 열고 3D 뷰어 아래 도구 막대의 3D 도구로 보내기(종이비행기) 아이콘을 눌러 DCC Bridge 메뉴를 엽니다. 메뉴의 Unreal 행이 연결됨(Connected) 으로 표시되면 보낼 준비가 된 것입니다. 아직 연결되지 않았다면 그 행에 연결 안 됨과 설치 링크가 보입니다.
연결 전 — Unreal 행에 Install 링크연결됨 — Unreal 행 Connected + 우측 종이비행기로 전송

에셋을 언리얼로 보내기

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

문제 해결

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

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

그래도 안 되면

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