-
Notifications
You must be signed in to change notification settings - Fork 0
辞書の書き方
luaのSHIORIなのでluaについてはある程度理解している前提の説明。
ghost\master\talkフォルダ以下にアンダースコア(_)から始まらない文字列+拡張子(.lua)
-
認識される ghost\master\talk\boot.lua
-
認識されない ghost\master\boot.lua -- talkフォルダ以下でない
-
認識されない ghost\master\talk\boot.txt -- 拡張子がluaじゃない
-
認識されない ghost\master\talk\_boot.lua -- ファイル名の先頭にアンダースコア(_)が付いている
return {
{
passthrough = [true | false],
anchor = [true | false],
id = [String],
content = Array | Function | Map[^1] | String | nil,
},
}
passthroughをtrueにするとreplace.confによる自動置換、自動リンク、 末尾\eの追加などの処理を行わないようになる。 balloon_tooltipとか、余計な文字を追加したくないものに指定すると良い。
anchorをtrueにするとidに指定した文字列を自動リンクするようになる。
idを指定しないとランダムトークで呼ばれる様になる。 (内部的にはidはnilではなく長さ0の文字列)
contentは最終的に文字列が返されるようになっていればok。 また、文字列中の改行コードは無視される。 ついでに、末尾の\eは省略しても付加されるようになっている。
[^1]__tostringのmetamethodを持つもののみ。
return {
{
id = "OnBoot",
content = "\\0こんにちは!\\e",
},
{
id = "OnClose",
content = "\\0ばいば〜い\\-\\e",
},
{
id = "Event1",
content = [[
Content
]],
},
{
id = "Event2",
content = function(shiori, ref)
return "Content"
end,
},
{
id = "Event3",
content = function(shiori, ref)
return "Content1", "Content2"
end,
},
{
id = "Event4",
content = {
"Content1",
"Content2",
"Content3",
},
},
}
どちらも起動時に「おはよう!」「こんにちは!」「こんばんは!」の内から いずれか1つをランダムに返す。
return {
{
id = "OnBoot",
content = "\\0おはよう!\\e",
},
{
id = "OnBoot",
content = "\\0こんにちは!\\e",
},
{
id = "OnBoot",
content = "\\0こんばんは!\\e",
},
}
return {
{
id = "OnBoot",
content = {
"\\0おはよう!\\e",
"\\0こんにちは!\\e",
"\\0こんばんは!\\e",
},
},
}
例1と例2を両方使うと選択される確率が変わってくる。 意図的に確率を変えたいのでなければid毎に書き方を統一すべし。
return {
{
id = "OnBoot",
content = "\\0おはよう!\\e", -- 1/4
},
{
id = "OnBoot",
content = "\\0こんにちは!\\e", -- 1/4
},
{
id = "OnBoot",
content = "\\0こんばんは!\\e", -- 1/4
},
{
id = "OnBoot",
content = {
"\\0おはよう!\\e", -- 1/12
"\\0こんにちは!\\e", -- 1/12
"\\0こんばんは!\\e", -- 1/12
},
},
}
後述するshiori:reserveTalk(id[, index])を用いる他に、 coroutineを利用する方法がある。が、あまりおすすめはしない。
{
id = "OnEvent",
content = function(shiori, talk)
coroutine.yield("\\01")
coroutine.yield("\\02", "\\0二")
return "\\03"
end,
},
のように書いておくと、 OnEventが呼ばれる度に、
- "1"
- "2"か"二"のどちらか
- "3"
が順番に表示される。かならず1から表示される点に注意。
return {
{
id = "Event",
content = function(shiori, ref) -- ←このshioriとrefの説明
return "\\0やっほー\\e"
end,
},
}
shiori:talkRandom() -- ランダムトークを返す
shiori:talkPrevious() -- 直前に話したランダムトークを返す
shiori:reserveTalk(id[, index]) -- トークの予約をする
shiori:saori(id) -- SAORI
shiori.var -- 変数管理を行う関数、これだけ「:」ではなく「.」であることに注意
return {
{
id = "OnEvent",
content = function(shiori, ref)
shiori:reserveTalk("予約トーク") -- 次のランダムトークでOnEvent1が呼ばれる
end,
},
{
id = "予約トーク",
content = "\\0予約されたトークだよ。\\e",
},
}
しゃべるトークの予約を行う。 indexは省略すると次のトークを予約することになる。
function(shiori, ref)
local module = shiori:saori("Test")
-- module("Argument0", "Argument1")
local ret = module("test", 100)
print(ret()) -- Resultの値
print(ret[0]) -- Value0の値
print(ret[1]) -- Value1の値
-- エラーを考慮しなければ一行でも書ける。
local result = shiori:saori("Test")("Argument")()
end
こんな感じでSAORIを呼び出せる。 shiori:saori()の引数にはsaori.confで指定したものを使用すること。
SHIORI内で呼び出せる変数を保持する関数。 要素の最初の文字を_(アンダースコア)にすると 変数がファイルに保存されない。 また、これに保存した変数は文字列内から${}を使って参照できる。 ただし、tostringで文字列化しているので、配列や関数などは ただしく置換されないので注意。
変数弄る度に呼ぶのが面倒なので local __ = shiori.varとしておくと幸せ。
これだけはshiori:var()ではなくshiori.var()で呼ぶこと。
function(shiori, ref)
local __ = shiori.var
shiori.var("Test", "テスト")
__("Var1", true)
__("Var2", 100)
__("Var3", {name = "りんご", num = 3})
__("Var1", nil) -- 削除
local var = shiori.var("Test")
return "\\0あーあー、" .. var .. "${Test}\e" -- "\\0あーあー、テストテスト\e"
end
Reference*の配列
function(shiori, ref)
return "\0Reference0は" .. ref[0] .. "だよ。\e"
end
luaの配列はデフォルトでは要素は1から始まるので Reference*を0から順番に処理したいときは
for i, v in ipairs(ref) do
do_something(v)
end
ではなく
for i = 0, #ref + 1 do
do_something(ref[i])
end
とする必要がある。