Apppublic

fantos/3D-Airforce-Simulator

sourceHugging Facecc-by-nc-4.0updated 1y agoView on Hugging Face

0likes

App README

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 재생 지연
—고사양 그래픽 설정에서 프레임 드롭 가능
—플레어 효과가 간혹 미사일을 완벽히 회피하지 못할 수 있음