util

Source: base/tealdef/scripts/util.d.tl

Notes

Types of /scripts/util.tl (Util): resolving script function references and formatting game-time durations. Load it with local util = ug_require "/scripts/util.tl" as Util.

Util

record global base/tealdef/scripts/util.d.tl:3

global record Util

Load: local util = ug_require "/scripts/util.tl"

Notes

Miscellaneous script helpers returned by ug_require "/scripts/util.tl".

Functions

useFn(string) : function base/tealdef/scripts/util.d.tl:5

Call as util.useFn

teal only extension of util --> call with util.funYouWannaCall(...) and util = ug_require "path/to/this"

Returns function

Used in the base game: 70 times in 29 files

base/content/mission/mission/mission_sim.script.tl:194

local bootstrapScriptFn = util.useFn(bootstrapDesc.bootstrapScriptFn)

base/content/mission/mission/mission_react_util.tl:270

if dialoguePath == nil or util.useFn(dialoguePath) == nil then

base/content/mission/mission/mission_framework/mission_framework_util.tl:15

local getVTableScriptFn = util.useFn(config.getVTableScriptFn) as function(any, string) : MissionInterface.TaskVTable<any, any>

base/content/gui/gui/line_vehicle_mgmt/manager_window.tl:3147

local renameFn = util.useFn(sc.renameFnDefinition.fileName) as function(params : AutoRename.RenameParams) : string

base/content/gui/gui/line_vehicle_mgmt/line_react_util.tl:64

local dataStateFn = util.useFn(params.notification.type .. "@useDataState") as (function(any, any) : NotificationGuiData)

base/content/gui/gui/construction/constructionHudIconMaster.tl:59

table.insert(hudIcons, (util.useFn(perkState:old().customRecipe.fileName)

… and 23 more files.

formatTimePoint(number) : string base/tealdef/scripts/util.d.tl:6

Call as util.formatTimePoint

No description in the game files yet.

Returns string

formatDurationWithCurrentCalenderSpeed(durationInDefaultSpeedMs : integer, integer, ?DurationRounding) : string base/tealdef/scripts/util.d.tl:13

Call as util.formatDurationWithCurrentCalenderSpeed

Notes

Formats a duration as years, months and days at the current calendar speed.

Parameter	Type	Description
durationInDefaultSpeedMs	integer	Duration in milliseconds of game time.
#2	integer	The current millisPerDay of the GAME_SPEED component; 0 (calendar paused) formats the plain game time instead.
#3	?DurationRounding	Optional rounding mode; without it the result lists years, months and days.

Returns string: Translated text such as "1 Year 3 Months".

Used in the base game: 30 times in 13 files

base/content/mission/mission/tasks/transport_cargo/transport_cargo_faster.tl:81

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(remainingMs), millisPerDay)

base/content/mission/mission/tasks/transport_cargo/empty_stocks.tl:129

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(remainingMs), millisPerDay)

base/content/mission/mission/tasks/wait/wait_for.tl:47

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(remainingMs), millisPerDay)

base/content/mission/mission/tasks/town_rating/town_rating_observer.tl:111

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(remainingMs), gameSpeed.millisPerDay)

base/content/gui/gui/construction/construction_desc_react_util.tl:253

years = util.formatDurationWithCurrentCalenderSpeed(math_util.round(effect.value), millisPerDay, "Year")}),

base/content/game_mechanics/game_mechanics/company/company_util.tl:216

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(remainingCooldown.remainingMs), millisPerDay)

… and 7 more files.

Util.DurationRounding

enum base/tealdef/scripts/util.d.tl:8

enum DurationRounding

Notes

Rounding mode for formatDurationWithCurrentCalenderSpeed.

Used in the base game: 1 time in 1 file

base/content/scripts/scripts/util.tl:40

function util.formatDurationWithCurrentCalenderSpeed(durationInDefaultSpeed : integer, currentMillisPerDay : integer, rounding? : Util.DurationRounding) : strin

Value	Description
"OnlyMonth"	Show the duration in months only (years converted to months).
"Month"	Show years and months, rounded to the nearest month.
"Year"	Show whole years, rounded to the nearest year.