콘솔 변수 에디터

콘솔 변수 에디터로 프로젝트에서 쓰는 모든 콘솔 변수를 열람 및 수정하고, 프리셋을 통해 여러 프로젝트 간에 콘솔 변수 세팅을 공유합니다.

Choose your operating system:

Windows

macOS

Linux

콘솔 변수 에디터(Console Variables Editor) 는 프로젝트에 설정된 모든 콘솔 변수와 명령에 대한 정보를 표시하는 패널로, 모든 변수를 확인하고 수정할 수 있는 중심적인 위치를 제공합니다. 여러 프로젝트에 걸쳐 동일한 콘솔 변수 및 값을 사용하도록 프리셋을 생성할 수 있습니다. 콘솔 변수 에디터는 멀티 유저 세션에서 여러 컴퓨터 간의 변수 컨트롤도 지원합니다.

콘솔 변수 에디터 유저 인터페이스

또한 콘솔 변수 에디터 플러그인은 블루프린트 API도 추가합니다. 이 API는 콘솔 변수 에디터에서 생성된 콘솔 변수 프리셋에 액세스하고 이를 제어합니다. 자세한 내용은 블루프린트 API 레퍼런스(Blueprint API Reference)를 참조하세요.

콘솔 변수 에디터를 사용하려면 프로젝트에서 콘솔 변수 에디터 플러그인을 활성화해야 합니다. 프로젝트에서 플러그인을 활성화하는 단계에 대해서는 플러그인으로 작업하기 페이지를 참조하세요.

콘솔 변수 에디터 플러그인

메인 메뉴에서 창(Window) > 콘솔 변수(Console Variables) 를 선택하여 콘솔 변수 에디터를 엽니다. 이 패널은 언리얼 에디터에서 원하는 곳에 도킹할 수 있습니다.

메인 메뉴에서 콘솔 변수 에디터 열기

콘솔 변수 목록

이 목록에는 현재 트래킹된 콘솔 변수 및 실행된 명령이 포함되어 있습니다. 콘솔 변수 에디터를 처음 열면 추가된 콘솔 변수가 없는 빈 프리셋이 로드됩니다. 플러그인 세팅에서 변경된 모든 콘솔 변수를 현재 프리셋으로 추가(Add All Changed Console Variables to Current Preset)True 로 설정하면 목록에서 이미 있는 변수를 볼 수 있습니다. 콘솔 변수는 프로젝트 세팅을 통해 설정되는 경우가 많기 때문입니다.

콘솔 변수 및 명령을 목록에 추가하려면 (+) 콘솔 변수 추가(Add Console Variable) 를 클릭하고 입력 박스에서 명령 또는 변수를 검색합니다. 텍스트를 입력하면 텍스트 필드 아래에 일치하는 콘솔 변수 이름이 표시되지만 stat unit 등 콘솔 명령은 추천 목록에 표시되지 않을 수 있습니다.

입력한 콘솔 변수가 유효하다면 목록에 나타날 것입니다. 유효한 값을 지닌 콘솔 변수 또는 명령을 입력하면 해당 값으로 명령이 실행되고 콘솔 변수가 목록에 새 값으로 표시됩니다.

콘솔 변수 추가 버튼을 클릭하고 콘솔 명령 'stat unit' 입력

목록에 변수를 추가하면 현재 값은 프리셋 값(preset value) 으로 저장됩니다. 각 개별 변수를 시작 값으로 리셋하거나 행의 체크박스를 체크 해제하여 일시적으로 변경 사항을 되돌릴 수 있습니다.

값 변경을 보기 위해 행 체크 및 체크 해제

행 오른쪽으로 마우스 커서를 가져가서 제거(Remove) 를 클릭하여 목록에서 콘솔 변수를 제거할 수 있습니다. 목록에서 콘솔 변수를 제거할 때 그 값은 플러그인 로드 시의 값으로 리셋됩니다.

행에 커서를 가져가면 표시되는 콘솔 변수 제거 버튼

콘솔 변수로 마우스를 가져가면 각 항목에 대한 설명과 값의 의미를 보여주는 툴팁이 표시됩니다.

에디터에서 이름으로 커서를 가져가면 표시되는 콘솔 변수 툴팁

콘솔 변수 목록의 각 행에는 아래 테이블에 지정된 순서대로 셀 그룹이 있습니다. 각 열 헤더를 클릭하여 정렬 순서 번호(Sort Order Number), 콘솔 변수 이름(Console Variable Name), 소스(Source) 순으로 목록을 정렬할 수 있습니다.

설명

정렬 순서 번호

콘솔 변수가 목록에 표시되는 순서입니다. 이 열로 정렬하는 경우 행을 드래그 앤 드롭하여 순서를 변경할 수 있습니다.

다른 열을 기준으로 정렬하는 경우 정렬 순서 설정(Set Sort Order)을 클릭하여 목록의 정렬 순서가 일치하도록 업데이트할 수 있습니다. 자세한 내용은 표시 옵션을 참조하세요.

체크박스

행을 체크 해제하여 개별 콘솔 변수에 적용된 변경 사항을 일시적으로 비활성화할 수 있습니다. 체크를 해제하면 콘솔 변수의 값이 시작 시 플러그인이 로드될 때의 콘솔 변수 값으로 설정됩니다.

행을 다시 체크하면 값이 행 체크 해제 전에 마지막으로 캐시된 값으로 설정됩니다. 행이 체크 해제된 사이에 콘솔 변수에 적용된 변경 사항은 행을 다시 체크했을 때 반영되지 않습니다.

현재는 콘솔 변수만 토글 가능합니다.

콘솔 변수 이름

콘솔 변수의 이름을 표시합니다. 이름 위로 커서를 가져가면 콘솔 변수에 대한 도움말 텍스트가 있는 경우 표시됩니다.

편집 가능한 콘솔 변수 필드입니다. 변수 또는 명령 타입과 일치합니다.

값 필드를 변경하면 콘솔 명령 또는 변수가 실행됩니다. 멀티 유저가 활성화되면 멀티 유저 세션의 사용자는 이 변수를 업데이트된 값으로 설정하거나 명령을 해당 사용자의 로컬 머신에서 실행되게 합니다.

변수 값 위로 커서를 가져가면 다음 세 가지 값이 표시됩니다.

  • 커스텀 값

  • 프리셋 값

  • 시작 값

변수의 현재 값이 프리셋 값과 다르다면 값 위젯 옆에 값 리셋 옵션이 표시됩니다. 리셋(Reset) 을 클릭하면 변수가 프리셋 값으로 다시 설정됩니다.

소스

변수 설정에 사용된 마지막 방법을 나타냅니다. 마지막 방법이 콘솔 변수 에디터를 통하는 것이었다면 소스 타입은 콘솔입니다.

표시 옵션

표시 옵션(Show Options) 을 클릭하여 목록에서 어떤 행이 표시될지 커스터마이징합니다. 각 옵션에 대한 설명은 아래 표를 참고하세요.

표시 옵션 드롭다운

옵션

설명

표시

생성자 표시(Show Constructor)

활성화되면 코드의 디폴트 생성자에서 설정된 콘솔 값을 표시합니다. 즉 엔진 클래스가 시작되고 콘솔 변수를 설정하는 경우입니다.

엔진 퀄리티 표시(Show Scalability)

활성화되면 엔진 퀄리티 옵션에서 설정된 콘솔 변수를 표시합니다.

게임 세팅 표시(Show Game Setting)

활성화되면 UGameUserSettings(config=GameUserSettings) 에서 설정된 콘솔 변수를 표시합니다.

프로젝트 세팅 표시(Show Project Setting)

활성화되면 프로젝트 세팅에서 설정된 콘솔 변수를 표시합니다.

시스템 세팅 ini 표시(Show System Settings ini)

활성화되면 시스템 세팅에서 설정된 콘솔 변수를 표시합니다.

디바이스 프로파일 표시(Show Device Profile)

활성화되면 디바이스 프로파일에서 설정된 콘솔 변수를 표시합니다.

게임 오버라이드 표시(Show Game Override)

활성화되면 게임 내 오버라이드에 의해 설정된 콘솔 변수를 표시합니다. 여기에는 제대로 실행되려면 특정 값이 필요한 플랫폼 등이 있습니다.

콘솔 변수 ini 표시(Show Console Variables ini)

활성화되면 Engine/Config/ConsoleVariables.ini 의 [Startup] 섹션에 설정된 콘솔 변수를 표시합니다.

명령줄 표시(Show Command line)

활성화되면 명령줄 실행인자에 설정된 콘솔 변수를 표시합니다.

코드 표시(Show Code)

활성화되면 생성자 밖의 소스 코드, 보통 플러그인에 설정된 콘솔 변수를 표시합니다.

콘솔 표시(Show Console)

활성화되면 블루프린트, CMD 입력 또는 콘솔 변수 에디터에서 설정된 콘솔 변수를 표시합니다.

변경된 항목만 표시(Show Only Modified)

활성화되면 현재 값이 프리셋 값과 다른 콘솔 변수를 모두 표시합니다.

정렬(Sort)

정렬 순서 설정(Set Sort Order)

선택하면 콘솔 변수 목록의 현재 순서가 저장됩니다.

옵션(Options)

모든 변수 변경 사항 추적(Track All Variable Changes)

이 옵션은 플러그인 세팅의 '변경된 모든 콘솔 변수를 현재 프리셋으로 추가' 옵션과 동일합니다.

검색

검색에는 프리셋 검색과 글로벌 검색 두 가지 타입이 있습니다. 입력하는 모든 텍스트는 검색 토큰이 됩니다. 파이프 문자(|)는 텍스트를 OR 토큰으로 나누며, 공백은 텍스트를 AND 토큰으로 결합합니다.

예를 들어 입력한 텍스트가 'lumen|screen percentage'인 경우, 검색 토큰은 'lumen'과 'screen percentage'입니다. 이 검색은 'lumen'을 포함하거나 'screen'과 'percentage'를 동시에 포함하는 결과를 반환합니다.

프리셋 검색

프리셋 검색은 검색 시의 디폴트 옵션입니다. 프리셋에 있는 콘솔 변수 중에 이름, 소스, 도움말 텍스트가 검색 토큰과 일치하지 않는 변수는 목록에서 필터링됩니다.

프리셋 검색 예시

글로벌 검색

검색 창에 텍스트를 입력한 뒤 모두 검색(Search All) 을 클릭하여 글로벌 검색을 활성화합니다. 이름 이 검색 토큰과 일치하는 모든 언리얼 엔진의 콘솔 변수가 목록에 나타납니다. 입력한 검색 토큰은 검색 필드 아래에 나타납니다. 일치하는 변수는 목록에 행으로 표시되며 프리셋의 행처럼 조작할 수 있습니다.

글로벌 검색 예시

검색 토큰을 클릭하여 켜거나 꺼서 토글합니다.

글로벌 검색에서 검색 토큰 켜짐/꺼짐

토큰을 개별적으로 제거하려면 토큰을 우클릭 또는 ctrl+클릭 합니다.

글로벌 검색에서 검색 토큰 제거

제거(Remove) 를 눌러 모든 검색 토큰을 제거하고 프리셋 검색으로 되돌립니다.

검색 토큰을 모두 제거하고 프리셋 검색으로 되돌리는 제거 버튼 하이라이트

글로벌 검색 목록의 콘솔 변수를 프리셋에 추가할 수 있습니다. 행으로 커서를 가져가서 CVAR 추가(Add CVAR) 를 클릭합니다. 모든 변수 변경 사항 트래킹을 활성화하면 이 뷰에서 변경하는 변수는 현재 프리셋에도 추가됩니다.

프리셋에 콘솔 변수 추가

프리셋

프리셋 패널을 열어서 프리셋을 저장 및 로드합니다. 프리셋을 로드할 때 현재 목록에 있는 모든 변수는 목록에서 제거되지만, 값은 영향을 받지 않습니다. 새로 로드된 프리셋의 모든 변수는 행이 체크 해제되지 않는 한 저장된 값으로 설정됩니다.

프리셋 패널

멀티 유저

프로젝트에서 멀티 유저 플러그인을 활성화한 경우 멀티 유저 옵션이 콘솔 변수 에디터에 나타나며 변수 변경 사항 및 명령 호출을 세션 내 다른 사용자에게 전파할 것인지 선택할 수 있습니다.

멀티 유저 컨트롤을 클릭하면 콘솔 변수 에디터 하단에 멀티 유저 세팅이 표시됩니다. 개별 세션 멤버에 대한 콘솔 변수 동기화를 이 제어 패널에서 활성화 또는 비활성화할 수 있습니다.

세션 내의 멀티 유저가 있는 멀티 유저 옵션 표시

플러그인 세팅

프로젝트 세팅(Project Setting) > 플러그인(Plugins) > 콘솔 변수 에디터 의 플러그인 세팅에서 콘솔 변수 에디터 함수 기능 및 디스플레이를 커스터마이징할 수 있습니다. 아래 표에서는 모든 플러그인 세팅에 대해 설명합니다.

콘솔 변수 에디터 플러그인 세팅

세팅

설명

체크 해제된 행 디스플레이 타입(Unchecked Row Display Type)

체크 해제된 행의 값 입력에서 값이 어떻게 표시될지 결정합니다. 다음은 체크 해제된 행의 디스플레이 옵션입니다.

  • 현재 값 표시(Show Current Value)

  • 마지막으로 입력된 값 표시(Show Last Entered Value)

변경된 모든 콘솔 변수를 현재 프리셋에 추가

활성화되면 콘솔 변수 에디터 외부에서 변경된 콘솔 변수가 목록에 추가됩니다. 이 방법으로는 콘솔 변수만 트래킹되며 명령은 콘솔 변수 에디터 외부에서 입력할 때 추가되지 않습니다.

변경된 콘솔 변수 스킵 목록(Changed Console Variable Skip List)

'변경된 모든 콘솔 변수를 현재 프리셋에 추가'가 활성화된 경우, 이 목록에 있는 콘솔 변수는 콘솔 변수 에디터 외부에서 변경될 때 필터링됩니다.