Skip to content
Copied!
published on 2026-05-08

config.toml リファレンス

config.toml はキャラクターディレクトリに置く設定ファイルです。アプリ実行中にファイルを保存すると即座に反映されます(ホットリロード)。ファイルが存在しない場合はすべてデフォルト値で動作します。

型の表記:実数 = 64 ビット浮動小数点数,[実数, 実数] = [最小値, 最大値] の 2 要素配列。

[floor]

床(Desktop)およびウィンドウ天面(WindowTop)での動作パラメーターです。

キーデフォルト説明
walk_speed実数40.0歩行速度(px/s)
walk_frame_secs実数0.14歩行アニメーション 1 フレームの表示時間(秒)
stand_duration[実数, 実数][3.0, 8.0]StandIdle の継続時間範囲(秒)
sit_duration[実数, 実数][5.0, 15.0]SitIdle の継続時間範囲(秒)
lie_duration[実数, 実数][20.0, 60.0]LieIdle の継続時間範囲(秒)
sleep_duration[実数, 実数][60.0, 180.0]Sleeping の継続時間範囲(秒)
headbob_period[実数, 実数][30.0, 90.0]StandIdle でのヘッドボブ:口が閉じている間隔(秒)の範囲。この時間が経過すると口を開く
headbob_open_duration[実数, 実数][0.3, 0.5]StandIdle でのヘッドボブ:口が開いている時間(秒)の範囲。この時間が経過すると口を閉じる
peek_prob実数0.20Observing 終了時にエッジを覗き込む(PeekDown)確率(0〜1)
peek_duration実数0.5PeekDown を保持する時間(秒)
edge_idle_prob実数0.40WindowTop エッジ到達時,コーナーを回る前にアイドル状態へ移行する確率(0〜1)。0.0 にすると常に即座にコーナーへ移動する
edge_stand_to_sit_prob実数0.50WindowTop エッジでの StandIdle 終了後に SitIdle へ移行する確率(0〜1)。0.0 にするとコーナーへ直接移行する
edge_sit_to_lie_prob実数0.50WindowTop エッジでの SitIdle 終了後に LieIdle へ移行する確率(0〜1)。0.0 にすると StandIdle へ戻る
edge_lie_to_sleep_prob実数0.30WindowTop エッジでの LieIdle 終了後に Sleeping へ移行する確率(0〜1)。0.0 にすると SitIdle へ戻る
standup_duration実数0.8着地後の立ち上がりアニメーション(LandingStandUp)の時間(秒)
turn_duration実数0.7振り向きアニメーション(TurningAround)の時間(秒)
observe_duration[実数, 実数][3.0, 8.0]着地後の観察フェーズ(Observing)の継続時間範囲(秒)
head_side_duration[実数, 実数][10.0, 25.0]SitIdle / LieIdle / Sleeping で横を向き続ける時間範囲(秒)
head_front_duration[実数, 実数][2.0, 6.0]SitIdle / LieIdle / Sleeping で正面を向き続ける時間範囲(秒)
peek_walk_prob実数0.5PeekDown 終了後に歩き続ける確率(0〜1)。残りは TurningAround へ
turn_walk_prob実数0.7TurningAround 終了後に歩き始める確率(0〜1)。残りは StandIdle へ
stand_idle_sit_prob実数0.40StandIdle 終了後(非エッジ)の遷移選択しきい値 1:r < this で SitIdle へ
stand_idle_walk_prob実数0.60StandIdle 終了後(非エッジ)の遷移選択しきい値 2:r < this で Walking へ(sit より優先度低)
stand_idle_turn_prob実数0.80StandIdle 終了後(非エッジ)の遷移選択しきい値 3:r < this で TurningAround。残りは PeekDown へ
sit_idle_lie_prob実数0.30SitIdle 終了後(非エッジ)の遷移選択しきい値 1:r < this で LieIdle へ
sit_idle_stand_prob実数0.65SitIdle 終了後(非エッジ)の遷移選択しきい値 2:r < this で StandIdle へ。残りは Walking へ
lie_idle_sleep_prob実数0.15LieIdle 終了後(非エッジ)の遷移選択しきい値 1:r < this で Sleeping へ
lie_idle_sit_prob実数0.60LieIdle 終了後(非エッジ)の遷移選択しきい値 2:r < this で SitIdle へ。残りは Walking へ
edge_arrive_stand_prob実数0.40WindowTop エッジ到達時の初期アイドル選択しきい値 1:r < this で StandIdle へ
edge_arrive_sit_prob実数0.70WindowTop エッジ到達時の初期アイドル選択しきい値 2:r < this で SitIdle へ
edge_arrive_lie_prob実数0.90WindowTop エッジ到達時の初期アイドル選択しきい値 3:r < this で LieIdle へ。残りは Sleeping へ
edge_fall_prob実数0.10WindowTop エッジ到達時,アイドルしない分局中で驚いて落下(f-shocked)する確率(0〜1)
shocked_duration実数0.6エッジ落下時に f-shocked スプライトを表示する時間(秒)

記述例

config.toml
toml
[floor]
walk_speed        = 60.0
walk_frame_secs   = 0.14
stand_duration    = [3.0, 8.0]
sit_duration      = [5.0, 15.0]
lie_duration      = [20.0, 60.0]
sleep_duration    = [60.0, 180.0]
headbob_period    = [30.0, 90.0]
headbob_open_duration = [0.3, 0.5]
peek_prob         = 0.20
peek_duration     = 0.5
edge_idle_prob    = 0.90
edge_stand_to_sit_prob = 0.50
edge_sit_to_lie_prob   = 0.50
edge_lie_to_sleep_prob = 0.30
standup_duration  = 0.8
turn_duration     = 0.7
observe_duration  = [3.0, 8.0]
head_side_duration  = [10.0, 25.0]
head_front_duration = [ 2.0,  6.0]
peek_walk_prob      = 0.5
turn_walk_prob      = 0.7
stand_idle_sit_prob  = 0.40
stand_idle_walk_prob = 0.60
stand_idle_turn_prob = 0.80
sit_idle_lie_prob    = 0.30
sit_idle_stand_prob  = 0.65
lie_idle_sleep_prob  = 0.15
lie_idle_sit_prob    = 0.60
edge_arrive_stand_prob = 0.40
edge_arrive_sit_prob   = 0.70
edge_arrive_lie_prob   = 0.90
edge_fall_prob    = 0.10
shocked_duration  = 0.6

[wall]

ウィンドウ壁(WindowWall)での動作パラメーターです。

キーデフォルト説明
climb_speed実数60.0壁の登攀速度(px/s)
climb_frame_secs実数0.22登攀アニメーション 1 フレームの表示時間(秒)
pause_prob実数0.15登攀中,3 フレームごとに一時停止(WallPause)する確率(0〜1)
pause_duration[実数, 実数][2.0, 5.0]WallPause の継続時間範囲(秒)
entry_hold実数0.5壁への取り付き直後(WallEntry)に s-hang-wall-0 を保持する時間(秒)

記述例

config.toml
toml
[wall]
climb_speed      = 120.0
climb_frame_secs = 0.11
pause_prob       = 0.15
pause_duration   = [2.0, 5.0]
entry_hold       = 0.5

[corner]

コーナー(WindowUpperCorner)での動作パラメーターです。

キーデフォルト説明
side_corner_secs実数0.3CornerTransitionSide(スプライト s-hang-corner)の表示時間(秒)
front_corner_secs実数0.5CornerTransitionFront(スプライト f-hang-corner)の表示時間(秒)
rest_prob実数0.30コーナー上端で休憩(CornerRest)する確率(0〜1)
rest_duration[実数, 実数][3.0, 8.0]CornerRest の継続時間範囲(秒)
lower_rest_duration[実数, 実数][1.0, 3.0]下コーナーでの休憩継続時間範囲(秒)(定義済み,現在は未使用)
rest_lying_prob実数0.5CornerRest 進入時:伏せる(lying=truef-lie)確率(0〜1)。残りは座る(f-sit
rest_descend_prob実数0.5CornerRest 終了後:壁へ下りる確率(0〜1)。残りはウィンドウ天面を内側へ歩く
corner_jump_prob実数0.2CornerRest 終了時,近くのウィンドウへ飛び移る(JumpRunup)確率(0〜1)。アイドル / 壁下り分岐より前に判定される
corner_jump_dist実数300.0コーナーからのウィンドウ跨ジャンプの検知半径(px)。水平・垂直両方向に適用
outing_interval[実数, 実数][300.0, 900.0]ウィンドウ間の強制お出かけ間隔(秒)の範囲。この時間が経過すると次のアイドル終了時に近くのウィンドウへジャンプする。[0.0, 0.0] で無効化

記述例

config.toml
toml
[corner]
side_corner_secs    = 1.5
front_corner_secs   = 0.5
rest_prob           = 0.80
rest_duration       = [3.0, 8.0]
lower_rest_duration = [1.0, 3.0]
rest_lying_prob     = 0.5
rest_descend_prob   = 0.5
corner_jump_prob    = 0.20
corner_jump_dist    = 300.0
outing_interval     = [300.0, 900.0]

[jump]

Desktop からウィンドウ壁へのジャンプおよびウィンドウへの引き付けに関するパラメーターです。

キーデフォルト説明
gravity実数0.6重力係数。実効加速度は gravity × 60 px/s²。値を大きくするほど落下が速くなる
runup_duration実数0.3JumpRunup アニメーション保持時間(秒)
wall_jump_max_dist実数80.0Desktop 歩行中にジャンプを開始するウィンドウまでの最大水平距離(px)。大きくすると遠くのウィンドウにも飛びつく
wall_jump_floor_margin実数150.0ウィンドウの下端が Dock(タスクバー)より上にこの値以上離れている場合,そのウィンドウはジャンプ・引き付けの対象外(px)。小さいウィンドウへの不自然な飛び付きを防ぐ
climb_attract_dist実数600.0自発的窓クライムの引き付け検知半径。キャラクターの左右それぞれでこの距離以内のウィンドウが対象(px)
climb_attract_prob実数0.35アイドル状態(Observing / StandIdle / SitIdle / LieIdle)終了時に近くにウィンドウがある場合,そちらへ歩き始める確率(0〜1)

記述例

config.toml
toml
[jump]
gravity              = 1.2
runup_duration       = 0.3
wall_jump_max_dist   = 300.0
wall_jump_floor_margin = 300.0
climb_attract_dist   = 600.0
climb_attract_prob   = 0.35

[display]

表示に関するパラメーターです。

キーデフォルト説明
display_width実数150.0キャラクターの表示幅(論理ピクセル)。大きくするほどキャラクターが大きく表示される
hover_alpha実数0.25マウスカーソルがキャラクター上にあるときの不透明度(0〜1)。0.0 で完全透明,1.0 で不透明

記述例

config.toml
toml
[display]
display_width = 150.0
hover_alpha   = 0.25