API Abfragen

🇬🇧 English version · ⬅ Für Mod-Autoren

Abfragen

Alle Abfragen liefern Kopien. Grundlagen (Stationen, Züge, Waren-Schlüssel) stehen auf der Seite Für Mod-Autoren.

Zähler

Funktion	Ergebnis
station_count()	Anzahl UTL-Stationen
idle_train_count()	Anzahl freier Züge in Depots
delivery_count()	Anzahl laufender Lieferungen
chained_count()	wie viele Lieferungen direkt im Anschluss (ohne Depot) vergeben wurden

Stationen

Funktion	Ergebnis
get_station(unit)	Kopie der Stationsdaten: unit, kind, stop_name, config, provide, request, version; nil, wenn unbekannt. In config stehen alle Einstellungen, darunter mode, roles, network, addon_role und ext (Daten von Add-ons).
get_stations(filter?)	Liste: unit, stop, stop_name, network, roles, addon_role, surface, force. filter = { surface = Index, force = Name, network = Name, role = …, addon_role = "mod/name" }; role: "provider", "requester", "depot", "fuel", "cleanup", "storage".
get_trains_at_station(unit)	{ here = { Zug-IDs, die dort warten }, coming = { Zug-IDs, deren Lieferung als Nächstes dorthin fährt } }; nil, wenn unbekannt
pending_trains(stop_unit)	wie viele Züge UTL per Wegpunkt zu dieser Haltestelle schickt (Depot, Tanken, Cleanup). Zusammen mit stop.trains_count ergibt das die Belegung gegen das Zuglimit.

Lieferungen

Funktion	Ergebnis
get_deliveries()	laufende Lieferungen: id, train_id, provider, requester, from, to, network, manifest, state, started, chained, extra_stops; mit zweitem Anbieter zusätzlich second (Station) und leg (1 oder 2)
get_delivery(id)	eine laufende Lieferung (Felder wie oben) oder nil

state ist to_provider, loading, to_requester oder unloading. manifest = { [Waren-Schlüssel] = Menge }.

Züge

Funktion	Ergebnis
get_train(train_id)	was UTL über einen Zug weiß: id, idle (frei im Depot), network, depot (Name), depot_stop, delivery (id), service ("fuel", "cleanup", "both", "relocate" …), stuck_minutes, held_by (Mod, der ihn festhält); nil, wenn UTL ihn nicht kennt
get_idle_trains(filter?)	freie Züge in Depots: id, network, depot, length, surface, force. filter = { surface = Index, force = Name, network = Name }. Mit { role = "mod/name" } stattdessen die freien Züge im Depot eines Add-ons (Felder id, station, depot, length, surface, force, role).

Netze und Teams

Funktion	Ergebnis
get_networks(surface_index, force?)	Netznamen auf einer Oberfläche für ein Team, sortiert
get_network_star(surface_index, name, force?)	Stern eines Netzes: role, center, partners
get_team_config(force_name, key)	gültiger Team-Wert (eigener Wert oder Kartenwert): load_timeout, unload_timeout, timeout_mode
get_elevators()	Weltraumaufzüge (nur mit Space Exploration): je Seite unit, stop, opposite, surface, ok (fertig und mit Strom)

Netz-Kombinator, Statistik, Warnungen

Funktion	Ergebnis
get_readout(unit)	Netz-Kombinator: config (network, mode, star, transit) und values (zuletzt ausgegebene Signale je Waren-Schlüssel); nil, wenn unbekannt. mode: "stock", "storage", "demand", "shortage", "trains".
get_statistics()	Statistik wie im Manager: since, deliveries, goods (je Ware ten, hour), trains (je Zug deliveries, utilization), stations (je Station sent_ten, sent_hour, received_ten, received_hour) – über alle Oberflächen und Teams
get_alerts()	letzte Warnungen, neueste zuerst: key, group, icon, count, tick