Ultimate Character Controller

by Opsive

RememberUltimateCharacterController is a Crystal Save component that captures and restores key aspects of an Opsive Ultimate Character Controller: equipment, position, view mode, input sensitivity, and attribute values. It plugs into the Crystal Save system as a SaveableComponent and is usually managed through a Remember Component (RememberComposite) wrapper.

---

Setup

1. Add the Remember Component

   • Select the character GameObject that owns UltimateCharacterLocomotion.

   • Add Remember Component (RememberComposite) via Add Component → Crystal Save/Remember Components/Remember Component.

   • In the Remember Component’s list, add Remember Ultimate Character Controller.

2. Behind the scenes

   • RememberComposite keeps a designer-controlled list of hidden SaveableComponent instances so their IDs persist across reloads

3. Result

   • A hidden RememberUltimateCharacterController component is created and registered with the Save system, automatically bound to UltimateCharacterLocomotion thanks to [RequireComponent] and [RememberTarget] attributes.

4. Demo Scene

   • UCC Crystal Save Demo scene requires import of official Ultimate Character Controller Demo Scene. Import it via Package Manager.

---

Configuration Options

The component exposes five toggles, letting designers choose which aspects of the character to persist:

Option	Saved Data
Remember Equipment	Inventory contents, active slots, ammo counts, and clip state
Remember Position	Per-scene position and rotation
Remember View Mode	Whether the camera was in first- or third-person view
Remember Input Sensitivity	Look sensitivity, smoothing, and acceleration thresholds
Remember Attributes	Attribute values and min/max limits from AttributeManager

All selections are serialized into a CharacterSnapshot structure for storage and later reconstruction.

---

Save/Load Flow

1. Serialization – When a save occurs, the component builds a CharacterSnapshot with the enabled data and hands it to the SaveManager.

2. Deserialization – On load, the snapshot is restored, reapplying gear, location, camera view, input settings, and attributes.

---

Summary

• Works with Opsive’s UCC by default and requires UltimateCharacterLocomotion.

• Deployed via RememberComposite to maintain stable save IDs.

• Individual toggles let you decide exactly which parts of the character state persist between sessions.