ScriptBridge-Fabric

ScriptBridge-Fabric is a powerful Minecraft Fabric mod that introduces dynamic JavaScript (GraalVM) scripting capabilities to the game. It bridges the gap between Minecraft's internal mechanics and runtime scripting, allowing you to control both the client and server sides in real-time by writing simple JavaScript code— without restarting the game .

Whether you are a developer looking to quickly prototype ideas or a player wanting to enhance your gameplay experience through scripts, ScriptBridge-Fabric provides a flexible and efficient solution.

🌟 Key Features

• Modern JavaScript Support : Powered by the GraalVM engine, enabling you to write scripts using modern JavaScript (ES6+) syntax with excellent performance.
• Dual Environment Support :
  • Client Scripts ( scripts/client ) : Directly interact with the local client to send chat messages, display info, or debug data.
  • Server Scripts ( scripts/server ) : Access higher privileges to modify player attributes, spawn blocks, broadcast messages, and more.
• Real-time Hot Reloading : Simply run /script reload after modifying your scripts, and changes take effect immediately. Drastically improves development and debugging efficiency.
• Intuitive API : Provides a simple global game object to easily access internal game functions.
• Built-in Debugging : Includes debug modes and log outputs to easily trace script execution status.

🚀 Getting Started

1. Installation

Download and install the mod, then launch the game once. The mod will automatically generate a scripts folder in your game's root directory.

2. Writing Scripts

Create a .js file in either the scripts/client or scripts/server directory.

Example: Client Welcome Script ( scripts/client/welcome.js )

// Sends a message to the player when the 
script runs
game.chat("Welcome back, " + game.
getPlayerName() + "!");
game.log("Initialization script loaded.");

Example: Server Interaction Script ( scripts/server/admin.js )

// Spawns a diamond block at coordinates 
(0, 80, 0)
game.spawnBlock(0, 80, 0, 
"minecraft:diamond_block");
game.broadcast("Admin script executed, 
reward block spawned!");

3. Running Scripts

Use the in-game commands to run your scripts:

• /script run welcome.js (Run a client script)
• /script reload (Reload all scripts)

📚 Documentation & Support

• API Documentation : For a full list of available methods and objects, please refer to the API Documentation .