Back to mods
VFXWeaver project artwork

Modrinth · Minecraft mod

VFXWeaver

Cinematic screen effects and post-processing for Minecraft: 60+ effects, camera shake, overlays and a node editor in your browser. Client-side; works from commands or datapacks.

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

Quick answer

Which VFXWeaver release should I use?

Updated yesterday
Latest stable file 2.6.3
Game version 1.21.11
Loader NeoForge

VFXWeaver 2.6.3 targets 1.21.11 with NeoForge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is VFXWeaver required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

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

The source marks this as usable on both the client and server.

What else does VFXWeaver 2.6.3 need?

2.6.3. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add VFXWeaver without breaking your instance.

Built for VFXWeaver 2.6.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 2.6.3. It targets 1.21.11 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 2.6.3. It opens that exact file at the source.

About this project

What does VFXWeaver add?

VFXWeaver puts a cinematic layer over Minecraft: 60+ effects rendered as post-processing shaders on top of the frame, camera moves, world and entity overlays, screen images and sound. Fire one from a command, build your own in a node editor that opens in your browser, or drive them from a datapack, a server plugin or your own mod.

Client-side only. Nothing to install on the server, no resource pack required.

Try it in two minutes

  1. Drop vfxweaver-2.5.0+<minecraft>-<loader>.jar into mods/ (the versions tab filters by game version and loader).
  2. Launch a world with cheats on, or be op on a server.
  3. /vfx list prints every effect id. Then:
Command What you see
/vfx play vfxweaver:datamosh The picture melts: pixels of the old frame are dragged along the movement and the frame breaks into blocks of stale content.
/vfx play vfxweaver:torn_edge The frame splits along a jagged line, the two sides pulled apart under a glowing edge.
/vfx play vfxweaver:spectral A seven-stop prism ramp: a duotone, a chromatic smear or a spectral ring.
/vfx play vfxweaver:hex_grid A triangular lattice whose lines take their colour from the screen position.
/vfx play vfxweaver:vhs Tape wear: tracking bands, colour bleed, wobble.
/vfx play vfxweaver:heartbeat A heartbeat in your ears, at a tempo you set.
/vfx play vfxweaver:vortex The world spirals into the centre.
/vfx play vfxweaver:shockwave A ring knocks the picture outward from a point.
/vfx play vfxweaver:camera_shake An impact shake with a smooth envelope, not a jitter.
/vfx playentity vfxweaver:entity_outline @e[type=pig,limit=1] A texture-aware outline on a chosen entity.

A play lasts a few seconds: run it again to repeat, /vfx stop <effect> to cut it. Any param is overridable in place, so /vfx play vfxweaver:vhs {[intensity:1.5]} is the same effect, harder. Several plays of the same effect stack instead of replacing each other.

Build your own in the browser

/vfxeditor starts a small node editor served by the game itself and opens it in your browser. The effect is a node graph; every param takes a constant, a start/end ramp, keyframes or an expression. The canvas plays live in-game while you drag, the timeline gives one lane per animated param, and Export writes an ordinary data/<namespace>/vfx/<name>.json — exactly what a datapack would contain, so there is no editor-only format and nothing extra to install.

The URL carries a one-time token, the bridge binds to 127.0.0.1 only, and closing the tab does not leave anything running.

What is in the box

  • Screen, 40 effects — chromatic aberration, colour grade, distortion, dent, vortex, shockwave, pixelate, halftone, comic, ink, posterize, gradient map, hue isolation, invert, solarize, slice shift, double vision, eyelids, iris wipe, digital glitch, VHS, datamosh, torn edge, spectral, hex grid, scanlines, film grain, motion blur, blur, bloom, depth of field, letterbox, speed lines, vignette, screen flash, accent glow, afterimage, stop motion, noise warp, sky pattern, surface pattern.
  • Camera, 3 — shake, dutch roll, field of view.
  • World, 7 — block tint, block outline, light beam, pulse ring, guide line, particles, block chain.
  • Entity, 3 — tint, outline and displacement by UUID, texture-aware.
  • Audio, 4 — heartbeat, hum, noise and volume duck, synthesised on their own audio thread so the frame rate never reaches the sound.
  • Images and windows — screen_image draws a picture over the frame (a resource-pack PNG, animated or not). window_create opens a real frameless click-through desktop window showing a picture while the game runs.
  • Extras — fog modifier, masks (screen, world and entity volumes, down to custom GLSL plugins), collections (several effects as one), easing curves and keyframes everywhere.

Datapacks

A definition is one JSON file: an effect type, a timeline, params, and optional bindings to the world, the camera or the player. Params animate as a constant, a start/end ramp, keyframes with easing, or an expr, and can read the player's position, look direction or health.

The jar ships 73 ready definitions, one per effect type, so the fastest way to learn the format is to copy one out and change a number. Servers can fire effects over vfxweaver:vfx_trigger and sync definitions over vfxweaver:vfx_sync; packets carry a PROTOCOL_VERSION, and a client silently ignores an incompatible one instead of touching your world.

The datapack used to record the clips on the docs site is public: vfx-demos-showcase.zip. It builds a stage (/function vfx_demos:scene/setup) and plays one looping demo per effect (/vfx play vfx_demos:show_vhs), which is the quickest tour of everything here.

For mod developers

dev.vfxweaver.api.VFXAPI plays, stops, live-tunes and keyframes effects on a player from the server side, and registerImage lets your mod hand the renderer an image it drew itself. The network layout, the definition registry and the full call surface are in docs/API.md.

Requirements

Minecraft 26.2, 26.1.x, 1.21.11
Loader Fabric 0.18.4+ on 26.x, 0.17.3+ on 1.21.11, or NeoForge
Fabric API required on Fabric
Java 25+
Side client; the server side is optional and only carries datapack sync and triggers

Effects recorded into a Flashback replay play back with it, including looping and persistent ones.

Links

Project description from Modrinth.

Pick your setup

VFXWeaver by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

10 available setups

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

Recent files

VFXWeaver versions and loaders

100 of 100 releases match

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