Skip to content

StreamTanks v0.0.1 — Initial Release

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Sep 11:13
v0.0.1
889c26c

🎮 StreamTanks v0.0.1 — Launch Release!

StreamTanks is an open-source, interactive Twitch chat artillery game and OBS browser overlay. Stream viewers join the battlefield via Twitch chat commands, pilot neon artillery tanks, aim angles and shot power, maneuver across dynamic destructible terrain, and compete for the stream leaderboard!

✨ Highlights & Features

  • 🚀 Single Self-Contained Binary: All web frontend assets (HTML, JavaScript, CSS) are compiled directly into the binary via //go:embed. No web server setup or dependencies required!
  • 🎨 Neon Cyberpunk Aesthetic: Designed specifically as a transparent 1920x1080 OBS Studio browser overlay with glowing neon terrain, aiming protractors, and explosive particle physics.
  • 💥 Dynamic Destructible Hills: Projectiles carve craters out of rolling hills in real-time, changing lines of sight and causing tanks to tumble down cliff faces.
  • ⚡ Bouncy Walls Mode: Optional %bouncywalls on adds frantic ricochet physics with a +10% speed boost to bouncing bullets and a +50% speed boost to tanks that ram the edges!
  • 🏆 Embedded SQLite Leaderboard: Player win statistics are tracked locally in streamtanks.db and persist automatically across stream sessions and server restarts.
  • ⚙️ On-Screen Live Config Modal: Streamers and moderators can toggle %config directly on the stream to view and modify game settings live.
  • 🛡️ OBS Reconnection Resilience: If the server stops or restarts during stream, the browser overlay hides transparently, polls in the background, and seamlessly reloads when the server comes back online.
  • 🧪 Offline Debug Mode: Test everything offline without connecting to Twitch by launching with -debug. A floating command console and practice target bot let you experiment immediately.

🕹️ Twitch Chat Command Quick Reference

Command Description Example
%join [emote] Join the battlefield (supports Twitch & channel emotes) %join Kappa
%startgame Starts a match from the waiting phase %startgame
%fire <angle> <power> Locks in cannon aim angle (0°–180°) and power (1–100) %fire 60 75
%left / %right Maneuvers your tank across the hills %left
%config Displays on-screen stream configuration modal %config
%bouncywalls on|off Toggles bouncy screen walls (+10% bullet speed, +50% tank speed) %bouncywalls on
%speed <0.1 - 3.0> Adjusts physics and animation speed (default: 0.5x) %speed 0.8
%commandtime <seconds> Configures input countdown timer (5s–120s, default: 20s) %commandtime 15
%autoround <min|-1|off> Schedules automated match starts (-1 immediate, off manual) %autoround 3
%idlemessage on|off Toggles visibility of the idle waiting HUD and leaderboard %idlemessage off
%prefix <symbol> Customizes command prefix (e.g. !, ?, tank!) %prefix !

🚀 Getting Started

  1. Download and extract the archive for your operating system below (e.g. StreamTanks_windows_amd64.zip).
  2. Run the executable from your terminal or command prompt: 
    ./StreamTanks -channel your_twitch_channel
    (Or run ./StreamTanks -debug to test offline).
  3. In OBS Studio, add a new Browser Source:
    • URL: http://localhost:8102
    • Width: 1920
    • Height: 1080
  4. The background is completely transparent—your stream game or camera will show through clearly behind the battlefield. Have fun!
Assets 8
Loading