初心者向け No.067

スロットマシン

絵文字を使った3リールスロット。当選パターン判定とコイン管理機能付きのカジノゲーム風アプリ。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter(標準ライブラリ) ⏱️ 制作時間: 30〜90分

1. アプリ概要

絵文字を使った3リールスロット。当選パターン判定とコイン管理機能付きのカジノゲーム風アプリ。

このアプリはgamesカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter(標準ライブラリ)、難易度は ★★☆ です。

このアプリは「ゲーム」カテゴリです。ゲーム実装は GUI イベント処理・状態管理・描画ループを同時に学べる教材で、画面・入力・ロジックの三層分離の感覚が掴めます。tkinter(標準ライブラリ) を活かして実装するこの構造は、他のアプリにも応用が効きます。

コピー&実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。

アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。

2. 機能一覧

  • スロットマシンのメイン機能
  • 直感的なGUIインターフェース
  • 入力値のバリデーション
  • エラーハンドリング
  • 結果の見やすい表示
  • クリア機能付き

3. 事前準備・環境

ℹ️
動作確認環境

Python 3.10 以上 / Windows・Mac・Linux すべて対応

以下の環境で動作確認しています。

  • Python 3.10 以上
  • OS: Windows 10/11・macOS 12+・Ubuntu 20.04+

4. 完全なソースコード

💡
コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

追加インストール不要(標準ライブラリのみ使用)
app067.py
import tkinter as tk
from tkinter import ttk, messagebox
import random


class App067:
    """スロットマシン: 3リール絵文字スロット + コイン管理"""

    SYMBOLS = ["🍒", "🍋", "🍊", "🔔", "⭐", "💎", "7️⃣"]
    # 当選時の獲得倍率(揃った絵文字に対する払い戻し倍率)
    PAYOUT = {
        "7️⃣": 50,
        "💎": 20,
        "⭐": 10,
        "🔔": 5,
        "🍊": 3,
        "🍋": 2,
        "🍒": 2,
    }
    BET = 10  # 1回あたりのベット額

    def __init__(self, root):
        self.root = root
        self.root.title("スロットマシン")
        self.root.geometry("600x450")
        self.root.configure(bg="#f8f9fc")
        self.coins = 100  # 初期所持コイン
        self.spinning = False
        self._build_ui()
        self._update_status()

    def _build_ui(self):
        """UI を構築する"""
        # タイトル
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(
            title_frame, text="🎰 スロットマシン",
            font=("Noto Sans JP", 16, "bold"),
            bg="#3776ab", fg="white"
        ).pack()

        main = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=20)
        main.pack(fill=tk.BOTH, expand=True)

        # ステータス(コイン数)
        self.status_var = tk.StringVar()
        tk.Label(
            main, textvariable=self.status_var,
            font=("Noto Sans JP", 12, "bold"), bg="#f8f9fc"
        ).pack(pady=(0, 10))

        # リール表示
        reel_frame = tk.Frame(main, bg="#222", padx=20, pady=20, bd=4, relief=tk.RIDGE)
        reel_frame.pack(pady=10)
        self.reel_vars = [tk.StringVar(value="❓") for _ in range(3)]
        self.reel_labels = []
        for i, var in enumerate(self.reel_vars):
            lbl = tk.Label(
                reel_frame, textvariable=var, font=("Arial", 48),
                width=2, bg="white", fg="#222", bd=2, relief=tk.SUNKEN
            )
            lbl.grid(row=0, column=i, padx=6)
            self.reel_labels.append(lbl)

        # 結果メッセージ
        self.message_var = tk.StringVar(value=f"スピン1回 = {self.BET}コイン消費")
        tk.Label(
            main, textvariable=self.message_var,
            font=("Noto Sans JP", 12), bg="#f8f9fc", fg="#333"
        ).pack(pady=10)

        # 操作ボタン
        btn = tk.Frame(main, bg="#f8f9fc")
        btn.pack(pady=8)
        self.spin_btn = ttk.Button(btn, text="スピン", command=self.spin)
        self.spin_btn.pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="コイン補充(+50)", command=self.add_coins).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="リセット", command=self.reset).pack(side=tk.LEFT, padx=4)

    def spin(self):
        """スピン開始"""
        if self.spinning:
            return
        if self.coins < self.BET:
            messagebox.showwarning("コイン不足", "コインが足りません。補充してください。")
            return
        self.coins -= self.BET
        self._update_status()
        self.spinning = True
        self.spin_btn.config(state=tk.DISABLED)
        # アニメーション: 各リールを順に止める
        self._animate(0, frames=15)

    def _animate(self, reel_index, frames):
        """リールを回転表示してから停止"""
        if frames > 0:
            for i in range(reel_index, 3):
                self.reel_vars[i].set(random.choice(self.SYMBOLS))
            self.root.after(60, lambda: self._animate(reel_index, frames - 1))
        else:
            # 現在のリールを確定
            if reel_index < 2:
                self._animate(reel_index + 1, frames=12)
            else:
                self._judge()

    def _judge(self):
        """当選判定"""
        symbols = [v.get() for v in self.reel_vars]
        if symbols[0] == symbols[1] == symbols[2]:
            mult = self.PAYOUT.get(symbols[0], 2)
            payout = self.BET * mult
            self.coins += payout
            self.message_var.set(f"🎉 大当たり! {symbols[0]} x3 → +{payout} コイン")
        elif symbols[0] == symbols[1] or symbols[1] == symbols[2] or symbols[0] == symbols[2]:
            payout = self.BET  # ベット額返却
            self.coins += payout
            self.message_var.set(f"おしい!2つ揃い → +{payout} コイン返還")
        else:
            self.message_var.set("ハズレ… もう一度!")
        self._update_status()
        self.spinning = False
        self.spin_btn.config(state=tk.NORMAL)

    def add_coins(self):
        """コインを補充する"""
        self.coins += 50
        self._update_status()

    def reset(self):
        """初期状態に戻す"""
        self.coins = 100
        for v in self.reel_vars:
            v.set("❓")
        self.message_var.set(f"スピン1回 = {self.BET}コイン消費")
        self._update_status()

    def _update_status(self):
        """所持コイン表示を更新"""
        self.status_var.set(f"💰 所持コイン: {self.coins}")


if __name__ == "__main__":
    root = tk.Tk()
    app = App067(root)
    root.mainloop()

5. コード解説

スロットマシンのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

クラス設計とコンストラクタ

App067クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

UIレイアウトの構築

LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

イベント処理

ボタンのcommand引数でクリックイベントを、bind('')でEnterキーイベントを処理します。どちらの操作でも同じprocess()が呼ばれ、コードの重複を避けられます。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

Textウィジェットでの結果表示

tk.Textウィジェットをstate=DISABLED(読み取り専用)で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

例外処理とエラーハンドリング

try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

6. ステップバイステップガイド

このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。

  1. 1
    ファイルを作成する

    新しいファイルを作成して app067.py と保存します。

  2. 2
    クラスの骨格を作る

    App067クラスを定義し、__init__とmainloop()の最小構成を作ります。

  3. 3
    タイトルバーを作る

    Frameを使ってカラーバー付きのタイトルエリアを作ります。

  4. 4
    入力フォームを実装する

    LabelFrameとEntryウィジェットで入力エリアを作ります。

  5. 5
    処理ロジックを実装する

    _execute()メソッドにメインロジックを実装します。

  6. 6
    結果表示を実装する

    TextウィジェットかLabelに結果を表示する_show_result()を実装します。

  7. 7
    エラー処理を追加する

    try-exceptとmessageboxでエラーハンドリングを追加します。

7. カスタマイズアイデア

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。

💡 ダークモードを追加する

bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。

💡 データの保存機能

処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。

💡 設定ダイアログ

フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。

8. よくある問題と解決法

❌ 日本語フォントが表示されない

原因:システムに日本語フォントが見つからない場合があります。

解決法:font引数を省略するかシステムに合ったフォントを指定してください。

❌ ライブラリのインポートエラー

原因:必要なライブラリがインストールされていません。

解決法:pip install コマンドで必要なライブラリをインストールしてください。

❌ ウィンドウサイズが合わない

原因:画面解像度や表示スケールによって異なる場合があります。

解決法:root.geometry()で適切なサイズに調整してください。

9. 練習問題

アプリの理解を深めるための練習問題です。

  1. 課題1:機能拡張

    スロットマシンに新しい機能を1つ追加してみましょう。

  2. 課題2:UIの改善

    色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。

  3. 課題3:保存機能の追加

    処理結果をファイルに保存する機能を追加しましょう。

🚀
次に挑戦するアプリ

このアプリをマスターしたら、次のアプリに挑戦しましょう。