Awesome
admiral_stats_exporter
艦これアーケードの公式プレイヤーズサイト内にある 提督情報ページ から、自分のプレイデータをエクスポートする非公式ツールです。
このツールの開発および www.admiral-stats.com でのサービス提供はすでに終了しています。
Ruby 版と PowerShell 版があります
エクスポータの種類 | 対応OS | メリット |
---|---|---|
Ruby 版 | Windows, Mac, Linux など(Ruby の動作する環境全般) | 対応 OS が多い、実験的な機能はこちらから実装 |
PowerShell 版 | Windows(PowerShell 3.0以降が必要) | インストール作業が簡単(ただし、実行権限の設定が必要な場合あり) |
PowerShell 版は <a href="https://twitter.com/sophiarcp" target="_blank">@sophiarcp</a> さんにご提供いただきました。Thanks!
注意事項
- このツールは非公式なツールです。本ツールの開発者は、このツールを利用することによるいかなる損害についても一切責任を負いません。
- このツールは、提督情報ページ内の表示に使われる JSON データを、そのままファイルに出力します。そのため、JSON ファイルの形式は、公式サイトの更新に伴って突然変わる可能性があります。
- 1個の SEGA ID に複数の Aime カード(複数の提督情報)を紐付けている場合、データをエクスポートできない可能性があります(開発者の想定外だったため、2016-10-06 時点で未検証)。
事前作業(Ruby/PowerShell 共通)
このツールを使うためには、事前に以下の作業が必要です。
- SEGA ID の登録
- SEGA ID 新規登録ページ の指示に従って、登録してください。
- 公式プレイヤーズサイト(提督情報ページ)ヘのログイン確認
- 提督情報ページ の指示に従って、初回ログインを行ってください。
- 初回ログイン時に、SEGA ID と Aime カードのひも付けが行われます。
- このページで自分のプレイデータを閲覧できない場合は、admiral_stats_exporter も動作しません。
Ruby 版
Ruby 版のインストール手順
1. Ruby のインストール
admiral_stats_exporter を動かすには、Ruby が必要です。
Windows ユーザで、Ruby をインストールしたことがない場合は、以下の手順をお勧めします。
- RubyInstaller のダウンロードページ から "Ruby 2.3.1" または "Ruby 2.3.1 (x64)" をダウンロード
- ダウンロードしたファイル(rubyinstaller-2.3.1.exe または rubyinstaller-2.3.1-x64.exe)を実行
- インストール中に出てくる「Ruby の実行ファイルへ環境変数 PATH を設定する」のチェックボックスを ON にする
2. Bundler のインストール
コマンドプロンプト、またはコンソールを開いて、以下のコマンドを実行してください。
Ruby がインストールされて、パスが通っていれば、実行できるはずです。
gem install bundler
3. admiral_stats_exporter のダウンロード
Releases ページ から zip ファイルをダウンロードして、好きな場所に解凍して下さい。
git を使える場合は master ブランチを clone しても OK です。
4. 必要なライブラリのダウンロード
コマンドプロンプト、またはコンソールを開いて、admiral_stats_exporter を解凍したディレクトリに移動してください。
そして、以下のコマンドを実行してください。
bundle install
5. config.yaml の作成
config.yaml.sample (Windows の場合は config.yaml.sample.dos)をコピーして、同じディレクトリに config.yaml ファイルを作成してください。
そして、SEGA_ID
, PASSWORD
, API_TOKEN
と書かれた箇所に、以下の情報を記入してください。
SEGA_ID
- 公式プレイヤーズサイトのログインに使った SEGA ID
PASSWORD
- 公式プレイヤーズサイトのログインに使ったパスワード
API_TOKEN
(※ 自動アップロード機能を使わない場合は設定不要)- Admiral Stats の「設定>API トークンの設定」で確認できる API トークン
login:
id: SEGA_ID
password: PASSWORD
output:
dir: ./json
upload:
token: API_TOKEN
Ruby 版の実行
エクスポートのみ実行する場合
admiral_stats_exporter.rb のあるディレクトリで、以下のコマンドを実行してください。
実行に成功すると、 json/コマンドの実行日時
ディレクトリに、最新のプレイデータがエクスポートされます。
$ bundle exec ruby admiral_stats_exporter.rb
Succeeded to download Personal_basicInfo_20170309_222344.json
Succeeded to download Area_captureInfo_20170309_222344.json
Succeeded to download TcBook_info_20170309_222344.json
Succeeded to download EquipBook_info_20170309_222344.json
Succeeded to download Campaign_history_20170309_222344.json
Succeeded to download Campaign_info_20170309_222344.json
Succeeded to download Campaign_present_20170309_222344.json
Succeeded to download CharacterList_info_20170309_222344.json
Succeeded to download EquipList_info_20170309_222344.json
Succeeded to download Quest_info_20170309_222344.json
Succeeded to download Event_info_20170309_222344.json
Succeeded to download RoomItemList_info_20170309_222344.json
エクスポート後に自動アップロードする場合
エクスポート後に、Admiral Stats へ JSON ファイルを自動アップロードしたい場合は --upload
オプションを付けて実行してください。
Admiral Stats の「設定>API ログの確認」で、アップロードに成功したかどうかを確認できます。
$ bundle exec ruby admiral_stats_exporter.rb --upload
Succeeded to download Personal_basicInfo_20170309_222344.json
Succeeded to download Area_captureInfo_20170309_222344.json
Succeeded to download TcBook_info_20170309_222344.json
Succeeded to download EquipBook_info_20170309_222344.json
Succeeded to download Campaign_history_20170309_222344.json
Succeeded to download Campaign_info_20170309_222344.json
Succeeded to download Campaign_present_20170309_222344.json
Succeeded to download CharacterList_info_20170309_222344.json
Succeeded to download EquipList_info_20170309_222344.json
Succeeded to download Quest_info_20170309_222344.json
Succeeded to download Event_info_20170309_222344.json
Succeeded to download RoomItemList_info_20170309_222344.json
Importable file types: Personal_basicInfo, TcBook_info, CharacterList_info, Event_info
艦娘一覧のインポートに成功しました。(ファイル名:CharacterList_info_20170309_222344.json)
イベント進捗情報が空のため、無視されました。(ファイル名:Event_info_20170309_222344.json)
基本情報のインポートに成功しました。(ファイル名:Personal_basicInfo_20170309_222344.json)
艦娘図鑑のインポートに成功しました。(ファイル名:TcBook_info_20170309_222344.json)
Windows 上で動かしたときに SSL のエラーが表示された場合
以下のページを参考に、SSL 証明書を設定してください。
PowerShell 版
PowerShell 版のインストール手順
1. PowerShell のインストール(古い OS の場合のみ)
Invoke-* コマンド実行のため、Windows PowerShell 3.0 以降が必要です。Windows 8, 10 は PowerShell 3.0 以上のため、問題ありません。
Windows 7 は古い PowerShell がインストールされている場合があります。その場合は、以下のページなどを参考に、PowerShell 3.0 以上をインストールしてください。
2. admiral_stats_exporter のダウンロード
Releases ページ から zip ファイルをダウンロードして、好きな場所に解凍して下さい。
git を使える場合は master ブランチを clone しても OK です。
PowerShell 版の実行
エクスポートのみ実行する場合
admiral_stats_exporter_ps.ps1 を右クリックして「PowerShell で実行」を選択、または admiral_stats_exporter_ps.bat をダブルクリックして実行します。
実行に成功すると、 json/コマンドの実行日時
ディレクトリに、最新のプレイデータがエクスポートされます。
初回実行時のみ認証情報登録ダイアログが表示されるので、プレイヤーズサイトの 提督情報ページ のID/パスワードを入力してください。 同フォルダの cred.xml にID/パスワードが記録されます。
エクスポート後に自動アップロードする場合
エクスポート後に、Admiral Stats へ JSON ファイルを自動アップロードしたい場合は admiral_stats_exporter_ps_doupload.bat をダブルクリックして実行してください。 Admiral Stats の「設定>API ログの確認」で、アップロードに成功したかどうかを確認できます。
PowerShell 版を実行時にセキュリティ警告が表示された場合
PowerShell 版の実行時に、セキュリティ警告が表示される場合があります。その場合は、以下のいずれかの方法で実行してください。
- 「[R] 一度だけ実行する」を選択して、bat ファイルの実行を一時的に許可する
- この方法で実行すると、ps1 ファイルの実行が一時的に許可されます。実行のたびに R の入力が必要です。
- admiral_stats_exporter_ps.bat と admiral_stats_exporter_ps.ps1 の実行を許可する
- admiral_stats_exporter_ps.bat と admiral_stats_exporter_ps.ps1 のプロパティを開き、「ブロックの解除」にチェックを入れてください。
- PowerShell の実行ポリシーを Restricted から RemoteSigned に変更してから、admiral_stats_exporter_ps.ps1 を直接実行する
- 上記の2つの方法で実行できない場合は、PowerShell の実行ポリシーを変更すると実行できる可能性があります。以下のサイトの「コマンドラインから実行してもらう」などを参考にしてください。
- Powershellを楽に実行してもらうには - Qiita
注意点
ID/パスワードを間違えた場合、または SEGA のID/パスワードを変更した場合は、同フォルダの cred.xml を削除してください。次回実行時に再登録できます。
エクスポートされたファイルの詳細(Ruby/PowerShell 共通)
admiral_stats_exporter は、以下のようなファイル名で、プレイデータをエクスポートします。
提督情報での表示 | ファイル名 |
---|---|
基本情報 | Personal_basicInfo_yyyymmdd_hhmmss.json |
艦娘図鑑 | TcBook_info_yyyymmdd_hhmmss.json |
艦娘一覧 | CharacterList_info_yyyymmdd_hhmmss.json |
装備図鑑 | EquipBook_info_yyyymmdd_hhmmss.json |
装備一覧 | EquipList_info_yyyymmdd_hhmmss.json |
海域情報 | Area_captureInfo_yyyymmdd_hhmmss.json |
任務一覧 | Quest_info_yyyymmdd_hhmmss.json |
イベント進捗情報 | Event_info_yyyymmdd_hhmmss.json |
家具一覧 | RoomItemList_info_yyyymmdd_hhmmss.json |
期間限定作戦進捗情報 | Cop_info_yyyymmdd_hhmmss.json |
※ yyyymmdd_hhmmss は、エクスポートを実行した時刻