Overview:
ScriptCore is a powerful in-game scripting engine that lets server owners and developers write JavaScript to control nearly every aspect of a Minecraft server. With ScriptCore, you can create commands, handle events, and modify game behavior without needing to write a traditional Java plugin. (Paper 1.21+)

Can now list, download & load premade scripts in game! (Only 1 available, I will make more or you can too! Join the Discord link at the bottom to contribute!)

Version Updates: Check The Spoiler to see what's new in each version


Here is a fully working slightly more advanced script that was made for 0.0.3
Tested and working perfect on version 0.0.3. (Test it by adding it to your Plugins/Scriptcore/scripts/ folder)
The new example script link: Click here - Github trial002.js

Looking to find information about methods? Use the above script and do
...for example "/listmethodstoconsole Player" Just part of the demonstration on what ScriptCore can do.

In order to really display how things will need to be setup in JS vs a NormalPlugin I re-coded my PlayerVaults plugin in .js to work in version 0.0.3+ without issue!

PlayerVaults.js - Available via in-game commands now! Use...
/scriptcore get playerVaults.js & then
/scriptcore reload playerVaults.js to load it up right away.
(commands will show red in chat until restart but still work fine)

Permissions & Commands for PlayerVaults.js:


Commands:

/scriptcore reload nameOfScript.js
/scriptcore list
/scriptcore get <scriptName.js>

Permissions:

scriptcore.reload
scriptcore.get
scriptcore.list

Key Features:

• Full JavaScript Scripting Engine:
  • Run scripts directly in your server using GraalVM.
    
    
  • Access Bukkit API objects directly in JavaScript.
    
    
  • Create custom commands, automate tasks, or prototype server features rapidly.
• Dynamic Event Handling:
  • Listen to any Bukkit events from JS.
    
    
  • Example events included in example.js: player joins, block breaks, entity damage, chat messages, etc.
    
    
  • Flexible enough to build mini-games, custom mechanics, or interactive systems.
• Command Creation Made Simple:
  • Define commands entirely in JavaScript.
    
    
  • Includes built-in permission checking for player access.
    
    
  • Commands can modify player state, inventory, world, or anything accessible via Bukkit API.
• Example Script (example.js):
  • Demonstrates the power of ScriptCore with multiple working commands and event hooks.
    
    
  • Includes sample commands: /feed, /heal, /fly, /gm, /give, /spawn, teleportation commands, and more.
    
    
  • Serves as a foundation to extend and customize your server.
• Lightweight & Self-Contained:
  • Despite bundling GraalVM, the plugin is compact (~36 MB).
    
    
  • No extra dependencies or setup required—just place in /plugins.
• GraalVM Integration:
  • Executes JS code natively on the JVM.
    
    
  • GraalVM is licensed under the GraalVM Free Terms and Conditions (Oracle), included as LICENSE.txt in the plugin folder.

Why Use ScriptCore?

• Rapidly prototype and implement server features in JS.
  
  
• Give admins and developers a flexible, runtime scripting environment.
  
  
• Create custom game logic, commands, and event responses without Java compilation.

Installation:

1. Place the .jar in /plugins.
   
   
2. Start the server; example.js will be generated automatically.
   (Version 0.0.4 and newer will no longer generate an example.js)
3. Edit example.js to add your own commands and events.
   
   
4. Restart the server to load script changes. (restart not required if you use the /reload command for new scripts)

License:

• GraalVM: GraalVM Free Terms and Conditions (Oracle).
• Classgraph

IMPORTANT THING TO NOTE FOR CODING JS VIA ScriptCore

1. Destructured Array: The key line jsFunc.execute(exposedObjects.toArray(), event); all these discovered objects are bundled into a single Java Array and passed as the first argument to the JavaScript function. The original Bukkit event object is passed as the second argument.
   This is why your JavaScript functions MUST use the array destructuring on the first argument else failure to work properly. As seen in the playerVaults.js provided above for example.

This is the initial test version and "might" impact server performance, please let me know. Reach out about any issues you have. Plugin hosted on Github, it was too large to host here. (36.7mb)

More updates will be coming to add additional capabilities as some things might not work yet! Although a lot already will... as of 0.0.3 you can do just about anything.

Please leave a rating with a comment on additional features you would like to see!

If you would like to get more directly involved or request a plugin, feel free to join the Discord!