VastInfiniteNet / JsMacros-Getting-Started

Helpful guide to getting started with JsMacros.

Welcome

Hello there! The goal of this document is to teach one how to setup JS Macros Mod.

This setup is targeted towards users:

• using MultiMC, but similar principles should apply to other Minecraft launchers.
• running Minecraft 1.18.2, but the same principles should apply to other Minecraft versions.

If you already have JS Macros installed, and looking for instructions on how to run a script you downloaded, go to the "Running a script" section.

Getting Started

1. Open MultiMC!

   • If you haven't already, sign in into your minecraft account.

2. Install Fabric mod loader.

   1. Select instance and click Edit Instance on the righthand side.
   2. Select Install Fabric; select the most recent version, and click OK.
      • you should now see Intermediary Mappings and Fabric Loader in the Version list. Make sure both are checked off. Should look similar to:

3. Install Fabric API.

   1. Go to the Fabric API mod page and download the most recent version for the game version you are playing on. For 1.18.2: https://www.curseforge.com/minecraft/mc-mods/fabric-api/files/3891301.
   2. Now select Loader mods and the lefthand side, below Version, and click Add on the righthand side.
   3. Navigate to where you downloaded the Fabric API zip to, and select and open it.
      • You should now see Fabric API in the mod list. If this your first mod installed for the instance, the Loader mods list should look like:

4. Install JS Macros.

   1. Go to the JS Macros mod page and download the most recent version for the game version you are playing on. Make sure it is the fabric verison! file name should look like jsmacros-1.XX.X-FABRIC-X.X.X.jar. For 1.18.2: https://www.curseforge.com/minecraft/mc-mods/jsmacros/files/3904779.
   2. Now add the mod. Click Add on the righthand side.
   3. Navigate to where you downloaded the Js Macros zip to, and select and open it.
      • You should now see Fabric API in the mod list. If this your first mod installed for the instance, the Loader mods list should look like:

Finding Where to Put a Script

The folder to put your scripts is typically Macros/. The full path will depend on where your MultiMC/launcher is, but generally looks like:

C:/path/to/MultiMC/instances/INSTANCE-NAME/.minecraft/config/jsMacros/Macros/

Drag any scripts you may want to run into that folder. It is fine if you add folders.

In the image below I placed a script I want to run, helloWorld.js in the Macros/ folder. Note the path.

Running a script

So you wanna run a script someone else gave you?

First make sure trust the script you are running. If you are able to read JavaScript or whatever language it is written in, give it a read before running it! Always practice some form of OPSEC.

1. Start the game!

2. Open the JS Macros menu.

   1. Find JS Macros menu key in the key bindings. Default should be K. Press it.

3. Add the script to a key.

   1. Click the + next to Run.

   2. Select the file to run by clicking the ./. Navigate to where the script is, click it, and click Select

      NOTE: IF YOU DON'T SEE THE SCRIPT YOU WANT YOU MAY NEED TO CONSULT THE ABOVE Finding Where to Put a Script SECTION

   3. Set the key binding by clicking on empty box to left of filename and pressing the key you want script to be binded to.

   4. Enable the binding by clicking on red Disabled button.

   In this case I am binding a script, hellowWorld.js to the y button:

4. Run the Scripts!

• Press the button you binded the script to!

Questions or Contact

If you run into any problems or have other questions feel free to reach out to me

• Via discord: MotokoKusanagi#5346
• Via email: [e-mail]