
GUI Scaler
Automatically adjusts Minecraft GUI scale based on window resolution. Smart scaling for optimal readability on any screen size.
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 offmode—AUTO(intelligent) orCUSTOM(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
How to Install GUI Scaler on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.1).
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
Minecraft Versions
26.1.1, 26.1, 1.21.11 (+3 more)
Server-side
✗ UnsupportedRecommended 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.
Similar Mods
Rent Modded Server
Install GUI Scaler with just one click on your server.