TopDown Engine  v4.2
MoreMountains.TopDownEngine.ExplodudesWeapon Class Reference

This class handles the dropping of bombs by characters in the Explodudes demo scene More...

Inheritance diagram for MoreMountains.TopDownEngine.ExplodudesWeapon:
MoreMountains.TopDownEngine.Weapon MoreMountains.Tools.MMMonoBehaviour

Public Types

enum  GridSpawnMethods { GridSpawnMethods.NoGrid, GridSpawnMethods.LastCell, GridSpawnMethods.NextCell, GridSpawnMethods.Closest }
 The possible ways to spawn a bomb on the grid : More...
 
- Public Types inherited from MoreMountains.TopDownEngine.Weapon
enum  TriggerModes { TriggerModes.SemiAuto, TriggerModes.Auto }
 the possible use modes for the trigger (semi auto : the Player needs to release the trigger to fire again, auto : the Player can hold the trigger to fire repeatedly More...
 
enum  WeaponStates {
  WeaponStates.WeaponIdle, WeaponStates.WeaponStart, WeaponStates.WeaponDelayBeforeUse, WeaponStates.WeaponUse,
  WeaponStates.WeaponDelayBetweenUses, WeaponStates.WeaponStop, WeaponStates.WeaponReloadNeeded, WeaponStates.WeaponReloadStart,
  WeaponStates.WeaponReload, WeaponStates.WeaponReloadStop, WeaponStates.WeaponInterrupted
}
 the possible states the weapon can be in More...
 

Public Member Functions

override void Initialization ()
 On init we grab our pool and initialize our stuff More...
 
override void ShootRequest ()
 When the weapon is used, we spawn a bomb More...
 
- Public Member Functions inherited from MoreMountains.TopDownEngine.Weapon
virtual void InitializeComboWeapons ()
 Initializes the combo weapon, if it's one More...
 
virtual void SetOwner (Character newOwner, CharacterHandleWeapon handleWeapon)
 Sets the weapon's owner More...
 
virtual void WeaponInputStart ()
 Called by input, turns the weapon on More...
 
virtual void WeaponInputReleased ()
 Describes what happens when the weapon's input gets released More...
 
virtual void TurnWeaponOn ()
 Describes what happens when the weapon starts More...
 
virtual void CaseWeaponIdle ()
 If the weapon is idle, we reset the movement multiplier More...
 
virtual void CaseWeaponStart ()
 When the weapon starts we switch to a delay or shoot based on our weapon's settings More...
 
virtual void CaseWeaponDelayBeforeUse ()
 If we're in delay before use, we wait until our delay is passed and then request a shoot More...
 
virtual void CaseWeaponUse ()
 On weapon use we use our weapon then switch to delay between uses More...
 
virtual void CaseWeaponDelayBetweenUses ()
 When in delay between uses, we either turn our weapon off or make a shoot request More...
 
virtual void CaseWeaponStop ()
 On weapon stop, we switch to idle More...
 
virtual void CaseWeaponReloadNeeded ()
 If a reload is needed, we mention it and switch to idle More...
 
virtual void CaseWeaponReloadStart ()
 on reload start, we reload the weapon and switch to reload More...
 
virtual void CaseWeaponReload ()
 on reload, we reset our movement multiplier, and switch to reload stop once our reload delay has passed More...
 
virtual void CaseWeaponReloadStop ()
 on reload stop, we swtich to idle and load our ammo More...
 
virtual void CaseWeaponInterrupted ()
 on weapon interrupted, we turn our weapon off and switch back to idle More...
 
virtual void Interrupt ()
 Call this method to interrupt the weapon More...
 
virtual IEnumerator ShootRequestCo ()
 Determines whether or not the weapon can fire More...
 
virtual void WeaponUse ()
 When the weapon is used, plays the corresponding sound More...
 
virtual void WeaponInputStop ()
 Called by input, turns the weapon off if in auto mode More...
 
virtual void TurnWeaponOff ()
 Turns the weapon off. More...
 
virtual void ReloadNeeded ()
 Describes what happens when the weapon needs a reload More...
 
virtual void InitiateReloadWeapon ()
 Initiates a reload More...
 
virtual void FlipWeapon ()
 Flips the weapon. More...
 
virtual IEnumerator WeaponDestruction ()
 Destroys the weapon More...
 
virtual void ApplyOffset ()
 Applies the offset specified in the inspector More...
 
virtual void InitializeAnimatorParameters ()
 Adds required animator parameters to the animator parameters list if they exist More...
 
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(). More...
 

Public Attributes

GridSpawnMethods GridSpawnMethod
 the spawn method for this weapon More...
 
Vector3 BombOffset
 the offset to apply on spawn More...
 
int MaximumAmountOfBombsAtOnce = 3
 the max amount of bombs a character can drop on screen at once More...
 
float BombDelayBeforeExplosion = 3f
 the delay before the bomb explodes More...
 
int RemainingBombs = 0
 the amount of bombs remaining More...
 
- Public Attributes inherited from MoreMountains.TopDownEngine.Weapon
string WeaponName
 the name of the weapon, only used for debugging More...
 
bool WeaponCurrentlyActive = true
 whether or not the weapon is currently active More...
 
bool InputAuthorized = true
 if this is true, this weapon will be able to read input (usually via the CharacterHandleWeapon ability), otherwise player input will be disabled More...
 
TriggerModes TriggerMode = TriggerModes.Auto
 is this weapon on semi or full auto ? More...
 
float DelayBeforeUse = 0f
 the delay before use, that will be applied for every shot More...
 
bool DelayBeforeUseReleaseInterruption = true
 whether or not the delay before used can be interrupted by releasing the shoot button (if true, releasing the button will cancel the delayed shot) More...
 
float TimeBetweenUses = 1f
 the time (in seconds) between two shots
More...
 
bool TimeBetweenUsesReleaseInterruption = true
 whether or not the time between uses can be interrupted by releasing the shoot button (if true, releasing the button will cancel the time between uses) More...
 
bool UseBurstMode = false
 if this is true, the weapon will activate repeatedly for every shoot request More...
 
int BurstLength = 3
 the amount of 'shots' in a burst sequence More...
 
float BurstTimeBetweenShots = 0.1f
 the time between shots in a burst sequence (in seconds) More...
 
bool MagazineBased = false
 whether or not the weapon is magazine based. If it's not, it'll just take its ammo inside a global pool More...
 
int MagazineSize = 30
 the size of the magazine More...
 
bool AutoReload
 if this is true, pressing the fire button when a reload is needed will reload the weapon. Otherwise you'll need to press the reload button More...
 
bool NoInputReload = false
 if this is true, reload will automatically happen right after the last bullet is shot, without the need for input More...
 
float ReloadTime = 2f
 the time it takes to reload the weapon More...
 
int AmmoConsumedPerShot = 1
 the amount of ammo consumed everytime the weapon fires More...
 
bool AutoDestroyWhenEmpty
 if this is set to true, the weapon will auto destroy when there's no ammo left More...
 
float AutoDestroyWhenEmptyDelay = 1f
 the delay (in seconds) before weapon destruction if empty More...
 
bool PreventReloadIfAmmoEmpty = false
 if this is true, the weapon won't try and reload if the ammo is empty, when using WeaponAmmo More...
 
int CurrentAmmoLoaded = 0
 the current amount of ammo loaded inside the weapon More...
 
Vector3 WeaponAttachmentOffset = Vector3.zero
 an offset that will be applied to the weapon once attached to the center of the WeaponAttachment transform. More...
 
bool FlipWeaponOnCharacterFlip = true
 should that weapon be flipped when the character flips? More...
 
Vector3 RightFacingFlipValue = new Vector3(1, 1, 1)
 the FlipValue will be used to multiply the model's transform's localscale on flip. Usually it's -1,1,1, but feel free to change it to suit your model's specs More...
 
Vector3 LeftFacingFlipValue = new Vector3(-1, 1, 1)
 the FlipValue will be used to multiply the model's transform's localscale on flip. Usually it's -1,1,1, but feel free to change it to suit your model's specs More...
 
Transform WeaponUseTransform
 a transform to use as the spawn point for weapon use (if null, only offset will be considered, otherwise the transform without offset) More...
 
bool WeaponShouldFlip = true
 if this is true, the weapon will flip to match the character's orientation More...
 
Transform LeftHandHandle
 the transform to which the character's left hand should be attached to More...
 
Transform RightHandHandle
 the transform to which the character's right hand should be attached to More...
 
bool ModifyMovementWhileAttacking = false
 if this is true, a multiplier will be applied to movement while the weapon is active More...
 
float MovementMultiplier = 0f
 the multiplier to apply to movement while attacking More...
 
bool PreventAllMovementWhileInUse = false
 if this is true all movement will be prevented (even flip) while the weapon is active More...
 
bool PreventAllAimWhileInUse = false
 if this is true all aim will be prevented while the weapon is active More...
 
float RecoilForce = 0f
 the force to apply to push the character back when shooting - positive values will push the character back, negative values will launch it forward, turning that recoil into a thrust More...
 
List< Animator > Animators
 the other animators (other than the Character's) that you want to update every time this weapon gets used More...
 
bool PerformAnimatorSanityChecks = false
 If this is true, sanity checks will be performed to make sure animator parameters exist before updating them. Turning this to false will increase performance but will throw errors if you're trying to update non existing parameters. Make sure your animator has the required parameters. More...
 
bool MirrorCharacterAnimatorParameters = false
 if this is true, the weapon's animator(s) will mirror the animation parameter of the owner character (that way your weapon's animator will be able to "know" if the character is walking, jumping, etc) More...
 
int WeaponAnimationID = 0
 the ID of the weapon to pass to the animator More...
 
string IdleAnimationParameter
 the name of the weapon's idle animation parameter : this will be true all the time except when the weapon is being used More...
 
string StartAnimationParameter
 the name of the weapon's start animation parameter : true at the frame where the weapon starts being used More...
 
string DelayBeforeUseAnimationParameter
 the name of the weapon's delay before use animation parameter : true when the weapon has been activated but hasn't been used yet More...
 
string SingleUseAnimationParameter
 the name of the weapon's single use animation parameter : true at each frame the weapon activates (shoots) More...
 
string UseAnimationParameter
 the name of the weapon's in use animation parameter : true at each frame the weapon has started firing but hasn't stopped yet More...
 
string DelayBetweenUsesAnimationParameter
 the name of the weapon's delay between each use animation parameter : true when the weapon is in use More...
 
string StopAnimationParameter
 the name of the weapon stop animation parameter : true after a shot and before the next one or the weapon's stop More...
 
string ReloadStartAnimationParameter
 the name of the weapon reload start animation parameter More...
 
string ReloadAnimationParameter
 the name of the weapon reload animation parameter More...
 
string ReloadStopAnimationParameter
 the name of the weapon reload end animation parameter More...
 
string WeaponAngleAnimationParameter
 the name of the weapon's angle animation parameter More...
 
string WeaponAngleRelativeAnimationParameter
 the name of the weapon's angle animation parameter, adjusted so it's always relative to the direction the character is currently facing More...
 
string EquippedAnimationParameter
 the name of the parameter to send to true as long as this weapon is equipped, used or not. While all the other parameters defined here are updated by the Weapon class itself, and passed to the weapon and character, this one will be updated by CharacterHandleWeapon only." More...
 
string InterruptedAnimationParameter
 the name of the parameter to send to true when the weapon gets interrupted. While all the other parameters defined here are updated by the Weapon class itself, and passed to the weapon and character, this one will be updated by CharacterHandleWeapon only." More...
 
MMFeedbacks WeaponStartMMFeedback
 the feedback to play when the weapon starts being used More...
 
MMFeedbacks WeaponUsedMMFeedback
 the feedback to play while the weapon is in use More...
 
MMFeedbacks WeaponUsedMMFeedbackAlt
 if set, this feedback will be used randomly instead of WeaponUsedMMFeedback More...
 
MMFeedbacks WeaponStopMMFeedback
 the feedback to play when the weapon stops being used More...
 
MMFeedbacks WeaponReloadMMFeedback
 the feedback to play when the weapon gets reloaded More...
 
MMFeedbacks WeaponReloadNeededMMFeedback
 the feedback to play when the weapon gets reloaded More...
 
MMFeedbacks WeaponReloadImpossibleMMFeedback
 the feedback to play when the weapon can't reload as there's no more ammo available. You'll need PreventReloadIfAmmoEmpty to be true for this to work More...
 
bool InitializeOnStart = false
 If this is true, the weapon will initialize itself on start, otherwise it'll have to be init manually, usually by the CharacterHandleWeapon class. More...
 
bool Interruptable = false
 whether or not this weapon can be interrupted More...
 
bool Flipped
 if true, the weapon is flipped More...
 
MMStateMachine< WeaponStatesWeaponState
 the weapon's state machine More...
 

Protected Member Functions

override void Update ()
 On update we store our movement position More...
 
virtual void SpawnBomb ()
 Spawns a bomb More...
 
virtual void DetermineBombSpawnPosition ()
 Determines where the bomb should be spawned based on the inspector settings More...
 
virtual IEnumerator AddOneRemainingBombCoroutine ()
 Adds back another bomb to use after it explodes More...
 
- Protected Member Functions inherited from MoreMountains.TopDownEngine.Weapon
virtual void Start ()
 On start we initialize our weapon More...
 
virtual void InitializeFeedbacks ()
 
virtual void LateUpdate ()
 On LateUpdate, processes the weapon state More...
 
virtual void ProcessWeaponState ()
 Called every lastUpdate, processes the weapon's state machine More...
 
virtual void ApplyRecoil ()
 Applies recoil if necessary More...
 
virtual void ResetMovementMultiplier ()
 
virtual void ReloadWeapon ()
 Reloads the weapon More...
 
virtual void TriggerWeaponStartFeedback ()
 Plays the weapon's start sound More...
 
virtual void TriggerWeaponUsedFeedback ()
 Plays the weapon's used sound More...
 
virtual void TriggerWeaponStopFeedback ()
 Plays the weapon's stop sound More...
 
virtual void TriggerWeaponReloadNeededFeedback ()
 Plays the weapon's reload needed sound More...
 
virtual void TriggerWeaponReloadFeedback ()
 Plays the weapon's reload sound More...
 
virtual void AddParametersToAnimator (Animator animator, HashSet< int > list)
 
virtual void UpdateAnimator (Animator animator, HashSet< int > list)
 

Protected Attributes

MMSimpleObjectPooler _objectPool
 
Vector3 _newSpawnWorldPosition
 
bool _alreadyBombed = false
 
Vector3 _lastBombPosition
 
ExplodudesBomb _bomb
 
WaitForSeconds _addOneRemainingBomb
 
Vector3 _closestLast
 
Vector3 _closestNext
 
Vector3Int _cellPosition
 
Vector3 _positionLastFrame
 
bool _hasntMoved = false
 
- Protected Attributes inherited from MoreMountains.TopDownEngine.Weapon
SpriteRenderer _spriteRenderer
 
WeaponAim _weaponAim
 
float _movementMultiplierStorage = 1f
 
Animator _ownerAnimator
 
WeaponPreventShooting _weaponPreventShooting
 
float _delayBeforeUseCounter = 0f
 
float _delayBetweenUsesCounter = 0f
 
float _reloadingCounter = 0f
 
bool _triggerReleased = false
 
bool _reloading = false
 
ComboWeapon _comboWeapon
 
TopDownController _controller
 
CharacterMovement _characterMovement
 
Vector3 _weaponOffset
 
Vector3 _weaponAttachmentOffset
 
Transform _weaponAttachment
 
List< HashSet< int > > _animatorParameters
 
HashSet< int > _ownerAnimatorParameters
 
bool _controllerIs3D = false
 
int _idleAnimationParameter
 
int _startAnimationParameter
 
int _delayBeforeUseAnimationParameter
 
int _singleUseAnimationParameter
 
int _useAnimationParameter
 
int _delayBetweenUsesAnimationParameter
 
int _stopAnimationParameter
 
int _reloadStartAnimationParameter
 
int _reloadAnimationParameter
 
int _reloadStopAnimationParameter
 
int _weaponAngleAnimationParameter
 
int _weaponAngleRelativeAnimationParameter
 
int _aliveAnimationParameter
 
int _comboInProgressAnimationParameter
 
int _equippedAnimationParameter
 
int _interruptedAnimationParameter
 
float _lastShootRequestAt = -float.MaxValue
 
float _lastTurnWeaponOnAt = -float.MaxValue
 
bool _movementSpeedMultiplierSet = false
 

Additional Inherited Members

- Static Protected Attributes inherited from MoreMountains.TopDownEngine.Weapon
const string _aliveAnimationParameterName = "Alive"
 
- Properties inherited from MoreMountains.TopDownEngine.Weapon
virtual string WeaponID [get, set]
 the name of the inventory item corresponding to this weapon. Automatically set (if needed) by InventoryEngineWeapon More...
 
virtual Character Owner [get, protected set]
 the weapon's owner More...
 
virtual CharacterHandleWeapon CharacterHandleWeapon [get, set]
 the weapon's owner's CharacterHandleWeapon component More...
 
virtual WeaponAmmo WeaponAmmo [get, protected set]
 the WeaponAmmo component optionnally associated to this weapon More...
 
float MovementMultiplierStorage [get, set]
 
bool IsComboWeapon [get, set]
 
bool IsAutoComboWeapon [get, set]
 

Detailed Description

This class handles the dropping of bombs by characters in the Explodudes demo scene

Member Enumeration Documentation

◆ GridSpawnMethods

The possible ways to spawn a bomb on the grid :

  • no grid : at the world position of the weapon
  • last cell : the last cell the owner of the weapon passed by
  • next cell : the cell the owner of the weapon is moving to
  • closest : will pick the cell closest to the movement right now
Enumerator
NoGrid 
LastCell 
NextCell 
Closest 

Member Function Documentation

◆ AddOneRemainingBombCoroutine()

virtual IEnumerator MoreMountains.TopDownEngine.ExplodudesWeapon.AddOneRemainingBombCoroutine ( )
protectedvirtual

Adds back another bomb to use after it explodes

Returns

◆ DetermineBombSpawnPosition()

virtual void MoreMountains.TopDownEngine.ExplodudesWeapon.DetermineBombSpawnPosition ( )
protectedvirtual

Determines where the bomb should be spawned based on the inspector settings

◆ Initialization()

override void MoreMountains.TopDownEngine.ExplodudesWeapon.Initialization ( )
virtual

On init we grab our pool and initialize our stuff

Reimplemented from MoreMountains.TopDownEngine.Weapon.

◆ ShootRequest()

override void MoreMountains.TopDownEngine.ExplodudesWeapon.ShootRequest ( )
virtual

When the weapon is used, we spawn a bomb

Reimplemented from MoreMountains.TopDownEngine.Weapon.

◆ SpawnBomb()

virtual void MoreMountains.TopDownEngine.ExplodudesWeapon.SpawnBomb ( )
protectedvirtual

Spawns a bomb

◆ Update()

override void MoreMountains.TopDownEngine.ExplodudesWeapon.Update ( )
protectedvirtual

On update we store our movement position

Reimplemented from MoreMountains.TopDownEngine.Weapon.

Member Data Documentation

◆ _addOneRemainingBomb

WaitForSeconds MoreMountains.TopDownEngine.ExplodudesWeapon._addOneRemainingBomb
protected

◆ _alreadyBombed

bool MoreMountains.TopDownEngine.ExplodudesWeapon._alreadyBombed = false
protected

◆ _bomb

ExplodudesBomb MoreMountains.TopDownEngine.ExplodudesWeapon._bomb
protected

◆ _cellPosition

Vector3Int MoreMountains.TopDownEngine.ExplodudesWeapon._cellPosition
protected

◆ _closestLast

Vector3 MoreMountains.TopDownEngine.ExplodudesWeapon._closestLast
protected

◆ _closestNext

Vector3 MoreMountains.TopDownEngine.ExplodudesWeapon._closestNext
protected

◆ _hasntMoved

bool MoreMountains.TopDownEngine.ExplodudesWeapon._hasntMoved = false
protected

◆ _lastBombPosition

Vector3 MoreMountains.TopDownEngine.ExplodudesWeapon._lastBombPosition
protected

◆ _newSpawnWorldPosition

Vector3 MoreMountains.TopDownEngine.ExplodudesWeapon._newSpawnWorldPosition
protected

◆ _objectPool

MMSimpleObjectPooler MoreMountains.TopDownEngine.ExplodudesWeapon._objectPool
protected

◆ _positionLastFrame

Vector3 MoreMountains.TopDownEngine.ExplodudesWeapon._positionLastFrame
protected

◆ BombDelayBeforeExplosion

float MoreMountains.TopDownEngine.ExplodudesWeapon.BombDelayBeforeExplosion = 3f

the delay before the bomb explodes

◆ BombOffset

Vector3 MoreMountains.TopDownEngine.ExplodudesWeapon.BombOffset

the offset to apply on spawn

◆ GridSpawnMethod

GridSpawnMethods MoreMountains.TopDownEngine.ExplodudesWeapon.GridSpawnMethod

the spawn method for this weapon

◆ MaximumAmountOfBombsAtOnce

int MoreMountains.TopDownEngine.ExplodudesWeapon.MaximumAmountOfBombsAtOnce = 3

the max amount of bombs a character can drop on screen at once

◆ RemainingBombs

int MoreMountains.TopDownEngine.ExplodudesWeapon.RemainingBombs = 0

the amount of bombs remaining


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