MoreMountains.CorgiEngine.CharacterPersistence Class Reference

Add this component to a Character and it'll persist with its exact current state when transitioning to a new scene. It'll be automatically passed to the new scene's LevelManager to be used as this scene's main character. It'll keep the exact state all its components are in at the moment they finish the level. Its health, enabled abilities, component values, equipped weapons, new components you may have added, etc, will all remain once in the new scene. Animator parameters : None. More...

Inheritance diagram for MoreMountains.CorgiEngine.CharacterPersistence:

Public Member Functions
virtual void	OnMMEvent (MMGameEvent gameEvent)
	When we get a save request, we store our character in the game manager for future use.
virtual void	OnMMEvent (CorgiEngineEvent engineEvent)
	When we get a Corgi Engine event, we act on it.
virtual void	ClearSavedCharacter ()
	Clears any saved character that may have been stored in the GameManager.
Public Member Functions inherited from MoreMountains.CorgiEngine.CharacterAbility
virtual string	HelpBoxText ()
	This method is only used to display a helpbox text at the beginning of the ability's inspector.
virtual void	SetInputManager (InputManager inputManager)
	Sets a new input manager for this ability to get input from.
virtual void	BindAnimator ()
	Binds the animator from the character and initializes the animator parameters.
virtual void	ResetInput ()
	Resets all input for this ability. Can be overridden for ability specific directives.
virtual void	EarlyProcessAbility ()
	The first of the 3 passes you can have in your ability. Think of it as EarlyUpdate() if it existed.
virtual void	ProcessAbility ()
	The second of the 3 passes you can have in your ability. Think of it as Update()
virtual void	LateProcessAbility ()
	The last of the 3 passes you can have in your ability. Think of it as LateUpdate()
virtual void	UpdateAnimator ()
	Override this to send parameters to the character's animator. This is called once per cycle, by the Character class, after Early, normal and Late process().
virtual void	PermitAbility (bool abilityPermitted)
	Changes the status of the ability's permission.
virtual void	Flip ()
	Override this to specify what should happen in this ability when the character flips.
virtual void	ResetAbility ()
	Override this to reset this ability's parameters. It'll be automatically called when the character gets killed, in anticipation for its respawn.
virtual void	PlayAbilityStartFeedbacks ()
	Plays the ability start feedback.
virtual void	StopStartFeedbacks ()
	Stops the ability used feedback.
virtual void	PlayAbilityStopFeedbacks ()
	Plays the ability stop feedback.
virtual void	RegisterAnimatorParameter (string parameterName, AnimatorControllerParameterType parameterType, out int parameter)
	Registers a new animator parameter to the list.
Public Member Functions inherited from MoreMountains.Tools.MMEventListener< T >
void	OnMMEvent (T eventType)

Protected Member Functions
override void	Initialization ()
	On Start(), we prevent our character from being destroyed if needed.
override void	OnDeath ()
	Override this to describe what should happen to this ability when the character respawns.
virtual void	SaveCharacter ()
	Saves to the game manager a reference to our character.
override void	OnEnable ()
	On enable we start listening for events.
virtual void	OnDestroy ()
	On disable we stop listening for events.
Protected Member Functions inherited from MoreMountains.CorgiEngine.CharacterAbility
virtual void	Start ()
	On Start(), we call the ability's intialization.
virtual void	InitializeAnimatorParameters ()
	Adds required animator parameters to the animator parameters list if they exist.
virtual void	InternalHandleInput ()
	Internal method to check if an input manager is present or not.
virtual void	HandleInput ()
	Called at the very start of the ability's cycle, and intended to be overridden, looks for input and calls methods if conditions are met.
virtual void	OnRespawn ()
	Override this to describe what should happen to this ability when the character respawns.
virtual void	OnHit ()
	Override this to describe what should happen to this ability when the character takes a hit.
virtual void	OnDisable ()
	On disable, we unbind our respawn delegate.

Properties
bool	Initialized [get, set]
Properties inherited from MoreMountains.CorgiEngine.CharacterAbility
virtual bool	AbilityAuthorized [get]
virtual bool	AbilityInitialized [get]
	true if the ability has already been initialized

Additional Inherited Members
Public Attributes inherited from MoreMountains.CorgiEngine.CharacterAbility
MMFeedbacks	AbilityStartFeedbacks
	the feedbacks to play when the ability starts
MMFeedbacks	AbilityStopFeedbacks
	the feedbacks to play when the ability stops
bool	AbilityPermitted = true
	if true, this ability can perform as usual, if not, it'll be ignored. You can use this to unlock abilities over time for example
CharacterStates.MovementStates[]	BlockingMovementStates
	an array containing all the blocking movement states. If the Character is in one of these states and tries to trigger this ability, it won't be permitted. Useful to prevent this ability from being used while Idle or Swimming, for example.
CharacterStates.CharacterConditions[]	BlockingConditionStates
	an array containing all the blocking condition states. If the Character is in one of these states and tries to trigger this ability, it won't be permitted. Useful to prevent this ability from being used while dead, for example.
Weapon.WeaponStates[]	BlockingWeaponStates
	an array containing all the blocking weapon states. If one of the character's weapons is in one of these states and yet the character tries to trigger this ability, it won't be permitted. Useful to prevent this ability from being used while attacking, for example.
Protected Attributes inherited from MoreMountains.CorgiEngine.CharacterAbility
Character	_character
Transform	_characterTransform
Health	_health
CharacterHorizontalMovement	_characterHorizontalMovement
CorgiController	_controller
InputManager	_inputManager
CameraController	_sceneCamera
Animator	_animator
CharacterStates	_state
MMStateMachine< CharacterStates.MovementStates >	_movement
MMStateMachine< CharacterStates.CharacterConditions >	_condition
bool	_abilityInitialized = false
CharacterGravity	_characterGravity
float	_verticalInput
float	_horizontalInput
bool	_startFeedbackIsPlaying = false
List< CharacterHandleWeapon >	_handleWeaponList

Detailed Description

Add this component to a Character and it'll persist with its exact current state when transitioning to a new scene. It'll be automatically passed to the new scene's LevelManager to be used as this scene's main character. It'll keep the exact state all its components are in at the moment they finish the level. Its health, enabled abilities, component values, equipped weapons, new components you may have added, etc, will all remain once in the new scene. Animator parameters : None.

Member Function Documentation

ClearSavedCharacter()

virtual void MoreMountains.CorgiEngine.CharacterPersistence.ClearSavedCharacter ( )

virtual

Clears any saved character that may have been stored in the GameManager.

Initialization()

override void MoreMountains.CorgiEngine.CharacterPersistence.Initialization ( )

protectedvirtual

On Start(), we prevent our character from being destroyed if needed.

Reimplemented from MoreMountains.CorgiEngine.CharacterAbility.

OnDeath()

override void MoreMountains.CorgiEngine.CharacterPersistence.OnDeath ( )

protectedvirtual

Override this to describe what should happen to this ability when the character respawns.

Reimplemented from MoreMountains.CorgiEngine.CharacterAbility.

OnDestroy()

virtual void MoreMountains.CorgiEngine.CharacterPersistence.OnDestroy ( )

protectedvirtual

On disable we stop listening for events.

OnEnable()

override void MoreMountains.CorgiEngine.CharacterPersistence.OnEnable ( )

protectedvirtual

On enable we start listening for events.

Reimplemented from MoreMountains.CorgiEngine.CharacterAbility.

OnMMEvent() [1/2]

virtual void MoreMountains.CorgiEngine.CharacterPersistence.OnMMEvent ( CorgiEngineEvent engineEvent )

virtual

When we get a Corgi Engine event, we act on it.

Parameters

gameEvent

OnMMEvent() [2/2]

virtual void MoreMountains.CorgiEngine.CharacterPersistence.OnMMEvent ( MMGameEvent gameEvent )

virtual

When we get a save request, we store our character in the game manager for future use.

Parameters

gameEvent

SaveCharacter()

virtual void MoreMountains.CorgiEngine.CharacterPersistence.SaveCharacter ( )

protectedvirtual

Saves to the game manager a reference to our character.

Property Documentation

Initialized

bool MoreMountains.CorgiEngine.CharacterPersistence.Initialized

getset

---

The documentation for this class was generated from the following file:

• Assets/CorgiEngine/Common/Scripts/Agents/CharacterAbilities/CharacterPersistence.cs