DEBUG ROOM
JP KR VN EN
처음으로게임 QA그래픽사운드텍스트필드네거티브 테스트체크리스트버그 리포트모니터링실패의 징후링크
TOP으로 돌아가기

버그 리포트

🧩 버그 리포트 형식


버그 사례

플레이어 캐릭터가 지형을 통과하여 떨어지는 사례
OK 이미지
NG 이미지

간이 보고

No. 위치 세부 사항 비고 보고자 작성일
101 영웅의 마을
영웅의 마을에서 「무기 상점」과 「돌담」이 맞닿은 부분으로 캐릭터를 이동시키면,
캐릭터가 땅을 통과해 떨어집니다.
Tenkawa Yota 2025-09-22



간략 보고

No.101 보고자Tenkawa Yota 보고일2025-09-22
버그 등급A 종류지형 이탈 재현 횟수3/3 (100% 재현)
위치영웅의 마을
개요 「무기 상점」과 「돌담」이 맞닿은 부분으로 캐릭터를 이동시키면 지면을 통과해 떨어짐
절차 1. 영웅의 마을에 들어감
2. 「무기 상점」과 「돌담」이 맞닿은 부분으로 이동
3. 지면을 통과해 떨어짐
환경 SmartPhone A (iOS 17)
SmartPhone B (Android 14)



상세 보고

No.101 보고자Tenkawa Yota 보고 일시2025-09-22 14:30
버그 등급A 종류지형 이탈 재현 횟수3/3 (100% 재현)
위치영웅의 마을
개요「무기 상점」과 「돌담」이 맞닿은 부분으로 캐릭터를 이동시키면 지면을 통과해 떨어짐
상세 영웅의 마을에서,
「무기 상점」과 「돌담」이 맞닿은 부분으로 캐릭터를 이동시키면,
지면을 통과해 떨어집니다.
절차 1. 영웅의 마을에 들어감
2. 「무기 상점」과 「돌담」이 맞닿은 부분으로 이동
3. 지면을 통과해 떨어짐
비고 이 상태가 되면 앱을 재시작하지 않는 한 캐릭터가 계속 떨어집니다.
건물 오브젝트가 같은 배치로 되어 있는 다른 장소에서도 재현될 가능성이 있습니다.
ROM VerA20250922_12098
환경 SmartPhone A (iOS 17)
SmartPhone B (Android 14)
참조 자료영웅의 마을 맵 사양서 20250824
첨부 자료bug/screenshot/101_a.png
bug/screenshot/101_b.png






🧩 버그 보고 시 주의사항


올바른 용어를 사용한다

NG 처음 마을에서~
사양서나 화면 표시를 따른 정식 명칭을 사용한다. 속칭이나 임의의 명칭은 사용하지 않는다

정식 명칭이 불명확한 경우, 보고자마다 표기가 달라지지 않도록 개발자나 리더에게 확인하여 통일한다
OK 영웅의 마을에서~



모호한 표현을 피한다

NG 윈도우를 열면 화면이 이상해진다
변한다」, 「이상해진다」 등의 표현은 피하고, 발생한 현상을 구체적으로 기재한다
OK 윈도우를 열면 캐릭터 이름과 아이콘 이미지가 표시되지 않는다



감정 표현을 포함하지 않는다

NG 아이템을 왜인지 구매할 수 없습니다
발생한 사실만 기재하고, 의문이나 감상은 불필요하다

불필요한 정보는 개발자에게 오해나 불쾌감을 줄 수 있으므로 주의
OK 아이템을 구매할 수 없습니다

NG 미션을 클리어했을 때 왜 보상을 받을 수 없는 것일까요?
다른 게임이라면 당연히 보상을 받을 수 있습니다
개발자를 비난하는 표현은 절대 피해야 한다

발생한 현상만 기재하고, 의견을 요구받지 않았다면 제안이나 불만은 적지 않는다

의견을 적는 경우에도, 개발자를 탓하는 표현은 피하고 객관적·중립적인 표현을 사용해야 한다
OK 미션을 클리어했을 때 보상을 받을 수 있다면 유저가 더 만족할 것이라 생각됩니다



정보를 생략하지 않는다

NG 영웅의 마을에서~
게임 진행 상황에 따라 상황이 크게 달라질 수 있으므로,
환경·절차·결과 등 재현에 필요한 정보는 생략하지 말고 명확히 기재해야 한다
OK 세계 붕괴 후의 영웅의 마을에서~



사실만을 기재한다

NG 모든 세이브 포인트에서 발생
확실히 확인된 사실만 기재한다
추측을 "사실"로 기재하면 수정 담당자가 혼란스러워질 수 있다

특히 모두라는 용어는 실제로 전부 확인했을 경우에만 사용한다
OK 영웅의 마을의 세이브 포인트에서 발생을 확인



1보고서 = 1현상으로 작성한다

NG 상점 화면에서 아이템 가격이 표시되지 않으며, 구매 후 보유 수량이 증가하지 않음
여러 결함을 하나로 묶지 말고, 현상별로 개별 보고서를 작성한다

하나로 합치면 일부만 수정된 경우 보고서 관리가 복잡해질 수 있음
OK 보고서 No.401: 아이템 가격이 표시되지 않음
보고서 No.402: 구매 후 보유 수량이 증가하지 않음



「개요」와 「상세」의 내용을 일치시킨다

NG 【개요】
스킬 A의 모션이 도중에 멈춤

【상세】
스킬 A를 사용하면, 모션 도중에 캐릭터가 땅에 묻혀 조작 불가능해짐
비슷한 내용이지만 최종 현상의 표현이 일치하지 않음

개발자는 개요를 보고 중요도를 판단하므로, “모션 도중 멈춤”과 “땅에 묻혀 조작 불가”는 우선순위가 크게 달라질 수 있음
OK 【개요】
스킬 A 사용 시 캐릭터가 땅에 묻혀 조작 불가능해짐

【상세】
스킬 A를 사용하면, 모션 도중에 캐릭터가 땅에 묻혀 조작 불가능해짐



「재현 절차」와 「현상」에 관계없는 내용은 작성하지 않는다

NG 무기점에 들른 후 5분 동안 대기한 다음 장비를 변경하고, 스킬 B를 사용하면 모션 도중 캐릭터가 땅에 묻혀 조작 불가능해짐
재현 절차 조사가 미흡하여 절차와 관계없는 조작이나 시간 경과까지 기재된 상태

최단 절차만 기재하고, 재현에 관련이 불분명한 요소는 별도로 구분하여 작성해야 함
OK 스킬 B를 사용하면 모션 도중 캐릭터가 땅에 묻혀 조작 불가능해짐



재현 절차의 정확성을 전달한다

NG 미션을 클리어했을 때 보상을 받을 수 없음
재현율은 보고서의 신뢰도를 나타내는 지표

기재된 절차로 재현이 불확실할 경우, 재현율을 명시해야 함

절차의 오류나 정보 부족 가능성을 개발자에게 전달할 필요가 있음
OK 미션을 클리어했을 때 보상을 받을 수 없음
(재현율: 0/3)

NG 미션을 클리어했을 때 보상을 받을 수 없음
기재된 절차로 항상 재현되지 않는 경우, 「~할 때가 있다」라는 표현을 사용하고 재현율을 함께 기재해야 함

조건이 아직 특정되지 않았을 가능성이 높으므로, 개발자가 기재 내용의 정확성을 이해할 수 있도록 해야 함
OK 미션을 클리어했을 때 보상을 받을 수 없을 때가 있다









🧩 보고 시 첨부하는 이미지의 잘못된 사례

결함이 어디에 있는지 알기 어렵다

NG 이미지
NG
어디가 잘못되었는지 한눈에 알 수 없음
OK 이미지
OK
빨간 선으로 잘못된 부분을 바로 알 수 있음

중요한 결함이 찍히지 않음

NG 이미지
NG
결함 발생 순간이 찍히지 않음
OK 이미지
OK
결함 발생 순간이 찍혀 있음

캡처 범위가 너무 좁아 상황을 알 수 없음

NG 이미지
NG
결함 부분만 잘려 있어 어디서 발생했는지 알기 어려움
OK 이미지
OK
결함 주변 상황도 알 수 있는 이미지

결함과 관련 없는 부분이 많이 찍혀 있음

NG 이미지
NG
모니터 전체 + 책상, 벽 등 불필요한 부분까지 찍혀 있음
OK 이미지
OK
결함을 인식할 수 있는 부분만 표시됨

여러 결함이 혼재되어 찍혀 있음

NG 이미지
NG
「상점 이름」과 「가격」이 모두 잘못된 이미지
OK 이미지
OK
「가격」만 잘못된 이미지

화질이 너무 나빠 결함을 식별할 수 없음

NG 이미지
NG
화질이 너무 나쁨
OK 이미지
OK
화질이 좋음

보고된 환경과 다른 이미지

NG 이미지
NG
PC 버그 보고에 스마트폰 스크린샷을 사용
OK 이미지
OK
PC 버전 스크린샷

파일 크기가 너무 큼

NG 이미지
NG
불필요하게 고해상도
OK 이미지
OK
결함을 식별할 수 있는 정도의 화질





🧩 보고 시 첨부하는영상의 잘못된 사례

버그 발생 후만 있고 "원인"이 보이지 않음

NG 이미지
NG
"캐릭터가 반투명해지는" 버그 발생 후만 촬영된 영상
OK 이미지
OK
버그 원인인 "사과"를 획득하는 장면부터 촬영된 영상

버그와 관련 없는 부분이 길게 촬영됨

NG 이미지
NG
버그와 관련 없는 부분(현상 전후)이 장시간 촬영된 영상
OK 이미지
OK
버그와 관련된 부분만 촬영된 영상

재현 절차와 관련 없는 동작이 섞여 있음

NG 이미지
NG
"바나나" 획득은 재현 절차에 포함되지 않음
OK 이미지
OK
"사과" 획득만이 재현 절차에 포함됨