TECHARTNOMAD | TECHARTFLOWIO.COM

UNREAL ENGINE

[메모] UE 프로젝트에 대한 HLSL 지원 설정

jplee 2026. 1. 7. 02:05

비주얼 스튜디오 설치할 때 옵션에서 Unreal Engien 어뎁터를 추가했다면 위와 같은 메뉴 일부를 볼 수 있습니다.

설정 가이드.

먼저 

확장관리에서 Visual Studio용 HLSL 도구를 설치하세요.

그 다음~

구성 버튼을 눌러서 engine 디렉토리 아니면 프로젝트 디렉토리를 선택 해 줍니다.

그럼 이제 "shadertoolsconfig.json" 파일이 하나 기본값으로 설정이 될텐데요~

{
	"hlsl.preprocessorDefinitions": {
		"COMPILER_HLSL": "1",
		"PLATFORM_WINDOWS": "1",
		"FEATURE_LEVEL": "SM6",
		"MATERIAL_SHADINGMODEL_DEFAULT_LIT": "1",
		"NUM_MATERIAL_TEXCOORDS_VERTEX": "4",
		"NUM_MATERIAL_TEXCOORDS": "4"
	},
	"hlsl.additionalIncludeDirectories": [
		"설치 된 경로/Engine/Shaders",
		"설치 된 경로/Engine/Shaders/Private",
		"설치 된 경로/Engine/Shaders/Public",
		"설치 된 경로/Engine/Shaders/Shared"
	],
	"hlsl.virtualDirectoryMappings": {
		"/Engine": "설치 된 경로/Engine/Shaders"
	}
}

이렇게 설정을 해 줍니다.

더 궁금한 사항은 보니까 AI 에서도 잘 알려주는 것 같습니다.

워낙 Rider 만 쓰다가 보니 별로 신경 쓰지 않았던 부분인데요. 메모 차원에서 기록 해 놨습니다.

참고로
"MATERIAL_SHADINGMODEL_DEFAULT_LIT": "1", 이 부분은 잘 살펴야 하는데요. 만약 커스텀 셰이더를 만들었다면 수정한 엔진 타입 클래스에서 확인 하고 추가 해 줘야 합니다.