GUI Scaler

Overview

GUI Scaler is a lightweight client-side utility mod that automatically adjusts your Minecraft GUI scale when you resize your game window or toggle fullscreen. No more squinting at tiny menus on large displays or oversized UI on small windows!

Features

• Automatic GUI Scaling - Dynamically adjusts GUI scale when window size changes
• Intelligent Detection - Uses pixel density detection for optimal readability
• Real-time Updates - Triggers instantly on screen open, fullscreen toggle, or window resize
• Two Scaling Modes:
  • AUTO Mode (Default) - Smart scaling based on resolution:
    • 2880x1800+ (HiDPI/Retina) → GUI scale 3
    • 1920x1080+ (Full HD) → GUI scale 2
    • 1280x720+ (HD) → GUI scale 1
    • Otherwise → GUI scale 0 (auto)
  • CUSTOM Mode - Define your own scaling rules in the config
• Multiloader Support - Works seamlessly on Fabric, Forge, and NeoForge
• Configurable - Easy-to-use config files for each platform

Why Use This Mod?

Perfect for players who:

• Switch between windowed and fullscreen modes frequently
• Play on high-resolution displays (1440p, 4K, or Retina)
• Use multiple monitors with different resolutions
• Want consistent UI readability without manual adjustments
• Stream or record at various resolutions

How It Works

The mod monitors screen initialization events and automatically calculates the optimal GUI scale based on your current window dimensions. The scaling algorithm considers both width and total pixel count to ensure the best visual experience across all display types.

Configuration

Fabric (Cloth Config)

Config file: config/guiscaler.json5

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

Forge/NeoForge

Config file: config/guiscaler-client.toml

#GUI Scaler Configuration
[general]
    #Enable automatic GUI scaling
    enableAutoScale = true
    #Scaling mode: AUTO (intelligent) or CUSTOM (user-defined rules)
    #Allowed Values: AUTO, CUSTOM
    mode = "AUTO"
    #Custom scaling rules in format 'width:scale' (e.g., '2560:3' means scale 3 for width >= 2560)
    customRules = ["2560:3", "1920:2", "1280:1"]