Metadata-Version: 2.4
Name: tucker-trucker
Version: 1.1.0
Summary: A 2D market timing and strategy game featuring Tucker the Boston Terrier delivering goods around town!
Author-email: Jeremy Evans <JeremyEvans@hey.com>
License: MIT License
        
        Copyright (c) 2025 Tucker Trucker Game
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/jeremevans/tucker-trucker
Project-URL: Bug Reports, https://github.com/jeremevans/tucker-trucker/issues
Project-URL: Source, https://github.com/jeremevans/tucker-trucker
Keywords: game,pygame,strategy,trading,boston-terrier,2d-game
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Games/Entertainment :: Simulation
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygame>=2.5.0
Requires-Dist: numpy>=1.24.0
Dynamic: license-file

# Tucker Trucker 🐕🚛

A 2D market timing and strategy game featuring Tucker, a Boston Terrier who runs a delivery business in a bustling pet marketplace!

## Game Overview

You play as Tucker, an entrepreneurial Boston Terrier who travels between different pet markets to buy and sell goods. Your goal is to make smart trading decisions, timing your purchases and sales to maximize profit while managing your limited cargo capacity.

## Features

- **Adorable Boston Terrier protagonist** with custom sprite design
- **Dynamic market system** with fluctuating prices and demand
- **5 unique pet markets** scattered around the game world
- **5 different goods types**: Bones, Treats, Toys, Food, and Medicine
- **Real-time trading mechanics** with supply and demand
- **Day/night cycle** that affects market conditions
- **Inventory management** with limited cargo capacity
- **Strategic gameplay** requiring market timing and route planning

## How to Play

### Controls
- **WASD** or **Arrow Keys**: Move Tucker around the world
- **E**: Toggle inventory panel
- **R**: Interact with nearby markets (when close enough)
- **ESC**: Close menus and trading interfaces

### Trading Controls (when at a market)
- **1-5**: Select different goods (Bones, Treats, Toys, Food, Medicine)
- **+/-**: Increase/decrease trade quantity
- **B**: Buy selected goods from market
- **S**: Sell selected goods to market

### Game Mechanics

1. **Movement**: Guide Tucker around the game world to visit different markets
2. **Trading**: Each market has different prices and stock levels for various goods
3. **Market Dynamics**: Prices fluctuate based on supply and demand over time
4. **Cargo Management**: You can only carry 10 items at once - choose wisely!
5. **Profit Strategy**: Buy low at one market, sell high at another
6. **Time Management**: Each day brings new market conditions

### Markets
- **Doggy Depot** (Top Left)
- **Paws & Claws Market** (Top Right)
- **The Bone Zone** (Bottom Left)
- **Furry Friends Store** (Bottom Right)
- **Pet Paradise** (Center)

### Goods Types
- 🦴 **Bones**: Classic dog treats with steady demand
- 🍪 **Treats**: Popular snacks with variable pricing
- 🧸 **Toys**: Entertainment goods with seasonal demand
- 🥫 **Food**: Essential supplies with consistent market
- 💊 **Medicine**: High-value specialty items

## Strategy Tips

1. **Watch the demand indicators**: High/Med/Low demand affects pricing
2. **Plan efficient routes**: Minimize travel time between profitable trades
3. **Monitor market money**: Markets need cash to buy your goods
4. **Track price trends**: Some goods increase in value over time
5. **Manage inventory space**: Don't get stuck with unsellable goods
6. **Start small**: Begin with low-risk trades to build capital

## Installation & Running

### Easy Installation (Recommended)
Install directly from PyPI:
```bash
pip install tucker-trucker
```

Then run the game:
```bash
tucker-trucker
```

### Manual Installation
If you want to run from source:

### Manual Installation
If you want to run from source:

#### Prerequisites
- Python 3.7 or higher
- pygame library
- numpy library

#### Running the Game
```bash
# Clone the repository
git clone https://github.com/jeremevans/tucker-trucker.git
cd tucker-trucker

# Install dependencies
pip install -r requirements.txt

# Run the game
python run_game.py
```

Or using the package module:
```bash
python -m tucker_trucker
```

## Development

This game is built with:
- **Python 3.x**
- **Pygame** for graphics and game engine
- **Object-oriented design** with modular components

### File Structure
```
TuckerTrucker/
├── main.py              # Main game entry point
├── game/
│   ├── __init__.py      # Package initialization
│   ├── constants.py     # Game constants and configuration
│   ├── entities.py      # Game objects (Player, Markets, Goods)
│   ├── game_engine.py   # Main game logic and coordination
│   └── ui.py           # User interface and rendering
└── README.md           # This file
```

## Future Enhancements

- 🚛 **Truck upgrades** for increased cargo capacity and speed
- 🏆 **Achievement system** for trading milestones
- 🌦️ **Weather effects** that impact travel and demand
- 📊 **Price history charts** for better market analysis
- 🎵 **Sound effects and music**
- 💰 **Loan system** for expanding business operations
- 🏪 **Player-owned market stalls**
- 📦 **Special delivery contracts** with time bonuses

## Credits

Created with ❤️ for Boston Terrier lovers and strategy game enthusiasts!

---

*Woof! Happy trading! 🐕💼*
