Back to mods
FancyMenu APNG Loop Fix project artwork

CurseForge · Minecraft mod

FancyMenu APNG Loop Fix

Client-side fix for FancyMenu play-once APNG replay + synchronized hover tear/regen.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which FancyMenu APNG Loop Fix release matches 1.20.1 Forge?

Updated 5 months ago
Best match for your filters fmloopfix-1.1.1.jar
Game version 1.20.1
Loader Forge

FancyMenu APNG Loop Fix fmloopfix-1.1.1.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is FancyMenu APNG Loop Fix required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does FancyMenu APNG Loop Fix fmloopfix-1.1.1.jar need?

fmloopfix-1.1.1.jar on 1.20.1 Forge. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add FancyMenu APNG Loop Fix without breaking your instance.

Built for FancyMenu APNG Loop Fix fmloopfix-1.1.1.jar on 1.20.1 Forge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use fmloopfix-1.1.1.jar. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside fmloopfix-1.1.1.jar. It opens that exact file at the source.

About this project

What does FancyMenu APNG Loop Fix add?

Overview

Ai used for the icon ( no ai used in coding other than general code assistant)

FancyMenu APNG Loop Fix is a small, client-side Forge mod for Minecraft 1.20.1 that unlocks advanced animated menu buttons in FancyMenu.

FancyMenu can use APNG (animated PNG) files as custom button backgrounds. That is powerful for title screens and GUIs — but out of the box, play-once animations cannot reliably replay on every hover. This mod fixes that limitation and adds logic so paired normal and hover animations stay in sync.

It was originally built for the Liminal Industries Rescripted modpack: Backrooms-style title menu buttons that look invisible at rest, tear open on hover, then slowly heal shut when you move away — without looping or getting stuck after the first hover.


Main features

  • APNG replay fix — Patches FancyMenu so loop=1 (play once, then hold) animations can restart after they finish. Without this, the first hover works and later hovers stay frozen.

  • Synchronized dual-texture playback — Keeps a button's normal and hover APNG backgrounds mirrored frame-for-frame during rip, regen, and idle states.

  • Tear-on-hover, heal-on-unhover — Hover plays the rip animation once and holds open. Un-hover runs a slow regen on the normal texture. Re-hover resumes the tear from wherever the button had healed to.

  • Idle breathing at rest — After fully healed, the mod loops only the breathing section of the normal APNG so buttons feel alive while staying mostly transparent.

  • Client-only — Menus are rendered on the client. This mod is not required on dedicated servers and will not affect gameplay.


The problem this mod solves

In FancyMenu's APNG handler, when an animation finishes with loop=1, an internal flag is set and never cleared when the texture is reset. The playhead may rewind, but the animation engine refuses to tick forward again.

That leaves you with two bad options:

  • Play once (loop=1) — no infinite looping, but cannot replay on re-hover.
  • Infinite loop (loop=0) — can reset, but the tear keeps cycling while hovered.

This mod adds a third path: play once, replay every hover, never loop while held.


How to use this mod

For players

  1. Install Minecraft 1.20.1, Forge 47+, and FancyMenu 3.6+.
  2. Place fmloopfix-1.0.0.jar in your mods folder alongside FancyMenu.
  3. Launch the game. If your pack or layout already uses compatible FancyMenu APNG buttons, the effect works automatically — no config file or keybind.

You do not need this mod on a server to join multiplayer. It only affects how your client draws FancyMenu widgets.

For FancyMenu / pack authors

This mod is designed for buttons that use two APNG backgrounds:

  • Normal background — regen (heal) frames + optional idle breathing loop at the end.
  • Hover background — rip/tear frames that play once and hold on the last frame.

Recommended FancyMenu layout settings per button:

  • restartbackgroundanimations = false — the mod owns playback timing.
  • Unique APNG file path per button — FancyMenu shares animation state by path; duplicate paths = broken sync.
  • Export APNGs with loop=1 for both normal and hover textures.

Normal APNG structure (recommended):

  1. Regen frames — peel/heal from open back to closed.
  2. Breathing frames — subtle idle pulse after regen (mod loops this section when healed).

Hover APNG structure (recommended):

  1. Start transparent or closed.
  2. Rip frames — tear open once.
  3. Hold on the final open frame.

Modpack integration

  • Mark as a client dependency in your CurseForge modpack.
  • Add a hard dependency on FancyMenu.
  • Ship your FancyMenu layout + APNG assets; this jar is the runtime that makes the animation behavior work.

Requirements

Minecraft 1.20.1
Mod loader Forge 47+
Required mod FancyMenu 3.6+
Side Client only

Disclaimer

This is not an official FancyMenu addon. FancyMenu APNG Loop Fix is an independent compatibility patch created by Liminal Industries. It is not affiliated with, endorsed by, or maintained by Keksuccino (the FancyMenu author). FancyMenu remains a separate project.

Intended use: Built for the Liminal Industries Rescripted modpack's Backrooms-themed main menu — invisible-at-rest buttons, wallpaper-reveal tears, slow regen, and idle breathing on the title screen. Published so other packs and FancyMenu authors can reuse the same pattern without manually patching FancyMenu.

What this mod does not do:

  • Does not add items, blocks, or gameplay mechanics.
  • Does not change server gameplay or world generation.
  • Does not replace FancyMenu — you still configure layouts and assets in FancyMenu.
  • Does not guarantee behavior on every FancyMenu version (targets 3.6.x on 1.20.1 Forge).

Uses Mixins to adjust FancyMenu's APNG texture behavior at runtime. Use at your own discretion.


Credits

  • Author: Liminal Industries
  • License: MIT
  • Built for: Liminal Industries Rescripted
  • Patches behavior in: FancyMenu by Keksuccino

Project description from CurseForge.

Pick your setup

FancyMenu APNG Loop Fix by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

FancyMenu APNG Loop Fix versions and loaders

2 of 2 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.