Falling Pickaxe Game inspired from YouTube shorts livestreams.

You can check my video here: https://www.youtube.com/watch?v=gcjeidHWEb4

If you consider streaming this game on your own youtube channel, please add credits in the description of your video/livestream. Credits should inclue a link to this repository and a link to my youtube channel.

Copy paste example:

Falling Pickaxe game made by Vycdev
YT: https://www.youtube.com/@vycdev
GH: https://github.com/vycdev/falling-pickaxe

Donations on YouTube (Super Thanks) or showing support on Patreon is also highly appreciated.

Update: You can watch my tutorial here: https://youtu.be/aFrvoFE7r_g

The easiest way to run the game is using the automated scripts that handle everything for you:

For Windows:

./scripts/run.ps1

For Linux/macOS:

chmod +x ./scripts/run.sh
./scripts/run.sh

These scripts will automatically:

• Create a Python virtual environment if it doesn't exist
• Install all required dependencies
• Run the game with automatic restart on crashes
• Exit cleanly when you close the game window

If you prefer to set up the environment manually:

1. Make sure you have Python 3.x installed. If you don't, follow the instructions from the official python website
2. Create and activate a virtual environment:

   python -m venv .venv
   # On Windows:
   .venv\Scripts\activate
   # On Linux/macOS:
   source .venv/bin/activate
   

3. Install packages:

   pip install -r requirements.txt
   

4. Run the game:

   python ./src/main.py
   

1. Make a copy of default.config.json to config.json or run the game once to automatically copy the config file into config.json
2. Create your Google API Key for YouTube.
3. Enable the YouTube Data API v3 for your Google Cloud Project.
4. Enter your credentials in the configuration file.
5. Set your youtube channel id and livestream id in the configuration file.
6. Change configuration to your liking

Note: The automated scripts (run.ps1 and run.sh) will run the game and restart it in case of unexpected crashes. When you close the game window normally, the script will exit cleanly. This is perfect for unattended streams.

Steps 2 to 6 are optional. You can disable the entire YouTube integration by setting the property: "CHAT_CONTROL": false

tnt

fast
slow

big

wood
stone
iron
gold
diamond
netherite

Extra details about when a MegaTNT appears in the game:

• New subscribers are detected by periodically polling YouTube for the channel's subscriber count. When an increase is detected the game appends an entry to the mega_tnt_queue (the string "New Subscriber") and the MegaTNT will be spawned when the queues are processed.
• Queue processing happens every QUEUES_POP_INTERVAL_SECONDS (see default.config.json / config.json). Polling frequency for YouTube is controlled by YT_POLL_INTERVAL_SECONDS.
• Requirements for automatic MegaTNT spawning: CHAT_CONTROL must be true, a valid live_chat_id and CHANNEL_ID must be configured so the game can read subscriber counts.
• The queued owner name is currently the literal string "New Subscriber" (not the subscriber's username). You can change this behavior in code if you want actual usernames used.
• You can also spawn a MegaTNT manually in-game by pressing the M key — this spawns immediately (no queue).
• MegaTNTs use a larger explosion radius, detonate automatically ~4 seconds after spawn, and trigger a stronger camera shake.

Any kind of improvements to the code, refactoring, new features, bug fixes, ideas, or anything else is welcome. You can open an issue or a pull requets and I will review it as soon as I can.

You can also help by subscribing or becoming a member of my YouTube channel to help me create more videos and projects like these.

Falling Pickaxe: Ultimate Mining Arcade Game for Streamers – Explosive Action & Massive Earnings!

Step into the world of Falling Pickaxe, the most addictive and interactive mining arcade game designed specifically for YouTube streamers! In this high-energy, physics-based adventure, you control a gigantic pickaxe falling through a dynamic, block-filled landscape. Smash obstacles, trigger explosive TNT, and collect valuable ores to power up your gameplay while engaging with your audience in real time.

Why Falling Pickaxe is a Must-Play for Streamers:

• Interactive Live Chat Integration: Let your viewers control the game! Live commands and super chats can spawn TNT, upgrade your pickaxe, or trigger wild power-ups, creating a fully immersive, viewer-driven experience that boosts engagement and subscriber growth.
• Explosive Visuals & Retro Charm: Enjoy stunning particle effects, realistic physics, and explosive animations that keep your stream exciting and visually captivating. Every impact and explosion is a spectacle that draws in viewers and increases watch time.
• Monetization & Revenue Opportunities: Use Falling Pickaxe to maximize your earnings through super chats, donations, and sponsored gameplay challenges. With its fast-paced action and interactive features, your channel becomes a hotspot for gaming enthusiasts and potential sponsors.
• Community-Driven Challenges: Host live competitions, subscriber challenges, and donation-triggered events that make every stream a unique and engaging event. Build a loyal community and watch your subscriber count soar!

Transform your YouTube channel into a money-making, interactive gaming hub with Falling Pickaxe – the ultimate mining adventure that delivers explosive action, high viewer engagement, and serious revenue potential. Start streaming today and experience the thrill of interactive arcade gaming like never before!

As I showed you in the video my inspiration was Petyr and the other YouTubers who made their own version of the Falling Pickaxe game. Huge thanks to them.

https://www.youtube.com/@Iklzzz