概要
最低限必要なファイル
descript.txtの書き方
surfaces.txtについて
サンプル画像
surfaces.txtの基本
領域作成（当たり判定）
アニメーション
サーフェスの合成
追加シェルとして配布する
よくあるエラーと原因
記述内容全文
外部サイトの紹介

ゴースト作りたくて絵を用意したけど、設定がよくわからない！という人向けのメモです。
ある程度、伺かを触って動かしている方を対象としています。
基本的なゴーストの知識は、ukadocの「全体の構成」に詳しい説明があります。

ここでは、「詳しい書き方よりも、ともかく最低限の動作をするシェルを作りたい」という方を対象としています。
さらに、SSPを使うことを想定しており、SSPでのみ実装されている機能を使用します。
SSP以外では動作しない可能性が高いです。
他のものでも動かしたいと考える場合は、このメモは参考になりません。

着せ替えなど、設定の手順が複雑なものは着せ替えやアニメーションの作り方に説明があります。

最低限のファイルは、以下の3つです。

• descript.txt
• surface0.png
• surface10.png

descript.txtがシェルの情報を記入するファイルで、シェルの名前や作者の名前などを記入します。
surface0.pngはメインキャラの基本ポーズ、surface10.pngはサブキャラの基本ポーズです。

これだけでも、サーフェス0番とサーフェス10番を表示出来るようになります。
ゴーストのトーク辞書でサーフェス0番を指定するとsurface0.pngが、サーフェス10番を指定するとsurface10.pngが表示されます。

また、0と10だけでなく、任意のsurface????.pngを使用出来ます。
「?」は半角数字なら何桁でも良いですが、頭の0は無視されます。
例えばsurface0000.pngとsurface0.pngは両方ともサーフェス0番に表示される画像となるので注意してください。
上記のような、サーフェス番号が重複するファイルが存在しないようにしてください。
なお、pngファイルのアルファチャンネル（透過情報）が適用されるので、pngファイルは半透明の画像なども使用できます。

ゴーストのデータの構成は以下のようになっており、今回触るのは[ゴーストフォルダ]/shell/masterフォルダです。

• [ゴーストフォルダ]
  • ghostフォルダ
    • masterフォルダ
      • descript.txt
      • shiori.dll
      • その他辞書ファイルなど
  • shellフォルダ
    • masterフォルダ
      • descript.txt
      • surface0.png
      • surface10.png
      • その他画像など
  • install.txt
  • readme.txt

詳細な項目の説明はukadocのShell設定に譲り、ここではサンプルを記載します。
----ここから---- charset,Shift_JIS craftman,sakusha_no_namae craftmanw,作者のなまえ craftmanurl,http://www.xxxxxxxxxxxxxxxx.co.jp/ id,master name,master type,shell seriko.use_self_alpha,1 ----ここまで----
メモ帳などを開き、上記をそのままコピーし、descriptと名前をつけて保存すれば使えます。

最下段のseriko.use_self_alpha,1という記述は、画像ファイルのアルファチャンネルを利用するという設定です。

保存したdescript.txtの下記の太字の部分を自分の名前および自分のサイトに変更してください。
空欄でも可ですが、craftmanwは最低限書いておいた方がよいでしょう。
----ここから---- craftman,sakusha_no_namae craftmanw,作者のなまえ craftmanurl,http://www.xxxxxxxxxxxxxxxx.co.jp/ ----ここまで----

上記のdescript.txtと、任意のsurface????.pngがあれば、シェルとしては動作すると説明しました。
しかし、これだけではただ絵が出るだけです。
まばたきなどのアニメーションはしませんし、頭など体の部位指定もされていません。
それを設定するのがsurfaces.txtです。
説明はukadocが詳しいため、ここではサンプルコードの表示と最低限の解説のみを行います。

今回、surfaces.txtに書くものを以下に示します。

• メインキャラの部位、「head」「hand」「shoulder」
• メインキャラのまばたきアニメーション

ここでheadはキャラクターの頭部を指定する部位、handは手、shoulderは肩の部位とします。

サンプルとして以下の絵を用意しました。
元の画像は、ボトル猫様が公開されているフリーシェル（伺かのシェル用のイラスト素材）です。

pngファイルの白い部分は、アルファ値を0%（完全な透明）に設定しています。
main_blink1.pngはまばたき用の半目、main_blink2.pngは目閉じです。
画像ファイルは、名称を好きなようにつけてかまいません。

上記まばたき用ファイルは、目閉じのみを用意したり、半目のパターンを増やしたりすることもできます。
ですが、ここでは最低限の構成として上記のようにしました。
また、メインキャラとサブキャラに、差分を1枚ずつ用意しました。

readme.txtには、好きな情報を記入しておきましょう。
大抵は、作者の名前、コンタクト先、シェルの名前などを書くことが多いです。
フリーシェルを使用した場合は、フリーシェルに同梱されていたreadme.txtをそのまま同梱することが多いです。

上記段落のサンプル画像を表示するためのsurfaces.txtが以下です。
ここで行っているのは「どのサーフェスにどの画像を表示するか」ということのみです。
----ここから---- charset,Shift_JIS descript { version,1 } surface0 { element0,base,surface0.png,0,0 } surface1 { element0,base,surface1.png,0,0 } surface10 { element0,base,surface10.png,0,0 } surface11 { element0,base,surface11.png,0,0 } ----ここまで----

最初のcharset,Shift_JISとdescript{ version,1 }は、必ずファイルの先頭に書いてください。
charset,Shift_JISは文字コードというものの指定です。windows環境なら、テキストファイルはデフォルトでShift_JISになっています。
descript{ version,1 }は、概要で述べた「新しい方の記述方式を使う」という意味です。

それぞれのサーフェスは、下の行のように記述します。
先頭の空白はあってもなくても変わりません。見やすいか否かだけです。
surface0 { ここにサーフェス0番の設定を記述 }

element0,base,????.png,0,0で始まる表記は、表示する画像の指定です。
1枚の画像を表示するだけの場合は、上記のように記述し、????.pngを使用する画像の名称に置き換えてください。
これで、サーフェス0、1、10、11が使用可能となりました。

ここでは、部位判定の領域を設定します。
まずは、キャラクターの頭部を設定してみることにします。
そのためには、どこからどこまでが頭なのかを指定する必要があります。

ここでは、2つの方法を説明します。
以下のどちらか片方を実装すると、シェルの領域を設定できます。

• Windows付属のペイント等を使い、座標を指定する方法
• 領域作成用の画像ファイルを別個用意する方法

今回、画像が2枚なので楽ですが、もしこれが10枚、20枚となったら設定や修正が大変です。
まとめて複数のサーフェスに一括設定する方法を以下に示します。
表情のみが違うサーフェスなどにまとめて設定することができます。
以下は座標指定で領域作成した場合の例です。
----ここから---- surface0 { element0,base,surface0.png,0,0 collision0,83,62,157,90,head collision1,97,263,127,316,hand } surface1 { element0,base,surface1.png,0,0 collision0,83,62,157,90,head collision1,97,263,127,316,hand } surface.append0-1 { collision0,83,62,157,90,head collision1,97,263,127,316,hand } ----ここまで----
surface.append????という表記は、surface????に内容を追加するという意味です。
この書き方をすると、既に記述済みのサーフェスに、追加で何かを設定できます。
上記のsurface.append0-1は「サーフェスの0番から1番の、全サーフェスに以下を追加せよ」という意味となります。
この記述の結果として、surface0にはheadとhandの領域が追加され、surface1にも同様に領域が追加されます。

上記の例では、surface0と1に、ベースになる画像のみを定義しています。
その後、領域をまとめて追加しています。
このように、共通部分だけをまとめて追加するという形にすると、後々、追加や修正が楽になります。

サーフェス0にまばたきをするアニメーションを記述します。
ここでは、サンプルにあるmain_blink1.png（半目）とmain_blink2.png（目閉じ）を使用します。
目を開いている→目閉じ→半目→目を開く、と素早く画像を切り替え、まばたきのように見えるアニメーションを作成します。
----ここから---- surface.append0 { animation0.interval,random,3 animation0.pattern0,overlay,1001,50,0,0 animation0.pattern1,overlay,1000,50,0,0 animation0.pattern2,overlay,-1,50,0,0 } surface1000 { element0,base,main_blink1.png,0,0 } surface1001 { element0,base,main_blink2.png,0,0 } ----ここまで----
surfaces.txt末尾に上記を追加してください。
この記述があると、以下のような動作をするようになります。

これ以下の解説は、改変するつもりがないのであれば、読む必要はありません。

先ほど、まばたきするアニメーションを作りました。
その画像の中に、目を閉じた上半身のみの画像がありました。
せっかく画像があるので、ずっと目をつむったままのサーフェスを作ろうと思います。
ただし上半身の部位しかないため、画像単体では表示できません。
そこで、複数枚の画像を合成してサーフェスとする記述を以下に記述します。
----ここから---- surface0 { element0,base,surface0.png,0,0 } surface1 { element0,base,surface1.png,0,0 } surface2 { element0,base,surface0.png,0,0 element1,overlay,main_blink2.png,0,0 } surface.append0-2 { collision0,83,62,157,90,head collision1,97,263,127,316,hand } ----ここまで----
surface.append0-2の部分は既存部分の書き換えです。
surface2が新しく追加した部分です。
目を開いた基本ポーズのsurface0.pngに、上から目を閉じたmain_blink2.pngを重ねています。
これで、サーフェス2に目を閉じた画像を追加することが出来ました。
surface.append0-2と記述を変更したことで、サーフェス2には頭と手の判定もついています。

element?～と記述することで、画像を重ねて1枚のサーフェスに出来ます。
「element0,base,????.png,0,0」という表記は、基本（base）とする下地の画像です。
「element1,overlay,????.png,0,0」は、基本の画像に被せる（overlay）画像を指定しています。
baseとoverlay以外の画像貼り付け方法は、ukadocにまとめられています。
後ろの「0,0」は貼り付ける位置（左上座標）です。
また、elementで指定する場合は、アニメーション時と違い、画像ファイルを直接指定できます。

ゴーストのマスターシェルではなく、追加シェルとして配布する場合は、install.txtが必要となります。
install.txtの書き方の例：
----ここから---- charset,Shift_JIS type,shell name,追加シェル（シェルの名前） directory,addshell（インストール時に作られるフォルダ名） accept,さくら（追加シェルを作るゴーストの\0側の名前） ----ここまで----
上記install.txtを、descript.txtと同じフォルダに置きます。
nameの項目は、descript.txtと合わせてください。
最低限の構成は以下のようになります。

• [任意の名前のフォルダ]
  • descript.txt
  • install.txt
  • readme.txt
  • surface0.png
  • surface10.png
  • surfaces.txt

「profile」というフォルダがある場合、フォルダごと削除してください。
上記をフォルダに格納しzip圧縮すれば、追加シェルとして扱われるファイルの完成です。
解凍時に、フォルダが入れ子にならないように注意してください。フォルダごと圧縮すれば大抵OKです。
拡張子を.narに変えると、伺か関連ファイルと認識されるので、アップ先に拡張子制限がなければ変更しておきましょう。

ここではsurfaces.txtを作成している時に出してしまいがちなエラーと、その原因を示します。

これらのエラーはsurface????の記述部分とsurface.append????での追加記述部分に重複していることもあります。
例えば、以下は重複エラーを起こします。 surface1 { element0,base,surface1.png,0,0 } surface.append0-9 { element0,overlay,surface100.png,0,0 } 上記はサーフェス1でelement0を設定しており、さらにsurface.append0-9でまとめてelement0を追加設定しています。
その結果、サーフェス1でのelement0の設定が2回行われています。
このような追加部分での重複がないかどうかも調べてみてください。

• 今回用意した画像ファイル
  
• 今回作成したdescript.txt charset,Shift_JIS craftman,sakusha_no_namae craftmanw,作者のなまえ craftmanurl,http://www.xxxxxxxxxxxxxxxx.co.jp/ id,master name,master type,shell seriko.use_self_alpha,1
• 今回作成したsurfaces.txt charset,Shift_JIS descript { version,1 } surface0 { element0,base,surface0.png,0,0 } surface1 { element0,base,surface1.png,0,0 } surface2 { element0,base,surface0.png,0,0 element1,overlay,main_blink2.png,0,0 } surface.append0-2 { collision0,83,62,157,90,head collision1,97,263,127,316,hand } surface.append0 { animation0.interval,random,3 animation0.pattern0,overlay,1001,50,0,0 animation0.pattern1,overlay,1000,50,0,0 animation0.pattern2,overlay,-1,50,0,0 } surface10 { element0,base,surface10.png,0,0 } surface11 { element0,base,surface11.png,0,0 } surface1000 { element0,base,main_blink1.png,0,0 } surface1001 { element0,base,main_blink2.png,0,0 }

• materia
  元祖とも言えるベースウェア。2002年に開発停止。軽微なバグがある模様。
• C.R.O.W
  独自の機能（シェルに文字を描画するなど）を積んでいる。2005年に開発停止。
• 如何か
  ブラウザで動くベースウェア。OSにかかわらず、ブラウザさえ動けば動作可能のため、macでもlinuxでも動作可能。
  トークや触り反応が中心のゴーストなら動かせる。
  narファイルをインストールして動かせるデモページあり。
• Androidの伺か
  Android端末で動かせるベースウェア。
  

• Coordin
• ころぺた
• さとりすと（本来は里々記述支援ソフト）

• Osuwari.dll
  シェルがアクティブウインドウを追従するように出来る。ゴーストの辞書側でSAORIの設定が必要。