Wiki 9Minecraft Wiki 9Minecraft

Special Model Loader Mod FAQ

10 questions players actually ask, answered.

Do I need to install this mod by itself or does another mod install it for me?
Special Model Loader Mod is a library dependency, meaning other mods require it to function. Check your modpack or mod documentation to see if it's already included; if a mod needs it and it's missing, you'll get an error on startup.
What 3D file format does this mod support?
This mod loads OBJ files, which is a standard 3D model format. MTL (material) files are also supported for defining basic material properties, but complex shader effects are not.
Can I use OBJ models for custom items, blocks, or both?
You can use OBJ models for both custom items and blocks. The approach differs slightly between the two—items typically use models for held/dropped states, while blocks use them for placement in the world.
Where do I put my OBJ files so the mod can find them?
OBJ files should be placed in your mod's assets folder, typically under `assets/modid/models/` or a similar custom path defined in your mod's code. The exact location depends on how the mod using this library specifies model directories.
My OBJ model looks wrong in-game—it's stretched, rotated, or inside-out. What went wrong?
Check that your model was exported with the correct scale and rotation from your 3D editor. Minecraft uses a specific coordinate system; if your model was created in a different orientation, you may need to rotate or flip it before export, or adjust the rotation values in your mod's model loader code.
How do I add textures to my OBJ models?
Create an MTL file alongside your OBJ with the same name, then reference texture image files in the MTL. The textures should be PNG files placed in your mod's texture assets folder, and the MTL must point to them with correct relative paths.
Will loading lots of OBJ models slow down my game?
Complex or high-polygon models can impact performance, especially if many are rendered at once. Use the optimization guide to reduce polygon counts, combine textures into atlases, and avoid unnecessary detail in areas players won't see closely.
Can I use OBJ models from websites like Sketchfab or TurboSquid directly?
You can download OBJ models from those sites, but they often need adjustment—check the license first, then optimize the model for Minecraft's scale and performance requirements before using it in your mod.
Does this mod work with Sodium, Optifine, or other rendering mods?
Special Model Loader Mod is designed to work with Fabric and most Fabric-compatible rendering mods, though compatibility with specific optimization mods can vary. Test in your modpack to confirm; if conflicts occur, check mod documentation or community forums for known issues.
What happens if a mod that depends on this library is installed but this mod isn't?
The game will crash on startup with a dependency error, usually stating that the required library is missing. Install Special Model Loader Mod to resolve it.