Skip to content

A simple 2D space mining game with an "Asteroids" style ship

License

Notifications You must be signed in to change notification settings

bazmatic/tiddler

Repository files navigation

Tiddler

Tiddler is a 2D space game built with Pygame. Navigate your ship to collect fuel and fire your bullets for the sheet pointless joy of it. The ship uses the classic control method pioneered in the old "Asteroids" game: rotate left, rotate right, thrust.

Installation

  1. Clone this repository:

    git clone https://github.com/yourusername/tiddler.git
    cd tiddler
    
  2. Create a virtual environment (optional but recommended):

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
    
  3. Install the required dependencies:

    pip install -r requirements.txt
    

Usage

Run the game using:

python main.py

Controls

  • Left Arrow: Rotate left
  • Right Arrow: Rotate right
  • Up Arrow: Thrust
  • X: Fire bullet

Project Structure

  • main.py: The main game loop and initialization
  • ship.py: Defines the Ship class and its behavior
  • maze.py: Implements the Maze and Block classes
  • bullet.py: Defines the Bullet class
  • colours.py: Contains color definitions
  • game_state.py: Manages the game state (currently empty)
  • hex_maze.py: An alternative maze implementation (not currently used)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

About

A simple 2D space mining game with an "Asteroids" style ship

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages