Back to mods
NekoUI project artwork

Modrinth · Minecraft mod

NekoUI

Bring a fresh UI experience to Minecraft with NekoUI and customizable backgrounds for endless variety.

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

Quick answer

Which NekoUI release should I use?

Updated 10 months ago
Latest stable file v1.0.3-neoforge
Game version 1.20.5, 1.20.6
Loader NeoForge

NekoUI v1.0.3-neoforge targets 1.20.5, 1.20.6 with NeoForge. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.

Where it goes

Is NekoUI required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

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

This file is marked client-only.

What else does NekoUI v1.0.3-neoforge need?

v1.0.3-neoforge. Change the file and its required mods may change too.

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 NekoUI without breaking your instance.

Built for NekoUI v1.0.3-neoforge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use v1.0.3-neoforge. It targets 1.20.5, 1.20.6 with NeoForge; 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

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside v1.0.3-neoforge. It opens that exact file at the source.

About this project

What does NekoUI add?

NekoUI

Github
Modrinth
CurseForge
Enviroment
Codacy Badge

License
Issues
Release
Crowdin
Github Star

Bring a fresh UI experience to Minecraft with NekoUI and customizable backgrounds for endless variety.


NekoUI: Java Edition has been migrated to HorizonUI: Java Edition, and will not receive any update.

Installation

To get started, download the mod .jar file from one of the trusted platforms or official sources below.

Trusted Platfroms

Official Sources


How To Use

  1. Place the downloaded .jar file into your Minecraft mods folder:
  2. On Windows: C:\Users<YourName>\AppData\Roaming.minecraft\mods
  3. On Linux/macOS: ~/.minecraft/mods
  4. Make sure you’re running a compatible mod loader.
  5. Launch the game, and NekoUI should be active!

Using a custom launcher?

If you're using MultiMC, Prism Launcher, GDLauncher, or any custom launcher, simply add the mod to the instance's mods folder, or import it using the launcher’s built-in mod manager.


Compatibility

NekoUI focuses heavily on UI customization, including layout and background visuals. As a result, mods that also modify the Minecraft user interface or background rendering may conflict with NekoUI.

Common sources of incompatibility include:

  • Mods that overhaul or replace the main menu or HUD elements.
  • Shader-related mods that modify UI layers or apply post-processing to 2D elements.
  • Mods that change how background images or textures are loaded and rendered.

If you are experiencing issues such as overlapping elements, broken backgrounds, or UI not appearing as expected, please review your mod list for potential conflicts with UI-altering mods.


Recommendations

To enhance your UI experience while using NekoUI, it is highly recommended to install font customization mods that replace the default Minecraft font.

Suggested mods:

  • BetterFonts
  • Smooth Font
  • Caxton
  • Or any mod that allows replacing Minecraft's default font with clean, modern fonts like Poppins, Inter, or Segoe UI.

Using a modern font will significantly improve readability and the overall visual consistency of the interface customized by NekoUI.


FAQ (Frequently Asked Questions)
  • Why isn't the animated background showing up?

  • I've downloaded the animated background, but it's still not showing on the title screen. Why?

    • Make sure you've enabled the background resource pack in the Resource Packs menu. Then, go to the mod configuration screen to select your desired background.
  • What's the minimum system requirement to run this mod smoothly?

    • We recommend allocating at least 4–6 GB of RAM, and using a processor equivalent to Intel Core i5 8th Gen or better with an integrated GPU.
  • Where do I report bugs or issues?

  • Is NekoUI compatible with other UI or shader mods?

    • NekoUI aims to be compatible with most mods, but UI or shader mods may conflict. If you find issues, try disabling other mods temporarily or report the conflict to us.
  • How do I reset NekoUI settings to default?

    • You can delete the NekoUI configuration file found in the config/nekoui folder within your Minecraft directory.
  • Does NekoUI support older versions of Minecraft?

    • Yes, but updates are released gradually per version. If your version isn't supported yet, please wait for upcoming releases.

Credits

Huge thanks to everyone involved in making NekoUI possible:

  • nokarin (Mod Developers, Code QC, UI Designer, Translator, Mod Tester)
  • Han's (Founder, Translator, UI Designer)
  • AetherLumine (Translator)
  • howtoscriptinpython (Translator for russian & ukraine)
  • ExplerHD (Mod Tester)
  • noxzym (Mod Tester)
  • alfaruqi (Translator for arabic, brazil, mexican, italian, german, and georgian)

License

NekoUI: Java Edition is licensed under All Rights Reserved License.
- © 2026 Han's Projects.
- © NekoUI: Java Edition 2026 - All Rights Reserved.
- © 2019-2026 Strivo Development - All Rights Reserved.

Disclaimer: This project is not affiliated with Nexon, NAT GAMES, or Yostar — the official developers of the Blue Archive game.

Check our roadmap and plans on here

Project description from Modrinth.

Pick your setup

NekoUI by Minecraft version and loader

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

74 available setups

Showing the newest 12 of 19 game versions. Older files are in the list below.

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

Recent files

NekoUI versions and loaders

98 of 98 releases match

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