VFXWeaver API

A client-side VFX library/API for Minecraft 26.2, 26.1.x and 1.21.11 (Fabric). Drop-in cinematic effects — screen post-processing, camera shake, block/entity overlays — either from chat commands, from datapacks, or programmatically from your own mod through a tiny Java API.

Author: Artition · License: MIT

What it does

• 30+ post-processing effects rendered through a ping-pong FBO (fullscreen, per-pixel shaders): chromatic aberration, color grading, distortion, dent, gradient map, posterize, blur, pixelate, hue isolation, vignette, screen flash, motion blur, bloom, film grain, scanlines, depth of field, letterbox, invert, vortex, speed lines, slice shift, noise warp, solarize, double vision, eyelids, iris wipe, digital glitch, VHS, shockwave, afterimage, stop motion.
• Camera effects — simplex-noise shake with a smooth envelope, dutch-angle roll, FOV modifier.
• World block overlays — block_tint and block_outline drawn as world-space geometry around blocks.
• Entity effects — entity_tint / entity_outline applied to entities by UUID (second-pass model render, texture-aware).
• Datapack-defined effects — plain JSON, no code. Keyframe animation, easing curves, world/camera/player bindings, math expressions, collections, sounds.
• Server → client triggers — effects fired from a server command, or from your own mod over the network.
• Public Java API for other mods (VFXAPI).

Requirements

Effect types

Screen post-processing

Camera

World overlays — block_tint, block_outline, light_beam (soft vertical column), pulse_ring (expanding ring), guide_line (dashed parabola arc)
Entity effects — entity_tint, entity_outline (by UUID), entity_displace (per-vertex displaced echo)

Quick start

All mutating commands require operator rights (/vfx list is open to all).

/vfx play vfxweaver:screen_flash
/vfx play vfxweaver:speed_lines {count:80, length:0.8, seed:"t * 2.0"}
/vfx playat vfxweaver:block_outline 100 64 200
/vfx playentity vfxweaver:entity_outline @e[type=!player,distance=..10]
/vfx stop vfxweaver:speed_lines
/vfx set vfxweaver:motion_blur {intensity:0.8}     # live override a running effect
/vfx list

Datapack effects (no modding)

Drop a JSON into data/<namespace>/vfx/<name>.json, run /reload, and the effect id is <namespace>:<name>:

{
  "type": "speed_lines",
  "duration": 60,
  "easing": "ease_out_cubic",
  "params": {
    "count": 80,
    "length": { "expr": "0.4 + 0.4 * t" },
    "seed": { "expr": "t * 2.0" },
    "intensity": 1.0
  }
}

• Animated params via keyframes (t = 0..1 progress) or math expressions over player state (health, hunger, speed, light level, time of day, position).
• World/camera/player bindings (bind: screen_x, bind: proximity, ...) so effects follow the world instead of the screen.
• Collections — play several child effects with per-child delays.
• Definitions sync automatically to clients on join and after /reload on dedicated servers.

Java API (for other mods)

Static entry point dev.vfxweaver.api.VFXAPI — a one-liner per call.

// Server → client
VFXAPI.sendEffect(serverPlayer,
    Identifier.fromNamespaceAndPath("vfxweaver", "screen_flash"),
    Map.of("intensity", 0.8F), null);

// With a world anchor (block/entity effects follow the position)
VFXAPI.sendEffect(player, effectId, somePos, Map.of(), null);

// Locally on the client (no packet)
VFXAPI.playEffect(Identifier.fromNamespaceAndPath("vfxweaver", "camera_shake"),
    20, Map.of("amplitude_x", 0.2F), null);

// Stop / live-tune
VFXAPI.sendStop(player, effectId);
VFXAPI.sendSetParam(player, effectId, "intensity", 0.3F);
VFXAPI.sendKeyframe(player, effectId, "intensity", 10, 1.0F, EasingType.EASE_OUT_CUBIC);

The network layer (vfxweaver:vfx_trigger) is protocol-versioned; the client silently ignores packets with an incompatible version. Full API, packet layout and definition-registry access are documented in the repo's docs/API.md.

Docs

Commands, effect params, datapack format, bindings — the full usage guide is in the project repo. Build it yourself with ./gradlew build (requires JDK 25), or grab a release jar from the Releases tab.

• Repo: ~~~~https://github.com/Artition/VFX-Weaver