스크립트 유효성 검사

스크립트 유효성 검사는 게임을 내보내기 전에 문제를 잡아내는 데 도움을 줍니다.

무엇인가요

유효성 검사는 스크립트를 위한 GenPy의 자동 검사 시스템입니다. 정기적으로 실행해 오류, 경고, 유용한 제안을 깨진 장면이나 실패한 내보내기가 되기 전에 발견하세요.

INFO

유효성 검사는 프로젝트가 끝날 때만이 아니라 일상적인 집필 루틴의 일부로 활용할 때 가장 효과적입니다.

검사하는 것

• 게임 스크립트의 문법 오류
• 점프나 콜이 존재하지 않는 장면을 가리킬 때 생기는 정의되지 않은 라벨
• 플레이어가 갈 곳이 없는 막힌 라벨
• 조건이나 스토리 로직에서 사용된 정의되지 않은 변수
• 누락된 캐릭터 정의
• pickle 안전성 문제를 포함한 세이브 호환성 이슈
• 절대 진입할 수 없는 도달 불가 코드 및 장면

사용 방법

1. Publish 모드 또는 Tools에서 Validation을 엽니다.
2. 현재 프로젝트에 대한 유효성 검사를 실행합니다.
3. 카테고리와 심각도별로 그룹화된 이슈 목록을 검토합니다.
4. 이슈를 클릭해 관련 줄이나 장면으로 바로 이동합니다.
5. 문제를 수정하고 유효성 검사를 다시 실행합니다.
6. 남은 이슈가 이해되고 수용 가능한 수준이 될 때까지 반복합니다.

심각도 수준

• 오류: 스토리가 올바르게 작동하지 않을 수 있는, 반드시 수정해야 할 문제
• 경고: 플레이어를 혼란스럽게 하거나 루트를 망가뜨릴 수 있어 검토가 필요한 문제
• 정보: 스크립트 품질과 일관성을 개선하는 제안

언제 사용하면 좋은가

• 모든 내보내기 전
• 주요 스토리 편집이나 루트 재작성 후
• QA 및 플레이테스트 준비 중
• 이전 스크립트를 가져오거나 재구성할 때

도움이 되는 이유

• 장면 사이의 끊긴 링크 발견
• 현재 구조와 더 이상 맞지 않는 스토리 로직 찾기
• 세이브 또는 루트 진행 이슈의 위험 감소
• 출시 전 정리를 위한 집중적인 체크리스트 제공

팁

• 마지막까지 기다리는 대신 일찍, 자주 유효성 검사를 실행하세요.
• 오류를 먼저 수정하고 경고를 처리하세요.
• 메뉴, 라벨, 또는 변수를 크게 변경한 후에는 유효성 검사를 다시 실행하세요.

TIP

유효성 검사는 스토리 그래프, Branch View, 변수 패널과 함께 사용할 때 가장 효과적입니다.