Tags
Creators
Details
Licensed MIT
Published 2 months ago
Updated yesterday
All versions
2.6.0
Release
VFXWeaver API 2.6.0 (26.2)3 weeks ago 88
Compatibility
Minecraft: Java Edition
26.2
Platform
Fabric
Supported environments
Client-side
Client and server
Changes
Added
- The editor edits a
text_overlayblock and badges its mode-only sockets. The visual node editor now has a Text panel on atext_overlaynode - acontenttextarea andmode/font/align/anchor/splitselects generated from the schema (structural.supportsText+ `structural.tex... text_overlay: the HUD path is registered on every node, not just 26.2.mode: "flat"used to draw on 26.2 only: the FabricHudElementRegistryelement and the NeoForgeRenderGuiEvent.Postlistener both sat behind a>=26.2guard, so on 1.21.11 and 26.1.2 a flat block was laid out an...text_overlay:gravity_angleturns the fall, and the HUD exit is the world's body. The acceleration is no longer a downward scalar:gravity_angleis a direction in degrees,0= down,90= right, clockwise on the screen, with no bounds (it is not wrapped, so450is90), and the accelera...text_overlay:holdkeeps the letters whole after they land, andfade_out: 0keeps them for good. A falling character used to start fading the instant it came to rest, so the only way to read a landed word was to make the fade long - and a fade long enough to read also washed the fall itself out.text_overlay: the back of the block is a mirror, not a second front. Thetwo_sidedtwin used to be a second display turned 180 degrees about Y, which is a two-sided sign: both sides read left to right, so the back of the letter was a readable copy instead of its physical back.text_overlay:through_blocksis an optional x-ray mode for the same quads. See-through ORsDisplay.TextDisplay.FLAG_SEE_THROUGHinto every display's flags, next to the shadow bit, for every unit and for any twin, so the same quad is drawn from both sides - vanilla's own x-ray mode, and...text_overlay:two_sidedshows the back of a pinned block. A text display draws its glyphs on a single-sided quad - vanilla'sDisplayRenderer$TextDisplayRenderersubmits them withFont.DisplayMode.POLYGON_OFFSETand offers no per-entity switch - so a block pinned in w...text_overlay:billboardchooses how the block faces the camera, andbrightnesschooses the light it is drawn in. Orientation used to be implicit: the block faced the camera unless any ofrot_x/rot_y/rot_zwas set, which pinned it in the world, so an author had no way to say "world orientation" without a rotation or to ask ...text_overlay:splitchooses what one animated piece is - and it now means the same thing in both renderers. Thetextblock gained a structuralsplitfield:char(default) keeps one character per unit,wordmakes every word one unit andblockmakes the whole text one unit.text_overlay: the line can be chosen when the effect is played. The words used to live only in the definition, so one phrase per file was the whole story.text_overlay: both transitions can decode (scramble).scramble(0..1, the only bounded one of the four) turns the reveal and the exit into a decode: with it above0, the characters insidescramble_band(4) positions ahead of the reveal frontier draw a noise...text_overlay: the world block follows where the effect was played. Aworldblock used to hang from its own absolutepos_x/pos_y/pos_zand ignore everything that moved the effect, so/vfx playat, a runtime move and an entity anchor did nothing to it.text_overlay: the 2D layer, drawn on the HUD. The same authored block now has a second render path:mode: "flat"draws it over the frame instead of standing it in the world, and both loaders get a hook for it - a FabricHudElementRegistryelement appended aft...text_overlay: the letters leave the line. The exit oftext_overlayis now real, andexitpicks what it is: 0 is a fade, 1 is a fall.text_overlay: text as an effect. A new effect type puts authored text on the frame or into the world.- A composition, built entirely by a datapack:
compositions/rift, composed for a single frame. A 16-block disc of deepslate with a cone of rock under it, eight stones ringing it, a bridge, and a night sky over it; above the island hangs a sphere of inverted world.
Fixed
text_overlay: the HUD fall keeps its seconds, not ticks. Moving theflatexit ontoVFXTextBodydropped the1/8screen scale the HUD fall had been tuned with, so the authoredgravity(screen heights per second squared) reached the tick integrator as if it were al...text_overlay: the HUD fall actually falls, and a landed letter stops trembling. Two defects.text_overlay: theflatletters drop downwards and spin with their fall. Two defects in the HUD exit.text_overlay: a landed letter rests on the floor instead of hovering over it, and tips over slowly instead of flipping into the fade. Two defects in theworldexit.text_overlay: a landed letter stops spinning, and lies down. The contact damping of aworldbody's angular velocity used to sit inside thetumblebranch, so with the defaulttumble: 0- which is what the showcase demo and every definition that only setsspin_x/spin_z...text_overlay: a fall that can never land no longer leaves an immortal, fully opaque block behind. Theworldfall only started itshold+fade_outramp from the tick its body reported resting, so a body withcollisionon that never rests - dropped into the void, or givenbounce: 1- stayed at opacity1...text_overlay: the back of a pinned block is a second display glued back to back, not a see-through quad. Vanilla draws text on a single-sided quad, and the answer to that is a two-sided sign, which is what the author asked for:two_sidedis on by default again,through_blocksis off by default and stays o...text_overlay: a settledworldcharacter rests on the surface, and the letters scatter instead of falling as one. The landing used to add the character's own font height to the floor (font line height * lines * 0.025 * scale), on the assumption that a display draws its glyph downward from the entity position; it draws it **upwa...text_overlay:blockmode now agrees with vanilla on where the lines break, where the block starts and how it is aligned. Four defects in the coarse splits: (1) ablockunit counted its lines with the mod's own wrapper, which never splits a long word and does nothing atwrap_width: 0, while the display wraps throughsetLineWidth(2...text_overlay: aworldcharacter settles on the surface instead of in it. A display draws its glyph upwards from the entity position, so landing the position exactly on a block buried the letter's lower half in it; the part that survived is that the glyph's own height is what the fall knows...text_overlay: theworldletters sit next to each other, and move smoothly. The block was laid out in font pixels and those pixels were placed as if each were one world unit, so the gap between two letters was about forty times too wide (the renderer already drew each glyph at vanilla's `0.02...text_overlay: aworldblock with no rotation faces the camera instead of vanishing edge-on. The characters were spawned asTextDisplays left at the display default billboardFIXED, so each glyph was a one-sided quad in the block's own plane - and a block lying in the player's XZ plane was seen edge-on, w...text_overlay: theworldcharacters spawn where the block stands, not at the origin. EachTextDisplaywas added to the client level at0, 0, 0and only moved to the real position on the next placement pass, so the entity was registered at the world origin - far from any camera - and the block neve...
Changed
- The Text panel's five dropdowns are drawn in the page, not by the browser. Opening
mode/font/align/anchor/splitin atext_overlay's inspector and clicking a row applied the row below the one clicked, even at 100% zoom and 96 dpi - the native<select>popup's hit areas did not... text_overlayis grouped in the visual editor instead of one flat 52-socket list. The node had no row in the editor's parameter-group table, so all 52 params fell through to the default group and the inspector drew them as one undivided column.text_overlay: theworldfall is a cheap per-letter body with one raycast, not a rigid rectangle resolved against the world every tick. The box, the eight-corner contact test, the inertia and the impulse solver are gone: a text block can carry up to 256 units, and agetBlockCollisionsper corner per tick per unit was the wrong price for a letter tha...text_overlay: the fall is physics now, not a closed-form drop. A detachedworldunit used to be the same analytic curve as theflatone - one floor query at the detach, an impact plus a single rebound, a floor found per column - and it is now a body: one rigid rectangle s...- The showcase datapack covers the 2.5.0 effects, and its source lives in the repository. The published pack (
vfx-demos-showcase.zip, linked from the guide) was built before this release, so it had no demo fordatamosh,torn_edge,spectral,hex_grid,heartbeat, `hu...
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:HBhB8m4j:D2E88q8A"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:HBhB8m4j:D2E88q8A"
}

