데브시스터즈, 쿠키런: 킹덤 전투 데이터에 JSON Schema 검증 및 VS Code 자동완성 도입

데브시스터즈 스튜디오의 김용욱 프로그래머는 쿠키런: 킹덤의 전투 데이터 입력 과정에서 발생하는 오타와 타입 오류를 해결하기 위해 JSON Schema 기반의 검증 시스템을 도입했다. 기존에는 기획자가 엑셀에 수기로 데이터를 입력했으나, Unity 내장 JSON 파서가 잘못된 값을 조용히 무시하거나 런타임 에러를 유발해 디버깅에 많은 시간이 소요되었다.

JSON Schema 자동 생성 및 커스터마이징

개발팀은 C# 클래스 정의로부터 JSON Schema를 자동으로 생성하는 방식을 채택했다. Json.NET의 JSONSchemaGenerator를 활용하되, PascalCase 키값과 실제 입력 데이터의 camelCase 불일치, Enum 타입의 숫자/문자열 매핑 문제를 해결하기 위해 후처리 과정을 거쳤다. 이를 통해 additionalProperties를 false로 설정해 불필요한 필드 입력을 차단하고, 필수 필드(required)를 유연하게 조정하여 복잡한 게임 로직 데이터에 적합한 스키마를 완성했다.

VS Code 연동 및 생산성 향상

생성된 JSON Schema는 Visual Studio Code와 연동되어 기획자와 QA가 데이터를 입력할 때 실시간 검증 및 자동완성 기능을 제공한다. .vscode/settings.json 설정을 통해 특정 폴더 내 JSON 파일에 스키마를 적용하고, 자주 사용하는 구문을 Code Snippet으로 등록해 입력 효율을 높였다. 이 시스템은 매 전투 테스트 시 별도 스레드에서 검증을 수행하며, 결과적으로 콘텐츠 업데이트 속도를 높이고 데이터 오류로 인한 버그를 크게 감소시켰다.