NexusAI Wiki

언리얼 엔진 5.7용 노드 기반 AI 에셋 생성 플러그인 NexusAI의 문서입니다.

노드를 연결해 그래프를 구성하면 AI로 이미지·3D 오브젝트·머티리얼을 생성하고, 결과를 실제 언리얼 에셋으로 프로젝트에 바로 가져옵니다. 블루프린트 UK2Node가 아니라 전용 UEdGraph + 커스텀 SGraphNode 에디터(나이아가라/머티리얼 패턴)로 구현했습니다.

문서 목차

페이지	내용
설치	플러그인 설치, 요구 사항, 개발용 빌드
API 키 설정	프로바이더별 API 키 설정 방법
사용법	그래프 작성부터 에셋 활용까지
노드 대원칙	모든 노드가 따르는 4가지 설계 원칙
프로젝트 구성	모듈 구조와 개발 규약

기능 요약

세 가지 에셋 모달리티를 Function(변환) 노드와 Value(데이터) 노드의 그래프로 표현합니다.

모달리티	파이프라인
이미지	Prompt (+참조 Image) → Image Generate → Image
3D 오브젝트	Prompt + Image → Object Generate → Object
머티리얼	Prompt (+참조 Image) → Material Generate → Material, 이후 Object + Material → Apply Material → Object
리텍스처	Object + Prompt (+참조 Image) → Object Retexture → Object (메시 UV에 맞게 재텍스처)

노드

• Value: Prompt, Image, Object, Material
• Function: Image Generate, Object Generate, Material Generate, Apply Material, Object Retexture

AI 프로바이더

• 이미지: Google Gemini (nano-banana) · OpenAI GPT Image
• 3D / 리텍스처: Meshy (text/image/multi-image-to-3D, retexture)
• 머티리얼: 생성한 텍스처를 프로그램 생성 부모 머티리얼 기반 UMaterialInstanceConstant로 래핑 (A단계: 베이스 컬러 / PBR 맵은 후속)

생성 결과는 /Game/NexusAI/Generated/… 아래에 영구 에셋(텍스처·메시·머티리얼)으로 저장되어 에디터를 재시작해도 유지되고, 일반 에셋처럼 사용할 수 있습니다.

자동 업데이트: 에디터 시작 시 GitLab 릴리즈의 새 버전을 감지하면 알림에서 한 번에 업데이트할 수 있습니다(창 → NexusAI → 업데이트 확인으로 수동 확인도 가능). 자세한 내용은 사용법의 업데이트 참조.