개발 · 작업물 뜯어보기
인벤토리 데이터를 스크립터블 오브젝트로 관리하는 이유
RPG 인벤토리 화면을 열면 칸마다 아이콘, 이름, 개수가 보이고, 칸을 누르면 설명과 공격력이 뜹니다. 화면은 단순해 보여도 그 뒤에는 아이템 수백 종의 데이터가 있습니다. 이 데이터를 어디에 어떻게 담느냐에 따라 기획자가 수치를 고치는 속도와 버그의 양이 크게 달라집니다. 유니티에서 자주 쓰는 스크립터블 오브젝트 방식이 왜 이렇게 생겼는지 뜯어봅니다.
작업 노트 491 · 읽는 시간 약 5분 · 2026.11.17 정리
인벤토리 한 칸에 담긴 두 종류의 정보
인벤토리 칸을 자세히 보면 정보가 두 종류로 나뉩니다. 하나는 모든 플레이어에게 똑같은 정보입니다. 체력 물약의 이름, 아이콘, 설명, 회복량, 최대로 겹칠 수 있는 개수 같은 것입니다. 다른 하나는 지금 이 플레이어만의 정보입니다. 물약을 몇 개 가지고 있는지, 무기의 남은 내구도가 얼마인지, 어느 칸에 들어 있는지입니다.
앞의 것을 아이템 정의, 뒤의 것을 보유 상태라고 나눠 부르면 설계가 쉬워집니다. 정의는 게임을 만드는 동안 기획자가 정하고 플레이 중에는 바뀌지 않습니다. 보유 상태는 플레이할 때마다 계속 바뀌고, 저장과 불러오기의 대상이 됩니다. 두 정보를 한 덩어리로 묶으면 바뀌지 않아야 할 값이 실수로 바뀌는 문제가 생깁니다.
스크립터블 오브젝트는 이 중 정의를 담는 그릇으로 자주 쓰입니다. 씬 안의 게임오브젝트에 붙는 컴포넌트가 아니라, 프로젝트 창에 파일로 존재하는 데이터 자산입니다. 체력 물약 하나가 파일 하나가 되고, 인스펙터에서 이름과 아이콘, 수치를 입력해 두면 여러 곳에서 이 파일을 참조해 같은 정보를 꺼내 씁니다.
왜 프리팹이나 코드 안 숫자가 아니라 데이터 자산인가
처음 만들 때는 아이템마다 프리팹을 만들거나, 코드 안에 회복량 같은 숫자를 직접 적기 쉽습니다. 아이템이 다섯 개일 때는 문제가 없지만 수백 개가 되면 수치 하나를 고치기 위해 코드를 열고 다시 컴파일해야 합니다. 기획자가 직접 수정하기도 어렵고, 같은 숫자가 여러 군데 흩어져 있으면 한 곳만 고치고 나머지를 빠뜨리는 실수가 생깁니다.
데이터 자산으로 빼 두면 수치 조정이 인스펙터에서 끝납니다. 기획자는 프로젝트 창에서 물약 파일을 선택하고 회복량 칸만 바꾸면 되고, 그 파일을 참조하는 상점, 드롭 테이블, 인벤토리가 모두 같은 값을 보게 됩니다. 정보가 한 곳에만 있으니 고칠 곳도 한 곳뿐입니다. 이것이 이 구조를 쓰는 가장 큰 이유입니다.
메모리 측면의 이점도 있습니다. 같은 물약을 백 개 가지고 있어도 정의 데이터는 하나의 파일을 함께 가리킬 뿐 백 번 복사되지 않습니다. 각 칸은 어떤 정의를 가리키는지와 개수만 들고 있으면 됩니다. 아이템 종류가 많고 화면에 여러 번 표시되는 게임일수록 이 차이가 커집니다.

만드는 순서와 각 부품의 역할
- 아이템 정의 클래스를 만든다: 이름, 아이콘, 설명, 종류, 최대 겹침 개수 같은 공통 항목
- CreateAssetMenu 속성을 붙여 프로젝트 창의 생성 메뉴에서 바로 만들 수 있게 한다
- 아이템마다 정의 파일을 만들고 인스펙터에서 값을 채운다
- 인벤토리 칸 클래스는 정의 파일 참조와 개수만 갖게 한다
- UI는 칸 목록을 읽어 아이콘과 개수를 그린다
무기와 소비 아이템처럼 종류마다 필요한 항목이 다르면 공통 정의 클래스를 부모로 두고 자식 클래스로 나눕니다. 무기 정의에는 공격력과 공격 속도, 소비 아이템 정의에는 회복량을 더하는 식입니다. 인벤토리 코드는 공통 부모만 알면 되고, 사용 버튼을 눌렀을 때 실제 효과는 각 종류가 알아서 처리하게 하면 새 종류가 늘어나도 인벤토리 코드는 거의 바뀌지 않습니다.
UI와 데이터를 분리하는 것도 핵심입니다. 인벤토리 데이터가 바뀌면 신호를 보내고, UI는 그 신호를 받아 화면을 다시 그리게 합니다. 이렇게 해 두면 같은 데이터를 상점 화면, 장비창, 퀵슬롯이 각자 다른 모양으로 보여 줄 수 있고, 화면 디자인이 바뀌어도 데이터 코드는 건드리지 않습니다.
이 구조에서 자주 생기는 실수
가장 흔한 실수는 보유 상태를 정의 파일에 넣는 것입니다. 무기 정의에 현재 내구도를 넣으면, 같은 무기를 두 개 가진 경우 하나가 닳을 때 다른 하나도 함께 닳습니다. 둘이 같은 파일을 가리키기 때문입니다. 플레이 중에 바뀌는 값은 반드시 칸이나 보유 아이템 쪽 데이터에 둡니다.
두 번째는 에디터에서 테스트하며 정의 값을 코드로 바꾸는 경우입니다. 에디터에서 플레이 중에 데이터 자산의 값을 바꾸면 플레이를 멈춰도 그 변경이 파일에 남습니다. 테스트하다 회복량을 코드로 두 배로 바꿨다면 원래 값이 사라진 것입니다. 반대로 빌드된 게임에서는 이렇게 바꾼 값이 저장되지 않으므로, 저장 기능을 데이터 자산에 기대면 안 됩니다.
세 번째는 저장 방식입니다. 세이브 파일에 정의 파일 전체를 넣을 필요는 없고, 아이템을 구분할 수 있는 고유 번호와 개수, 내구도만 저장합니다. 불러올 때는 고유 번호로 정의 파일을 찾아 연결합니다. 그래서 정의마다 겹치지 않는 고유 번호를 두고, 이 번호를 나중에 바꾸지 않는다는 규칙을 처음부터 정해 둡니다.

작업물로 보여 줄 때 설명할 포인트
포트폴리오에서 인벤토리를 보여 준다면 화면 영상과 함께 데이터 구조 그림을 한 장 넣으세요. 정의 파일, 보유 칸, UI가 어떤 화살표로 연결되는지만 그려도 설계 의도가 전달됩니다. 아이템을 하나 새로 추가할 때 코드 수정 없이 파일 하나만 만들면 된다는 점을 짧은 영상으로 보여 주면 더 설득력이 있습니다.
설계하며 고민한 점도 적어 둡니다. 왜 내구도를 정의에서 뺐는지, 고유 번호를 어떻게 정했는지, 겹치는 아이템과 겹치지 않는 아이템을 어떻게 구분했는지 같은 내용입니다. 면접에서 이 구조를 다른 방식과 비교해 설명할 수 있으면, 기능을 만들 줄 아는 수준을 넘어 데이터를 설계할 줄 안다는 인상을 줍니다.
SBS아카데미게임학원 유니티 과정은 C# 문법에서 출발해 게임 오브젝트, 씬, 에셋 활용, UI 연동을 차례로 다루고 개인·팀 프로젝트로 마무리합니다. 인벤토리처럼 데이터가 많은 시스템을 프로젝트에 넣고 싶은데 구조를 어떻게 잡을지 막막하다면 무료 상담에서 만들고 싶은 게임을 설명하고 범위를 함께 정해 보세요.
자주 묻는 질문
아이템이 수천 개면 파일도 수천 개 만들어야 하나요?
그럴 수 있어서 규모가 큰 프로젝트는 표 형식 데이터 파일에서 값을 불러오는 방식을 함께 쓰기도 합니다. 개인 프로젝트 규모에서는 데이터 자산 방식으로 충분한 경우가 많습니다.
스크립터블 오브젝트는 인벤토리에만 쓰나요?
아닙니다. 적 능력치, 스킬 정보, 대사 데이터, 게임 설정값처럼 여러 곳에서 함께 쓰는 고정 데이터에 두루 활용됩니다.
확인한 자료
외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.
과정 보기 →