Unity UI Toolkit을 활용한 Custom Package 만들기 (1)
TL;DR (세 줄 요약)
- UI Toolkit은 Unity가 만든 UI 시스템입니다. 화면의 구조(UXML), 모양(USS), 동작(C#)을 서로 다른 파일에 나누어 적습니다.
- 두 사람이 약 두 달 동안 ReInput이라는 패키지를 만들었습니다. ReInput은 게임 입력을 파일로 저장하고 다시 재생합니다.
- 저는 UI Toolkit으로 Editor Window를 만드는 일을 맡았습니다. 시작할 때 규칙 네 가지와 역할을 정해 둔 것이 진행에 도움이 됐습니다.
이 글은 Unity의 UI Toolkit으로 Custom Package를 만든 사이드 프로젝트 회고의 첫 번째 글입니다. 프로젝트를 시작한 계기, 목표, 역할 분담을 순서대로 적습니다.
1. 이 글은 어떤 글인가요?
글또 8기 3회차 글입니다. 글또는 개발자들이 함께 글을 쓰는 모임입니다.
사이드 프로젝트는 회사 일이나 학교 수업과 따로, 개인 시간에 하는 프로젝트입니다. 회고는 끝난 일을 돌아보며 한 일과 배운 점을 적는 글입니다. 이 회고는 세 편으로 나누어 씁니다.
| 편 | 다루는 내용 |
| 1편 (이 글) | 프로젝트를 시작한 계기, 목표, 역할 |
| 2편 | 진행 순서와 문제를 고친 과정 |
| 3편 | 기술적으로 배운 점 |
2. 왜 이 프로젝트를 시작했나요?
브릿지(BRIDGE-DEV)라는 대학생 연합 게임 개발 동아리에 모집 글이 하나 올라왔습니다. UI Toolkit으로 Unity의 Custom Package를 만들고, 패키지 매니저로 배포해 보자는 내용이었습니다.
낯선 단어를 먼저 풀어 둡니다.
- Unity: 게임을 만드는 프로그램(게임 엔진)입니다.
- Custom Package: 여러 Unity 프로젝트에서 다시 쓸 수 있도록 코드와 파일을 묶은 것입니다.
- 패키지 매니저(Package Manager): Unity 안에서 패키지를 설치하고 지우는 창입니다.
글을 쓴 분의 실력이 좋다는 이야기를 이미 들었습니다. 주제도 제가 관심 있던 것이었습니다. 그래서 글을 보자마자 토론 글에 댓글을 달았습니다.
모집 글: Unity Custom Editor 스터디 모집 (BRIDGE-DEV Discussion #4)
같은 시기에 Unity에서는 무엇이 바뀌었나요?
이 글을 쓴 2023년 기준으로 Unity는 1년에 세 번 새 버전을 냈습니다.
- Tech Stream: 새 기능을 먼저 넣어 보는 버전입니다. 1년에 두 번 나왔습니다.
- LTS(Long Term Support): 안정성을 우선하는 버전입니다. 1년에 한 번 나왔습니다.
회사에서는 보통 LTS를 씁니다. 2021 LTS(버전 번호 2021.3)는 2022년 4월에 나왔습니다. 이 LTS부터 UI Toolkit을 게임 실행 화면에서도 쓸 수 있게 됐습니다. 저는 LTS가 나오면 무엇이 바뀌었는지 확인합니다.
Unity 6부터는 버전 이름을 붙이는 방식이 바뀌었습니다. 위 설명은 2023년 당시 기준입니다.
3. UI Toolkit은 무엇인가요?
UI(User Interface)는 버튼, 글자, 창처럼 사용자가 보고 누르는 화면 요소입니다. UI Toolkit은 Unity가 직접 만든 새 UI 시스템입니다. 공식 소개 글과 발표 영상을 아래에 남깁니다.
UI 툴킷에서 새롭게 선보이는 기능 | Unity Blog
UI 툴킷에서 직접 테두리 라운딩, 색상, 크기, 텍스트를 설정하여 텍스처리스 UI를 생성하세요. Photoshop에서 이미지를 생성하거나 임포트할 필요가 없으므로 도구 전환으로 낭비되는 시간을 크게
blog.unity.com
구조, 모양, 동작을 어떻게 세 파일로 나누나요?
UI Toolkit은 화면 하나를 세 종류의 파일로 나누어 만듭니다. 웹 페이지를 만들 때 HTML, CSS, JavaScript로 일을 나누는 것과 같은 방식입니다.
| 파일 | 적는 내용 | 웹에서 같은 역할을 하는 것 |
| UXML | 화면에 무엇이 어떤 순서로 놓이는지 | HTML |
| USS | 글자 크기, 색, 여백처럼 보이는 모양 | CSS |
| C# 스크립트 | 버튼을 눌렀을 때 일어나는 일 | JavaScript |
이렇게 나누면 모양만 바꿀 때는 USS 파일만 고치면 됩니다.
UGUI와 무엇이 다른가요?
UGUI(Unity UI)는 UI Toolkit보다 먼저 나온 Unity의 UI 시스템입니다. UGUI는 버튼이나 글자 같은 화면 요소 하나하나를 GameObject로 만듭니다. GameObject는 Unity 장면(Scene)에 놓이는 물체의 기본 단위입니다. 이 요소들은 Canvas라는 컴포넌트 아래에 놓여 함께 그려집니다.
UI Toolkit은 화면 요소를 GameObject로 만들지 않습니다. UXML 문서에 적힌 구조를 읽어서 화면을 만듭니다.
Unity 공식 문서는 복잡한 에디터 도구를 만들 때 UI Toolkit을 권장합니다. 문서가 드는 이유는 세 가지입니다. 다시 쓰기 쉽습니다. 눈으로 보며 편집하는 도구가 있습니다. 코드 유지보수와 성능 면에서 규모를 키우기 좋습니다.
UI Toolkit은 에디터 화면과 게임 실행 화면 양쪽에서 쓸 수 있습니다. 에디터는 게임을 만들 때 쓰는 Unity 프로그램의 화면입니다. 저는 웹에서 화면을 만들던 사람이 Unity를 쓰는 회사로 옮겨 게임 UI를 만드는 일도 늘 것이라고 예상했습니다.
4. ReInput은 어떤 패키지인가요?
ReInput은 게임을 실행하는 동안 들어온 입력을 파일로 저장하고, 나중에 그 입력을 다시 재생하는 패키지입니다. 입력은 키보드를 누르거나 마우스를 움직이는 것처럼 사용자가 게임에 보내는 신호입니다.
프로젝트는 저를 포함한 두 사람이 약 두 달 동안 진행했습니다. 메인 기능이 끝난 뒤에는 패키지로 배포하기 위한 정리 작업을 했습니다.
첫 회의는 디스코드로 했습니다. 간단히 인사하고 큰 방향만 정했습니다. 다음 주에는 광화문 근처에서 저녁을 먹으며 세부 내용을 정했습니다.


회의에서 어떤 규칙을 정했나요?
- 최소 목표를 먼저 끝내고, 그 뒤에 목표를 늘립니다.
- 기간은 2월 말까지, 약 두 달로 정합니다.
- 입력 장치는 키보드와 마우스만 다룹니다.
- 매주 비대면 회의로 진행 상황을 확인합니다.
직접 만나서 이야기한 것이 도움이 됐습니다. 프로젝트는 대부분 온라인으로 진행할 수 있습니다. 하지만 시작할 때 서로의 말투와 반응을 알아 두면 그 뒤의 온라인 대화에서 오해가 줄어듭니다. 코로나19 이후 직접 만나는 일이 줄었습니다. 그래도 처음에 한 번 만나는 것이 협업 속도를 높인다고 느꼈습니다.
역할은 어떻게 나누고 이름은 어떻게 정했나요?
| 맡은 사람 | 맡은 일 |
| 함께한 분 | 게임을 실행할 때 키 입력을 감지해 파일로 저장하고 읽는 시스템, 패키지 배포 |
| 저 | UI Toolkit으로 Editor Window 만들기 |
Editor Window는 Unity 에디터 안에서 열리는 창입니다. 패키지 이름은 다시를 뜻하는 Re와 핵심 개념인 Input(입력)을 붙여 ReInput으로 정했습니다.
5. 다음 글에서는 무엇을 다루나요?
이번 글에서는 계기, 목표, 역할까지 정리했습니다. 다음 글에서는 진행 순서와, 문제가 생겼을 때 원인을 찾아 고친 과정을 적습니다. 그다음 글에서는 기술적으로 배운 점과 개인적으로 느낀 점을 나누어 적습니다.
자주 묻는 질문 (FAQ)
Q1. UI Toolkit은 UGUI를 완전히 대체하나요?
아직은 아닙니다. Unity 6.3 공식 문서는 게임 실행 화면에는 UGUI를 권장하고 UI Toolkit을 대안으로 안내합니다. 에디터 화면에는 UI Toolkit을 권장합니다. 두 시스템은 한 프로젝트에서 함께 쓸 수 있습니다. UGUI로 이미 만든 화면은 그대로 두는 경우가 많습니다.
Q2. Custom Package란 무엇인가요?
Unity 프로젝트 사이에서 다시 쓸 코드와 파일을 묶은 단위입니다. Package Manager에 등록하면 다른 프로젝트에서 이름과 버전을 지정해 설치할 수 있습니다. 이 프로젝트에서는 ReInput을 그런 형태로 배포하는 것이 목표였습니다.
Q3. 프로젝트에 대면 회의가 꼭 필요했나요?
필수는 아니었습니다. 다만 세부 내용을 직접 만나서 정했기 때문에 목표와 역할을 빠르게 맞출 수 있었습니다. 그 뒤에는 매주 온라인 회의로 충분했습니다.
수정 안내
이 글은 2026년 11월 21일에 다시 썼습니다. 이전 판의 "UGUI는 느려지고 UI Toolkit은 바뀐 부분만 다시 계산한다"는 성능 비교는 측정 근거를 확인할 수 없어 삭제하고, 공식 문서의 권장 기준으로 바꿨습니다. "2021 LTS에서 UI Toolkit 1.0 정식 버전이 나왔다"는 표현은 "게임 실행 화면에서도 쓸 수 있게 됐다"로 고쳤습니다. 2021 LTS가 나온 때는 2022년 4월로 바로잡았습니다. 모집 글 미리보기에 있던 다른 분의 이름은 지우고 링크만 남겼습니다.
참고 자료
- Unity 매뉴얼: UI Toolkit
- Unity 매뉴얼: Comparison of UI systems in Unity
- Unity 블로그: Introducing Unity 2021 LTS
같은 주제의 다른 글: Unity UI Toolkit을 활용한 Custom Package 만들기 (2), Unity UI Toolkit을 활용한 Custom Package 만들기 (3)