두나미스 테크니컬 아트 & 애니메이터 (Tech Art / Anim)

먼저 AIController 블루프린트에서 주인공 캐릭터를 발견했을 때를 이벤트 디스패처로 처리한다.

그리고 주인공 캐릭터 BP에서 처리한 이벤트를 호출하여 디텍트 이벤트로 바인드 한다.

이렇게 처리하면 AI가 주인공을 발견했을때만 이벤트가 일어난다.

이것을 이용해 몬스터가 주인공에게 뛰어 올때 자동으로 무기를 장착하도록 처리했다.

IDE 프로그램(라이더 같은..)에서 프로젝트를 실행하고, 메뉴에서 Editor / Game 을 골라서 디버그 및 실행이 가능해 진다.

말그대로 Editor 로 선택 시 언리얼엔진과 에디터에서 실행되게 되고, Game을 선택시 최종 패키징 된 빌드가 실행되게 된다.

타깃과 구성 별로 고를 수 있으며, 최대한 많은 문제를 잡아 내기 위해서는 Debug 모드로 실행하는게 좋은데, 여러가지 문제를 뒤지느라 프레임이 많이 떨어지게 된다.

반대로 Shipping 모드로 할 경우 디버그가 아예 안되게 막혀있고, 프레임이 가장 잘 나오게 된다.

이 에러가 날 힘들게 하고 있다...;;

UObject 의 수가 한도치를 넘어서서 에러가 발생했다는 건데.. 내 씬이 이렇게가지 무겁게 셋팅이 안되어있는데, 도무지 영문을 모르겠다..;.;

열심히 문제를 찾아봐야겠네.. 어딘가에서 오브젝트가 무한 증식하고 있는 듯 하다.

• 문제를 찾았다! 위 문제에 대한 Debug 방법 정리.
  • Editor Preferences -> Genera - Performance 에서 Show Frame Rate and Memory를 체크하면 UObect를 디스플레이 해준다.

    

    

    
    
    
    
  • 현재 UObject가 무한 증식 되고 있는 것을 확인할 수 있다.
    • 그다음 여러 프로파일링을 돌려서 확인하는게 좋은데, 나는 일단 가장 의심되는 오브젝트들을 하나씩 지우면서 확인해서 찾아냈다.
    • AI 로직쪽에서 부하를 일으킨다고 느꼈는데, 역시나 AI 관련 Actor들을 지우고나니 UObject의 증가가 멈췄다... 이제부터 요놈을 뜯어 고쳐야 한다.
    • 일단 RunBehavior 트리를 연결만 하면 무조건 증가하는 UObject를 발견했다.

* 해당 문제해결

- 첫째로는 GC를 자주 발동시켜 문제를 완화 - 하지만 게임내 렉을 일으킬수 있어 좋은 방법 아님.

- 완전 해결된 이유 - 주인공 애니메이션을 정리하면서 자동 해결.

referencing 잘못된 애니나 오브젝트들이 UObject를 증가시키게 되므로 잘못 연결된것들을 고치면 자동으로해결.

게임 시작할 때의 위치나 퀘스트 완료후의 위치를 Location Volume 을 활용해서 위치를 지정했다..

그런데 얘가 뒤통수를 쳤다.

에디터상에서는 위치값을 매우 잘 잡아 주지만 패키징 빌드후에는 전혀 엉뚱한 곳으로 캐릭터를 워프시킨다..  젠장.

전부 Actor 로 다시해서 문제를 해결했다.. 황당.

엔진 코드 중에  UniquePtr.h  라는 포인터 처리 코드가 있습니다.

코드에서 포인터를 사용할 경우 해당 헤더파일을 반드시 참조하게 되어 디버그에러시 해당 파일과 잘못연결되어 에러를 뱉는 경우가 허다합니다.

메모리에 올렸다 해제했다를 잘해야 하는데, 그러지 못한 경우 해당 코드에서 문제를 일으키는 것입니다.

포인터의 개념을 잘 숙지하여 해당 코드와 문제가 일으나지 않도록 관리하는 것이 필요합니다.

자, 이제 포인터에 대해서 자세히 알아봅시다..

포인터란 무엇일까?

포인터는 **"다른 변수의 메모리 주소를 가리키는 변수"**라고 생각하면 됩니다. 조금 더 쉽게 말하면, 포인터는 다른 데이터가 저장된 위치를 기억하는 변수예요.

비유로 이해하기

포인터를 주소로, 그리고 변수를 집이라고 생각해볼게요.

• 변수는 데이터가 저장된 "집"이에요.
• 포인터는 그 집이 어디 있는지 알려주는 "주소"입니다.

예를 들어, 집(변수) 안에 사람이 살고 있다고 하면, 포인터는 그 사람이 살고 있는 집의 위치를 알려주는 주소를 기억하고 있는 거예요.

포인터 사용해 보기

기본 변수와 포인터의 차이

• 보통의 변수는 데이터를 직접 저장합니다.
• 포인터는 데이터를 저장하는 것이 아니라, **그 데이터가 어디에 있는지(메모리 주소)**를 저장합니다.

여기서:

• int number는 숫자 10을 저장하는 일반 변수입니다.
• int* pointer는 number 변수의 메모리 주소를 저장하는 포인터입니다.
• &number는 number의 메모리 주소를 의미해요.

포인터의 기호

• * : 포인터를 선언할 때 사용합니다. 예를 들어, int*는 "정수형을 가리키는 포인터"라는 의미입니다.
• & : 변수의 메모리 주소를 얻기 위해 사용합니다.
• * (역참조) : 포인터가 가리키는 주소에 있는 값을 가져오기 위해 사용합니다.

왜 포인터를 사용할까?

포인터가 중요한 이유는 메모리의 직접적인 접근과 효율적인 데이터 처리를 가능하게 하기 때문이에요.

1. 동적 메모리 할당: 프로그램이 실행될 때 필요한 만큼 메모리를 요청하고 사용할 수 있어요.
   • 예를 들어, 프로그램이 실행될 때 사용자가 원하는 만큼의 데이터를 저장하려면, 포인터를 사용해 메모리를 동적으로 할당할 수 있습니다.
   cpp

   코드 복사

   int* p = new int; // 정수형 메모리 공간을 동적으로 할당받고, 그 주소를 p에 저장 *p = 20; // 할당된 메모리 공간에 20을 저장 delete p; // 사용한 메모리를 해제
2. 데이터 공유: 함수에서 변수를 복사하지 않고, 원래 데이터를 직접 변경할 수 있어요.
   • 예를 들어, 함수에 변수의 포인터를 전달하면 함수 내부에서 그 값을 직접 변경할 수 있습니다.
   cpp

   코드 복사

   void changeValue(int* p) { *p = 100; // 포인터가 가리키는 변수의 값을 변경 } int main() { int number = 10; changeValue(&number); // number의 주소를 함수에 전달 cout << "number의 값: " << number << endl; // 출력 결과: 100 return 0; }
3. 배열 처리: 포인터는 배열과 밀접하게 연관되어 있어요. 배열의 첫 번째 요소의 주소를 통해 전체 배열을 처리할 수 있습니다.
4. cpp
   코드 복사
   int arr[3] = {1, 2, 3}; int* p = arr; // 배열의 첫 번째 요소의 주소를 저장 cout << *p << endl; // 첫 번째 요소 출력 (1) cout << *(p + 1) << endl; // 두 번째 요소 출력 (2)

주의할 점

• 잘못된 포인터 접근: 초기화되지 않은 포인터를 사용하면 프로그램이 충돌할 수 있습니다. 항상 포인터를 사용할 때는 초기화하고 유효성을 확인하는 것이 중요합니다.
  cpp

  코드 복사

  int* p = nullptr; // 포인터를 초기화하지 않으면 위험!
• 동적 메모리 해제: 동적으로 할당한 메모리를 해제하지 않으면 메모리 누수가 발생합니다. delete를 사용해 메모리를 꼭 해제해야 합니다.

정리

• 포인터는 메모리 주소를 저장하는 변수입니다.
• *와 & 같은 기호를 사용해 메모리 주소를 얻거나 값을 참조합니다.
• 포인터는 효율적인 데이터 처리와 메모리 관리를 가능하게 해줍니다.

엔진을 실행할 때 SM6를 사용할 경우 AutogenShaderHeaders.ush 파일이 Game\Intermediate\ShaderAutogen\PCD3D_SM6\

폴더에 생성되게 됩니다.

쿠킹 테스트 중 C:\Users\User\AppData\Local\Temp\UnrealShaderWorkingDir 폴더에 생성된 파일과 충돌이 발생하길래 삭제한 적이 있습니다。

그 이후 엔진 실행 중 셰이더 컴파일이 안되서 따로 백업해 둔 프로젝트가 있어서 간신히 위기를 넘어 간 적이 있습니다. 

위 파일을 단순히 덮어씌운다고 해결되지도 않기 때문에 지우는 순간 프로젝트를 영영 잃게 될 수 있기 때문에 신중함이 필요합니다.
셰이더 쿠킹 문제가 터졌을 땐 캐싱 파일들을 바로 지우지 않고, 엔진과 게임 폴더내에 있는 Intermediate / DerivedDataCache / Saved 폴더를 제거후 엔진을 다시 실행하는 방식으로 접근하는 것이 가장 좋은 방법입니다.

각각의 폴더를 잘 파악해야 패키지 빌드를 잘 성공 시킬 수 있다.

1. 엔진폴더와 게임 폴더의 구분을 잘 파악하자.

* 1번은 엔진을 실행하는데 필수로 필요한 파일들이 있으며, 빌드 성공시에 해당 폴더의  \Engine\Binaries\Win64 폴더로 이동하여 UnrealEditor.exe 파일을 실행하면 엔진이 실행하게 된다.

* UE5.sln 파일을 실행한 후 IDE 프로그램에서 디버그나 빌드를 눌러도 실행된다.

* 아래는 Engine 폴더 내부인데, 빨간 줄을 친 부분은 엔진을 실행하는 데 필수 요소 들은 아니며 엔진을 실행하거나 하는등의 바이너리화 작업중에 발생하는 파일들이다. 따라서 엔진을 다른 컴퓨터나 폴더로 옮길수 해당 폴더들은 제외하고 옮겨도 실행하는데 문제가 없다.

* 2번은 엔진 실행후 해당 엔진을 통해 만들어진 게임 폴더들이다. 아래 폴더 구조를 통해 상세히 알아 보자. 먼저 여기서도 엔진과 마찬가지로 아래의 빨간색으로 표시된 폴더들은 구동시 반드시 필요한 폴더가 아니다.

1. Content 폴더 : 게임실행시 블루프린트와 아트어셋 데이터들이 생성되는 장소이다. 엔진코드나 플러그인을 딱히 건드리지 않았을 경우 해당 폴더만 옮겨도 게임내부의 어셋들을 다른 프로젝트에서 확인이 가능하다. 하지만, 안되는 경우도 꾀 있으니 해당 폴더만으로 모든작업된 내용이 똑같이 발동 될거라 섣불리 생각하지는 말자. 예를들어  tag나 Default.ini 등에서 바뀌어진 정보는 해당 폴더에 있지 않다.

2. Plugins 폴더 :  게임실행 후 설치한 플러그인나 외부적으로 제작한 플러그인들이 생성되는 장소이다. 해당 폴더에 설치된 내용이 있고, game.uproject 파일에서 true / false 설정을 할 수 있다. 다만 언리얼에서 기본 제공하는 플러그인들은 uproject 파일에서 true 했을 경우에 거의 잘 되긴 하지만 외부에서 가져온 플러그인들은 Source에서 제어해줘야만 정상 작동하는 PlugIns들도 있다는 것을 주의하자.

3. Source 폴더 : 소스코드 빌드된 엔진에서 가장 중요한 부분이라 생각하면 될거 같다. 요 부분에서 엔진 코드 / 게임 코드 / 플러그인 코드 등을 C++ 로 제어하게 된다. IDE 프로그램에서 처리되는 모든 소스코드가 이곳을 통해 이루어진다고 보면 된다. 그만큼 민감하게 예민한 곳이라 적절하게 코드작업이 이루어지지 않을 경우 빌드에러가 발생하여 게임 / 엔진 모두가 망가질수 있음을 주의하자.  Unreal C++ 코딩 카테고리에서 참고사항을 잘 확인하며 신중하게 작업을 진행해야 한다.

• IDE 프로그램에서 폴더구조를 변경한다 해도, Build.cs 파일에 에디터상에서 보여질 폴더를 표시해줘야 폴더가 에디터상에서 출력된다.
  • Build.cs 파일은 엔진에 종속된 코드라 변경 후에는 반드시 솔루션 빌드를 해줘야 정상 반영됨.

PublicIncludePaths.AddRange(new string[] {
    "MyProject/NewFolder"
});

• 그리고 코드상에서 줄기차게 사용하는 플러그인들도 build.cs 파일에 등록해 줘야 한다.

		PrivateDependencyModuleNames.AddRange(collection: new string[]
		{
			"MoviePlayer",
			"ProceduralMeshComponent",
			"Slate",
			"AnimGraphRuntime",
			"TraceLog",
			"MotionWarping",
			"MovieScene",
			"DeveloperSettings",
			"SQLiteCore",
			"SignificanceManager",
			"AnimationLocomotionLibraryRuntime",
			"MovieSceneTracks",
			"PhysicsControl",
			"SignalProcessing",
			"PoseSearch",
			"PhysicsCore"
		});

마지막 패키징에 실패할 때 치명적인 오류가 없었지만, 플러그인 관련  warning 만으로도 패키징을 실패할 수 있음을 알았습니다.

에러 로그 리포트에서 플러그인 관련된 내용들을 잘 서치하여 코드에서 사용되고 있지만 빠져있는 플러그인들을 .uproject 에 잘 로드해 줘야 한다.

• 예시 : UATHelper: Packaging (Windows): Warning: C:\UnrealEngine\GyGame\GyGame.uproject does not list plugin 'ModularGameplay' as a dependency, but module 'GyGame' depends on 'ModularGameplay'.
• 아래 코드를 .uprject 파일에 추가한다.

    {
        "Name": "ModularGameplay",
        "Enabled": true
    },

설치된 플러그인도 아닌데 엔진에 기본 깔려 있어서 로드하다가 실패하는 경우도 있다.. 이건 뭐..

• Plastic SCM 플러그인 오류.
• 예시 - Warning LogStreaming Failed to read file '../../../Engine/Plugins/Developer/PlasticSourceControl/Resources/Icon128.png' error.
• 이 경고는 언리얼 엔진이 특정 파일(../../../Engine/Plugins/Developer/PlasticSourceControl/Resources/Icon128.png)을 읽으려고 시도했지만, 파일이 존재하지 않거나 손상되었기 때문에 실패했다는 메시지입니다. 이 경고는 주로 Plastic SCM Source Control 플러그인과 관련이 있습니다. 플러그인 자체가 동작하는 데 필요한 리소스가 없을 때 발생합니다.
• 이럴 경우 아래 구문을  .uproject 파일에 추가하여 아예 로드되지 않도록 처리한다.

"Plugins": [
    {
        "Name": "PlasticSourceControl",
        "Enabled": false
    }
]

GameFeatureData 의 정보를 코드에서 쓰고 있는데 게임에디터상의 정보에 누락되어 빌드 패키징에서 실패하는 경우가 있다.

• 해결방법
• . Asset Manager 설정 변경
  1. 언리얼 에디터 열기:
     • Edit > Project Settings로 이동합니다.
  2. Asset Manager 검색:
     • 왼쪽 검색창에 Asset Manager를 입력하여 해당 섹션으로 이동합니다.
  3. Primary Asset Types to Scan 추가:
     • Primary Asset Types to Scan 섹션을 찾습니다.
     • + 버튼을 눌러 새 항목을 추가합니다:
       • Name: GameFeatureData
       • Asset Base Class: GameFeatureData
       • Directories: GameFeatureData가 위치한 디렉터리를 지정 (필요 시 All로 설정 가능).
       • Specific Assets: 특정 에셋을 지정하려면 여기에 추가.

외부에서 제작된 코드를 옮기거나 할때에 아래 그림처럼 사전 정의된 매크로를 사용하는 경우가 종종 있을 수 있다.

하지만, 문제는 해당 Class는 어디서 찾았는지 알길이 없다는 것이다..;;

그 이유는 프로젝트 이름을 참조하여 자동으로 생성되는 매크로이기 때문이다.

위치는

개인프로젝트폴더\Intermediate\Build\Win64\x64\UnrealEditor\Development\ 개인프로젝트폴더\

의 Definitions. 개인프로젝트폴더 .h 파일안에 아래처럼 숨겨져 있다.

비주얼 스튜디오로 작업하다 보면 매우 엄격하게 컴파일 감시를 하다보니 코드 한줄 잘 못 써도 바로 프로젝트가 터지는 일을 빈번히 겪게되어 아무 작업도 못하는 지경에 이르게 된다..;;  라이더를 사용하여 좀더 릴렉스하게 코드 작업을 진행해 보자.

다운 링크 : Rider: The Cross-Platform .NET IDE from JetBrains

언리얼 프로젝트에서 Source Code 작업을 Rider UProject로 선택해 준다.

라이더의 좋은점.

• 헤더파일등의 추가가 용이하고, 잘못된 컴파일 에러로 프로젝트 자체가 수시로 고장나 버리는 비주얼 스튜디오보다 훨씬 더 고장율이 떨어지면서 작업하는게 용이해 진다. 마치 유니티 C#작업하는 느낌과 거의 흡사해 짐.
  • 비주얼 스튜디오에서는 헤더파일만 만들고 cpp 파일을 안만들면 컴파일 에러와 빌드 에러를 일으키지만 라이더는 유연하게 대처 해준다.
• 라이더에서 작업하던 중간에 비주얼 스튜디오로 넘어가는것은 삼가하자..;; 프로젝트가 99프로 확률로 고장나면서 멘탈 공격 심하게 들어온다.
  • 그래도 너무 릴렉스하게는 하지 말고 중간중간 빌드를 해주면서 고장 난 부분이 없는지 수시로 체크하는 것도 필요하긴 하다..;;

언리얼 코드 작성은 유니티에서 작업하던거와는 신중함의 무게가 다르다.. 아래 사항들을 유의하며 코드 작성을 해야 한다.

• 오류가 많은 채로 빌드를 하면 빌드 실패는 당연한거고 UnrealEditor.exe 파일이 날라간다.
  • 반드시 한줄 한줄 오류가 없는지 점검하며 빌드를 해야 한다.
• 한줄만 잘못 써도 위와 같은 상황이 발생하게 되므로, 아래의 여러가지 코드 작성 방법을 유의하며 코딩 작업을 해야 한다.
  
  
  언리얼 엔진에서 C++ 코드를 작성할 때, 빌드 시간이 길고 한 줄만 잘못 써도 다시 빌드해야 하는 것은 개발자들이 자주 겪는 문제입니다. 다행히 이를 완화할 수 있는 몇 가지 방법이 있습니다:1. Hot Reload 활용하기
  • 언리얼 엔진은 코드를 변경한 후 엔진을 재시작하지 않고도 변경 사항을 반영할 수 있는 Hot Reload 기능을 제공합니다.
  • 하지만 Hot Reload는 코드 구조를 크게 변경하지 않은 경우에만 효과적입니다. 예를 들어, 새 클래스를 추가하거나 매크로를 변경한 경우에는 제한적일 수 있습니다.
  2. Live Coding 사용
  • 언리얼 엔진은 Live Coding 기능을 제공하여, 게임을 종료하지 않고도 변경된 코드 부분을 빠르게 컴파일하고 적용할 수 있습니다.
  • 설정 방법:
    1. Editor Preferences → General → Miscellaneous → Enable Live Coding 활성화.
    2. 변경 후 Ctrl + Alt + F11을 눌러 Live Coding 빌드를 실행.
  • 주의점: Live Coding은 큰 코드 수정에는 적합하지 않으며, 가벼운 수정에 유용합니다.
  3. PCH(Precompiled Header) 최적화
  • 프로젝트의 Precompiled Header를 잘 관리하면 빌드 시간을 크게 줄일 수 있습니다.
  • 모든 헤더 파일을 .cpp 파일에서 직접 포함하지 말고, 공통적으로 사용되는 헤더 파일은 PCH에 포함하세요.
  • 예를 들어, MyProject.h에 공통 헤더들을 넣고 필요할 때마다 이를 사용하도록 구성합니다.
  4. 코드 모듈화
  • 코드를 작은 모듈로 나누면, 변경된 모듈만 다시 컴파일하면 되므로 빌드 시간을 단축할 수 있습니다.
  • 각 기능을 별도의 모듈로 분리하면 의존성을 줄이고 더 빠르게 작업할 수 있습니다.
  5. Blueprint와 C++의 적절한 조화
  • 빈번히 변경해야 하는 코드나 실험적인 작업은 Blueprint로 구현하고, 성능이 중요한 부분만 C++로 작성하는 것도 좋은 방법입니다.
  • 이 접근법은 빌드 시간을 줄이는 데 매우 효과적입니다.
  6. Unity Build 비활성화
  • 언리얼 프로젝트는 기본적으로 Unity Build를 활성화하여 여러 .cpp 파일을 한 번에 컴파일합니다.
  • 하지만 일부 상황에서는 Unity Build를 끄면 특정 파일만 다시 컴파일하게 되어 더 빠를 수 있습니다.
    • BuildConfiguration.xml에서 bUseUnityBuild를 false로 설정하세요.
  7. 코드 변경 전 유효성 검사
  • 에디터에서 미리 코드 스타일이나 오류를 체크할 수 있는 도구(예: Rider, Visual Studio, CLion)를 사용하면 빌드 전 많은 문제를 방지할 수 있습니다.
  8. SSD와 RAM 업그레이드
  • 하드웨어 업그레이드도 빌드 시간을 줄이는 데 큰 도움이 됩니다.
  • 특히 NVMe SSD와 충분한 **RAM(32GB 이상)**을 사용하면 빌드 속도가 크게 향상됩니다.

• IDE 프로그램에서 폴더구조를 변경한다 해도, Build.cs 파일에 에디터상에서 보여질 폴더를 표시해줘야 폴더가 에디터상에서 출력된다.
  • Build.cs 파일은 엔진에 종속된 코드라 변경 후에는 반드시 솔루션 빌드를 해줘야 정상 반영됨.

PublicIncludePaths.AddRange(new string[] {
    "MyProject/NewFolder"
});

• 폴더 변경후 비주얼 스튜디오에서도 제대로 반영되지 않으므로 Generate Visualstudio Project를 실행해야 정상 반영된다.
• (GENERATED_BODY() 또는 GENERATED_UCLASS_BODY() 등)를 사용하려면, 반드시 .generated.h 파일이 헤더의 맨 마지막 #include 구문 뒤에 위치해야 한다는 규칙을 지키지 않았을 때 에러가 발생합니다.
•  빌드 에러가 떴을 때 비주얼 스튜디오나 IDE 프로그램을 그냥 종료하지 않고, 오류부분들을 수정하고 솔루션 빌드를 완료한 후 종료해야 한다. 그러지 않으면 프로젝트를 새로 받아야 할 수도 있음.

계속해서 빌드에 실패할 경우 비주얼 스튜디오에 불필요한 데이터가 많이 쌓여서 일 경우 가 많이 있다. 그럴 때는 비주얼 스튜디오를 깨끗하게 제거한후 클린 버전으로 다시 설치하는 것을 추천한다.

1. Visual Studio 설치 관리자를 통해 제거

1. Visual Studio 설치 관리자 실행
   • 시작 메뉴에서 "Visual Studio 설치 관리자"를 검색하고 실행합니다.
   • 설치된 Visual Studio 목록이 표시됩니다.
2. Visual Studio 제거
   • 제거하려는 버전을 선택한 뒤 제거 버튼을 클릭합니다.
   • 표시되는 모든 단계를 따라 Visual Studio를 제거합니다.

2. Visual Studio 설치 파일 및 캐시 삭제

Visual Studio가 제거된 후에도 관련 파일과 캐시가 남아있을 수 있습니다. 이를 제거하려면:

1. Visual Studio 설치 경로 확인
   • 일반적으로 Visual Studio는 다음 경로에 설치됩니다:
     • C:\Program Files (x86)\Microsoft Visual Studio
   • 해당 경로로 이동해 남아있는 파일이 있다면 삭제합니다.
2. 설치 관리자의 다운로드 캐시 제거
   • Visual Studio 설치 관리자가 사용하는 파일은 다음 경로에 저장됩니다:
     • %ProgramData%\Microsoft\VisualStudio\Packages
   • 위 경로로 이동하여 폴더를 삭제합니다.

3. Visual Studio 관련 레지스트리 항목 제거

주의: 레지스트리를 잘못 수정하면 시스템에 문제가 생길 수 있습니다. 레지스트리를 수정하기 전에 반드시 백업하세요.

1. 레지스트리 편집기 실행
   • Windows + R를 눌러 실행창을 열고 regedit를 입력한 뒤 실행합니다.
2. Visual Studio 관련 항목 삭제
   • 다음 경로를 찾아 삭제합니다:
     • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio
     • HKEY_CURRENT_USER\SOFTWARE\Microsoft\VisualStudio
   • 해당 항목이 있으면 삭제합니다.

4. Visual Studio Installer 제거

Visual Studio 설치 관리자도 제거하려면:

1. 설치 프로그램 제거
   • 시작 > 설정 > 앱 > 앱 및 기능으로 이동합니다.
   • "Visual Studio Installer"를 검색하여 선택 후 제거를 클릭합니다.

5. 추가적인 남은 파일 검색 및 삭제

1. %AppData% 및 %LocalAppData% 경로 확인
   • C:\Users\사용자명\AppData\Roaming\Microsoft\VisualStudio
   • C:\Users\사용자명\AppData\Local\Microsoft\VisualStudio
   • 위 경로에 남아있는 파일이 있다면 삭제합니다.
2. 디스크 정리 도구 사용
   • Windows의 디스크 정리 도구를 실행하여 불필요한 파일을 삭제합니다.

6. 재부팅 후 확인

컴퓨터를 재부팅한 뒤 Visual Studio와 관련된 파일이 완전히 삭제되었는지 확인합니다.

이 과정을 통해 Visual Studio를 완전히 제거할 수 있습니다.

재 설치 후 5.4.4에 타겟에 맞는 구성으로 비주얼 스튜디오를 다시 까는 방법.

1. 언리얼 런처를 실행하고 5.4.4 엔진을 실행후   C++  프로젝트를 새로 만든다.
   1. 이 때 visual Studio 2022 를 깔아야 한다고 안내가 나오고,  자동으로  visual studio installer 를 설치하게 된다.
   2. 인스톨러 설치 후 아래에서 두가지만 선택하여 비주얼 스튜디오를 설치한다.

이후에 샘플 프로젝트를  c++ 로 만들어 패키징까지 해보고 이상이 없는 지 체크한다. 

이후에 패키징이 정상적으로 되고, 실행도 온전히 된다면 기본적인 구성은 어느정도 완료됐다고 보면 된다.

이제 기존 소스코드 받은 5.4.4 의  Setup.bat / GenerateProjectFiles 를 실행한뒤 다시 ue5.sln 파일을 실행한다.
* 이 때 새 프로젝트가 비주얼스튜디오가 열릴 때 신뢰할 수 없는 소스들을 열면 불안하게 프로젝트가 열려 빌드가 되지않을 수 있어 열지 않는것이 좋다.

* 추가 설치가 필요하다고 뜰 때는 추가 설치를 진행해 준다.

언리얼 소스코드 빌드는 왜 필요한가?

1. 엔진 커스터마이징

• Unreal Engine의 소스 코드를 수정해야 하는 경우:
  • 엔진의 기본 기능을 확장하거나 수정해야 할 때 소스 코드를 직접 변경해야 합니다.
  • 예: 물리 엔진(Px), 렌더링 파이프라인, 네트워크 모듈 등을 맞춤화.
• Epic Games Launcher로 설치한 엔진은 소스 코드 접근이 불가능하므로, GitHub에서 제공되는 소스 코드를 빌드해야 수정이 가능합니다.

2. 특정 플랫폼 지원

• Unreal Engine이 기본적으로 지원하지 않는 플랫폼에서 게임을 실행하려는 경우:
  • 커스텀 하드웨어, OS, 또는 특수 플랫폼(예: 리눅스 변형, 특정 임베디드 시스템).
  • 일부 플랫폼에서는 빌드 시 추가 의존성을 포함하거나 커스텀 설정이 필요합니다.

3. 최신 버전 또는 특정 브랜치 사용

• Epic Games Launcher를 통해 제공되는 Unreal Engine 버전은 공식 릴리스에 한정됩니다.
  • 만약 최신 개발 브랜치(예: Main 브랜치)나 특정 버전이 필요한 경우, GitHub에서 해당 소스를 내려받아 빌드해야 합니다.
  • 실험적 기능이나 버그 수정 사항을 즉시 사용하고 싶을 때 유용합니다.

4. 디버깅 및 문제 해결

• 엔진 내부에서 발생하는 문제를 디버깅해야 할 때:
  • 엔진의 작동 방식이나 특정 API 호출 흐름을 파악하기 위해 소스 코드 접근이 필요할 수 있습니다.
  • Visual Studio(또는 다른 IDE)에서 엔진 코드 전체를 디버깅할 수 있습니다.

5. 플러그인 개발

• 고급 플러그인이나 모듈 개발 시 엔진의 소스 코드와 깊게 연동되는 경우:
  • 일부 고급 기능을 추가하거나 시스템 수준의 동작을 수정해야 할 때.
  • 소스 코드 빌드된 엔진에서 테스트해야 플러그인과의 호환성을 보장할 수 있습니다.

6. 라이센싱 또는 코드 분석

• 기업이나 특정 프로젝트에서 엔진의 동작을 세부적으로 검토하거나 맞춤화해야 하는 경우.
• 엔진을 수정하지 않더라도 소스 코드 빌드를 통해 엔진의 모든 부분에 접근할 수 있습니다.

7. 전문적인 작업 환경 구축

• 대규모 팀이나 전문 개발 환경에서 커스텀 엔진 빌드를 사용하는 경우:
  • 엔진 빌드를 공유하여 팀 전체가 동일한 엔진 상태로 작업.
  • 각종 커스텀 빌드 설정(특정 디버그 플래그, 빌드 최적화 등)을 포함.

등등의 이유로 필요하지만, 간단한 1인 게임을 만들기 위해서는 굳이 필요하지 않다고 여겨지고, 최소한 오픈 월드 RPG 이상의 환경 구축이 필요한 게임에서만 하는게 좋지 않을까 싶습니다.

왜냐? 너무 어렵고 진입 장벽이 높음.. 하다가 지쳐버림.

좌충우돌 소스코드 빌드 성공기.

1. Git이랑 연동해서 하는법

• 먼저 언리얼에서 개발자 계정을 만들고,Git과 연계하는 작업을 진행한다.
  • 근데 불친절한 언리얼과 Git의 만남이라 그런가.. 정말 복잡하고 어렵고 느리다.
  • 엔지니어 위주의 설명이다보니 진짜 디자이너 출신들의 진입 장벽이 너무 높게 느껴진다..
  • 이래서 1인개발은 멀고도 험하다..ㅠ

Unreal Engine on GitHub

요 페이지와 아래 페이지를 통해 GitHub 의 계정을 언리얼과 연동하는 작업을 먼저 진행한다.

언리얼 엔진 소스 코드 다운로드하기 | 언리얼 엔진 5.5 문서 | Epic Developer Community | Epic Developer Community

위 페이지에서 가장 눈여겨 보아야 할 부분. - 아래의 충족여건이 안되면 링크를 타고 가도 404 Page Error 어쩌구 뜨면서 연결이 안된다.

언리얼 개인 계정 페이지에서 아래와 같이  Git Hub 와 연동이 되어야 한다.

잘 모를 땐 GitHub 내 언리얼 엔진 - Unreal Engine  페이지에서 아래의 FAQ를 잘 확인하며 하나씩 잘 따라가는 것도 좋다.

위의 계정연결을 성공하고 나서 소스 코드 브랜치 중 EpicGames/UnrealEngine 으로 들어가 원하는 버전을 선택한다. 나는 5.4.4를 선택했다.

여기서 이제 두가지 방법으로 소스코드 빌드를 할 수 있게 되는데, Git 브렌치를 이용하여 Repository를 복사하여 내 Repsitory를 이용하는 방법 그리고 그냥 Zip 파일을 받아서 내 하드에 풀고 Setup.bat 파일로 하는 방법

첫 째, GitHub 데스크탑을 이용하여 내 Repository를 이용하는 방법

GitHib Desktop 앱을 이용하면 좀더 손쉽게 Repository를 이용할 수 있다.

위 까지 성공하고 Clone Reprository를 실행하면 아래 화면이 뜨면서 언리얼 엔진을 내 Repository에 가져오기 시작한다.

위의 처리가 완료되고 폴더가기를 누르면 내 로컬 컴퓨터에 Engine 브랜치가 다운 받아진것을 확인할 수 있습니다.

두 번째, 그냥 Zip 파일을 받아 압축을 풀고 Setup.bat 파일을 실행한다. 전 그냥 이방식을 추천합니다.

EpicGames/UnrealEngine: Unreal Engine source code 페이지에서 Zip 파일을 받아 압축을 푼다.

어디 드라이브가 됐든 최상위에 압축을 풀고 1. Setup.bat / 2. GenerateProjectFiles 를실행한다. 최상위 폴더에 풀지 않으면 경로에러로 압축이 안풀릴수 있다.

 Setup은 30분~1시간, GenerateProjectFiles는 10초면 된다.

언리얼 빌드를 시작하기 전에 VisualStudio 2022를 받고, 아래 해당 되는 것들을 설치합니다.

주소 - Visual Studio 2022 IDE - 소프트웨어 개발자를 위한 프로그래밍 도구

그런 후 UE5.Sln 파일을 실행하고 솔루션 'UE5'에 마우스 오른쪽 버튼을 누르고 솔루션 빌드를 시작합니다.

위 작업은 최종 작업으로서 최소2시간에서 컴퓨터 사양따라 반나절 이상 소모되는 경우도 있으니 주무시기전에 하거나 다른 일을 하고 오시는 것을 추천드립니다.

여기까지 진행후 빌드 성공이 뜨면 나만의 커스텀 엔진을 생성하는데 성공하게 되고, Engine/Binaries/Win64 폴더에서 UnrealEditor를 실행하면 커스텀 엔진이 실행되게 되고, 거기서 프로젝트를 새로 만들면 나만의 엔진에서 나만의 게임을 만들수 있게 됩니다.

추가설치가 뜰땐 시키는데로 하는게 좋습니다.

문제점 - 소스코드 완료 후 오류가 많을 경우 버전들을 픽스하여 다시 설치한다.

비주얼 스튜디오 추가 구성과 도움이 필요할 땐 아래사이트를 참고하면 도움이 됩니다.

언리얼 엔진용 Visual Studio Code 구성 | 언리얼 엔진 5.5 문서 | Epic Developer Community | Epic Developer Community