******
🏷️ ID
******

``glib.id:`` : The management of entity IDs allows to identify precisely
an entity. Useful for example in the case of a shooting game to know who
is shooting at whom.

Check ID
~~~~~~~~

``check`` : Allows to compare the ``glib.id`` scores of the entities
with the ``glib.targetId`` score of the entity having executed the
function.

* The latter receives the tag ``glib.id.checker``.
* The other entities receive the tag
   * ``glib.id.upper`` if their ``glib.id`` is higher than the ``glib.targetId``.
   * ``glib.id.lower`` if their ``glib.id`` is lower than the ``glib.targetId``.
   * ``glib.id.match`` if their ``glib.id`` is equal to ``glib.targetId``.

*Example:*

Find the entity (or entities) with ID 3:

::

    # Once
    scoreboard players set @s glib.targetId 3
    function glib.id:check

    # See the result
    execute unless entity @e[tag=glib.id.match] run tellraw @a [{"text": "No entity found :'(", "color": "dark_gray"}]
    execute as @e[tag=glib.id.match] run tellraw @a ["",{"text":"<"},{"selector":"@s"},{"text":">"},{"text": "Hey! Are you looking for me?", "color": "dark_gray"}]

Check parent ID
~~~~~~~~~~~~~~~

``check_parent`` : Compares the ``glib.parentId`` scores of the entities
with the ``glib.id.target`` score of the entity that executed the
function.

* The latter receives the tag ``glib.parentId.checker``.
* The other entities receive the tag
   * ``glib.parentId.upper`` if their score ``glib.id.parent`` is higher than the ``id.targetId``
   * ``glib.parentId.lower`` if their score ``glib.id.parent`` is lower than the ``id.targetId``
   * ``glib.parentId.match`` if their score ``glib.id.parent`` is equal to the ``id.targetId``

*Example:*

Find all child entities of Bob:

::

    # Once
    execute as @e[name=Bob,limit=1] run scoreboard players operation @s glib.targetId = @s glib.id
    function glib.id:check_parent

    # See the result
    execute unless entity @e[tag=glib.parentId.match] run tellraw @a [{"text": "No entity found :'(", "color": "dark_gray"}]
    execute as @e[tag=glib.parentId.match] run tellraw @a ["",{"text":"<"},{"selector":"@s"},{"text":">"},{"text": "Hey! Are you looking for me?", "color": "dark_gray"}]

Get simple unique ID
~~~~~~~~~~~~~~~~~~~~

``get_suid`` : (Simple Unique ID) Allows the entity executing the
function to get a ``glib.id`` score different from all other entities
that have already executed the function.

* Returns the ID on the glib.id score of the executing entity.
* Gives the tag ``glib.id.set`` and ``glib.id.type.suid`` to the entities that have already executed the function

*Example:*

Give an ID to all players:

::

    # In a loop to give an ID to the players who connect
    execute as @a[tag=!glib.id.set] run function glib.id:get_suid

    # See the result
    scoreboard objective setdisplay sidebar glib.id

Get chain unique ID
~~~~~~~~~~~~~~~~~~~

``get_cuid`` : (Chain Unique ID) Allows the entity running the function
to get a score ``glib.id`` different from all other entities that have
already run the function. The difference with ``get_suid`` is in the way
the scores are assigned.

* ID scores are assigned dynamically based on the available scores, so that they form a string. So, if there are 5 entities, they will be numbered from 1 to 5, without any "hole". In order not to break this string, you must also execute the ``update_cuid`` function in a loop.
* Returns the ID on the ``glib.id`` score of the executing entity.
* Give the tag ``glib.id.set`` and ``glib.id.type.cuid`` to the entities that have already executed the function

*Example:*

Give an ID to all players:

::

    # In a loop to give an ID to the players who connect
    execute as @a[tag=!glib.id.set] run function glib.id:get_cuid

    # See the result
    scoreboard objective setdisplay sidebar glib.id

Update chain unique ID
~~~~~~~~~~~~~~~~~~~~~~

``update_cuid`` : Allows to update all the CUID of the entities.
Executes globally (the source entity does not matter, executing it
multiple times per tick will have no effect)

*Example:*

Keep the ID string free of holes and duplicates:

::

    # To be executed once at the beginning of each tick
    function glib.id:update_cuid

    # See the result
    scoreboard objective setdisplay sidebar glib.id