Tags
Creators
Details
Licensed MIT
Published 2 months ago
Updated 2 days ago
All versions
2.6.3
Release
VFXWeaver API 2.6.3 (26.1.x, NeoForge)2 days ago 8
Compatibility
Minecraft: Java Edition
26.1.x
Platform
NeoForge
Supported environments
Client-side
Client and server
Changes
Changed
- The client can now run up to 2048 simultaneous effect instances (was 64).
MAX_ACTIVE_EFFECTSinVFXEffectManagerwas raised from 64 to 2048; the eviction of the oldest active effect on overflow (with a warning) is unchanged andMAX_SCHEDULED_EFFECTSstays 128. This is a perf ceiling, not a target: every concurrent effect adds render work, so more live effects mean more overdraw. Not verified in game.
Fixed
- Datapack definitions with large
positionsarrays are no longer truncated at 4096 during sync.VFXSyncPayload(vfxweaver:vfx_sync) now carries a definition's top-levelpositionsarray as 12-byte binaryfloattriples (positionBlobs) instead of inside the definition JSON string, so a largeblock_tint/block_outlinedefinition no longer hits theSTRING_UTF832767-character ceiling.VFXSyncPayload.PROTOCOL_VERSIONis 3 and an old client skips the packet rather than crashing on decode. Not verified in game. - Per-instance position lists are no longer silently truncated at 4096.
VFXTriggerPayload.positionsused to be encoded withVec3.STREAM_CODEC(24 bytes per point) and cut toMAX_POSITIONS = 4096, so a 10199-point one-instanceVFXAPI.sendEffect(..., List<Vec3>, ...)reached the client with only 4096 points. Positions now travel as threefloats per point (12 bytes) and share the packet-derivedMAX_WIRE_POSITION_BYTESbudget with lifted mask blobs; a call that cannot fit is refused by the API (returnsfalse, nothing sent) instead of being cut. The publicList<Vec3>signature is unchanged andMAX_POSITIONSis now derived from the byte budget.PROTOCOL_VERSIONstays 10, so no second bump. Not verified in game. - A large
block_listmask override no longer disconnects the client withString too big.VFXAPI.sendMaskused to hit theByteBufCodecs.STRING_UTF832767-character ceiling once a mask'spositionsarray grew past a few thousand blocks, throwing anEncoderException("String too big") while encodingvfx_trigger.block_listpositions now travel as 12-bytefloattriples in a binary tail of the same packet; the JSON keeps a fail-closed"@wire:N"marker that the client restores beforeVFXMaskParser.parse.MAX_WIRE_JSON(32767 chars, plus a UTF-8 byte check) andMAX_WIRE_POSITION_BYTES(1 MiB - 192 KiB) replaceMAX_MASK_JSON, which stays only as a deprecated alias; an unfit mask is refused by the API instead of being sent asnull.PROTOCOL_VERSIONis 10 and an old-version packet is skipped rather than crashing decode. No caller change. Server and clients must run the same protocol versions (trigger 10, sync 3). Not verified in game (needs the 10199-block radar mask in a live Fabric/NeoForge test).
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:7qtcXYSO"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:HBhB8m4j:7qtcXYSO"
}

