feat: v0.4.0 - 대규모 도시 도로 네트워크 시스템
🏙️ 주요 변경사항 - 작은 서킷(~500 studs) → 대규모 도시 맵(2500x2500 studs)으로 완전 교체 - 3초 주행 문제 해결: 충분한 주행 공간 확보 🛣️ 도로 시스템 - 주요 간선도로 5개 (4-6차선): 동서/남북/대각선/강변도로 - 보조 도로 8개 (2-3차선): 각 구역별 분산 - 남북 연결도로 4개 - 차선 마킹 시스템 (흰색 차선) 🌊 강/하천 시스템 - 구불구불한 강 본류 6개 세그먼트 - 자연스러운 강둑 5개 - 교량 3개 (난간 포함) - 강변도로와 도심도로의 조화 🌃 환경 시스템 - 가로등 50개 (자동 조명) - 맵 경계 안전장치 (투명 벽) - 야간 분위기 연출 🎮 게임플레이 개선 - 아이템 확장: OilCan 10개, BoostPad 6개, RepairKit 4개 - 맵 전역 분산 배치 및 회전 애니메이션 - 스타트라인 체커보드 패턴 - 차량 스폰 위치 조정 📊 맵 사양 - 크기: 2500x2500 studs (기존 대비 약 25배 증가) - 주행 가능 도로: 17개 구간 - 총 파트: 도로 17개 + 강 14개 + 교량 3개 + 가로등 50개 🎨 디자인 컨셉 변경 - 기존: "작은 서킷 위를 달리는 미래형 차량" - 신규: "대규모 도시를 질주하는 사이버포뮬러 차량" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
		
							
								
								
									
										102
									
								
								CLAUDE.md
									
									
									
									
									
								
							
							
						
						
									
										102
									
								
								CLAUDE.md
									
									
									
									
									
								
							| @@ -71,12 +71,15 @@ part.Parent = game.Workspace | |||||||
|  |  | ||||||
| ## ✨ 주요 기능 | ## ✨ 주요 기능 | ||||||
|  |  | ||||||
| ### 1. 트랙 시스템 | ### 1. 도로 시스템 (v0.4.0) | ||||||
| - 프로페셔널 서킷 디자인 | - **대규모 도시 도로 네트워크** (2500x2500 studs) | ||||||
| - 아스팔트 트랙 + 차선 마킹 | - 주요 간선도로 5개 (4-6차선) | ||||||
| - 빨강-흰 연석 (Kerbs) | - 보조 도로 8개 (2-3차선) | ||||||
| - 금속 가드레일 | - 남북 연결도로 4개 | ||||||
| - 스타트/피니시 라인 | - 차선 마킹 시스템 | ||||||
|  | - 강변도로 시스템 | ||||||
|  | - 교량 3개 (난간 포함) | ||||||
|  | - 스타트/피니시 라인 (체커보드 패턴) | ||||||
|  |  | ||||||
| ### 2. 차량 시스템 | ### 2. 차량 시스템 | ||||||
| - 사이버포뮬러 스타일 (네온 효과) | - 사이버포뮬러 스타일 (네온 효과) | ||||||
| @@ -91,10 +94,12 @@ part.Parent = game.Workspace | |||||||
| - 부스트 소모: 30% / 회복: 초당 5% | - 부스트 소모: 30% / 회복: 초당 5% | ||||||
| - 엔진 블로우 메커니즘 (10% 이하 강제 부스트) | - 엔진 블로우 메커니즘 (10% 이하 강제 부스트) | ||||||
|  |  | ||||||
| ### 4. 아이템 시스템 | ### 4. 아이템 시스템 (v0.4.0 확장) | ||||||
| - ⛽ **오일 캔** (x4): 오일 +50% 회복 | - ⛽ **오일 캔** (x10): 오일 +50% 회복 | ||||||
| - 🚀 **부스트 패드** (x4): 강력 가속 | - 🚀 **부스트 패드** (x6): 강력 가속 | ||||||
| - 🔧 **리페어 킷** (x2): 엔진 즉시 수리 + 오일 100% | - 🔧 **리페어 킷** (x4): 엔진 즉시 수리 + 오일 100% | ||||||
|  | - 맵 전역에 분산 배치 | ||||||
|  | - 회전 애니메이션 효과 | ||||||
|  |  | ||||||
| ### 5. UI 시스템 | ### 5. UI 시스템 | ||||||
| - 오일 게이지 (색상 변화) | - 오일 게이지 (색상 변화) | ||||||
| @@ -118,6 +123,13 @@ part.Parent = game.Workspace | |||||||
| - 자신의 순위 하이라이트 | - 자신의 순위 하이라이트 | ||||||
| - 최대 8명 멀티플레이어 지원 | - 최대 8명 멀티플레이어 지원 | ||||||
|  |  | ||||||
|  | ### 8. 환경 시스템 (v0.4.0 신규) | ||||||
|  | - 강(하천) 시스템 (구불구불한 자연스러운 형태) | ||||||
|  | - 강둑 및 교량 시스템 | ||||||
|  | - 가로등 50개 (자동 조명) | ||||||
|  | - 맵 경계 안전장치 | ||||||
|  | - 강변도로와 도심도로의 조화 | ||||||
|  |  | ||||||
| ## 🎮 조작법 | ## 🎮 조작법 | ||||||
|  |  | ||||||
| - **W**: 전진 | - **W**: 전진 | ||||||
| @@ -127,19 +139,22 @@ part.Parent = game.Workspace | |||||||
| - **F**: 부스트 발동 | - **F**: 부스트 발동 | ||||||
| - **Space**: 차량 하차 | - **Space**: 차량 하차 | ||||||
|  |  | ||||||
| ## 📁 프로젝트 구조 | ## 📁 프로젝트 구조 (v0.4.0) | ||||||
|  |  | ||||||
| ``` | ``` | ||||||
| Workspace/ | Workspace/ | ||||||
| ├── RacingCircuit/              # 서킷 트랙 | ├── CityRoads/                  # 도시 도로 네트워크 (2500x2500) | ||||||
| │   ├── HomeStretch             # 홈 스트레이트 | │   ├── EastWestMainRoad        # 동서 주간선도로 (6차선) | ||||||
| │   ├── BackStretch             # 백 스트레이트 | │   ├── NorthSouthMainRoad      # 남북 주간선도로 (5차선) | ||||||
| │   ├── Turn1_2, Turn3_4        # 코너 | │   ├── RiversideRoad1_2        # 강변도로 (4차선) | ||||||
| │   ├── LaneLines/              # 차선 | │   ├── DiagonalMainRoad        # 대각선 간선도로 (5차선) | ||||||
| │   ├── Kerbs                   # 연석 | │   ├── SecondaryRoad[1-8]      # 보조도로 (2-3차선) | ||||||
| │   ├── Guardrails              # 가드레일 | │   ├── VerticalConnector[1-4]  # 남북 연결도로 | ||||||
| │   ├── LightTowers             # 조명 | │   └── StreetLights (x50)      # 가로등 시스템 | ||||||
| │   └── StartLine               # 스타트/피니시 라인 | ├── River/                      # 강 시스템 | ||||||
|  | │   ├── RiverSegment[1-6]       # 강 본류 | ||||||
|  | │   ├── Riverbank[1-5]          # 강둑 | ||||||
|  | │   └── Bridge[1-3]             # 교량 및 난간 | ||||||
| ├── SimpleCyberCar/             # 차량 모델 | ├── SimpleCyberCar/             # 차량 모델 | ||||||
| │   ├── Chassis                 # 차체 | │   ├── Chassis                 # 차체 | ||||||
| │   ├── DriveSeat               # 운전석 | │   ├── DriveSeat               # 운전석 | ||||||
| @@ -150,10 +165,11 @@ Workspace/ | |||||||
| │       ├── BoostSound          # 부스트 효과음 | │       ├── BoostSound          # 부스트 효과음 | ||||||
| │       ├── PickupSound         # 아이템 획득 | │       ├── PickupSound         # 아이템 획득 | ||||||
| │       └── BlowSound           # 엔진 블로우 | │       └── BlowSound           # 엔진 블로우 | ||||||
| └── Items/                      # 아이템 | ├── Items/                      # 아이템 (맵 전역 분산) | ||||||
|     ├── OilCan (x4) | │   ├── OilCan (x10) | ||||||
|     ├── BoostPad (x4) | │   ├── BoostPad (x6) | ||||||
|     └── RepairKit (x2) | │   └── RepairKit (x4) | ||||||
|  | └── StartLine                   # 스타트/피니시 라인 (체커보드) | ||||||
|  |  | ||||||
| StarterPlayer/ | StarterPlayer/ | ||||||
| └── StarterCharacterScripts/ | └── StarterCharacterScripts/ | ||||||
| @@ -181,11 +197,12 @@ ServerScriptService/ | |||||||
| ## 🎯 게임플레이 | ## 🎯 게임플레이 | ||||||
|  |  | ||||||
| 1. **차량 탑승**: 네온 차량에 접근해서 클릭 | 1. **차량 탑승**: 네온 차량에 접근해서 클릭 | ||||||
| 2. **레이싱**: WASD로 서킷을 주행 | 2. **도시 레이싱**: WASD로 대규모 도시 도로 네트워크 주행 (2500x2500 studs) | ||||||
| 3. **부스트 관리**: F 키로 부스트, 오일 게이지 주의 | 3. **부스트 관리**: F 키로 부스트, 오일 게이지 주의 | ||||||
| 4. **아이템 수집**: 트랙의 아이템으로 오일 회복 | 4. **아이템 수집**: 맵 곳곳의 아이템으로 오일 회복 및 부스트 | ||||||
| 5. **랩타임 도전**: 스타트라인을 통과하며 기록 측정 | 5. **랩타임 도전**: 스타트라인을 통과하며 기록 측정 | ||||||
| 6. **주의**: 오일 10% 이하에서 부스트 → 엔진 블로우! | 6. **환경 탐험**: 강변도로, 교량, 도심 간선도로 등 다양한 환경 | ||||||
|  | 7. **주의**: 오일 10% 이하에서 부스트 → 엔진 블로우! | ||||||
|  |  | ||||||
| ## 🔧 기술 스택 | ## 🔧 기술 스택 | ||||||
|  |  | ||||||
| @@ -216,12 +233,33 @@ ServerScriptService/ | |||||||
| - [x] 사운드 이펙트 | - [x] 사운드 이펙트 | ||||||
| - [x] 랩타임 시스템 | - [x] 랩타임 시스템 | ||||||
| - [x] 리더보드 시스템 | - [x] 리더보드 시스템 | ||||||
|  | - [x] 대규모 도시 도로 네트워크 (v0.4.0) | ||||||
|  | - [x] 강/하천 시스템 (v0.4.0) | ||||||
| - [ ] UI 정리 및 레이아웃 최적화 | - [ ] UI 정리 및 레이아웃 최적화 | ||||||
| - [ ] 추가 서킷 맵 | - [ ] 교통 시스템 (신호등, 표지판) | ||||||
| - [ ] 타임 어택 모드 | - [ ] 타임 어택 모드 | ||||||
|  | - [ ] 미니맵 시스템 | ||||||
|  |  | ||||||
| ## 📝 버전 히스토리 | ## 📝 버전 히스토리 | ||||||
|  |  | ||||||
|  | ### v0.4.0 (2025-10-07) | ||||||
|  | - ✅ **대규모 도시 도로 네트워크** (2500x2500 studs) | ||||||
|  |   - 주요 간선도로 5개 (4-6차선) | ||||||
|  |   - 보조 도로 8개 (2-3차선) | ||||||
|  |   - 남북 연결도로 4개 | ||||||
|  | - ✅ **강/하천 시스템** | ||||||
|  |   - 구불구불한 강 본류 6개 세그먼트 | ||||||
|  |   - 강둑 5개 | ||||||
|  |   - 교량 3개 (난간 포함) | ||||||
|  | - ✅ **환경 시스템** | ||||||
|  |   - 가로등 50개 (자동 조명) | ||||||
|  |   - 맵 경계 안전장치 | ||||||
|  |   - 강변도로와 도심도로 조화 | ||||||
|  | - ✅ **아이템 확장** | ||||||
|  |   - 오일캔 10개, 부스트패드 6개, 리페어킷 4개 | ||||||
|  |   - 맵 전역 분산 배치 | ||||||
|  | - ✅ 기존 작은 서킷을 대규모 도시 맵으로 완전 교체 | ||||||
|  |  | ||||||
| ### v0.3.0 (2025-10-07) | ### v0.3.0 (2025-10-07) | ||||||
| - ✅ 리더보드 시스템 (실시간 순위표) | - ✅ 리더보드 시스템 (실시간 순위표) | ||||||
| - ✅ 멀티플레이어 지원 (최대 8명) | - ✅ 멀티플레이어 지원 (최대 8명) | ||||||
| @@ -244,11 +282,13 @@ ServerScriptService/ | |||||||
|  |  | ||||||
| ## 🎨 디자인 컨셉 | ## 🎨 디자인 컨셉 | ||||||
|  |  | ||||||
| **컨셉**: "일반 서킷 위를 달리는 미래형 네온 차량" | **v0.4.0 컨셉**: "대규모 도시를 질주하는 사이버포뮬러 차량" | ||||||
|  |  | ||||||
| - 트랙: 리얼리스틱한 F1 스타일 서킷 | - 맵: 실제 도시 스케일의 도로 네트워크 (2500x2500 studs) | ||||||
|  | - 환경: 강변도로, 교량, 도심 간선도로, 가로등이 있는 야간 분위기 | ||||||
| - 차량: 사이버포뮬러 애니메이션 스타일 (네온 효과) | - 차량: 사이버포뮬러 애니메이션 스타일 (네온 효과) | ||||||
| - 대비: 현실적 배경 + 미래적 차량 = 시각적 임팩트 | - 대비: 현실적 도시 환경 + 미래적 차량 = 극대화된 시각적 임팩트 | ||||||
|  | - 게임플레이: 3초 주행으로 지나가는 작은 서킷 → 광활한 도시 탐험 | ||||||
|  |  | ||||||
| ## 📄 라이선스 | ## 📄 라이선스 | ||||||
|  |  | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user