🎲 Dice Rolling Simulator

A simple yet powerful dice rolling simulator built in Python, perfect for aspiring developers to learn programming concepts.

📋 Features

• Roll dice with any number of sides (4, 6, 8, 10, 12, 20, etc.)
• Roll multiple dice at once
• Interactive command-line interface
• Clean, object-oriented code structure
• Educational Jupyter notebook with detailed explanations

🚀 Quick Start

Running the Simulator

python dice_simulator.py

Example Usage

🎲 Welcome to Dice Rolling Simulator! 🎲

Enter number of sides (default 6): 20
Enter number of dice to roll (default 1): 2

🎯 Rolling 2 20-sided dice:
Results: [15, 8]
Total: 23

Roll again? (y/n): n
Thanks for playing! 🎲

📁 Project Structure

Dice Rolling Simulator/
├── dice_simulator.py              # Main simulator program
├── dice_simulator_explained.ipynb # Educational Jupyter notebook
└── README.md                      # This file

🎯 Learning Objectives

This project demonstrates key programming concepts:

• Object-Oriented Programming: Classes and methods
• Error Handling: Try-except blocks for user input validation
• List Comprehension: Efficient data structure creation
• User Interface Design: Interactive command-line experience
• Code Documentation: Clear comments and docstrings

🔧 Code Structure

DiceSimulator Class

class DiceSimulator:
    def __init__(self, sides=6):
        self.sides = sides
    
    def roll(self):
        return random.randint(1, self.sides)
    
    def roll_multiple(self, num_dice):
        return [self.roll() for _ in range(num_dice)]

Key Methods

• roll(): Simulates a single dice roll
• roll_multiple(num_dice): Rolls multiple dice and returns results
• main(): Interactive user interface

📚 Educational Resources

Jupyter Notebook

Open dice_simulator_explained.ipynb to explore:

• Step-by-step code explanation
• Programming concepts breakdown
• Statistical analysis examples
• Interactive testing scenarios

Concepts Covered

1. Random number generation
2. Class-based programming
3. Input validation
4. Loop structures
5. List operations

🎮 Use Cases

• Gaming: D&D, board games, probability games
• Education: Teaching randomness and statistics
• Development: Learning Python fundamentals
• Testing: Simulating random scenarios

🛠️ Requirements

• Python 3.6 or higher
• No external dependencies required!

🎨 Customization Ideas

Extend the simulator with:

• Dice roll history tracking
• Statistical analysis features
• GUI interface using tkinter
• Save/load functionality
• Custom dice notation (e.g., "3d6+2")

🤝 Contributing

This project is designed for learning. Feel free to:

• Add new features
• Improve the user interface
• Create additional documentation
• Add unit tests

📄 License

This project is open source and available for educational purposes.

---

Happy Rolling! 🎲

Perfect for aspiring developers learning Python fundamentals through practical application.