useWeaponOnCell

useWeaponOnCell

> Functions

Uses the equipped weapon on the cell cell.

Example: using the pistol on the nearest enemy:

Parameters

• cell: The target cell.

Return

• result: A value strictly greater than 0 if the attack was launched. The return values of useWeaponOnCell are:
• USE_CRITICAL, on a critical hit
• USE_SUCCESS, on success
• USE_FAILED, on failure
• USE_INVALID_TARGET, if the target does not exist
• USE_NOT_ENOUGH_TP, if your entity does not have enough TP
• USE_INVALID_POSITION, if the range is wrong or the line of sight is not clear

Since USE_SUCCESS and USE_CRITICAL are 1 and 2 respectively, and the other values are 0 or negative, you can tell whether the weapon was used successfully with this test:

See also

• setWeapon: equips a weapon.
• useWeapon: use a weapon on an entity instead of a cell.
• getCellToUseWeapon: finds a cell from which to use a weapon.
• useChip: use a chip.