Skip to content

TheM1ddleM1n/github-battleships

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚢 GitHub Battleships!

Welcome to GitHub Battleships — a turn-based game powered entirely by GitHub Issues and Actions/Secrets!

Sink ships, climb the leaderboard, and flex your strategic genius — all from the comfort from your own GitHub Account!


How to Play github-battleships?

  1. Open a new issue with your move in the title: Move: B4 or /move B4

(Only one move per issue, please! DO NOT SPAM consecutive cells like B4, B5, B6...)

  1. The bot will:
  • Check if your move is valid
  • Update the game board
  • Reply to your issue with the result: Hit!, Miss!, or Already Played
  • Award achievements for milestones

The Game Rules

  • The board is 10x10 (A–J rows, 1–10 columns)
  • Ships are hidden — you won't know their locations!
  • Hits are marked with 💥, misses with 🌊
  • First player to sink all ships wins eternal glory 👑
  • 2-hour cooldown between moves (reduced for active players! sorry lol!)
  • Strategic patterns may be detected - mix up your strategy!
  • Only Owner is allowed to have no cooldown (so he can test some new updates) :D
  • Track your stats! (on the all time or game leaderboard!)
  • MOST IMPORTANTLY DO NOT CHEAT!! or this game will become a failure lol

🎯 Current Game Board

1 2 3 4 5 6 7 8 9 10
A 🌊
B 🌊 💥 💥 💥 💥 💥 🌊
C
D
E
F 💥
G
H
I
J

🚢 Fleet Status

  • 🛳️ CARRIER (5 cells): 💀 SUNK
  • BATTLESHIP (4 cells): 🔥 1/4 damaged
  • 🔱 SUBMARINE (3 cells): ✅ Afloat
  • ⛴️ DESTROYER (2 cells): ✅ Afloat
  • 🛥️ PATROL (2 cells): ✅ Afloat

📊 Game Statistics

  • 🎯 Ship Cells Remaining: 10/16
  • 🎲 Total Moves: 9
  • 💥 Total Hits: 6
  • 🌊 Total Misses: 3
  • 📈 Community Accuracy: 66.7%
  • 👥 Active Players: 1

📜 Recent Moves

  • 💥 @TheM1ddleM1n: F7 - Hit (battleship)
  • 💥 @TheM1ddleM1n: B9 - Hit (carrier)
  • 💥 @TheM1ddleM1n: B8 - Hit (carrier)
  • 💥 @TheM1ddleM1n: B7 - Hit (carrier)
  • 💥 @TheM1ddleM1n: B6 - Hit (carrier)
  • 💥 @TheM1ddleM1n: B5 - Hit (carrier)
  • 🌊 @TheM1ddleM1n: B10 - Miss
  • 🌊 @TheM1ddleM1n: B2 - Miss
  • 🌊 @TheM1ddleM1n: A10 - Miss

🏅 Current Game Leaderboard

Rank Player 🖼️ Avatar 🏹 Hits 💦 Misses 🎯 Accuracy 🔥 Streak 🚢 Sunk
🥇 @TheM1ddleM1n 🔥 Hot Streak 🚢 Ship Sinker 6 3 0.67 6 1

👑 All-Time Leaderboard

Rank Player 🏹 Total Hits 🏆 Wins 🎮 Games 🔥 Best Streak 🚢 Ships Sunk
👑 @TheM1ddleM1n 8 0 0 6 1

🏆 Achievements

Unlock badges by hitting milestones!

  • 🎯 Sharpshooter - 80%+ accuracy with 10+ moves
  • 🔥 Hot Streak - 5 hits in a row
  • First Blood - Get the first hit of the game
  • 🚢 Ship Sinker - Sink your first ship
  • 💀 Fleet Destroyer - Sink 3 or more ships
  • 🏆 Victory Royale - Win a game

Powered By

  • GitHub Actions & Secrets
  • Python-based game logic
  • JSON-based state management
  • Your brilliant moves!

💬 Any Questions, Bugs or Ideas?

Open an issue titled Suggestion: or Question: and let's make this game even better!


Ready to fire your first shot? Open an issue and type your move now! 🎯

About

This is Battleships but in a GitHub repo! Enjoy and have fun! Feel free to ask any questions.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages