...
player can be id or things like ENEMIES, ALLIES, etc.
range is in tiles
Returns an array of game objects seen within range of given position that passes the optional filter which can be one of a player index, ALL_PLAYERS, ALLIES or ENEMIES. By default, filter is ALL_PLAYERS. Finally an optional parameter can specify whether only visible objects should be returned; by default only visible objects are returned. Calling this function is much faster than iterating over all game objects using other enum functions. (3.2+ only)