Back to mods
VisualJS project artwork

CurseForge · Minecraft mod

VisualJS

Adding visual effects via KubeJS and GLSL

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which VisualJS release should I use?

Updated 2 years ago
beta file VisualJS-1.1.0-forge.jar
Game version 1.20.1
Loader NeoForge, Forge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge, Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

1 required mod needs a matching file

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.

1 listed on this file 2 pulled in by those mods
KubeJS Needed by VisualJS-1.1.0-forge.jar
required
Matching file found Matched file: KubeJS Forge 2001.6.5-build.26
Rhino Needed by KubeJS
pulled in
Matching file found Matched file: Rhino Forge 2001.2.3-build.10

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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:

Creeper effect

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:

CRT effect

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.

5 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

VisualJS versions and loaders

4 of 4 releases match

Looking for an older file? The official CurseForge project page is in Resources.