ANoob's BRRES Material Tool

From Custom Mario Kart
Jump to navigation Jump to search
ANoob's BRRES Material Tool
Author: ANoob
Operating system: Windows, Mac, Linux
Programming language: Python
File formats: BRRES, OBJ, DAE
Version: v1.3.2
Date of latest version: 2022-06-05
Download: GitHub


ANoob's BRRES Material Tool (also known as abmatt and sometimes stylized as ANoob's Brres Material Tool) is a Python program created by ANoob. This is used for creating, editing and exporting BRRES models. It was created with the intention of making the process of material editing and model creation easier. Prior to v0.8.0, the tool only supported text-based commands from the command-line; however, a GUI was added for easier usage.

Main Features

  • Conversion to and from OBJ and DAE file formats.
  • Automatically uses previous material settings on model replacement.
  • Copy and pasting of materials, shaders, and animations.
  • Regular expression pattern matching.
  • Interactive mode.
  • Text file commands.
  • Custom configuration (etc/abmatt/config.conf).
  • Presets (etc/abmatt/presets.txt)
  • Automatically checks and fixes.
  • Automatically detects model name of course, map, and vrcorn models.
  • Automatically adds map model bones.
  • Material library for easy access to user's preferred materials (v0.8.0).

Model Creation Geometry Details

  • Automatically detects encoding format to use.
  • Uses tristrips to create model geometry, saving file space.
  • Removes super small triangles that become lines.

Abmatt facepoint compare.png


The tool uses Wiimms Image Tool (wimgt) to convert images, which must be on the system's path.


v0.7.2 Demo

Version History

Version Date of release Information
v0.4.0 2020-06-15 First release
v0.5.0 2020-06-28
  • Added copy/paste command support.
  • Added feature for editing animations.
  • Added auto-fixing and checks.
v0.6.0 2020-07-20
  • Added installer for Windows and Linux.
  • Added configuration file.
  • Fixed a bug with copy/paste SRT0 layer.
v0.6.1 2020-07-20
  • Adjusted output for bug notification.
  • Added some options to configuration file.
v0.7.0 2020-09-19
  • Added convert command supporting conversion to and from "dae" and "obj" files.
  • Added image conversion and editing using Wiimms Image Tool and pillow.
  • Added ability to directly input a command on command-line in addition to the command-line options.
  • Changed installer to improve speed; now binaries are all put in one directory instead of one file.
  • Fixed numerous bugs that would cause crashes in-game.
v0.7.1 2020-09-21
  • Fixed Collada matrix parsing.
  • Fixed an issue that Windows Defender treated as a virus.
v0.7.2 2020-09-23
  • Updated to handle exporting multiple models.
  • Updated argument parsing.
v0.7.3 2020-09-24
  • Fixed compatibility issue with calling image converter on Linux systems.
  • Changed export of floats to avoid scientific notation.
v0.7.4 2020-09-27
  • Added Collada file units detection, which are converted to meters.
  • Applied bone transformation when exporting to OBJ.
  • Fixed a bug with importing textures beginning with the "file://" semantic.
  • Fixed a maximum recursion bug with large models.
v0.8.0 2021-01-09
  • Added a user-friendly GUI.
  • Added a material library.
v0.9.1 2021-02-14
  • Added export/import/replace support of specific models from GUI.
  • Fixed an issue combining OBJ geometries when importing.
v0.9.2 2021-04-11
  • Fixed an issue parsing DAE input offsets.
  • Updated to use fuzzy matching if material not found when replacing models.
v0.9.3 2021-04-14
  • Fixed blue fog bug and incorrect color register.
  • Fixed bug that overloaded image manager causing crashes.
v0.9.5 2021-04-27 Fixed an issue with encoding polygon data length that caused in-game blackscreens.
v0.9.6 2021-04-30
  • Fixed binding transformations of bones (single bind only).
  • Added single-bone conversion option.
v0.9.7 2021-05-09 Fixed an issue with importing OBJ single-binding to bone and rebuilding node tree.
v1.0 2021-05-24
  • Added rigged models support.
  • Fixed problems encoding/decoding influences.
  • Fixed missing material settings.
  • Changed the way SRT0 and PAT0 animations are linked to materials.
  • Added "--moonview" option to automatically rename materials based on Moonview Highway's requirements.
v1.0.2 2021-05-24 Fixed an installation issue.
v1.2 2021-06-15
  • Added include, exclude and patch options for converting models.
  • Increased default precision for point encoding.
v1.3.1 2021-10-20 Fixed some bugs.
v1.3.2 2022-06-05
  • Added advanced polygon conversion.
  • Added support for converting OBJ vertex colors and UVs.