FAQ
I need help with an issue. What information should I provide?
To get the best help, please provide as much context as possible:
- A clear description of the problem: What did you expect to happen, and what actually happened?
- Your
latest.logfile: Find it at<game-directory>/logs/latest.log. Do not send a crash log unless specifically requested;latest.logusually contains the needed context. Use a site such as https://gist.github.com when posting it. - Your Minecraft Version: (e.g., 1.20.1)
- Your Mod Loader and Version: (e.g., Forge 47.2.0, Fabric 0.15.7)
- Your FancyMenu Version: (e.g., 3.5.2)
- Screenshots or videos of the issue can also be very helpful.
How do I change the layering of elements (move something in front of or behind another)?
- Custom vs. Custom: Open Window -> Editor Widgets -> Layers and drag elements in the hierarchy. You can also right-click an element and use Move One Layer Up/Down. See Layers and Groups.
- Custom vs. Vanilla: To render all your custom elements behind all vanilla elements (e.g., to put a background image behind the default buttons), right-click the editor background and toggle the option "Render Custom Elements Behind Vanilla".
Can I exclude certain buttons from a universal button template?
No. If a template button has custom textures set, these textures are always shared with all affected elements. You cannot exclude individual buttons.
How do I make a button do something when clicked?
Use an Action Script.
- Right-click the button in the editor.
- Select Edit Action Script.
- Click Add Action and choose an action, such as Open Screen or Custom GUI, Join Server, or Set Variable Value.
Can I create a completely new menu screen from scratch?
Use a Custom GUI.
- In the menu bar, go to Customization -> Custom GUIs -> Manage Custom GUIs.
- Click "New GUI" and give it a unique identifier.
- You can then open this new empty screen and create a layout for it, adding any elements you want.
- Open the Custom GUI with the Open Screen or Custom GUI action.
My game is taking a long time to load after enabling pre-loading.
This is expected behavior. Pre-loading large resources like high-resolution animations or sounds during the initial startup will naturally increase the game's loading time.
My FMA animation is using too much RAM!
Classic FMA animations can consume a lot of memory when they contain many high-resolution frames. AFMA is better suited to large or complex animated textures. Keep classic FMA animations short; use Video for full video playback.
Does FancyMenu work with OptiFine?
No. OptiFine is not compatible and is known to break many mods, including FancyMenu. It is highly recommended to use modern alternatives like Sodium/Embeddium + Iris/Oculus.
See OptiFine Alternatives.
My game is crashing. How do I figure out if it's a mod conflict?
The best way to check for a mod conflict is to run the game with only FancyMenu and its dependencies (Konkrete, Melody). If the crash no longer occurs, you can add your other mods back in small groups until the crash happens again to identify the conflicting mod.
A button from another mod disappears or doesn't work when I try to edit it.
Some mods add widgets in ways FancyMenu cannot detect or customize. Check Vanilla/Mod Elements and, for list-based screens, Customizing Scrollable Screens. If the widget still does not appear, the mod that adds it must expose it as a supported screen widget.
Can I use FancyMenu layouts on a server?
Layouts and visual customizations are stored on the player's client; a server cannot force them onto an unconfigured client. Distribute them as part of a modpack. Install FancyMenu on the server when you need server commands, FM Data, server-side NBT access, gamerules, structures, or server listeners.
What's the difference between FancyMenu v2 (for older MC versions) and v3?
FancyMenu v3 is a complete rewrite with many new features, a more stable architecture, and better performance. V2 is outdated, no longer supported, and missing many features like advanced placeholders and scripting. It is highly recommended to use v3 on a modern Minecraft version (1.18.2+). V2 layouts can be automatically converted to v3 when you load them, but some manual fixing may be required.
Where can I find pre-made layouts and templates?
The FancyMenu community shares layouts in the #layout-templates channel on the official Keksuccino's Mods Discord server ("Kekscord").
How can I make the Player Entity render behind other elements?
You generally cannot force a Player Entity element behind normal 2D elements through the Layers widget. Its renderer can ignore normal GUI layer order. Design the layout around that limitation or use a pre-rendered image when strict layer ordering is required.
My Player Entity has only one leg! What happened?
This is a visual glitch, likely caused by a mod conflict with another mod that alters player animations or models. Check the Player Entity's Pose settings to see if the legs have been rotated or moved by accident.
How do I create a delay between actions in a script?
Use Delay or Execute Later blocks for delayed action logic. For repeating background logic, use Schedulers.
Can I customize menus from the Create mod?
No. Customization is intentionally disabled for Create screens. See Screens where customization is intentionally disabled.
What is the recommended resolution for background images and button textures?
Backgrounds: A standard 1920x1080 (1080p) image is a great starting point and will scale well for most users.
Buttons: Most vanilla buttons are around 150-200 pixels wide and 20 pixels high. Matching this size for custom textures is a good practice for consistency.
Is there a way to automatically open a menu or run a command when a player completes an in-game objective (like a quest)?
FancyMenu has many built-in game-event listeners, but there is no generic listener for every third-party quest system. If the quest mod supports command rewards, use one to run /openguiscreen, /fmvariable, or another suitable FancyMenu command.
How do I make a button inactive or "grayed out"?
You can control a button's active state using Loading Requirements.
Right-click the button in the editor and select Control Active State.
Add a requirement that must be met for the button to be active. To permanently disable it, use Is Number to check whether 0 equals 1.
The button will now use its "Inactive Background" texture and will be unclickable.
How can I remove the header and footer (the dirt texture bars) on scrollable screens?
In the layout editor, open Layout Properties -> Header/Footer Customizations. Set the textures to transparent. This option may be unavailable on some modded screens.
I can't create a layout "for the current screen". The button is greyed out.
You need to enable customizations for that screen first through menu bar -> Customization -> Current Screen Customizations -> Enabled.
I can't customize any elements of a screen when opening it in the editor. It's just an empty screen then.
This could mean you created a Universal Layout instead of one for the current screen.
It could also be a scrollable screen, which FancyMenu cannot customize by default.
The third possibility is that it's a screen from a mod that adds elements in a non-Vanilla way, which makes FancyMenu unable to customize these elements.
There are weird grey boxes at my Text element.
These translucent boxes are the scroll grabbers of the Text element, not a rendering bug.
If you don't want these boxes to be visible, you can either right-click the element and disable scrolling completely OR you can also set the grabber textures to completely transparent ones in the same right-click menu, if you want the element to be still scrollable.
How can I show the latest Minecraft changelog in my menus?
There's a great GitHub project that converts Minecraft's changelogs to FancyMenu-compatible Markdown, so you can show the latest MC changelog in your menus! It updates daily to fetch new changelogs.
To show it in a Text element, set Source Mode to Resource and its resource source to Web. Use https://clay.is-a.dev/minecraft-changelogs-markdown/{"placeholder":"mcversion"}/fancymenu.md.
What's the easiest way to stretch any element to the size of the screen?
Most elements have an option in their right-click context menus to stretch them horizontally and vertically. Enabling this will make them always stretch to the full width and/or height of the screen. Horizontal and vertical stretching can be toggled independently.
I can't click buttons or interact with sliders when they are behind or in front of a Text element.
This happens because Text elements are interactable by default (to be able to grab the scroll grabber or click Markdown hyperlinks), which means they consume mouse clicks and scroll events. The best way would be to simply not move buttons behind/in front of Text elements, but if there is no way around it, you can make the Text element not interactable by right-clicking it and then setting Interactable to Disabled. Keep in mind this makes the Text element a static, non-interactable text, so you can't scroll it anymore or click on hyperlinks.
How can I make it so buttons and sliders do not get selected/focused anymore when navigating in screens with the Arrow and Tab keyboard keys?
To make buttons and sliders not navigable, you need to right-click it and set Navigable to Disabled. The button/slider will still be clickable, but you can't focus it with Arrow/Tab navigation anymore.
This is also useful if you want to add buttons/sliders to the Chat screen, so you can still use the Arrow Up key to scroll through older messages without accidentally selecting buttons/sliders in the screen.
One of FancyMenu's context menus is missing an option that should be there.
FancyMenu's context menus (the menus that open when you right-click somewhere or when you interact with menu bars) are SCROLLABLE. This means you can use your scroll wheel while your mouse cursor is over the menu to scroll up or down, which let's you see more options that were previously not visible.
I can't customize the Title screen, it keeps showing the original when I leave the editor.
Another mod is replacing the original title_screen. Disable that mod's custom Title screen in its settings. If it has no such option, FancyMenu cannot apply the layout to the replacement screen.