Перейти к содержимому
Mineforgian

OptiFrames

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

Загрузки
3K
Подписчики
17
Обновлён
29 марта 2026 г.
Лицензия
CC-BY-NC-4.0

Опубликован 2 марта 2026 г.

Исходный кодСообщить об ошибке

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.

Ченджлог

3.1.0Релиз26.1 · 29 марта 2026 г.

added support for minecraft 26.1

3.1.0Релиз1.21.11 · 29 марта 2026 г.

migrated yarn to mojang mappings

3.0.0Релиз1.21.11 · 15 марта 2026 г.

Features

  • Added atlas support for all map rendering, including held maps and cartography table previews
  • Improved atlas map texture update to reduce update time
  • Reworked map update detection to better identify when a texture really needs to be refreshed

Performance

  • Improved map rendering by skipping unnecessary vanilla render-layer calls when atlas rendering is active
  • Optimized map texture uploads so unchanged maps are not processed again
  • Improved atlas lifecycle handling on world leave to clean up textures
2.3.0Релиз1.21.11 · 6 марта 2026 г.

Features

  • Added config option to choose between OptiFrames optimized or vanilla item frame model rendering
  • Added config option to render item frame back faces (optional, slight performance cost for improved vanilla parity)
  • Removed item frame border rendering toggle (no performance impact, now always enabled)

Performance

  • Combined border and back-face rendering into single render pass
  • Frame model no longer rotates with map rotation (architectural fix)

Bug Fixes

  • Fixed item frame borders rotating along with map rotation when using optimized model
  • Fixed incorrect UV normals on frame border geometry causing visual artifacts
  • Fixed glowing item frame borders rendering at full brightness instead of using proper light values
  • Frame border textures now precisely match vanilla item frame model UVs
2.2.0Релиз1.21.11 · 4 марта 2026 г.

Performance

  • Atlas texture updates now only upload the changed 128x128 map section instead of the entire atlas, significantly reduces lag spikes when maps update
  • Map dirty page tracking moved to world tick instead of checking every entity
  • Pre-computed rotation calculations: map rotations now use cached values instead of recalculating math every single frame
  • Direction lookups optimized: uses fast lookup tables instead of runtime calculations for neighbor detection

You can expect a gain of ~10-15 FPS compared to last version

Bug Fixes

  • Fixed atlas size configuration not being editable, now properly changes on world rejoin
2.1.0Релиз1.21.11 · 3 марта 2026 г.

optimized how borders updates

2.0.1Релиз1.21.11 · 3 марта 2026 г.

fixed a bug with decorations

2.0.0Релиз1.21.11 · 3 марта 2026 г.

New Features

  • Texture Atlas: All map textures are now packed into shared atlas pages, reducing hundreds of GPU draw calls to just one per page. Massive FPS improvement with unique maps.
  • Multi-page atlas: Automatically creates additional atlas pages when one is full — no limit on map count.
  • Atlas size setting: Choose atlas texture size (1024–GPU max) in the config screen. Default 4096 works for most setups.
  • Decorations toggle: New config option to enable/disable map decorations (player markers, banners, etc.).

Комментарии

Загружаем…