WP Manifestindependent plugin directory
manifest / content / puzzle-arcade

Puzzle Arcade

WordPress plugin: Minesweeper and Number Place puzzles in a full-screen modal, with seeded deterministic boards and browser-only progress/best-time tracking.

by shokun0803 · github.com/shokun0803/puzzle-arcade

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/shokun0803/puzzle-arcade/archive/refs/heads/main.zip
Readme github.com/shokun0803/puzzle-arcade ↗

ショートコードまたはブロックで設置したアイコンをタップすると、全画面モーダルでパズルゲームが遊べる WordPress プラグインです。盤面はシード値から決定論的に生成され、進行状況と最短記録はブラウザの localStorage にのみ保存されます（サーバーへの通信は一切行いません）。

収録ゲーム:

  • マインスイーパー — 初手では必ず安全なマスが自動で開くため、初手死は発生しません。
  • ナンプレ（ナンバープレース） — 生成した問題はすべて解が一意であることを検証済みです。

特徴

  • 📱 スマホ最適化（縦持ち基準のレイアウト、タップ／長押し操作、ダブルタップズーム抑止）、PC でもマウス・キーボードで快適に操作可能
  • 🎲 シード値（10進整数）から盤面を決定論的に生成。同じ数値＋同じ難易度なら常に同じ盤面
  • 💾 途中経過をブラウザに保存し、閉じても後から再開可能
  • ⏱ 経過時間の表示、難易度ごとの最短クリア時間を記録
  • 📅 デイリーチャレンジ（日替わり共通盤面）と連続プレイ日数の記録
  • 📊 プレイ回数・クリア率・平均タイムなどの統計パネル
  • 🧩 Gutenberg ブロックとショートコード [puzzle_arcade] の両方に対応
  • 🌐 日本語 UI（i18n 対応、.pot/.po/.mo 同梱）
  • 🔒 外部通信ゼロ・サーバー側へのデータ保存ゼロ。同梱物はすべて自作コードと自作 SVG のみ

インストール

リリースの zip から

  1. Releases から puzzle-arcade.zip をダウンロード
  2. WordPress 管理画面の「プラグイン → 新規追加 → プラグインのアップロード」から zip をアップロードして有効化

ソースから

git clone https://github.com/shokun0803/puzzle-arcade.git wp-content/plugins/puzzle-arcade

ビルド工程は不要です。JavaScript は素の ES2020 をそのまま配信します。

使い方

固定ページ・投稿・ウィジェットにショートコードを配置:

[puzzle_arcade games="minesweeper,numberplace" columns="2" daily="yes" title="ミニゲーム"]
属性 既定値 説明
games 全ゲーム 表示するゲームを CSV で指定（順序も反映）
columns auto 最大列数（1〜6）。既定はスマホ2列・PC最大4列の自動レイアウト
daily yes デイリーチャレンジのカードを表示するか
title なし アイコン一覧の上に出す見出し

ブロックエディタでは「Puzzle Arcade」ブロックから同じ設定を GUI で行えます。

ディレクトリ構成

puzzle-arcade.php     プラグインヘッダ・ブートストラップ
includes/              ゲーム定義・ショートコード・ブロック・文字列（PHP）
blocks/games/          Gutenberg ブロック
assets/js/core/        シードPRNG・localStorage・タイマー・モーダルUI・レジストリ
assets/js/games/       マインスイーパー／ナンプレの実装
assets/css/            スタイル一式
languages/              .pot / .po / .mo と JS 翻訳
readme.txt             WordPress.org 用の説明文

ライセンス

GPLv2 or later. 詳細は LICENSE を参照してください。