Zum Inhalt

subvention_util

Quelle: base/tealdef/game_mechanics/subventions/subvention_util.d.tl

Hinweise

Gemeinsame Helfer der Scripts für Subventionstypen (Standard-Fristen, Belohnungen und Strafen, Daten für Karten und Benachrichtigungen).

SubventionUtil

record global base/tealdef/game_mechanics/subventions/subvention_util.d.tl:3

global record SubventionUtil

Laden: local subvention_util = ug_require "::/game_mechanics/subventions/subvention_util.tl" as SubventionUtil

Hinweise

Helfer für die Scripts der Subventionstypen und für das Subventions-Game-Script.

Funktionen

getSpawnIntervalDuration(modifier : number, companyRank : integer) : integer base/tealdef/game_mechanics/subventions/subvention_util.d.tl:4

Aufruf: subvention_util.getSpawnIntervalDuration(…)

nil, if there is nothing to spawn at all!

Rückgabe integer

initStateIfEmpty(SubventionState) : SubventionState base/tealdef/game_mechanics/subventions/subvention_util.d.tl:5

Aufruf: subvention_util.initStateIfEmpty(…)

Hinweise

Gibt einen neuen Subventionszustand zurück, wenn der übergebene leer ist. Sonst ergänzt die Funktion fehlende spawnIntervalModifier und failedSubventions.

Parameter Typ Beschreibung
#1 SubventionState Zustand aus dem Game-Script.

Rückgabe SubventionState: Der verwendbare Zustand.

getDefaultSubventionStatus<T>(state : Subvention<T>) : Subvention.Status base/tealdef/game_mechanics/subventions/subvention_util.d.tl:7

Aufruf: subvention_util.getDefaultSubventionStatus(…)

Hinweise

Status aus den Zeitstempeln. Active, wenn angenommen und nicht erfüllt, Complete, wenn erfüllt, sonst Proposed. Failed kommt nie heraus.

Parameter Typ Beschreibung
state Subvention<T> Subvention.

Rückgabe Subvention.Status: Status der Subvention.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:385

local subventionStatus = subvention_util.getDefaultSubventionStatus(state)
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:483
local subventionStatus = subvention_util.getDefaultSubventionStatus(state)
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:438
local subventionStatus = subvention_util.getDefaultSubventionStatus(state)
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:240
local subventionStatus = subvention_util.getDefaultSubventionStatus(state)
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:261
local subventionStatus = subvention_util.getDefaultSubventionStatus(state)

getAllCargoRequired(Engine.Component.StockList) : {CargoTypeId} base/tealdef/game_mechanics/subventions/subvention_util.d.tl:9

Aufruf: subvention_util.getAllCargoRequired(…)

Hinweise

Güterarten, die irgendeine Regel einer Lagerliste als Eingang verwendet. Eine Güterart kann mehrfach vorkommen.

Parameter Typ Beschreibung
#1 Engine.Component.StockList Lagerlisten-Komponente einer Industrie.

Rückgabe {CargoTypeId}: IDs der benötigten Güterarten.

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:65

local allCargoToDeliver = subvention_util.getAllCargoRequired(stockList)

didStockListProduce(Engine.Entity) : boolean base/tealdef/game_mechanics/subventions/subvention_util.d.tl:10

Aufruf: subvention_util.didStockListProduce(…)

Hinweise

Ob irgendeine Produktionsregel einer Lagerliste schon angewendet wurde.

Parameter Typ Beschreibung
#1 Engine.Entity Lagerlisten-Entität.

Rückgabe boolean: Wahr, wenn die Lagerliste mindestens einmal produziert hat.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:57

local didProduce : boolean = subvention_util.didStockListProduce(industry.stockList)

getAllProducedCargo() : {CargoTypeId : integer} base/tealdef/game_mechanics/subventions/subvention_util.d.tl:11

Aufruf: subvention_util.getAllProducedCargo(…)

At any time in the past

Rückgabe {CargoTypeId : integer}

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:142

local allCargoProduced = subvention_util.getAllProducedCargo()
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:260
local allCargoProduced = subvention_util.getAllProducedCargo() as {CargoTypeId : number}

getSpawnYearScaleFactor() : number base/tealdef/game_mechanics/subventions/subvention_util.d.tl:12

Aufruf: subvention_util.getSpawnYearScaleFactor(…)

Hinweise

Faktor von 1 bis 4, der in frühen Jahren längere Fristen gibt. Berechnet als ceil((2000 - year) / 100 * 4), wobei das Jahr auf 1900 bis 1999 begrenzt wird.

Rückgabe number: Skalierungsfaktor. makeDefaultSubventionTemplate addiert pro Stufe 12 Monate zu expireDuration.

defaultTimeout<T is ISubvention.ISubventionData>(state : Subvention<T>, currentGameTime : number) : ISubvention.FailReason base/tealdef/game_mechanics/subventions/subvention_util.d.tl:14

Aufruf: subvention_util.defaultTimeout(…)

Hinweise

Gibt "Timeout" zurück, wenn die Frist der aktuellen Phase abgelaufen ist. Das ist expireDuration nach dem Annehmen, effectDuration nach dem Erfüllen oder, solange die Subvention nur angeboten ist, expireDurationProposed nach dem Erzeugen (außer bei -1).

Parameter Typ Beschreibung
state Subvention<T> Subvention.
currentGameTime number Aktuelle Spielzeit (ms).

Rückgabe ISubvention.FailReason: "Timeout" oder nil.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:213

return subvention_util.defaultTimeout(state, currentGameTime)
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:311
return subvention_util.defaultTimeout(state, currentGameTime)
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:250
return subvention_util.defaultTimeout(state, currentGameTime)
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:183
return subvention_util.defaultTimeout(state, currentGameTime)
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:195
return subvention_util.defaultTimeout(state, currentGameTime)

makeDefaultSubventionTemplate(string) : ISubvention.ISubventionData base/tealdef/game_mechanics/subventions/subvention_util.d.tl:15

Aufruf: subvention_util.makeDefaultSubventionTemplate(…)

Hinweise

Erzeugt Subventionsdaten mit Namen und Standard-Zeitdauern.

Parameter Typ Beschreibung
#1 string Übersetzter Titel.

Rückgabe ISubvention.ISubventionData: Daten mit expireDurationProposed von etwa 6 Monaten (plus oder minus 30 Tage), expireDuration von 12 Monaten plus 12 pro Stufe von getSpawnYearScaleFactor und effectDuration von 5 Jahren.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:72

local state = subvention_util.makeDefaultSubventionTemplate(_("Supply Industry")) as DeliverCargoState
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:113
local state = subvention_util.makeDefaultSubventionTemplate(_("Supply Town")) as DeliverCargoTownState
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:80
local state = subvention_util.makeDefaultSubventionTemplate(_("Connect Towns")) as DeliverPassengersState
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:59
local state = subvention_util.makeDefaultSubventionTemplate(_("Transport Workers")) as DeliverWorkersState
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:62
local state = subvention_util.makeDefaultSubventionTemplate(_("Transport Visitors")) as DeliverVisitorsState

makeDefaultCardData<T is ISubvention.ISubventionData>(state : Subvention<T>, icon : string) : SubventionCardData base/tealdef/game_mechanics/subventions/subvention_util.d.tl:16

Aufruf: subvention_util.makeDefaultCardData(…)

Hinweise

Karteninhalt mit Titel, Frist, Restzeit und den Zeilen für Belohnungen und Strafen der aktuellen Phase.

Parameter Typ Beschreibung
state Subvention<T> Subvention.
icon string Titel-Icon.

Rückgabe SubventionCardData: Karteninhalt. Ergänze location, description und die typspezifischen Felder.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:301

local cardData = subvention_util.makeDefaultCardData(state, "::/game_mechanics/subventions/icons/industry.tga")
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:401
local cardData = subvention_util.makeDefaultCardData(state, "::/game_mechanics/subventions/icons/town.tga")
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:366
local cardData = subvention_util.makeDefaultCardData(state, "::/game_mechanics/subventions/deliver_passengers/connect-towns.tga")
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:236
local cardData = subvention_util.makeDefaultCardData(state, "::/game_mechanics/subventions/deliver_passengers/connect-towns.tga")
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:248
local cardData = subvention_util.makeDefaultCardData(state, "urbangames_campaign_mission_06::/subventions/deliver_visitors/deliver_visitors.tga")

makeDefaultNotificationData(status : ISubvention.Status, failReason : ISubvention.FailReason, icon : string, getDesc : function(ISubvention.Status) : string) : NotificationGuiData base/tealdef/game_mechanics/subventions/subvention_util.d.tl:17

Aufruf: subvention_util.makeDefaultNotificationData(…)

Hinweise

Benachrichtigung mit dem Standardtitel für einen Status („New Subsidy Available“, „Subsidy in Progress“, „Subsidy Fulfilled“, „Subsidy Failed“ oder bei InvalidEntity „Subsidy Removed“; im Spiel „Neue Subvention verfügbar“, „Subvention läuft“, „Subvention erfüllt“, „Subvention gescheitert“, „Subvention entfernt“).

Im Spiel Neue Subvention verfügbar · Subvention läuft · Subvention erfülltIm Code: New Subsidy Available · Subsidy in Progress · Subsidy Fulfilled

Parameter Typ Beschreibung
status ISubvention.Status Zu meldender Status.
failReason ISubvention.FailReason Grund des Scheiterns.
icon string Icon der Benachrichtigung.
getDesc function(ISubvention.Status) : string Liefert die Beschreibung für einen Status.

Rückgabe NotificationGuiData: Inhalt der Benachrichtigung.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:245

return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:342
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:317
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:201
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:213
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),

makeDefaultMissedNotificationData(failReason : ISubvention.FailReason, icon : string, getDesc : function(ISubvention.Status) : string) : NotificationGuiData base/tealdef/game_mechanics/subventions/subvention_util.d.tl:19

Aufruf: subvention_util.makeDefaultMissedNotificationData(…)

Hinweise

Benachrichtigung mit dem Titel „Subsidy Missed“ („Subvention verpasst“) für ein zurückgezogenes Angebot. Bei InvalidEntity verwendet sie statt getDesc eine feste Beschreibung.

Im Spiel Subvention verpasst · Das Subventionsangebot wurde zurückgezogen, da seine Bedingungen nicht mehr erfüllt sind.Im Code: Subsidy Missed · The subsidy offer has been rescinded, as its conditions are no longer met.

Parameter Typ Beschreibung
failReason ISubvention.FailReason Warum das Angebot zurückgezogen wurde.
icon string Icon der Benachrichtigung.
getDesc function(ISubvention.Status) : string Liefert die Beschreibung.

Rückgabe NotificationGuiData: Inhalt der Benachrichtigung.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:266

return subvention_util.makeDefaultMissedNotificationData(reason, subvention_util.getIcon(subventionId, "Failed"),
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:363
return subvention_util.makeDefaultMissedNotificationData(reason, subvention_util.getIcon(subventionId, "Failed"),
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:339
return subvention_util.makeDefaultMissedNotificationData(reason, subvention_util.getIcon(subventionId, "Failed"),
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:222
return subvention_util.makeDefaultMissedNotificationData(reason, subvention_util.getIcon(subventionId, "Failed"),
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:234
return subvention_util.makeDefaultMissedNotificationData(reason, subvention_util.getIcon(subventionId, "Failed"),

applyBonusMalus(bonusMalus : SubventionBonusMalus, positive : boolean) base/tealdef/game_mechanics/subventions/subvention_util.d.tl:22

Aufruf: subvention_util.applyBonusMalus(…)

Hinweise

Wendet eine Belohnung oder Strafe an. Money bucht einen Subventionseintrag ins Journal des Spielers, Reputation sendet das Towns-Ereignis decreaseReputation, TownExperience sendet addExperiencePercentage.

Parameter Typ Beschreibung
bonusMalus SubventionBonusMalus Anzuwendender Eintrag.
positive boolean Wahr für eine Belohnung. Bei falsch werden Geld- und Rufbeträge negiert.

makeBonusMalusMoney(amount : integer) : SubventionBonusMalus base/tealdef/game_mechanics/subventions/subvention_util.d.tl:24

Aufruf: subvention_util.makeBonusMalusMoney(…)

Hinweise

Erzeugt einen Money-Eintrag.

Parameter Typ Beschreibung
amount integer Betrag in Spielwährung, abgerundet.

Rückgabe SubventionBonusMalus: Der Eintrag.

Im Basisspiel verwendet: 9-mal in 4 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:123

subvention_util.makeBonusMalusMoney(upfrontPayment)
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:198
subvention_util.makeBonusMalusMoney(upfrontPayment),
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:108
subvention_util.makeBonusMalusMoney(upfrontPayment)
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:95
subvention_util.makeBonusMalusMoney(upfrontPayment),

makeBonusMalusReputation(townEntity : EntityUtil.EntityAndRevision, value : number) : SubventionBonusMalus base/tealdef/game_mechanics/subventions/subvention_util.d.tl:25

Aufruf: subvention_util.makeBonusMalusReputation(…)

Hinweise

Erzeugt einen Reputation-Eintrag.

Parameter Typ Beschreibung
townEntity EntityUtil.EntityAndRevision Stadt.
value number Änderung des Rufs als Bruchteil.

Rückgabe SubventionBonusMalus: Der Eintrag.

Im Basisspiel verwendet: 7-mal in 3 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:199

subvention_util.makeBonusMalusReputation(state.townEntity, upfrontReputation),
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:113
table.insert(state.failure, subvention_util.makeBonusMalusReputation(state.from, math.random(2, 20) * 0.05 * distanceFactor))
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:92
subvention_util.makeBonusMalusReputation(state.townEntity, upfrontReputation),

makeBonusMalusTownExp(townEntity : EntityUtil.EntityAndRevision, value : number) : SubventionBonusMalus base/tealdef/game_mechanics/subventions/subvention_util.d.tl:26

Aufruf: subvention_util.makeBonusMalusTownExp(…)

Hinweise

Erzeugt einen TownExperience-Eintrag.

Parameter Typ Beschreibung
townEntity EntityUtil.EntityAndRevision Stadt.
value number Levelfortschritt als Bruchteil.

Rückgabe SubventionBonusMalus: Der Eintrag.

Im Basisspiel verwendet: 4-mal in 3 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:216

subvention_util.makeBonusMalusTownExp(state.townEntity, math.random(4, 20) * 0.05),
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:117
subvention_util.makeBonusMalusTownExp(state.from, math.random(4, 20) * 0.05 * distanceFactor),
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:100
subvention_util.makeBonusMalusTownExp(state.townEntity, math.random(4, 20) * 0.05),

makeBonusMalus(t : SubventionBonusMalus.Type, params : SubventionBonusMalus.Param) : SubventionBonusMalus base/tealdef/game_mechanics/subventions/subvention_util.d.tl:27

Aufruf: subvention_util.makeBonusMalus(…)

Hinweise

Erzeugt einen Eintrag beliebigen Typs.

Parameter Typ Beschreibung
t SubventionBonusMalus.Type Typ des Eintrags.
params SubventionBonusMalus.Param Werte des Eintrags.

Rückgabe SubventionBonusMalus: Der Eintrag.

getData(upfront : {SubventionBonusMalus}, positive : boolean) : {SubventionBonusMalus.Data} base/tealdef/game_mechanics/subventions/subvention_util.d.tl:29

Aufruf: subvention_util.getData(…)

Hinweise

Anzeigezeilen für eine Liste von Belohnungen oder Strafen. Geldeinträge werden zu einer Zeile summiert, Rufeinträge zu einer Zeile pro Stadt.

Im Spiel {amount} Zahlung · {amount} Ruf in {townName} · {amount} Level-Fortschritt in {townName}Im Code: {amount} Payment · {amount} Reputation in {townName} · {amount} Level Progress in {townName}

Parameter Typ Beschreibung
upfront {SubventionBonusMalus} Zu beschreibende Einträge.
positive boolean Wahr für Belohnungen („Payment“, im Spiel „Zahlung“), falsch für Strafen („Fine“, im Spiel „Strafe“, der Ruf wird negiert angezeigt).

Rückgabe {SubventionBonusMalus.Data}: Eine Anzeigezeile pro zusammengefasstem Eintrag. Einträge mit dem Betrag null oder einer geänderten Stadt fallen weg.

defaultOnAccept<T is ISubvention.ISubventionData>(state : Subvention<T>) base/tealdef/game_mechanics/subventions/subvention_util.d.tl:31

Aufruf: subvention_util.defaultOnAccept(…)

Hinweise

Wendet alle upfront-Einträge als Belohnungen an.

Parameter Typ Beschreibung
state Subvention<T> Angenommene Subvention.
Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:219

onAccept = subvention_util.defaultOnAccept,
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:317
onAccept = subvention_util.defaultOnAccept,
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:220
onAccept = subvention_util.defaultOnAccept,
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:158
onAccept = subvention_util.defaultOnAccept,
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:172
onAccept = subvention_util.defaultOnAccept,

defaultOnFailure<T is ISubvention.ISubventionData>(state : Subvention<T>) base/tealdef/game_mechanics/subventions/subvention_util.d.tl:32

Aufruf: subvention_util.defaultOnFailure(…)

Hinweise

Wendet alle failure-Einträge als Strafen an.

Parameter Typ Beschreibung
state Subvention<T> Gescheiterte Subvention.
Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:221

onFailure = subvention_util.defaultOnFailure,
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:319
onFailure = subvention_util.defaultOnFailure,
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:222
onFailure = subvention_util.defaultOnFailure,
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:160
onFailure = subvention_util.defaultOnFailure,
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:174
onFailure = subvention_util.defaultOnFailure,

defaultOnComplete<T is ISubvention.ISubventionData>(state : Subvention<T>) base/tealdef/game_mechanics/subventions/subvention_util.d.tl:33

Aufruf: subvention_util.defaultOnComplete(…)

Hinweise

Wendet alle complete-Einträge als Belohnungen an.

Parameter Typ Beschreibung
state Subvention<T> Erfüllte Subvention.
Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:223

onComplete = subvention_util.defaultOnComplete,
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:321
onComplete = subvention_util.defaultOnComplete,
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:224
onComplete = subvention_util.defaultOnComplete,
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:162
onComplete = subvention_util.defaultOnComplete,
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:176
onComplete = subvention_util.defaultOnComplete,

defaultUpdateIndustry<T is ISubvention.ISubventionData>(state : Subvention<T>, industryEntity : EntityUtil.EntityAndRevision) base/tealdef/game_mechanics/subventions/subvention_util.d.tl:34

Aufruf: subvention_util.defaultUpdateIndustry(…)

Hinweise

Bricht eine geplante Schließung der Industrie ab, solange die Subvention aktiv ist.

Parameter Typ Beschreibung
state Subvention<T> Subvention.
industryEntity EntityUtil.EntityAndRevision Ziel-Industrie. Hat sie sich geändert, passiert nichts.
Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:227

subvention_util.defaultUpdateIndustry(state, data.stockListEntity)
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:166
subvention_util.defaultUpdateIndustry(state, data.to)

getDefaultExpectedTimeInMonths(distance : number) : integer base/tealdef/game_mechanics/subventions/subvention_util.d.tl:36

Aufruf: subvention_util.getDefaultExpectedTimeInMonths(…)

Hinweise

Spielmonate, die ein Fahrzeug mit der aktuell höchsten Bahngeschwindigkeit für eine Strecke braucht, aufgerundet. Die Typen des Basisspiels rechnen daraus zusätzliche Fristzeit.

Parameter Typ Beschreibung
distance number Entfernung in Metern.

Rückgabe integer: Zahl der Spielmonate.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:116

local extraTime = subvention_util.getDefaultExpectedTimeInMonths(minDist) * 32
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:190
local extraTime = subvention_util.getDefaultExpectedTimeInMonths(minDist) * 32
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:98
local extraTime = subvention_util.getDefaultExpectedTimeInMonths(distance) * 4
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:86
local extraTime = subvention_util.getDefaultExpectedTimeInMonths(minDist) * 15
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:83
local extraTime = subvention_util.getDefaultExpectedTimeInMonths(minDist) * 15

getSubventionAndStatusFromGameScript(scriptEntity : Engine.Entity, subventionUID : number) : ISubvention, integer base/tealdef/game_mechanics/subventions/subvention_util.d.tl:38

Aufruf: subvention_util.getSubventionAndStatusFromGameScript(…)

Hinweise

Sucht eine Subvention über ihre UID im Zustand des Subventions-Game-Scripts.

Parameter Typ Beschreibung
scriptEntity Engine.Entity Entität des Game-Scripts ::/game_mechanics/subventions/subventions.gs.
subventionUID number Gesuchte UID.

Rückgabe ISubvention, integer: Die Subvention und ihr Listenindex (1 angeboten, 2 aktiv, 3 erfüllt, 4 gescheitert) oder nil, nil.

Im Basisspiel verwendet: 5-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/notifications/notification_legacy_util.tl:113

local subvention, status = subvention_util.getSubventionAndStatusFromGameScript(scriptEntity, params.uid)
base/content/game_mechanics/game_mechanics/notifications/types/subvention.script.tl:41
local subvention = subvention_util.getSubventionAndStatusFromGameScript(scriptEntity, notificationParams.uid)
base/content/game_mechanics/game_mechanics/notifications/types/subvention_notification.script.tl:39
local subvention = subvention_util.getSubventionAndStatusFromGameScript(scriptEntity, notificationParams.uid)
base/content/game_mechanics/game_mechanics/subventions/subventions_gui.tl:206
subvention, status = subvention_util.getSubventionAndStatusFromGameScript(scriptEntity, subventionUID)
base/content/mission/mission/tasks/subsidies/subsidies.tl:88
local found = subvention_util.getSubventionAndStatusFromGameScript(scriptEntity, subsidy[1])

getStatusEnumFromStatusIndex(status : integer) : ISubvention.Status base/tealdef/game_mechanics/subventions/subvention_util.d.tl:39

Aufruf: subvention_util.getStatusEnumFromStatusIndex(…)

Hinweise

Wandelt einen Listenindex aus getSubventionAndStatusFromGameScript in einen Status um.

Parameter Typ Beschreibung
status integer Index 1 bis 4.

Rückgabe ISubvention.Status: Der Status. Bei anderen Werten Proposed, und ein Fehler wird protokolliert.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/game_mechanics/game_mechanics/notifications/types/subvention_notification.script.tl:36

local notificationData = scriptGetNotificationData.getNotificationData(notificationParams.id, notificationParams.params, subvention_util.getStatusEnumFromStatus

getIcon(id : string, status : ISubvention.Status) : string base/tealdef/game_mechanics/subventions/subvention_util.d.tl:40

Aufruf: subvention_util.getIcon(…)

Hinweise

Icon eines Subventionstyps für einen Status, aus der Res-Datei des Typs. Ersatzweise icons.fallback.

Parameter Typ Beschreibung
id string Res-Name des Subventionstyps.
status ISubvention.Status Status.

Rückgabe string: Icon-Pfad oder nil, wenn die Res nicht existiert.

Im Basisspiel verwendet: 10-mal in 5 Dateien

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:245

return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:342
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:317
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
base/content/game_mechanics/game_mechanics/subventions/deliver_workers/deliver_workers.script.tl:201
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),
mods/release/urbangames_campaign_mission_06/content/subventions/subventions/deliver_visitors/deliver_visitors.script.tl:213
return subvention_util.makeDefaultNotificationData(status, reason, subvention_util.getIcon(subventionId, status),

isLineADirectConnectionLine(lineEntity : Engine.Entity, fromTown : Engine.Entity, toTown : Engine.Entity, passengerOnly? : boolean) : boolean base/tealdef/game_mechanics/subventions/subvention_util.d.tl:42

Aufruf: subvention_util.isLineADirectConnectionLine(…)

Hinweise

Ob eine Linie in beiden Städten hält.

Parameter Typ Beschreibung
lineEntity Engine.Entity Linie.
fromTown Engine.Entity Erste Stadt.
toTown Engine.Entity Zweite Stadt.
passengerOnly? boolean Bei wahr zählen nur Halte, an denen Passagiere einsteigen.

Rückgabe boolean: Wahr, wenn die Linie beide Städte verbindet.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:275

if subvention_util.isLineADirectConnectionLine(lineEntity, fromTown, toTown) then

areTownsConnected(fromTown : Engine.Entity, toTown : Engine.Entity, passengerOnly? : boolean) : Engine.Entity base/tealdef/game_mechanics/subventions/subvention_util.d.tl:43

Aufruf: subvention_util.areTownsConnected(…)

Hinweise

Sucht eine Linie, die in beiden Städten hält.

Parameter Typ Beschreibung
fromTown Engine.Entity Erste Stadt.
toTown Engine.Entity Zweite Stadt.
passengerOnly? boolean Bei wahr zählen nur Halte, an denen Passagiere einsteigen.

Rückgabe Engine.Entity: Die erste verbindende Linie oder nil.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/game_mechanics/game_mechanics/subventions/deliver_passengers/deliver_passengers.script.tl:72

local lineEntity = subvention_util.areTownsConnected(fromTownEntity, toTownEntity, true)