Unreal World

Unreal Engine 5.7 기반 복셀 지형 게임 프로젝트 — LLM 에이전트 통합 및 절차적 월드 생성

---

메인 목표

• LLM을 이용해 게임 내 에이전트를 제어하고, 실제 게임 서비스에 적용 가능한지 실험

서브 목표

• 텍스처, 애니메이션 등 에셋 생성 자동화 및 관리
• 언리얼 엔진의 구조를 커스텀하여 LLM 통합에 최적화
• 멀티플랫폼 테스트 및 상용 서비스

---

기술 스택

• 엔진: Unreal Engine 5.7.4 (Custom Fork: UECustom)
• 지형: Voxel-based 절차적 지형 생성 (다중 노이즈, 바이옴, 동굴, 광산 시스템)
• AI 프레임워크: Ollama / LMStudio (MCP Server 기반)
• 프로그래밍 언어: C++ (UE5), C# (Tools), Python (MCP/RAG Server)
• 참조 게임: Uncharted Waters 2 (Submodule: reference_game/unchartedwaters2)

---

프로젝트 구조 및 규칙

• 베이스: 태그 1.0.0 기준으로 재정리됨.
• 서브모듈:
  • UECustom: 엔진 커스텀 포크 (5.7.4) — 라이선스는 별도 항목 참고
  • reference_game/unchartedwaters2: 참조용 오리지널 게임 데이터 및 로직
• 데이터 기반 아키텍처:
  • TemplateData/*.md -> GameTools/DataTableGenerator -> GameData/*.json -> UDataTable (Runtime)
• 매니저 시스템: UUVWPlatformGameInstance를 정점으로 하는 매니저 구조.

---

라이선스

이 프로젝트는 GNU General Public License v3.0 (GPL-3.0) 으로 배포됩니다.

개인 사용 및 학습

누구나 자유롭게 포크, 다운로드, 수정, 학습 목적의 사용이 가능합니다.

상업적 이용 시 주의사항

상업적 목적으로 이 프로젝트(수정본 포함)을 배포, 유통, 서비스에 사용할 경우, 반드시 소스 코드를 공개해야 합니다. GPL-3.0의 조건에 따라:

• 수정한 소스 코드를 사용자에게 제공해야 합니다
• 동일한 GPL-3.0 라이선스 하에 배포되어야 합니다
• 라이선스 고지와 저작권 표시를 유지해야 합니다

자세한 내용은 저장소 루트의 LICENSE 파일을 참조하세요.

UECustom 서브모듈 라이선스 (중요)

UECustom/ 서브모듈은 Epic Games의 Unreal Engine 라이선스를 그대로 따릅니다. 이 프로젝트의 GPL-3.0 라이선스가 UECustom에 적용되지 않으며, 별도의 라이선스 조건이 적용됩니다. UECustom을 사용할 때는 반드시 Unreal Engine EULA를 확인하세요.

---

클론 및 빌드

# 서브모듈 포함 클론 (UECustom은 UE 엔진 전체 포크라 클론에 시간이 오래 걸립니다)
git clone --recursive git@github.com:kojeomstudio/UnrealVoxelWorld.git

# 서브모듈만 따로 초기화하는 경우
git submodule update --init --recursive

# IDE 프로젝트 파일 생성
GenerateProjectFiles.bat

---

참고 자료

1. https://arxiv.org/pdf/2404.02039

• A Survey on Large Language Model Based Game Agents

2. https://arxiv.org/pdf/2411.05348

• LLM-PYSC2: STARCRAFT II LEARNING ENVIRONMENT FOR LARGE LANGUAGE MODELS

3. https://arxiv.org/pdf/2305.16291

• VOYAGER: An Open-Ended Embodied Agent with Large Language Models

4. https://arxiv.org/pdf/2310.08067

• GameGPT: Multi-agent Collaborative Framework for Game Development

5. https://github.com/kojeomstudio/awesome-LLM-game-agent-papers

• A Survey on Large Language Model-Based Game Agents