-- shared logic file for map manager - don't call any subsystem-specific functions here