개발 · 도구 다루기
빌드 버전 번호를 붙이는 간단한 규칙
테스터가 보스가 두 번 나오는 버그를 신고했는데, 그게 어제 빌드인지 오늘 아침 빌드인지 아무도 모른다면 버그를 고쳤는지 확인할 방법도 없습니다. 빌드 버전 번호는 지금 실행 중인 게임이 정확히 어떤 상태인지 가리키는 이름표입니다. 복잡한 체계 없이 작은 팀과 1인 개발자가 바로 쓸 수 있는 규칙을 순서대로 정리합니다.
작업 노트 444 · 읽는 시간 약 5분 · 2026.11.17 정리
버전 번호가 필요한 순간
버전 번호는 혼자 개발할 때는 필요 없어 보이지만, 빌드를 다른 사람에게 건네는 순간부터 꼭 필요해집니다. 친구에게 테스트를 부탁하거나, 수업에서 발표하거나, 전시에 출품하면 여러 빌드가 동시에 돌아다니게 됩니다. 이때 각 빌드를 구분할 이름이 없으면 받은 의견이 어떤 빌드에 대한 것인지 알 수 없습니다.
버그 추적에서도 핵심입니다. 이 버그는 몇 번 빌드에서 처음 생겼고, 몇 번 빌드에서 고쳐졌다는 기록이 있어야 같은 버그가 다시 나타났을 때 원인을 빨리 찾을 수 있습니다. 버전 번호 없이 날짜만으로 관리하면 같은 날 여러 번 만든 빌드를 구분하기 어렵습니다.
출시 후에는 플레이어와의 소통에도 쓰입니다. 업데이트 공지에 버전을 적고, 플레이어가 문제를 신고할 때 자기 게임의 버전을 알려 주면 개발자가 문제 상황을 훨씬 빠르게 재현할 수 있습니다. 게임 화면 구석이나 설정 메뉴에 버전을 표시해 두는 이유가 여기에 있습니다.
세 자리 번호 규칙의 뜻
널리 쓰이는 방식은 점으로 구분한 세 개의 숫자입니다. 예를 들어 1.4.2라면 첫 숫자는 큰 변화, 두 번째는 기능 추가, 세 번째는 작은 수정을 뜻하도록 정합니다. 소프트웨어 분야에서 쓰이는 시맨틱 버저닝이라는 규칙이 이 구조를 바탕으로 하며, 게임에서는 이를 팀 사정에 맞게 단순화해 쓰는 경우가 많습니다.
첫 숫자는 게임의 큰 단계가 바뀔 때 올립니다. 정식 출시 전에는 0으로 두고, 출시하는 순간 1로 올리는 방식이 흔합니다. 출시 후 대규모 확장이나 구조가 크게 바뀌는 업데이트가 있을 때 2로 올립니다. 이 숫자가 0이라는 것만으로도 아직 개발 중인 게임이라는 것을 알 수 있습니다.
두 번째 숫자는 새 기능이나 콘텐츠가 들어갈 때, 세 번째 숫자는 버그 수정이나 수치 조정처럼 작은 변경이 있을 때 올립니다. 두 번째 숫자를 올리면 세 번째 숫자는 0으로 돌아갑니다. 0.3.5에서 새 스테이지를 추가하면 0.4.0이 되는 식입니다. 이 규칙만 지켜도 번호를 보고 변경의 크기를 짐작할 수 있습니다.
개발 초기에는 이 규칙을 느슨하게 적용해도 괜찮습니다. 0으로 시작하는 기간에는 두 번째 숫자를 주요 개발 단계에 맞춰 올리는 팀도 있습니다. 프로토타입은 0.1, 알파는 0.5, 베타는 0.8처럼 정해 두면 숫자만 보고 지금 어느 단계인지 알 수 있습니다. 어떤 방식이든 팀 안에서 같은 뜻으로 쓰이기만 하면 충분합니다.

실제로 적용하는 순서
먼저 팀이 쓸 규칙을 한 장에 적습니다. 각 숫자를 언제 올리는지, 누가 올리는지, 어디에 기록하는지를 정합니다. 작은 팀이라면 빌드를 만드는 사람 한 명이 번호를 관리하는 것이 혼선이 적습니다. 규칙 문서는 팀원 모두가 볼 수 있는 곳에 둡니다.
다음으로 버전을 게임 안에 표시합니다. 타이틀 화면 구석이나 설정 화면에 작은 글씨로 버전을 띄우고, 엔진의 프로젝트 설정에 있는 버전 항목도 같이 맞춥니다. 표시 위치는 플레이에 방해가 되지 않으면서 테스터가 쉽게 확인할 수 있는 곳이 좋습니다. 버그 신고 양식에 버전 칸을 넣는 것도 잊지 않습니다.
빌드 파일 이름에도 버전을 넣습니다. 게임이름_0.4.0_win처럼 이름, 버전, 플랫폼을 붙이면 폴더에 여러 빌드가 쌓여도 구분이 쉽습니다. 마지막으로 변경 기록 문서를 만들어 버전마다 바뀐 내용을 몇 줄씩 남깁니다. 이 기록은 나중에 업데이트 공지의 초안이 됩니다.
버전 관리 도구를 쓴다면 빌드를 만든 시점의 코드에 같은 버전 이름으로 표시를 남겨 둡니다. 그러면 특정 빌드에서 생긴 문제를 조사할 때 그 시점의 코드로 정확히 돌아갈 수 있습니다.
자주 하는 실수
가장 흔한 실수는 번호를 올리지 않고 빌드를 다시 만드는 것입니다. 작은 수정이라 괜찮겠지 하고 같은 번호로 새 빌드를 배포하면, 같은 버전인데 동작이 다른 빌드가 두 개 생깁니다. 아무리 작은 변경이라도 다른 사람에게 건네는 빌드라면 세 번째 숫자는 올리는 것을 원칙으로 합니다.
번호를 의미 없이 크게 올리는 것도 혼란을 줍니다. 기분에 따라 0.2에서 0.9로 건너뛰면 번호가 진행 상황을 반영하지 못합니다. 또 1.9 다음은 2.0이 아니라 1.10이 될 수도 있다는 점을 팀원들이 모르면, 숫자 크기를 잘못 비교하는 일이 생깁니다. 점 사이의 숫자는 각각 따로 비교한다는 것을 공유해 둡니다.
내부 테스트용 빌드와 외부 배포용 빌드를 구분하지 않는 것도 실수입니다. 내부 빌드에는 디버그 기능이 켜져 있을 수 있어 외부로 나가면 안 됩니다. 내부 빌드에는 번호 뒤에 표시를 붙이는 등 구분 규칙을 정해 두면 실수로 잘못된 빌드를 보내는 일을 막을 수 있습니다.
버전을 바꿀 때마다 실행 확인을 하는 습관도 같이 들입니다. 새 번호를 붙인 빌드를 처음부터 끝까지 한 번 짧게 플레이해 보고, 화면에 표시된 버전이 파일 이름과 일치하는지 봅니다. 번호만 바꾸고 실행 확인을 건너뛰면 빌드 과정에서 빠진 파일이나 설정 문제를 늦게 발견하게 됩니다.

전시와 출시 때 버전 관리
전시에 출품할 때는 전시용 빌드의 버전을 따로 기록해 둡니다. 전시 현장에서 받은 의견과 버그를 그 버전에 묶어 정리하면, 전시 후 수정 작업이 체계적으로 진행됩니다. 전시 기간 중에 빌드를 바꿔야 한다면 바꾼 시점과 버전도 꼭 기록합니다.
버전 관리는 작은 습관이지만 팀 작업과 출시 준비의 기초가 됩니다. 내 프로젝트의 빌드 관리와 테스트 흐름을 어떻게 잡아야 할지 막막하다면, SBS아카데미게임학원 게임개발 과정 무료 상담에서 현재 빌드와 작업 방식을 보여 주고 출시까지의 순서를 함께 정해 보세요.
자주 묻는 질문
날짜를 버전 번호로 쓰면 안 되나요?
날짜 기반 번호도 쓸 수 있지만, 변경의 크기를 알기 어렵다는 단점이 있습니다. 내부 빌드는 날짜, 외부 배포는 세 자리 번호처럼 함께 쓰는 팀도 있습니다.
상점에 올릴 때도 같은 번호를 쓰나요?
플랫폼마다 버전 표기 방식이나 별도 빌드 번호 규칙이 있을 수 있어 해당 플랫폼 안내를 확인해야 합니다. 내부 번호와 플랫폼 번호의 대응표를 만들어 두면 편합니다.

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