==== Overview ====

A script is a Java class, hence you need to know the [[https://en.wikipedia.org/wiki/Java_(programming_language)|Java programming language]].

There is not yet a public API for scripts, but if there is interest we will consider creating one. For now, example scripts are provided that can be modified by end-users.

==== Classpath ====

While developing scripts, it is useful to be able to compile the script to ensure that it works before running it in Ecolego. 

Ecolego binaries are stored in a semi-hidden folder in the user directory. 

On Windows, this folder is located at

  %APPDATA%/Roaming/Ecolego 7/lib
  
On Linux, it is located in 

  ~/.facilia/Ecolego 7/lib
  
This folder contains [[https://en.wikipedia.org/wiki/JAR_(file_format)|jar files]] for Ecolego and all third-party libraries that Ecolego uses.

When compiling a script, you must ensure that these files are included in the [[https://en.wikipedia.org/wiki/Classpath_(Java)|classpath]].

On Windows:

  javac -cp "%APPDATA%/Roaming/Ecolego 7/lib/*" MyScriptFile.java

Unix

  javac -cp "~/.facilia/Ecolego 7/lib*" MyScriptFile.java
  
==== See also ====

  * [[Example scripts]]
  * [[Scripting]]