＊このページはElona本家wikiの情報をコピーしたものです（今後編集予定）＊

カスタムNPC †

カスタムNPCは、プレイヤーが自由に作成できるNPCです。
作成の手順は以下の通り。

1.NPC情報を記入したtxtファイルと、キャラ画像のbmpファイルを用意する。
2.ゲーム内でF8を押し、「カスタムNPCの作成」を選択する。
3.ファイル選択ダイアログが開くので、用意したtxtファイルとbmpファイルを選択する。

サンプルを作ってみる †

txtファイルにuserフォルダのnpc_template.txtを、bmpファイルにelona/graphicフォルダ
の適当なファイルを選択すれば作成できます。

使用する・配布する †

カスタムNPCを作成すると、○○.npcというファイルがuserフォルダに作成され、PCの近くに出現します。
作成直後は敵対設定されていなくても興奮して襲いかかってくるので、戦いを避けたい場合は一旦マップから出て入り直してください。
userフォルダの中の*.npcファイルは、自動的に読み込まれ、ゲームにNPCが登場します。
(討伐依頼や、死体や剥製などのアイテムに付くNPC名は、常に"user"となります)
また、カスタムNPCと★召喚石を配置したマップをショウルームにすることで、ショウルームを訪れたプレイヤーも、マップ内のカスタムNPCを自分のゲームに登場させることができます。
ただし、1つのショウルームに配置可能なカスタムNPCは10種までです。それを超えた分は「残りカス」となります。

bmpファイルについて †

x48,y48 もしくはx48,y96 の画像ならばなんでもokです。透過色は黒(RGB0:0:0)です。
なお、サイズが違う場合でも読み込めるようですが、大きすぎる場合は左上のx48,y96分が画像として、
足りない場合は下と右側の部分に白部分を足して所定のサイズにしたものが表示されます。

削除したいときは †

街で生成してしまったNPCなどを削除したいときは、まずNPCファイルを削除してからelonaを起動し、
ゲーム内に存在するNPCを死亡させればもう出てこないはずです。
ただし、NPCファイルを削除した後に残る『残りカス』は、削除前のNPCと同等の能力を持っています。
自力で倒せる程度の能力に抑える、野外などのランダムマップで生成するようにする、
セーブデータのバックアップをとってから実行する、など、きちんとした準備をして生成すべきでしょう。

更新したいときは †

メッセージとダイアログおよびキャラチップ(bmp画像)は表示の都度npcファイルを参照するため、初生成時と同じ手順で同名のnpcファイルを作成すれば更新が可能です。
行動パターンや耐性などのその他の要素はNPCファイルを書き換えても、すでに生成されたカスタムNPCに更新を反映することは出来ません。
ショウルームにするマップに更新前のNPCがいる場合は、一旦そのNPCを死亡させるなどしてから、そのマップ上で再度NPCを作成してください。

カスタムNPCの仕様 †

• カスタムNPCは、すべてuserという名前で扱われる。(処理上でも名前上でも)
• 変異種討伐依頼でuserが選ばれた場合、複数種のカスタムNPCが出てくることがある。(詳しい仕様については該当記事を参照)
• モンスターボールでuserを捕獲した場合、捕獲したものと違うカスタムNPCが出てくることがある。
• userの死体や卵の重さは種族によって決まるが、食事効果は付与されない。
• ラファエロに売り飛ばす際は人外扱い。
• 種族に神の化身(servant)を選択すると、神からペットを貰う際の２体制限に引っかかる。

各項目の説明と記入例 †

userフォルダにあるnpc_template.txtを参考にして下さい。

作者名 †

author.		"だれか"~

カスタムNPCの作者の名前を記入してください。

キャラ名 †

name.		"younger brother,おとおと"~

左側に英語の名前を、右側に日本語の名前を記入してください。長さは各31バイトまでです。
英語の名前はそのままファイル名としても使われます。ファイル名に使えない文字は避けてください(1.16reloaded fix1でアンダースコアに置き換えられるよう修正済み)。
なお、英語名の先頭文字はアルファベットのみに制限されています。そのため、名前の書式を既存のユニークNPCと統一することは出来ません。

• ×"<Foobar> the hogehoge,ほげほげの『フーバー』"
• ○"Foobar the hogehoge,ほげほげの『フーバー』"
   
  なお、ファイル名(＝英語の名前)が同じになってしまうと、生成した際に既存の同名npcファイルが上書きされます。
  また、ショウルームで同じになってしまった場合はuserフォルダのファイルが優先して読み込まれます。
  

種族 †

race.		"norland"~

種族を記入してください。キャラクタの基本性能に影響するほか、一部の種族は死亡表現または行動時のメッセージが変化します。
一覧のどれにも該当しない場合、異常なキャラクタ(種族名「0」、全主能力0、装備部位無し)が作成されるので注意してください。

各種族のページに記載されている種族特性はNPCにも適用されます。
但し属性耐性については、プレイヤーキャラの場合とは強度が異なる場合があります。

種族一覧 †

• ※バイク: Ver.1.16xmas以降で有効。

職業 †

class.		"gunner"~

職業を記入してください。一覧のどれにも該当しない場合は無職になります。
初期装備品の組み合わせにも影響します。

職業一覧 †

0:皆無 1:微々 2:少し 3:普通 4:やや高い 5:高い

属性 †

filter.		"/man/"~

NPCの属性です。ゲーム内部で、特定の条件に合致するキャラクターを選別するためのタグとして使用されます。
関係のありそうなものを属性一覧から選んでください。例えば「火竜」なら"/fire/dragon/"です。
属性の両端はスラッシュで囲んでください。
但し、属性の効果によっては、関係ありそうな物でも設定しない方がいい場合もあります。

属性一覧 †

属性の効果は推測なので正しくないかもしれません。cnpc属性は付けておいた方が安定するようです。

レベル †

level.		"16"~

NPCの初期経験レベルです。最大100まで有効ですが、生成品質による割り増しでこれを超えることがあります(最大166まで可能)。
経験レベルが高いキャラは、魔法と弱点以外の属性耐性にボーナスが加えられる(Lv51まで、最大4ランクの上昇)ほか、初期装備品に重層鎧や防弾服、法王衣などの高級品が選ばれる可能性があります。
1に設定した場合、キャラクタ毎や種族毎の属性耐性は付与されません。

関係 †

relation.	"0"~

初期敵対関係です。中立以上の場合、範囲回復や魔力制御の対象になります。
また、無関心または友好の場合、PCはそのキャラクターを押しのけて移動できます。

性別 †

sex.		"-1"~

NPCの性別です。
ランダムを指定した場合は、種族ごとの男性率で性別が決定します(53%前後)。
但しローラン、妹猫、神、猫の神の4種族だけは男性率が0%のため、明示的に指定しない限り男性になることはありません。

生成品質 †

fixLv.		"4"~

NPCの生成品質レベルです。初期装備品の品質にも影響します。
品質が4以上の場合は変異種扱いとなり、HPが大幅に割り増しされ、支配や変化が無効化されます。4または5の場合は経験レベルも割り増しされます。

生成頻度 †

rare.		"100"~

NPCの生成頻度です。値が小さいほど出現しにくく、大きいほどよく出現します。
冒険者のようにNPCが他の街等に移動することはありません。
なお、生成頻度を0にしても出現する場合があります。(モンスター召喚で確認)
ダルフィの奴隷商人で販売される確率にも影響し、0だと数百回話しかけても出ないときがあります。

生成条件 †

spawnType.	"0"~

カスタムNPCの生成場所の条件です。どのようなマップで出現するかを指定します。(一部推測)
1.16reloaded fix1追加。現在0と5以外指定する意味はほぼありません。

待機時 †

aiCalm.		"1"~

非戦闘時のAIタイプです。

移動確率 †

aiMove.		"80"~

戦闘時、敵との距離が適正距離でない場合にNPCが移動する確率です。(0%-100%)

適正距離 †

aiDist.		"2"~

NPCが交戦する際の適正距離です。ペットとして随行する際はPCとの適正距離にもなります。
交戦時は双方の移動確率にもよりますが、適正距離の短い方が長い方を追いかけ回す戦い方になることが多いです。
2の場合、敵と1マス離れた距離を好みます。
あまり大きい値だと、近接攻撃やアイテムの受け渡しが困難になります。

瀕死時行動 †

aiHeal.		"0"~

NPCのHPが低い時に選択する行動です。1個だけ指定できます。
回復以外でも良いですが、MPを消費する行動だとマナの反動で死期を早めます。特に、変異種など高HPキャラは瀕死レベルから自然回復するのがかなり遅いので注意してください。

基本行動 †

aiAct.		"-1,-1,-2,651,0"~

NPCが敵に対して取る行動です。5個まで指定できます。5個に満たない場合、残りは「何もしない(0)」が指定されます。
例の場合、2/5の確率で近接攻撃(-1)を試み、1/5で確率で遠隔攻撃(-2)、
1/5の確率で食料を奪い取ろうとします(651)。

行動選択は以下の順序で行われます。

1. 移動判定 適正距離でない場合、aiMoveの確率で移動を選択。
   
2. 基本行動or特殊行動の判定 移動が選択されなかった場合、aiActSubFreqに従って基本行動か特殊行動かを選択。
   
3. 行動選択 設定された５種類の行動からひとつを選択し、実行可能なら実行。
   
4. 臨時行動選択 選択した行動が実行不可能であった場合、以下の優先順位で臨時の行動を選択。
   
   1. 近接攻撃が可能なら近接攻撃。
   2. 遠隔攻撃が可能なら遠隔攻撃。
   3. aiMoveの２分の１の確率で移動。このときの移動方向は敵対キャラに接近する方向で、適正距離には依存しない。
   4. どの行動も選択されなかった場合、そのままターンを終える。

なお、「何もしない(0)」は実際には『必ず実行不可能と判定される行動』で、
多くの場合は臨時行動選択で近接攻撃・遠隔攻撃・移動のいずれかが選択されます。

行動一覧 †

一部の行動は、NPC(特に敵として)が使用することを想定していないため、意図した効果が出ないことがあります。

• ※持続する効果：ターゲットが同じ影響を受けていても選択される
• ※何もしない：必ず実行不可能と判定され臨時行動選択を行う。詳細は基本行動の項に記述
• ※近接攻撃：ターゲットとの距離が１でない場合、実行不可能と判定される。適正距離が２以上の場合は右往左往して一向に攻撃しない可能性あり 相手が切り傷などのカウンター効果を持つ場合、可能であれば遠隔攻撃に振り替えられる場合がある
  
• ※接近待ち：ターゲットとの距離が１あれば近接攻撃。自分からは近づこうとしない
• ※癒しの手：白衣のナース問題。敵にしか使おうとしない。
• ※闇の霧：有益な補助魔法であるにも関わらず敵をターゲットにする。
• ※接近：他のテレポート系や同名の武器の発動と違い、騎乗した状態でも発動する。その結果移動不可マスとしてペットの残像が残るバグ有り。
• ※スウォーム：敵が使ってもPCやペットは攻撃の対象外となる。それ以外のNPCには使用者の味方であっても命中する。
• ※スリの指：後述の「必ずお金を落とす」ビットを立てておかないと、盗まれた金貨は戻ってこない。
• ※死の宣告：後述の「死の宣告持ち」ビットを立てておかないと、宣告者が死んだ後も死の宣告は継続する。
• ※鼓舞：敵が使うとPCを含む全キャラクタが鼓舞の対象になる。
• ※ポーション投擲(大)：生成されるポーションは混乱・沈黙・突然変異・失耐性・麻痺・火炎瓶
• ※ポーション投擲(中)：生成されるポーションは混乱・鈍足・沈黙・変異治療・脆弱・火炎瓶・火炎瓶
• ※ポーション投擲(小)：生成されるポーションは盲目・混乱・鈍足・睡眠薬・毒薬・ビア・英雄気分・硫酸
• ※支配、願い、魔術師の収穫、うみみゃぁ！：著しくゲームバランスを崩すため、カスタムNPCは実行しないよう設定されている

特殊行動確率 †

aiActSubFreq.	"20"~

NPCが下記のサブ行動を取る確率です。(0%-100%)

特殊行動 †

aiActSub.	"610,610,0,0,0"~

NPCが敵に対して取るサブ行動です。5個まで指定できます。5個に満たない場合、残りは「何もしない(0)」が指定されます。
例の場合、20%の確率でサブ行動をとり、さらに2/5の確率で毒のブレス(610)をはきます。
ポーション投擲などの一部の行動はなぜか特殊行動に設定されていないと発動しません。

素手攻撃 †

meleeElem.	"61,200"~

NPCが素手で攻撃した際に付与される攻撃属性とその属性強度です。
例の場合、切り傷属性(61)でパワー200の攻撃を行います。（パワーの標準値は100、最大値は99999)
言うまでもありませんが、近接武器を装備している場合は意味がありません。プレデターや野生動物系など、近接武器を持たないor使えない職業・種族が最適です。
属性強度は上げるほど属性ごとの追加効果がより起こりやすく、より強力になっていきます。与えるダメージ量は主能力やスキルによって決まり、属性強度によっては変わりません。当然、追加効果を持たない魔法属性と無属性は、いくつに設定しても何も変わりません。
出血属性とエーテル属性を設定する場合、属性強度を上げすぎるとあらゆるキャラクターをほぼ一撃で倒してしまう（エーテル属性ではプレイヤーのみ）ので、ゲームバランスを壊さないよう慎重に設定するのがよいでしょう。

耐性 †

resist.		"50,3,51,-2"~

NPCの耐性を、属性ID、効果、属性ID、効果…の順に指定します。但しキャラクタの経験レベルが1の場合は、指定しても効果はありません。
効果値は、耐性のランクを2(耐性無し)からどれだけ増減させるかを指定します。
種族による指定値がある場合は、そちらによる値で上書きされるため、例えばリッチ系の弱点や免疫を消すことは出来ません。
例の場合、火炎耐性(50)が(3)ランク上がって5(強い耐性)になり、冷気耐性(51)が(-2)ランク上がって0(致命的な弱点)になります。~
耐性ランクが10以上の場合、その属性に対して完全な免疫を獲得します。6以上であればボーナス耐性次第で免疫を獲得できます。
逆に耐性ランクが1以下の場合、その属性にボーナス耐性は付与されません。
但し、魔法耐性は生成時点で耐性ランクが10以上でないと「耐性無し」に修正されます。そのため魔法属性を弱点にすることは出来ません。~
なお、仲間にしたキャラクタの耐性は、弱点と完全な免疫を除いて消滅します。
（例えば、妖精の種族耐性は完全ではないため、ボーナス耐性が最大となる経験レベル51以上で生成されないと免疫は獲得できない）

属性一覧 †

耐性として有効なのは50から60までです。0～49を選ぶと火炎属性になります。

補正 †

bitOn.		"5,23"~

指定した番号のbitをオンにします。
例の場合、NPCは浮遊(5)し、さらに分裂(23)します。

bit一覧 †

メッセージ †

NPCが様々な状況で発生するメッセージを記述します。
通常は水色で表示されますが、カギ括弧またはダブルクォーテーションを含む文字列はセリフ扱いとなり、黄色で表示されます(会話ダイアログを除く)。
発生頻度を下げたい場合は空行を挿入してください。空行は無言(会話ダイアログではデフォルトメッセージ)扱いとなります。サンプルでは会話以外の状況で1行ずつ挿入されています。

なお、これ以降の項目のみを記述したファイルは、既存NPCの口調変更に使用でき、使用中のファイルを書き換えるとリアルタイムで反映されます(Elona再起動やファイル再指定は不要)。

待機 †

%txtCalm,JP~
「わーい」~
「おにいちゃん！」~

~
%txtCalm,EN~
"Weee."~
"Brother!"~

待機時に発するメッセージです。

交戦 †

%txtAggro,JP~
「てめー」~

%txtAggro,EN~
"Scum!"~

敵に向かっていくときと、PCの攻撃(体当たりを含む)が命中したときに発するメッセージです。

死亡 †

%txtDead,JP~
「ちんだ」~

~
%txtDead,EN~
"I'm dead."~

死亡時に発するメッセージです。

勝利 †

%txtKilled,JP~
「ころしたよー」~
~

%txtKilled,EN~
"I killed it."~

敵を殺したときに発するメッセージです。

出迎え †

%txtWelcome,JP~
「おかえり」~
~

%txtWelcome,EN~
"Weclome back."~

帰宅時、またはわが家でゲームを再開したときのメッセージです。

会話 †

%txtDialog,JP~
なあに？~
（おとおとはあなたをじっとみている)~

%txtDialog,EN~
Hi.~
What's up?~
Dude...~

1.16reloaded fix1で追加されました。会話ダイアログのメッセージです。1行の長さは日本語モードで57byte*1、英語モードで53byteです。表示の際は禁則処理が適用されます。
(1.16reloaded fix2現在、英語モードではカスタムNPCの会話ダイアログはデフォルトの文章しか表示されません)
カスタムNPCの生成品質が6(ユニーク)の場合は、ペットになっているか、ショウルーム内に居る時のみ有効となります*2
ショウルームのテーマに依存する文章を記述したい場合、キャラクタの生成品質や属性で支配や購入が出来ないようにするといいでしょう。

会話ダイアログでは、以下の文字列置き換えが有効です。
但し、一部は依頼時の掲示文などの特定用途のため、"Unknown Code"に置き換えられます。