コンテンツにスキップ
箱庭諸島2 TypeScript 版
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

CLI

Node.js 版の hakoniwa コマンドで、ゲームの開始・終了、ターンの操作、バックアップを行います。

@hakoniwajs/node をインストールした環境では、npx hakoniwa <command> で次の操作ができます。環境変数 (HAKONIWA_DB_PATH など) はサーバーと同じものを指定してください。

npx hakoniwa --help

サーバー

コマンド 説明
serve HTTP サーバーを起動する

ゲーム

コマンド 説明
game new 新しいゲームを開始する (現在のゲームが進行中なら失敗)
game new --name 第2回 --start-at 2026-10-01T21:00:00+09:00 --final-turn 100 --unit-time 6h30m 名前・開始日時・最終ターン・1 ターンの長さを指定して開始する
game finish 現在のゲームを終了する
game list ゲーム一覧 (現在と過去) を表示する
game set-final-turn <N|none> 現在のゲームの最終ターン数を変更する (none で無期限)
game set-unit-time <値> 1 ターンの長さを変更する (次のターン境界から反映。6h、90m、1h30m、3600 (数字のみは秒) を受け付ける)

データベース

コマンド 説明
db init ゲームが無いときだけ新しいゲームを開始する (game new のエイリアス。同じオプションを受け付ける)
db status 現在のゲームの名前・状態・ターン数・最終更新時刻・開始時刻・最終ターン・1 ターンの長さ・島数・過去のゲーム数などを表示する
db reset --yes すべてのゲームを削除する

ターンと時刻

コマンド 説明
turn check 期限が来ていればターンを進める
turn advance 強制的に 1 ターン進める (終了後は何もしない)
time set <unix|ISO8601> 最終更新時刻を変更する

バックアップ

コマンド 説明
backup list バックアップの一覧
backup create [label] バックアップを作成する
backup restore <label> バックアップから復元する
backup delete <label> バックアップを削除する

Cloudflare 版には CLI はありません。同じ操作は管理画面から行えます。