🎰 Casino Royal — Virtual Casino

A fully playable virtual casino with four classic games, animated UI, and per-game music.

"Register your profile, choose your starting balance, and try not to lose it all."

---

🎬 Preview

---

🎮 Game Features

🃏 Four Playable Casino Games

• 🔴 Roulette — Bet on Red, Black, or Green with realistic spin animation
• 🎰 Slots — 3-reel slot machine with symbol matching and adjustable bets
• ♠️ Blackjack — Classic card game with Hit and Stand mechanics
• 🎲 Dice — Bet on Even/Odd and High (8–12) / Low (2–6) with rolling animation

📋 Player Registration System

• Full name, alias, age validation (18+)
• Custom starting balance from $500 to $5,000
• Alias displayed in the HUD during gameplay

💰 Virtual Money System

• Real-time balance display in the top-right corner
• Per-game bet adjustment using +/− controls (minimum $10)
• Animated win/loss result messages

🎵 Per-Game Music

• Unique soundtrack for each game and screen
• Seamless music transitions between sections

🌊 Animated Background

• Dynamic synthwave gradient with pulsing particle effects

💀 Game Over Sequence

• Triggered when the player's balance reaches $0
• Dedicated music and animated screen

---

🕹️ Games Overview

Game	Bet Types	Payout
🔴 Roulette	Red / Black / Green	2x
🎰 Slots	Match symbols across 3 reels	2x
♠️ Blackjack	Beat the dealer without exceeding 21	2x
🎲 Dice	Even / Odd / High (8–12) / Low (2–6)	2x

---

💾 Installation

1. Go to the Releases section
2. Download the latest Casino.Virtual.exe
3. Double-click to run
4. No installation or Python required!

Note: Windows may show a security warning. Click "More info" → "Run anyway" to start.

---

🖥️ System Requirements

Component	Minimum
OS	Windows 10 / 11
RAM	8 GB
Storage	~320 MB free space
Display	1200×800 or higher
Network	Not required

---

🎯 How to Play

1. Open Casino.Virtual.exe
2. Register your player profile — name, alias, age, and starting balance
3. Select a game from the main menu
4. Adjust your bet using the +/− buttons
5. Play and try to multiply your balance!

---

📝 Important Notes

• Minimum bet is $10, adjustable in $10 increments
• Age validation requires players to be 18 or older
• The game ends permanently when your balance reaches $0

---

🛠️ Tech Stack

Technology	Version	Purpose
Python	3.13.0	Base language
Pygame	2.6.1	Graphics, audio, and game loop

---

📁 Project Structure

Casino/
├── main.py                  ← Entry point
├── elementos/
│   ├── colores.py           ← Color constants
│   └── boton.py             ← Button class
├── minijuegos/
│   ├── ruleta.py            ← Roulette game
│   ├── tragamonedas.py      ← Slots game
│   ├── blackjack.py         ← Blackjack game
│   └── dados.py             ← Dice game
├── imagenes/                ← Game images and logo
└── musica/                  ← Audio files per screen/game

---

❓ FAQ

Q: The game won't open. What should I do?

A: Right-click the .exe → "Run as administrator". Also make sure you're on Windows 10 or 11.

Q: Can I change my starting balance mid-game?

A: No. The balance is set during the registration screen and cannot be changed afterwards.

Q: What happens when I run out of money?

A: A Game Over screen appears with dedicated music and the game closes after 3 seconds.

Q: Is there a save system?

A: No. Each session starts fresh from the registration screen.

---

🐛 Known Issues

• Windows Only: Linux and macOS are not supported in this release
• No Save System: Each play session starts from scratch
• Fixed Resolution: Designed for 1200×800; may not scale on smaller screens

---

👥 Credits

Role	Name
Developer	Magallanes López Carlos Gabriel

Development Period: 2026

---

📞 Contact & Support

📧 Email: cgmagallanes23@gmail.com
🐛 Report Bugs: Open an Issue

---

📜 License

This project is free for personal use.

---

"Good luck, and may the odds be in your favor."

🎰 Download Casino.Virtual.exe

---

Last Updated: June 29, 2026 · Version: 1.0