Terminal Game Hub v2
by icehunter494
Terminal Game Hub A collection of multiple games that can all be played directly in the terminal. This project is designed to bundle a variety of classic and experimental games into one simple, lightweight hub without requiring a graphical interface. Requirements Python 3.8 or higher Windows Users The curses module is not included by default on Windows. You must install it manually: pip install windows-curses Game List Arcade / Real-Time Games Snake Pong (2-player) Breakout Asteroids Bullet Hell (work in progress) Strategy / Simulation Space Trader Stock Market Simulator Puzzle / Logic Games Sudoku Mastermind Word Scramble 2048 Connect 4 Minesweeper Classic / Casual Games Blackjack Battleship Rock Paper Scissors Ultimate Mad Libs Hangman Exploration / Other Roguelike Dungeon Crawler Maze Runner Featured Games Stock Market Simulator A dynamic trading simulation with: multiple stocks with volatility and trends bull and bear market cycles random news events affecting prices dividend payouts portfolio and net worth tracking Asteroids A real-time space shooter featuring: ship rotation and thrust physics bullet shooting system moving asteroids collision detection score tracking and restart system Breakout A brick-breaking arcade game with: paddle and ball physics destructible brick grid score tracking win/lose conditions Pong A two-player competitive game: local multiplayer controls score tracking win condition system Blackjack A terminal-based card game: hit and stand mechanics dealer AI proper scoring rules Adding New Games To add a new game: Create a .py file inside the /games folder Add one of the following entry functions: Standard game: def run(): Curses-based game: def run(stdscr): (Optional) Add a display name: GAME_NAME = "My Game" The hub will automatically detect and load the game. Controls Controls vary per game. Most games display their controls on launch. Common patterns include: Arrow keys for movement WASD for alternative controls Q to quit R to restart Notes All games are designed for terminal play only Some games require a sufficiently large terminal window Performance may vary depending on terminal and system Future Improvements Additional games (Tetris, Bomberman, Tower Defense) Improved UI for the main hub More advanced game mechanics and polish Optional save systems for certain games
Extra info
2026-05-14T04:05:31.927Z
Approved at 2026-05-14T19:14:03.490Z
User submitted
19h 5m
Reviewer approved
19h 5m
Hackatime projects: [21591]
Raw project json
{
"aasm_state": "approved",
"ai_declaration": "helped debug and figure out certain python features i havent learned yet :D (map generation etc)",
"approved_at": "2026-05-14T19:14:03.490Z",
"approved_seconds": 68725,
"created_at": "2026-05-02T23:25:25.529Z",
"demo_link": "https://github.com/Icehunter494/Terminal-Game-Hub/releases/tag/v2.0.0",
"desc": "Terminal Game Hub\r\n\r\nA collection of multiple games that can all be played directly in the terminal. This project is designed to bundle a variety of classic and experimental games into one simple, lightweight hub without requiring a graphical interface.\r\n\r\nRequirements\r\nPython 3.8 or higher\r\n\r\nWindows Users\r\n\r\nThe curses module is not included by default on Windows. You must install it manually:\r\n\r\npip install windows-curses\r\n\r\nGame List\r\n\r\nArcade / Real-Time Games\r\n\r\nSnake\r\n\r\nPong (2-player)\r\n\r\nBreakout\r\n\r\nAsteroids\r\n\r\nBullet Hell (work in progress)\r\n\r\nStrategy / Simulation\r\n\r\nSpace Trader\r\n\r\nStock Market Simulator\r\n\r\nPuzzle / Logic Games\r\n\r\nSudoku\r\n\r\nMastermind\r\n\r\nWord Scramble\r\n\r\n2048\r\n\r\nConnect 4\r\n\r\nMinesweeper\r\n\r\nClassic / Casual Games\r\n\r\nBlackjack\r\n\r\nBattleship\r\n\r\nRock Paper Scissors Ultimate\r\n\r\nMad Libs\r\n\r\nHangman\r\n\r\nExploration / Other\r\n\r\nRoguelike Dungeon Crawler\r\n\r\nMaze Runner\r\n\r\nFeatured Games\r\n\r\nStock Market Simulator\r\n\r\nA dynamic trading simulation with:\r\n\r\nmultiple stocks with volatility and trends\r\nbull and bear market cycles\r\nrandom news events affecting prices\r\ndividend payouts\r\nportfolio and net worth tracking\r\n\r\nAsteroids\r\n\r\nA real-time space shooter featuring:\r\n\r\nship rotation and thrust physics\r\nbullet shooting system\r\nmoving asteroids\r\ncollision detection\r\nscore tracking and restart system\r\n\r\nBreakout\r\n\r\nA brick-breaking arcade game with:\r\n\r\npaddle and ball physics\r\ndestructible brick grid\r\nscore tracking\r\nwin/lose conditions\r\n\r\nPong\r\n\r\nA two-player competitive game:\r\n\r\nlocal multiplayer controls\r\nscore tracking\r\nwin condition system\r\n\r\nBlackjack\r\n\r\nA terminal-based card game:\r\n\r\nhit and stand mechanics\r\ndealer AI\r\nproper scoring rules\r\nAdding New Games\r\n\r\nTo add a new game:\r\n\r\nCreate a .py file inside the /games folder\r\nAdd one of the following entry functions:\r\n\r\nStandard game:\r\n\r\ndef run():\r\n\r\nCurses-based game:\r\n\r\ndef run(stdscr):\r\n(Optional) Add a display name:\r\nGAME_NAME = \"My Game\"\r\n\r\nThe hub will automatically detect and load the game.\r\n\r\nControls\r\n\r\nControls vary per game. Most games display their controls on launch. Common patterns include:\r\n\r\nArrow keys for movement\r\nWASD for alternative controls\r\nQ to quit\r\nR to restart\r\n\r\nNotes\r\n\r\nAll games are designed for terminal play only\r\nSome games require a sufficiently large terminal window\r\nPerformance may vary depending on terminal and system\r\n\r\nFuture Improvements\r\n\r\nAdditional games (Tetris, Bomberman, Tower Defense)\r\n\r\nImproved UI for the main hub\r\nMore advanced game mechanics and polish\r\nOptional save systems for certain games",
"hackatime_projects": [
21591
],
"high_quality": false,
"id": 2039,
"real_approved_seconds": 68724,
"rejected_at": "2026-05-06T11:48:00.914Z",
"repo_link": "https://github.com/Icehunter494/Terminal-Game-Hub",
"reported_seconds": 68725,
"screenshot": "https://r2.hctg.gallery.karimeltaib.com/2039.png",
"status": "Approved on 2026-05-14",
"submitted_at": "2026-05-14T04:05:31.927Z",
"tags": [
5
],
"title": "Terminal Game Hub v2",
"total_seconds": null,
"unread_notification_count": 0,
"updated_at": "2026-05-14T19:14:03.496Z",
"user_id": 2814,
"username": "icehunter494",
"ysws": null
}