GUI Scaler

Automatically adjusts Minecraft GUI scale based on window resolution. Smart scaling for optimal readability on any screen size.

File Details
DownloadInstall

GUI Scaler 1.21.1-1.1.0 [NeoForge]

ByNetleak
  • R
  • May 31, 2026
  • 424.36 KB
  • 17
  • 1.21.1
  • NeoForge

File Name

guiscaler-1.21.1-1.1.0-neoforge.jar

Supported Versions

  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:gui-scaler-1373686:8175409"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

Changelog

All notable changes to GUI Scaler will be documented in this file.

The format is based on Keep a Changelog.

[1.1.0] - 2026-05-31

Changed

  • Auto-scale now only re-applies the GUI scale when the window size actually changes (resize / fullscreen toggle) instead of on every screen open, so the mod sets the default GUI scale while manual changes in Sodium / vanilla options stick (#3).

Fixed

  • Backported the reentrancy guard preventing a StackOverflowError when resizing the window (recursive GUI scaling triggered by resizeGui() re-initializing the current screen).

[1.0.4] - 2026-05-02

Changed

  • Extracted ModMenu integration to a separate class to avoid resolving client-only ModMenuApi from the main entrypoint on dedicated servers

[1.0.3] - 2026-03-14

Fixed

  • GUI scale not applying visually when window is maximized before menu loads (added resizeDisplay() call)
  • Fabric dev launcher crash caused by duplicate ASM classes on classpath
  • Downgraded Fabric Loom from unstable 1.10-SNAPSHOT to stable 1.9.2

[1.0.2] - 2025-11-02

Added

  • Fabric: missing dependencies

[1.0.1] - 2025-10-28

Fixed

  • Client only

[1.0.0] - 2025-10-27

Added

  • Automatic GUI scaling based on window resolution
  • Intelligent AUTO mode with pixel density detection
    • 2880x1800+ (HiDPI/Retina) → scale 3
    • 1920x1080+ (Full HD) → scale 2
    • 1280x720+ (HD) → scale 1
  • CUSTOM mode for user-defined scaling rules
  • Multiloader support (Fabric, Forge, NeoForge)
  • Configuration system for each platform
    • Fabric: owo-lib with full custom rules support
    • Forge: ForgeConfigSpec with default rules
    • NeoForge: ModConfigSpec with default rules
  • Dynamic scaling on screen open events
  • Platform abstraction via IPlatformHelper service loader

Technical Details

  • Common module: GUIScaleCalculator, ScaleMode enum, ConfigProvider interface
  • Fabric: ScreenEvents.AFTER_INIT callback
  • Forge: ScreenEvent.Init.Post event with MinecraftForge.EVENT_BUS
  • NeoForge: ScreenEvent.Init.Post event with NeoForge.EVENT_BUS
  • All platforms implement IPlatformHelper for GUI scale operations