CurseForge · Minecraft mod
VisualJS
Adding visual effects via KubeJS and GLSL
Quick answer
Which VisualJS release should I use?
VisualJS-1.1.0-forge.jar targets 1.20.1 with NeoForge, Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. 1 required mod needs a matching file.
Where it goes
Is VisualJS required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does VisualJS-1.1.0-forge.jar need?
VisualJS-1.1.0-forge.jar. Change the file and its required mods may change too.
Install KubeJS, Rhino, Architectury API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match. 2 come through another mod in the chain.
2 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add VisualJS without breaking your instance.
Built for VisualJS-1.1.0-forge.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use VisualJS-1.1.0-forge.jar. It targets 1.20.1 with NeoForge, Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install KubeJS, Rhino, Architectury API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match. 2 come through another mod in the chain.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside VisualJS-1.1.0-forge.jar. It opens that exact file at the source.
About this project
What does VisualJS add?
VisualJS
VisualJS is a mod that allows you to add effects to the game via shaders (So it's highly recommended for you to read about GLSL), in a dynamic way configurable by KubeJS. The mod adds the effects via the vanilla's post-effect system, so it's compatible with other mods like, at least Embeddium.
You can start by simply adding effects that exist in the game, like this, but note that all scripts must be executed in the client side.
So if you read it already, I'll explain the code to you: creeper is an post-effect located in minecraft/shaders/post/creeper.json, the true indicates that VisualJS will prevent the effect from being changed/removed by vanilla code. You can also add your own effects and shader programs, as long as they follow a same file structure as the vanilla ones, because Minecraft will only load the effects and shaders there.
You might notice that the uniforms can be modified programatically. So, this mean that your effects can receive values from your JS scripts, and have a more dynamic behavior. With the uniform modified, you can see something like this in game:

Despite it's from a vanilla creeper effect, it's now yellow instead of green!
Of course you can also add many other cool features, and I've got one done as the example, you can refer to the example for more details, if everything is done correctly, you should see something like this, and the shader will also change if you move closer or further from a light source:

Project description from CurseForge.
Pick your setup
VisualJS by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.20.1
3 loader builds1.19.2
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
VisualJS versions and loaders
VisualJS-1.1.0-forge.jar
21 Dec 2023
VisualJS-1.1.0-fabric.jar
21 Dec 2023
VisualJS-1.0.0-forge.jar
15 Dec 2023
VisualJS-1.0.0-fabric.jar
15 Dec 2023
Looking for an older file? The official CurseForge project page is in Resources.