初心者向け No.19

サイコロシミュレーター

1〜6のサイコロをパラパラ演出付きで振るシミュレーター。Labelの差し替えとafter()で動きを付ける方法を学びます。

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

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

1〜6のサイコロをパラパラ演出付きで振るシミュレーター。Labelの差し替えとafter()で動きを付ける方法を学びます。

このアプリはゲームカテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★☆☆ です。

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

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

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

サイコロシミュレーター実行画面（Windows） — 実行画面（Windows）

サイコロシミュレーター実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「🎲 振る！」ボタン（roll()）・「リセット」ボタン（reset()）で操作
ウィンドウはタイトル「サイコロシミュレーター」・サイズ 400x465 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

💡

コードのコピー方法

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

✅ 追加インストール不要（標準ライブラリのみ使用）

app19.py

import tkinter as tk
from tkinter import ttk
import random


class App19:
    """サイコロシミュレーター"""

    FACES = {
        1: "⚀", 2: "⚁", 3: "⚂",
        4: "⚃", 5: "⚄", 6: "⚅",
    }

    def __init__(self, root):
        self.root = root
        self.root.title("サイコロシミュレーター")
        self.root.geometry("400x465")
        self.root.minsize(400, 465)
        self.root.configure(bg="#f8f9fc")
        self.roll_history = []
        self._build_ui()

    def _build_ui(self):
        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_frame = tk.Frame(self.root, bg="#f8f9fc", padx=24, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # サイコロ表示
        self.dice_label = tk.Label(main_frame, text="⚀",
                                   font=("Segoe UI Emoji", 72),
                                   bg="#f8f9fc", fg="#333")
        self.dice_label.pack()

        self.result_label = tk.Label(main_frame, text="ボタンを押してサイコロを振ろう！",
                                     bg="#f8f9fc", font=("Noto Sans JP", 12), fg="#555")
        self.result_label.pack(pady=(0, 10))

        # ボタン
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack()
        tk.Button(btn_frame, text="🎲 振る！", font=("Noto Sans JP", 14, "bold"),
                  bg="#3776ab", fg="white", activebackground="#2a5a8a",
                  relief=tk.RAISED, bd=0, padx=20, pady=8,
                  command=self.roll).pack(side=tk.LEFT, padx=8)
        ttk.Button(btn_frame, text="リセット", command=self.reset).pack(side=tk.LEFT)

        # 統計
        stats_frame = ttk.LabelFrame(main_frame, text="統計（各目の出た回数）", padding=8)
        stats_frame.pack(fill=tk.X, pady=(12, 0))
        self.stat_labels = {}
        bg_color = self.root.cget("bg")
        for col, face in enumerate(range(1, 7)):
            tk.Label(stats_frame, text=self.FACES[face],
                     font=("Segoe UI Emoji", 18), bg=bg_color).grid(
                row=0, column=col, padx=6)
            lbl = tk.Label(stats_frame, text="0",
                           font=("Noto Sans JP", 11), bg=bg_color, fg="#555")
            lbl.grid(row=1, column=col, padx=6)
            self.stat_labels[face] = lbl

        self.total_label = tk.Label(main_frame, text="合計: 0回",
                                    bg="#f8f9fc", font=("Noto Sans JP", 10), fg="#888")
        self.total_label.pack(pady=(6, 0))

    def roll(self):
        # アニメーション風：3回チラ見せ
        for _ in range(3):
            tmp = random.randint(1, 6)
            self.dice_label.config(text=self.FACES[tmp])
            self.root.update()
            self.root.after(80)

        result = random.randint(1, 6)
        self.dice_label.config(text=self.FACES[result])
        self.result_label.config(text=f"出た目: {result}")
        self.roll_history.append(result)
        self._update_stats()

    def _update_stats(self):
        for face in range(1, 7):
            count = self.roll_history.count(face)
            self.stat_labels[face].config(text=str(count))
        self.total_label.config(text=f"合計: {len(self.roll_history)}回")

    def reset(self):
        self.roll_history.clear()
        self.dice_label.config(text="⚀")
        self.result_label.config(text="ボタンを押してサイコロを振ろう！")
        for lbl in self.stat_labels.values():
            lbl.config(text="0")
        self.total_label.config(text="合計: 0回")


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

5. コード解説

サイコロシミュレーターのコードを、実際に書かれている実装に沿って解説します。

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

App19 クラスにアプリの全機能をまとめています（メソッド5個・全102行）。__init__ ではタイトル「サイコロシミュレーター」とウィンドウサイズ 400x465 を設定します。最後に _build_ui() で画面を組み立てます。