improve farm (and non-farm) find logic
documenting the server scripts