This guide aims to help you resolve common issues without needing to file a bug report.

1. Make sure you've animated a texture. MoreMcmeta doesn't change the game until you animate a texture. See the default pack in the next bullet.

2. Try using the trial resource pack. If the trial textures work, there may be an issue with your textures.

   • Use a JSON validator to detect syntax issues in your .moremcmeta files.
   • Make sure your animation data has a .moremcmeta extension, not an .mcmeta extension.
   • Check the Animation Format Guide. In particular, make sure you defined a width and height for rectangular frames.
   • Please report the issue if you can't determine the cause. Include the textures/.moremcmeta files you are using.

3. Make sure you downloaded the mod from an official site.

4. Check that you are using a Forge or Fabric profile in the Minecraft launcher.

5. Ensure you installed the mod in the mods folder associated with your Forge or Fabric launcher profile.

6. Try removing all other mods. If MoreMcmeta works alone, there may be a compatibility issue. Add mods back to determine which one is causing the problem.

   • Please report the issue. However, compatibility issues with coremods or mods that alter Minecraft's texturing process will likely not be resolved.

7. If all else fails, report the problem. Include any textures/.moremcmeta files that are not working.

This issue may occur when you're using the MoreMcmeta emissive textures plugin. If you're using the .properties format to add an overlay to a texture and the .mcmeta format to animate that overlay, you might notice that the base animation and the overlay animation are not perfectly synchronized.

When you use the .properties format to add an overlay, and the base texture is animated with the .mcmeta format, MoreMcmeta will load the .mcmeta animation and disable Minecraft's default processing for it. However, it won't do anything with the overlay's .mcmeta animation, so that animation will be handled by Minecraft. Minecraft does not update textures on the menu screen, while MoreMcmeta does to enable animated GUIs. This means the animations can become desynchronized.

To fix this issue, you should use the .moremcmeta format or the .properties format to animate the overlay, rather than .mcmeta.

So far, users have not reported lag issues with MoreMcmeta. However, this section may help you reduce lag from MoreMcmeta if you do experience it.

Although you can install MoreMcmeta on a server without errors, it only does client-side work. Therefore, MoreMcmeta probably isn't the culprit if you're experiencing tick lag (block breaking delays, etc.).

However, if you are experiencing client-side lag, try these steps:

1. Remove MoreMcmeta from your mods folder to check if the lag issue persists. If you still have lag, MoreMcmeta probably isn't the cause.
2. Disable interpolation and daytime sync on each of your textures. Neither setting is enabled by default, so if you or your resource pack didn't enable it for a texture, you don't have to do anything.
3. Remove a few of the largest animated textures in your resource pack (the largest by individual frame size, not number of frames).
4. Report the problem. Please include your hardware information (graphics card manufacturer/series), your resource pack, and your mod list.

Animating a texture requires updating many pixels—the game has to do more work to render a frame. Because of this, animating many textures with MoreMcmeta can cause lag.

The game has to do even more work when frames are interpolated. It has to calculate the color of each pixel in the interpolated frame from the current frame and the next frame. Storing all of these interpolated frames for numerous textures does not work well because it would require a significant amount of memory.

To reduce the amount of work required for rendering, MoreMcmeta analyzes your textures when they are first loaded (during game startup or when you change your resource packs). It determines which pixels change throughout the animation. Then it selectively interpolates the pixels that change. For example, about 50% or more of a GUI texture's pixels can be skipped because they are transparent space.

Please ensure that you downloaded MoreMcmeta from an official site and are using the latest .jar file for your Minecraft version.

If that does not resolve the problem, report a bug. Include screenshots of the issue and example texture/.moremcmeta files.