TouchAttackMelee(object, int)

From NWN Lexicon
Revision as of 01:59, 14 March 2021 by Jasperre (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Performs a touch melee attack out of turn.

int TouchAttackMelee(
    object oTarget,
    int bDisplayFeedback = TRUE


The target of the touch melee attack.
Display graphical feedback on the attack. (Default: TRUE)


The caller will perform a melee touch attack on oTarget. This is not an action, and it assumes the caller is already within range of oTarget.

Returns 0 on a miss, 1 on a hit, and 2 on a critical hit.


No combat animations are performed, and no damage is dealt. It simply does a roll to see if the target is hit, and if bDisplayFeedback is TRUE, displays feedback in the combat feedback window.

The attackers melee touch attacks are based on:

  • BAB + strength modifier (only if positive) + nature sense + epic prowess (unless a ranged weapon is equipped) + unarmed weapon focus feats (if unarmed or using a creature weapon) + effects

A touch attack denies the defender their armor and shield AC (base and bonus), as well as their natural armor bonus to AC. All other armor class modifiers, such as the size modifier, dexterity modifier, and deflection/dodge bonus apply (or don't apply, e.g. if flat-footed) normally. Consequentially, touch attacks sometimes have a significantly better chance of hitting than regular attacks.


This function was updated in 1.83.8193.21 of NWN:EE. It made it so weapon attack bonuses are not added to touch attacks, for instance arming yourself with a +5 Longsword will not add 5 to the attack rolls of this function anymore.

See Also



 author: Charles Feduke, editor: Lilac Soul