pkdx

ポケモン対戦の構築支援ツールです。
Claude Code / Codex と対話しながらチームを組んだり、ポケモンの型を作ったり、ダメージ計算や対戦シミュレーションができます。

できること

• チームビルド: 軸ポケモンを決めたら、タイプ補完・素早さ調整・メタ対策まで対話的にガイド。6体構築と3体選出パターンを提案する。チャンピオンズのバトルチームスクリーンショットから登録も可能
• ダメージ計算: 特性・持ち物・天候・テラスタル込みの乱数ダメージを計算。「確定2発」「乱数1発(12/16)」のような実戦的な確定数を出力する
• 育成シミュレーション: 性格・特性・持ち物・技・努力値を対話的に設定し、Lv50実数値を算出。完成データはファイルに保存でき、チームビルドでも利用できる
• 耐久指数最適化: H/B/D の努力値配分を最適化。HP条件（きのみ/オボン/たべのこし）・物理/特殊比重・top-N 候補の指定に対応し、「HBD 値が最大になる配分」を提示する
• ポケモン検索: 名前・タイプ・素早さ・覚えるわざなどの条件でポケモンを検索。技一覧やタイプ相性もすぐ引ける
• バトルシミュレーション: 登録済みのチーム2つを使って、選出から対戦結果までをシミュレーション。最適行動を取り続けた際の勝率を導出

対応バージョン

ポケモンに関するデータは https://github.com/towakey/pokedex/ を用いています。
一部チャンピオンズに対応するため徹底攻略データを追加しています(技、メガポケモン)

セットアップ

A. データをクラウドに保存したい場合（GitHubアカウントあり）

GitHubアカウントがあれば、作成した構築・育成データをクラウドにバックアップでき、複数のPCで共有したり、過去のデータに戻すことができます。

1. GitHubの pkdxtools/pkdx ページ右上の「Fork」ボタンを押す
2. クローンしたリポジトリのURLをClaude Code / Codexに渡して「これ使いたい」
3. 以降は /self-update スキルで最新版に追従できる

B. まず試してみたい場合（GitHubアカウントなし）

このリポジトリのURLをClaude Code / Codexに渡して「これ使いたい」でOK。データは手元のPCにのみ保存されます。
あとからGitHubアカウントを作成してクラウド保存に切り替えることも可能です。

使い方

Claude Code / Codex (CLI / デスクトップアプリどちらでも可) をこのリポジトリで開いて話しかけるだけ。

> ガブリアス軸で構築したい
> ガブリアスのげきりんでサーフゴーに何発？
> ガブリアスを育成したい
> ガブリアスの総合耐久を最適化したい
> 対戦シミュレーションをしたい

または、スキルを呼び出すことも可能

# 構築をはじめる
> /team-builder

# ダメージ計算をはじめる
> /calc

# 育成シミュレーションをはじめる
> /breed

# 対戦シミュレーションをはじめる
> /nash

作成したチーム・型は ./box 配下に置かれる。手動で編集もできるし、Claude Code / Codex経由で閲覧・編集も可能。

CLI 単体でも使える

bin/pkdx query "ガブリアス"           # 種族値・特性を確認
bin/pkdx moves "ガブリアス"           # 覚える技を一覧
bin/pkdx search --type "ドラゴン" --min-speed 100  # 素早さ100以上のドラゴン
bin/pkdx damage "ガブリアス" "サーフゴー" "じしん"  # ダメージ計算
bin/pkdx hbd "カビゴン" --nature ずぶとい            # 耐久指数が最大になる努力値配分
bin/pkdx stat-calc "ガブリアス" --ev "0,252,0,0,4,252" --nature ようき  # 実数値計算
bin/pkdx type-chart "ほのお" "くさ"   # タイプ相性
bin/pkdx coverage "じめん,こおり"     # 攻撃範囲の確認

対応環境

macOS (Apple Silicon) / Linux (x86_64) / Windows (WSL2)

ライセンス

MIT

対戦シミュレーションの対応範囲

/nash (選出最適化 / 最適戦略算出) が評価対象としているメカニクス。勝率・選出分布を読むときは ⚠️ / ❌ の影響を念頭に置いてください。

凡例: ✅ 対応済 / ⚠️ 部分対応 / ❌ 未対応

カテゴリ	要素	状態	備考
フォーマット	3v3 シングル	✅	6匹 → 3匹選出
フォーマット	ダブル (4v4)	❌	未実装
ダメージ計算	16段階乱数 / 一致 / 相性 / ランク / 急所	✅
ダメージ計算	テラスタル	✅
ダメージ計算	天候・フィールド補正	⚠️	ダメージ計算には入るが状態遷移では無視
先手判定	優先度 (ねこだまし・しんそく等) + 実素早さ	✅
先手判定	素早さ同速	✅	0.5 / 0.5 分岐
命中率	確率ノードで分岐	✅	鬼火 85 / 電磁波 90 / キノコ 100 等
ランク変化	自己強化	✅	つるぎのまい / りゅうのまい / からをやぶる等
ランク変化	相手ランク低下付与	✅	あまえる / いやなおと / こわいかお / しっぽをふる / にらみつける等。瀕死ヒット時は付与スキップ
状態異常	まひ	✅	行動不能 12.5% + S×1/2、電気タイプ免疫
状態異常	やけど	✅	物理×1/2 + HP/16、炎タイプ免疫
状態異常	どく	✅	HP/8、鋼・毒タイプ免疫
状態異常	もうどく	✅	n/16 加算スリップ、交代でカウンタリセット
状態異常	ねむり	✅	2 ターン固定
状態異常	あくび	✅	1 ターン予告 → Sleep(2)、交代で解除
状態異常	こおり / こんらん / メロメロ / バインド / やどりぎ	❌
同ターン内順序	先行付与状態を後攻行動前に反映	✅	やけどで後攻物理半減 / ねむりで後攻行動スキップ
交代	基本交代 + ランクリセット	✅
交代	交代時発動効果	❌	いかく / プレッシャー / 滅びのうた / 追い討ち
メガ進化	ステ・タイプ・特性切替	✅	各サイド 1 回
特性	全般	❌	じゅうなん / やるき / ふみん / いかく / 再生力 / 砂起こし / トレース等
持ち物	能動効果	❌	きのみ / オボン / たべのこし / 拘り系 / とつげき / しろいハーブ等
攻撃技	副次効果	❌	ダスト 30% 毒 / 火炎パンチ 10% やけど等
攻撃技	反動技	✅	ブレイブバード 1/3 / すてみタックル 1/4 / はめつのひかり 1/2 等 12 種
攻撃技	自滅技	✅	じばく / だいばくはつ
攻撃技	反動硬直 (次ターン完全スキップ)	✅	はかいこうせん / ギガインパクト / ブラストバーン / ハイドロカノン / ハードプラント。技選択・交代ともに不可
攻撃技	2 ターン溜め	❌	ソラビ / ロケットずつき / ダイビング等
攻撃技	タイプ相性上書き	❌	フリーズドライ / フライングプレス
変化技	壁 / 設置技 / 守る / 天候変動 / フィールド展開	❌
変化技	回復技	❌	じこさいせい / なまける等
特殊システム	Z 技 / ダイマックス	❌	未実装