Every Agentic Atmos AICallable editor tool for inspection, authoring, capture, and diagnostics

Editor Toolsets

Agentic Atmos provides nine editor-only toolsets on Unreal Engine 5.8 through ToolsetRegistry. The tables list every AICallable method by its C++ name and summarize its declared purpose. Discover live tool identifiers and argument schemas through the editor’s tool registry before calling them; these names are not a promise about a client’s transport spelling.

These toolsets are editor tooling, not a runtime game dependency. World-aware tools generally use the PIE world while playing and the editor world otherwise. Read the returned success state, action, problems, and world context: a successful operation can still carry important caveats.

AtmosTime

Tool	Purpose
`GetTime`	Read clock, calendar, apparent time, warps, and time-source ownership.
`SetTime`	Jump to a clock time within the current day without rolling the date.
`AdvanceTime`	Advance or rewind by signed in-game seconds, including crossed calendar events.
`SetPaused`	Freeze or resume the clock.
`SetDilation`	Set a non-negative clock-rate multiplier.
`SetDayLength`	Set real minutes per in-game day.
`AdvanceDays`	Shift by whole in-game days while preserving time of day.
`SetDate`	Set a calendar date and align the clock day index.
`PushTimeWarp`	Push a removable apparent-time warp and return its handle.
`PopTimeWarp`	Remove a warp by its returned handle.
`ClearTimeWarps`	Remove every apparent-time warp.
`GetSeason`	Read season identity, continuous phase, and assigned profile.

AtmosSky

Tool	Purpose
`GetSky`	Read observer geometry, celestial positions, solar-day solution, and physical lighting-model values.
`SetGeoOrigin`	Change the calendar geographic origin; marks the asset dirty but does not save it.
`SetEphemerisDrive`	Always rejects both argument values; this is not a supported drive-mode switch.

AtmosCapture

Tool	Purpose
`CaptureFrame`	Optionally set time and camera, request a frame, and synchronously write its context sidecar.
`GetCaptureContext`	Read renderer and atmosphere capture context without requesting an image.

AtmosWeather

Tool	Purpose
`GetWeather`	Read simulator state, transitions, resolved channels, and lighting response.
`ForceWeather`	Force a registered weather kind found in the active region, using the simulator transition.
`SetActiveRegion`	Select the active region asset used by the resolver and weather simulation.
`SetKindTag`	Set a weather type’s registered kind tag and save the asset.

AtmosAuthor

Tool	Purpose
`ListAssets`	List atmosphere assets by kind and content folder through the Asset Registry.
`CreateDayCycle`	Create and save an empty day cycle.
`CreateWeatherType`	Create and save a weather type.
`CreateRegion`	Create and save a region with empty slot arrays.
`CreateClimate`	Create and save a climate asset.
`CreateCalendar`	Create and save a calendar configuration.
`CreateLightingProfile`	Create and save a physical-lighting profile.
`CreateSkyProfile`	Create and save an empty render-profile registry.
`CreateRenderer`	Create and save a renderer asset of the requested class.
`SetProfileEntry`	Write a render-profile registry entry or plain field, then save.
`SetRendererEntry`	Write a supported renderer field and save.
`RenameMaterialParameters`	Rename parameters on a material.
`SetMaterialParameterTexture`	Change the texture referenced by a material texture parameter.
`RepointMaterialAsset`	Replace references to one asset throughout a material graph.
`SetRendererTexture`	Bind a texture into a clouds renderer’s texture map.
`SetAssetField`	Write a supported reflected field on an asset and save.
`AddRendererRow`	Append a renderer binding row with its source, target, and transform.
`SetWeatherEffectValue`	Write a typed property on an instanced weather effect.
`AddWeatherEffect`	Append an effect instance to a weather type.
`DuplicateAsset`	Duplicate an atmosphere asset into a new package.
`DeleteAsset`	Delete an atmosphere asset only when no referencers remain; otherwise report them.
`SetAssetThumbnail`	Set an asset’s Content Browser thumbnail from a PNG and save.
`SetSlotGating`	Set region-slot tag gates and priority or weight, then save.
`NormalizePersistentLevelURLMap`	Inspect or optionally repair the persistent level’s serialized map-name field; dry-run by default.
`PurgeNiagaraParametersByPrefix`	Remove Niagara editor parameters matching a prefix; dry-run by default.

AtmosSegment

Tool	Purpose
`ListSegments`	List timeline slots in resolver order and report gaps or overlaps.
`GetSegment`	Read one slot’s grouped fields, selected by index or time.
`AddSegment`	Add a timed slot, optionally copying an existing slot, then sort and save.
`RemoveSegment`	Remove a slot and save; refuses to leave the cycle empty.
`SetSegmentTime`	Change a slot’s time range, outgoing transition duration, or easing curve and save.
`PromoteSegmentOverrides`	Fold one slot’s inline overrides into its preset or a new fork, then clear the hidden copy.
`PromoteSegmentLooksToPresets`	Promote inline looks across a cycle into presets, with a dry-run option.
`PullPresetIntoSlot`	Copy a preset into the slot’s hidden inline layer; a compatibility/seeding operation, not normal authoring.
`SetSegmentGroup`	Patch fields in one inline segment group and save; omitted JSON fields retain their values.
`DiffSegments`	Compare two segments field by field without modifying them.
`CopySegment`	Copy a segment into the same or another cycle and save the destination.

AtmosRegion

Tool	Purpose
`ListRegions`	List region assets and the volumes placing them in the current world.
`QueryAt`	Read primary/secondary region resolution and blend alpha at a world point.
`GetActiveRegion`	Report the active region, selected cycle, tag gates, and reasons for slot rejection.
`SpawnRegionVolume`	Spawn an editable rectangular spline region volume; refuses during PIE.

AtmosValidate

Tool	Purpose
`DiagnoseAuthority`	Count sky authorities and identify duplicate owners.
`ListKnownTraps`	Check known configuration traps against live world and asset state.
`ValidateAsset`	Run schema and semantic checks on a supported atmosphere asset.
`EstimateSegmentCost`	Classify authored segment settings into cost buckets; does not return a millisecond estimate.
`ChannelExists`	Check renderer write-side channel binding and collection read-side row existence separately.

AtmosLook

Tool	Purpose
`CompareToReference`	Capture and score a sun-matched pair against the placed comparison rig’s configured reference sky.

Operational details

Authoring tools can save, delete, or rewrite assets. Review exact targets before mutations, use dry runs where offered, and work on your own copies. A failed save is not a completed edit. DeleteAsset refuses referenced assets; it is not a force-delete tool.

Time ownership: an external driver can overwrite SetTime and the within-day part of AdvanceTime. Pausing only postpones that overwrite until resume. Relative advances and warp pushes are not idempotent.
Large time jumps: above the clock’s 366-day event fan-out cap, state still moves the full distance but the event stream is truncated. Read the returned problems; split the move if listeners need every crossing.
Sky readouts: GetSky reports physical-model values. Check bDrivingTheBackend before assuming those values are being applied, and bSolarDaySolved before treating sunrise/sunset as a solved result. SetGeoOrigin requires an explicit asset save afterwards.
Asynchronous capture: CaptureFrame returns before the PNG exists, although its sidecar is already written. It does not pause the clock. Wait for the image and verify it before treating the request as a completed capture.
Registry naming: CreateSkyProfile creates UAtmosRenderProfile; assign the registry to the day cycle’s RenderProfile. New registry and renderer assets are intentionally empty until authored and connected.
Timeline authoring: prefer preset modifier slots. PullPresetIntoSlot and SetSegmentGroup can create hidden inline overrides above an assigned preset. Promotion moves that state into presets and clears it from the timeline. Slot indices can change after sorting.
Validation scope: ValidateAsset recognizes day cycles, regions, weather types, and render profiles. An unsupported class is not a clean validation result. EstimateSegmentCost is a classification, not a GPU timing.
Reference comparison: CompareToReference requires a placed AAtmosCompareRig, an atmosphere sky actor, and a configured reference. It pauses the clock, matches sun elevation, captures both legs, and scores eight axes. No reference sky is supplied automatically. There are no automatic reference-analysis or look-solving tools in this toolset.

See look presets, day-cycle fields, console commands, or support.

Editor Toolsets

On this page