GUI Scaler

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

File Details

GUI Scaler 26.1.2-1.4.1 [Fabric]

  • R
  • Jul 3, 2026
  • 424.07 KB
  • 64
  • 26.1.2+2
  • Fabric

File Name

guiscaler-26.1.1-1.4.1-fabric.jar

Supported Versions

  • 26.1.2
  • 26.1.1
  • 26.1

Curse Maven Snippet

Fabric

modImplementation "curse.maven:gui-scaler-1373686:8365231"

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.4.1] - 2026-05-31

Added

  • Marked Minecraft 26.1.2 as supported (binary-compatible with the 26.1.1 build; no code changes).

[1.4.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).

[1.3.1] - 2026-04-19

Fixed

  • Fabric: customRules in config/guiscaler.json5 duplicating on every launch due to Jankson appending defaults to the loaded list. Added validatePostLoad() that deduplicates the list while preserving order.

Changed

  • Fabric: extracted ModMenu integration into a dedicated GuiScalerModMenuIntegration class (per Cloth Config docs), keeping GuiScaler as a pure ModInitializer.

[1.3.0] - 2026-04-18

Changed

  • BREAKING: Updated to Minecraft 26.1.x (builds against 26.1.1, supports 26.1 and 26.1.1)
  • Updated Java requirement to 25 (Minecraft 26.1+ requires Java 25)
  • Updated Fabric API to 0.145.4+26.1.1
  • Updated Fabric Loader to 0.18.6
  • Updated NeoForge to 26.1.1.15-beta
  • Updated Cloth Config to 26.1.154
  • Updated pack format to 101
  • Switched ModMenu dependency from CurseMaven to Terraformers Maven (18.0.0-alpha.8)

Removed

  • Parchment mappings (Mojang de-obfuscated parameter names in 26.1+, making Parchment redundant)

[1.2.2] - 2026-04-16

Fixed

  • StackOverflowError crash when resizing the window (especially on Wayland). Added a reentrancy guard to prevent recursive GUI scaling calls triggered by resizeDisplay() re-initializing the current screen (#2)

[1.2.1] - 2026-03-21

Fixed

  • Fabric: custom rules not saving correctly in the config GUI (switched to string list representation)

Changed

  • Upgraded SonarQube plugin for Gradle 9 compatibility
  • Upgraded GitHub Actions to Node.js 24 compatible versions

[1.2.0] - 2026-03-14

Changed

  • Updated to Minecraft 1.21.11
  • Upgraded Gradle to 9.2.1
  • Upgraded Fabric Loom to 1.14
  • Updated Fabric API to 0.141.3+1.21.11
  • Updated Fabric Loader to 0.18.1
  • Updated NeoForge to 21.11.38-beta
  • Updated Cloth Config to 21.11.153
  • Updated Parchment mappings to 1.21.11 BLEEDING-SNAPSHOT
  • Updated pack format to min/max 75
  • Replaced FMLLoader.isProduction() with FMLEnvironment.isProduction() for NeoForge

Removed

  • Forge platform support (ForgeGradle does not support Gradle 9)

[1.1.0] - 2026-03-14

Changed

  • Updated to Minecraft 1.21.4
  • Updated Fabric API to 0.110.5+1.21.4
  • Updated Forge to 54.1.0
  • Updated NeoForge to 21.4.147
  • Updated Cloth Config to 17.0.144
  • Updated Parchment mappings to 2024.12.29
  • Updated pack format to 46
  • Added Jade as optional test dependency
  • Removed JEI (Fabric/Forge) and EMI (NeoForge) - no 1.21.4 builds available
  • Updated CI deploy to target MC 1.21.4

[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