BG(2)EE Identifiers

Objects can be split broadly into three categories; static objects, marked objects and object specifiers. Static objects (e.g. Player1, Myself) are always bound (and in fact, they always return the same creature). Marked objects (e.g. LastSeenBy, LastAttackerOf) are almost always bound. Object specifiers (e.g. [ENEMY.0.0.MAGE] are not bound — they are checked every time they are referenced. Objects listed in object.ids are marked objects and are not saved over game sessions.

Note:

Group objects are determined by the specifics value set in the creature file.
Nearest() identifiers cascade outwards, i.e. if there are only three valid creatures, FourthNearest() and above will return the third nearest creature (rather than false).

IDS V1.0

0 Nothing

1 Myself

Returns the active creature.

2 LeaderOf

3 GroupOf

4 WeakestOf

Returns the weakest player character (in the party).

5 StrongestOf

Returns the strongest player character (in the party).

6 MostDamagedOf

Returns the most damaged player character (in the party).

7 LeastDamagedOf

Returns the least damaged player character (in the party).

8 ProtectedBy

9 ProtectorOf

10 LastAttackerOf

Returns the creature that last inflicted physical damage on the active creature.

11 LastTargetedBy

12 NearestEnemyOf

Returns the nearest creature of opposite allegiance.

13 LastCommandedBy

14 Nearest

Returns the nearest visible creature — usually the active creature.

15 LastHitter

16 LastHelp

17 LastTrigger

Returns the last creature that activated the active trigger region.

18 LastSeenBy

Set by See() and Detect(), not by Exists() or Range().

19 LastTalkedToBy

Returns the last creature that has been targeted by StartDialogue() or similar actions.

20 LastHeardBy

Returns the last creature that triggered a Help() or Shout() action.

21 Player1

Assigned to party members in their join order, lowest first. If a member leaves the party, the associated object will be invalid until a new member joins or the game is reloaded (when the list gets compacted).
Use the Player1Fill family of objects if you want to avoid any gaps.

Synonymous with Player1.

28 StrongestOfMale

Returns the strongest male player character (in the party).

29 SecondNearestEnemyOf

30 ThirdNearestEnemyOf

31 FourthNearestEnemyOf

32 FifthNearestEnemyOf

33 SixthNearestEnemyOf

34 SeventhNearestEnemyOf

35 EighthNearestEnemyOf

36 NinthNearestEnemyOf

37 TenthNearestEnemyOf

Returns the player character (in the party) with the highest AC.

48 BestAC

Returns the player character (in the party) with the lowest AC.

49 LastSummonerOf

Returns the character who summoned the active creature.

50 NearestEnemyOfType

It auto-populates the EA field of the object selector and immediately evaluates it, so it's useless to define the EA manually.

51 SecondNearestEnemyOfType

52 ThirdNearestEnemyOfType

53 FourthNearestEnemyOfType

54 FifthNearestEnemyOfType

55 SixthNearestEnemyOfType

56 SeventhNearestEnemyOfType

57 EigthNearestEnemyOfType

57 EighthNearestEnemyOfType

58 NinthNearestEnemyOfType

59 TenthNearestEnemyOfType

60 NearestMyGroupOfType

It auto-populates the SPECIFIC field of the object selector and immediately evaluates it, so it's useless to define the SPECIFIC manually.

61 SecondNearestMyGroupOfType

62 ThirdNearestMyGroupOfType

63 FourthNearestMyGroupOfType

64 FifthNearestMyGroupOfType

65 SixthNearestMyGroupOfType

66 SeventhNearestMyGroupOfType

67 EigthNearestMyGroupOfType

67 EighthNearestMyGroupOfType

68 NinthNearestMyGroupOfType

69 TenthNearestMyGroupOfType

70 Player1Fill

Assigned to party members in their join order, lowest first. If a member leaves the party, objects with a higher ID will be shifted one down. Eg. if Player2 is booted, previous Player3 will be accessible via Player2, Player4 via Player3 and so on.

Returns the nearest closed door (does not detect secret doors, or locked doors).