[NodeToCode + 로컬 AI 가이드] 블루프린트를 N초 만에 C++로?

언리얼 엔진 개발자라면 누구나 한 번쯤 “이 복잡한 블루프린트, 누가 C++로 좀 바꿔줬으면…” 하는 상상을 한다.

챗GPT에게 물어보자니 일일히 캡처해서 넣기도 힘들고, 복잡한 노드들은 인식도 잘 안된다

 

오늘은 본인 컴퓨터의 그래픽카드(Local AI)를 활용해!

비용 0원, 보안 걱정 0%로 블루프린트를 C++ 코드로 변환하는 방법을 정리해본다.

특히, RTX 3060(12GB) 보급형 그래픽카드에서도 완벽하게 돌아가는 세팅값을 정리한다....!

---

🖥️ 테스트 환경 (My Specs)
- OS: Windows 11
- GPU: NVIDIA RTX 3060 (VRAM 12GB)
- Engine: Unreal Engine 5.6
- AI Tool: LM Studio (Server Mode)
- Model: Qwen 2.5 Coder 7B Instruct

---

1. AI 두뇌 준비: LM Studio & Model

먼저 블루프린트를 해석할 AI 모델을 준비해야 한다.

1. LM Studio 설치: lmstudio.ai에서 다운로드.
2. 모델 다운로드: 검색창에 qwen2.5 coder 7b를 입력하고, Q4_K_M 버전을 받는다. (용량과 성능 밸런스가 가장 좋다고 한다.)
3. 서버 가동: 개발자 탭에서 Start Server를 누른다.

LM Studio Quick Start

---

2. UE 5.6 호환성 뚫기 & 플러그인 설치

NodeToCode 플러그인은 공식적으로 5.5까지만 지원하지만, 5.6에서도 문제없이 쓸 수 있다.

1. GitHub에서 최신 플러그인을 받아 Plugins 폴더에 넣는다.
2. NodeToCode.uplugin 파일을 메모장으로 연다.
3. "EngineVersion": "5.5.0" → "5.6.0"으로 수정 후 저장!

Releases · protospatial/NodeToCode

 

---

3. ⭐️ 핵심: 절대 실패하지 않는 설정법 (트러블슈팅)

가장 많은 시간을 쏟았던 부분이다. (여러분은 삽질하지 마세요)

1) LM Studio 서버 설정 (Server Settings)

• Server Port: 1234
• Enable CORS: [ON] 필수! (이게 꺼져 있으면 언리얼에서 접속을 못한다.)
• Serve on Local Network: [OFF] (혼자 쓸 거면 끄는 게 보안상 좋다.)

---

2) 모델 컨텍스트(기억력) 늘리기

처음에 번역을 시도했을 때 아래와 같은 에러가 뜨며 실패했다.

“Trying to keep the first 5461 tokens… context length of only 4096 tokens”
(번역할 내용이 너무 많은데, AI 기억 용량이 4096밖에 안 돼서 못 하겠음)

• 해결책
  
  • 설정창에서 Context Length를 과감하게 8192 (또는 12000) 이상으로 늘리고, 모델을 Reload!
  • RTX 3060 12GB 모델이라면 충분히 버틴다.

---

3) 언리얼 플러그인 설정

• Provider: LM Studio
• Model Name: qwen2.5-coder-7b-instruct (LM Studio에서 Copy Identifier 버튼으로 복사해온 정확한 ID여야 한다.)
• Server Endpoint: http://127.0.0.1:1234

---

4. 결과

모든 설정 후, 블루프린트 에디터에서 [Node to Code] -> [Translate Blueprint]를 클릭했다.

(두근거리는 로딩 화면… 약 10초 정도 소요)

---

변환 결과 (Header & Source)

놀랍게도 AI가 .h(헤더) 파일과 .cpp(소스) 파일을 완벽하게 분리해서 생성해준다.

 

1. Header (.h) 분석

• UFUNCTION(BlueprintCallable) 매크로를 자동으로 붙여준다.
• 멀티캐스트 델리게이트(DECLARE_DYNAMIC_MULTICAST...) 선언도...
• 주석(@brief)까지 달아서 문서화해준다.

2. Source (.cpp) 분석

• 블루프린트 로직의 완벽한 이식:
  • Delay 노드 → GetWorldTimerManager().SetTimer(...)로 변환
  • 형변환 → Cast<UGeometryCacheComponent>(GetMesh()) 처럼 안전한 캐스팅 사용.
  • 복잡한 스위치 문(Switch on Int)도 깔끔하게 구현.

---

5. 총평

Qwen 2.5 Coder 7B 모델은 생각보다 훨씬 똑똑했다.

단순히 노드를 텍스트로 옮기는 수준을 넘어, “언리얼 C++스러운” 코드를 짜준다.

• API 비용 0원. 무제한 사용 가능.
• 블루프린트 공부용으로도 훌륭함 (이 노드는 C++로 이렇게 짜는구나!).
• 주석 자동 생성으로 문서화 작업 단축.

+ 이런 사이트도 있다 : https://blueprintue.com