· GUI 스킨· 레포트 #174
장비 탭과 장착 기능 (GUI 적용 3단계)
확정 시안대로 장비 탭을 만들고, 장착·해제가 실제 인벤토리·스탯과 연결되게 했다. 장착한 검이 저장 후 사라지는 문제를 막으려고 저장 데이터를 v4로 올려 파티 장비까지 저장한다.
배경
- 2단계(173)에서 캐릭터 탭과 임시 스탯을 만들었지만, 장비 칸은 모두 "없음"으로 비어 있었다. 장비 아이템(기본 검)은 있어도 끼울 방법이 없었다.
- 확정 시안은 167 장비 2안(큰 초상화 + 세로 장비 칸 3개)이다.
목적
- 시안대로 장비 탭 화면을 만들고, 장착·해제가 인벤토리와 스탯에 실제로 반영되게 한다.
결과

- 왼쪽: 큰 초상화(가장자리를 흐리게 잘라 배경에 녹임), 캐릭터 바꾸기, 장비 칸 3개(무기·방어구·장신구). 후보를 고르면 칸에 아이콘이 흐리게 미리 보인다.
- 오른쪽 위: 고른 칸에 맞는 장비 목록. 지금 낀 장비는 "장착 중", 인벤토리 것은 "보유 N"으로 구분한다. 후보가 없으면 "장착할 수 있는 무기가 없습니다."를 보여 준다.
- 오른쪽 아래: STATUS CHANGE에서 공격력·방어력·사거리를 "지금 → 바꾼 뒤"로 보여 준다. 오르면 초록, 내리면 빨강이라 장착 전에 결과를 판단할 수 있다.
- 입력은 ↑↓ 칸 선택, ←→ 캐릭터, F 장착이다. 마우스로도 된다.

- 기본 검(+10)을 끼면 공격력이 15 → 25가 되고, 캐릭터 탭의 STATUS와 EQUIPMENT에도 바로 반영된다.
결정과 이유
- 장착 = 인벤토리에서 빼서 칸에 끼기: 같은 검을 인벤토리와 장비 칸에 동시에 두지 않는다. 그래서 장착한 장비는 상점 판매 목록에도 나오지 않고, 끼운 채로 파는 일이 생기지 않는다.
- 전부 성공하거나 전부 실패: 해제할 때 인벤토리가 가득 차 있으면 아무것도 바꾸지 않고 "인벤토리 공간이 부족합니다."라고 알린다. 상점 거래(33단계)와 같은 규칙이라, 중간에 아이템이 사라지거나 복제되는 일이 없다.
- 전투 반영은 미룸: 전투 유닛은 아직
Unit_Hero값을 그대로 쓴다. 메뉴 적용(GUI 9단계)을 먼저 끝내고 전투 연결은 따로 하기로 했다.
고친 문제
- 저장 후 불러오면 장착한 검이 사라짐
- 증상: 장착하면 검이 인벤토리에서 빠지는데, 장비 칸은 저장하지 않아서 불러오면 검이 어디에도 없었다.
- 해결: 저장 데이터를 v3 → v4로 올리고 파티(캐릭터 ID + 칸별 장비 ID)를 함께 저장한다. 인벤토리와 같은 시점에 모으고, 같은 묶음으로 검증·적용·되돌리기를 한다.
- 이전 저장 파일(v1~v3)은 "파티 = 카린, 장비 없음"으로 채워서 그대로 불러올 수 있다. 알 수 없는 아이템이나 칸에 맞지 않는 장비가 있으면 불러오기 전체를 실패시킨다.
검증
- 장착 → 저장 → 해제(검이 인벤토리로 돌아옴) → 불러오기 순서로 시험했다. 장착 상태와 공격력 25가 복원되고, 저장 파일에
"equipment": ["basic_sword", "", ""]이 들어갔다. - 시험은 별도 저장 파일로 했고, 사용자 저장 파일은 건드리지 않았다.
남은 일
- 방어구·장신구 아이템 종류가 아직 없어서 두 칸은 비어 있다.
- 장비 스탯을 전투에 반영하기
- 현재 HP·MP는 아직 저장하지 않는다(항상 최대치).