Document the entities code

[kemenaran]

The code for entities AI (i.e. actors, NPCs, enemies, etc) has been entirely decompiled. But much of the code is still undocumented.

A useful task is to pick one of the entities (the files in the src/code/entities/ directory), analyze how it works, and label the functions to document its behavior.