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