홈 › 제이월드 블로그

계정 없이 저장하기: 제이월드 게임이 진행 상황을 기기에 지키는 방법

제이월드 팀 ·

로그인 없이도 진행이 사라지지 않게 하려고 제이월드 팀이 쓰는 저장 규칙을 정리했어요. 저장 형식, 버전 번호, 깨진 저장 복구, 기기 사이 옮기기까지 담았어요.

제이월드 게임은 대부분 회원가입도 로그인도 없이 바로 시작해요. 그런데 방치형 게임은 며칠씩 쌓은 진행이 전부예요. 저장이 한 번 날아가면 플레이어는 다시 돌아오지 않아요.

계정이 없으면 서버에 맡길 수도 없어요. 그래서 진행은 기기 안에 저장하고, 그 저장이 절대 망가지지 않게 규칙을 여러 겹 둬요. 이 글은 그 규칙을 정리한 개발 노트예요. 내용은 도깨비 주막과 한성부 사건일지의 저장 코드, 그리고 GAME_DEV_PLAYBOOK.md에서 가져왔어요.

저장은 JSON 한 덩어리예요

도깨비 주막의 저장은 이런 모양이에요.

`` { "v": 7, "savedAt": 1763500000000, "state": { ... } } ``

  • v는 저장 형식의 버전 번호예요. 지금 주막은 7이에요.
  • savedAt은 저장한 시각이에요. 자리를 비운 동안의 수익을 계산할 때 써요.
  • state는 게임 상태 전부예요.

게임 규칙 코드는 화면과 저장소를 몰라요. 상태를 글자로 바꾸고(serialize) 글자를 상태로 읽는(readSave) 함수만 따로 있어요. 그래서 저장소가 브라우저든 앱이든 같은 코드를 써요.

읽을 때는 절대 믿지 않아요

저장 글자는 언제든 이상해질 수 있어요. 오래된 빌드가 썼을 수도 있고, 중간에 잘렸을 수도 있어요. 그래서 읽을 때 모든 값을 검사해요.

이런 값을 만나면이렇게 처리해요
숫자가 아니거나 음수새 게임의 기본값으로 바꿔요
모르는 음식·손님 id버려요
같은 id가 두 번한 번만 남겨요
날짜가 YYYY-MM-DD 모양이 아님빈 값으로 보고 오늘 것으로 새로 만들어요
기간이 없는 이용권이용권이 없는 것으로 봐요
음식이 늘어난 새 버전새 음식 칸을 뒤에 채워요

이렇게 하면 필드 하나가 깨져도 게임 전체가 멈추지 않아요. 깨진 칸만 기본값으로 돌아가요.

버전 번호는 두 가지 일을 해요

형식을 바꿀 때마다 SAVE_VERSION을 올려요. 주막은 1에서 7까지 올라왔어요. 번호는 두 가지 일을 해요.

1. 옛 저장을 새 형식으로 바꿔요. 예를 들어 버전 6에서는 첫 몇 분을 안내하는 단계(intro)와 누적 플레이 시간을 넣었어요. 버전 5 저장은 "안내를 끝낸 경험 많은 플레이어"로 읽어요. 이미 한참 한 사람에게 튜토리얼을 다시 보여 주지 않으려는 거예요.

2. 옛 빌드가 새 저장을 덮어쓰지 못하게 막아요. 저장을 읽었는데 v가 이 빌드의 번호보다 크면 결과는 newer예요. 이때 게임은 저장을 멈추고 "더 새로운 저장이에요" 화면을 보여 줘요. 버전 7을 올린 이유도 이거예요. 30일 장부 이용권이 들어갔는데, 옛 빌드가 열린 탭이 이용권 없는 저장으로 덮어쓰면 구매한 것이 사라지니까요.

브라우저 탭을 두 개 열어 두거나, 포털에서 옛 버전이 캐시에 남은 경우에 실제로 일어나는 일이에요. 그래서 웹 빌드는 저장하기 직전마다 저장소의 버전을 한 번 더 읽어요. 포털 저장소는 읽기가 느려서 1분에 한 번만 확인하고, 화면이 숨겨지거나 닫힐 때는 반드시 확인해요.

깨진 저장은 지우지 않고 따로 둬요

읽다가 JSON 자체가 깨져 있으면 새 게임으로 시작해야 해요. 하지만 그냥 덮어쓰면 복구할 기회가 사라져요. 그래서 깨진 글자를 jumak.save.bak이라는 다른 칸에 먼저 복사해 둬요.

한성부 사건일지는 한 걸음 더 가요. 저장을 쓰기 전에 직전의 정상 저장을 .bak에 남겨요. 읽을 때는 순서가 정해져 있어요.

  1. 본 저장을 읽어요.
  2. 안 되면 .bak을 읽어요.
  3. 그것도 안 되면 새로 시작하고 "저장을 읽지 못해 새로 시작해요"라고 알려요.

저장소 접근은 전부 try/catch로 감싸요. 시크릿 모드처럼 저장이 막힌 곳에서는 게임이 멈추지 않고, 그냥 기억하지 못한 채로 계속 돼요.

언제 저장하나요

저장 시점이 모자라면 닫는 순간 진행이 사라지고, 너무 잦으면 기기가 느려져요. 한성부 사건일지는 낱말을 놓을 때, 판정이 날 때, 카드를 열 때 저장하고, 1초 안에 여러 번 일어나면 한 번으로 모아요(debounce). 여기에 화면이 숨겨질 때(visibilitychange)와 페이지를 떠날 때(pagehide)도 꼭 저장해요.

주막은 여기에 한 가지를 더해요. 화면이 숨겨진 동안에는 게임이 멈춰 있으니, 저장 시각을 멈춘 순간으로 찍어요. 탭을 닫아 버려도 다음에 열면 그 시각부터 자리를 비운 시간이 계산돼요. 이 시간은 4시간까지만 쳐 줘요(OFFLINE_CAP_SECONDS).

저장소는 채널마다 달라요

같은 게임이 웹, 구글 플레이, 토스에 모두 나가요. 저장소를 어디에 두는지는 어댑터가 정하고, 게임 코드는 get / set만 불러요.

채널저장 위치이유
웹localStorage가장 단순해요. 막혀 있으면 조용히 건너뛰어요
구글 플레이 앱Capacitor Preferences기기 용량이 부족하면 OS가 WebView 저장소를 지울 수 있다고 문서에 나와 있어서, 앱 자체 데이터와 함께 있는 곳을 써요
토스토스 SDK 저장소localStorage를 쓰면 안 돼요. 사용자 식별키를 앞에 붙여, 한 폰의 두 계정이 서로 다른 기록을 가져요
원스토어localStorage게임이 닫히기까지 0.5초라서, 바로 끝나는 동기 쓰기를 써요

저장이 실패해도 게임이 멈추지 않도록, 앱 빌드에는 메모리 사본도 둬요.

기기를 바꿀 때: 저장 코드

계정이 없으면 폰을 바꿀 때 문제가 생겨요. 한성부 사건일지는 이걸 저장 코드로 풀어요. 설정에서 "저장 코드 내보내기"를 누르면 진행이 글자로 나와요. 다른 기기에서 "저장 코드 가져오기"에 붙여 넣으면 이어서 해요. 웹에서 시작해 구글 플레이나 토스로 옮길 때 써요.

코드를 만들 때 지킨 규칙은 이래요.

  • 압축해서 글자 수를 줄여요. 앞 글자가 z면 압축, j면 압축 없는 대체 형식이에요. 압축이 안 되는 WebView를 위한 길이에요.
  • 끝에 검증값(HMAC)을 붙여요. 직접 고친 코드는 읽을 때 걸러져요.
  • 구매 정보는 담지 않아요. 구매는 스토어에서 다시 불러와요. 코드를 고쳐서 힌트나 광고 보상을 만들어 내는 일을 막으려고, 구입한 힌트와 광고 보상도 기기에 남아요.
  • 가져오기 전에 "지금 이 기기의 진행 대신 코드의 진행으로 바꿔요"라고 안내해요.

계정 없는 구조에서는 이 정도가 서버 없이 할 수 있는 가장 안전한 이동 방법이에요.

정리

  • 저장은 {v, savedAt, state}예요. 규칙 코드는 저장소를 모르고, 어댑터가 저장소를 골라요.
  • 읽을 때는 모든 값을 검사해요. 깨진 칸만 기본값으로 돌아가요.
  • 형식을 바꾸면 버전을 올려요. 새 버전 저장을 만난 옛 빌드는 저장을 멈춰요.
  • 깨진 저장은 .bak에 남기고, 한성부는 직전 정상 저장도 .bak에 둬요.
  • 화면이 숨겨질 때와 페이지를 떠날 때는 반드시 저장해요.
  • 기기를 옮길 때는 구매 정보 없는 저장 코드를 써요.

한성부 사건일지에서 설정의 저장 코드 내보내기를 직접 눌러 볼 수 있어요.

이 글은 제이월드 팀이 게임 설계 문서와 실제 플레이 수치를 바탕으로 썼고, 글을 다듬을 때 AI 도구를 함께 썼어요.

다른 글

서버 없이 만드는 "오늘의 판": 날짜 하나로 모두에게 같은 판을 주는 법

프레임 브레이커의 오늘의 판이 서버 없이 어떻게 모두에게 같은 공과 벽돌을 주는지, 점수 공식과 연속 기록의 시계 함정 처리, 이모지 결과 공유까지 개발 노트로 풀었어요.

개발 노트데일리프레임 브레이커

조선의 봉수: 불과 연기로 소식을 이은 신호망, 그리고 화차 성채의 '봉화 단계'

봉수가 낮과 밤에 어떻게 신호를 보냈는지, 불 몇 개가 무슨 뜻이었는지 정리했어요. 화차 성채의 봉화 0~5단계 규칙이 역사와 어디서 갈라지는지도 표로 보여줘요.

culture봉수화차 성채

한판 AI 도전 공략: 오목·장기 상대 20명, 레벨마다 뭐가 달라질까

한판의 AI 도전 레벨 1~10을 구간별로 나눠, 상대가 어떻게 두는지와 별 3개 조건, 막혔을 때 쓸 수 있는 방법을 게임 속 문구 그대로 정리했어요.

공략한판오목

나루와 포구의 옛 이야기, 그리고 부두 한 짐의 다섯 항구

나루, 포구, 항구는 어떻게 다른지, 한강 나루와 조운 같은 옛 물길 이야기를 짚고, 부두 한 짐의 항구 다섯 곳 중 무엇이 역사이고 무엇이 게임이 지어낸 것인지 정리했어요.

문화부두 한 짐항구