💡 Pro tip: If your script runs too slowly and the program would become unresponsive, it will be aborted and all scripts of your wallpaper will become disabled. Make sure your script keeps the program responsive to avoid being disabled.

⚠️ Warning: Unlike other scene features of Wallpaper Engine, the scripting system is not backwards compatible.

That means if you notice anything not working right or not making sense, please post on the Steam forums instead of finding a workaround yourself. Otherwise chances are that your workaround will stop working when the issue gets fixed and your whole script may just break.

A few generic things to illustrate what could lead to problems if ignored:

• Don't assume the execution order of scripts or events. (I.e. don't expect a script on one layer to execute always right after another layer.)
• Don't access any internal objects not documented here. (Any global JavaScript objects should not be modified.)
• Don't try calling or manipulating anything from Wallpaper Engine from the 'global' script scope except for the few functions that specifically mention this as a valid use case. (We might new globals in the future and those could interfere with yours!)
• Don't call functions with wrong or undefined parameters. We might add parameters to functions or add support for variable types so calling functions wrongly could break your scripts in the future.
• Don't ignore script warnings or errors. (Check the log at the bottom for issues.)
• If you want to share data between scripts, use the global shared object. Otherwise you risk that the program will get extended with new features that use the same name as your script and so your script will break.