GUI Scaler

GUI Scaler

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

by
5.5K Downloads
fabricforgeneoforgeutility
Rent Server with this Mod

About this Mod

GUI Scaler

Never adjust GUI scale manually again. GUI Scaler automatically scales your Minecraft GUI based on window size — whether you resize, toggle fullscreen, or switch monitors.

✨ Features

  • Automatic GUI Scaling — Dynamically adjusts GUI scale when your window size changes
  • Intelligent Detection — Uses pixel density detection for optimal readability on any display
  • Real-time Updates — Triggers instantly on screen open, fullscreen toggle, or window resize
  • Two Scaling Modes — Smart AUTO mode or fully customizable CUSTOM mode
  • Multiloader — Works on Fabric and NeoForge (Forge supported up to 1.21.4)
  • ModMenu Support — Fabric users get an in-game config screen via ModMenu

🎯 Scaling Modes

AUTO Mode (Default)

Resolution GUI Scale
2880x1800+ (HiDPI/Retina) 3
1920x1080+ (Full HD) 2
1280x720+ (HD) 1
Otherwise 0 (auto)

CUSTOM Mode

Define your own width → scale rules in the config file.

⚙️ Configuration

Fabric (config/guiscaler.json5):

{
  "enableAutoScale": true,
  "mode": "AUTO",
  "customRules": {
    "2560": 3,
    "1920": 2,
    "1280": 1
  }
}

NeoForge (config/guiscaler-client.toml):

[general]
  enableAutoScale = true
  mode = "AUTO"
  customRules = ["2560:3", "1920:2", "1280:1"]
  • enableAutoScale — Toggle automatic scaling on or off
  • modeAUTO (intelligent) or CUSTOM (user-defined rules)
  • customRules — Custom width:scale mappings for CUSTOM mode

📦 Supported Platforms

Loader Required Dependencies
Fabric Fabric API, Cloth Config
NeoForge
Forge (up to 1.21.4 only)

🔗 Links

Available Versions

GUI Scaler 1.21.1-1.1.0 [NeoForge]release
MC 1.21.1neoforge
May 31, 2026
GUI Scaler 1.21.1-1.1.0 [Forge]release
MC 1.21.1forge
May 31, 2026
GUI Scaler 1.21.1-1.1.0 [Fabric]release
MC 1.21.1fabric
May 31, 2026
GUI Scaler 1.21.4-1.2.0 [NeoForge]release
MC 1.21.4neoforge
May 31, 2026
GUI Scaler 1.21.4-1.2.0 [Forge]release
MC 1.21.4forge
May 31, 2026

How to Install GUI Scaler on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.1).

3

Install Mod

Open the mod browser in the dashboard and search for "GUI Scaler". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricforgeneoforge

Minecraft Versions

26.1.1, 26.1, 1.21.11 (+3 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

GUI Scaler server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.1). You can switch loaders with one click in the panel.

Is GUI Scaler compatible with fabric and forge and neoforge?

GUI Scaler officially supports fabric, forge, neoforge for Minecraft 26.1.1, 26.1, 1.21.11. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with GUI Scaler – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if GUI Scaler consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install GUI Scaler with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v3.0 only
Server-side
Unsupported

Supported Versions

26.1.126.11.21.111.21.41.21.11.20.1