WOLF RPG Editor

「WOLF RPGエディター」を利用中、挙動のおかしい現象を確認した場合には
まずは下記内容を確認する

1. PCを再起動して確かめる
2. 最新版のWOLF RPGエディターを再度ダウンロードして確かめる
3. 環境依存の可能性も高いため、他PCがあれば同様の現象が発生するか確認する
4. 似たような現象報告が無いか、公式サイトの「バグ報告スレッド」及び「何でも質問スレッド」にて確認する

上記でも改善しない場合、不具合の可能性を否定できませんが、自分の勘違いや操作・
設定ミス、仕様の範囲内での挙動という可能性もあります。
不具合を確信できるよう、十分な試行・確認・切り分けを行ってください。

補足：【基本的な対処法】というよりも【前提事項】です。
　　　 上記の試行を否定する内容であれば別ですが、ウディタプログラムの破損やウディタ
　　　 以外の部分で問題がないことを確認しておかないと、要因特定が困難になります

　公式サイト：WOLF RPGエディターフォーラム

http://vanzgraphica.web.fc2.com/udexita/index.html#etc_basicmethod

この項では、現象の切り分けについて簡単に説明します。
切り分けの極々基本的な内容しか記載できませんが、お役に立てればと思います。
なお、この項の内容は前項【基本的な対処法】をクリアしていることが前提です。

現象の切り分け内容は多岐に渡り、有効的な方法もケースバイケースの為汎用的に言える事は少ないです。
ただし、要素をしっかり絞り込めば必要な計算・方法の算出は意外と簡単です。

　　　　　　　　　　　　　　　　　A（環境/状態）＋B（操作）＝C（現象）

方程式があるとすれば、こんな具合でしょうか。
現象を確認した際に、上記のAとBが何を意味しているのか漠然とでも解るようになると、それを確認するためにどういった計算や処理を行えばよいのか、自ずと導かれます。

以降、自作ゲーム中マップaからマップbに移動するとゲームが強制終了するという、架空の現象を例題として進めます。

　　　　　　　　　　　　　　　　　　　　　　　　　　　◇

まず最初に行うことは、A・Bそれぞれに対して、要因を特定することです。
切り分けの基本は、確かめたい要素だけを変化させ、他の要素は何も変化させないことです。

　　　　　　　　　　　　　　　　　　　　　　　　　　　◇

簡単に確認できる方法として、同じデータ上で同じ内容の異なる操作を行ってみます。
マップの端にキャラが移動したら、「場所移動」でマップbに移動する処理を設けているかと思います。
そこで、マップ移動を管理しているイベント上で、マップbではなくマップcに移動するイベントに変更してみます。

A＋B＝C　ならば　A＋B'＝C　が成り立つか確認する作業です。
これを行うことで、B（操作）の要因が「マップbに移動すること」かどうか判別します。

　■マップcに移動すると現象未発生
　　→「マップbに移動すること」に要因の可能性あり

　■マップcに移動しても現象確認
　　→「他マップに移動すること」に要因の可能性あり

「他マップに移動すること」に要因があると踏めれば、同様にマップd やe にも移動処理を行って確認します。
その結果、特定のマップに移動することが要因ではなく「場所移動」コマンドに要因がある、という結論に至るかもしれません。

　　　　　　　　　　　　　　　　　　　　　　　　　　　◇

続いて環境/状態の切り分けです。
異なる環境で同じ操作を行った際に現象が確認できなければ、元の環境による問題の可能性があります。

A＋B＝C　ならば　A'＋B＝C　が成り立つか確認する作業です。

手段の一つとして、改変の無いサンプルゲームで確認するというのは、有効な切り分けの一つです。
サンプルゲームに同じイベントをおいて検証してみます。

　■サンプルゲームでも現象が確認
　　→操作内容（イベント）に要因の可能性あり

　■サンプルゲームで現象が確認出来ない
　　→自作された部分(AとA'の差分)に要因の可能性あり

結果より、上記の内容に結論付けることが可能です。

冒頭でも述べましたが、切り分けを行う際は A'＋B'＝C　になっていないかどうかご注意ください。
「確かめたい要素だけを変化させ、他の要素は何も変化させない」ことが肝心です。

一度に二つの要素の切り分けは、要因をあやふやにさせるだけでなく、要因の誤認に繋がりかねません。
必ず A'＋B＝C、A＋B'＝C を個別に確認するようにしてください。

　　　　　　　　　　　　　　　　　　　　　　　　　　　◇

A・Bの要因が特定できたら、確認した内容が正しいかどうか「逆」を使って確定させます。

たとえば要因が「マップa からb に移動する事」と認識したとします。
上記の場合、マップa からマップb に移動したときのみ現象が確認できなければ、正確ではありません。
つまりマップa → b だけではなく、マップb → a に移動した際に、現象が発生しないことを確認しておきます。

もし、マップb → a に移動した際にも現象が確認できれば、「場所移動」コマンドそのものに要因があるのかもしれません。 少なくとも要因が「マップa からb に移動する事」ではなくなりますので、認識を改める必要があります。

要因を特定できたなら、「逆」を使って要因を確定させるところまで試行できれば、ベストです。

　　　　　　　　　　　　　　　　　　　　　　　　　　　◇

A・Bそれぞれの要因が確定できました。
確定できたら、さらにもう一手指しておきます。

空データを用意して、最低限のイベントやグラフィックのみを置いて現象が確認できるかどうか、検証します。
こうする事によって他要素から影響を受ける事なく、要因を検証することが可能です。

不必要な要素が存在すると、検証結果が異なったり正しい結果に繋がらなかったりします。
不必要な要素を排除することで、要因のみをダイレクトに一点検証することが可能です。

正しい認識と正確な切り分けが出来ていたら、最低限のデータだけで現象の確認が出来るはずです。
余計な要素を省いているので、それはシンプルで純度の高いソースになります。

シンプルで純度の高いソースは、「バグ報告スレッド」にて検証データをアップするにあたり、申し分のないデータとなるでしょう。
また余計な要素を省いているので、製作者様も確認を行う際にスムーズに確認できるに違いありません。

　　　　　　　　　　　　　　　　　　　　　　　　　　　◇

以上、現象の切り分けについて思いつくままに記載しました。
話が長くなりましたが、考え方についての基本なので、慣れてくれば途中を省いたり応用が可能です。
また、最後まで確認するためには工数が少しかさみます。
しかし正確な情報を掴むためにも、自身の環境で確かめられる所までは、頑張って確認してみてください。

なお、A+B＝C A'+B=C A+B'=C という考え方は、デバッグやプログラムの組み方にも応用が可能です。

確認された現象が、どんなイベントコマンドが要因になっているのか特定が早ければ、効率の良いデバッグを行うことが可能です。
イベント（C）がどんな要素（A・B）を含んで成立しているか細分化できるようになれば、ウディタで複雑なイベントを組む際に大きな手助けになるはずです。

ぜひ、お役立てください。

http://vanzgraphica.web.fc2.com/udexita/index.html#et_technique

不具合と確信できた際には、公式サイト「バグ報告スレッド」にて報告が可能です。
その際には不具合の内容と共に、必要に応じて下記項目を明記すると良いでしょう。

• 利用OS、及びサービスパック
• WOLF RPGエディターの利用バージョン
• 現象発生手順
• Game部、Editor部、どちらでのエラーか
• 表示エラー名（あれば）
• 発生頻度（解れば)
• 発生ゲームデータ（差し支えなければ）

ただし、現象が確認できないと製作者様側でも対処のしようが無いと思います。
このとおり操作すれば確実に確認できるという発生手順、もしくは現象発生データを、
極力明記・提供ください。

ご協力をお願いします。

　公式サイト：WOLF RPGエディターフォーラム

http://vanzgraphica.web.fc2.com/udexita/index.html#etc_notimprovement

デバッグとは、想定外の挙動を見せているプログラム部分を探し出し、適切な内容に修正し、想定している挙動に近づける作業です。

想定している挙動に近づけるためには、ゲーム内部で管理されている内部情報（変数や使用されているファイル名等）を正確に把握していないと効率よく進みません。
そこで内部情報を画面に表示して、目視しながら進めていくと効率が良い上に認識ミスを防ぐことが可能です。

この項では、内部情報を画面で確認する方法と、デバッグの方法について端的に説明します。

なお、デバッグについての基本的な考えは「現象の切り分けについて」について記載した内容を用いることが可能です。
そのため考え方については割愛いたします。

内部情報を確認する方法については、主に以下の方法があります。

内部情報を確認する方法について

　a.テストプレーで開始、F8にて確認
　b.同、F9で確認
　c.「文字列をピクチャとして描画」にて、特殊文字を指定して確認
　d.文章表示にて、特殊文字を指定して確認
　e.自分でデバッグイベントを作成する

順に説明していきます。

a.テストプレーで開始、F8にて確認

　■確認できる内容：
　　�@使用中のピクチャ（括弧内は画像）と音声の総数
　　�A読み込まれている画像ファイル名と、Dataフォルダを基準としたパス
　　�B読み込まれている音声ファイル名と、Dataフォルダを基準としたパス
　　�C読み込まれている各種チップファイル名と、Dataフォルダを基準としたパス
　　�D利用されているピクチャ番号
　　�E同時に実行されている並列コモン番号

　■特徴：
　　F8を押している間のみ表示される
　　「並列イベント」と同じような挙動のため、表示させながらゲームの進行が可能

　■注意：
　　game.exeで開始した際には実行できないので、editor.exeからの「テストプレイ開始」から実行すること


b.同、F9で確認

　■確認できる内容：
　　通常変数、文字列変数、システム変数、システム文字列に格納されている値、及び文字

　■特徴：
　　F9を押すと表示され、決定キー（Enterキー）・スペース・マウスクリックで画面の更新・終了が可能
　　「自動実行イベント」と同じような挙動のため、表示させながらゲームの進行は不可

　■注意：
　　game.exeで開始した際には確認できないので、editor.exeからの「テストプレイ開始」から確認すること

　■参考：
　　F9中は決定キー（Enterキー）・スペース・マウスクリック以外のボタン操作が無効になる
　　そのためPrint Screenキーでキャプチャの採取は不可


c.「文字列をピクチャとして描画」にて、特殊文字を指定して確認

　■確認できる内容：特殊文字で表示可能な変数

　■特徴：表示イベントの組み方に依存

　■注意：表示はイベントの組み方に依存するので、表示させたタイミングと現時点で値が異る場合があること
　　　　　 に注意


d.文章表示にて、特殊文字を指定して確認

　■確認できる内容：特殊文字で表示可能な変数

　■特徴：
　　決定キーで文章を終了させない限り表示される
　　また、「文章表示」を置いたプログラムの進行もそこでストップされる
　　プログラムが進まないので、その時点での正確な内容を把握する際に便利


e.デバッグイベントを自作する

　■確認できる内容、特徴、注意：作成したイベント内容に依存
　　 デバッグイベントの参考として、wikiに登録されているデバッグコモンをリンクとして挙げておきます。

　WOLF RPGエディターWiki＞自作コモンイベント＞Self変数＆cdb監視コモン

また、特定のコマンド部分が怪しいと察した場合、その部分を除外してテストプレイすることで判別が可能です。

　■除外しても現象発生
　　→除外した箇所は要因ではない

　■除外して現象改善
　　→除外した箇所に要因あり

除外する際にdelキーで削除してしまうと、除外した内容を復旧させることが出来ません。
イベントやコマンドを除外する際はdelキーでなくxキーで切り取って除外しておきます。
テストプレーの確認後、除外箇所をvキーで復旧を簡単にするためです。

また、ウディタではいわゆる「コメントアウト」機能は実装されていません。
擬似的な方法として、ラベル移動とラベルで挟んでおく事で実質可能です。
テストプレイで確認する際に、ラベル移動を削除して確認、ラベル移動を追加してコメントとして保持します。
（逆の、ラベルとラベル移動だと無限ループになるので、気をつけてください）

また、公式サイトで他のユーザーの方から教わった方法ですが、ループ回数０回の回数付ループにコマンド内容を格納しておいても同様の処理が可能です。

但し、二つの方法は単体では想定どおりの挙動を確認していますが、他プログラムにどう影響するか保障できません。
使用は自己責任でお願いします。

以上、デバッグの方法について端的に説明させていただきました
デバッグの効率は、製作状況にそのまま影響します。
効率の良いデバッグ方法を見つけ出すのも、製作状況を早める一歩だと思います。

http://vanzgraphica.web.fc2.com/udexita/index.html#et_debug