- Notifications
You must be signed in to change notification settings - Fork3
Create TypeScript/JavaScript plugins for Minecraft 1.16 Bukkit/Spigot/Paper
License
astorks/ScriptableMC-Engine
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Run JavaScript/TypeScript plugins for Minecraft 1.17 using the GraalJS script engine.
Supported Minecraft Versions: Bukkit/Spigot/Paper1.17
Previous Minecraft Versions:Use v1.3.X version of the plugin
We are switching to a new version numbering to match the supporting minecraft version.
New v1.17.X builds of this plugin will only work with Minecraft 1.17+
For Minecraft v1.12-1.16 you should use v1.3.X of this plugin.
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 installGraalVM-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.
- Download the latest
ScriptableMC-Engine-JS-Bundled.jarand place it in your plugins folder.
- Download the latest
ScriptableMC-Engine-JS.jarand place it in your plugins folder.
Take a look atScriptableMC-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 menu | /smc m | Opens an inventory menu that allows you to control the script engines. | scriptablemc.menu |
/scriptablemc info | /smc i | Prints plugin version and all loaded script engine versions if available. | scriptablemc.info |
/scriptablemc reload | /smc rl | Fully reloads all script engines and all script files. | scriptablemc.reload |
/scriptablemc version | /smc v | Check the github releases for any updates. | scriptablemc.version |
| Command | Alias | Description | Permission |
|---|---|---|---|
/scriptablemc javascript reload | /smc js rl/jsrl | Fully reloads the javascript engine and all script files. | scriptablemc.js.reload |
/scriptablemc javascript execute <source> | /smc js ex <source>/jsex <source> | Executes javascript source and prints the return value. | scriptablemc.js.execute |
/scriptablemc javascript file <filePath> | /smc js f <filePath>/jsexf | Executes javascript file from the scripts folder. | scriptablemc.js.execute.file |
/scriptablemc javascript pastebin <filePath> | /smc js pb <filePath>/jsexpb | Executes javascript source from a pastebin. | scriptablemc.js.execute.pastebin |
/jsex return 1 + 1
/jsex sender.sendMessage(lib.org.bukkit.ChatColor.GREEN + "Hello World!")
https://github.com/MinusKube/SmartInvs - Inventory helper library
https://github.com/lucko/helper - MinecraftVersions helper library
https://github.com/jkcclemens/khttp - HTTP helper library
https://github.com/aikar/commands - Built-in commands and auto-completion
https://github.com/tr7zw/Item-NBT-API - NBT helper library
https://github.com/apache/commons-io - FileUtils helper library
https://github.com/graalvm/graaljs - JavaScript engine
About
Create TypeScript/JavaScript plugins for Minecraft 1.16 Bukkit/Spigot/Paper
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.