InstanceDTO

InstanceDTO describes a managed game instance for library and detail views.

Kind

struct

Fields

Go field	JSON field	Go type	TypeScript type	Optional	Nullable	Description
ID	id	string	string	No	No
Name	name	string	string	No	No
Description	description	string	string	No	No	Description is the user-visible instance description.
GameVersionID	gameVersionId	string	string	No	No	GameVersionID selects the installed game version used by the instance.
GameClient	gameClient	string	string	No	No	GameClient selects the runtime implementation: vanilla or optimum.
DefaultAccountID	defaultAccountId	*string	string | null	Yes	Yes	DefaultAccountID is the account used when the instance launches without an explicit choice.
Directory	directory	string	string	No	No	Directory is the instance data directory relative to the launcher data root.
Status	status	string	string	No	No	Status is the current instance lifecycle state.
LaunchArguments	launchArguments	[]string	string[]	No	No	LaunchArguments are extra command-line arguments appended at launch.
EnvironmentVariables	environmentVariables	map[string]string	Record<string, string>	No	No	EnvironmentVariables are additional environment values applied at launch.
IsPinned	isPinned	bool	boolean	No	No	IsPinned reports whether the instance is pinned in the library.
LastPlayedAt	lastPlayedAt	*string	string | null	Yes	Yes	LastPlayedAt is the timestamp of the most recent launch, when known.
CreatedAt	createdAt	string	string	No	No
EnabledModCount	enabledModCount	int	number	No	No	EnabledModCount and TotalModCount summarize the installed mods.
TotalModCount	totalModCount	int	number	No	No
PlaytimeSeconds	playtimeSeconds	int64	number	No	No	PlaytimeSeconds is the accumulated play time across sessions.
CoverURL	coverUrl	*string	string | null	Yes	Yes	CoverURL serves the instance cover image, when one is set.

Used by

• InstanceController.CloneInstance — return value
• InstanceController.CreateInstance — return value
• InstanceController.GetInstance — return value
• InstanceController.ListInstances — return value
• InstanceController.SetInstancePinned — return value
• InstanceController.UpdateInstance — return value

Source

internal/transport/wails/dto.go:148