---
title: "BG(2)EE Identifiers : object.ids"
---
    
<div class="title_main"> BG(2)EE Identifiers </div>
<br />

Objects can be split broadly into three categories; static objects, marked objects and object specifiers. Static objects (e.g. <code><a href="#Player1">Player1</a></code>, <code><a href="#1">Myself</a></code>) are always bound (and in fact, they always return the same creature). Marked objects (e.g. <code><a href="#18">LastSeenBy</a></code>, <code><a href="#10">LastAttackerOf</a></code>) are almost always bound. Object specifiers (e.g. <code>[<a href="../bgee/ea.htm#255">ENEMY</a>.0.0.<a href="../bgee/class.htm#1">MAGE</a>]</code> are not bound &mdash; they are checked every time they are referenced. Objects listed in <code><a href="../bgee/object.htm">object.ids</a></code> are marked objects and are not saved over game sessions.

{% capture note %}
<ul>
  <li><code><a href="#60">Group</a></code> objects are determined by the <code><a href="../../../file_formats/ie_formats/cre_v1.htm#CREV1_0_Header_0x274">specifics</a></code> value set in the creature file.</li>
  <li><code><a href="#14">Nearest()</a></code> identifiers cascade outwards, i.e. if there are only three valid creatures, <code><a href="#FourthNearest">FourthNearest()</a></code> and above will return the third nearest creature (rather than false).</li>
</ul>
{% endcapture %}
{% include note.html %}

<br />
<br />   

IDS V1.0<br />
<br />

<div class="idsHeader"><a name="Nothing">0 Nothing</a></div>
<br />

<div class="idsHeader"><a name="1">1 Myself</a></div>
<div class="indent1">
  Returns the active creature.
</div>
<br />

<div class="idsHeader"><a name="LeaderOf">2 LeaderOf</a></div>
<br />

<div class="idsHeader"><a name="GroupOf">3 GroupOf</a></div>
<br />

<div class="idsHeader"><a name="4">4 WeakestOf</a></div>
<div class="indent1">
  Returns the weakest player character (in the party).
</div>
<br />

<div class="idsHeader"><a name="5">5 StrongestOf</a></div>
<div class="indent1">
  Returns the strongest player character (in the party).
</div>
<br />

<div class="idsHeader"><a name="6">6 MostDamagedOf</a></div>
<div class="indent1">
  Returns the most damaged player character (in the party).
</div>
<br />

<div class="idsHeader"><a name="7">7 LeastDamagedOf</a></div>
<div class="indent1">
  Returns the least damaged player character (in the party).
</div>
<br />

<div class="idsHeader"><a name="ProtectedBy">8 ProtectedBy</a></div>
<br />

<div class="idsHeader"><a name="ProtectorOf">9 ProtectorOf</a></div>
<br />

<div class="idsHeader"><a name="10">10 LastAttackerOf</a></div>
<div class="indent1">
  Returns the creature that last inflicted physical damage on the active creature.
</div>
<br />

<div class="idsHeader"><a name="LastTargetedBy">11 LastTargetedBy</a></div>
<br />

<div class="idsHeader"><a name="12">12 NearestEnemyOf</a></div>
<div class="indent1">
  Returns the nearest creature of opposite allegiance.
</div>
<br />

<div class="idsHeader"><a name="LastCommandedBy">13 LastCommandedBy</a></div>
<br />

<div class="idsHeader"><a name="14">14 Nearest</a></div>
<div class="indent1">
  Returns the nearest visible creature &mdash; usually the active creature.
</div>
<br />

<div class="idsHeader"><a name="LastHitter">15 LastHitter</a></div>
<br />

<div class="idsHeader"><a name="LastHelp">16 LastHelp</a></div>
<br />

<div class="idsHeader"><a name="17">17 LastTrigger</a></div>
<div class="indent1">
  Returns the last creature that activated the active trigger region.
</div>
<br />

<div class="idsHeader"><a name="18">18 LastSeenBy</a></div>
<div class="indent1">
  Set by <code><a href="../../../scripting/triggers/bgeetriggers.htm#0x401C">See()</a></code> and <code><a href="../../../scripting/triggers/bgeetriggers.htm#0x4074">Detect()</a></code>, not by <code><a href="../../../scripting/triggers/bgeetriggers.htm#0x400D">Exists()</a></code> or <code><a href="../../../scripting/triggers/bgeetriggers.htm#0x4018">Range()</a></code>.
</div>
<br />

<div class="idsHeader"><a name="19">19 LastTalkedToBy</a></div>
<div class="indent1">
  Returns the last creature that has been targeted by <code><a href="../../../scripting/actions/bgeeactions.htm#137">StartDialogue()</a></code> or similar actions.
</div>
<br />

<div class="idsHeader"><a name="20">20 LastHeardBy</a></div>
<div class="indent1">
  Returns the last creature that triggered a <code><a href="../../../scripting/actions/bgeeactions.htm#17">Help()</a></code> or <code><a href="../../../scripting/actions/bgeeactions.htm#106">Shout()</a></code> action.
</div>
<br />

<div class="idsHeader"><a name="Player1">21 Player1</a></div>
<div class="indent1">
  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).<br>
  Use the <code><a href="#Player1Fill">Player1Fill</a></code> family of objects if you want to avoid any gaps.
</div>
<br />

<div class="idsHeader"><a name="Player2">22 Player2</a></div>
<br />

<div class="idsHeader"><a name="Player3">23 Player3</a></div>
<br />

<div class="idsHeader"><a name="Player4">24 Player4</a></div>
<br />

<div class="idsHeader"><a name="Player5">25 Player5</a></div>
<br />

<div class="idsHeader"><a name="Player6">26 Player6</a></div>
<br />

<div class="idsHeader"><a name="27">27 Protagonist</a></div>
<div class="indent1">
  Synonymous with <code><a href="#Player1">Player1</a></code>.
</div>
<br />

<div class="idsHeader"><a name="28">28 StrongestOfMale</a></div>
<div class="indent1">
  Returns the strongest male player character (in the party).
</div>
<br />

<div class="idsHeader"><a name="SecondNearestEnemyOf">29 SecondNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="ThirdNearestEnemyOf">30 ThirdNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="FourthNearestEnemyOf">31 FourthNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="FifthNearestEnemyOf">32 FifthNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="SixthNearestEnemyOf">33 SixthNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="SeventhNearestEnemyOf">34 SeventhNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="EighthNearestEnemyOf">35 EighthNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="NinthNearestEnemyOf">36 NinthNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="TenthNearestEnemyOf">37 TenthNearestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="SecondNearest">38 SecondNearest</a></div>
<br />

<div class="idsHeader"><a name="ThirdNearest">39 ThirdNearest</a></div>
<br />

<div class="idsHeader"><a name="FourthNearest">40 FourthNearest</a></div>
<br />

<div class="idsHeader"><a name="FifthNearest">41 FifthNearest</a></div>
<br />

<div class="idsHeader"><a name="SixthNearest">42 SixthNearest</a></div>
<br />

<div class="idsHeader"><a name="SeventhNearest">43 SeventhNearest</a></div>
<br />

<div class="idsHeader"><a name="EighthNearest">44 EighthNearest</a></div>
<br />

<div class="idsHeader"><a name="NinthNearest">45 NinthNearest</a></div>
<br />

<div class="idsHeader"><a name="TenthNearest">46 TenthNearest</a></div>
<br />

<div class="idsHeader"><a name="47">47 WorstAC</a></div>
<div class="indent1">
  Returns the player character (in the party) with the highest AC.
</div>
<br />

<div class="idsHeader"><a name="48">48 BestAC</a></div>
<div class="indent1">
  Returns the player character (in the party) with the lowest AC.
</div>
<br />

<div class="idsHeader"><a name="49">49 LastSummonerOf</a></div>
<div class="indent1">
  Returns the character who summoned the active creature.
</div>
<br />

<div class="idsHeader"><a name="50">50 NearestEnemyOfType</a></div>
<div class="indent1">
  It auto-populates the <code><a href="../bgee/ea.htm">EA</a></code> field of the object selector and immediately evaluates it, so it's useless to define the <code><a href="../bgee/ea.htm">EA</a></code> manually.
</div>
<br />

<div class="idsHeader"><a name="SecondNearestEnemyOfType">51 SecondNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="ThirdNearestEnemyOfType">52 ThirdNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="FourthNearestEnemyOfType">53 FourthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="FifthNearestEnemyOfType">54 FifthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="SixthNearestEnemyOfType">55 SixthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="SeventhNearestEnemyOfType">56 SeventhNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="EigthNearestEnemyOfType">57 EigthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="EighthNearestEnemyOfType">57 EighthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="NinthNearestEnemyOfType">58 NinthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="TenthNearestEnemyOfType">59 TenthNearestEnemyOfType</a></div>
<br />

<div class="idsHeader"><a name="60">60 NearestMyGroupOfType</a></div>
<div class="indent1">
  It auto-populates the <code><a href="../bgee/specific.htm">SPECIFIC</a></code> field of the object selector and immediately evaluates it, so it's useless to define the <code><a href="../bgee/specific.htm">SPECIFIC</a></code> manually.
</div>
<br />

<div class="idsHeader"><a name="SecondNearestMyGroupOfType">61 SecondNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="ThirdNearestMyGroupOfType">62 ThirdNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="FourthNearestMyGroupOfType">63 FourthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="FifthNearestMyGroupOfType">64 FifthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="SixthNearestMyGroupOfType">65 SixthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="SeventhNearestMyGroupOfType">66 SeventhNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="EigthNearestMyGroupOfType">67 EigthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="EighthNearestMyGroupOfType">67 EighthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="NinthNearestMyGroupOfType">68 NinthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="TenthNearestMyGroupOfType">69 TenthNearestMyGroupOfType</a></div>
<br />

<div class="idsHeader"><a name="70">70 Player1Fill</a></div>
<div class="indent1">
  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.
</div>
<br />

<div class="idsHeader"><a name="Player2Fill">71 Player2Fill</a></div>
<br />

<div class="idsHeader"><a name="Player3Fill">72 Player3Fill</a></div>
<br />

<div class="idsHeader"><a name="Player4Fill">73 Player4Fill</a></div>
<br />

<div class="idsHeader"><a name="Player5Fill">74 Player5Fill</a></div>
<br />

<div class="idsHeader"><a name="Player6Fill">75 Player6Fill</a></div>
<br />

<div class="idsHeader"><a name="76">76 NearestDoor</a></div>
<div class="indent1">
  Returns the nearest closed door (does not detect secret doors, or locked doors).
</div>
<br />

<div class="idsHeader"><a name="SecondNearestDoor">77 SecondNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="ThirdNearestDoor">78 ThirdNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="FourthNearestDoor">79 FourthNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="FifthNearestDoor">80 FifthNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="SixthNearestDoor">81 SixthNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="SeventhNearestDoor">82 SeventhNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="EighthNearestDoor">83 EighthNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="NinthNearestDoor">84 NinthNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="TenthNearestDoor">85 TenthNearestDoor</a></div>
<br />

<div class="idsHeader"><a name="PartySlot1">86 PartySlot1</a></div>
<div class="indent1">
  Returns the player in the first portrait slot.
</div>
<br />

<div class="idsHeader"><a name="PartySlot2">87 PartySlot2</a></div>
<br />

<div class="idsHeader"><a name="PartySlot3">88 PartySlot3</a></div>
<br />

<div class="idsHeader"><a name="PartySlot4">89 PartySlot4</a></div>
<br />

<div class="idsHeader"><a name="PartySlot5">90 PartySlot5</a></div>
<br />

<div class="idsHeader"><a name="PartySlot6">91 PartySlot6</a></div>
<br />

<div class="idsHeader"><a name="92">92 Familiar</a></div>
<div class="indent1">
  Returns the familiar creature if present.
</div>
<br />

<div class="idsHeader"><a name="93">93 FamiliarSummoner</a></div>
<div class="indent1">
  Returns the summoner of the current familiar.
</div>
<br />

<div class="idsHeader"><a name="LastKilled">94 LastKilled</a></div>
<br />

<div class="idsHeader"><a name="95">95 NearestAllyOf</a></div>
<div class="indent1">
  Returns the nearest creature of same allegiance.
</div>
<br />

<div class="idsHeader"><a name="SecondNearestAllyOf">96 SecondNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="ThirdNearestAllyOf">97 ThirdNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="FourthNearestAllyOf">98 FourthNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="FifthNearestAllyOf">99 FifthNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="SixthNearestAllyOf">100 SixthNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="SeventhNearestAllyOf">101 SeventhNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="EighthNearestAllyOf">102 EighthNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="NinthNearestAllyOf">103 NinthNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="TenthNearestAllyOf">104 TenthNearestAllyOf</a></div>
<br />

<div class="idsHeader"><a name="105">105 FarthestEnemyOf</a></div>
<div class="indent1">
  Returns the farthest enemy within visual range of the active creature.
</div>
<br />

<div class="idsHeader"><a name="SecondFarthestEnemyOf">106 SecondFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="ThirdFarthestEnemyOf">107 ThirdFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="FourthFarthestEnemyOf">108 FourthFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="FifthFarthestEnemyOf">109 FifthFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="SixthFarthestEnemyOf">110 SixthFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="SeventhFarthestEnemyOf">111 SeventhFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="EighthFarthestEnemyOf">112 EighthFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="NinthFarthestEnemyOf">113 NinthFarthestEnemyOf</a></div>
<br />

<div class="idsHeader"><a name="TenthFarthestEnemyOf">114 TenthFarthestEnemyOf</a></div>
<br />