Skip to content

not-GIANT/Jet-Follower

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jet Follower Banner

Python License: MIT Platform FPS Status

A high-performance fighter jet that hunts your cursor — armed, dangerous, and physics-accurate.

⬇ Download .exe · 📖 Installation · ⚙️ Configure


What Is This?

Jet Follower is a tkinter-based desktop toy that renders a fully animated fighter jet chasing your cursor across the screen — including across multiple monitors. Under the hood it runs a real physics simulation: velocity LERPing, angular momentum, afterburner states, and an autonomous dual-weapon combat system that fires at your cursor without mercy.

This is not a simple "follow the mouse" widget. It's a miniature flight simulator with a weapons loadout.


✦ Feature Breakdown

🔬 Physics Engine

System Description
Velocity LERPing Smooth acceleration and deceleration — the jet carries momentum, not just position
Angular Momentum Curved turning arcs instead of instant snapping — the jet banks into its turns
Afterburner Logic Auto-engages on long-distance pursuit; flame switches from orange to high-intensity blue
Barrel Rolls Simulated 3D roll during high-G turns via oscillating polygon perspective

⚔️ Dual-Weapon Combat System

The jet proactively attacks your cursor — it's not just following you, it's hunting you.

Weapon Behavior
Tracer Burst Rapid-fire 25-bullet bursts with high-speed motion-blur trails
Homing Missiles Dual missiles with real-time pathfinding — they will find your cursor

Both weapons trigger impact effects: micro-explosions for bullets, multi-point heavy explosions for missile impacts.

🎨 Visual Effects

  • World-Space Smoke Trails — Particles calculated in global coordinates, drifting and lingering as the jet moves
  • 60 FPS Rendering — Optimized item pool management prevents CPU spikes
  • Persistent Particles — Smoke, fire, and debris all have their own physics lifecycle

🖥️ Multi-Monitor Support

  • Detects the full virtual desktop bounding box
  • Traverses screen edges seamlessly
  • Respawns from any screen edge after a fatal cursor-catch

⬇ Installation

Option A — Run the Executable (Windows, zero setup)

  1. Go to Releases
  2. Download Jet Follower.exe
  3. Run it. That's it.

Option B — Run from Source

Prerequisites: Python 3.8+ with tkinter (bundled with standard Python on Windows)

# Clone the repo
git clone https://github.com/not-GIANT/Jet-Follower.git
cd Jet-Follower

# Launch
python jet_follower.py

Or double-click Run Jet.bat if you prefer.


🕹️ Controls

Input Action
Move mouse Jet tracks your cursor with physics delay
ESC Close the application
Middle click Close the application
(automatic) Jet auto-respawns from a random screen edge after exploding

⚙️ Configuration

Every tunable parameter lives in the CONFIG dictionary at the top of jet_follower.py. Open it in any text editor and adjust to taste.

CONFIG = {
    "cursor_delay":      0.08,   # Input lag for the jet's reaction (lower = tighter)
    "max_speed":         18,     # Top velocity in pixels/frame
    "shoot_dist":        300,    # Range at which weapons engage
    "missile_turn_spd":  0.06,   # Missile tracking aggression (higher = sharper turns)
    "explosion_chance":  0.4,    # Probability of exploding on cursor contact
}
Parameter Effect
cursor_delay Higher = cinematic lag. Lower = razor-sharp tracking.
max_speed How fast the jet moves at full afterburner
shoot_dist Increase for a more aggressive jet
missile_turn_spd Raise for heat-seeker accuracy; lower for lazy arcs
explosion_chance Set to 1.0 for guaranteed destruction on cursor-catch

🗂️ Project Structure

Jet-Follower/
├── jet_follower.py      ← Main simulation — physics, rendering, weapons
├── Run Jet.bat          ← Windows launcher shortcut
├── Jet Follower.exe     ← Pre-compiled Windows binary
├── icon.png             ← Application icon
└── README.md

🛠️ Built With

  • Python 3 — Core language
  • tkinter — Rendering and window management (no external dependencies)
  • Pure math — All physics computed from scratch; no game engine or libraries

🗺️ Roadmap

  • Sound effects (engine roar, weapons fire, explosions)
  • Configurable jet skin / color scheme
  • Survival mode — how long can you dodge?
  • Linux / macOS support
  • Multiple jets simultaneously


Developed with ❤️ by GIANT

If it made you smile, drop a ⭐

About

A high-performance Python application built with tkinter that simulates a fighter jet tracking your cursor with advanced physics and visual effects.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors