From cfb840284610712855d9441be92d35c489ecb111 Mon Sep 17 00:00:00 2001
From: LGram16 <tindevil82@gmail.com>
Date: Tue, 7 Oct 2025 19:39:59 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20v0.4.0=20-=20=EB=8C=80=EA=B7=9C?=
 =?UTF-8?q?=EB=AA=A8=20=EB=8F=84=EC=8B=9C=20=EB=8F=84=EB=A1=9C=20=EB=84=A4?=
 =?UTF-8?q?=ED=8A=B8=EC=9B=8C=ED=81=AC=20=EC=8B=9C=EC=8A=A4=ED=85=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🏙️ 주요 변경사항
- 작은 서킷(~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>
---
 CLAUDE.md | 102 +++++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 71 insertions(+), 31 deletions(-)

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