I didn't plan to include examples in the Sripting reference page, just maybe some usage code portions when not included , and as Jenalya suggests it, tricks like the one we met on Blue Sage quest. Of course, links to sample code when it will be available could be included too, but this begins to overflow my skills as I am far to know all the built in functions. To be able to read code is one thing, to be able to write some code is another one, to document a library is far beyondo11c wrote:Yeah, it could be beneficial to add (or link) examples under the commands on this page:
http://wiki.themanaworld.org/index.php/ ... _Reference
(Don't edit the existing ones - they're signatures, not examples)
Though, a few larger examples would likely not "fit" in a single command. Wherever you introduce the larger syntax (how a warp or mob looks like; the meaning of all the pipe-and-comma separated values have and which ones are optional) might be a good place to do that. (like the current one on the "Standards" page is)
I was sure that there was a inappropriate content in this text, due to the work that was done since TMW fork exists. I included it because I bet most of the content would be useful and that the work needed to upgrade it would be far less than writing a new one from scratch.There are definitely some major inaccuracies in the Basics page.
I would start with a brief mention of how the NPC scripts are loaded from the conf, then mention the top-level constructs besides scripts (with appropriate warnings that they should usually be generated by the converter rather than by hand), then finally scripts.
I suppose the interpreter begins to read the .conf file, then the cascading imports through the folders hierarchy until it reaches NPC, Map, Mob and item scripts and variables, and links all that mess someway. My ears (eyes in fact) are wide open to learn if you have a nice way to explain that with simple words.