Google Apps Script SpreadsheetでGNT同時着弾タイマーを作る

1.前書き

GNT(ガンダムネットワーク大戦)はバンダイナムコのブラウザMMOリアルタイム戦略ゲームです
一つの敵の部隊に対して味方の複数の部隊を同時に戦闘させるとかなり有利にゲームを進めることができます
これを相手が受けてくれると戦闘に勝ちやすくなり戦略を有利に進めることができます
ですがこの同時に戦闘させるのはかなり熟練しないとタイミングを合わせることができないのです
これを簡単にできるようにするためのプログラムをスプレッドシートのマクロで作りました

作成にかかった時間は色々調べながら約6時間ほどで出来上がりました
この時にいろいろ気づいた点などがあるので作成方法も含めて様々な人に紹介することにしました

2.はじめに

スプレッドシートで空白を選択すると空のスプレッドシートができます

3.デザイン

シートには図形とチェックボックスをそれぞれ一つずつ配置しました

ボタン風の図形は「挿入」→「図形描画」を選択すると図形描画のフォームが現れるのでメニューから図形を選択さらにプルダウンメニューから「図形」→「ベベル（面取り）」を選択するとボタン風の図形ができます
さらにこれに「スタート」の文字を書きます

できた図形を右クリックすると選択できるようになり大きさの変更やスクリプトを割り当てることができるようになります
なぜ右クリックなのかというと左クリックすると通常は割り当てられてる関数が実行されてしまうので右クリックで選択する癖をつけた方がいいでしょう

スクリプトの割り当てには「StartTimer」と入力します
この「StartTimer」は後でスクリプトエディタで作成する関数です

セルの結合は複数セルを選択し下図の赤丸のボタンを押すと結合されます
(結合されたセルを元に戻す時もこのボタンを押します)

チェックボックスを配置します
チェックボックスはメニューの「挿入」→「チェックボックス」で配置できます
ここではシートの「E10」に配置します

グリッド線は消去しておくときれいに見えます
グリッド線を消すにはメニューの「表示」→「グリッド線」で消せます
すると次の画像のようになります

デザインはここまでです

4.プログラムコード

プログラムコードを書くにはメニューの「ツール」→「スクリプトエディタ」を選択します
するとAps Script画面になりコードを書くことができるようになります
プログラミング言語はJavaScriptです

プログラミングコードは以下

code

function StartTimer(){
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var cD5=sheet.getRange("D5").getValue();
  var cF5=sheet.getRange("F5").getValue();
  var dMe=new Date(0,0,0,0,Number(cD5),Number(cF5));
  var cD7=sheet.getRange("D7").getValue();
  var cF7=sheet.getRange("F7").getValue();
  var dTarget=new Date(0,0,0,0,Number(cD7),Number(cF7));
  var diffTime=dTarget-dMe;
  if(diffTime<=0){
    Browser.msgBox("設定時間がマイナスです\n先行部隊着弾時間は自部隊所要時間より長くないといけません");
    return;
  }
  sheet.getRange("D14").setValue(Math.floor(diffTime/(60*1000)));
  sheet.getRange("F14").setValue(diffTime%(60*1000)/1000);
  var saveTime=new Date();
  sheet.getRange("E10").uncheck();
  SpreadsheetApp.flush();
  while(sheet.getRange("E10").isChecked()==false){
    var now= new Date();
    var diffNowTime=now-saveTime;
    var diffTime2=diffTime-diffNowTime;
    sheet.getRange("D14").setValue(Math.floor(diffTime2/(60*1000)));
    sheet.getRange("F14").setValue(Math.floor(diffTime2 % (60*1000)/1000));
    if(sheet.getRange("D14").getValue()<0){
      break;
    }
  }
}

5.プログラムコードのアクセスの許可

赤丸のリンクやボタンを順に押していくと作成したスクリプトが使えるようになります
また、この時にGoogleから確認のメールが届きます(これは無視してかまいません)

6.プログラムで使ったクラスやメソッドの簡単な説明

Number()　文字列を数値に変換します　他にparseIntがあります　それぞれ数値以外の文字が入ったときの挙動が変わります
Date　Dateクラスです　年月日を0に設定すると時間計算がしやすくなります
Math.floor　小数点切り捨てを行います
uncheck()　チェックボックスのチェックを外します
isChecked()　チェックボックスのチェックの状態を取得します

7.動かしてみる

自部隊所要時間に8分53秒、先行部隊着弾に10分0秒をセットしてスタートボタンを押してください
出撃時刻がカウントダウンされるはずです
GNTではこの出撃時刻が0分0秒になったときに出撃ボタンを押すと同着攻撃ができます
先行部隊着弾時間はキリの良い時間の方が合わせやすいと思います

また先行部隊着弾時間が自部隊所要時間より短い場合はエラーメッセージが表示されカウントダウンは行われません

カウントダウンを途中で止めたい場合はストップチェックボックスをオンにしてください

※重要
スタートボタンの2度押しはしないでください
もし押してしまった場合はスクリプトのキャンセルのリンクを押すかストップチェックボックスをオンにしてください

8.GoogleSpreadとExcelの違いの感想

GoogleSpreadはまだ資料も少なく機能もExcelに比べると少ないですね
ただしGoogleSpreadは簡単にWeb上でリンク共有できるのはいいですね

両方使えるならそれぞれの長所を活かして好きな方を選べばよいのではないのでしょうか