非同期ネットゲーム仕様書

はじめに

本書は、RPGアツマールで開催される非同期ネットゲームコンテスト（2019年3月3日(日)23:59〆切）に向けて作成するゲームの仕様を書いた物である。

マークダウン記法で記述するテキストデータである。
UML部分はPlantUMLを使用する。

マークダウン記法

本書で使用するマークダウン記法について、使い方と書き方を以下に記述する。

使い方

PlantUMLというVSCodeの拡張機能と、描画用にGraphviz（要Java）を使う。
VSCodeで、ctrl+k の後に v を押してプレビュー表示できる。
もしくは右上の虫眼鏡アイコンをクリックする。
Wikipedia「Markdown」
https://ja.wikipedia.org/wiki/Markdown
参考にした記事
https://www.eureka-moments-blog.com/entry/2018/12/17/121617

書き方

マークダウン記法では、文章内の改行は無視される。
画面の右端で自動改行される。
明示的に改行させたい時は行末に空白2つを付ける。
このようになります。
ですよ。

ハイフン＋スペース「- 」を行頭に付けると、箇条書きになる。
行頭に「●」が付く。
- 行頭にスペース2個を付けると、インデントも可能。
本書では要件や仕様に関する記述は、基本的に箇条書きで記述している。

連番による箇条書きは、番号＋スペースを行頭に付ける。
1. 番号は「1. 」だけでも自動採番される
2. だから、「1. 」の方が変更に強い
改行が必要な時は、このように
行末にスペース2個を付ける。
番号の場合はスペース4個でインデントする。
本書では処理の順序を表したい場合に使用する。

【注意】
箇条書きや引用などの文章の塊がある場合、その塊の種類が変わる所で空白行を入れる。

「> 」は引用です。
引用する時に開始行の先頭に使います。
このように表示されます。

表は以下のように記述する。

|A|ヘッダ|てすと|項目名|
|---|:---:|---|---|
|AAA|B|テスト|表の内容|
|Aの内容2|センタリング|C|表の内容2|
|Aの内容03|表はこのように書く|Test|D|

この記述により、以下のように表示される。

A	ヘッダ	てすと	項目名
AAA	B	テスト	表の内容
Aの内容2	センタリング	C	表の内容2
Aの内容03	表はこのように書く	Test	D

バッククォート3個「```」を開始行、終了行に書いて囲った
  この範囲は
自由に空白や改行できる。

開始側のバッククォート3個「```」の後に、テキストデータの形式を記述する。
この例では「```text」としているが、
「```javascript」「```plantuml」と書くと、その言語として表示される。

そのため
  ソースコードを
    書くのに最適。

本書で使いそうなマークダウン記法の書き方は以上。
なお、下の横線は「***」と記述する。

ゲーム情報 (概要)

ゲームの目的

花を育てる。
- 当初予定では、「いちご狩り」をするゲームであったが、いちごの素材がないため断念した。
花をプレゼントして好感度を上げる。
キャラクターの人気投票をする。

ゲームタイトル

『花摘み【パケキャラ総選挙】』を仮タイトルとする。
- 「花摘み」は品がないがインパクトはあると思われるので、仮タイトルとする。
最終的に、タイトルは『PKG16 総選挙』とした。

ゲームの流れ (基本設計)

概要

放置系ゲームの要領で花を育て、花をパケキャラにプレゼントし、プレゼントの量でパケキャラの人気を競う。
「パケキャラ」とは、RPGツクールMVの「パッケージキャラクター」の事である。本ゲームではNPCである。
他人が育てた花を取る事が出来る。
パケキャラごとに好感度ランキングを用意する。

花を育てる

放置系ゲーム要素は以下の流れとする。

種を植える（プレイヤー操作）。
種が草に育つ（放置）。
草が花に育つ（放置）。
花が実になる（放置）。
実が種になる（放置）。
種が草に育つ（放置）。繰り返し。

花壇は全プレイヤー共通の領域とする。
花壇の数はプレイヤーの数に応じて増やす。
- 自動でマップの拡張できる？
  しかし、1プレイヤーに1マップなどにするとマップ数が増えると困るので、自動で増やすのはやめた方が良さそう。
- 花壇の数は何らかのタイミングで作者が手動で増やす。（増やせるように作る事）
花の成長状況を花の上に表示させたい。「あと何秒で次の状態になるか」を表示する。

花を摘む

プレイヤーは、「花」または「実」を採取する事が出来る。
「花」と「実」以外は採取できない。
花壇は共通領域なので、他のプレイヤーが育てた「花」や「実」を採取する事が出来る。
花を摘んだ花壇は「空き」になる。プレイヤーが種を植えるまで「空き」になる。

花をプレゼントする。

プレイヤーはパケキャラに「花」または「実」をプレゼントする事が出来る。
プレイヤーがプレゼントする事で、「好感度」と「種」と「所持金」を得る事が出来る
（このゲームに公職選挙法のようなものは無い）。
プレイヤーがプレゼントする事で、パケキャラの人気ポイントが上昇する。

種の入手

プレイヤーはゲーム開始時に「種」をいくつか持っている。
プレイヤーがパケキャラにプレゼントした時に、「種」と「所持金」をもらえる。
- 「実」をプレゼントした時に、その「種」をもらえると面白いかも。
  出所がはっきりしているので。
プレイヤーは所持金を使用して「種」を買う事が出来る。

プレイヤーのデータ

アイテム（植える前の「種」、採取した「花」または「実」）
- 「種」と「花」＆「実」でアイテム種別を分ける。
プレイヤーの実績を表す何か。
- 実績アイテム（大事なもの）
経験値（レベル）
所持金
好感度（パケキャラそれぞれなので、16人分）
- ステータス画面を使うのと、アイテムの個数で表現するの、どっちが楽？
- 変数を16個用意して、ステータス画面でその変数を表示する？

アツマールAPIを使う場面

花壇はプレイヤー共有なので、何らかのAPIを使用する。
- 使うAPIは、グローバルシグナルになりそう。
- 花の成長はプレイヤーごとに行い、採取した時にシグナルを送る。
- 採取シグナルを受け取ると、その花壇は「空き」になる。
- タイミングによっては、同じ花壇で複数プレイヤーが同時に採取できるが、許容する。
- APIの通信は『5秒に1回よりも緩やかにすること』との事なので、採取シグナル送受信のタイミングで、何らかの演出を行い、時間を稼ぐ。
ランキング機能を使う。
- パケキャラごとの好感度をランキングにする。
- パケキャラ総選挙の順位はランキング機能を使わない。プレイヤーのランキングではないので。
総選挙の順位に、グローバルサーバー変数を使用する。
- 1キャラにつき1変数を使用すると、16個のグローバルサーバー変数が必要になる。
- グローバルサーバー変数では、トリガーを使用して値の変更を行う。

パケキャラ

RPGツクールMVのパッケージキャラ16体を使う。
マップに表示する。
プレゼントを渡す事が出来る。プレゼントは総選挙の票（人気ポイント）を兼ねている。
- プレゼントは「花」または「実」である。
- アイテム選択の処理でプレゼントを渡す。
好きな「花」「実」があり、それによってプレゼント時の好感度に差がある。
好きな「花」「実」の説明と、プレゼントを渡す場所は分けておく。
- 好きな「花」「実」の説明はすぐに見れる場所に置く。
- プレゼントを渡す場所は、パケキャラごとにマップを用意する。
- プレゼントを渡してお礼を受け取ると、ランキングAPIの通信を行う。そのため、（プレゼントは1アイテムずつ選択するが）プレゼントに対してのお礼はまとめて受け取るのが良さそう。そのマップを出る時でもイイかも。

メモ

メッセージWindowに歩行キャラを表示させたい。名前だけでパケキャラを識別するのが難しいと思われるため。
- アイコン化（32×32）するか、プラグインを用意するか。
- IconSet.pngを下に拡張できるので、アイコン化するのが良さそう。

詳細設計

詳細設計の代わりに、JavaScriptのソースコードを記述する。

Promise全般

// promise() を使いたい場合
// thenはPromise受信時に実行される
// catchはエラー発生時に実行される
// ドット「.」区切りで連続して記述する
// 1行で書くとこのようになっている
promise().then(function(a){ 非同期処理 }).catch(function(b){ エラー処理 });

グローバルシグナル送信

window.RPGAtsumaru.experimental.signal.sendSignalToGlobal(data)
// catchはエラー発生時に実行される
// 引数errを受け取る
.catch(function(err){
    switch(err.code) {
    case "UNAUTHORIZED":
        // プレイヤーがログインしていない
        console.log('send error : UNAUTHORIZED');
        break;
    case "BAD_REQUEST":
        // ゲーム側で何か間違えているとき＝指定したボードIDが大きすぎるかマイナスの場合などに発生
        console.log('send error : BAD_REQUEST');
        break;
    case "INTERNAL_SERVER_ERROR":
        // サーバー側で何らかの問題＝通信不良やメンテ等で発生
        console.log('send error : INTERNAL_SERVER_ERROR');
        break;
    case "API_CALL_LIMIT_EXCEEDED":
        // 短時間にゲームAPIを利用しすぎて、一時的に利用を制限されている
        console.log('send error : API_CALL_LIMIT_EXCEEDED');
        break;
    }
});

グローバルシグナル受信

window.RPGAtsumaru.experimental.signal.getGlobalSignals()
// thenはPromise受信時に実行される
// Promiseの内容を引数vとして受け取る
// 非同期処理なので、いつ受信するかは分からない事に注意！
.then(function(v){
    KRD_checkSignal(v); // 別関数で処理する
})
// catchはエラー発生時に実行される
// 引数errを受け取る
.catch(function(err){
    switch(err.code) {
    case "INTERNAL_SERVER_ERROR":
        // サーバー側で何らかの問題＝通信不良やメンテ等で発生
        console.log('get error : INTERNAL_SERVER_ERROR');
        break;
    case "API_CALL_LIMIT_EXCEEDED":
        // 短時間にゲームAPIを利用しすぎて、一時的に利用を制限されている
        console.log('get error : API_CALL_LIMIT_EXCEEDED');
        break;
    }
});

データフロー