whdwo798/Travel_Run
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a708f184991a4ad556e67023a3387473150bbf18
Travel_Run/Docs/assets.md
T
jongjae0305 a708f18499 Refactor course maps and travel UI
2026-07-07 15:57:11 +09:00

200 lines
11 KiB
Markdown
Raw Blame History

# Assets
현재 만들어진 이미지와 사용 위치를 정리합니다.
## Runtime Resources
`Resources.Load<Sprite>()`로 직접 사용하는 에셋입니다.
| 파일 | 용도 |
| --- | --- |
| `Assets/Resources/UI_LeftHudPassportHorizontalGridPanel.png` | 현재 적용 중인 가로형 왼쪽 여권 HUD 배경 |
| `Assets/Resources/UI_LeftHudPassportCompactPanel.png` | 오른쪽 빈 장식 영역을 줄인 왼쪽 HUD 전용 컴팩트 여권 배경 |
| `Assets/Resources/UI_LeftHudPassportPanel.png` | 이전 큰 세로형 왼쪽 여권 HUD 배경 |
| `Assets/Resources/UI_PassportPanel.png` | 기존 작은 왼쪽 여권 HUD 배경 |
| `Assets/Resources/UI_JJ_PassportPhoto.png` | 현재 적용 중인 JJ 여권사진 UI |
| `Assets/Resources/UI_JJ_Face.png` | 플레이어 얼굴 UI |
| `Assets/Resources/UI_LifeStamp.png` | 목숨 도장 |
| `Assets/Resources/UI_DepartureStamp_Red.png` | 배경 없는 출국 도장 |
| `Assets/Resources/UI_PassportItemSlot.png` | 아이템 슬롯 |
| `Assets/Resources/Map_Tutorial_Incheon_Airport.png` | 튜토리얼 인천공항 배경 |
| `Assets/Resources/Map_America_NewYork.png` | 미국 뉴욕 배경 |
| `Assets/Resources/UI_TutorialAirportMonitorFrame.png` | 튜토리얼 설명창용 공항 디지털 안내 패널 프레임 |
| `Assets/Resources/UI_TutorialNextButton.png` | 튜토리얼 안내를 넘기는 확인 버튼 |
| `Assets/Resources/UI_RightHudLuggageLabel_Korea.png` | 튜토리얼/인천 맵 오른쪽 HUD 수하물 라벨 |
| `Assets/Resources/UI_RightHudLuggageLabel_Japan.png` | 일본 맵 오른쪽 HUD 수하물 라벨 |
| `Assets/Resources/UI_RightHudLuggageLabel_China.png` | 중국 맵 오른쪽 HUD 수하물 라벨 |
| `Assets/Resources/UI_RightHudLuggageLabel_America.png` | 미국 맵 오른쪽 HUD 수하물 라벨 |
| `Assets/Resources/FinishGate_Tutorial_Incheon.png` | 튜토리얼 출국 게이트 |
| `Assets/Resources/FinishGate_Japan_Torii.png` | 일본 토리이 도착 지점 |
| `Assets/Resources/FinishGate_China_Paifang.png` | 중국 패방 도착 지점 |
| `Assets/Resources/FinishGate_America_Liberty.png` | 미국 자유의 여신상 도착 지점 |
## Intro Assets
| 파일/폴더 | 용도 |
| --- | --- |
| `Assets/ConceptArt/Intro/` | 인트로 세계지도, 여권, 스마트폰, 버튼, 도장 이미지 |
| `Assets/ConceptArt/Intro/UI/intro_title_lockup.png` | TravelRun 타이틀 이미지 |
| `Assets/ConceptArt/Intro/UI/intro_button_start.png` | 시작 버튼 이미지 |
| `Assets/ConceptArt/Intro/UI/intro_button_continue.png` | 이어하기 버튼 이미지 |
| `Assets/ConceptArt/Intro/UI/intro_button_settings.png` | 설정 버튼 이미지 |
| `Assets/ConceptArt/Intro/Cutouts/` | 잘라낸 여권/스마트폰/아이콘 부품 |
## Tutorial UI Assets
| 파일 | 용도 |
| --- | --- |
| `Assets/Resources/UI_TutorialAirportMonitorFrame.png` | 실제 튜토리얼 안내창에 적용하는 투명 배경 런타임 PNG |
| `Assets/Resources/UI_TutorialNextButton.png` | 실제 튜토리얼 안내창에 적용하는 확인 버튼 런타임 PNG |
| `Assets/ConceptArt/tutorial_instruction_airport_monitor_frame_01.png` | 튜토리얼 설명창용 공항 디지털 안내 패널/광고판 컨셉 |
| `Assets/ConceptArt/tutorial_next_button_concept_01.png` | 공항 안내 패널에 맞춘 확인 버튼 컨셉 |
| `Assets/ConceptArt/tutorial_instruction_concept_01.png` | 기존 튜토리얼 안내 UI 컨셉 |
## Left Passport HUD Assets
왼쪽 HUD는 체력 도장과 아이템 슬롯이 잘 보이도록 가로형 여권 페이지 패널로 교체했습니다.
왼쪽 캐릭터 사진 영역은 HP/아이템 2줄 높이에 맞추고, 오른쪽에는 HP 3칸과 아이템 3칸을 같은 열 위치의 2줄 그리드로 배치합니다.
실제 목숨 도장, 아이템 슬롯, 얼굴 이미지는 Unity UI로 위에 얹습니다.
| 파일 | 용도 |
| --- | --- |
| `Assets/Resources/UI_LeftHudPassportCompactPanel.png` | 실제 적용하는 컴팩트 가로형 여권 2줄 그리드 HUD 런타임 PNG |
| `Assets/Resources/UI_LeftHudPassportHorizontalGridPanel.png` | 결과 화면과 원본 보관용 가로형 여권 2줄 그리드 HUD PNG |
| `Assets/ConceptArt/left_hud_passport_horizontal_grid_panel_concept_01.png` | 가로형 여권 2줄 그리드 HUD 컨셉 원본 |
| `Assets/Resources/UI_JJ_PassportPhoto.png` | 오프닝 만화의 JJ를 바탕으로 만든 현재 여권사진 런타임 PNG |
| `Assets/ConceptArt/jj_passport_photo_concept_01.png` | JJ 여권사진 컨셉 원본 |
| `Assets/Resources/UI_LeftHudPassportPanel.png` | 이전 큰 세로형 여권 HUD 배경 |
| `Assets/ConceptArt/left_hud_passport_panel_concept_01.png` | 이전 큰 세로형 여권 HUD 컨셉 원본 |
| `Assets/Resources/UI_PassportPanel.png` | 이전 작은 여권 HUD 배경 |
## Right HUD Luggage Tag Assets
오른쪽 HUD에서 거리와 이번 판 적립 마일리지만 간결하게 표시하기 위한 수하물 태그 컨셉입니다.
실제 숫자/라벨 텍스트는 Unity UI 텍스트로 얹습니다.
| 파일 | 용도 |
| --- | --- |
| `Assets/Resources/UI_RightHudLuggageTag_Korea.png` | 한국 버전 오른쪽 HUD 수하물 태그 런타임 PNG |
| `Assets/Resources/UI_RightHudLuggageTag_Japan.png` | 일본 버전 오른쪽 HUD 수하물 태그 런타임 PNG |
| `Assets/Resources/UI_RightHudLuggageTag_China.png` | 중국 버전 오른쪽 HUD 수하물 태그 런타임 PNG |
| `Assets/Resources/UI_RightHudLuggageTag_America.png` | 미국 버전 오른쪽 HUD 수하물 태그 런타임 PNG |
| `Assets/ConceptArt/right_hud_luggage_tag_korea_concept_01.png` | 한국 버전 컨셉 원본 |
| `Assets/ConceptArt/right_hud_luggage_tag_japan_concept_01.png` | 일본 버전 컨셉 원본 |
| `Assets/ConceptArt/right_hud_luggage_tag_china_concept_01.png` | 중국 버전 컨셉 원본 |
| `Assets/ConceptArt/right_hud_luggage_tag_america_concept_01.png` | 미국 버전 컨셉 원본 |
가로형 수하물 라벨이 현재 실제 적용 버전입니다.
런타임 PNG는 투명 여백을 줄이기 위해 태그 경계 기준으로 크롭했고, 맵에 따라 한국/일본/중국/미국 라벨을 자동으로 바꿔 끼웁니다.
표시 정보는 `DIST`와 `MILE` 두 가지입니다.
| 파일 | 용도 |
| --- | --- |
| `Assets/Resources/UI_RightHudLuggageLabel_Korea.png` | 가로형 한국 버전 오른쪽 HUD 수하물 라벨 투명 PNG |
| `Assets/Resources/UI_RightHudLuggageLabel_Japan.png` | 가로형 일본 버전 오른쪽 HUD 수하물 라벨 투명 PNG |
| `Assets/Resources/UI_RightHudLuggageLabel_China.png` | 가로형 중국 버전 오른쪽 HUD 수하물 라벨 투명 PNG |
| `Assets/Resources/UI_RightHudLuggageLabel_America.png` | 가로형 미국 버전 오른쪽 HUD 수하물 라벨 투명 PNG |
| `Assets/ConceptArt/right_hud_luggage_label_korea_concept_01.png` | 가로형 한국 버전 컨셉 원본 |
| `Assets/ConceptArt/right_hud_luggage_label_japan_concept_01.png` | 가로형 일본 버전 컨셉 원본 |
| `Assets/ConceptArt/right_hud_luggage_label_china_concept_01.png` | 가로형 중국 버전 컨셉 원본 |
| `Assets/ConceptArt/right_hud_luggage_label_america_concept_01.png` | 가로형 미국 버전 컨셉 원본 |
## Result UI Assets
결과 화면은 여권 정산표처럼 필요한 정보만 간추려 보여줍니다.
| 파일 | 용도 |
| --- | --- |
| `Assets/Resources/UI_LeftHudPassportHorizontalGridPanel.png` | 결과 화면 여권 정산표 배경 |
| `Assets/Resources/UI_DepartureStamp_Red.png` | `출국 성공!` 클리어 도장 |
| `Assets/Sprites/UIIcons/UI_ClearRank.png` | 클리어 배지 |
| `Assets/Sprites/UIIcons/UI_Mileage.png` | 마일리지 스탯 |
| `Assets/Sprites/UIIcons/UI_Timer.png` | 도착 시간 스탯 |
| `Assets/Sprites/UIIcons/UI_Checkpoint.png` | 이동 거리/목적지 스탯 |
| `Assets/Sprites/UIIcons/UI_DutyFreeShop.png` | `면세점으로` 버튼 아이콘 |
| `Assets/Sprites/UIIcons/UI_AirplaneTravel.png` | `다음 여행지 가기` 버튼 아이콘 |
| `Assets/Resources/UI_TutorialNextButton.png` | 결과 화면 버튼 배경 |
| `Assets/Resources/Map_Tutorial_Incheon_Airport.png` | 결과 화면 뒤 인천공항 배경 |
| `Assets/Sprites/Souvenirs/` | 맵별 보상 기념품 표시 |
## Opening Story Assets
| 파일/폴더 | 용도 |
| --- | --- |
| `Assets/ConceptArt/Opening/Cutscene/` | 오프닝 만화 컷 |
| `opening_cutscene_comic_jj_03_no_bubbles.png` | 현재 사용하는 말풍선 없는 오프닝 침대/휴대폰 컷 |
| `opening_cutscene_comic_jj_04_prepare_no_bubbles.png` | 현재 사용하는 말풍선 없는 오프닝 여행 준비 컷 |
| `opening_jj_v2_panel_01_room.png` | 누워있는 장면 |
| `opening_jj_v2_panel_02_alert.png` | 휴대폰 알림 |
| `opening_jj_v2_panel_03_react.png` | 반응 컷 |
| `opening_jj_v4_panel_01_sparkle.png` | 눈 반짝임 |
| `opening_jj_v4_panel_02_messy_room.png` | 여행 준비 |
| `opening_jj_v4_panel_03_leave_with_items.png` | 나가는 컷 |
| `opening_cutscene_comic_jj_03.png` | 이전 말풍선 포함 오프닝 침대/휴대폰 컷 |
| `opening_cutscene_comic_jj_04_prepare.png` | 이전 말풍선 포함 오프닝 여행 준비 컷 |
| `opening_cutscene_final_departure_jj_06_street_strict_stylematch.png` | 거리로 나가는 큰 컷 |
## Gameplay Items
| 파일 | 효과 |
| --- | --- |
| `Assets/Sprites/Items/Item_Health_Sushi.png` | 목숨 회복 |
| `Assets/Sprites/Items/Item_Invincible_Ramen.png` | 잠깐 무적 |
| `Assets/Sprites/Items/Item_Shield.png` | 충돌 1회 방어 |
| `Assets/Sprites/Items/Item_Speed_Shoes.png` | 속도 회복 |
| `Assets/Sprites/Items/Item_Mileage_Card.png` | 마일리지 획득량 증가 |
| `Assets/Sprites/Items/Item_Lunchbox.png` | 면세점 도시락 |
| `Assets/Sprites/Items/Item_Backpack.png` | 가방/슬롯 확장 |
| `Assets/Sprites/Items/Item_Souvenir_Magnet.png` | 기념품 |
## Regional Items
`Assets/Sprites/RegionalItems/`에 국가별 음식/소품 아이템이 있습니다.
- 한국: 김밥, 바나나우유, 붕어빵, 교통카드
- 일본: 초밥, 라멘, 말차, 오니기리
- 중국: 만두, 월병, 차, 훠궈
- 미국: 햄버거, 도넛, 콜라, 핫도그
현재 튜토리얼은 기본 아이템 에셋을 사용하고, 이후 맵별 스킨으로 교체할 수 있습니다.
## Obstacle And Platform Skins
`Assets/Sprites/ObstacleSkins/`
| 종류 | 파일 예시 |
| --- | --- |
| 공항 발판 | `Skin_Platform_AirportFloorTile.png` |
| 공항 천장 | `Skin_Platform_AirportCeiling.png` |
| 일본 발판 | `Skin_Platform_Japan.png` |
| 중국 발판 | `Skin_Platform_China.png` |
| 미국 발판 | `Skin_Platform_USA.png` |
| 낮은 장애물 | 캐리어, 석등, 시장 상자, 콘 |
| 슬라이드 장애물 | 공항 표지판, 홍등, 배너, 도로 표지판 |
## Effects
컨셉 이미지:
- `Assets/ConceptArt/gameplay_effects_concept_01.png`
포함된 효과:
- 마일리지 획득 반짝임
- 목숨 회복 하트/+1
- 방어막 버블
- 무적/속도감 실루엣
- 속도 바람
- 충돌 폭발
- 먼지 효과
현재 구현:
- `Assets/Scripts/ItemFeedbackEffect.cs`가 런타임에서 링, 반짝임, 짧은 문구를 생성합니다.
- 아이템 획득 시 `+1`, `SAFE`, `SHIELD`, `SPEED`, `x2` 같은 피드백을 표시합니다.
- 라멘 무적/방어막 방어 성공 시 피격 깜빡임 대신 `SAFE` 또는 `BLOCK` 피드백을 표시합니다.
다음 방향:
- 컨셉 시트에서 실제로 사용할 이펙트 PNG를 개별 스프라이트로 잘라 교체합니다.
Reference in New Issue View Git Blame Copy Permalink