テキストアドベンチャーのコマンドヘルプで、例文のアイテムを場面内の物と誤解させない方法

「鍵を取る」を現在の場面の手がかりと受け取らせないためには、ヘルプで三つの点を説明する必要がある。その文がどの状況で成り立つのか、鍵はどのような設定に基づいて登場するのか、現在の場面で使えるのか、という点だ。汎用的な入力形式と、その場で使うコマンドは分けて示す。コピーできる例文には、貼り付けて使う場所と、使用前に満たすべき条件も添える。

以下では、架空の教材を使ってヘルプ全体を書き直す。プレイヤーがいるのは、椅子が一脚あるだけの、ほぼ何もない部屋だ。鍵は独立した練習用の状況にしか登場しない。場面、文案、処理の流れはいずれも、この解説のために独自に作成したものであり、実際のユーザー事例、実測結果、DramaForkの製品機能ではない。

元の文案は、「動作とアイテム名を入力してください。例：鍵を取る。」という二文だけだ。文の組み立て方を教えたいのだが、プレイヤーが読んだばかりの部屋の説明の隣に、具体的な物を登場させている。そのため、プレイヤーは鍵を探し始めたり、見つからないのは探索が足りないからだと考えたりするかもしれない。

書き直す前に、まず場面の前提を「部屋には椅子が一脚だけある」と固定する。さらに、この例の作者側のルールとして、椅子を調べることはできるが、動かせるかどうかはまだ設定していない、と定める。したがって、その場で使う例は「椅子を調べる」とし、「椅子を取る」にはしない。物がすでに登場していることは、その出所の根拠にはなるが、あらゆる動作が許される根拠にはならない。

このページの学習目標は二つある。「動作＋対象」という二つの要素からなる基本的な表現を理解してもらうことと、現在の場面に根拠のある最初の行動を示すことだ。隠しアイテムをほのめかしたり、すべての動作ルールを説明したりする役割は持たせない。先に目的を絞ることで、残すべき例文を判断できる。

例文を並べてから注意書きを付け足すのではなく、まず以下の作者用シートを埋める。各行で同じ五つの問いに答え、その内容をプレイヤー向けのヘルプに反映する。

二行目は、意図的に読むだけの練習例にしている。具体的でわかりやすい例文を残しつつ、練習への入口、練習専用の所持品、リセットの挙動まで約束せずに済むからだ。その代わり、プレイヤーはヘルプ内で操作を試せず、文章を読んで理解することになる。

作品に実際に操作できる独立した練習エリアがあるなら、この行を書き直し、どこから入るか、何に影響するか、どう退出するかを説明したうえで、実装と照合する必要がある。見出しを「練習モード」に変えただけで、その行動が本編から切り離されていると見なしてはいけない。

このシートは、人物、場所、資源を使った例にも再利用できる。名詞が出てくるたびに、現在の場面に属するものか、練習上の仮定か、入力形式を示すための仮の表現かを答えられるようにする。答えられない例文はいったん外す。

以下の引用は、この例におけるプレイヤー向け文案の全文だ。自分の作品にコピーする際は、場面の説明を差し替え、書かれている動作が実際にサポートされていることを確認する。

行動の入力方法

基本は「動作＋対象」の二つの要素を伝える形式です。「動作」と「対象」は形式の説明なので、この二つの言葉をそのまま入力する必要はありません。現在の場面にすでに登場している対象を選び、それに何をしたいかを入力してください。

独立した練習例：文の組み立て方だけを説明します

練習用の机の上に鍵が一本あると仮定します。「鍵を取る」と書けば、動作とその対象を表せます。この机と鍵は説明用の設定であり、探索中の部屋には属しません。この節には練習用の入力欄はありません。この文を、現在の場面で推奨されるコマンドとして使わないでください。

現在の部屋：試せるコマンド

部屋には椅子が一脚だけあります。この場面のルールでは、今は「椅子を調べる」と入力できます。このコマンドが指すのは、すでに場面に登場している椅子です。ヘルプページ自体が、あなたに代わって椅子を調べることはありません。

場面に戻る

ヘルプを閉じ、部屋の説明に戻って行動を続けてください。このページを読んだだけでは、物を取ったことにも、調べ終えたことにもなりません。練習例の鍵が部屋や所持品に追加されることもありません。次の入力は、その場の説明に基づいて行ってください。

ここでは、「試してみましょう」という言葉を練習例と実際の場面の両方に使っていない。また、二つの例文を一つの「おすすめの行動」という見出しの下に並べてもいない。小見出しだけを流し読みしても、二つの状況の違いがわかる。

場面に戻る際の説明から、新たな推測を誘わないことも大切だ。「練習用の鍵はここには属しません」が示すのは、あくまで現在の範囲の区切りである。物語全体に鍵が一切存在しないという意味ではないし、「あとで見つかります」と付け足して、予定していない展開を予告してもいけない。

ヘルプにコピー操作を用意するなら、コピーされるものが完成したコマンドなのか、書き換えが必要な形式なのか、どの入力欄に貼り付けるのかを、そのそばで説明する。この例の現在の場面で使うコマンドなら、「『椅子を調べる』をコピーし、現在の部屋の行動入力欄に貼り付けてください。送信して初めて行動が実行されます」と書ける。ただし、この説明が使えるのは、作品に対応する操作が実際にある場合だけだ。

練習例と現在の場面で使うコマンドに、説明のない共通の「今すぐ試す」入口を設けるのは避けたい。学習のために練習例もコピー可能にするなら、例文のすぐそばに「文の組み立て方を学ぶための例です。現在の部屋では使えません」と明記する。重要な前提をページ末尾に隠し、コピーしてから制約に気づく構成にはしない。

ヘルプを開いている間に場面が変化する可能性も考える。たとえば、その後の展開で椅子が部屋から移されてしまえば、古い例文は実行の前提を失う。現在の状態を確認できるなら、根拠のあるコマンドを選び直す。確認できないなら、欄の名前を「その場で使うコマンドの書き方」に変え、戻った際に対象がまだあるか確認するよう促す。その時点で実行できるとは断言しない。

具体的な例文は理解しやすい一方、事実として受け取られやすい。抽象的な形式は区切りが明確だが、初心者には何を書けばよいかわからない場合がある。この文案では両方を残し、独立した状況を介してつなげている。そして現在の場面の節には、「今、何から始められるか」を示す役割を持たせている。

一つ目は、練習の節だけを読んで、「これを根拠に、部屋に鍵があると断定できるか」と問うことだ。答えは「できない」であるべきだ。最後まで読まないとその解釈を排除できないなら、状況の説明を例文の前へ移す。

二つ目は、「鍵を取る」を、プレイヤーが現在の場面で自ら送信した入力として扱うことだ。作者は、場面のルールに合う応答をあらかじめ用意しておく。たとえば、「現在の部屋には取れる鍵がありません。ヘルプ内の鍵は、文の組み立て方の説明にだけ使っています」といった応答だ。これは実装担当者に、文字列だけで例文かどうかを判定させるという意味ではない。誤ってコピーした際に、物が突然追加されたり、行動コストを差し引かれたり、アイテムを入手したと告げられたりしないかを確認するためのものだ。

三つ目は、ヘルプを読み、そのまま閉じることだ。部屋と所持品が元の状態を保っているかを確かめてから、「椅子を調べる」と入力し、実際に送信した行動だけが処理されることを確認する。以上はこれから実施する確認手順であり、実施済みのテスト記録ではない。

この一式は、物語の外に置く入力形式のヘルプやコマンド説明に向いている。プレイヤーが自ら物を作り出せる作品なら、その創造のルールを別途説明する必要がある。練習自体が物語上の課題なら、どのような実際の影響が残るのかを明記する。引き渡し時には、五項目の整理シート、プレイヤー向け文案、誤読の確認記録を残しておく。場面内の物が変わった際に、一緒に更新すべき例文を見つけられるようにするためだ。