Back to mods
OptiFrames project artwork

CurseForge · Minecraft mod

OptiFrames

A lightweight, client-side Fabric mod that optimizes large map display rendering and significantly improves FPS in demanding situations

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

Quick answer

Which OptiFrames release should I use?

Updated 7 months ago
Latest stable file optiframes-mc26.1-3.1.0.jar
Game version 26.1
Loader Fabric

optiframes-mc26.1-3.1.0.jar targets 26.1 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

Is OptiFrames 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 Fabric
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 optiframes-mc26.1-3.1.0.jar need?

optiframes-mc26.1-3.1.0.jar. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

5 listed on this file 2 pulled in by those mods
Mod Menu Optional for optiframes-mc26.1-3.1.0.jar
optional
Matching file found Matched file: v18.0.2 for 26.1
Fabric API Needed by optiframes-mc26.1-3.1.0.jar
required
Matching file found Matched file: [26.1.2] Fabric API 0.155.3+26.1.2
Mod Menu Optional for optiframes-mc26.1-3.1.0.jar
optional
Matching file found Matched file: 18.0.2
Cloth Config API Optional for optiframes-mc26.1-3.1.0.jar
optional
Matching file found Matched file: 26.1.154+fabric
Text Placeholder API Needed by Mod Menu
pulled in
Matching file found Matched file: placeholder-api-3.0.0+26.1.jar

2 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add OptiFrames without breaking your instance.

Built for optiframes-mc26.1-3.1.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use optiframes-mc26.1-3.1.0.jar. It targets 26.1 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

  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 optiframes-mc26.1-3.1.0.jar. It opens that exact file at the source.

About this project

What does OptiFrames add?

OptiFrames

A lightweight, client-side Fabric mod that makes large map displays render cleaner and smoother without changing their appearance.

Performance Test with 40x40 and 70x70 map

Test are made with Sodium but you can expect same gain without it.

performance img

Why use OptiFrames?

  • Optimized rendering: hides redundant borders between adjacent maps.
  • Texture Atlas: all map textures are packed into a shared atlas, drastically reducing GPU draw calls.
  • FPS boost: expect up to 9x FPS increase with large maps.
  • Map decoration support: player markers, banners, and other map icons still render correctly.
  • Lightweight: designed to work well alongside Sodium and Iris.

Installation

  1. Download the latest optiframes-<version>.jar from the Modrinth/Curseforge page.
  2. Place the JAR in your mods folder.
  3. Start Minecraft using a Fabric profile.

Configuration

You can configure the mod with Mod Menu:

  • Enable/Disable Optiframes entirely.
  • Frame Render Type — choose between vanilla and optimized frame model rendering.
  • Frame borders — toggle frame border rendering for extra performance.
  • Back Face Rendering — toggle rendering of item frames back face.
  • Atlas size — choose the atlas texture size, Bigger = more maps per draw call. Default 4096 works great for most setups.

Compatibility

  • Client-side only — safe to use on any server.
  • Works well with Sodium and Iris.
  • Tested on every available version.

Troubleshooting

  • Mod not appearing in Mod Menu: confirm the JAR is in mods and you launched the Fabric profile.
  • Crashes: please attach latest.log and any crash-reports when opening an issue.

Project description from CurseForge.

Pick your setup

OptiFrames by Minecraft version and loader

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

2 available setups

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

Recent files

OptiFrames versions and loaders

9 of 9 releases match

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