凡例

このページは、books/coe33 の各Runbookで使える実装済みBlockの一覧と、それぞれの最小構文例を まとめた参照ページです。新しいBlock(コアのBlock kind、または plugin-expedition33 の Component)が実装されたら、このページにも例を追加してください。

コアBlock

Plugin/GameSchemaに依存せず、@rundocs/core が常に提供するBlock。

state

任意のkey-valueを書ける汎用Block。GameSchemaのComponent名をキーにネストすると、その Componentの専用Renderer(下記)が適用される。

note

YAMLを介さない、プレーンなテキストのみのBlock。手順の補足や注意書きに使う。本文はMarkdownとして 解釈される。

route

経路メモ用に、YAMLリスト(waypointの配列)を受け取るBlock。

1. Manor Entrance ~> Grand Hall
2. Grand Hall ~> Library

encounter

ターン制の戦闘など、1回限りの遭遇で何が起きたかを記録するBlock。stateのような永続的な Componentとは異なり、その場限りのイベントログとして使う。相手を表すtitle(省略可)と、 ターンごとのactions(行動したcharacterとactionの配列)・任意のnoteをまとめたturnsを持つ。

when

操作のタイミングを一言で記す、プレーンなテキストのみのBlock。:::skipや:::menuなど、 タイミングが意味を持つBlockの直前に置く。

plugin-expedition33 のComponent Block

game.schema.yaml の components に登録されたComponentは、:::state にネストする代わりに :::componentName として単独でも書ける(意味・描画結果は同じ)。

formation(陣形)

隊列順(前衛/後衛の区別なし、最大3人)。members は formation.schema.yaml の enum に 列挙されたキャラクターID。

equip(装備)

キャラクターごとの武器・Pictos(最大3、重複不可)・スキル(最大6、重複不可)・ルミナ(個数制限なし、任意個の文字列)。

status(成長度合い)

キャラクターごとのレベル(lv)・能力値(stats: h体力/s速さ/a攻撃力/d防御力/cクリティカル率)・ 特性(attributes: v生命力/m攻撃力/a素早さ/d防御力/l運)。いずれも省略可で、記録した項目だけ 表示される。

skip(ムービースキップ)

ムービースキップの累計回数と、直後にロード画面を挟むかどうか。スキップするタイミングを記す 場合は、直前に:::whenを置く。

menu(メニューイング)

一時停止メニューを開いて武器・Pictos・ルミナ・スキル・隊列などを変更した記録。順序を持つ actionsを持つ。各行動はcharacter(誰の)とkind(種別)を持てるが、どちらが親になるか (itemsで束ねる側)は行動ごとに逆転してよい。characterはformation Componentと同じ キャラクターID、kindはweapon/pictos/lumina/skill/formation(隊列変更)のいずれかで、 いずれもmenu.schema.yamlのenumで検証される固定値(自由入力不可)。character/kindは ラベルとして見出し的に表示され、noteは操作内容の具体としてMarkdownで描画される。メニューを 開いたタイミングを記す場合は、直前に:::whenを置く。