Got it. It'd be useful if there was something like Chance(x) which returned a random number instead - i.e. Random(x).
I'm making a cookbook with them at the moment.
One of the goals of "classroon" was to conceal features that were not required to make the 3 "beginner level" Adventuron games:
- "Escape from Dinosaur Island DX"
- "The Cave of Magic"
- "Excalibur: Sword of Kings"
It seems that the jam is unleashing additional requirements and I require an "advanced user" guide. The cookbook will be just that. It's coming.
The more your document, the more you put off absolute beginners. Onboarding beginners needs is an undocumented goal of this jam. That's why it almost required two community boards. One for absolute beginners, and one for those with preconceptions about what functions they expect from the system.
I don't think you need a cookbook - just a list, like in your HTML documentation, is fine. That's initially what I wanted to read, but it hadn't been posted at the time. I ended up doing the whole classroom lesson. I couldn't see the title of the chapters, so I had to do the whole class to unlock what they were.
Incidentally, there are a few typos through the classroom. I had them noted to forward to you, but I since had a restart and lost that notepad. Also, one of the comments in the copy-and-paste at the end of a section are incorrect. I think it's one of the headers surrounded in "#".
I thought the classroom was very thorough for absolute beginners.
I'm also approaching writing my game from the perspective of someone who is used to coding. Having a separate 'add', 'subtract' and 'increment' functions for elements instead of, for example, += is difficult to come to terms with. I may not be the target audience, and indeed what I'm doing with the engine is pushing it to its limits, so I appreciate you being so accomodating.