Topics

[HOW]

In the help file under "Predefined global script functions", it says

In your main global script file, there are some functions which are automatically added when you create the game. These are global events, and the function is called when a particular event happens. There are also some other events which you can add if you want to.

However, nowhere does it specify HOW to add these events.

The few events that are included in a templated new project are surrounded by these tags.

Code: ags

#sectionstart unhandled_event  // DO NOT EDIT OR REMOVE THIS LINE
    ...
#sectionend unhandled_event  // DO NOT EDIT OR REMOVE THIS LINE

This strongly implies that global events are like other events, they must be added or removed by the AGS editor GUI and not copied, pasted, or written manually since this could confuse the automatic synchronization between the code source and the GUI management.

I can find no GUI method to add, manage, or remove global events, nor any documentation describing this, or even if it is or is not required.

I believe, from the text I've read so far written by people discussing global event code, that there is no GUI method for adding global events and that the sectionstart and sectionend tags around these event handlers are not needed.

Can anyone let me know how global event code is intended to be added and removed in the AGS editor?

What script engine does AGS use?
Is the script engine public or proprietary?
Is the script ECMA compliant?
If ECMA compliant, can AGS be configured to use a different script engine?

I ask because, with many applications that have a script engine, the application script documentation may be less complete than the docs that come with the script engine itself. The script engine docs could be used to answer more detailed and specific script questions.

Also, whenever possible I like to configure apps to only use JavaScript. I've memorized way too many script languages already.