Simutrans の輸送ネットワークを構成する中核システムについて解説します。停留所、路線、編成、スケジュールが相互に連携し、複雑な輸送網を実現しています。
ファイル: src/simutrans/simhalt.h, simhalt.cc
停留所（haltestelle_t）は、Simutrans における貨物・旅客の積み下ろし拠点です。複数のタイルにまたがる停留所を統合管理し、経路探索、貨物配送、統計管理を行います。
enum stationtyp {
invalid = 0,
loadingbay = 1 << 0, // トラック荷台
railstation = 1 << 1, // 鉄道駅
dock = 1 << 2, // 港
busstop = 1 << 3, // バス停
airstop = 1 << 4, // 空港
monorailstop = 1 << 5, // モノレール駅
tramstop = 1 << 6, // 路面電車停留所
maglevstop = 1 << 7, // リニア駅
narrowgaugestop = 1 << 8 // 狭軌鉄道駅
};
複数のタイプを組み合わせて（OR 演算）、複合停留所を作成可能です。
enum station_flags {
NOT_ENABLED = 0,
PAX = 1 << 0, // 旅客
POST = 1 << 1, // 郵便
WARE = 1 << 2 // 貨物
};
各停留所は、受け入れる貨物種別を設定できます。
#define HALT_ARRIVED 0 // 到着した貨物量
#define HALT_DEPARTED 1 // 出発した貨物量
#define HALT_WAITING 2 // 待機中の貨物量
#define HALT_HAPPY 3 // 満足した旅客数
#define HALT_UNHAPPY 4 // 不満足な旅客数
#define HALT_NOROUTE 5 // 経路なし旅客数
#define HALT_CONVOIS_ARRIVED 6 // 到着した編成数
#define HALT_WALKED 7 // 徒歩で移動した数
12 ヶ月分の履歴を保持し、グラフ表示に使用されます。
flowchart TD
Halt[停留所 haltestelle_t]
Tiles[複数タイル<br/>koord3d]
Cargo[貨物管理<br/>ware_t リスト]
Routing[経路探索<br/>connection_t]
Stats[統計データ<br/>12ヶ月履歴]
Convoys[編成リスト<br/>到着・出発管理]
Halt --> Tiles
Halt --> Cargo
Halt --> Routing
Halt --> Stats
Halt --> Convoys
Cargo --> |配送先決定| Routing
Routing --> |最短経路| Cargo
Convoys --> |積載/降車| Cargo
Cargo --> |統計更新| Stats
style Halt fill:#e1f5ff
style Routing fill:#fff3cd
// 貨物を追加
void add_ware(ware_t ware);
// 貨物を取得（編成への積載）
uint32 fetch_goods(convoihandle_t cnv, slist_tpl<ware_t>& load,
const goods_desc_t* good, uint32 amount);
// 待機中の貨物総量
uint32 get_ware_summe(const goods_desc_t* good) const;
// 目的地までの経路を検索
halthandle_t get_halt(const koord &pos, const player_t *player) const;
// 接続情報を更新
void rebuild_destinations();
// 統計値を記録
void book(sint64 amount, int cost_type);
// 統計値を取得
sint64 get_finance_history(int month, int cost_type) const;
ファイル: src/simutrans/simline.h, simline.cc
路線（simline_t）は、複数の編成を統合管理するシステムです。スケジュールを共有し、統計を集計します。
enum linetype {
line = 0, // 汎用
truckline = 1, // トラック
trainline = 2, // 鉄道
shipline = 3, // 船舶
airline = 4, // 航空
monorailline = 5, // モノレール
tramline = 6, // 路面電車
maglevline = 7, // リニア
narrowgaugeline = 8, // 狭軌鉄道
MAX_LINE_TYPE
};
#define LINE_CAPACITY 0 // 輸送可能量
#define LINE_TRANSPORTED_GOODS 1 // 輸送済み量
#define LINE_CONVOIS 2 // 編成数
#define LINE_REVENUE 3 // 収入
#define LINE_OPERATIONS 4 // 運用コスト
#define LINE_PROFIT 5 // 利益
#define LINE_DISTANCE 6 // 走行距離
#define LINE_MAXSPEED 7 // 最高速度
#define LINE_WAYTOLL 8 // 通行料
路線の状態は色で表現されます：
stateDiagram-v2
[*] --> 正常: 路線作成
正常 --> 編成なし: 全編成削除
編成なし --> 正常: 編成追加
正常 --> 停止中: 動かない
停止中 --> 正常: 再開
正常 --> 赤字: 収支マイナス
赤字 --> 正常: 収支改善
正常 --> 旧式: 車両が陳腐化
旧式 --> 正常: 車両更新
// 編成を路線に追加
void add_convoy(convoihandle_t cnv);
// 編成を路線から削除
void remove_convoy(convoihandle_t cnv);
// スケジュールを設定
void set_schedule(schedule_t* schedule);
// 財務統計を記録
void book(sint64 amount, int cost_type);
withdraw フラグで段階的な路線廃止が可能ファイル: src/simutrans/simconvoi.h, simconvoi.cc
編成（convoi_t）は、複数の車両を連結した輸送単位です。経路探索、加速計算、貨物管理を統合的に行います。
enum states {
INITIAL, // 初期状態（車庫内）
EDIT_SCHEDULE, // スケジュール編集中
ROUTING_1, // 経路探索中
DUMMY4, DUMMY5,
NO_ROUTE, // 経路なし
CAN_START, // 出発可能
CAN_START_ONE_MONTH, // 1ヶ月後出発可能
CAN_START_TWO_MONTHS, // 2ヶ月後出発可能
ENTERING_DEPOT, // 車庫進入中
LEAVING_DEPOT, // 車庫退出中
DRIVING, // 運行中
LOADING, // 積載中
WAITING_FOR_CLEARANCE,// 信号待ち
WAITING_FOR_CLEARANCE_ONE_MONTH,
WAITING_FOR_CLEARANCE_TWO_MONTHS
};
graph LR
Convoy[編成 convoi_t]
V1[先頭車両<br/>vehicle_t]
V2[車両2<br/>vehicle_t]
V3[車両3<br/>vehicle_t]
Vn[最後尾車両<br/>vehicle_t]
Convoy --> V1
V1 --> V2
V2 --> V3
V3 --> Vn
V1 -->|leading=true| Route[経路探索]
Vn -->|last=true| BrakeCalc[制動計算]
style Convoy fill:#e1f5ff
style V1 fill:#d4edda
style Vn fill:#fff3cd
void calc_acceleration(uint32 delta_t);
以下の要素を考慮します：
sum_gesamtweight（自重 + 積載）sum_friction_weight（カーブ・勾配による変動）sum_gear_and_power（ギア補正込み）sint32 calc_max_speed(uint64 total_power, uint64 total_weight, sint32 speed_limit);
残余パワー式を使用（詳細は VEHICLE_TERMINAL_SPEED.md 参照）
// 新しい経路を探索
void suche_neue_route();
// スケジュールに従って次の目的地へ
void ziel_erreicht();
// 停留所で貨物を積載
void laden();
// 貨物を降ろす
void unload_freight();
// 収入を記録
void book(sint64 amount, int cost_type);
// 運用コストを計算
sint64 calc_running_cost() const;
ファイル: src/simutrans/dataobj/schedule.h, schedule.cc
スケジュール（schedule_t）は、編成の巡回経路を定義します。各エントリーは目的地座標と待機条件を含みます。
struct schedule_entry_t {
koord3d pos; // 目的地座標
uint8 waiting; // 待機条件フラグ
sint16 minimum_loading; // 最小積載率（%）
};
#define WAIT_FOR_TIME 1 // 指定時刻まで待機
#define WAIT_FOR_LOAD 16 // 積載完了まで待機
#define NO_LOAD 32 // 積載しない
classDiagram
class schedule_t {
<<abstract>>
+vector entries
+current_stop
+advance()
+is_same_schedule()
}
class truck_schedule_t {
+waytype = road
}
class train_schedule_t {
+waytype = track/tram/monorail/maglev
}
class ship_schedule_t {
+waytype = water
}
class airplane_schedule_t {
+waytype = air
+handle_aircraft_specifics()
}
schedule_t <|-- truck_schedule_t
schedule_t <|-- train_schedule_t
schedule_t <|-- ship_schedule_t
schedule_t <|-- airplane_schedule_t
sequenceDiagram
participant Convoy as 編成
participant Schedule as スケジュール
participant Halt as 停留所
Convoy->>Schedule: 現在の目的地取得
Schedule-->>Convoy: entries[current_stop]
Convoy->>Convoy: 経路探索・移動
Convoy->>Halt: 到着
Halt->>Convoy: 積載/降車
Convoy->>Schedule: 待機条件チェック
alt 条件満たす
Schedule->>Schedule: advance()
Note over Schedule: current_stop++
else まだ待機
Schedule-->>Convoy: 次の更新まで待機
end
Convoy->>Schedule: 次の目的地取得
graph TD
Schedule[スケジュール<br/>schedule_t]
Line[路線<br/>simline_t]
Convoy[編成<br/>convoi_t]
Vehicle[車両<br/>vehicle_t]
Halt[停留所<br/>haltestelle_t]
Ware[貨物<br/>ware_t]
Line --> |スケジュール共有| Schedule
Schedule --> |経路定義| Convoy
Convoy --> |車両管理| Vehicle
Convoy --> |経路探索| Halt
Halt --> |積載/降車| Ware
Ware --> |配送管理| Convoy
Vehicle --> |加速計算| Convoy
Convoy --> |運用費記録| Line
Line --> |統計集計| Halt
style Schedule fill:#e1f5ff
style Line fill:#d4edda
style Convoy fill:#fff3cd
style Halt fill:#FFD700
| システム | 責務 | 主要ファイル |
|---|---|---|
| Halt | 貨物集約、経路探索、統計 | simhalt.h/cc |
| Line | スケジュール共有、集計統計 | simline.h/cc |
| Convoi | 物理演算、経路探索、貨物管理 | simconvoi.h/cc |
| Schedule | 経路定義、待機条件管理 | schedule.h/cc |
これら 4 つのシステムが緊密に連携することで、Simutrans の複雑な輸送ネットワークが実現されています。