LuaDocs/AHuman

From Data Realms Wiki

Contents 1 Parent: Actor 2 Enumerations 2.1 UpperBodyState 2.2 MovementState 2.3 ProneState 2.4 Layer 2.5 DeviceHandlingState 2.6 SweepState 2.7 DigState 2.8 JumpState 3 Properties 3.1 ClassName 3.2 Head 3.3 FGArm 3.4 BGArm 3.5 FGLeg 3.6 BGLeg 3.7 Jetpack 3.8 JetTimeTotal 3.9 JetTimeLeft 3.10 EquippedItem 3.11 FirearmIsReady 3.12 ThrowableIsReady 3.13 FirearmIsEmpty 3.14 FirearmNeedsReload 3.15 FirearmIsSemiAuto 3.16 FirearmActivationDelay 4 Functions 4.1 EquipFirearm 4.2 EquipThrowable 4.3 EquipDiggingTool 4.4 EquipShield 4.5 EquipShieldInBGArm 4.6 EquipDeviceInGroup 4.7 EquipNamedDevice 4.8 EquipLoadedFirearmInGroup 4.9 UnequipBGArm 4.10 ReloadFirearm 4.11 IsWithinRange 4.12 Look 4.13 LookForGold 4.14 LookForMOs 4.15 IsOnScenePoint

Parent: Actor

Concrete Class. A humanoid actor.

Go back to Class Index

Enumerations

UpperBodyState

• 0 = WEAPON_READY
• 1 = AIMING_SHARP
• 2 = HOLSTERING_BACK
• 3 = HOLSTERING_BELT
• 4 = DEHOLSTERING_BACK
• 5 = DEHOLSTERING_BELT
• 6 = THROWING_PREP
• 7 = THROWING_RELEASE

MovementState

• 0 = NOMOVE
• 1 = STAND
• 2 = WALK
• 3 = CROUCH
• 4 = CRAWL
• 5 = ARMCRAWL
• 6 = CLIMB
• 7 = JUMP
• 8 = DISLODGE
• 9 = MOMENTSTATECOUNT

ProneState

• 0 = NOTPRONE
• 1 = GOPRONE
• 2 = PRONE
• 3 = PRONESTATECOUNT

Layer

• 0 = FGROUND
• 1 = BGROUND

DeviceHandlingState

• 0 = STILL
• 1 = POINTING
• 2 = SCANNING
• 3 = AIMING
• 4 = FIRING
• 5 = THROWING
• 6 = DIGGING

SweepState

• 0 = NOSWEEP
• 1 = SWEEPINGUP
• 2 = SWEEPINGPAUSE
• 3 = SWEEPINGDOWN
• 4 = SWEEMDOWNPAUSE

DigState

• 0 = NOTDIGGING
• 1 = PREDIG
• 2 = STARTDIG
• 3 = TUNNELING
• 4 = FINISHINGDIG
• 5 = PAUSEDIGGER

JumpState

• 0 = NOTJUMPING
• 1 = FORWARDJUMP
• 2 = PREJUMP
• 3 = UPJUMP
• 4 = APEXJUMP
• 5 = LANDJUMP

Properties

ClassName

The class name of this Entity.A string with the friendly-formatted type name of this object.

Head

Read-only property. The head AttachableA pointer to the head Attachable of this. Ownership is NOT transferred!

FGArm

Read-only property. The FG Arm as an Attachable. This is for Lua binding mostly.A pointer to the FG Arm Attachable of this. Ownership is NOT transferred!

BGArm

Read-only property. The BG Arm as an Attachable. This is for Lua binding mostly.A pointer to the BG Arm Attachable of this. Ownership is NOT transferred!

FGLeg

Read-only property. The FG Leg as an Attachable. This is for Lua binding mostly.A pointer to the FG Leg Attachable of this. Ownership is NOT transferred!

BGLeg

Read-only property. The BG Leg as an Attachable. This is for Lua binding mostly.A pointer to the BG Leg Attachable of this. Ownership is NOT transferred!

Jetpack

Read-only property. The jetpack as an emitter. This is for Lua binding mostly.A pointer to jetpack emitter. Ownership is NOT transferred!

JetTimeTotal

The amount of time this' jetpack can fire when filled, in ms.The amount of time this' jetpack can fire when it's at max.

JetTimeLeft

The amount of time this' jetpack can still fire until out, in ms.The amount of time this' jetpack can still fire before running out.

EquippedItem

Read-only property. Returns whatever is equipped in the FG Arm, if anything. OINT.The currently equipped item, if any.

FirearmIsReady

Read-only property. Indicates whether the currently held HDFirearm's is ready for use, and has ammo etc.Whether a currently HDFirearm (if any) is ready for use.

ThrowableIsReady

Read-only property. Indicates whether the currently held ThrownDevice's is ready to go.Whether a currently held ThrownDevice (if any) is ready for use.

FirearmIsEmpty

Read-only property. Indicates whether the currently held HDFirearm's is out of ammo.Whether a currently HDFirearm (if any) is out of ammo.

FirearmNeedsReload

Read-only property. Indicates whether the currently held HDFirearm's is almost out of ammo.Whether a currently HDFirearm (if any) has less than half of ammo left.

FirearmIsSemiAuto

Read-only property. Indicates whether the currently held HDFirearm's is semi or full auto.Whether a currently HDFirearm (if any) is a semi auto device.

FirearmActivationDelay

Read-only property. Returns the currently held device's delay between pulling the trigger and activating.Delay in ms or zero if not a HDFirearm.

Functions

EquipFirearm

Switches the currently held device (if any) to the first found firearm in the inventory. If the held device already is a firearm, or no firearm is in inventory, nothing happens.

Arguments:

• Whether to actually equip any matching item found in the inventory, or just report that it's there or not.

Return value:

Whether a firearm was successfully switched to, or already held.

EquipThrowable

Switches the currently held device (if any) to the first found ThrownDevice in the inventory. If the held device already is a ThrownDevice, or no ThrownDevice is in inventory, nothing happens.

Arguments:

• Whether to actually equip any matching item found in the inventory, or just report that it's there or not.

Return value:

Whether a ThrownDevice was successfully switched to, or already held.

EquipDiggingTool

Switches the currently held device (if any) to the first found digging tool in the inventory. If the held device already is a digging tool, or no digging tool is in inventory, nothing happens.

Arguments:

• Whether to actually equip any matching item found in the inventory, or just report that it's there or not.

Return value:

Whether a digging tool was successfully switched to.

EquipShield

Switches the currently held device (if any) to the first found shield in the inventory. If the held device already is a shield, or no shield is in inventory, nothing happens.

Arguments:

• None.

Return value:

Whether a shield was successfully switched to, or already held.

EquipShieldInBGArm

Tries to equip the first shield in inventory to the background arm; this only works if nothing is held at all, or the FG arm holds a one-handed device, or we're in inventory mode.

Arguments:

• None.

Return value:

Whether a shield was successfully equipped in the background arm.

EquipDeviceInGroup

Switches the currently held device (if any) to the first found device of the specified group in the inventory. If the held device already is of that group, or no device is in inventory, nothing happens.

Arguments:

• The group the device must belong to.
• Whether to actually equip any matching item found in the inventory, or just report that it's there or not.

Return value:

Whether a firearm was successfully switched to, or already held.

EquipNamedDevice

Switches the currently held device (if any) to the first found device of with the specified preset name in the inventory. If the held device already is of that preset name, or no device is in inventory, nothing happens.

Arguments:

• The preset name the device must have.
• Whether to actually equip any matching item found in the inventory, or just report that it's there or not.

Return value:

Whether a device was successfully switched to, or already held.

EquipLoadedFirearmInGroup

Switches the currently held device (if any) to the first loaded HDFirearm of the specified group in the inventory. If no such weapon is in the inventory, nothing happens.

Arguments:

• The group the HDFirearm must belong to. "Any" for all groups.
• The group the HDFirearm must *not* belong to. "None" for no group.
• Whether to actually equip any matching item found in the inventory, or just report that it's there or not.

Return value:

Whether a firearm was successfully switched to, or already held.

UnequipBGArm

Unequips whatever is in the BG arm and puts it into the inventory.

Arguments:

• None.

Return value:

Whether there was anything to unequip.

ReloadFirearm

Reloads the currently held firearm, if any.

Arguments:

• None.

Return value:

None.

IsWithinRange

Tells whether a point on the scene is within close range of the currently used device and aiming status, if applicable.

Arguments:

• A Vector with the aboslute coordinates of a point to check.

Return value:

Whether the point is within close range of this.

Look

Casts an unseen-revealing ray in the direction of where this is facing.

Arguments:

• The degree angle to deviate from the current view point in the ray casting. A random ray will be chosen out of this +-range.
• The range, in pixels, beyond the actors sharp aim that the ray will have.

Return value:

Whether any unseen pixels were revealed by this look.

LookForGold

Casts a material detecting ray in the direction of where this is facing.

Arguments:

• The degree angle to deviate from the current view point in the ray casting. A random ray will be chosen out of this +-range.
• The range, in pixels, that the ray will have.
• A Vector which will be filled with the absolute coordinates of any found gold. It will be unaltered if false is returned.

Return value:

Whether gold was spotted by this ray cast. If so, foundLocation has been filled out with the absolute location of the gold.

LookForMOs

Casts an MO detecting ray in the direction of where the head is looking at the time. Factors including head rotation, sharp aim mode, and other variables determine how this ray is cast.

Arguments:

• The degree angle to deviate from the current view point in the ray casting. A random ray will be chosen out of this +-range.
• A specific material ID to ignore (see through)
• Whether to ignore all terrain or not (true means 'x-ray vision').

Return value:

A pointer to the MO seen while looking.

IsOnScenePoint

Indicates whether this' current graphical representation overlaps a point in absolute scene coordinates.

Arguments:

• The point in absolute scene coordinates.

Return value:

Whether this' graphical rep overlaps the scene point.

Go back to Class Index