ErriicGit / LabyModScripting

A LabyMod-Addon, that allows you to run JavaScript in Minecraft

LabyModScripting

This Addon for LabyMod 4 allows you to run JavaScript inside of Minecraft.

Setup

• Download the latest version here
• Place the .jar in .minecraft\labymod-neo\addons

Command

There is only one simple command for loading, starting and stopping the scripts.

/script list
/script <load/start/stop/reload/unload> <name>
/script <create/run> <name> <script>

You can download the test.js from above and load it with

/script load full/path/to/test.js

You can then view the current status of it by running

/script list

Now you can start it using

/script start test.js

If it says TEST in chat it successfully ran.

You can now stop it with

/script stop test.js

If you edited the script and want to reload it, you can do it like this

/script reload test.js

You can also unload a script with

/script unload test.js

It's also possible to run code inside a script using the following command

/srcipt run test.js console.log("test");

You can also create small scripts with

/script create test2 msg = "test2"; console.log(msg);

Binding

There is currently only one Binding provided by the addon:

Script

For interaction with the own script and adding Commands as well as Listeners

• bind(String binding, String className) This method is used to bind Classes. It creates a javascript interface for the java class using reflections
• start() To start the Script. Throws IllegalStateException
• stop() To stop the Script. Throws IllegalStateException
• registerEvent(String className, Consumer<Event> handler) To register a new Event-Listener. Returns CustomSubscribeMethod
• registerCommand(String prefix, BiConsumer<String, String[]> handler, String... aliases) To register a new Command. Returns CustomCommand
• unregisterCommand(CustomCommand cmd) To unregister a Command. This only works for Commands that were registered from this script
• unregisterEvent(CustomSubscribeMethod csm) To unregister an Event-Listener. This only works for Listeners that were registered form this script
• unregisterAllCommands() To unregister all Commands that were registered from this script
• unregisterAllEvents() To unregister all Event-Listeners that were registered from this script
• isRunning() To check whether the script is running or not. Returns boolean
• getLocation() To get the file location of the script. Returns Path
• getName() To get the name of the script. Returns String
• getRoot() To get the root path of the script. Returns Path
• getScript() To get the whole script as one string. Returns String
• getAddonVersion() To get the Version of the LabyModScripting-Addon. Can be used to check compatibility. Returns String
• getClass(String className) To get the class associated with the given name. For primitives this will return the corresponding wrapper class
• getPrimitiveClass(String className) Works similar to getClass(String className) but returns the actual primitive class

Examples

Bindings

Script.bind("Laby", "net.labymod.api.Laby");

Events

worldEvent = Script.registerEvent("net.labymod.api.event.client.world.WorldEnterEvent", (event) => {
  console.log("Hello World");
});
Script.unregisterEvent(worldEvent);

Commands

customCommand = Script.registerCommand("customcommand", (prefix, args) => {
    console.log("You entered the custom command");
});
Script.unregisterCommand(customCommand);

Planed Features

• A text-editor with syntax-highlighting and suggestions
• Installation of scripts
• An easy way to add and access settings fom scripts
• A wait() function