JS Runner

Description

This project was inspired by ScriptCraft. ScriptCraft is a plugin that allows JavaScript files to be ran on a Minecraft server, but sadly ScriptCraft is no longer being updated and only supports 1.8. This plugin aims to bring the function of ScriptCraft back to modern day Minecraft. This project includes custom JavaScript API to interact with the game server.

Setup

Put the .jar file into the server plugins folder and restart it. A new folder will pop up with the name: "JSRunner" and inside that folder will be another folder named: "scripts." You can put .js files into the scripts folder and use the appropriate command to execute it.

Commands

``` /js run <filename> ``` runs a Javascript file located in JSRunner/Scripts

``` /js stop <filename> ``` stops a Javascript file

``` /js reload ``` stops all JavaScript files

JavaScript API

Server

``` server.log() ``` logs a message to the server console

``` server.command() ``` runs a command as the console

Timers

``` timers.setTimeout(fn, ticks) ``` run fn once after ticks

``` timers.setInterval(fn, ticks) ``` run fn repeatedly every ticks

``` timers.clear(id) ``` cancels a timeout/interval

``` timers.clearAll() ``` cancels all timers.

Events

``` events.on(event, callback) ``` listens for an event

``` playerJoin ``` parameter: PlayerWrapper

``` playerQuit ``` parameter: PlayerWrapper

``` blockBreak ``` BlockWrapper

Block Wrapper

``` getType() ``` returns block type as string

``` getX() ``` get X position ``` getY() ``` get Y position ``` getZ() ``` get Z position

``` getPlayerName() ``` name of the player who broke the block

Player Wrapper

``` getName() ``` gets the players name ``` getUUID() ``` gets the players UUID

Sample Code (Requires latest version to work)

This sample code welcomes a player who joined the server.

``` server.log("Hello from JSRunner!");

events.on("playerJoin", function(player) { server.log("Welcome " + player.getName()); });

var intervalId = timers.setInterval(function() { server.log("Repeating message every 100 ticks"); }, 100); ``` This sample code clears the invenory of a player who breaks bedrock with their hands (not TNT).

``` events.on("blockBreak", function(block) { if (block.getType() === "BEDROCK") { server.command("clear " + block.getPlayerName()); server.command("tell " + block.getPlayerName() + " Your inventory was cleared!"); } });

```