# 🏎️ 사이버포뮬러 레이싱 게임

로블록스 스튜디오로 제작한 사이버포뮬러 스타일 레이싱 게임

## 📋 프로젝트 개요

- **플랫폼**: 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