VPB Mesh Loader [VML]

This add-on is not an official Vic's Point Blank add-on; it is unofficial. Please report them exclusively in the comments section of this mod or on Vell's Mods info server.

VPB Mesh Loader lets Vic's Point Blank content packs use mesh models (poly_mesh) made in Blockbench and exported with the Meshy plugin. Just install it — no extra folders, config files or special setup are needed in your content pack.

Guns, attachments, ammo, throwables and every other item that Vic's Point Blank renders with GeckoLib are supported.

Why is VPB Mesh Loader required to load mesh models?

GeckoLib can read poly_mesh data in theory, but it cannot read the format Meshy actually exports, so any model containing a mesh crashes the game while loading. VPB Mesh Loader fixes the loading and turns each mesh into normal GeckoLib geometry, so it works with everything Vic's Point Blank does:

• Part visibility, animations, reloads and attachments
• Glowing parts, skins and scopes
• Mixed models: cubes and meshes can be combined freely, even inside the same bone
• Triangles, quads and larger polygons (automatically triangulated)

Performance

On every supported version, mesh parts of guns and attachments are drawn with GPU vertex buffers (VBO), the same technique used in TacZMeshLoader, so even high-poly guns stay smooth. The mesh data is sent to the GPU once and reused every frame.

Lighting and shading are correct with and without shader packs (Oculus on 1.20.1, Iris on 1.21.1 and 26.1.2).

For content pack creators

1. Install the Meshy plugin in Blockbench (required to export meshes)
2. Make your model — cubes and meshes can be mixed freely
3. Export the geo model with Meshy and put it where Vic's Point Blank normally expects the model:

assets/pointblank/geo/item/<item_name>.geo.json

The same pack layout works on every supported version. Animations, textures and item definitions stay exactly the same as a normal Vic's Point Blank pack.

Please keep marker bones as cubes. Vic's Point Blank reads the shape of some bones to find positions, for example muzzleflash, scope, scopepip, leftarm, rightarm and attachment mount bones.

Supported versions

Client-side only. Install it on each player's game; servers do not need it, and it does nothing if installed on a server.

Config

• 1.20.1 (Forge) / 1.21.1 (NeoForge): config/vpbmeshloader-client.toml
• 1.21.1 (Fabric) / 26.1.2 (NeoForge and Fabric): config/vpbmeshloader-client.properties

In case of display problems, you can turn VBO rendering off completely (enableVbo) or only while a shader pack is active (vboWithShaderPacks).