Refactoring and documenting of world.lua

In particular World:isTileEmpty was wrongly documented (it does the reverse of what the docs said).