Super-detailed code comments! Really well-organized :)
As for the game, I'll start with the successful stuff. The varied design of the level (the ramps, maze, use of verticality, etc.) is excellent and makes the game interesting to explore. To improve: the movement needs to be WAY faster (at least to me). I got bored and didn't finish because it was taking so long to get through it. But here's another thing to think about: this *may* not be a speed problem. The other thought I had while playing is that the scale just feels all wrong. The game board is huge, so even if you increased the speed it would still feel huge and hard to make sense of the various parts. I think a useful exercise for you would be to take a look at the design of a course in Super Mario 64. Those levels, although expansive in some ways, are actually pretty tightly constrained (i.e. they are in a small physical space). For a game like this (puzzles, collecting), as a player I'm looking for more Super Mario 64, less Skyrim ;)