updated world controller javadocs