Skip to main content

ActorVisualController

The ActorVisualController manages the dynamic loading and customization of character visuals for players, handling modular equipment, skin tone, and animation via the Animancer system. It supports runtime addressable asset management and robust animation layering.

🧩 Overview​

public class ActorVisualController : SerializedMonoBehaviour

A Unity MonoBehaviour component that assembles, animates, and tracks player avatars through addressable prefabs and modular components like PlayerItem_SO.

🧱 Visual Customization​

SetAvatarItems(List<PlayerItem_SO> requestedItems, bool shouldSaveItems = true)​

  • Dynamically loads visual assets based on requested player items.
  • Handles merging with DefaultItems.
  • Clears or disables unused visuals based on the shouldDeleteUnusedItemsOnChange flag.
  • Loads the asset from SourcePrefab if necessary.

SetSkintone(PlayerSkintone newTone, bool shouldSave = false)​

  • Updates all PlayerSkintoneItem components to the specified tone.

PreviewOutfit(PlayerOutfit outfit)​

  • Swaps current visuals to reflect the passed outfit without saving changes permanently.

🧩 Animation API (Animancer-based)​

PlayClip(...), PlayMixer(...), etc.​

Animates the character using:

  • Single clips via ClipTransition.
  • Mixers like LinearMixerTransition or MixerTransition2D.
  • Controls layer weight, additive mode, masks, and time offset.

All play methods cache the active AnimationSequence per layer for state restoration and manipulation.

ApplyToAnimancers(int layer, float weight)​

  • Updates the weight of a specific animation layer.

FadeTo(int layer, FadeTo goal)​

  • Fades a layer fully in or out based on the FadeTo enum.

StopAnimancers(int layer) / StopAllAnimancers()​

  • Halts animations cleanly on one or all layers.

🔀 Visual Lifecycle & Asset Loading​

LoadAsset()​

  • Loads the character prefab via Addressables and caches the result.

OnVisualsDespawned, OnVisualsSpawned​

  • UnityEvents triggered on prefab replacement or initialization.

🎮 Runtime Attachments​

TrackedTransforms​

Tracks visual bones or sockets with NetworkTrackedTransforms for syncing purposes.

worldUI & moveUIToHead​

UI element auto-repositions to the avatar’s head using HeadTransformTracker.

🔄 Internal State & Caching​

  • CurrentOutfit – currently displayed outfit.
  • _loadedAnimancer – reference to the AnimancerComponent on the visual prefab.
  • _activeLayerSequences – animation state info per layer.
  • _spawnedPrefab / _loadedPrefab – live and cached asset instances.
  • _loadedPlayerItems – cached PlayerItem components for visibility toggling.

🧠 Summary​

ActorVisualController is the central avatar loader, animator, and manager in the m00m character system. It modularly assembles visual components based on player data, integrates animation layering, and supports real-time prefab lifecycle via Unity Addressables and Animancer.