“날짜만 바꾸면 끝?” 게임 프로그래밍 겨울 이벤트의 시간 설계
겨울 이벤트가 하루 먼저 열리는 이유
12월 출석 선물을 준비했는데 누군가는 11월 마지막 밤에 보상을 받고, 다른 이용자는 자정이 지나도 잠긴 화면을 봅니다. 겨울 업데이트의 게임 프로그래밍에서는 눈송이 연출보다 먼저, 누구의 시계로 문을 열 것인지 결정해야 합니다.
달력의 날짜를 실행 규칙으로 바꿉니다
11월 하순에는 연말 이벤트의 시작과 종료를 함께 설계합니다. 예를 들어 한국 시각 기준 2026년 12월 1일 00시에 시작한다면, 같은 순간의 UTC 값은 11월 30일 15시입니다. 설정에는 날짜만 적지 말고 시간대까지 명시하고, 판정에 사용하는 값과 이용자에게 보여 주는 문구를 분리합니다.
- 전 세계 동시 시작: 하나의 시작 순간을 공유하고 화면의 시간만 지역에 맞춰 표시합니다. 해외 이용자에게는 현지 날짜가 다르게 보일 수 있으므로 공지에 기준 시간대를 적습니다.
- 지역별 자정 시작: 지역마다 시작 순간이 달라지는 별도 정책입니다. 기기 설정 변경만으로 참여 지역이 바뀌지 않도록 계정의 지역 기준과 변경 가능 시점을 정해야 합니다.
- 접속 후 일정 시간: 첫 접속부터 24시간 동안 진행하는 개인 이벤트는 공통 달력 이벤트와 다릅니다. 첫 참여 시각을 기록하고 재접속 때 시작점을 다시 만들지 않습니다.
기획 문장에 숨어 있는 빈칸을 찾습니다
“크리스마스까지 받을 수 있습니다”라는 문장만으로는 25일 시작에 닫히는지, 그날이 끝날 때 닫히는지 알 수 없습니다. 역할 구분은 기획자에 관한 지식백과 항목을 참고하고, 개발 문서에는 참여 종료와 보상 수령 종료를 각각 적습니다.
이벤트 공지를 읽은 두 사람이 같은 종료 시각을 적을 수 있어야 합니다. 구현에 들어가기 전에 문장의 모호함부터 없애세요.
시작과 끝을 포함하는 방식부터 고정합니다
끝나는 순간은 다음 상태에 맡깁니다
기간 판정은 시작 시각 이상, 종료 시각 미만으로 설계하면 경계를 다루기 쉽습니다. 종료를 12월 26일 00시로 잡으면 25일 전체를 포함하면서, 26일 00시부터는 종료 상태가 됩니다. “23시 59분 59초까지”라고 구현할 때 생기는 더 작은 시간 단위의 빈틈도 피할 수 있습니다.
| 입력 시각 | 예상 상태 | 확인할 동작 |
|---|---|---|
| 12월 1일 00시 직전 | 시작 전 | 참여 버튼 비활성 |
| 12월 1일 00시 정각 | 진행 중 | 참여 조건 확인 후 허용 |
| 12월 26일 00시 직전 | 진행 중 | 마지막 유효 요청 처리 |
| 12월 26일 00시 정각 | 참여 종료 | 새 참여 요청 거절 |
여기서 “직전”은 프로그램이 지원하는 최소 시간 단위 이전을 뜻합니다. 화면의 남은 시간이 0초로 보이는 순간과 실제 판정은 표시 반올림 때문에 어긋날 수 있으므로, 버튼 표시와 최종 처리에서 같은 기간 규칙을 사용합니다. 클릭 시각과 요청 도착 시각 중 무엇을 기준으로 삼는지도 문서에 남깁니다.
현재 시각을 바깥에서 받는 작은 함수를 만듭니다
판정 함수를 “현재 시각, 시작 시각, 종료 시각을 받아 상태를 반환하는 함수”로 만들면 운영체제 날짜를 바꾸지 않고도 시험할 수 있습니다. 날짜 형식을 해석하는 일은 입력 단계에 두고 판정에는 같은 기준으로 변환한 값만 전달합니다. 구간 연산처럼 경계 조건을 명시하는 습관이 게임 이벤트에도 도움이 됩니다.
- 입력 검증: 시작이 종료보다 늦거나 두 값이 같은 설정은 등록 단계에서 거절합니다. 잘못된 형식과 시간대 누락을 조용히 기본값으로 바꾸지 말고 원인을 표시합니다.
- 정확한 경계 시험: 시작 직전·정각·직후, 종료 직전·정각·직후의 여섯 경우를 고정합니다. 연말을 넘기는 이벤트라면 12월 31일과 다음 해 1월 1일도 별도로 확인합니다.
- 표시와 정책 분리: “3분 남음”이라는 문자열로 참여 가능 여부를 계산하지 않습니다. 상태와 남은 시간 값을 먼저 구한 뒤 안내 문구를 만들면 번역을 바꿔도 규칙은 유지됩니다.
종료 뒤에도 보상 처리는 계속될 수 있습니다
참여 종료와 수령 종료를 나눕니다
퇴근길에 미션을 완료하고 집에서 보상을 받으려는 이용자를 떠올려 보세요. 참여 기간이 끝났다는 이유로 이미 달성한 보상까지 사라지게 할 것인지 먼저 결정해야 합니다. 예시 정책으로 참여는 25일까지, 달성 보상 수령은 28일까지 허용한다면 시작 전·진행 중·수령만 가능·완전 종료라는 네 상태를 둡니다.
- 진행 중: 미션 진행과 보상 수령을 모두 허용하되, 달성 여부와 기존 수령 기록을 따로 확인합니다. 진행률 100%라는 화면 표시만으로 지급을 확정하지 않습니다.
- 수령만 가능: 새 진행도를 쌓는 요청은 막고 종료 전에 달성한 보상만 처리합니다. 달성 시점의 증거가 필요하므로 종료 후 현재 진행도만 보고 자격을 추측하지 않습니다.
- 완전 종료: 수령 버튼은 닫되 이미 얻은 아이템과 지급 기록은 유지합니다. 이벤트 화면을 숨기는 작업과 소유 아이템을 삭제하는 작업을 같은 처리에 묶지 않습니다.
재접속과 중복 클릭을 정상 경로로 취급합니다
보상 버튼을 두 번 누르거나 응답을 받기 전에 연결이 끊겨도 지급은 한 번이어야 합니다. 계정·이벤트·보상 항목을 묶은 식별자로 수령 기록을 관리하고, 중복 확인과 지급 기록·재화 반영이 함께 성공하도록 구성합니다. 매일 받는 보상이라면 날짜별 회차도 식별자에 포함해야 다음 날의 정상 수령이 중복으로 차단되지 않습니다.
온라인 게임에서는 신뢰하는 서버가 시간과 지급 자격을 최종 판정하도록 설계합니다. 서버가 없는 개인 프로젝트라면 기기 시각 변경을 완전히 막는다고 약속하기보다, 경쟁 순위나 거래 가능한 보상을 제외하는 식으로 범위를 정할 수 있습니다. 잠든 노트북을 깨우거나 앱으로 복귀했을 때는 남은 숫자를 이어 세기 전에 현재 상태부터 다시 계산합니다.
종료된 이벤트의 화면을 다시 여는 시험도 해보세요. 화면은 남아 있어도 새 참여는 막히고, 이미 획득한 아이템은 그대로 있어야 합니다.
주말 8시간이면 겨울 이벤트 한 개에 집중합니다
이미 있는 기능과 새로 만드는 기능을 나눕니다
아래 시간은 로그인·저장·보상 지급 기능이 이미 있는 작은 프로젝트에 이벤트 하나를 붙이는 작업 배분 예시입니다. 서버나 계정 시스템을 처음 만드는 일정까지 포함한 견적은 아닙니다. 목표와 예산을 함께 생각할 때 살펴볼 용어로 계획예산 제도가 있으며, 작업표에는 기능별 예상 시간을 기록합니다.
- 정책 작성 1시간: 기준 시간대, 참여 기간, 수령 유예 기간을 결정합니다. 안내 문구와 내부 설정이 같은 순간을 가리키는지 확인하고 변경 책임자도 정합니다.
- 설정과 판정 구현 2시간: 날짜를 코드 곳곳에 넣지 않고 이벤트 설정 한곳에 모읍니다. 잘못된 기간은 활성화되지 않게 하고, 긴급 비활성화 설정도 준비합니다.
- 화면 연결 2시간: 네 상태의 버튼과 안내 문구를 연결합니다. 좁은 화면에서 종료 날짜가 잘리지 않는지 확인하고, 색상 외에 문구로도 상태를 전달합니다.
- 시험 2시간과 예비 1시간: 경계 여섯 경우에 중복 요청, 재접속, 지급 도중 실패를 더합니다. 예비 시간에는 발견된 문제를 고치고 같은 입력으로 다시 시험합니다.
예비 시간을 넘으면 효과보다 범위를 줄입니다
시험에서 보상 중복이 발견됐다면 눈 내리는 배경을 추가할 시간을 지급 처리에 돌립니다. 설정을 끄는 조치와 잘못 지급한 보상을 복구하는 조치는 다르므로, 비활성화만으로 모든 문제가 해결된다고 가정하지 않습니다. 개발자 포트폴리오에는 화려한 화면 외에도 경계 시험 입력과 기대 상태를 짧게 남길 수 있습니다.
이 예시의 총량은 8시간, 이벤트 1개, 상태 4개, 필수 경계 시험 6개입니다. 보유 도구와 기존 리소스만 쓰면 신규 에셋 구매 예산은 0원으로 잡을 수 있지만, 작업 시간과 기존 서버 운영비는 별도입니다. 남은 시간이 2시간뿐이라면 보상 없는 기간 한정 테마로 축소하고, 30분은 켜기·끄기와 원래 화면 복귀 시험에 배정합니다.

- 이전글게임 프로그래밍, 키보드와 게임패드 로직을 나눌 필요 없다 26.11.22
- 다음글게임 프로그래밍 저장 오류, 파일 형식부터 바꿀 필요 없다 26.11.20
등록된 댓글이 없습니다.
