箱庭交通機関 鯖民向け説明書 (Alpha-1.16.0)
このサーバーの「箱庭交通機関」プラグインで使えるコマンドの一覧です。特別な権限が無くても 使えるものと、管理者(または個別に権限を付与された人)しか使えないものを分けて記載しています。 念のため、権限がないと使えないコマンドも「こういうことができる」という参考として載せています。
コマンド名は /htransit(短縮形 /htr)どちらでも使えます。以下では /htr で表記します。
WARNING
本書に記載の内容は、プラグインのバージョンや当サーバーの設定状況により、一部が実際の動作と異なる場合があります。ご利用の際は、実際にコマンドを実行するなどしてご自身で動作をご確認ください。 各コマンドを実行した場合に何が起こるかは本書内でできる限り説明していますので、それを踏まえたうえでの実行によって生じた不利益について、運営チームは責任を負いかねます。
1. できること
- 改札看板を右クリックして駅に入場・出場し、出場時に運賃が自動で引き落とされます。
- 自分の乗車履歴の確認・ファイル(CSV/JSON)への書き出し(期間指定可)ができます。
- 駅・路線・会社の一覧確認、乗換案内(通過駅・運賃)の確認ができます。
- 利用回数・支払運賃のランキングを確認できます。
- ブラウザから路線図Webページを開き、路線図・運賃シミュレーター・混雑状況・QRコード共有を利用できます。
- (このサーバーで制限が有効な場合)エリトラでの滑空には権限または免許が必要です。
2. 誰でも使えるコマンド
改札の利用自体(入退場・運賃の支払い)は誰でもできます。以下のコマンドも権限不要です。
| コマンド | できること |
|---|---|
/htr history [ページ] | 自分の乗車履歴を確認する |
/htr history unpaid | 自分の未払い記録・乗車中(未出場)記録を確認する |
/htr station list | 登録済みの駅を一覧表示する |
/htr station connections <駅id> | 指定駅の直接接続(乗り入れ先)を一覧表示する |
/htr station congestion [駅id|all] | 駅の混雑度(現在入場中の人数)を確認する |
/htr route list | 路線一覧(駅から参照されているものを含む、会社・運行中/運休中)を一覧表示する |
/htr route <路線id> | 指定した路線の表示名・会社・運行状況・所属駅を確認する |
/htr company list | 会社一覧(路線から参照されているものを含む)を一覧表示する |
/htr company <会社id> | 指定した会社の表示名・所属路線を確認する |
/htr route find <入場駅id> <出場駅id> | 乗換案内(通過駅・乗換・運賃)を確認する |
/htr history export <csv|json> [from=yyyy-MM-dd] [to=yyyy-MM-dd] | 自分の乗車履歴をファイル(サーバー内)に書き出す(期間を絞り込み可能) |
/htr fare list | 現在の運賃設定を一覧表示する |
/htr ranking rides [件数] | 利用回数ランキングを確認する |
/htr ranking fare [件数] | 支払運賃ランキングを確認する |
/htr elytra status [player] | エリトラ許可制の有効/無効、免許の有無を確認する |
3. コマンド以外の使い方
改札看板
| 操作 | できること |
|---|---|
| 改札看板を右クリック | 入場/出場する(運賃は出場時に自動徴収) |
| 改札看板をしゃがみ右クリック | 入退場せず、駅情報・運賃・乗換案内を確認する |
路線図Webページ
/htr route map で確認できるURLを開くと、ブラウザ上で以下のタブを操作できます(コマンド不要、 運営からURLを共有された場合のみ利用できます)。
| タブ | 内容 |
|---|---|
| 路線図 | 駅・路線・接続の最新状態を図で確認する(10秒ごとに自動更新) |
| 運賃シミュレーター | 乗車駅・降車駅をプルダウンで選び、実際の運賃計算で運賃と経路を事前に確認する |
| 混雑状況 | 直近24時間の駅ごとの入場・出場件数をバーグラフで確認する |
| スマホでひらく | このページのURLをQRコードで表示する(スマホのカメラで読み取ると同じページを開ける) |
4. 主要コマンドの使い方の例
乗車履歴を確認する
/htr history自分の乗車履歴が新しい順にページ表示されます。2ページ目以降は/htr history 2のようにページ番号を指定します。
乗車履歴を期間指定でファイルに書き出す
/htr history export csv from=2026-08-01 to=2026-08-092026年8月1日〜8月9日分の履歴のみをCSVファイルとして書き出します。from/toはどちらも省略可能で、 省略した場合は全期間が対象になります。
乗換案内で運賃・経路を調べる
/htr route find central end_st入場駅ID(central)から出場駅ID(end_st)までの通過駅・乗換・運賃が表示されます。駅IDは /htr station listで確認できます。
路線図Webページで運賃を事前に確認する
/htr route mapで表示されたURLをブラウザで開き、「運賃シミュレーター」タブで乗車駅・降車駅を プルダウンから選ぶと、実際に乗車したときと同じ運賃・経路がその場で表示されます。
5. よくある質問
- Q. 「権限がありません」と表示された → そのコマンドは7章に該当する管理者専用コマンドです。 必要であれば運営に相談してください。
- Q. 乗換案内で「経路は不明です」と出た → 入場駅と出場駅が別会社の路線に属しているか、直接 つながっていない可能性があります。この場合は運賃だけ(越境運賃)が確定して表示されます。
- Q. エリトラで滑空できない → このサーバーでエリトラ制限が有効になっている場合、権限か免許が 無いと滑空できません。
/htr elytra statusで自分の状態を確認してください。
6. 注意点
- 未入場での出場・二重入場はできません(いずれもエラーメッセージが表示され、運賃は発生しません)。
- 残高不足で出場できない場合、サーバーの設定によっては強制出場が許可されておらず、入場記録が残ったまま 出場できないことがあります。その場合は残高を用意してから改めて出場してください。
- 路線図Webページの「混雑状況」タブは直近24時間の集計に固定されており、期間を変更することはできません。
- 路線図Webページの「スマホでひらく」タブのQRコードは外部の画像サービスを利用しているため、 サーバー側の通信環境によっては表示されないことがあります(その場合も他のタブの機能には影響しません)。
- 運賃シミュレーターの結果は、実際に会社をまたぐ移動などで経路が特定できない場合、経路が空欄のまま 運賃(越境運賃)のみが表示されることがあります。
7. 管理者権限などが必要なコマンド
以下は管理者(op)や、個別に権限を付与された人専用のコマンドです。通常の鯖民は使えませんが、 「こういう管理ができる」という参考として一覧にしています。
駅・路線の管理(hakoniwatransit.station.manage、既定op)
| コマンド | できること |
|---|---|
/htr station add | 駅を新規登録する |
/htr station edit ... | 駅のID・路線・番号・表示名を変更する |
/htr station remove <id> | 駅を削除する |
/htr station connect / disconnect | 駅同士を直接接続/解除する |
/htr route add / edit / remove | 路線を新規登録/変更/削除する |
/htr route status <id> <on|off> | 路線の運行状況(運行中/運休中)を切り替える |
/htr company add / edit / remove | 会社を新規登録/変更(表示名)/削除する |
/htr sign refresh <番号|all> | 改札看板の表示を最新の内容で更新する |
運賃の管理(hakoniwatransit.fare.manage、既定op)
| コマンド | できること |
|---|---|
/htr fare set / remove | 特別区間運賃を設定/削除する |
/htr fare default / samestation / base / perstation / crossroute | 各種運賃の金額を設定する |
/htr fare currency <単位> | 運賃表示の通貨単位を設定する |
/htr fare loop <route> <on|off|status> | 路線の環状線設定を切替/確認する |
/htr revenue owner set/remove/list | 路線ごとの収益受取先を設定/確認する |
/htr revenue rate / recipient | 手数料率・手数料受取先を設定する |
/htr revenue mode / interval / notify | 支払いタイミング・通知の設定を変更する |
/htr revenue status | 収益分配の設定状況を表示する |
/htr revenue stats station/player | 駅別・プレイヤー別の売上を集計する |
フェンスゲートの管理(hakoniwatransit.gate.manage、既定op)
| コマンド | できること |
|---|---|
/htr gate link <番号> | フェンスゲートを改札看板に紐付ける |
/htr gate unlink <番号> | 紐付いているフェンスゲートを解除する |
/htr gate list <番号> | 紐付いているフェンスゲートを一覧表示する |
他人の履歴閲覧(hakoniwatransit.history、既定op)
| コマンド | できること |
|---|---|
/htr history <player> [page] | 他プレイヤーの乗車履歴を確認する |
/htr history unpaid <player> | 他プレイヤーの未払い・乗車中記録を確認する(引数無しなら全員分) |
/htr history export <csv|json> <player> | 他プレイヤーの乗車履歴をファイルに書き出す |
エリトラ免許の管理(hakoniwatransit.elytra.manage、既定op)
| コマンド | できること |
|---|---|
/htr elytra grant <player> | エリトラ免許を付与する |
/htr elytra revoke <player> | エリトラ免許を剥奪する |
/htr elytra list | 免許保持者を一覧表示する |
サーバー管理(hakoniwatransit.admin、既定op)
| コマンド | できること |
|---|---|
/htr reload | 設定ファイルを再読込する |
/htr enable / disable | プラグイン全体の入退場処理を有効化/無効化する |
/htr discord webhook add/remove/list | Discord通知の送信先(Webhook)を追加/削除/一覧表示する |
/htr discord notice <種別> <on|off|webhook> | 告知種別ごとの通知有効/無効・送信先を設定する |
/htr route map | 路線図Webサーバーの稼働状況・ポートを確認する(ページには運賃シミュレーター・混雑状況・QRコード共有も含まれる) |
8. 備考
- 2026年7月29日 初版公開（Alpha-1.13.0）（表記整理前バージョン）
- Alpha-1.14.0でDiscord Webhookの送信先追加/削除・告知種別ごとの通知設定コマンドを追加（Alpha-1.14.0版はこちら）
- Alpha-1.14.1で会社(company)を路線から独立して管理するコマンドを追加（Alpha-1.14.1版はこちら）
- Alpha-1.14.2で路線・会社の一覧に暗黙登録分を含め、個別詳細確認コマンドを追加(単体のアーカイブファイルが見つからないため、この版へのリンクは付与できません)
- Alpha-1.14.3で
route <id>/company <id>のTAB補完が候補を表示しない不具合を修正（Alpha-1.14.3版はこちら） - Alpha-1.15.0で乗車履歴のCSV/JSONエクスポート(
history export)と路線図Webサーバー(route map)を追加（Alpha-1.15.0版はこちら） - Alpha-1.15.1で
/htransit reloadで路線図Webサーバーの設定変更を反映するようにし、路線図の表示に路線/会社の名称・IDを併記するようにした（Alpha-1.15.1版はこちら） - Alpha-1.15.2で会社未設定の路線が路線idをそのまま会社名として表示していた問題を修正し、駅設定だけで路線・会社の表示名を定義できるようにした（Alpha-1.15.2版はこちら）
- Alpha-1.16.0で
history exportに期間指定(from/to)を追加し、路線図Webページに運賃シミュレーター・混雑状況表示・QRコードでのスマホ共有を追加した(章立てを8章構成のテンプレートに合わせて整理)