Skip to content

altomar/gunlab

Repository files navigation

🔬 GunLab

FPS weapon analytics — spread cones, damage falloff, TTK, and recoil maps.

Compare any loadout at a glance. Built for the community.

GunLab screenshot

Live site MIT License Contributions welcome


Visualizations

View What it shows
Spread cone Top-down bullet spread per weapon, with damage falloff zones
Falloff chart Damage-per-hit across range brackets
TTK Time-to-kill at each range, with N/A where a weapon can't reliably kill
Recoil map Simulated 30-shot scatter pattern
Stat radar Spider chart — accuracy, damage, range, control, fire rate

Games

  • Battlefield 6 (placeholder data — help us source real values!)

More games coming. See CONTRIBUTING.md to add one.


Running locally

git clone https://github.com/YOUR_USERNAME/gunlab.git
cd gunlab
npm install
npm run dev

Open http://localhost:5173.


Deployment

Deployed automatically to Vercel on every push to main.

To set up your own:

  1. Fork this repo
  2. Create a free account at vercel.com
  3. Import the repo — Vercel auto-detects Vite, no config needed
  4. (Optional) Add a custom domain in Vercel → Settings → Domains

Roadmap

  • Real BF6 weapon data sourced from community wikis
  • Social share card (/share?weapon=m416&game=bf6)
  • Hip-fire vs ADS spread comparison
  • Bullet velocity over range
  • Suppressor impact overlay
  • Community weapon request form
  • Multi-game support (BF2042, Warzone, etc.)

Contributing

See CONTRIBUTING.md. Weapon data PRs especially welcome.


License

MIT — do what you want, credit appreciated.

About

FPS Weapon Analytics. isualize spread cones, damage falloff, TTK, and recoil patterns for FPS weapons. Compare any loadout at a glance.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors