..

.gitignore

@@ -1 +1,16 @@
+# Roblox Studio
 *.lock
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*~
+*.tmp
+*.temp
+
+# Backup files
+*.bak
+*.backup

README.md

@@ -0,0 +1,138 @@
+# 🏎️ 사이버포뮬러 레이싱 게임
+
+로블록스 스튜디오로 제작한 사이버포뮬러 스타일 레이싱 게임
+
+## 📋 프로젝트 개요
+
+- **플랫폼**: Roblox Studio
+- **언어**: Lua
+- **스타일**: 사이버포뮬러 (Future GPX Cyber Formula)
+- **장르**: 레이싱, 멀티플레이어
+
+## ✨ 주요 기능
+
+### 1. 트랙 시스템
+- 프로페셔널 서킷 디자인
+- 아스팔트 트랙 + 차선 마킹
+- 빨강-흰 연석 (Kerbs)
+- 금속 가드레일
+- 스타트/피니시 라인
+
+### 2. 차량 시스템
+- 사이버포뮬러 스타일 (네온 효과)
+- 커스텀 운전 시스템 (WASD)
+- 안정성 시스템 (전복 방지)
+- 헤드라이트/테일라이트
+
+### 3. 부스트 시스템
+- **F 키** 발동
+- 오일 게이지 관리 (100%)
+- 부스트 소모: 30% / 회복: 초당 5%
+- 엔진 블로우 메커니즘 (10% 이하 강제 부스트)
+
+### 4. 아이템 시스템
+- ⛽ **오일 캔** (x4): 오일 +50% 회복
+- 🚀 **부스트 패드** (x4): 강력 가속
+- 🔧 **리페어 킷** (x2): 엔진 즉시 수리 + 오일 100%
+
+## 🎮 조작법
+
+- **W**: 전진
+- **S**: 후진
+- **A**: 왼쪽 회전
+- **D**: 오른쪽 회전
+- **F**: 부스트 발동
+- **Space**: 차량 하차
+
+## 📁 프로젝트 구조
+Workspace/
+├── RacingCircuit/              # 서킷 트랙
+│   ├── HomeStretch             # 홈 스트레이트
+│   ├── BackStretch             # 백 스트레이트
+│   ├── Turn1_2, Turn3_4        # 코너
+│   ├── LaneLines/              # 차선
+│   ├── Kerbs                   # 연석
+│   ├── Guardrails              # 가드레일
+│   └── LightTowers             # 조명
+├── SimpleCyberCar/             # 차량 모델
+│   ├── Chassis                 # 차체
+│   ├── DriveSeat               # 운전석
+│   ├── Wheels (x4)             # 바퀴
+│   └── NeonLines               # 네온 장식
+└── Items/                      # 아이템
+├── OilCan (x4)
+├── BoostPad (x4)
+└── RepairKit (x2)
+StarterPlayer/
+└── StarterCharacterScripts/
+└── VehicleControl          # 메인 운전 스크립트
+ReplicatedStorage/
+├── OilPickup                   # 오일 아이템 이벤트
+└── RepairPickup                # 리페어 아이템 이벤트
+
+## 🎯 게임플레이
+
+1. **차량 탑승**: 네온 차량에 접근해서 클릭
+2. **레이싱**: WASD로 서킷을 주행
+3. **부스트 관리**: F 키로 부스트, 오일 게이지 주의
+4. **아이템 수집**: 트랙의 아이템으로 오일 회복
+5. **주의**: 오일 10% 이하에서 부스트 → 엔진 블로우!
+
+## 🔧 기술 스택
+
+- **Lua**: 게임 로직
+- **Roblox Studio**: 게임 엔진
+- **BodyVelocity/BodyGyro**: 차량 물리
+- **HingeConstraint**: 바퀴 회전
+- **RemoteEvent**: 클라이언트-서버 통신
+- **ParticleEmitter**: 부스트 효과
+
+## 📊 게임 밸런스
+
+| 항목 | 값 |
+|------|-----|
+| 기본 속도 | 80 |
+| 부스트 속도 | 160 (2배) |
+| 후진 속도 | 40 |
+| 조향 각도 | 5° |
+| 부스트 지속 | 3초 |
+| 부스트 소모 | 30% |
+| 오일 회복 | 초당 5% |
+| 엔진 블로우 | 10초 정지 |
+
+## 🚀 TODO
+
+- [ ] UI 시스템 (오일 게이지, 속도계)
+- [ ] 멀티플레이어 최적화
+- [ ] 사운드 이펙트
+- [ ] 추가 서킷 맵
+- [ ] 리더보드 시스템
+- [ ] 타임 어택 모드
+
+## 📝 버전 히스토리
+
+### v0.1.0 (2025-01-XX)
+- ✅ 일반 서킷 트랙 구현
+- ✅ 사이버포뮬러 스타일 차량
+- ✅ 오일 게이지 부스트 시스템
+- ✅ 엔진 블로우 메커니즘
+- ✅ 아이템 시스템 (3종)
+- ✅ 차량 안정성 시스템
+
+## 🎨 디자인 컨셉
+
+**컨셉**: "일반 서킷 위를 달리는 미래형 네온 차량"
+
+- 트랙: 리얼리스틱한 F1 스타일 서킷
+- 차량: 사이버포뮬러 애니메이션 스타일 (네온 효과)
+- 대비: 현실적 배경 + 미래적 차량 = 시각적 임팩트
+
+## 📄 라이선스
+
+MIT License
+
+## 👨‍💻 개발자
+
+- 개발: Claude + tindevil82
+- 플랫폼: Roblox Studio
+- 개발 기간: 2025