어드벤처 테일 (Adventure Tale) 개발 노트

Unity 6 기반 2D 쿼터뷰(아이소메트릭) RPG 어드벤처 테일 의 작업별 개발 기록입니다. 작업과 기획을 번호별로 기록합니다. 작업 노트에는 무엇을 했는지 / 작업 후 화면 / 문제와 해결 방법 을, 기획 노트에는 목표 스타일 / 참고 이미지 / 이후 결정·구현 항목 을 정리합니다.

• 작업 단위: 기능 하나 (노트 번호 = 작업 순서)
• 스크린샷: images/<번호>/ (에디터에서 실제 게임 코드로 조립해 찍은 화면, 또는 그림 미리보기 도구 결과)

폴더 구조

rpg-game-develop-note/
├── README.md                     ← 이 문서 (목차·공통 정보)
├── NN-<작업이름>.md               ← 작업별 노트 (작업 내용 / 스크린샷 / 문제와 해결)
└── images/NN/                    ← 작업별 스크린샷

목차

번호	작업	날짜
01	캐릭터 디자인 변경 및 장비 외형 적용	2026-09-24
02	월드 맵 확장 · 이동 속도 증가 · 월드 그래픽	2026-09-24
03	몬스터 전투 시 몬스터 정보 박스	2026-09-24
04	스킬 사용 방식 개편 — 기본공격 분리, 대상 지정/범위 스킬	2026-09-24
05	경험치 · 레벨 · 스킬포인트	2026-09-25
06	직업별 스킬 트리 · 스킬마스터 NPC	2026-09-25
07	퀘스트 시스템 (수락 · 목록 · 진행 확인)	2026-09-25
08	캐릭터 선택창 · 캐릭터 생성 (이름 / 직업 / 성별)	2026-09-25
09	게임 글꼴 · UI 스타일 개선	2026-09-25
10	지역 기획 · 지역별 몬스터 · 보스 몬스터 (지역 1 · 2)	2026-09-25
11	지역 3 · 4 (해변가 · 바닷속) · 1차 전직 퀘스트 · 사냥 경험치 1.75배	2026-09-25
12	마을별 상점 · 장비 등급 · 스크롤 목록 상점 창 · 직업별 레벨 성장	2026-09-26
13	인벤토리(가방) 칸 무제한 · 스크롤 목록	2026-09-26
14	상점 팔기 (팔기 탭 · 파는 값 · 한 번 더 묻기)	2026-09-26
15	지역 5·6 (바위 동굴 · 산악) + 2차 전직 시험	2026-09-26
16	지역 7·8 (얼음 · 심연) + 스킬 트리 개편 · MP + 몬스터 배치	2026-09-26
17	지역 9·10 (황무지 협곡 · 드래곤 성) + 최고 레벨 400	2026-09-26
18	몬스터 추적 개편 · 법사 HP/MP · 조준 중 이동	2026-09-26
19	스킬 재사용 대기시간 종류별 고정값	2026-09-27
20	범위 스킬 범위·판정 개선	2026-09-27
21	캐릭터 디자인·픽셀 아트 스타일 개편 기획	2026-09-27
22	몬스터 디자인·스타일 개편 기획	2026-09-27
23	아이템 등급·포션 종류·장비 제작 시스템	2026-09-27
24	NPC(촌장) 이미지·디자인 개편 기획 (지역 1~11)	2026-09-30
25	NPC(상점) 이미지·디자인 개편 기획 (지역 1~11)	2026-09-30
26	NPC(안내원) 이미지·디자인 개편 기획 (지역 1~11)	2026-09-30
27	NPC(스킬마스터) 이미지·디자인 개편 기획 (지역 1~10)	2026-09-30
28	NPC(창고지기) 이미지·디자인 개편 기획 (지역 1~11)	2026-09-30
29	캐릭터 · 스킬 이펙트 PNG 적용 — 페이퍼돌 캐릭터 · 지역 장비 색 · 걷기 개선	2026-10-02
30	NPC(보스 필드 지기) 이미지·디자인 개편 기획 (지역 1~11)	2026-10-03
31	장비창 모자 숨기기	2026-10-03
32	NPC 60명 PNG 시트 적용 — 마을 NPC 5역할 · 보스 필드 지기	2026-10-03
33	캐릭터 만들기 머리색 선택 — 기본 + 7색	2026-10-09
34	몬스터 · 보스 PNG 시트 적용 — 지역 1~10, 98종	2026-10-09
35	월드맵 확장 · 사냥터 구성 다양화 — 마을 64 · 사냥터 100, 지역마다 3~6곳	2026-10-09
36	스킬 이펙트 새 시트 적용 — 검사 12종 · 법사 13종	2026-10-09
37	남자 캐릭터 걷기 그림 다듬기 — 옷 팔 · 턱 그늘 · 오른쪽 눈	2026-10-09
38	보스 큰 공격 다양화 — 보스마다 다른 조합 · 새 패턴 8가지	2026-10-10
39	보스 다듬기 — 산호 골렘 두 마리 · 드래곤 불 뿜는 순간 · 지역별 난이도 곡선	2026-10-10
40	다국어 — 한국어 · 영어, 설정에서 바꾸기	2026-10-10
41	지역 11 용사의 성 — 타락한 용사 Lv500 · 최고 레벨 500	2026-10-11
42	스킬마스터 NPC 제거 — 스킬은 레벨업 · 전직 때 저절로	2026-10-11
43	장비 강화 — 강화석 4종 + 골드, 최대 +20	2026-10-11
44	지역별 장비 착용 레벨 통일 (지역 1~11)	2026-10-11
45	버그 수정 — 긴 대사 스크롤 · 몬스터 정보 칸 폭	2026-10-12
46	장비 제작 재료를 등급마다 다르게 — 새 재료 99종	2026-10-12
47	보스 필드 입장 재료 — 뒤 지역일수록 종류 · 개수 증가, 앞 지역 전리품	2026-10-13
48	가방 정리 버튼 — 같은 아이템 합치기 · 장비 → 포션 → 재료 순	2026-10-14
49	마을 귀환석 — 상점에서 사서 쓰면 지금 지역의 마을로	2026-10-14
50	해변가 몬스터 개편 — 소라군을 빼고 야자수몬 추가, 레벨 조정	2026-10-14
51	버그 수정 — 스킬 이펙트 크기를 대상 몬스터와 상관없이 고정	2026-10-14
52	공용 창고 — 모든 캐릭터가 같이 쓰는 창고와 창고 창	2026-10-14
53	기본 이동 속도 조금 줄이기 — 초당 8칸 → 7.5칸	2026-10-14
54	메테오 연출 — 하늘의 불 구멍에서 운석이 실제로 떨어진다	2026-10-14
55	뇌전 가르기 — 원 가운데로 뛰어들어 치는 스킬로	2026-10-14
56	파도 가르기 연출 — 부채꼴 범위를 덮는 물결 셋	2026-10-14
57	퀘스트 보상 중심 성장 — 사냥 경험치 5% · 지역마다 퀘스트 10개	2026-10-14
58	퀘스트 15개 · 다음 퀘스트까지 이어지는 보상	2026-10-16
59	몬스터 드랍 확률 표 — 종류마다 하나의 확률 · 일반 몬스터 장비	2026-10-16
60	미니맵 — 내 위치 · NPC · 포탈	2026-10-16

공통 개발 환경 · 원칙

• Unity 6000.6.2f1 / URP 2D / Input System / C# 9, macOS (Apple Silicon)
• 외부 이미지 에셋 없이 그림을 코드로 생성 (월드·아이콘·UI). 예외: 글꼴은 라이선스가 확인된 나눔스퀘어라운드(SIL OFL) (09), 플레이어 캐릭터 · 장비 · 스킬 이펙트 · NPC · 몬스터는 직접 그린 PNG 시트 (21 · 22 · 24~30 · 32 · 34)
• 게임 규칙은 UnityEngine 을 쓰지 않는 순수 C# Core 어셈블리 에 두고(서버 이식 대비), Unity 쪽은 입력·연출만
• 세이브 스키마가 바뀌면 SaveData.CurrentVersion 을 올리고 마이그레이션 단계를 추가 (현재 v9)
• 검증: Unity batchmode EditMode 테스트 (에디터가 열려 있으면 프로젝트 복제본에서), 그림은 dotnet 미리보기 도구 / 에디터 캡처 스크립트로 확인

개발 중 쓰는 도구

도구	용도
Unity batchmode -runTests	컴파일 + EditMode 테스트 (215개, 31 기준)
캐릭터 아트 파이프라인 (파이썬 numpy · Pillow)	원본 PNG 시트를 칸으로 자르고 맨몸에 장비를 맞춰 겹쳐 게임용 층 아틀라스 · 칸 표를 만든다. 옆모습 걷기 합성, 지역 장비 색 바꾸기, 검토용 미리보기 · GIF (29)
프로젝트 복제본 (APFS cp -c)	에디터를 켜 둔 채로 batchmode 테스트·캡처를 돌리는 사본 (용량 추가 없음, 캡처 전용 코드는 사본에만)
dotnet 그림 미리보기 도구	캐릭터·몬스터·월드·아이콘 그리기 코드를 Unity 없이 4초 만에 PNG 로 렌더 (지역별 몬스터 줄 세우기, 4방향·동작 시트)
밸런스 계산 콘솔 (임시)	게임 규칙(Core) 코드를 dotnet 으로 돌려 레벨별 몬스터 능력치 · 몇 대에 잡히나 · 레벨업까지 사냥 수를 표로 뽑음
맵 설계 스크립트 (임시)	타원 호수 · 굽은 길 · 숲 무리 · 바위 턱 · 골짜기를 칠해 ASCII 맵을 만들고, 줄 길이 · 연결성(스폰에서 포탈 · NPC · 사냥터까지, 갇힌 틈 메우기) · 길 앞을 가리는 나무를 검사
맵 전체 미리보기 (임시)	바닥 · 장식물 · 포탈 · NPC · 몬스터 자리를 맵 한 장으로 같은 축척에 그려 필드끼리 크기 · 지형을 비교 (한글 이름표는 macOS 의 Swift 로 붙인다)
에디터 캡처 스크립트 (임시)	batchmode 에서 GameSession 을 조립해 실제 HUD·월드 화면을 PNG 로 찍음 (게임 저장소에는 넣지 않음)
에디터 시뮬레이션 스크립트 (임시)	플레이어 로직을 프레임 단위로 돌려 NPC 대화·스킬 뒤 자동 공격·스킬 시전 흐름 검증
batchmode Play 모드 흐름 시험 (임시)	복제본을 실제 Play 모드로 돌려 선택창 → 캐릭터 만들기 → 게임 → 선택창 → 다른 캐릭터 흐름, 보스 안내 → 입장 → 큰 공격 → 처치 흐름, 전직 퀘스트 대화, 모든 보스 큰 공격 발동, 상점 창(사기 · 팔기 · 탭 · 스크롤 · 멀어지면 닫힘)을 단계마다 확인 (세이브는 임시 폴더)
비교 페이지 + 헤드리스 크롬 (임시)	글꼴 후보를 실제 게임 문구로, UI 방향을 목업으로 한 장에 그려 PNG 로 찍어 고르는 데 씀
글꼴 글자 표 검사 (임시 스크립트)	글꼴 파일의 글자 표(cmap)를 읽어 게임 코드에 쓰인 글자가 모두 있는지 확인