TrainCartsドキュメント

TrainCarts Wiki（英語版）より翻訳
原文：https://wiki.traincarts.net/p/TrainCarts
2026年6月9日現在の変更を取り込んでいます

目次

1. 概要
2. スポーン
   • 2.1 スポーンパターン
   • 2.2 列車スポーンチェスト
3. 物理挙動
   • 3.1 新しい物理挙動
   • 3.2 バニラマインカート
   • 3.3 Mobの乗車
4. 列車プロパティ
5. コマンド
   • 5.1 グローバルコマンド
   • 5.2 列車・カートコマンド
   • 5.3 コマンドセレクター
6. 経路探索
7. チケット
8. アタッチメント
9. 権限
10. パフォーマンス（ラグ対策）
11. 看板
    • 11.1 看板の構造と動作
    • 11.2 方向
    • 11.3 ステートメント
    • 11.4 各看板リファレンス
12. API とアドオン
13. 関連リンク

1. 概要

TrainCarts は Bergerkiller が開発したプラグインで、マインカートを使った列車に関するあらゆる機能を提供します。もともとは複数のカートを連結して動く列車を作ることを目的として開発されました。その後、アクション看板、コマンド、プロパティ、アタッチメント、他のプラグインが独自機能を追加できる広範な API など、多くの機能が加わっています。

列車内の各カートは メンバー と呼ばれ、全メンバーをまとめて グループ と呼びます。各メンバーはグループと通信しており、先頭カートがブロックにぶつかると編成全体が停止します。誰かがカートを押すと、その力は全メンバーに分散されます。そのため、長い列車は短い列車より反応が鈍くなります。

デフォルトでは、プレイヤーが設置したマインカートはすべて TrainCarts 管理のマインカートになります。バニラのマインカートをスポーンさせたい場合は権限設定で変更できます（詳細はバニラマインカート参照）。Mob はデフォルトでは TrainCarts のマインカートに乗りません（詳細は Mob の乗車参照）。

2. スポーン

列車をスポーンさせる方法は主に以下の3つです。

• プレイヤーによるスポーン：プレイヤーがマインカートアイテムをレールに設置すると TrainCarts 管理のマインカートとなります。
• スポーン看板：レールの上にレッドストーン信号または一定間隔で自動的に列車をスポーンします（スポーン看板参照）。
• 列車スポーンチェスト：プレイヤーが持ち歩けるアイテムで、列車をピックアップしてレール上にスポーンできます（列車スポーンチェスト参照）。

2.1 スポーンパターン

列車スポーンチェストとスポーン看板はどちらも スポーンパターン 構文に対応しています。この構文で複数の異なるカートや保存された列車を組み合わせた列車編成を指定できます。

バニラマインカートの種類

保存された列車

/train save [名前] で現在編集中の列車を 保存列車 として保存できます。その名前をスポーンパターンで使用できます。

• 名前の一覧：/savedtrain list
• 保存列車の管理：/savedtrain [名前] [サブコマンド]
• パターンを名前で保存：/savedtrain [名前] spawn [パターン]

スポーンパターンの構文

グループ化：4[carr carg carb] loco は loco の前に 4 グループの carr・carg・carb（計 12 両）を連結します。

ランダム：12[33%carr 33%carg 33%carb] loco はランダムな色のカート 12 両＋機関車の編成をスポーンします。パーセンテージの合計は正規化されます。

2.2 列車スポーンチェスト

列車スポーンチェストは、列車をピックアップしてレール上にスポーンできる特殊なアイテムです。

コマンド

/train chest [スポーンパターン]

指定したスポーンパターンで列車をスポーンするスポーンチェストアイテムを入手します。

/train chest

現在選択中の列車をスポーンチェストに保存します。

/train chest set [スポーンパターン]

既存のスポーンチェストのスポーンパターンを変更します。

/train chest lock

スポーンチェストをロックします（他のプレイヤーが列車をスポーンできないようにする）。

使用方法

スポーンチェストを持ってレールをクリックすると、設定されたパターンの列車がスポーンします。既存の列車をスニーク右クリックするとその列車をチェストに収納できます。

3. 物理挙動

3.1 新しい物理挙動

TrainCarts は通常のレール以外にも特殊な物理挙動に対応しています。

感圧板による交差：感圧板（圧力プレート）はレールの代わりとして機能し、X 字型の交差点として使用できます。列車が交差する方向をランダムに決定します。

ハシゴによる垂直レール：ハシゴをレールの代わりに使用することで、垂直方向に列車を走らせることができます。上昇・下降両方に対応しています。

逆さレール：天井に設置されたバニラレールの下を逆さまに走ることも可能です。

3.2 バニラマインカート

デフォルトでは、プレイヤーが設置したすべてのマインカートが TrainCarts 管理のマインカートになります。バニラの物理挙動で動くマインカートをスポーンさせたい場合は以下の方法があります。

設定ファイルで変更（config.yml）：

allMinecartsAreTrainCarts: false

この設定を false にするとデフォルトでバニラマインカートになります。

権限で制御：

• train.place.traincart：プレイヤーが TrainCarts マインカートを設置できる
• train.place.minecart：プレイヤーがバニラマインカートを設置できる

両方の権限を持つ場合、プレイヤーはスニーク状態でカートを設置するとバニラマインカートになります。

ディスペンサーから：ディスペンサーでスポーンしたマインカートは常にバニラマインカートになります。

3.3 Mob の乗車

デフォルトでは Mob は TrainCarts のマインカートに乗りません。乗れるようにするには以下の設定が必要です。

コマンドで設定：

/train collision mobs enter

DefaultTrainProperties.yml で設定（新しく設置されるすべての列車に適用）：

default:
  collision:
    mobs: enter

または特定の Mob カテゴリごとに設定できます：

collision:
  players: default
  passive: enter
  neutral: push
  hostile: cancel
  tameable: enter
  pet: enter

Mob カテゴリ：passive（受動的 Mob）、neutral（中立 Mob）、hostile（敵対 Mob）、tameable（手懐け可能 Mob）、pet（ペット）、animal（動物）、monster（モンスター）、jockey（騎乗中）、utility（ゴーレム類）、boss（ボス）

4. 列車プロパティ

列車および個々のカートはプロパティを持ちます。DefaultTrainProperties.yml に新しい列車のデフォルト値を設定でき、TrainProperties.yml には既存の列車のプロパティが保存されます。

デフォルトプロパティは以下の方法で設定できます。

• 権限：train.property.default などの権限で特定のプレイヤーに特定のデフォルトを適用
• 看板：[+train] / property / setdefault / <名前> の形式
• コマンド：/train setdefault default|admin|spawner

列車プロパティ一覧

カートプロパティ一覧

衝突モード

collision プロパティには以下のカテゴリ別に衝突モードを設定できます：
players、passive、neutral、hostile、tameable、pet、animal、monster、jockey、killer_bunny、npc、utility、boss、train

使用できるモード：default、push（押しのける）、cancel（無視）、kill（殺す）、killnodrops（ドロップなしで殺す）、enter（乗せる）、link（連結）、damage（ダメージ）、damagenodrops、skip

5. コマンド

コマンドは /train（列車全体を対象）または /cart（単一カートを対象）で実行します。

列車の選択方法

コマンドを実行するには先に列車を選択する必要があります。選択方法は以下のとおりです。

• カートに乗る
• スニーク状態でカートを攻撃する（壊れない）
• 列車スポーンチェストで新しい列車をスポーンする
• カートを見て /train edit を実行する
• /train list でリストを表示してクリックする、または /train edit [名前] で指定する

ターゲットフラグ

事前選択なしで列車を直接指定できるフラグです。コマンドブロックでも使用可能です。

5.1 グローバルコマンド

/train list              # 列車の一覧・統計を表示
/train reroute [--lazy]  # 経路探索を再計算
/train destroyall        # サーバー上の全列車を削除
/train fixbugged         # 孤立した（管理外の）マインカートを削除

5.2 列車・カートコマンド

# 情報
/train info

# 名前・表示名
/train rename [名前]
/train displayname [名前]

# オーナーシップ
/train claim
/train setowners [プレイヤー名...]
/train addowners [プレイヤー名...]

# タグ
/train settags [タグ...]
/train addtags [タグ...]

# 目的地
/train destination [目的地名]

# 経路（ルート）
/train route                              # 現在のルートを確認
/train route set [目的地1] [目的地2...]   # ルートを設定
/train route add [目的地名]               # 目的地を追加
/train route remove [目的地名]            # 目的地を削除
/train route save [名前]                  # ルートを保存
/train route load [名前]                  # 保存されたルートを読み込み

# プレイヤー乗降
/train playerenter [true/false]
/train playerexit [true/false]

# その他プロパティ
/train pickup [true/false]
/train collision mobs enter
/train keeploaded [true/false/minimal 0/full 2 など]
/train speedlimit [速度]
/train save [名前]           # 列車を名前付きで保存
/train debug destination     # 経路探索デバッグ用スティックを入手

保存された列車の管理：

/savedtrain list
/savedtrain [名前] import [URL]
/savedtrain [名前] export
/savedtrain [名前] spawn [パターン]

5.3 コマンドセレクター

@train および @ptrain セレクターをすべてのコマンド（TrainCarts 以外も含む）で使用できます。列車や乗客プレイヤーに対して条件付きでアクションを実行できます。

/train maxspeed 0.0 --train @train[name=intercity*]

@train セレクターの条件

@ptrain セレクター

@ptrain は列車の乗客プレイヤーを対象とします。経済プラグインやステータスエフェクトなど他のプラグインとの連携に使用できます。

/give @ptrain[distance=10] diamond 1

6. 経路探索

列車に目的地を設定すると、切替看板が自動的に線路を切り替え、最短ルートで目的地へ誘導します。

基本的な設定手順

1. 目的地を指定する：目的地看板（Destination Sign）を設置します。3行目に目的地名、4行目に次の目的地（省略可）を記入します。

2. 切替ノードを指定する：線路が分岐する場所に常時通電の切替看板（Switcher Sign）を設置します。目的地が設定された列車がその上を通過すると、経路が計算されて線路が切り替わります。

3. 方向を制限する：一方通行にしたい場合は常時通電のブロッカー看板（Blocker Sign）を使用します。経路探索システムはブロックされた経路を自動的に除外します。

4. テスト：マインカートを設置して目的地を設定します。

/train destination [目的地名]

経路探索が正しく動作しない場合は再計算コマンドを実行します。

/train reroute

プロパティ看板での設定例

[+train]
property
destination
outpost

便利な関連機能

チャンクをロードし続ける：プレイヤーがいない場所でも列車が走り続けるよう keepchunksloaded プロパティを有効にします。

待機距離：wait.distance プロパティで前方の列車との距離を維持します（衝突防止）。

ミューテックスゾーン：交差点での衝突を防ぐためにミューテックス看板を使用します。

ステーション経路選択：ステーション看板に route を指定すると、列車の目的地に基づいて自動的に方向を決定します。

デバッガー

/train debug destination         # 全目的地の経路情報スティックを入手
/train debug destination [名前]  # 特定の目的地への経路を表示

スティックでレールをクリックすると、そのレールから到達できる目的地と距離がパーティクルで表示されます。スニーク状態でクリックするとローカルな再計算を行います。

ルートマネージャー

複数の目的地を順番に巡回させるルートを設定できます。

/train route set [目的地1] [目的地2] [目的地3...]
/train route set outpost hillfort dungeon
/train route add [目的地名]
/train route remove [目的地名]
/train route save [名前]
/train route load [名前]

看板でルートを読み込む場合：

[+train]
property
loadroute
myroute

7. チケット

列車チケットはマップアイテムをベースにした特殊なアイテムです。チケットを持つプレイヤーのみ乗車を許可したり、乗車時に列車プロパティを設定したりできます。

チケットコマンド

/train ticket create <名前>               # 新しいチケットを作成
/train ticket edit <名前>                 # チケットを編集モードに
/train ticket rename <名前> <新しい名前>  # チケット名を変更
/train ticket remove <名前>               # チケットを削除
/train ticket give <プレイヤー> [数量]    # プレイヤーにチケットを付与
/train ticket maximumuses <回数>          # 最大使用回数を設定（-1 で無制限）
/train ticket destination <目的地>        # 使用時に設定される目的地
/train ticket tags <タグ...>              # 使用時に設定されるタグ
/train ticket background <アイテム>       # マップの背景アイテムを設定
/train ticket realm <レルム名>            # チケットのレルム（所属グループ）を設定

チケット看板との連携

チケット看板（[train] / ticket）を使用すると、Vault 経済プラグインとの連携で乗車時に料金を徴収できます（チケット看板参照）。

列車プロパティでチケット設定：

[train]
property
setticket
expresstrain

8. アタッチメント

アタッチメントエディターは列車の外観をカスタマイズするための GUI ツールです。コマンド /train attachments で起動します。

アタッチメントの種類

エディターの使用方法

1. /train attachments でアタッチメントエディターを開く
2. ツリー構造でアタッチメントを追加・削除・並び替える
3. 各アタッチメントに外観（Appearance）、位置（Position）、アニメーション（Animation）、一般設定（General）を設定する

アタッチメントにはアニメーションを設定できます。アニメーション看板（Animate Sign）で再生をトリガーできます。

9. 権限

すべての権限は plugins/Train_Carts/PermissionDefaults.yml に記載されています。このファイルで権限のデフォルト値を変更できます。

一般権限

コマンド権限（主なもの）

看板設置権限（主なもの）

プロパティ権限（主なもの）

10. パフォーマンス（ラグ対策）

TrainCarts の一部の機能はサーバーまたはクライアントの遅延を引き起こす可能性があります。

主な原因と対策

複雑な 3D モデル：大量のアタッチメントを使ったカスタムモデルはクライアントの描画負荷を高めます。モデルの複雑さを抑えるか、リソースパックを活用してください。

大きなカート：大型のカート（多数のアタッチメント）はサーバー処理負荷を上げます。

大きな待機距離（wait distance）：wait.distance を非常に大きく設定すると、前方の長い範囲を常時スキャンするためサーバー負荷が増加します。必要最小限の値に設定してください。

チャンクをロードし続ける（keep chunks loaded）：keepchunksloaded が有効な列車は多くのチャンクをロードし続けます。長距離移動中は minimal 0 モードを使用すると負荷を大幅に削減できます。

[train]
property
keeploaded
minimal 0

列車数の制限（config.yml）：

cartLimits:
  total: 1000        # 世界全体のカート総数
  perWorld: 500      # ワールドごとのカート数
  perPlayer: 50      # プレイヤーごとのカート数

保存列車のスポーン制限：スポーン看板やスポーンチェストでスポーンする保存列車ごとに最大スポーン数を設定できます。

/savedtrain [名前] maxcount [数]

11. 看板

TrainCarts では看板を使ってカートや列車に対するアクションを自動化できます。

11.1 看板の構造と動作

看板は常に同じ構造で使用します。

1行目: [train] または [cart]（+ レッドストーン入力モードと方向）
2行目: 看板の種類
3行目: 設定値1
4行目: 設定値2

[train] は列車全体を対象、[cart] は通過した個々のカートを対象にします。

レッドストーン入力モード

TrainCarts の看板はデフォルトでレッドストーン入力が必要です。1行目の記法で入力モードを変更できます。

レバー出力

看板が取り付けられているブロックにレバーを設置すると、看板がレッドストーン信号を出力できます。例えばステーション看板は列車が停車中にレバーをオンにします。

起動方向

デフォルトでは、列車が看板の正面または側面を向いている時に看板が起動します。コロン（:）に続けて方向を指定することで起動方向を上書きできます。常に起動させたい場合は [train:*] を使います。

例：[-train:lr] は切替看板で列車が看板の左または右から来た時のみレバーを切り替えます。

リモートコントロール

一部の看板は列車名による リモートコントロール に対応しています。[train 列車名] または [t 列車名] の形式を使用します。リモートコントロール看板はレッドストーン変化のみに反応し、設置場所は関係ありません。

[train Intercity*]
property
destination
interhome

この例では「Intercity」で始まる名前のすべての列車の目的地を「interhome」に設定します。

看板の設置ルール

各看板は上方のレールを対象とします。壁付き看板は取り付けブロックから上にレールを探します。看板柱は直上のレールを使います。1つのレールに複数の看板を縦に積み重ねることができます（看板のないブロックを間に挟まないでください）。

11.2 方向

方向指定は看板の起動方向の制御や、切替・発射の方向設定に使用します。

複数の方向を組み合わせる場合はつなげて書きます（例：lr = 左右どちらからでも）。

11.3 ステートメント

ステートメントは切替看板、検知看板、スキップ看板で列車の状態に基づいた条件分岐に使用します。

先頭に ! を付けると NOT 条件になります（例：!passenger = 乗客がいない）。

name@<配列> の形式の配列ステートメントは複数の値をセミコロン（;）で区切って指定できます（例：ed@north;south）。

ほとんどのステートメントは演算子に対応しています：=（等しい）、!=（等しくない）、>=（以上）、<=（以下）、>（より大きい）、<（より小さい）。演算子なしの場合は >0 がデフォルトです。

タグのワイルドカード

*        タグがある
!*       タグがない
*a       末尾が 'a' のタグ
a*       先頭が 'a' のタグ
*a*      'a' を含むタグ
*ab*cd*  'ab' と 'cd' を両方含むタグ

AND 論理

すべてのステートメントは OR で評価されます。AND 条件が必要な場合は、2 つのステートメントを反転させてレバーを切り替え、そのレバーで反転した別の看板を制御する方法を使います。

11.4 各看板リファレンス

アニメーション看板（Animate）

アタッチメントエディターで設定したアニメーションを再生します。リモートコントロール対応。

[train]
animate
アニメーション名
オプション

オプション：

• reset / r：アニメーションをリセット（最初から再生）
• looped / l：ループ再生
• queue / q：現在のアニメーションが終わってから再生
• move / m：列車が動いている間のみ再生

特定のシーンを指定する場合は アニメーション名[シーン名] の形式を使います。

アナウンス看板（Announce）

列車の乗客にメッセージを送ります。リモートコントロール対応。

[train]
announce
メッセージ

4行目にメッセージを追加することもできます（2行にわたるメッセージ）。

ブロッカー看板（Blocker）

指定した方向から来る列車をブロックします。経路探索システムと連携し、レッドストーン入力がある時はその方向からのルートをブロックします。

[+train:left]
blocker

入力が解除された後に列車を進める方向を4行目で指定できます。

経路探索での使用例（左から来る列車をブロック、右方向のみ許可）：

[+train:left]
blocker

ブロック変更看板（Block Changer）

マインカート内に表示されるブロックの種類を変更します。リモートコントロール対応。

[train]
blockchanger
ブロック種類

アイテムのフォーマットでブロックを指定します（例：stone、oak_planks）。

クラフト看板（Crafter）

チェスト付きマインカートのアイテムを、近くのクラフト台を使ってクラフトします。

[train]
craft

目的地看板（Destination）

経路探索ネットワークの目的地マーカーです。列車が通過すると次の目的地を設定します。リモートコントロール対応。

[+train]
destination
目的地名
次の目的地名（省略可）

3行目の目的地名がこのノードの名前になります。4行目を指定すると、この看板を通過した後の次の目的地が自動的に設定されます。

削除看板（Destroyer）

列車またはカートを削除します。リモートコントロール対応。

[+train]
destroy

空の列車（乗客・アイテムなし）のみ削除する例：

[train]
destroy
empty

検知看板（Detector）

一定区間のレール上にいる列車を検知し、レバーを切り替えます。

[train]
detector (名前)
ステートメント1
ステートメント2

配置のルール：検知したい区間の両端に1組ずつ設置します。2つの看板は互いに向き合わせる必要があります。両端の看板が同時に動作するため、合計4つのステートメントを使用できます。

任意の名前を付けると同名の検知看板ペアのみが互いを認識します。ステートメントを省略するとすべての列車を検知します。

エフェクト看板（Effect）

アタッチメントに設定されたエフェクト（サウンド、パーティクル、シーケンサー）を起動します。リモートコントロール対応。

[train]
effect
エフェクト名

レガシー構文（古いバージョン向け）：

• beffect：ブロックエフェクト
• peffect：パーティクルエフェクト
• meffect：モブエフェクト

排出看板（Ejector）

列車から乗客を降ろします。リモートコントロール対応。

[train]
eject
offset x/y/z

降車位置は相対座標または絶対座標で指定できます。4行目で Yaw/Pitch を指定できます（例：yaw 90 pitch -30）。

エレベーター看板（Elevator）

列車を垂直方向に同名の別のエレベーター看板へテレポートさせます。

[+train]
elevator
up

4行目に up（上）または down（下）を指定します。数値を続けて書くと複数のエレベーター看板をスキップできます（例：up 2）。

乗車看板（Enter）

近くにいるプレイヤーまたは Mob を列車に乗せます。リモートコントロール対応。

[+train]
enter
10
player

3行目に乗車範囲の半径（ブロック数）を指定します。10s のように s を付けると球形の範囲になります（デフォルトは円柱形）。4行目に対象のエンティティ種類を指定します：player（プレイヤー）、mob（Mob）、misc（その他）。指定がない場合はすべてが対象です。

フリップ看板（Flip）

カートを180度回転させます。リモートコントロール対応。（※ 現在作業中のページです）

[train]
flip

発射看板（Launcher）

列車を指定速度まで加速・減速させます。ステーション看板と異なり、発射後に速度がロックされないので更に加速・停止が可能です。リモートコントロール対応。

[train]
launch 10
0.4
continue

2行目の構文：

3行目：目標速度。正の数は絶対速度（ブロック/ティック）、+0.5 のように符号付きは相対速度。0 で停止。単位指定例：1.5（ブロック/ティック）、54km/h。

速度制限との同時設定（3行目に2つの数値）：

[train]
launch 20
2.0 10.0

速度制限を2.0に設定し、目標速度まで20ブロックで加速した後、10.0のエネルギー（余剰速度分）を与えます。

4行目：発射方向（省略時は continue = 来た方向に継続）。

ミューテックス看板（Mutex）

交差点などで複数の列車が同時に進入しないよう相互排除ゾーンを定義します。

[+train]
mutex [名前]
幅 高さ

または

[+train]
smartmutex [名前]
幅 高さ

看板種類：

• mutex：単純なミューテックス
• smartmutex / smutex：スマートミューテックス（空きになったら自動で次の列車を解放）
• pathmutex / pmutex：経路探索統合ミューテックス
• spmutex：スマート＋経路探索統合

3行目に幅（x/z方向）、4行目に高さ（y方向）を指定します（例：5 3）。同名の複数の看板で大きなゾーンを定義できます。

ステートメントを使って特定の列車のみ制限できます。

デバッグコマンド：/train debug mutex

プロパティ看板（Property）

列車のプロパティをコマンドと同様に自動設定します。リモートコントロール対応。カートのオーナーシップを無視するため、自分の列車にのみ適用したい場合はオーナーをチェックする切替看板と組み合わせてください。

[train]
property
プロパティ名
値

[cart] と [train] 両方で使えるプロパティ：

[train] のみのプロパティ：

ブール値プロパティのステートメント設定：playerenter などのブール値プロパティはステートメントで条件付き設定が可能です。例えばレバーの状態でオン/オフを切り替えられます。

チャンクロードモード：

待機プロパティ：

コマンドでの設定：/train wait <プロパティ> <値>

スキップ看板（Skip）

前方に続く看板を条件に応じてスキップします。リモートコントロール対応。

[train]
skip
ステートメント
看板種類フィルタ（省略可）

3行目のステートメントが真の場合、前方の看板をスキップします。4行目で特定の種類の看板のみをスキップ対象にできます（例：station = ステーション看板のみスキップ）。

例（乗客がいる時だけスキップ）：

[+train]
skip
passenger

サウンド看板（Sound）

指定した音を再生します。リモートコントロール対応。

[train]
sound
サウンド名
音量 ピッチ（省略可）

msound を使うと列車が看板上にある間、音を継続して再生します。乗客にのみ聞こえるようにするには sound in を使用します。

スポーン看板（Spawner）

看板上のレールに列車をスポーンします。

[train]
spawn
スポーンパターン
インターバル（自動スポーン時）

3行目にスポーンパターン（m、MyTrain など）を指定します。4行目に秒数を指定すると自動スポーンになります（例：30 = 30秒ごとにスポーン）。

スポーン失敗時（レール上に既に別のカートがある等）は看板が色付きテキストで状態を表示します。

ステーション看板（Station）

列車を停止させ、一定時間後に指定方向へ発射します。

[train]
station [距離] [オフセット]
待機時間（秒）
方向

1行目：[train] 使用時は列車の中心カートが看板の真上で停止します。[cart] 使用時は通過した最初のカートが停止します。

2行目：station の後に発射距離（ブロック数）を指定できます（省略時は前方のカーブまでを自動計算、最大100ブロック）。また 20.5m のように m を付けることで中心オフセットを設定できます。

3行目：発射までの待機時間（秒）。

4行目：両側にレッドストーン入力が入っている時の動作モード。

発射速度の指定：

[train]
station
5
continue 0.4

レバー出力：列車が停車中は看板のブロックに付いたレバーがオンになります（扉の開閉、乗降設定の切り替えなどに活用）。

シャトルランの例（折り返し運転）：左端のステーション看板を reverse、右端を reverse に設定すると自動的に往復運転します。

切替看板（Switcher）

列車のプロパティに基づいてレールとレバーを切り替えます。経路探索ネットワークのノードとしても機能します。

[train]
switcher
ステートメント（または方向:ステートメント）
ステートメント（または方向:ステートメント）

1行目：[-train] でレール切替なし（レバーのみ）、[+train] などでレール切替あり。

2行目：switcher または tag

3行目・4行目：ステートメント。デフォルトでは3行目が左方向、4行目が右方向への条件です。方向プレフィックスで方向を明示できます（例：f:passenger = 乗客がいれば前進）。

default ステートメントは他のどの条件も一致しない場合に真になります。

方向プレフィックス

条件が真の時の発射方向を指定します：l:（左）、r:（右）、f:（前進）、n:（北）など。

経路探索ノードとして

ステートメントが空の場合（または一致しない場合）、列車の目的地に基づいて自動的にレールを切り替えます。

[+train]
switcher

レール切替のみ（列車なし）

[+train]
switcher
n-e:redstone
n-w:default

レッドストーン入力時は北東に、それ以外は北西に切り替えます。

ソーター（カウンター分岐）

[+train]
switcher
3
4

3編成を左に、次の4編成を右に送り、以後繰り返します。

列車分割

[+cart]
switcher
50%
50%

[+cart] を使うと各カートを個別に処理し、50%ずつ左右に分岐します。

検知のみ（レバー制御）

[-train]
switcher
passengers

乗客が乗った時だけレバーをオンにします（レール切替なし）。

ステートメントの継続

追加の看板を下に積み重ねると、ステートメントを増やすことができます。ただし、すべての追加行に方向プレフィックスが必要です。

テレポーター看板（Teleporter）

MyWorlds のポータル看板を使って列車をテレポートします。MyWorlds プラグインが必要です。リモートコントロール対応。

[train]
teleport

チケット看板（Ticket）

Vault 経済プラグインと連携して乗車料金を徴収します。Vault プラグインが必要です。

[train]
ticket
モード
金額（または目的地）

モード：

• add：所持金を加算
• check：金額を確認（所持金が足りなければ排出）
• buy：金額を徴収（足りなければ排出）
• pay：対象プレイヤーに支払い

転送看板（Transfer）

列車のチェスト付きカートとチェスト・かまど・ディスペンサーの間でアイテムを転送します。

[train]
transfer in/out/inout
アイテムフィルタ（省略可）

in：周囲のコンテナから列車へ転送
out：列車から周囲のコンテナへ転送
inout：両方向で転送

トリガー看板（Trigger）

SignLink プラグインと連携し、列車情報や到着カウントダウンを看板に表示します。SignLink プラグインが必要です。

[train]
trigger
変数名

列車が通過するとカウントダウンを開始します。RecordMode で列車の定期的な動きを記録できます。

ウェイター看板（Waiter）

前方のレールが空くまで列車を待機させます。

[+train]
wait
距離（省略可）
遅延（秒・省略可）

3行目に前方確認距離（ブロック数）を指定します（省略時はデフォルト値）。4行目にレールが空いた後の発車遅延を秒数で指定できます。

注意：最新の TrainCarts では wait.distance プロパティ（プロパティ看板で設定）の方が高機能です。切替看板・ブロッカー・ミューテックスゾーンも考慮した賢い待機制御が可能なため、通常はそちらを推奨します。

12. API とアドオン

TrainCarts は柔軟な API を持ち、他のプラグインがカスタムトラック、看板、アタッチメントなどを実装できます。

主なアドオン：

• TC-Coasters：なめらかなジェットコースタートラックを追加
• TC-Hangrail：任意のブロックの下に吊り下がったり、上に浮いたりする疑似トラック
• TrainCartsDestinationSelector：プレイヤーが列車の目的地をクリックで選択できる看板
• Traincarts AdvancedSigns：追加の看板タイプ（特にジェットコースターに便利）
• TC Minecart Variants：石炭・金などの資源ごとに異なるカートモデル
• TCAnimatronics：Animatronics プラグインとの連携

廃止されたアドオン（現バージョン非対応）：

• ActionBlocks：ブロックベースのシステム（現在の看板システムで代替可能）

13. 関連リンク(外部・TrainCarts公式)

TrainCarts：Spigot / Jenkins / GitHub

BKCommonLib：Spigot / Jenkins / GitHub

TC-Coasters：Spigot / Jenkins / GitHub

Discord：https://discord.gg/wvU2rFgSnw

Paste サイト：https://paste.traincarts.net/

英語版最終更新：2026年2月（Signs ページ）/ 翻訳：2026年6月