README.md

metadata

title: 3D Air Combat Simulator
emoji: 🌐
colorFrom: blue
colorTo: yellow
sdk: static
pinned: false
license: cc-by-nc-4.0
short_description: One-minute creation by AI Coding Autonomous Agent 'MOUSE-I'

3D Air Combat Simulator

link: https://huggingface.co/spaces/cutechicken/3D-Airforce-Simulator Developer: https://huggingface.co/spaces/cutechicken

🎮 Project Overview

A high-quality web-based 3D fighter jet simulator created with VIBE CODING. Built with Three.js, this is a full-scale aerial combat game that runs in your browser, featuring realistic physics engine and combat systems.

✨ Key Features

🛩️ Realistic Flight Physics

• Real Aircraft Dynamics Simulation: Realistic flight considering lift, gravity, and drag
• G-Force System: Blackout effects during extreme maneuvers
• Stall System: Loss of control when speed drops below threshold
• Altitude-based Performance: G-Force increases with altitude

🎯 Combat System

• 20mm Cannon: 940 rounds, continuous fire capability
• AIM-9 Sidewinder Missiles: 8 missiles with 3-stage lock-on system
• Flare System: Heat-seeking countermeasures (3 uses)
• Enemy AI: Smart AI capable of evasive maneuvers, missile launches, and flare deployment

🎨 Immersive HUD

• Fighter HUD: Speed, altitude, heading, pitch/roll indicators
• RWR (Radar Warning Receiver): Enemy position and lock-on warnings
• Pitch Ladder: Aircraft attitude display
• Target Markers: Automatic enemy marking within crosshair

🔊 Sound Design

• Engine sounds, cannon fire, missile launches
• Warning system (altitude, stall, Over-G, missile alerts)
• Voice guidance system
• Distance-based volume control

🎮 Controls

Basic Controls

• W/S: Throttle increase/decrease
• A/D: Rudder (yaw) control
• Mouse: Pitch/roll control
• Left Click: Fire weapon
• R: Switch weapon (Cannon ↔ Missile)
• F: Deploy flares
• G: Escape stall (hold for 2 seconds)

Combat Tips

1. Missile Lock: Keep enemy in crosshair for 3 seconds in AIM-9 mode
2. Flare Usage: Press F immediately when missile warning sounds
3. Over-G Warning: Level out when vision darkens during extreme maneuvers
4. Stall Recovery: Hold G for 2 seconds when speed drops below 300kt

🚀 Installation & Setup

Requirements

• Modern web browser (Chrome, Firefox, Edge recommended)
• WebGL support
• Mouse required

📁 Project Structure

3D-Airforce-Simulator/
├── index.html          # Main HTML (HUD and UI)
├── game.js            # Game logic (physics, AI, combat systems)
├── models/            # 3D model files
│   ├── f-15.glb      # Player fighter
│   └── mig-29.glb    # Enemy fighter
├── sounds/            # Sound files
│   ├── main.ogg      # BGM
│   ├── normal.ogg    # Engine sound
│   └── ...           # Various sound effects
└── effects/          # Visual effects
    └── symbol.png    # RWR symbol

🛠️ Tech Stack

• Three.js: 3D graphics rendering
• Vanilla JavaScript: Game logic
• Web Audio API: Sound processing
• Pointer Lock API: Mouse control

🎯 Game Objectives

• Mission: Destroy all enemy aircraft (4) within 180 seconds
• Victory Conditions:
  • Destroy all enemies
  • Survive time limit + destroy all enemies
• Defeat Conditions:
  • Health reaches 0 (hit/collision)
  • Ground collision
  • Time expires with enemies remaining

🏆 Scoring System

• Cannon kill: 100 points
• Missile kill: 100 points
• Collision kill: 200 points

💡 VIBE CODING Achievement

This project was created using the VIBE CODING methodology. Through rapid prototyping and immediate feedback, we achieved a high-quality 3D fighter jet simulator.

Special Features

• Complete game engine in a single JavaScript file
• Real-time physics simulation
• Complex AI behavior patterns
• Professional HUD system
• Immersive sound design

🐛 Known Issues

• BGM playback delay due to autoplay policies in some browsers
• Possible frame drops on high graphics settings
• Flares may occasionally fail to perfectly evade missiles

3D Air Combat Simulator : 3D 전투기 시뮬레이터

link: https://huggingface.co/spaces/cutechicken/3D-Airforce-Simulator 개발자: https://huggingface.co/spaces/cutechicken

🎮 프로젝트 소개

VIBE CODING으로 제작된 완성도 높은 웹 기반 3D 전투기 시뮬레이터입니다. Three.js를 활용하여 브라우저에서 실행되는 본격적인 공중전 게임으로, 실제 전투기의 물리 엔진과 전투 시스템을 구현했습니다.

✨ 주요 특징

🛩️ 리얼리스틱한 비행 물리

• 실제 항공기 역학 시뮬레이션: 양력, 중력, 항력을 고려한 현실적인 비행
• G-Force 시스템: 급기동 시 블랙아웃 효과 구현
• 스톨(실속) 시스템: 속도 부족 시 조종 불능 상태 재현
• 고도별 성능 변화: 고도에 따른 G-Force 증가

🎯 전투 시스템

• 20mm 기관포: 940발 탄약, 연사 가능
• AIM-9 사이드와인더 미사일: 8발 장착, 3단계 락온 시스템
• 플레어 시스템: 미사일 회피용 열추적 교란 장치 (3회 사용)
• 적기 AI: 회피 기동, 미사일 발사, 플레어 사용 가능한 스마트 AI

🎨 몰입감 있는 HUD

• 전투기 HUD: 속도, 고도, 헤딩, 피치/롤 표시
• RWR (레이더 경보 수신기): 적기 위치 및 락온 경고
• 피치 래더: 항공기 자세 표시
• 타겟 마커: 크로스헤어 내 적기 자동 표시

🔊 사운드 디자인

• 엔진음, 기관포, 미사일 발사음
• 경고음 시스템 (고도, 스톨, Over-G, 미사일 경고)
• 음성 안내 시스템
• 거리별 음량 조절

🎮 조작법

기본 조작

• W/S: 스로틀 증가/감소
• A/D: 러더 (요) 조작
• 마우스: 피치/롤 조작
• 좌클릭: 무기 발사
• R: 무기 전환 (기관포 ↔ 미사일)
• F: 플레어 발사
• G: 스톨 탈출 (2초간 유지)

전투 팁

1. 미사일 락온: AIM-9 모드에서 적기를 크로스헤어에 3초간 유지
2. 플레어 사용: 미사일 경고음이 들리면 즉시 F키로 플레어 발사
3. Over-G 주의: 급기동 시 시야가 어두워지면 수평 비행으로 회복
4. 스톨 회복: 속도 300kt 이하에서 G키를 2초간 눌러 회복

🚀 설치 및 실행

요구사항

• 최신 웹 브라우저 (Chrome, Firefox, Edge 권장)
• WebGL 지원
• 마우스 필수

📁 프로젝트 구조

3D-Airforce-Simulator/
├── index.html          # 메인 HTML (HUD 및 UI)
├── game.js            # 게임 로직 (물리, AI, 전투 시스템)
├── models/            # 3D 모델 파일
│   ├── f-15.glb      # 플레이어 전투기
│   └── mig-29.glb    # 적 전투기
├── sounds/            # 사운드 파일
│   ├── main.ogg      # BGM
│   ├── normal.ogg    # 엔진음
│   └── ...           # 각종 효과음
└── effects/          # 시각 효과
    └── symbol.png    # RWR 심볼

🛠️ 기술 스택

• Three.js: 3D 그래픽 렌더링
• Vanilla JavaScript: 게임 로직
• Web Audio API: 사운드 처리
• Pointer Lock API: 마우스 컨트롤

🎯 게임 목표

• 미션: 180초 내에 모든 적기(4대) 격추
• 승리 조건:
  • 모든 적기 파괴
  • 시간 내 생존 + 모든 적기 파괴
• 패배 조건:
  • 체력 0 (피격/충돌)
  • 지면 충돌
  • 시간 초과 시 적기 잔존

🏆 점수 시스템

• 기관포 격추: 100점
• 미사일 격추: 100점
• 충돌 격추: 200점

💡 VIBE CODING의 결과물

이 프로젝트는 VIBE CODING 방법론으로 제작되었습니다. 빠른 프로토타이핑과 즉각적인 피드백을 통해 높은 완성도의 3D 전투기 시뮬레이터를 구현했습니다.

특별한 점

• 단일 JavaScript 파일로 구현된 완전한 게임 엔진
• 실시간 물리 시뮬레이션
• 복잡한 AI 행동 패턴
• 전문적인 HUD 시스템
• 몰입감 있는 사운드 디자인

🐛 알려진 이슈

• 일부 브라우저에서 자동 재생 정책으로 인한 BGM 재생 지연
• 고사양 그래픽 설정에서 프레임 드롭 가능
• 플레어 효과가 간혹 미사일을 완벽히 회피하지 못할 수 있음