ファイル構成。
ゴースト「ポストと狛犬」に入ってたり入ってなかったりするファイル。
基本ルールでもあります。
以下はゴーストとしてのフォルダとファイルの構成の代表的な物を列挙した概略になります。
★マークのある項が里々とその関連の制御下・範疇にあるファイルです。
C:\Program Files\ssp\ghost\○○ │ readme.txt │ install.txt 【narファイルには必須】 │ thumbnail.png │ developer_options.txt │ update2.dau 【ネットワーク更新でサーバーに必須】 ├─ghost │ └─master │ │ descript.txt 【必須】 │ │ ○○.ico │ │ dic○○.txt │ │ replace.txt │ │ replace_after.txt │ │ satori.dll ★【必須】 │ │ satori_conf.txt ★ │ │ satori_license.txt ★【必須→配布時不要】 ※Mc163-5以降はなくてもOK │ │ satori_savebackup.txt ★【自動生成、配布時要削除】 │ │ satori_savedata.txt ★【自動生成、配布時要削除】 │ │ satorite.exe ★【配布時不要】 │ │ satorite.dat ★【配布時不要】 │ │ satorite.txt ★【配布時不要】 │ │ れしば.exe ★【配布時不要】 │ │ れしば.txt ★【配布時不要】 │ │ characters.ini ★ │ ├─saori │ │ fill_desktop.dll 【例/SAORI】 │ │ ssu.dll ★ │ ├─another ★【例/辞書フォルダ】 │ ├─profile 【自動生成、配布時要削除】 │ └─var 【自動生成、配布時要削除】 └─shell ├─master │ descript.txt │ surface○○.png │ surfaces.txt └─profile 【自動生成、配布時削除】
フォルダ名は半角英数推奨。
詳しく→Ukadoc ゴーストの構成 (一般的ゴーストの構成です、ここのshiori.dllが里々使用ゴーストではsatori.dllになります)
里々にかかわらず、ほぼ全てのゴーストに共通する、伺か・ベースウェア仕様のファイルです。
これらの詳しい仕様は外部サイトUKADOC Projectにてまとめられています(SSPはこのドキュメントが公式文書扱いとなっています)。
そのゴーストの説明や作者からの注意書きなどを書いておくファイル。
必須ではありませんが、あればゴーストがインストールされた時に自動的に開かれるので、注意書きなどを書いておけばユーザの目に留まりやすくなります。
配布者や配布元など明記するのが一般的。
インストール情報を記述するファイル。
インストール用 narファイルには必須です。
refresh,1 refreshundeletemask,satori_savedata.txt
ゴーストのサムネイル画像です。省略可。
右クリックメニューのゴースト切り替え等で表示されます。
updates2.dau や narアーカイブを作成する時に、この中で指定したファイルを含まないようにします。省略可。
ベースウェアSSP専用。
詳しくはUKADOCのdeveloper_options.txtを参照のこと。
Rポストと狛犬 2018/04/24では以下を記述しています。
セーブデータ、さとりて、れしばをnarやネットワーク更新用に含めません。
ghost/master/satori_savebackup.txt,nonar,noupdate ghost/master/satori_savedata.txt,nonar,noupdate ghost/master/satorite.txt,nonar,noupdate ghost/master/satorite.exe,nonar,noupdate ghost/master/れしば.txt,nonar,noupdate ghost/master/れしば.exe,nonar,noupdate
ネットワーク更新の受信ファイル照合用ファイル。
ネットワーク更新でゴーストのアップデート配信する場合にサーバーに置いておきます、
ネットワーク更新したゴーストのフォルダに入ってたりします。
ゴーストの名称等を記述します。必須ファイル。
アイコン画像ファイル。省略可。
これを用意し、descript.txtにicon設定の定義を記述することで、タスクトレイ用のアイコンとして使われます。
主に里々ゴーストだけが持つ特有のファイル群です。
伺かの仕様における「栞」であり、里々の本体です。必須ファイル。
栞は、様々な辞書ファイルとベースウェアを仲介する、ゴーストの心臓部になります。
里々のライセンスが記載されている文書です。
変数・特殊変数の初期値設定、SAORI使用時の定義を記述するファイル。
ゴースト起動時に変数・特殊変数へ初期値を与えたい時に記述します。
初期値が読み込まれるとゴースト終了時に変数の値は satori_savedata.txt に保存され、次回起動時からは satori_savedata.txt の値が優先されます。(初期値は1回だけ参照される事になります。)
例
*初期化 $喋り間隔【タブ】180秒 $喋り間隔誤差【タブ】10%
使用するSAORIを定義します。
例
@SAORI fill_desktop,saori/fill_desktop.dll fill_red,saori/fill_dektop.dll,255,0,0
詳しく→SAORI
キャラクター設定をするファイルです。省略可。
詳しく→駄でべ レゴキチ/里々まとめ の characters.ini の項を参照
トークから栞リソースまで全てを記述します。
いわゆる「辞書ファイル」と呼ばれます。
自動アンカー用辞書ファイル。省略可。
辞書ファイル置換文字列の定義ファイル。省略可。
書式
置換する文字列【タブ】置換後の文字列
※この書式の【タブ】は必ず実際のTabキーを押して入力して下さい。
例えばカッコを含んだものを置き換えたり。
(赤)【タブ】(fill_desktop,255,0,0)
callを省略してユーザ定義関数っぽくしてみたり。
(ほげ,【タブ】(call,ほげ, (ほげ、【タブ】(call、ほげ、
本wikiに限らず、タブ文字はけっこう多用されるので、下記の記述は入れておくと吉。
【タブ】
見えづらいですが"【タブ】"の右にはタブが2つあります。この"【タブ】"はそのまま4文字の文字列としての意味です。
トーク置換文字列の定義ファイル。省略可。
書式
置換する文字列【タブ】置換後の文字列
※この書式の【タブ】は必ず実際のTabキーを押して入力して下さい。
replace.txtと同じく、辞書に書いた内容を置き換えます。
違うのは、本体にさくらスクリプトを返す直前、つまり「しゃべる直前」に置き換えること。
例えば……
変数(ゴースト名)に”ととたん”が入っていた場合
:(ゴースト名)さん、またねー
みたいなのが
ととたんさん、またねー
になってしまうのを防ぐために、
たんさん【タブ】たん
と書くと。
replace.txtだと、まだカッコが展開されてないので「たんさん」になっておらず、置き換えが効かないわけです。逆に、カッコを含むものはreplace_after.txtだと既に展開されており、手遅れなわけです。
このへんが影響しない場合は、どっちでも同じです。
いわゆるセーブデータと呼ばれるファイルで、変数が保存されます。
ゴースト配布ファイル作成時は削除して下さい。
*セーブデータ $喋り間隔【タブ】180秒 $喋り間隔誤差【タブ】10%
参考→セーブデータ
satori_savedata.txtの一世代前バックアップとして作られるファイルです。
ゴースト配布ファイル作成時は削除して下さい。
参考→セーブデータ
トークのテストをしたりできる補助ツールです。
里々形式で会話を書いて、それを起動中のゴーストに(SSTPで)喋らせることができます。
里々による「さくらスクリプト」の変換結果を見ることもできます。
使い方→ゴースト作成入門-里々編-(深瀬氏):さとりての使い方
里々の動作ビューワです。
ゴースト起動前にこれを起動しておくと、satori.dllの動作を逐一見ることができます。
関連→特殊変数.れしば関係
ゴースト「ポストと狛犬」に標準装備されていたSAORIです。
Mc157-1よりssuが内部関数に統合されたため、saori/ssu.dllファイルと関連するSAORIの宣言記述が不要になりました。
ゴースト「ポストと狛犬」にサンプルとして入っているSAORIです。省略可。
ただし削除する場合は satori_conf.txt の次の定義も削除して下さい。
fill_desktop,saori/fill_desktop.dll fill_red,saori/fill_desktop.dll,255,0,0