Files
Travel_Run/Docs/assets.md
T
2026-07-09 02:50:48 +09:00

19 KiB

Assets

현재 만들어진 이미지와 사용 위치를 정리합니다.

Runtime Resources

Resources.Load<Sprite>()로 직접 사용하는 에셋입니다.

파일 용도
Assets/Resources/UI_ResultBoardingPassPanel_New.png 현재 적용 중인 결과 화면 보딩패스형 정산 패널 배경
Assets/Resources/UI_LeftHudPassportHorizontalGridPanel.png 현재 적용 중인 가로형 왼쪽 여권 HUD 배경
Assets/Resources/UI_LeftHudPassportCompactPanel.png 오른쪽 빈 장식 영역을 줄인 왼쪽 HUD 전용 컴팩트 여권 배경
Assets/Resources/UI_PassportHudPhotoFrame.png 왼쪽 HUD 사진/정보 박스 프레임
Assets/Resources/UI_PassportHudPhotoHeader.png 왼쪽 HUD 사진/정보 박스 상단 여권 장식
Assets/Resources/UI_PassportHudPhotoRouteBox.png 왼쪽 HUD 안쪽 항공권 경로 박스 선택 리소스
Assets/Resources/UI_PassportHudPhotoInfoStrip.png 왼쪽 HUD 안쪽 항공권 정보줄 선택 리소스
Assets/Resources/UI_PassportHudLifeCircleFrame.png 왼쪽 HUD 오른쪽 영역의 HP 원형 프레임
Assets/Resources/UI_PassportHudItemSlotFrame.png 왼쪽 HUD 오른쪽 영역의 아이템 네모 슬롯 프레임
Assets/Resources/UI_PassportHudFlightMarker.png 왼쪽 HUD 오른쪽 영역의 비행기 표시 라인
Assets/Resources/UI_PassportHudItemMarker.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/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_01_CheckInHall.png 현재 적용 중인 인천 튜토리얼 체크인 홀 배경 조각, 임시 카메라 맞춤 캔버스
Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_02_DepartureSecurity.png 현재 적용 중인 인천 튜토리얼 출국/보안 통로 배경 조각, 임시 카메라 맞춤 캔버스
Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_03_DutyFreeConcourse.png 현재 적용 중인 인천 튜토리얼 면세점 거리 배경 조각, 임시 카메라 맞춤 캔버스
Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_04_MovingWalkwayWindows.png 현재 적용 중인 인천 튜토리얼 무빙워크/터미널 창 배경 조각, 임시 카메라 맞춤 캔버스
Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_05_BoardingGate.png 현재 적용 중인 인천 튜토리얼 탑승 게이트 배경 조각, 임시 카메라 맞춤 캔버스
Assets/Resources/Map_Japan_Fukuoka.png 일본 후쿠오카 실전맵 배경
Assets/Resources/Map_China_Beijing.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 미국 자유의 여신상 도착 지점

인천 StageBackgrounds 조각은 화면 확대를 줄이기 위한 임시 보정본입니다. 상단 늘어남이 보여 최종본은 새 16:9 배경 조각으로 다시 제작합니다.

Runtime SFX Assets

Resources.Load<AudioClip>()로 직접 사용하는 무음성 효과음입니다.

파일 용도
Assets/Resources/SFX/SFX_Player_Jump.wav 기본 점프 효과음
Assets/Resources/SFX/SFX_Player_DoubleJump.wav 2단 점프 효과음
Assets/Resources/SFX/SFX_Player_Slide.wav 슬라이딩 시작 효과음

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줄 그리드로 배치합니다. 현재 기본 패널은 바깥 여권 테두리와 오른쪽 여행 도장 장식만 포함합니다. 왼쪽 사진/정보 박스 프레임과 상단 장식, 오른쪽의 원형 HP 프레임, 네모 아이템 슬롯, 비행기 표시 라인, 물건 표시 라인은 개별 이미지로 분리했습니다. 실제 목숨 도장, 아이템 슬롯, 얼굴 이미지는 Unity UI로 위에 얹습니다.

파일 용도
Assets/Resources/UI_LeftHudPassportHorizontalGridPanel.png 실제 적용하는 가로형 여권 2줄 그리드 HUD 런타임 PNG
Assets/Resources/UI_LeftHudPassportCompactPanel.png 오른쪽 빈 장식 영역을 줄인 컴팩트 가로형 여권 2줄 그리드 HUD PNG
Assets/Resources/UI_PassportHudPhotoFrame.png 개별 배치용 왼쪽 사진/정보 박스 프레임 PNG
Assets/Resources/UI_PassportHudPhotoHeader.png 개별 배치용 왼쪽 사진/정보 박스 상단 장식 PNG
Assets/Resources/UI_PassportHudPhotoRouteBox.png 개별 배치용 왼쪽 항공권 경로 박스 PNG
Assets/Resources/UI_PassportHudPhotoInfoStrip.png 개별 배치용 왼쪽 항공권 정보줄 PNG
Assets/Resources/UI_PassportHudLifeCircleFrame.png 개별 배치용 HP 원형 프레임 PNG
Assets/Resources/UI_PassportHudItemSlotFrame.png 개별 배치용 아이템 네모 슬롯 프레임 PNG
Assets/Resources/UI_PassportHudFlightMarker.png 개별 배치용 비행기 표시 라인 PNG
Assets/Resources/UI_PassportHudItemMarker.png 개별 배치용 물건 표시 라인 PNG
Assets/ConceptArt/left_hud_passport_horizontal_grid_panel_concept_01.png 가로형 여권 2줄 그리드 HUD 컨셉 원본
Assets/ConceptArt/left_hud_passport_horizontal_grid_panel_split_concept_01.png 오른쪽 요소를 비워두고 분리 배치하도록 수정한 현재 컨셉
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는 투명 여백을 줄이기 위해 태그 경계 기준으로 크롭했고, 맵에 따라 한국/일본/중국/미국 라벨을 자동으로 바꿔 끼웁니다. 표시 정보는 DISTMILE 두 가지입니다.

파일 용도
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

결과 화면은 보딩패스형 정산표처럼 필요한 정보만 간추려 보여줍니다. 큰 텍스트와 수치 정보는 이미지에 박지 않고 Unity UI 텍스트/아이콘으로 얹습니다.

파일 용도
Assets/Resources/UI_ResultBoardingPassPanel_New.png 현재 결과 화면 보딩패스 정산표 배경
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/ 맵별 보상 기념품 표시

보딩패스 배경 구성:

  • 왼쪽 큰 영역: 출국 성공! / 실패 문구, ICN -> FUK 같은 이동 경로, 출국 도장
  • 중앙 큰 박스: FROM/TO 공항 코드와 도시명
  • 중앙 하단 4칸: 항공편, 좌석, 로컬 탑승 시간, 클래스
  • 오른쪽 원 3개: 마일리지, 도착 시간, 이동 거리
  • 오른쪽 하단 3칸: 목적지, 보상, 보유 마일리지

Duty Free UI Assets

Assets/ConceptArt/duty_free_ui_parts_concept_01.png에서 배경을 제거하고 분리한 런타임용 PNG입니다.

파일 용도
Assets/Resources/UI_DutyFreeShopInteriorPanel.png 면세점 화면 배경
Assets/Resources/UI_DutyFreeShopWindowPanel.png 현재 적용 중인 면세점 상품 진열 창 패널
Assets/Resources/UI_DutyFreeProductCard_Brown.png 도시락 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Green.png 영양제 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Blue.png 미사용 예비 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Purple.png 마일리지 카드 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Brown_Clean.png 현재 적용 중인 도시락 세로형 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Green_Clean.png 현재 적용 중인 영양제 세로형 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Blue_Clean.png 미사용 예비 세로형 상품 카드 배경
Assets/Resources/UI_DutyFreeProductCard_Purple_Clean.png 현재 적용 중인 마일리지 카드 세로형 상품 카드 배경
Assets/Resources/UI_DutyFreeProductPriceTag.png 상품 아이템 옆 세로형 걸이 가격표 태그
Assets/Resources/UI_DutyFreeButton_PrimaryYellow.png 구매/장착 가능 버튼 배경
Assets/Resources/UI_DutyFreeButton_DisabledGray.png 비활성 버튼 배경
Assets/Resources/UI_DutyFreeBagSlotPanel.png 장착 슬롯 패널 장식
Assets/Resources/UI_DutyFreeBagSlot_Active.png 구매한 가방 슬롯의 빈칸 상태
Assets/Resources/UI_DutyFreeBagSlot_Inactive.png 아직 구매하지 않은 가방 슬롯의 비활성 상태
Assets/Resources/UI_DutyFreeBagSlot_Occupied.png 아이템이 장착된 슬롯의 가방 없는 상태
Assets/Resources/UI_DutyFreeAirportDirectionSign.png 공항 방향 표지판 장식
Assets/Resources/UI_DutyFreeWoodShelfPanel.png 빈 진열대 장식
Assets/Resources/UI_DutyFreeLockedWideSlot.png 잠금 상태 표시
Assets/Resources/UI_DutyFreeWarningWideSlot.png 구매/장착 불가 상태 표시
Assets/Resources/UI_DutyFreePriceStrip_Blue.png 가격/마일리지 표시 띠
Assets/Resources/UI_DutyFreePriceTag_LightBlue.png 가격 태그 장식
Assets/Resources/UI_DutyFreeItemCarouselStrip.png 하단 아이템 목록 장식

현재 면세점 상품 아이콘:

파일 용도
Assets/Sprites/DutyFree/DutyFree_Normal_Lunchbox.png 도시락 상품 아이콘
Assets/Sprites/DutyFree/DutyFree_Normal_Supplement.png 영양제 상품 아이콘
Assets/Sprites/DutyFree/DutyFree_Normal_MileageCard.png 마일리지 카드 상품 아이콘
Assets/Sprites/DutyFree/DutyFree_Normal_Backpack.png 가방 업그레이드 아이콘

DutyFree_*_ShieldCharm.png, DutyFree_*_Shoes.png는 이전 기획용 이미지로 남아 있지만 현재 로직에서는 사용하지 않습니다.

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_Mileage_Card.png 마일리지 카드 공통 아이콘
Assets/Sprites/Items/Item_Lunchbox.png 이전 도시락 아이콘
Assets/Sprites/Items/Item_Backpack.png 이전 가방/슬롯 확장 아이콘
Assets/Sprites/Items/Item_Souvenir_Magnet.png 기념품

Item_Shield.png, Item_Speed_Shoes.png는 현재 아이템 로직에서 제외한 레거시 이미지입니다.

Regional Items

Assets/Sprites/RegionalItems/에 국가별 음식/소품 아이템이 있습니다.

  • 한국/공항: 김밥, 바나나우유, 에너지 드링크
  • 일본: 초밥, 라멘, 에너지 드링크
  • 중국: 만두, 훠궈, 에너지 드링크
  • 미국: 버거, 핫도그, 에너지 드링크

현재 GameplayItemCatalog가 맵 스킨에 따라 회복/무적/에너지 드링크 이미지를 선택합니다. 붕어빵, 교통카드, 말차, 오니기리, 월병, 차, 도넛, 콜라는 이후 보상/수집용으로 활용할 수 있는 예비 에셋입니다.

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, ENERGY, x2 같은 피드백을 표시합니다.
  • 무적 아이템으로 충돌을 통과하면 피격 깜빡임 대신 SAFE 피드백을 표시합니다.

다음 방향:

  • 컨셉 시트에서 실제로 사용할 이펙트 PNG를 개별 스프라이트로 잘라 교체합니다.