GUI 매뉴얼 · Chapter 32

Global Constant Editor

Global Constant Editor 는 프로젝트 전역에서 사용하는 명명 상수(Global Constant)를 한곳에서 정의·관리 하는 카탈로그형 에디터입니다. 자주 쓰는 고정값을 의미 있는 이름으로 등록해 두면, 스크립트와 화면에서 숫자를 직접 적는 대신 이름으로 참조할 수 있어 매직넘버를 줄일 수 있습니다. 진입 경로는 Project → Global Constant Editor 이며, 툴바의 Constant Value Editor 로도 열 수 있습니다.

상수를 한 항목씩 추가하고 이름·값·설명을 입력해 두는 목록형 편집 방식입니다. 이런 카탈로그 편집 패턴은 Message Editor 와 유사하므로, 항목을 추가·정리하는 방식은 그쪽과 비슷하게 다루면 됩니다.

무엇을 정의하는가

이 에디터의 한 항목은 하나의 전역 상수에 해당합니다. 일반적으로 다음과 같은 정보를 항목으로 관리합니다.

  • 상수 이름: 스크립트·화면에서 참조할 때 사용하는 식별자입니다.
  • 상수 값: 이름에 대응하는 고정값입니다.
  • 설명: 해당 상수의 용도를 적어 두는 보조 정보입니다.

값을 바꿀 일이 있는 고정 수치(대기 시간, 반복 횟수, 임계값 등)를 상수로 등록하면, 여러 곳에 흩어진 숫자를 일일이 찾아 고치지 않고 이 에디터의 값 한 곳만 바꿔 일괄 반영할 수 있습니다.

사용 흐름

상세 UI 라벨은 버전에 따라 다를 수 있으므로, 여기서는 정의에서 적용까지의 일반적인 흐름만 설명합니다.

  1. Project → Global Constant Editor 로 에디터를 엽니다.
  2. 새 상수 항목을 추가하고 이름·값·설명을 입력합니다.
  3. 같은 이름이 중복되지 않도록 의미가 분명한 이름을 사용합니다.
  4. 편집 내용을 저장하면 프로젝트 전역에서 그 이름으로 값을 참조할 수 있습니다.
  5. 스크립트나 화면에서 숫자를 직접 적는 대신 등록한 상수 이름으로 참조해 매직넘버를 제거합니다.

활용 지침

상수는 "여러 곳에서 같은 값을 쓰는 경우" 또는 "추후 한 번에 바꿀 가능성이 있는 값"에 적용할 때 효과가 큽니다. 반대로 한 곳에서만 쓰는 일회성 값까지 모두 상수로 만들 필요는 없습니다.

이름은 값이 무엇을 뜻하는지 드러내도록 정합니다. 의미가 분명한 이름을 쓰면 스크립트를 읽을 때 숫자의 배경을 따로 설명하지 않아도 의도가 전달됩니다.

관련 항목