lib/help/jpref.txt

   1 === ユーザー設定ファイル ===
   2
   3 変愚蛮怒ではゲームの様々な点を自分好みに変更することが出来ます。設定ファ
   4 イルを書き変える事で、キー配置を変更すること(押されたキーに対応する内
   5 部的キー配置の割り当てを変更します)、マクロを作成すること(一つのキーに
   6 一連の複数のキーを押す手順を記憶させます)、画面表示を変更すること(モン
   7 スターやアイテムや地形をあらわす文字や色を変更します)、カラーを変更す
   8 ること(一定のカラーを明るくしたり暗くしたり全く別の色に変えたりします)、
   9 オプションを設定すること(その機能をオン・オフします)、及びアイテムの自
  10 動拾いと自動破壊を設定する事ができます。
  11
  12 変愚蛮怒ではユーザーの変更した様々な情報を「ユーザー設定ファイル(user
  13 pref file)」と呼ばれるファイルに保存します。そのファイルはコメントと、
  14 簡単な設定変更のコマンドで構成されています。ユーザー設定ファイルを読み
  15 込む方法は色々とありますし、自動的に読み込まれるものもあります。
  16
  17 変愚蛮怒にもともと用意された設定ファイルは「lib/pref/」ディレクトリに
  18 入っています。ユーザーの設定を保存したりユーザー自身が書く設定ファイル
  19 は、「ユーザーディレクトリ」に保管されます。これは標準の設定でコンパイ
  20 ルされた場合ならば、 Unix の場合は ~/.angband/Hengband/ その他の機種の
  21 場合は、lib/user/ の下になります。また設定変更コマンド (") を使って、
  22 普通はファイルに書いている設定変更のコマンドをゲーム上で直接打ち込むこ
  23 ともできます。ゲームの画面に影響する設定を変更したならば、画面描き直し
  24 コマンド(^R) が必要になるかもしれません。
  25
  26 ゲームをスタートして、以前のキャラクタのセーブ・データを読み込むか新し
  27 いキャラクタを作るかした後に、自動的に設定ファイルがいくつか読み込まれ
  28 ます。まず始めに "pref.prf" ファイルが読み込まれます。このファイルには
  29 全てのシステムで機能するいくつかのユーザー設定コマンドが記入されていま
  30 す。次に文字表示の場合は "font-xxx.prf" が、グラフィック表示の場合は
  31 "graf-xxx.prf" が読み込まれます。このファイルには、モンスター、アイテ
  32 ム、地形の表示方法や色を、それぞれのシステムに適合させるような変更が記
  33 載されています。次に "pref-xxx.prf"ファイルが読み込まれます。このファ
  34 イルには、それぞれのシステムで必要なマクロや色などの設定が記載されてい
  35 ます。次に "user-xxx.prf" ファイルが読み込まれます。このファイルには通
  36 常ユーザーが設定したことが記載しますが、全てのユーザーに共通です。
  37 "user-xxx.prf"ファイルは多くの場面においてデフォルトのユーザー設定ファ
  38 イルとして使われています。
  39
  40 今までに出てきた "xxx" の部分にはシステムに応じた文字が入ります。具体
  41 的には実行ファイルを作成するのに使われた "main-xxx.c" の "xxx" の部分
  42 の文字が入ります。その後で "<種族名>.prf" "<職業名>.prf" "<キャラクター
  43 名>.prf" ファイルが読み込まれます。ただし<種族名>にはプレイヤーの種族
  44 名、<職業名>にはプレイヤーの職業名、<キャラクター名>には現在プレイして
  45 いるキャラクタの名前が入ります。あなたがが自分の設定を書き込むのは、主
  46 に"<キャラクター名>.prf"になるでしょう。
  47
  48 最後に自動拾い/破壊設定の専用ファイル "picktype.prf" と "picktype-<キャ
  49 ラクター名>.prf"を読み込みます。このファイルの中ではマクロ等の設定を書
  50 き込める事に加えて、自動拾いのアイテム名の登録ができます。このファイル
  51 はあなた自身がエディターを使って書かなければなりません。
  52
  53 設定を変更したい場合には、設定変更コマンドをユーザー設定ファイルにエディ
  54 ターなどを使って直接記述するのも良いのですが、ゲーム中で「マクロの設定」
  55 (@)、「画面表示の設定」(%)、「カラーの設定」(&)を使えばより感覚的に設
  56 定を変更することが出来ます。またこれらコマンド中では、現存するユーザー
  57 設定ファイルを読み込んだり、新しいユーザー設定ファイルを作成したり、現
  58 存するユーザー設定ファイルに情報を上書きしたりもできます。
  59
  60 変愚蛮怒では現存するユーザー設定ファイルに情報を上書きするときに古い設
  61 定行は削除してくれます。つまり追加書き込みを繰り返してファイルがどんど
  62 ん巨大に膨れ上る心配はありません。ぞんぶんに書き込みましょう。
  63
  64
  65 ***** <Commands>
  66 === ユーザー設定ファイルのコマンド ===
  67
  68 オプションの設定 (=)
  69      オプション設定画面を表示して、そこで変愚蛮怒の動作を変更すること
  70      ができます。「詐欺オプション」の扱いには注意して下さい。一度でも
  71      このオプションを有効にすると、そのことがセーブファイルに記録され
  72      てしまって、ハイスコアリストに載ることが不可能になってしまいま
  73      す。通常のオプションはユーザー設定ファイルの中で "X"と"Y"コマンド
  74      で設定することもできます。また、オプションによっては画面描き直し
  75      コマンド (^R) を入力しないと有効にならないものもあります。
  76
  77 マクロの設定 (@)
  78      マクロの設定をすることができます。ユーザー設定ファイルからマクロ
  79      を読み込んだり、ユーザー設定ファイルにマクロをセーブしたり、様々
  80      な種類のマクロを定義したり、キー配置を変更したりできます。
  81
  82 画面表示の設定 (%)
  83      画面表示に関する設定をすることができます。画面表示の設定をユー
  84      ザー設定ファイルから読み込んだり、ユーザー設定ファイルにセーブし
  85      たり、モンスターやアイテムや地形の色や文字を変更したりすることが
  86      できます。
  87
  88 カラーの設定 (&)
  89      カラーの設定をすることができます。このコマンドはシステムによって
  90      は機能しません。設定を変更したら、画面描き直しコマンド (^R) を使っ
  91      て画面を描き直して下さい。
  92
  93 自動拾い/破壊設定ファイルの読み込み ($)
  94      このコマンドを実行すると、"picktype.prf" と "picktype-<キャラクター
  95      名>.prf"を読み込みます。ゲーム中にこれらのファイルをエディタで書
  96      き変えたときに便利でしょう。
  97
  98 自動拾い/破壊ファイルの編集 (_)
  99      このコマンドを実行すると picktype.prf を編集するエディタに入りま
 100      す。エディタの中では全てのコマンドはメニュー(ESCで開く)から実行で
 101      きます。エディタを終了するには ^Q または、^W を押します。
 102
 103
 104 ***** <Macros>
 105 === ユーザー設定ファイル(マクロ) ===
 106
 107 「マクロの設定」コマンドではマクロを設定したり無効にしたりできます。マ
 108 クロとは、ファンクションキーや未使用のキー入力などに、一連のキー操作を
 109 定義することを言います。マクロは、いちいち何度も同じ様な一連のキー入力
 110 をする煩雑さを解消するためにあるのです。
 111
 112 マクロはどのような時にも適用されます(マクロ設定コマンドでトリガーキー
 113 を選んでいる最中だけが例外です)。したがって、例えばエスケープキーや'y'
 114 キーをマクロのトリガーとして使ってしまうと、後で元のエスケープキー等を
 115 入力できなくなり、非常に困った事になるでしょう。
 116
 117 マクロは連続したいくつかのキー入力に対応させられますが、特殊なキー(リ
 118 ターンキーや CTRLキー)を使用するときには特別な書式で書かれなければなり
 119 ません。"^X" と書けばCTRL-X と解釈され(他の CTRL キーも同じです)、
 120 "\NNN" と書けば十進数の NNN と解釈され、"\xHH"と書けば16進数の HH と解
 121 釈されます。また、"\e" は ESC、"\n" は次の行(ラインフィード)、"\r" は
 122 リターンキー、"\s" はスペースキー、"\\" はバックスラッシュ、"\^" は
 123 "^" という文字を表します。
 124
 125 マクロのトリガーキーとして特殊なキーを使うときも同様に特別な書式で表現
 126 されます。CTRL-X なら ^X 、F1キーなら \[F1]、コントロールキー + F2キー
 127 なら \[control-F2]等と書かれます。実際にどう書かれるかはマクロを設定す
 128 るコマンド '@'の中で表示されるので、いろいろと試してみてください。
 129
 130 マクロ行動の解釈中においては、他のマクロのトリガーをチェックしていませ
 131 んので、マクロ行動の作成において無限ループを作ってしまうことを心配する
 132 必要はありません。また、マクロはどんなに長くても結構ですが、システムの
 133 内部的な入力機能によって制限されます。通常は 1024 文字くらいが限度でしょ
 134 う。
 135
 136 "\" コマンド(マクロ行動に記述するときには "\\" と入力します)はマクロに
 137 おいて大変便利なコマンドです。どのマクロやキー配置においても、"\" コマ
 138 ンドに続くキーはアングバンドの「内部的キー配置」のキーと解釈されます。
 139 「内部的キー配置」のリストは "jcommand.txt" を見て下さい。例えば、マク
 140 ロ行動に "\\.6"と記述し、トリガーキーを"SHIFT-(テンキー)6" にしたとしま
 141 す。つまり SHIFT-(テンキー)6 に "\" + "." + "6" が定義されたとすると、
 142 どのキー配置を使用しているときでも、「東に走る」と解釈されます。キー配
 143 置や定義に依存しないという点でマクロはなるべく "\" コマンドを使って内部
 144 的キー配置で記述したほうがよいでしょう。
 145
 146 内部的キー配置を使う際の注意を述べます。"\\" は1つのコマンドに対し1回だ
 147 け有効です。例えば、ローグ風キー配置でマクロ "\\u0u0" を実行すると、最
 148 初の "\\u0" は内部的キー配置の動作となり銘{@u0}に対応する杖を使います
 149 が、次の "u0" は内部的キー配置ではなくローグ風キー配置で入力したと見な
 150 され、おそらく意図していない動作になります。このマクロをローグ風キー配
 151 置でも内部的キー配置として正しく動作させるには "\\u0\\u0" と記述するべ
 152 きです。また、"\e" を記述した後にコマンドを記述する場合にも "\\" を記述
 153 するべきです。例として、ローグ風キー配置では "\\\eu0" は誤動作しますの
 154 で "\\\e\\u0" とするべきです。
 155
 156 マクロの定義はユーザー設定ファイル中では２行に渡って記述されています。
 157 １行目は "A:<文字列>" で、これはエンコードされたマクロ行動を表します。
 158 ２行目は "P:<文字列>" で、これはエンコードされたトリガーキーを表します。
 159
 160
 161 ***** <Keymaps>
 162 === ユーザー設定ファイル(キー配置) ===
 163
 164 「マクロの設定」コマンド中では「キー配置」を変更することもできます。
 165 「キー配置」とはそれぞれのコマンドを実行する文字として何かのキーを割り
 166 当てることです。マクロがあらゆる状況で適用されるのと違い、キー配置はコ
 167 マンドの入力をするときにのみ関係します。つまりあなたが 'n'キーに'f'コ
 168 マンドを定義してしまったとしても、アイテムの選択時や、文字列の入力時に
 169 は 'n'キーはそのまま'n'と解釈されます。
 170
 171 オリジナルキー配置とローグ風キー配置は、実は内部的なキー配置とは異なり、
 172 設定ファイルによって、内部的なキー配置に割り当てられているだけです。し
 173 たがって、ユーザーがこの割り当てに手を加えることもできます。プレイヤー
 174 が「キー配置」の変更を行う場合には、実行するべきコマンドはオリジナルキー
 175 配置やローグ風キー配置のコマンド文字ではなく、必ず内部的キー配置の文字
 176 で指定しなければなりません。
 177
 178 オリジナルキー配置は内部的キー配置に非常によく似たキー配置です。ただ追
 179 加的に、全ての数字が ";" + (方向) に、"5" が "," に、コントロールキー
 180 が様々なことに割り当てられています。内部的キー配置自体については
 181 "jcommand.txt" を参照して下さい。キー配置の変更には他に、特定のコマン
 182 ドに "\x00" を割り当てて、そのコマンドを使用不能にすることもできます。
 183
 184 キー配置はユーザー設定ファイル中ではマクロと同様に 2 行に渡って記述さ
 185 れています。1 行目は "A:<文字列>" で、これは内部的キー配置の文字で書か
 186 れたコマンドです。２行目は "C:<0か1の数字>:<文字列>" で、これはエンコー
 187 ドされたトリガーキー(実際にあなたが押すキー)を表します。ローグ風配置の
 188 ときは数字に1を、オリジナル配置のときは数字に0を指定します。
 189
 190
 191 ***** <Visuals>
 192 === ユーザー設定ファイル(画面表示) ===
 193
 194 「画面表示の設定」コマンドでは様々な画面表示を変更できますが、現在の
 195 所、様々なモンスターやアイテムや地形をあらわす文字と色を変更できます。
 196 "main-xxx.c" で対応していて、更に "use_graphics" フラグがセットされて
 197 いるのならば、様々なものを表示するのに通常の「色付きの文字」の代わりに
 198 「グラフィック・ビットマップ」を使用することが出来ます。
 199
 200 色や文字を変更するときの具体的なキー操作ですが、通常は大文字を押すと値
 201 を一つ減らし、小文字を押すと値を一つ増やします。"n" か "N" を押して変
 202 更しようとするキャラクターを選択して下さい。"a" か "A" を押すとそのキャ
 203 ラクターの色が変更され、"c" か "C" を押すとそのキャラクターをあらわす
 204 文字が変更されます。また、"^N"や"^A"や"^C"を押すと直接数値を入力して変
 205 更することができます。グラフィックが使用可能なら、文字や色を表す数字に
 206 128～255の数字を使うことでグラフィックを表示させることができます。
 207
 208 <<注意>>この機能を使うとゲーム中の全てのモンスターの名前を見ることがで
 209 きます。そのような情報を望まないのなら、この機能は使わないで下さい。
 210
 211 画面表示の設定はユーザー設定ファイル中では "R:<N>:<A>/<C>"
 212 "K:<N>:<A>/<C>" "F:<N>:<A>/<C>" という形式で記述されています。
 213
 214
 215 ***** <Colors>
 216 === ユーザー設定ファイル(カラー) ===
 217
 218 「カラーの設定」コマンドでは様々な画面表示のカラーの値を変更することが
 219 出来ます。このコマンドはシステムによっては機能しないこともあります。最
 220 もよくこの機能を発揮するシステムでは、アングバンドで使用される 16 色の
 221 カラーをそれぞれ RGB の値で変更することができ、現在使用されていない新
 222 しいカラーを設定することもできるでしょう。
 223
 224 カラーの設定はユーザー設定ファイル中では "V:<N>:<V>:<R>:<G>:<B>" とい
 225 う形式で記述されています。
 226
 227
 228 ***** <Options>
 229 === ユーザー設定ファイル(オプション) ===
 230
 231 「オプションの設定」コマンドではオプションの効果をオン・オフする事が出
 232 来ます。このオプションのオン・オフをユーザー設定ファイル中で行うことも
 233 できます。そのコマンドはそれぞれ "X:<option>" "Y:<option>" です。
 234
 235 この方法はあなたがマクロ中で使いたいと思う事もあるでしょう。例えば、魔
 236 法書 b の３番目の魔法を使う操作をF1キーにマクロ登録して、何度も何度も
 237 休憩しながら使いたいとき、単純に 'R\r'を挿入するだけでは、次の魔法を使
 238 うコマンド文字を押したときに休憩を中断してしまうので、「ユーザー設定を
 239 1行実行する」コマンド(")を使って、次のように書くのが便利です。
 240
 241 A:"X:avoid_abort\rR\rmbc"Y:avoid_abort\r
 242 P:\[F1]
 243
 244 avoid_abort オプションについては、効率化オプション [b] を参照してくだ
 245 さい。
 246 ***** [b] joption.txt#Efficiency
 247
 248 --
 249 Original   : Alexander Cutler and Andy Astrand
 250 Updated    : (2.7.6) by Russ Allbery (rra@cs.stanford.edu)
 251 Updated    : (2.7.9) by Ben Harrison (benh@phial.com)
 252 Updated    : Zangband 2.2.0 through 2.2.6c by Robert Ruehlmann
 253 Updated    : Zangband DevTeam
 254 Updated    : Hengband 1.7.0