GG Tanks

v5.9.6
Play Beta Version

Credits

Code Editor:
Cursor (powered by vibes)

Programmers:
95% Claude 3.7 Think (does all the thinking)
4% Gemini 2.5 Pro (we let it press a button once)

Graphics Engine:
Three.js (making things pretty)

Physics Engine:
Cannon-es (making things go boom)

Main Menu Music by:
Riffusion (AI with rhythm)

Main Menu Art by:
GPT-4o (visionary pixels)

3 Braincelled Team IQ:
Mustafa Beken

Total Code:
Over 33,000 lines of pure tank mayhem

Game Roadmap

🚀 Game Roadmap (should all be implemented over the next week)

🔧 Core Gameplay Enhancements

  • Introduce a minimap to improve player awareness building
  • Add ability to tilt cannons up and down for vertical aiming control built, removed, planning
  • Rapid fire (will be visually styled in blue to avoid confusion with damage effects) planned
  • Introduce crosshairs, evolving with each weapon tier to reflect progression planned
  • Add health bars for clearer combat feedback planned
  • Show damage numbers above hit players for immediate impact feedback planned
  • Improve kill feedback with satisfying sounds and effects planned
  • Prevent walls from blocking vision when too close to the camera planned
  • Make map much nicer building
  • Ability to use victories to change your tank in meaningful ways, not just visual. Such as using victories as currency for permanent upgrades planning
  • Tank colors before spawning planned
  • We have auto kick after 5 mins, but we need auto spectator mode after 30 seconds planned
  • Engine sounds!! building
  • Auto Lobby/matchmaking with max users per room, with the ability to invite planned

🛠 Performance & Control Improvements

  • Optimize rapid fire performance to reduce lag building
  • Add Q/E rotate controls to arrow keys, supports for smoother gameplay building
  • Add sensitivity settings for better aiming control planned
  • Slow down ping refresh rate in the tab menu to reduce distraction building
  • Take advantage of all cores on the dedicated server planned

🎨 User Interface & Experience

  • Replace floating names with number plates on front and back of characters planned
  • Improve spree announcement volume and variety (ensure they're noticeable and satisfying) planned
  • Add music cues for key moments PLANNED!!!!!
  • Add tab menu sorting:
    • Sort by most victories, then by most kills building
    • Remove match kills stat planned

🤖 Bots & Matchmaking Logic

  • Automatically add AI opponents when only 1 human player is online testing
  • Ensure no AI spawns when there are 0 or more than 1 human players building

đŸŽ¯ Polishing & Progression

  • Crosshair design evolves as weapons improve planned
  • Add meaningful kill streak feedback and rewards planned
  • Ensure UI and audio cues reflect the intensity of late-game play planned

🌌 Vibejam Feature

  • Vibeportal testing

🐛 Known Bugs

  • Rare edge cases of spawning inside the (procedurally generated) terrain mesh planned
    • Current workaround: Refresh the page if this happens
    • Easy fix: Spawn players above the maximum terrain height, but this affects visuals
    • Working on a better algorithm to detect safe spawn positions

Changelog

🚀 Recent Updates

Current Beta Changes BETA ONLY

Here are some key improvements and fixes currently being tested in the beta version:

  • Damage Numbers: Added visible numbers when projectiles hit opponents.
  • Mute Icon: Optimized the mute button's appearance and function.
  • Server Authority: Enhanced server control for kill tracking and spree announcements.
  • Unique Player Names: Implemented name discriminators (e.g., Player#123) to fix spawning issues when multiple players had the same name.
  • Collision Detection: Improved collision checks to make it harder to shoot through solid objects.
  • Ramming Damage: Implemented server-controlled ramming damage for both the rammer and the target.
  • Smoke Effect Fix: Resolved an issue where the smoke effect could freeze visually after healing.
  • Frame Rate Independence (Effects): Ensured visual effects play consistently regardless of frame rate.
  • Frame Rate Independence (Rotation): Ensured player tank rotation speed is consistent regardless of frame rate.

April 2025: Performance Improvements

Removed point lights from projectiles to improve performance during rapid fire

ADDED:

  • Increased emissive intensity on projectiles (1.5x) to compensate for removed lights
  • Increased size of muzzle flash from 3x to 4x projectile size
  • Increased opacity of particle effects from 0.8 to 0.9 for better visibility

REMOVED:

  • Point lights on all projectiles
  • Muzzle flash point lights on weapon firing
  • Point lights on energy particles for high-tier weapons
  • Light-related code in updateEnergyParticle method

UPDATED:

  • Projectile.createMesh() method to use only emissive materials without lights
  • Vehicle.createMuzzleFlash() to rely solely on mesh effects
  • Projectile.createEnergyParticle() to use stronger emissive materials instead of lights

FIXED:

  • Performance degradation during rapid weapon firing
  • FPS drops when many projectiles are on screen at once
  • Rendering bottlenecks caused by excessive dynamic lighting

They looked great, but they were killing performance. This update significantly improves performance by removing all point lights from projectiles and weapon effects. Dynamic lighting is one of the most expensive rendering operations and was causing major FPS drops during rapid fire. The visual appearance is preserved by compensating with stronger emissive materials, larger meshes, and higher opacity values.

Game Settings

Graphics

Audio

Performance Monitoring

Game Controls

Game Objective

The objective is to eliminate opponents to advance through a series of weapons. Scoring a kill with the final weapon secures victory. However, if you die, you'll be downgraded by one weapon level.

Movement

W
Move Forward
S
Move Backward
A
Turn Left
D
Turn Right
SHIFT
Boost

Combat

Q
Rotate Turret Left
E
Rotate Turret Right
←
Turn Left + Rotate Turret Left
→
Turn Right + Rotate Turret Right
SPACE
Fire Weapon

Power-ups

Power-ups are automatically activated when collected. Currently, there are 2 types available:

đŸ”Ĩ
Rapid Fire - Increases weapon fire rate
⚡
Speed Boost - Increases movement speed

UI Controls

TAB
Show Scoreboard
ESC
Menu / Exit
🕹ī¸ Vibe Jam 2025 💡 Suggestions