tucker-trucker

Name	tucker-trucker JSON
Version	1.1.0 JSON
	download
home_page	None
Summary	A 2D market timing and strategy game featuring Tucker the Boston Terrier delivering goods around town!
upload_time	2025-08-07 20:40:54
maintainer	None
docs_url	None
author	None
requires_python	>=3.7
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.
keywords	game pygame strategy trading boston-terrier 2d-game
VCS
bugtrack_url
requirements	pygame numpy
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # 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! 🐕💼*

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "tucker-trucker",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "game, pygame, strategy, trading, boston-terrier, 2d-game",
    "author": null,
    "author_email": "Jeremy Evans <JeremyEvans@hey.com>",
    "download_url": "https://files.pythonhosted.org/packages/ae/c9/073c0482ac8b9b47823fbe0d98b27e90ff4bacdfcf5b10fb47e96c299788/tucker_trucker-1.1.0.tar.gz",
    "platform": null,
    "description": "# Tucker Trucker \ud83d\udc15\ud83d\ude9b\r\n\r\nA 2D market timing and strategy game featuring Tucker, a Boston Terrier who runs a delivery business in a bustling pet marketplace!\r\n\r\n## Game Overview\r\n\r\nYou 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.\r\n\r\n## Features\r\n\r\n- **Adorable Boston Terrier protagonist** with custom sprite design\r\n- **Dynamic market system** with fluctuating prices and demand\r\n- **5 unique pet markets** scattered around the game world\r\n- **5 different goods types**: Bones, Treats, Toys, Food, and Medicine\r\n- **Real-time trading mechanics** with supply and demand\r\n- **Day/night cycle** that affects market conditions\r\n- **Inventory management** with limited cargo capacity\r\n- **Strategic gameplay** requiring market timing and route planning\r\n\r\n## How to Play\r\n\r\n### Controls\r\n- **WASD** or **Arrow Keys**: Move Tucker around the world\r\n- **E**: Toggle inventory panel\r\n- **R**: Interact with nearby markets (when close enough)\r\n- **ESC**: Close menus and trading interfaces\r\n\r\n### Trading Controls (when at a market)\r\n- **1-5**: Select different goods (Bones, Treats, Toys, Food, Medicine)\r\n- **+/-**: Increase/decrease trade quantity\r\n- **B**: Buy selected goods from market\r\n- **S**: Sell selected goods to market\r\n\r\n### Game Mechanics\r\n\r\n1. **Movement**: Guide Tucker around the game world to visit different markets\r\n2. **Trading**: Each market has different prices and stock levels for various goods\r\n3. **Market Dynamics**: Prices fluctuate based on supply and demand over time\r\n4. **Cargo Management**: You can only carry 10 items at once - choose wisely!\r\n5. **Profit Strategy**: Buy low at one market, sell high at another\r\n6. **Time Management**: Each day brings new market conditions\r\n\r\n### Markets\r\n- **Doggy Depot** (Top Left)\r\n- **Paws & Claws Market** (Top Right)\r\n- **The Bone Zone** (Bottom Left)\r\n- **Furry Friends Store** (Bottom Right)\r\n- **Pet Paradise** (Center)\r\n\r\n### Goods Types\r\n- \ud83e\uddb4 **Bones**: Classic dog treats with steady demand\r\n- \ud83c\udf6a **Treats**: Popular snacks with variable pricing\r\n- \ud83e\uddf8 **Toys**: Entertainment goods with seasonal demand\r\n- \ud83e\udd6b **Food**: Essential supplies with consistent market\r\n- \ud83d\udc8a **Medicine**: High-value specialty items\r\n\r\n## Strategy Tips\r\n\r\n1. **Watch the demand indicators**: High/Med/Low demand affects pricing\r\n2. **Plan efficient routes**: Minimize travel time between profitable trades\r\n3. **Monitor market money**: Markets need cash to buy your goods\r\n4. **Track price trends**: Some goods increase in value over time\r\n5. **Manage inventory space**: Don't get stuck with unsellable goods\r\n6. **Start small**: Begin with low-risk trades to build capital\r\n\r\n## Installation & Running\r\n\r\n### Easy Installation (Recommended)\r\nInstall directly from PyPI:\r\n```bash\r\npip install tucker-trucker\r\n```\r\n\r\nThen run the game:\r\n```bash\r\ntucker-trucker\r\n```\r\n\r\n### Manual Installation\r\nIf you want to run from source:\r\n\r\n### Manual Installation\r\nIf you want to run from source:\r\n\r\n#### Prerequisites\r\n- Python 3.7 or higher\r\n- pygame library\r\n- numpy library\r\n\r\n#### Running the Game\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/jeremevans/tucker-trucker.git\r\ncd tucker-trucker\r\n\r\n# Install dependencies\r\npip install -r requirements.txt\r\n\r\n# Run the game\r\npython run_game.py\r\n```\r\n\r\nOr using the package module:\r\n```bash\r\npython -m tucker_trucker\r\n```\r\n\r\n## Development\r\n\r\nThis game is built with:\r\n- **Python 3.x**\r\n- **Pygame** for graphics and game engine\r\n- **Object-oriented design** with modular components\r\n\r\n### File Structure\r\n```\r\nTuckerTrucker/\r\n\u251c\u2500\u2500 main.py              # Main game entry point\r\n\u251c\u2500\u2500 game/\r\n\u2502   \u251c\u2500\u2500 __init__.py      # Package initialization\r\n\u2502   \u251c\u2500\u2500 constants.py     # Game constants and configuration\r\n\u2502   \u251c\u2500\u2500 entities.py      # Game objects (Player, Markets, Goods)\r\n\u2502   \u251c\u2500\u2500 game_engine.py   # Main game logic and coordination\r\n\u2502   \u2514\u2500\u2500 ui.py           # User interface and rendering\r\n\u2514\u2500\u2500 README.md           # This file\r\n```\r\n\r\n## Future Enhancements\r\n\r\n- \ud83d\ude9b **Truck upgrades** for increased cargo capacity and speed\r\n- \ud83c\udfc6 **Achievement system** for trading milestones\r\n- \ud83c\udf26\ufe0f **Weather effects** that impact travel and demand\r\n- \ud83d\udcca **Price history charts** for better market analysis\r\n- \ud83c\udfb5 **Sound effects and music**\r\n- \ud83d\udcb0 **Loan system** for expanding business operations\r\n- \ud83c\udfea **Player-owned market stalls**\r\n- \ud83d\udce6 **Special delivery contracts** with time bonuses\r\n\r\n## Credits\r\n\r\nCreated with \u2764\ufe0f for Boston Terrier lovers and strategy game enthusiasts!\r\n\r\n---\r\n\r\n*Woof! Happy trading! \ud83d\udc15\ud83d\udcbc*\r\n",
    "bugtrack_url": null,
    "license": "MIT License\r\n        \r\n        Copyright (c) 2025 Tucker Trucker Game\r\n        \r\n        Permission is hereby granted, free of charge, to any person obtaining a copy\r\n        of this software and associated documentation files (the \"Software\"), to deal\r\n        in the Software without restriction, including without limitation the rights\r\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n        copies of the Software, and to permit persons to whom the Software is\r\n        furnished to do so, subject to the following conditions:\r\n        \r\n        The above copyright notice and this permission notice shall be included in all\r\n        copies or substantial portions of the Software.\r\n        \r\n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n        SOFTWARE.\r\n        ",
    "summary": "A 2D market timing and strategy game featuring Tucker the Boston Terrier delivering goods around town!",
    "version": "1.1.0",
    "project_urls": {
        "Bug Reports": "https://github.com/jeremevans/tucker-trucker/issues",
        "Homepage": "https://github.com/jeremevans/tucker-trucker",
        "Source": "https://github.com/jeremevans/tucker-trucker"
    },
    "split_keywords": [
        "game",
        " pygame",
        " strategy",
        " trading",
        " boston-terrier",
        " 2d-game"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8b5ec2d3c20c1cdea8c84634365f3d954951398edf76857d4344f6acaefe04cc",
                "md5": "373af5639dc78c5c8a0722ab4a15d953",
                "sha256": "a9b54440626e34bcaf9d3d33b683d577ff75bd38fe4c601c051addaf68604c28"
            },
            "downloads": -1,
            "filename": "tucker_trucker-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "373af5639dc78c5c8a0722ab4a15d953",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 14747,
            "upload_time": "2025-08-07T20:40:53",
            "upload_time_iso_8601": "2025-08-07T20:40:53.425299Z",
            "url": "https://files.pythonhosted.org/packages/8b/5e/c2d3c20c1cdea8c84634365f3d954951398edf76857d4344f6acaefe04cc/tucker_trucker-1.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "aec9073c0482ac8b9b47823fbe0d98b27e90ff4bacdfcf5b10fb47e96c299788",
                "md5": "5ac353020e2636f4dba66cd57e232112",
                "sha256": "d6da34111b7ccc5571dc617bd30f0acc7ca07056f48f34ef960c6be3409d3562"
            },
            "downloads": -1,
            "filename": "tucker_trucker-1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "5ac353020e2636f4dba66cd57e232112",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 16498,
            "upload_time": "2025-08-07T20:40:54",
            "upload_time_iso_8601": "2025-08-07T20:40:54.620201Z",
            "url": "https://files.pythonhosted.org/packages/ae/c9/073c0482ac8b9b47823fbe0d98b27e90ff4bacdfcf5b10fb47e96c299788/tucker_trucker-1.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-07 20:40:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jeremevans",
    "github_project": "tucker-trucker",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "pygame",
            "specs": [
                [
                    ">=",
                    "2.5.0"
                ]
            ]
        },
        {
            "name": "numpy",
            "specs": [
                [
                    ">=",
                    "1.24.0"
                ]
            ]
        }
    ],
    "lcname": "tucker-trucker"
}