TacZ Mesh Loader [TML]

This add-on is not an official TacZ add-on; it is unofficial. Please do not report any bugs caused by this add-on to the TacZ server under any circumstances. Please report them exclusively in the comments section of this mod or on Vell's Mods info server.

Required dependencies

• Forge 1.20.1 / NeoForge 1.21.1: Timeless and Classics Zero (official TacZ) 1.2.0 or later
• Fabric 1.20.1 / 1.21.1: TaCZ: Refabricated 1.0.0 or later

---

Overview

TacZ Mesh Loader is a client-side mod that allows TacZ models to use poly_mesh geometry exported by the Blockbench plugin Meshy.

By default, TacZ only supports Bedrock-format cube models. With this mod installed, gunpack creators can use polygon mesh models — smooth shapes built from triangle and quad polygons — directly in TacZ guns, attachments, ammo and gun smith tables.

No special setup is required. Mesh models are detected automatically.

---

Features

Poly mesh support — Loads Meshy-exported poly_mesh geometry directly into TacZ's model pipeline. Cube parts and mesh parts can be freely mixed in the same model.

Automatic detection — Any model file that contains poly_mesh data is automatically rendered as a mesh model. No "model_type" definition is needed.

Wide coverage — Works for guns, attachments (scopes, suppressors, etc.), ammo, and gun smith tables.

VBO caching — At first glance, you might think that mesh models put a strain on your computer, but this mod incorporates VBO processing, which minimizes the load even when you spawn a large number of mesh model guns at once.

Compatibility — Works with Iris / Oculus shaders, the new scope lens effects of TacZ 1.2.0 (night vision / thermal), and Yes Steve Model.

LesRaisins Tactical Equipements support — Melee weapons, consumables and throwables can also use mesh models. (Forge 1.20.1, NeoForge 1.21.1 and Fabric 1.21.1 only. NeoForge and Fabric versions support the unofficial ports.)

---

For Gunpack Creators

Starting from 0.2.1, the "model_type": "mesh" definition is no longer required. Just write the display JSON exactly the same way as a normal TacZ gunpack. TacZ Mesh Loader checks the model file and automatically enables mesh rendering if it contains poly_mesh data.

{
  "model": "mypack:gun/mygun_geo",
  "texture": "mypack:gun/uv/mygun",
  "animation": "mypack:mygun"
}

Existing gunpacks that already use "model_type": "mesh" will continue to work without any changes.

File locations and structure follow the standard TacZ gunpack format. Models should be created in Blockbench using the Meshy plugin. You can download it directly from the Blockbench plugin list.

If you release a gunpack that uses mesh models, please be sure to list this mod as a dependency. Without this mod, the mesh parts will not be displayed.

Be sure to use the hand model as a cube object. Do not convert the hand model into a mesh.

---

License

GPL-3.0

---

Credits

Author: VellEagle

---

*This project uses generative AI to create code.