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:
2025-10-07 19:39:59 +09:00
parent e7c7492f2f
commit cfb8402846

102
CLAUDE.md
View File

@@ -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초 주행으로 지나가는 작은 서킷 → 광활한 도시 탐험
## 📄 라이선스 ## 📄 라이선스