The GuideMe Scripting Engine was inspired by this post by desertfox. This set of XML pages and Javascript routines implements most of the features desertfox discussed in his that post. In a nutshell, it allows you to write a Guideme tease in a simple script language. The page creation is handled automatically for you. It allows you to focus on writing your tease and making the best use of images etc, rather than learning all the complexities of Guideme. Don't be fooled by the simplicity of it though. It's surprisingly effective, and full of features, with even more planned.
The script engine requires Guideme 1.5 or higher
NOTE: Guideme versions 3.3 through 3.8 all have a bug that prevents proper saving of the tease state if you exit Guideme while a script is in progress. There is a workaround to this issue described in this post.
Latest release: Jan 7, 2018 Version 1.53 Download (63mb). See this post for notes. If you've already downloaded version 1.52 you can just grab the updated .js file from that post.
Dec 16/2017 Version 1.52 See here and here
Dec 10/2017 Version 1.51 See this post
Nov 12/2017 Version 1.5 See this post
Just unzip it to your Guides folder. It will place several files in the Guides folder and create a subfolder named "ScriptTeases" with the remaining files.
See file ScriptEngine-Readme.txt (found in the ScriptTeases folder) for a full list of commands and features.
Detailed information on the features and commands added in version 1.5 can be found in
ScriptTeases\Common\ScriptEngineChangeLog.txt
and in the tutorial scripts provided.
Also check the edit notes below for links to other posts in this thread that provide more details.
Next open Guideme and load GuidemeScripts.xml. You should see a screen like this: For the full tutorial select Tutorial and click OK. This will give you brief tutorial of the features. Have a look at the script source in PG/Common/Scripts/Script Tutorial.scr to see how it works.
If you've used the ScriptEngine before start with New in v1.5.
There are now numerous sample teases and scripts included to help you discover what's possible with the script engine.
That's all you really need to get started, but more details are in the spoiler below:
- Spoiler: show
Enjoy,
**EDITS**
Jan 6/2019 Updated links to other posts and reorganized this post a bit.
Dec 16/2017 Updated to version 1.52 to fix a bug introduced in 1.51.
Dec 10/2017 Updated to version 1.51 to fix a few bugs and add a few enhancements. See this post for notes.
Nov 12/2017 Uploaded version 1.5. Modified this post to better reflect the new version.
Feb 24/2016 Uploaded new version 1.4 files with bug reported by desertfox corrected.
Feb 20/2016 Uploaded version 1.4. Includes the If command, changes to the Audio command, and other features outlined in this post: <TBA>
Feb 10/2016 Upload version 1.3 with some bug fixes for supporting reloading a script.
Jan 25/2016 Uploaded version 1.2 which supports being reloaded in the middle of a script. This allows a user to close Guideme (or load a different tease) then reload the scripted tease later, and the tease will continue from where it was. This was required to support the random mazes being developed by DesertFox.
Nov 12/2015 Uploaded new version with basic expressions like "count = count + 1" and for videos. The link above should download the latest version (1.1)
PlayfulGuy