커스텀 빌드

이 페이지에서는 커스텀 UE5 빌드에 Dash를 설치하는 과정을 설명합니다. 몇 가지 유의사항:

  • Dash는 UE5.1 이상에서만 호환됩니다.

  • 대부분의 경우 과정은 상당히 간단하지만, 커스텀 UE5 빌드가 기본 엔진 소스에서 크게 변경된 경우 일부 문제가 발생할 수 있으므로 [email protected]로 문의하는 것을 권장합니다.

  • 우리는 보통 회사들을 공용 Slack 채널로 초대하여 실시간으로 안내하고 아티스트와 직접 피드백을 주고받을 수 있게 합니다. 연락해 주세요!

  • 크래시 리포팅, 분석, AI 기능 등을 끄려면 특정 환경 변수를 설정하면 됩니다. 이 주제에 대한 자세한 내용은 아래에 있습니다.

그럼 시작해봅시다.

빌드 방법은 두 가지이며, 하나는 플러그인 빌드이고 다른 하나는 소스 빌드입니다. 두 파일 모두 다음 Google Drive에 있습니다: polygonflow.io/latest-source-build에서, 아래의 다른 지침을 확인하여 원하는 빌드 방법을 선택할 수 있습니다.

빌드 방법:

옵션 1: 플러그인 빌드 지침

이는 일반적인 언리얼 엔진 플러그인 구조이므로 가장 직관적인 배포 방식입니다. Epic Games 플러그인 가이드 를 정상적으로 적용할 수 있습니다.

시작하려면 Plugin Build 폴더를 Google Drive 에서 열고 설치하려는 Dash 버전에 해당하는 폴더를 엽니다. 여기에는 우리가 지원하는 각 UE 버전별로 하나의 zip이 있으므로 해당 UE 버전에 맞는 zip만 다운로드하면 됩니다.

zip을 다운로드하고 압축을 풀면 Dash 폴더를 PROJECT_ROOT/Plugins 또는 ENGINE_ROOT/Engine/Plugins 에 배치할 수 있으며, 이는 플러그인 가이드.

에 설명된 방식입니다.

Python 종속성 설치 Dash Python 코드는 PLUGIN_ROOT/Content/Python 아래에 위치하며 언리얼의 Python에서 자동으로 사용 가능합니다. init_unreal.py

는 수정이 필요 없으며 모든 사용자에게 항상 유효합니다. Dash 플러그인 설치 후 언리얼 엔진을 처음 시작하면 Dash는 Python 종속성을 PLUGIN_ROOT/Content/Python/Plugins/UnrealEngineContext/Imports/311/ 언리얼 엔진 5.4+의 경우 아래에, 그리고 PLUGIN_ROOT/Content/Python/Plugins/UnrealEngineContext/Imports/39/

언리얼 엔진 5.1-5.3의 경우 아래에 설치합니다. 이 과정은 프로젝트별로 한 번 발생합니다(프로젝트별로 Dash를 설치한 경우). 또는 엔진 버전별로 한 번 발생합니다(엔진에 Dash를 설치한 경우). 디스크 공간을 절약하려면 Dash를Engine/Plugins 아래에 설치하는 것이 권장됩니다. 예시 엔진 경로:, ENGINE_ROOT/Engine/Plugins/GraphNUnrealPlugin, ENGINE_ROOT/Engine/Plugins/Polygonflow/GraphNUnrealPlugin.

ENGINE_ROOT/Engine/Plugins/Whatever/GraphNUnrealPlugin

디스크 공간 소비 Dash 플러그인 크기는 약 1GB 설치 직후입니다. Python 종속성이 설치되면 전체 크기는약 3GB

가 됩니다. 또한 Dash는 에셋의 썸네일 이미지 같은 에셋 메타데이터를 다운로드하므로 이로 인해 추가 공간이 소요될 수 있습니다.

컴파일 Dash 플러그인은 일반적인 언리얼 엔진 코드 플러그인 구조를 준수하며, C++ 프로젝트 내에서 컴파일하거나언리얼 자동화 스크립트 사용 또는 도구→플러그인

메뉴에서 “패키지” 버튼을 사용하여 컴파일할 수 있습니다. 이를 통해 사용자는 커스텀 엔진용으로 Dash를 빌드할 수 있습니다.

제거(언인스톨) 이 과정은 프로젝트별로 한 번 발생합니다(프로젝트별로 Dash를 설치한 경우). 또는 엔진 버전별로 한 번 발생합니다(엔진에 Dash를 설치한 경우). 디스크 공간을 절약하려면 Dash를 또는 PROJECT_ROOT/Plugins

단순히 GraphNUnrealPlugin 폴더를 에서 제거하세요. 또한

Documents/Polygonflow

폴더도 제거하십시오. Google Drive 옵션 2: 소스 빌드 지침

이 빌드 옵션의 경우, 먼저

  • Source Build폴더를 열고 설치하려는 Dash 버전의 zip을 다운로드합니다.

  • 이 ZIP 파일에는 다음이 포함되어 있습니다:Dash

  • 아래에 위치하며 언리얼의 Python에서 자동으로 사용 가능합니다.: 이 폴더는 설치 관리자에서 복사된 파일을 보관합니다. 설치 없이 버전 관리나 공유 폴더를 통해 플러그인을 배포할 수 있게 해줍니다.

GraphNUnrealPlugin

  1. : 이 디렉터리에는 커스텀 엔진 빌드에 Dash를 통합하기 위한 C++ 코드가 포함되어 있습니다.

  2. : 만약 모든 아티스트의 기기에 Dash를 설치하지 않기로 선택하면, 이 개발자 파일이 플러그인의 Python 부분을 시작하는 진입점 역할을 합니다. 그다음 빌드할 시간입니다! 새로운 언리얼 C++ 프로젝트 생성 프로젝트의

  3. Plugins 아래에 위치하며 언리얼의 Python에서 자동으로 사용 가능합니다. 폴더에 플러그인을 배치합니다(Plugin 폴더가 아직 없으면 생성). 결과는 Plugins\\GraphNUnrealPlugin 이어야 합니다. Source Build ZIP 안에 함께 제공된 파일을 프로젝트 내부의

  4. Plugins/GraphNUnrealPlugin/Content/Python아래에 위치하며 언리얼의 Python에서 자동으로 사용 가능합니다. 로 복사하여 플러그인이

  5. 와 그 라이브러리들을 볼 수 있게 하거나, 그렇지 않으면

ModuleNotFoundError: No module named 'GN'

  1. 와 같은 오류가 발생합니다. 파일 끝부분의 경로를 편집하여, 플러그인을 배포하려면 당신이 Dash 폴더를 배치한 위치로, 또는 설치 관리자를 사용하는 경우 설치 디렉터리로 지정하세요..

.uproject 파일을 탐색기에서 우클릭하고 “Generate Visual Studio project files”를 선택하여 비주얼 스튜디오 프로젝트를 생성합니다.

프로젝트 파일을 생성하려면 우클릭하세요.

  1. Visual Studio 또는 Rider에서 솔루션을 열고 그곳에서 빌드하세요. 자세한 정보는 공식 문서 에서 확인하세요. Python에서 사용하기 플러그인은 파이썬 인터프리터에 일부 기능을 노출하며, 언리얼이 파이썬 스텁을 생성하도록 하여 IDE에서 로드할 수 있습니다.

  2. 언리얼 엔진을 열고 플러그인을 활성화하세요. 그러면

Python Script Plugin

  1. 과

  2. Editor scripting utilities 플러그인들이 활성화됩니다.

  3. 프로젝트 설정으로 이동하여 개발자 모드를 활성화하세요.

개발자 모드는 자동완성을 위한 파이썬 스텁을 생성합니다.

에디터를 재시작하세요.

  • 다음을 확인하세요: PROJECT_ROOT/Intermediate/PythonStub/unreal.py

  • 이 파일을 IDE에 추가하면 내보낸 함수들에 대한 자동완성을 사용할 수 있습니다. 버전 관리에서 제외할 항목 두 빌드 유형 모두에 대해 버전/소스 관리에서 제외할 수 있는 파일들: Plugins/UnrealEngineContext/Imports/thirdparty

  • (약 2 GB) - 이 폴더는 사용자 기기별로 생성 및 채워지며 Python 패키지를 포함합니다. Modules/GN/ContentLibrary/Backends/IESLibrary/IesLibraryContents

  • (약 28 MB) - 이 폴더는 같은 폴더에 있는 IesLibraryContents.zip

  • 에서 추출됩니다. IesLibraryContents.zip

  • ThirdPartyLicenses - 기능에는 영향이 없으며 선택적입니다.

  • __pycache__ - Python이 생성합니다.

*.pyc

*.pdf

- EULA 같은 법적 문서로 선택적입니다. *.md.

- 법적 문서 및 내부 문서로 선택적입니다.

Dash 환경 변수 Dash 환경 변수 지침.

특정 환경 변수를 설정하여 Dash에서 특정 기능과 옵션의 사용 가능 여부를 제어할 수 있습니다. "1", "yes" 또는 "true"를 사용하면 모두

참 Dash 환경 변수 지침

으로 인식됩니다.

DASH_CRASH_REPORT_ENABLED Dash 환경 변수 지침

파일 경로 등을 포함할 수 있는 크래시 리포팅을 활성화하거나 비활성화합니다. 기본값 =

활성화됨 Dash 환경 변수 지침

DASH_UPDATE_CHECK_ENABLED

시작 시 업데이트 확인을 활성화하거나 비활성화합니다. 업데이트 확인은 Dash가 처음 표시되는 각 언리얼 에디터 세션당 한 번 발생합니다. Dash는 최신 버전 정보를 가져오기 위해 우리의 Cloudflare 서버에 요청을 보냅니다. 기본값 - DASH_ANALYTICS_ENABLED

Dash 사용 텔레메트리를 활성화하거나 비활성화합니다. Dash는 사용 데이터를 주기적으로 우리 MongoDB 클러스터로 전송합니다. 기본값 -

DASH_REGISTER_PREFERENCES_FOR_ANALYTICS Dash 환경 변수 지침

활성화하면 분석 옵션을 제어하는 토글이 Dash 환경설정 UI에 추가됩니다. 기본값 -

DASH_OPEN_AI_ENABLED

우리의 OpenAI Enterprise API 계정을 통한 AI 어시스턴트 및 AI 에셋 태깅을 활성화하거나 비활성화합니다. 기본값 -

  1. 활성화

  2. DASH_REGISTER_PREFERENCES_FOR_OPEN_AI

활성화하면 OpenAI Enterprise API를 사용한 AI 기능 활성화 토글이 Dash 환경설정 UI에 추가됩니다. 기본값 -

자주 묻는 질문(FAQ)

Permission Denied / 읽기 전용 / 쓰기 보호 파일 - 버전 관리 문제

metadata.json 파일과 관련하여 권한 거부 또는 읽기/쓰기 오류가 표시되면 두 가지를 시도해 볼 수 있습니다:

  • Windows 11에서 Windows Defender가 Documents 폴더에 추가하는 자동 쓰기 보호(Protected folder)를 끄세요.

  • metadata.json 또는 버전 관리 하의 다른 Dash 파일들을 Perforce 등에서 항상 쓰기 가능하도록 표시한 다음 설치 과정을 처음부터 다시 수행할 수 있습니다.

플러그인을 모든 머신에서 컴파일해야 하나요?

아니요. 동일한 엔진 버전을 사용하는 모든 머신에 대해 사전 빌드된 C++ 플러그인을 배포할 수 있습니다.

플러그인을 모든 아티스트 머신에 설치해야 하나요?

Dash를 실행하려면 두 가지 구성 요소가 필요합니다:

  • 언리얼 C++ 플러그인

Dash Python 플러그인

  • 플러그인을 모든 아티스트 머신에 설치하거나 커스텀 빌드된 C++ 플러그인과 함께 버전 관리로 직접 배포할 수 있습니다.

  • C++ 플러그인의 의존성은 무엇인가요?

  • C++ 계층의 의존성 목록은 다음과 같습니다:

  • 마이크로소프트의 메모리 라이브러리(언리얼도 사용함)

  • mimalloc.lib

Dash 내부 의존성

IndexMeshSymbols.lib

  • _math.lib

  • _array.lib

  • meshoptimizer.lib

  • _gnmesh.lib

  • Dash Python 플러그인의 의존성은 무엇인가요?

  • Dash는 일련의 내부 및 서드파티 라이브러리에 의존합니다. 다음 목록은 변경될 수 있지만, 작성 시점 기준으로 사용되는 서드파티 라이브러리는 다음과 같습니다:

  • abseil

  • eigen

  • embree

  • OpenSubdiv

  • Physix

  • tbb

  • robin-hood-hasing

  • tinyspline

  • FastNoise2

  • fast_obj

  • unordered_dense

  • blinker

  • boto3

  • botocore

  • certifi

  • dateutil

  • jmespath

  • orjson

  • pytz

  • semver

  • s3transfer

  • sentry_sdk

  • urllib3

  • numpy

PIL

PySide6

scipy

sklearn shiboken6

torch_redstone

일부는 순수 파이썬 모듈이고, 일부는 파이썬 모듈 내부에서 사용하는 C++ 라이브러리입니다.

새 릴리스마다 플러그인을 다시 컴파일해야 하나요?

예. 커스텀 언리얼 버전을 사용하는 경우 C++ 플러그인을 다시 컴파일하고 일치하는 Dash Python 플러그인을 함께 재배포해야 합니다. 구조가 이미 갖춰져 있다면 프로젝트를 재생성하고 빌드하는 것만으로 간단해야 합니다. 릴리스 간에 변경될 수 있으므로 init_unreal.py도 업데이트해야 하는지 확인하세요.

새 버전의 Dash가 출시되면 Dash에서 직접 알림을 받게 되며, 알림을 받으면 항상 다음에서 최신 ZIP을 다운로드할 수 있습니다:

https://www.polygonflow.io/download-latest-source-build

  1. C++ 플러그인을 컴파일할 때 몇 가지 경고가 발생하면 어떻게 해결하나요?

  2. Dash는 끊임없이 진화하고 있으며, 우리의 최우선 과제는 아티스트와 스튜디오에 지속적인 업데이트와 작업 흐름을 개선할 수 있는 새 도구를 제공하는 것입니다. 이러한 빠른 개발 속도는 때때로 우리가 인지하고 있는, 치명적이지 않은 컴파일 경고를 남길 수 있습니다. 앞으로 진행하면서 수정될 수 있지만, 경고를 전혀 허용하지 않는 정책을 따르는 경우에는 발생하는 경고들을 직접 해결해야 할 수도 있습니다.

  3. 엔터프라이즈 시트는 몇 개가 필요합니까?

  4. 도구에 접근하고 매개변수를 조정할 권한을 원하는 아티스트들에 대해서만 시트가 필요합니다. 빌드 머신에는 라이선스가 필요하지 않습니다. 리소스 오류 - 프로젝트에 파일을 복사할 수 없습니다

  5. Perforce나 다른 버전 관리 소프트웨어를 사용 중이고 Dash를 열었을 때 리소스 업데이트 팝업이 표시되며 Resource Error가 발생하면 다음을 수행하세요:

  6. Dash 버전이 1.9.2 이상이면 5단계로 이동하세요.

  7. 언리얼을 종료하세요.

  8. PC 폴더 탐색기에서 다음 경로를 여세요: DASH_INSTALL_ROOT\Plugins\UnrealEngineContext\Imports\GN,

    1. 그런 다음 이 ContentUtils.py 파일을 다음 위치에서 제공되는 파일로 교체하세요:

    2. https://drive.google.com/drive/folders/129GZoD6borfOGJ4-sGD_VTAdVMtMgbKr?usp=sharing

    3. 그런 다음 언리얼을 열고 업데이트 팝업을 무시하세요. 즉, 업데이트를 클릭하지 말고 닫으세요.

    4. 그 다음 메인 Dash 메뉴를 통해 Dash 환경설정을 열고 Content Settings 섹션에 있는 새 "리소스 획득 건너뛰기(Skip Resource Acquisition)" 설정을 체크하세요.

    5. 다음 번에 Dash를 열 때 업데이트 팝업이 나타나지 않아야 합니다.

PreviousDash 1.7.0Next알파 컷

Last updated

Was this helpful?