## Description
\nThis 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. <\/p>\n
## Setup
\nPut 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.<\/p>\n
## Commands<\/p>\n
“` “` “` # JavaScript API “` “` “` “` “` “` “` “` “` “` “` “` “` “` ## Sample Code (Requires latest version to work) “` events.on(“playerJoin”, function(player) { var intervalId = timers.setInterval(function() { “` “`<\/p>\n","protected":false},"excerpt":{"rendered":" The plugin aims to add the ability to run JavaScript files in a Minecraft server.<\/p>\n","protected":false},"featured_media":88561,"template":"","meta":{"_minecraft_slug":"js-runner","_minecraft_project_id":"gcqjSE77","_minecraft_author":"Bunnyking","_minecraft_license":"CC-BY-SA-4.0","_minecraft_downloads":39,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"js-runner.zip","_minecraft_size_bytes":101484388,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T21:37:53.990400Z","_minecraft_date_created":"2026-01-05T21:17:36.368368Z","_minecraft_date_modified":"2025-12-31T18:49:11.608595Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/js-runner","_minecraft_icon_attachment_id":88561,"_minecraft_imported_at":"2026-06-05T01:29:01+00:00","_minecraft_import_hash":"b0764bba3287fe8f54669cda15b6f7a3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,873,126,90,127,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-88560","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/js run
\n“`
\nruns a Javascript file located in JSRunner\/Scripts<\/p>\n
\n\/js stop
\n“`
\nstops a Javascript file<\/p>\n
\n\/js reload
\n“`
\nstops all JavaScript files<\/p>\n
\n## Server<\/p>\n
\nserver.log()
\n“`
\nlogs a message to the server console<\/p>\n
\nserver.command()
\n“`
\nruns a command as the console
\n## Timers <\/p>\n
\ntimers.setTimeout(fn, ticks)
\n“`
\nrun fn once after ticks<\/p>\n
\ntimers.setInterval(fn, ticks)
\n“`
\nrun fn repeatedly every ticks<\/p>\n
\ntimers.clear(id)
\n“`
\ncancels a timeout\/interval<\/p>\n
\ntimers.clearAll()
\n“`
\ncancels all timers.
\n## Events <\/p>\n
\nevents.on(event, callback)
\n“`
\nlistens for an event<\/p>\n
\nplayerJoin
\n“`
\nparameter: PlayerWrapper<\/p>\n
\nplayerQuit
\n“`
\nparameter: PlayerWrapper<\/p>\n
\nblockBreak
\n“`
\nBlockWrapper
\n## Block Wrapper<\/p>\n
\ngetType()
\n“`
\nreturns block type as string<\/p>\n
\ngetX()
\n“`
\nget X position
\n“`
\ngetY()
\n“`
\nget Y position
\n“`
\ngetZ()
\n“`
\nget Z position<\/p>\n
\ngetPlayerName()
\n“`
\nname of the player who broke the block
\n## Player Wrapper<\/p>\n
\ngetName()
\n“`
\ngets the players name
\n“`
\ngetUUID()
\n“`
\ngets the players UUID<\/p>\n
\nThis sample code welcomes a player who joined the server.<\/p>\n
\nserver.log(“Hello from JSRunner!”);<\/p>\n
\n server.log(“Welcome ” + player.getName());
\n});<\/p>\n
\n server.log(“Repeating message every 100 ticks”);
\n}, 100);
\n“`
\nThis sample code clears the invenory of a player who breaks bedrock with their hands (not TNT).<\/p>\n
\nevents.on(“blockBreak”, function(block) {
\n if (block.getType() === “BEDROCK”) {
\n server.command(“clear ” + block.getPlayerName());
\n server.command(“tell ” + block.getPlayerName() + ” Your inventory was cleared!”);
\n }
\n});<\/p>\n