1. k4nagatsuki Avatar k4nagatsuki
  2. CardWirth with WSN
  3. CardWirthPy Reboot
  4. Issues

タスク: チュートリアルを整備する

Issue #200 resolved
k4nagatsuki repo owner created an issue

初心者向けのみならず、CardWirthからの乗り換えに際してもなんらかのチュートリアルが必要です。

例えばデバッガでイベントの流れを変える機能やカードにスターを付ける機能などは言われなければ気づかないものだと思われます。

実現にはいくつかの方法があり、並立も可能です。

  • ヘルプを整備してチュートリアルをつける
  • Webサイトを整備してチュートリアルをつける
  • エンジンにチュートリアル機能をつける(初めて開く場面ごとにツールチップが出てプレイヤーの行動へのヒントを表示するなど)
  • 見やすい形で追加機能を紹介する

これらはやらないよりはやった方が確実にいいのですが、なかなか大変そうで手につかない作業です……。長いスパンで考えていきます。

Comments (12)

  1. 暗黒 騎士

    デバッガの解説を書いていて、不安に思ったことが数点。嘘を書いていても問題なので教えて下さい。

    1.デバッガの背景更新（Ctrl+R）とイベント強制終了(F12)はそれぞれ画面再構築コンテントと効果中断コンテントを実行した時と同じという理解でOKでしょうか。

    2.デバッグモード時、貼り紙の「エディタから開く」で旧WBを指定しているとWBが起動するだけでシナリオが開けなくなっているのは仕様でしょうか（デバッガからは開けるし、以前はこちらからも開けた気がするのですが…勘違いだったかも）

    3.まとめとして以下は適切かどうか。

    まずデバッグしたいイベントツリー実行中に一時停止ボタンを押してみる。イベントを再開したい場合はもう一度押せばOK。メッセージやウェイトがほとんど無く、停止する間もなく一瞬で終わってしまう場合はウェイト窓に数字を入力して実行間隔を遅くする。

    ステップオーバー／ステップインはそれぞれ一コンテントずつ、メッセージコンテントのように手動送りできるが ステップオーバーはコール先は通常実行し、ステップインはコール先でも停止する。 ステップリターンは手動送りをやめ、そのツリーを実行しきってコール先まで戻る。（つまりコールオーバー／コールイン／コールリターン？）

    いずれにしてもメッセージコンテント表示中はCWの仕様上イベントは止まる（無限ウェイトが掛かる）ので、 メッセージ主体のツリーを組む作者はコンテントのアイコンを直感的にダブルクリックするだけでもよい

  2. crowstar

    チュートリアルに生かせるかどうかわかりませんが・・・
    ver1.20のみの機能としてゲーム途中でヘルプボタンを押すとゲームの場面に応じたヘルプのページを表示する機能があったんですよ。
    (冒険者の宿・シナリオ進行中・キャンプ中・戦闘中等々)
    ver1.28からヘルプの形式が変わったのでこの機能は使えなくなりましたが、
    初心者ならヘルプボタンを押せばこの場面で何が出来るのか大まかにでも表示されたらわかりやすいんじゃないかな、と思ってます。

  3. k4nagatsuki reporter

    WirthBuilderで開けない問題をpull request #1274で修正しました。WirthBuilderはフォルダを指定してもシナリオを開くことが出来ず、あらかじめSummary.wsmを補っておく必要があったのが抜けていたためで、たぶん最初から開けなかったと思います。

    1.は、それでOKです。

    3.は、一時停止はイベント開始前にも押しておける事を書いた方がいいかもしれませんね。そうするとイベント開始と同時に停止します。私はそちらの方法をよく使います。

    ステップオーバー・ステップイン・ステップリターンはそれで正しい説明です。このオーバー・イン・リターンは、サブルーチン(スタートやパッケージ)にかかっている言葉です。つまり、コールされたイベントをオーバーする(コール先の処理を読み飛ばす)か、インする(コール先の処理まで入って見る)か、コール元までリターンするか、です。

    なんらかの形で画面部品の説明が出るのは、必要なのになかなか手のつかないものの一つです。CWだとボタンの一つ一つにもツールチップヒントがついていますが、そうしたものもつけた方がいいでしょう。しかしいかんせん技術的には簡単でも作業量が膨大なので、なかなか作業を開始できていません。

  4. 暗黒 騎士

    ありがとうございます。そんな感じで追記しておきました。

    イベントの実行のサブウィンドウのSS、Windows7のものの方が分かりやすいかと思って紹介ページに丁度いいのがあったので流用させていただきました。（問題あったらすいません削除させていただきます）

  5. k4nagatsuki reporter

    ありがとうございます。もちろん問題ありません。何気なくこのリポジトリwikiのトップでCC0を宣言してありますので。

  7. k4nagatsuki reporter

    仕様ですが、つまるところ仕様のバグですね。背景更新の方を変えてしまいましょう。

    REDISPLAYのうち、RとEとDは使われているのでCtrl+I辺りですかね……。

  11. k4nagatsuki reporter

    pull request #2192

    表示機能をつけました。

    残る作業としては:

    • 場面ごとに開くセクションを変更する
    • ヘルプファイルの軽量化。イメージのJPEG化などが必要？
  13. Log in to comment
Assignee
–
Type
task
Priority
major
Status
resolved
Milestone
–
Votes
0
Watchers
2
Jira: the preferred issue tracker for Bitbucket. Join the team!