Elona_ADDTの拡張書式について

現在のページの対応バージョン：2013年2月3日版

Elona_ADDTで追加された拡張書式についてのページです。
基本的に書かれている内容は本体に付属しているReadmeを引用しています。

更新情報
注意：2013年2月3日版でグローバルキーの動作に関する不具合等が修正されています。

特徴

Elonaにあるカスタムテキスト機能の拡張に特化したヴァリアント。現在Elona1.22版とElona_omake(2012/8/20)版とElona_ore_hack(2012/7/7)に対応しているものが存在する。
両者に存在しているタグに条件を追加することにより、様々な状況に応じたセリフをしゃべるようにできる。追加された機能は以下の通り。

条件式による発言内容の状況に応じた指定

例：晴れの時

%txtDialog,JP
「ふあぁ…眠いなぁ」
「そろそろ新しい武器ほしいなっ」
$weather Sun
「日差しが気持ちいい～」
「今日もいい天気だね！」
$weather Rain
「雨嫌いー…」

この場合は
「ふあぁ…眠いなぁ」
「そろそろ新しい武器ほしいなっ」
「日差しが気持ちいい～」
「今日もいい天気だね！」

また、条件の複数指定も可能です
その場合は条件を,で区切ります

$when month 1,when date 1
「あけましておめでとー！今年もよろしくねっ！」

他ヴァリアントでの利用を保つ機能

なお、先頭文字は"$"だけでなく"%$"でも作動するようにしました
これにより%$を使った場合他ヴァリアント様と協同でテキストを使いたい場合に
条件式以下の行の部分が判断に入らないようになるはずです

条件式を使用したcNPCやショウルームをアップする場合に使ってください

not指定とand,or指定

not指定

各条件式の最初に!をつけることでnot指定になります
例えば、

$!where North_Tyris,when month 12 - 2

の場合だと、「位置がグローバルマップでなく、12月から2月のとき」となります

and,or指定

　( この項では,などの区切りを演算子と呼びます )
　演算子ごとに順序を分け、ほとんどの状況に対応できるようにしました

• 演算順序1 　 | 　 (or演算子)
• 演算順序2 　 , 　 (and演算子)
• 演算順序3 　 / 　 (or演算子)

　番号が若い順から演算を行います
　例えば、

$weather Rain|weather Hard_rain,where North_Tyris/where Lumiest|where Port_Kapul

　の場合だと、

　{ ( 雨か雷雨 ) で グローバルマップ } または ( ルミエスト か ポート・カプール ) の時

　という順番で処理されます

テキストの優先度の指定

---

　[rank X]
　他のテキストと比較した場合の優先度を指定します。Xが優先度で、Xの数が大きいほど優先度が高いです
　Xには0以上の整数を指定してください。それ以外は無効となり、0として扱われます
　また、これの前には区切り文字をつけず、絶対に条件文の最後に置くようにしてください

---

　この指定を行うと優先度が最も高いものだけが表示されます。

　例として以下の記述の場合、

%txtDialog,jp
「ふぁぁ… 眠いなぁ…」
$when month 7 - 8
「うーん… 夏だねー……」
$when year 513,when month 8,when date 12[rank 2]
「そういえば、この土地で私たちが再開してもう一年が経つんだね」
$when month 8,when date 12[rank 1]
「今日は私たちがここで再開した日なんだよ！ …覚えてる？」
「ノースティリスにきて、もう何年か経っちゃったのかぁ…」

　513年の8月12日には [rank 1] と [rank 2] の条件が同時に満たされますが、
　「そういえば、この土地で私たちが再開してもう一年が経つんだね」
　という [rank 2] のテキストのみが表示されるようになります。

　[rank 2] の条件を満たさない 513年以外の8月12日 でのみ [rank 1] は機能し、
　「今日は私たちがここで再開した日なんだよ！ …覚えてる？」
　「ノースティリスにきて、もう何年経ったのかなぁ…」
　というテキストが表示されるようになります。

　この際に [rank X] が未指定のテキストは表示されません。
　[rank X] が指定されてないテキストは自動的に [rank 0] として扱われます。

　つまり「ふぁぁ… 眠いなぁ…」と「うーん… 夏だねー……」のテキストは、
　[rank 1] が条件を満たす 8月12日 には絶対に表示されないということです。

コメントアウト

コメントアウトしたい行の最初に"//"をつけることでコメントアウトになります
コメントアウトした行は表示されませんので忘備録などにご活用ください

例：

$when month 8,when date 12
// 少女の誕生日の時

選択肢システム

イベントアクションは使えませんが選択肢をCNPCで品質が6でなくても使えるようにしました
選択肢の指定方法に関してはomake様の"台詞の編集方法.txt"の"CNPCの選択肢会話について"をご覧ください

テキストごとに表示されるポートレートの変更

ダイヤログで表示されるテキストの最後に@～～.bmpを追加することで
ポートレイトを自動で変化させられるようにします

ファイルはuser\graphicの中を参照します
サイズは X 80 , Y 112 でお願いします

例：
%txtDialog,JP
お、○○じゃねぇか。 何か用か？
ふぁあ、眠ぃな…@sleepy.bmp

この場合だと、「ふぁあ、眠ぃな…」の時ポートレイトを
user\graphicの中のsleepy.bmpに差し替えます

なお、@が複数あった場合は最後の@以降のみを使います

例：
Qy@と願えば世にも奇妙なモンスターが現れるというらしいですが…@face2.bmp

この場合はface2.bmpを使います

変数

変数が扱えるようになりました
扱えるデータは文字列のみですが、擬似的に整数も扱うことができます
変数を扱う命令は@以降に書いて、2つ以上の場合はコンマで区切ってください（ポートレイト変更も命令の一種として扱います）
命令の処理は2つ以上のとき左から順に行われます
命令リストは、条件リストの次に書いておきます

Elona_ADDTの変数を用いた記述(グローバルキー含む)に関する、より細かな解説はこちら。
Elona_ADDT変数記述解説

なお、ADDTでは変数のことをキーと呼びます
キーに使える名前は
・半角スペース、半角アットマーク、半角コンマ、半角セミコロンのいずれも含まない
・数字のみで構成されていない
の条件を満たしているものに限ります

例：

%txtDialog,JP
聖夜祭、その… {var_1}と一緒に行きたいのですが… ダメですか？
$strcomparison var_1 equal "-1"[rank 7]
//呼び名が決まっていないとき
あの… 私はあなたのことをなんと呼んだらいいでしょうか？{c}呼び捨てでいい%Yobisute{ev},,,,,{c}ご主人様だろjk%Gosyujinsama{ev},,,,,{c}お兄ちゃん！%Oniityan{ev},,,,,
%txtYobisute,JP
//呼び捨てにする（以降var_1にはプレーヤーの名前+さんが代入される）
わ、わかりました！ えっと… {player}……さん@concatenation var_1 PCName "さん"
%txtGosyujinsama,JP
//ご主人様（以降var_1はご主人様）
ご主人様ですねっ！わかりました！ごしゅじんさびゃっ！（どうやら舌を噛んでしまったようだ。痛みと羞恥で顔を真っ赤にしている）@substitution var_1 "ご主人様"
%txtOniityan,JP
//お兄ちゃん（以降var_1はお兄ちゃん）
えっ、お、お兄ちゃんですか！？ …わかりました！お、お兄ちゃん！@substitution var_1  "お兄ちゃん"

上の例だと、まず話しかけた際
「あの… 私はあなたのことをなんと呼んだらいいでしょうか？」
というテキストとともに
呼び捨てでいい、ご主人様だろjk、お兄ちゃん！という選択肢が現れます

それぞれ選んだ選択肢に応じたテキストが表示され、var_1というキーに代入され、それぞれ
「聖夜祭、その… {var_1}と一緒に行きたいのですが… ダメですか？」は発話される際次のように解釈されます

呼び捨て 「聖夜祭、その… (プレーヤー名)さんと一緒に行きたいのですが… ダメですか？」
ご主人様 「聖夜祭、その… ご主人様と一緒に行きたいのですが… ダメですか？」
お兄ちゃん 「聖夜祭、その… お兄ちゃんと一緒に行きたいのですが… ダメですか？」

また、これにより作られたキーは 上の例のような{～} , comparison , strcomparison で使用可能です

グローバルキーに対応しました。グローバルキーとはすべてのテキストから参照できるキーのことです
グローバルキーに書き込む際はキー命令の次にglobalの単語を入れてください
例：substitutionの場合
substitution global Key Str
このとき、グローバルキーKeyにStrが代入されます

参照する際はキー名の先頭にglobal:をつけてくだい
例：substitutionの場合
substitution Key1 global:Key2
このとき、ローカルキーKey1にグローバルキーKey2の内容が代入されます

なお、グローバルキーを使用したテキストを書いた際は被りを予防するため下のページに書き込みをお願いします
ADDT使用済みグローバルキー

• 利用例

  名前	対応ヴァリアント	作者名	ファイル	備考	改変	二次配布
  ADDT変数利用例：カブの少女	ADDT	ADDT作者様	TEXT	変数の作成・利用例	×	×

注意点

条件式及び追加されたテキストに関する機能に上手く働かない、エラー落ちなどのバグが存在する可能性があります。
ある程度どうしてエラーが起こったのかの推測が出来る場合、それが起こった状況、自分のElonaの環境などを添えて下記のスレに報告すると良いかもしれません。

開発状況

2012年12月30日現在開発進行中。開発進行の拠点は次のスレ。
http://jbbs.livedoor.jp/bbs/read.cgi/game/45610/1350133364/l50

ADDTの拡張書式

when系
　時間に関係する条件式。

where系
　現在地に関係する条件式。

weather系
　天気に関係する条件式。

impression系
　好感度に関する条件式。

condition系
　状態異常に関係する条件式。

karma系
　カルマに関係する条件式。

※カルマは先頭にPCがなくてもプレイヤーの値を参照するようです。

cash系
　所持金に関係する条件式。

fame系
　名声に関係する条件式。

religion系
　信仰に関係する条件式。

action系
　複数ターン使用する行動に関係する条件式。

sex系
　性別に関係する条件式。

race系
　種族に関係する条件式。

class系
　職業に関係する条件式。

comparison系
　要素の数値の比較に関係する条件式。

Con部分に入る条件

※なお、X3には有理数が入る。

X1・X2部分に入る数値

• 有理数
   
   
• キー
   
   
• Detail系

  条件名	備考
  Age	発言者の年齢
  Height	発言者の身長
  Weight	発言者の体重
  PCAge	プレイヤーの年齢
  PCHeight	プレイヤーの身長
  PCWeight	プレイヤーの体重

   
   
• Ability系
  主能力に関する値。
  オプションが存在する。設定する場合は以下の順に設定。
   
  1.プレイヤーの値を表示したい時は先頭に"PC"をつける(デフォルトでは発言者の値を参照)
  2.潜在の値を比較したい時は末尾に"P"をつける
  3.また、潜在をランクで比較したい時はさらに"R"をつける(２で"P"をつけていないと正しく判断できないので注意)
  4.武器による補正ありの値を表示したい時は末尾に"+"をつける(デフォルトでは武器による補正なしで判断します)
   

  Level：レベル	Hp：現在HP	MaxHp：最大HP
  Mp：現在MP	MaxMp：最大MP	Sp：現在SP
  MaxSp：最大Sp	Strength：筋力	Constitution：耐久
  Dexterity：器用	Perception：感覚	Learning：習得
  Willpower：意思	Magic：魔力	Charm：魅力
  Speed：速度	Luck：運勢	Mana：マナ
  Life：生命力	Sanity：狂気度	Fame：名声

   
  潜在を比較する際に次の値が使用可能（Rをつけてないと正しく判断できません）
  Superb
  great
  good
  bad
  hopeless

• Skill系
  スキルに関する値。
  オプションが存在。設定する場合は以下の順に設定。
   
  1.プレイヤーの値を表示したい時は先頭に"PC"をつける(デフォルトでは発言者の値を参照)
  2.潜在の値を比較したい時は末尾に"P"をつける
  3.また、潜在をランクで比較したい時はさらに"R"をつける(２で"P"をつけていないと正しく判断できないので注意)
  4.経験値も加えて計算したい場合は末尾に"E"をつける(デフォルトでは経験値なしで判断します)
  5.武器などによる補正ありの値で比較したい時は末尾に"+"をつける(デフォルトでは武器などによる補正なしで判断します)
   

  Tactics：戦術	Weight_Lifting：重量挙げ	Two_Hand：両手持ち
  Healing：治癒	Mining：採掘	Shield：盾
  Heavy_Armor：重装備	Medium_Armor：中装備	Light_Armor：軽装備
  Carpentry：大工	Lock_Picking：鍵開け	Dual_Wield：二刀流
  Evasion：回避	Disarm_Trap：罠解体	Tailoring：裁縫
  Jeweler：宝石細工	Pickpocket：窃盗	Stealth：隠密
  Detection：探知	Sense_Quality：自然鑑定	Fishing：釣り
  Eye_of_Mind：心眼	Greater_Evasion：見切り	Marksman：射撃
  Literacy：読書	Gene_engineer：遺伝子学	Anatomy：解剖学
  Memorization：暗記	Alchemy：錬金術	Gardening：栽培
  Cooking：料理	Magic_Capacity：魔力の限界	Faith：信仰
  Traveling：旅歩き	Riding：乗馬	Meditation：瞑想
  Casting：詠唱	Magic_Device：魔道具	Control_Magic：魔力制御
  Negotiation：交渉	Investing：投資	Performer：演奏
  Long_Sword：長剣	Axe：斧	Martial_Arts：格闘
  Scythe：鎌	Blunt：鈍器	Polearm：槍
  Stave：杖	Short_Sword：短剣	Bow：弓
  Crossbow：クロスボウ	Throwing：投擲	Firearm：銃器

• Resistance系
  耐性に関する値。オプションが存在する。
   
  1.プレイヤーの値を表示したい時は先頭に"PC"をつける(デフォルトでは発言者の値を参照)
  2.武器などによる補正ありの値で比較したい時は末尾に"+"をつける(デフォルトでは武器などによる補正なしで判断します)
   

  fire：火炎	cold：冷気	lightning：電撃
  darkness：暗黒	mind：幻惑	nether：地獄
  poison：毒	sound：音	chaos：混沌
  nerve：神経	magic：魔法	cut：出血

• Data系
  内部変数などを直接比較する、わかる人向けの機能。名称はMMAを参考としている。
   
  gdata(*)の値 gdata*
  cdata(*,発言者ID)の値 cdata*
  cdata(*,cc)の値 ccdata*
  cdata(*,tc)の値 tcdata*
  sdata(*,発言者ID)の値 sdata*
  sdata(*,cc)の値 csdata*
  sdata(*,tc)の値 tsdata*
   
   

その他
　そのほかの条件式。

ADDTの拡張書式-変数：命令関係

比較条件文

Strに指定できるもの

※次のブロックのものはPCNameのように先頭にPCとつけることでプレイヤーの値を参照する。
　(デフォルトでは発言者の値)

命令文

文章の後ろに@に続けて記述。「,」で複数の命令を用いることも出来る。

例文

作った中で使いやすいと感じた条件指定を自由に書き込んで言ってください。なおその時点の最新版で、指定した条件下において、正確な発言が確認できたもののみとしてください。
どのように条件が指定されるかについては拡張書式の比較対照表も参照。

例：○○weather系

• 天気に関係する条件式。

  $when Morning,weather Rain|weather Hard_rain,where Town
  // 主要な町における朝、雨か雷雨の時。（2012/12/10更新分にて確認）

  掲載位置については判断が難しいと思われますが、とりあえず気楽に、自分がここだと思った場所に追加してください。
  またADDTで採用されている「//」を文頭に入れてしまうとここでもコメントアウトしてしまいますので、「/」を一本抜いてください。また例文を解説ごと使う場合は追加することを忘れないでください。
   

when系
　時間に関係する条件式。

• エーテル発生月が近いことへの警告用条件式

  $when month 2, when date 20 - 30
  // 2月の20日～30日
  $when month 5, when date 20 - 30
  // 5月の20日～30日
  $when month 8, when date 20 - 30
  // 8月の20日～30日
  $when month 11, when date 20 - 30
  // 11月の20日～30日

where系
　現在地に関係する条件式。

weather系
　天気に関係する条件式。

impression系
　好感度に関する条件式。

condition系
　状態異常に関係する条件式。

karma系
　カルマに関係する条件式。

cash系
　所持金に関係する条件式。

fame系
　名声に関係する条件式。

religion系
　信仰に関係する条件式。

action系
　複数ターン使用する行動に関係する条件式。

sex系
　性別に関係する条件式。

race系
　種族に関係する条件式。

class系
　職業に関係する条件式。

comparison系
　要素の数値の比較に関係する条件式。

その他
　そのほかの条件式。