Run JavaScript/TypeScript plugins for Bukkit/Spigot/Paper Minecraft 1.15 using the GraalJS script engine.
This plugin is in a preview state, there may be breaking changes, missing features, and possibly a few bugs.
Feel free to create an issue if you find any missing features, bugs, or just have an idea for a great feature to add.
This plugin requires running your minecraft server with OpenJDK, Standard JDK, or the GraalVM java runtime.
Most linux servers already use OpenJDK, however if you're running windows or want a fully supported java runtime that supports AOT javascript compilation you can install GraalVM-CE.
GraalVM-CE is a free open source java runtime created by Oracle that is pre-packaged with the GraalJS Engine allowing all javascript engine features including AOT compilation of javascript.
- Ensure your server is running OpenJDK 8+ or GraalVM
- Download the latest ScriptableMC plugin and place it in your plugins folder.
- Take a look at ScriptableMC-TypeScript for a full typescript plugin example. You can take the typescript example and compile it, then directly modify the javascript if you don't want to use typescript.
| Command | Alias | Description | Permission |
|---|---|---|---|
/scriptablemc javascript reload |
/smc js rl |
Fully reloads the script engine and all script files. | scriptablemc.js.reload |
/scriptablemc javascript execute <source> |
/smc js ex <source> |
Executes javascript source and prints the return value. | scriptablemc.js.execute |
/scriptablemc javascript file <filePath> |
/smc js f <filePath> |
Executes javascript file from the scripts folder. | scriptablemc.js.execute.file |
/scriptablemc menu |
/smc menu |
Opens an inventory menu that allows you to control the scriptable engine. | scriptablemc.menu |
/scriptablemc info |
/smc info |
Prints plugin version and GraalVM/GraalJS versions if available. | scriptablemc.info |
/jsex return 1 + 1
/jsex sender.sendMessage(lib.org.bukkit.ChatColor.GREEN + "Hello World!")
