KeiryouAIM(仮)

ブラウザーベースのタクティカルシューター向けエイム練習ソフトウェア

特徴

• ブラウザーで動作: インストール不要、HTMLファイルを開くだけ
• タクティカルシューター準拠の物理: 移動速度、ストッピング、ジャンプの完全再現
• 3つのグラフィックモード:
  • 線画版: 最軽量、144fps以上推奨
  • 標準版: バランスの取れた実用的デザイン
  • リッチ版: 視覚的に豪華で没入感のある体験
• 複数の練習モード:
  • プリエイム練習
  • フリック練習
  • 複数ターゲット連続フリック
  • 実戦シミュレーション
  • フリープレイ
• 精密な射撃システム: レイキャスティングによる正確なヒット判定
• リアルタイム統計: 精度率、ヘッドショット率、反応時間の計測
• カスタマイズ可能:
  • マウス感度（主要なタクティカルシューターと互換）
  • クロスヘア（色、サイズ、形状）
  • グラフィック設定
  • オーディオ設定

必要環境

線画版

• GPU: WebGL 1.0対応、統合GPU可
• RAM: 2GB以上
• ブラウザー: Chrome 70+, Firefox 70+, Edge 70+
• 推奨FPS: 144fps以上

標準版

• GPU: WebGL 1.0対応、GTX 1060 / RX 580相当以上
• RAM: 4GB以上
• ブラウザー: Chrome 80+, Firefox 80+, Edge 80+
• 推奨FPS: 60-120fps

リッチ版

• GPU: WebGL 2.0対応、RTX 2060 / RX 5700相当以上
• RAM: 8GB以上
• ブラウザー: Chrome 90+, Firefox 90+, Edge 90+
• 推奨FPS: 120fps以上

使い方

1. 起動方法

# リポジトリをクローン
git clone https://github.com/Chiytako/KeiryouAIM
cd KeiryouAIM

# index.htmlをブラウザーで開く
# Windowsの場合
start index.html

# macOSの場合
open index.html

# Linuxの場合
xdg-open index.html

または、index.htmlをダブルクリックしてブラウザーで開きます。

2. 初期設定

1. メインメニューから**「設定」**をクリック
2. マウス設定を調整:
   • DPI: お使いのマウスのDPI値を入力
   • ゲーム内感度: ゲーム内の感度を入力
3. グラフィック設定を選択:
   • デザインモード: 線画版 / 標準版 / リッチ版
   • FOV: 視野角（デフォルト: 103）
4. クロスヘア設定をカスタマイズ（オプション）
5. 設定を保存して閉じる

3. ゲームプレイ

1. メインメニューから練習モードを選択
2. 画面をクリックしてマウスをロック
3. 操作方法:
   • W/A/S/D: 移動
   • マウス: 視点移動
   • 左クリック: 射撃
   • スペース: ジャンプ
   • Ctrl: しゃがみ
   • ESC: ポーズ
4. ターゲットを撃って精度を高めましょう！

練習モード詳細

プリエイム練習

• 固定位置でのクロスヘア配置練習
• ターゲットが出現する前にクロスヘアを配置
• 難易度: 初級

フリック練習

• 近～中距離（5-30度）のフリック練習
• ランダムな位置にターゲットが出現
• 難易度: 中級

複数ターゲット連続フリック

• 2-5個のターゲットを順次破壊
• 様々な配置パターン
• 難易度: 上級

実戦シミュレーション

• ピーク、クリアリング、接敵の総合練習
• 移動とストッピングを組み合わせた実戦的な練習
• 難易度: エキスパート

フリープレイ

• 自由な練習モード
• ターゲット数や配置をカスタマイズ可能
• 難易度: カスタム

データと統計

リアルタイム統計

• ヒット数: 命中した弾数
• ミス数: 外れた弾数
• 精度率: ヒット数 / 総射撃数
• ヘッドショット率: ヘッドショット数 / ヒット数

保存データ

すべての設定とセッションデータはブラウザーのLocalStorageに保存されます。

トラブルシューティング

マウスがロックされない

• ブラウザーがPointer Lock APIをサポートしているか確認
• 画面をクリックしてからマウスをロック
• フルスクリーンモードを試す

フレームレートが低い

1. グラフィックモードを線画版に変更
2. 他のブラウザータブを閉じる
3. 解像度スケールを下げる（設定 → グラフィック → 解像度）
4. FPS制限を設定（設定 → グラフィック → FPS制限）

感度が合わない

1. 設定でDPIとゲーム内感度を正確に入力
2. ゲーム内の感度をメモして入力
3. 計算式: cm/360° = (360 × 2.54) / (DPI × 感度 × 0.07)

技術仕様

使用技術

• Three.js (v0.160.0): 3Dレンダリング
• HTML5 Canvas: 2D UI（クロスヘア）
• ES6 Modules: モジュラー設計
• LocalStorage: データ永続化
• Pointer Lock API: マウス制御
• Performance API: 高精度タイミング

物理パラメータ

• 歩行速度: 5.4 units/sec (標準的なタクティカルシューター準拠)
• ジャンプ高さ: 正確な再現
• ストッピング: 独自の減速カーブ
• ヒットボックス: ヘッド半径20cm、ボディ高さ180cm×幅40cm

ファイル構成

KeiryouAIM/
├── index.html              # エントリーポイント
├── css/
│   ├── main.css           # 基本スタイル
│   ├── menu.css           # メニュー
│   └── hud.css            # HUD
├── js/
│   ├── main.js            # アプリケーション本体
│   ├── core/              # コアシステム
│   ├── player/            # プレイヤー制御
│   ├── targets/           # ターゲット管理
│   ├── ui/                # UI要素
│   └── utils/             # ユーティリティ
└── README.md              # このファイル

今後の拡張予定

• 詳細な分析システム（ヒートマップ、軌道分析）
• リプレイ機能
• カスタムシナリオエディター
• オンラインランキング
• 追加の練習モード
• サウンドエフェクトの追加
• マップバリエーション

注意事項

• このソフトウェアはベータ版です
• 本ソフトウェアは特定のゲームタイトルの公式製品ではありません
• 各ゲームタイトルの商標はそれぞれの所有者に帰属します

ライセンス

MIT License

貢献

バグ報告や機能リクエストは、GitHubのIssuesで受け付けています。

クレジット

• 開発: Claude (Anthropic)
• 要件定義: ユーザー提供の詳細な仕様書

---

楽しいエイム練習を！Good luck, have fun! 🎯