Back to mods
Vextris project artwork

CurseForge · Minecraft mod

Vextris

A lightweight mesh loading and rendering library for Minecraft mods, with optional GeckoLib integration.

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

Quick answer

Which Vextris release matches 1.20.1?

Updated 2 days ago
Best match for your filters vextris-forge-1.20.1-0.1.4.2.jar
Game version 1.20.1
Loader Forge

vextris-forge-1.20.1-0.1.4.2.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Vextris 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 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 vextris-forge-1.20.1-0.1.4.2.jar need?

vextris-forge-1.20.1-0.1.4.2.jar on 1.20.1. Every mod below is checked against that same setup.

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 Vextris without breaking your instance.

Built for vextris-forge-1.20.1-0.1.4.2.jar on 1.20.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use vextris-forge-1.20.1-0.1.4.2.jar. It targets 1.20.1 with Forge; 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

    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 vextris-forge-1.20.1-0.1.4.2.jar. It opens that exact file at the source.

About this project

What does Vextris add?

Vextris: mesh loading and rendering library for Minecraft mods

Vextris is a lightweight mesh loading and rendering library for Minecraft mods.

It loads and validates triangle and quad meshes, provides immutable geometry and a resource-reload cache, and renders through Minecraft's vertex consumers. Static meshes work without GeckoLib. An optional bridge lets GeckoLib animate bones while Vextris draws the mesh.

I use Vextris for the mesh rendering in the mods I'm developing, and publish it on its own so they can depend on it as a separate library.

Library mod: Vextris adds no blocks, items or gameplay of its own

Release 0.1.4.2: meshes on demand, loaded meshes in about half the memory

Used by Vettura: Vehicles & Roads


Two D20 meshes rendered by Vextris in a flat world

Left: a D20 mesh loaded from a resource pack. Right: the same die built as 20 solid pieces with MeshModel.builder() and moved apart by a per-bone transform. Faces at any angle, not just cubes.


Features

Mesh loading and validation

  • .vxmesh.json meshes (formats 1 to 4), standalone or paired with a GeckoLib/Bedrock .geo.json of the same path for its bones.
  • Triangles and planar convex quads, with flat or smooth normals.
  • Large meshes: up to 256 MiB per file, 2,048 parts, 6,291,456 vertices and 2,097,152 triangle-equivalents.
  • Strict validation: degenerate or non-planar faces and bad indices are rejected. Every file is rejected on its own with a clear message; the other files still load.
  • Loaded in parallel within a memory budget and read straight from the stream; a corner shared by several faces is stored once, so a loaded mesh takes about half the memory it did in 0.1.4.1.
  • On demand: VextrisMeshes.loadOnDemand(...) names meshes that a reload only notes; each loads in the background the first time it is asked for (status, preload).

Smooth shading

  • Per-vertex normals, or automatic crease smoothing by angle (corner-angle or face-area weighting), with optional hard edges.
  • Under Oculus/Iris shader packs, smooth parts are drawn as triangles, so the pack keeps their smooth normals.
  • Computed once when resources load; flat parts draw exactly as in 0.1.0.

Rendering and layers

  • Vertices are submitted through Minecraft's vertex consumers, in cutout and translucent layers. Cutout parts are also drawn in a shader pack's shadow pass.
  • Baked once per resource reload into an immutable snapshot; F3+T is safe.
  • Safe on dedicated servers: the data API is common code, rendering is client-only.

GPU geometry cache

  • MeshGpuCache keeps a mesh's cutout parts on the GPU and draws them with one matrix per bone, instead of resubmitting every vertex each frame. Meant for vehicles, machines and other static meshes.
  • GpuGeometry does the same for your own vertices (road or terrain pieces).
  • bakeAhead writes a model's entries on worker threads before they are drawn, so a large mesh does not stop a frame.
  • Draws with the RenderType's own shader, or the shader pack's, so the picture matches the CPU path. Translucent parts stay on the CPU path; -Dvextris.gpuCache=false turns the cache off.

Bones, locators and skinning

  • Bone hierarchies with pivots and bind rotations; bind-pose rendering without GeckoLib.
  • A per-bone BonePoser hook for your own transforms: spin, hover, part separation.
  • Locators: named attachment points on bones (seats, muzzles, lights), with bone and locator transform queries that also work on a dedicated server.
  • Skinned surfaces (format 4): up to four bone weights per vertex, skinned on the CPU, for joints that must not break apart.
  • Deformation: MeshPart.deformed(...) and MeshModel.deformed(...) move corners (a dented panel), with normals rebuilt per smoothing group; the GPU cache bakes only the changed bones again.
  • Code-built meshes through MeshModel.builder(), with the same validation as files.

Optional GeckoLib bridge

  • Draws Vextris meshes on bones that GeckoLib animates, and skinned surfaces that follow them. GeckoLib owns skeletal animation.
  • Active with GeckoLib 4.7.4 or 4.8.4. Without GeckoLib, Vextris Core works normally.

What Vextris is not

In detail:

  • No skeletal animation engine, keyframes or animation state.
  • No OBJ/FBX/glTF importer or converter yet.
  • No dynamic UVs or morph targets. Skinning runs on the CPU.
  • No blocks, items, block entities, collision shapes or networking.

Requirements: Minecraft 1.20.1, Forge 47.4 or later, Java 17

Installation

  1. Install Minecraft 1.20.1 with Forge 47.4.0 or later and Java 17.
  2. Put vextris-forge-1.20.1-0.1.4.2.jar in the instance's mods folder and remove any previous Vextris JAR.
  3. Install GeckoLib 4.7.4 or 4.8.4 only when a mod you use needs the animation bridge.
  • Forge 47.4.0 or later (Minecraft 1.20.1) (required) - Declared range [47.4.0,48); built and tested on 47.4.22.
  • GeckoLib 4.7.4 or 4.8.4 (optional) - Only for the optional animation bridge. Not required for Vextris Core.

Oculus, Iris and Embeddium are not required. Tested with Embeddium 0.3.31, and with Oculus 1.8.0 and the Sundial Lite shader pack; other rendering mods and shader packs have not been tested.


For developers

Get Vextris from Curse Maven (the snippet is also on each file's page here). Version 0.1.0 is on Maven Central as io.github.dwom10912:vextris; later versions are not. Do not bundle Vextris into your own mod.

repositories {
    maven {
        url = "https://cursemaven.com"
        content { includeGroup "curse.maven" }
    }
}
dependencies {
    compileOnly fg.deobf("curse.maven:vextris-1738149:9448393")
    runtimeOnly fg.deobf("curse.maven:vextris-1738149:9448393")
}

In your mods.toml:

[[dependencies.yourmod]]
    modId="vextris"
    mandatory=true
    versionRange="[0.1.1,0.2.0-alpha)"
    ordering="AFTER"
    side="BOTH"

Existing [0.1.0,0.2.0-alpha) declarations accept every 0.1.x version; mods built against 0.1.0 keep working. A mod that calls VextrisMeshes.loadOnDemand needs [0.1.4.2,0.2.0-alpha).

Known limits

One texture per model draw. Skinning runs on the CPU (linear blend, up to four bones per vertex); there are no morph targets and no general model importer. The GPU geometry cache is render-thread only and covers cutout parts; translucent parts use CPU submission. Meshes loaded on demand stay loaded until the next resource reload. Shader packs are tested with Oculus 1.8.0 and Sundial Lite only.


Changelog

0.1.4.2

  • Meshes on demand: VextrisMeshes.loadOnDemand(Predicate) names meshes that a reload only notes; each loads in the background the first time it is asked for. status, preload, onDemandErrors; -Dvextris.meshesOnDemand=all puts every mesh on demand.
  • Loaded meshes take about half the memory: a corner shared by several faces is stored once (Vettura's packs: 314 MB to 143 MB). Every value a part gives is bit for bit the same.
  • Mesh files are read from the stream straight into numbers and load in parallel only while their peaks fit a memory budget (a quarter of the heap; -Dvextris.meshLoadBudgetMB), so many large meshes no longer fill the heap on the loading screen.
  • Additive: no public signature removed or changed.

0.1.4.1

  • MeshGpuCache.bakeAhead: a model's entries are written on worker threads before they are drawn and uploaded a few milliseconds a frame; GpuGeometry.write and upload.

0.1.4

  • Deformation: MeshPart.deformed, MeshModel.deformed and smoothing groups; the GPU cache bakes only the changed bones.
  • Forge range [47.4.0,48) (built and tested on 47.4.22).

0.1.3

  • Limits per mesh file: 2,097,152 triangle-equivalents, 6,291,456 vertices, 2,048 parts, 256 MiB.
  • Mesh files load in parallel on a resource reload; the log gives the time and names slow files; a file that runs out of memory is rejected on its own.
  • MeshGpuCache default budget 1 GiB.

0.1.2

  • Licence change only, same code as 0.1.1: All Rights Reserved from this version.
  • Versions up to 0.1.1 keep the Apache License 2.0.

0.1.1

  • Smooth shading: per-vertex normals and crease smoothing (mesh format 3), kept under shader packs.
  • Locators and bone/locator transform queries, also on a dedicated server.
  • Skinned meshes (mesh format 4), skinned on the CPU, with GeckoLib support.
  • GPU geometry cache for static meshes (MeshGpuCache, GpuGeometry).
  • GeckoLib 4.8.4 supported alongside 4.7.4.
  • Raised limits per mesh file: 64 MiB, 512 parts, 786,432 vertices, 262,144 triangle-equivalents.
  • Additive: mods built for 0.1.0 and format 1/2 mesh files work exactly as before.

0.1.0

  • Stabilization release of the existing 0.1.0-alpha.1 mesh library baseline.
  • Preserves the Java API, resource format, Mod ID and rendering implementation.
  • Publishes io.github.dwom10912:vextris:0.1.0 on Maven Central, with POM metadata and Javadoc.
  • Updates installation, integration and release documentation.

License: All Rights Reserved; versions up to 0.1.1 keep the Apache License 2.0

From 0.1.2, Vextris is All Rights Reserved: you can use it in any modpack that downloads it from this page, and build mods that depend on it, but not re-upload it, redistribute modified builds or copy its code. Versions up to 0.1.1 were published under the Apache License 2.0 and keep it. The Vextris name and logo have separate terms (TRADEMARKS.md in the jar).

Development disclosure

Vextris was developed with substantial AI coding assistance. The page text and changelog were drafted with AI help. The logo and page images are drawn by code (SVG and HTML templates) written with AI help; no image-generation models were used. The D20 showcase is a real in-game screenshot. All releases are built, tested and reviewed by the author.

Project description from CurseForge.

Pick your setup

Vextris by Minecraft version and loader

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

1 available setups

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

Recent files

Vextris versions and loaders

5 of 5 releases match
Clear filters

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