Auto Window Size

Auto Window Size

A Minecraft 1.20.1 / Forge client-side mod — auto window sizing, centering, minimum-size lock, fixed window size, borderless mode, always-on-top, and auto-fullscreen on launch.

⚠ Platform notice: this mod only supports desktop Minecraft (Windows / macOS / Linux). It does not work on mobile / Bedrock.

📮 About the source: the author is new to GitHub / Git and once caused some messy repository state during an update. If the source you downloaded does not match the released jar, email [email protected] for the correct source.

中文

What it does

When building a modpack you spend ages arranging mod GUIs exactly right — then a player launches on a different resolution, the window resizes, and every layout breaks. Auto Window Size turns "game window size" from a lucky accident into a deliberate choice: on launch it sizes the window to your resolution and centers it, can lock a minimum size, fully freeze the window size, center it in one click, and even start fullscreen. It only touches the OS-level window and almost never conflicts with other mods.

• Auto window sizing on launch: after a configurable delay (default 1.5s) it sets the window to your configured resolution (default 1280×720) and centers it, without stretching the loading screen.
• Resolution presets: grouped by aspect ratio (16:9 / 16:10 / 4:3 / 5:4 / 21:9) with 12 one-click presets per ratio, plus a custom resolution input; presets larger than your screen, smaller than the configured minimum, or matching the current size are auto-disabled.
• Minimum size lock: the window can grow freely but cannot shrink below the configured size, keeping tuned UI layouts intact.
• Fixed window size: freezes the window at its current size; the maximize button is disabled at the OS level, so a "fake maximized" state is impossible.
• Center window: one-click centering on whichever monitor the window is on.
• Borderless mode: removes the window title bar and borders; works in windowed, maximized, and fullscreen (pseudo-fullscreen) states.
• Always-on-top: three modes — off, normal (GLFW floating), and force (re-claims focus every frame, can override other always-on-top windows like classroom monitoring software).
• Auto-fullscreen / auto-maximize / auto-borderless on launch: players can persistently toggle "start fullscreen", "start maximized", or "start borderless" on next launch; modpack authors can set a one-time onboarding flag.
• Window position memory: optionally save and restore the window position and size across launches instead of forcing center; compatible with auto-fullscreen / auto-maximize.
• Cycle window state: one button / keybind to cycle through windowed → maximized → fullscreen.
• Native entry point: a "Window Settings" button in Options → Accessibility Settings (moved from Video Settings to stay compatible with mods like Embeddium that replace the video settings screen).
• Client-side only, no server install; works out of the box at 1280×720.

Quick Start

1. Install Minecraft 1.20.1 with Forge (47.x or newer).
2. Drop autowindowsize-1.1.0.jar into your .minecraft/mods/ folder.
3. Launch the game. The window will automatically resize to 1280×720 and center after 1.5 seconds.
4. Open Options → Accessibility Settings → Window Settings to configure everything.

Usage

Opening the settings screen

Go to Options → Accessibility Settings, then click the Window Settings button at the top of the list.

Core features at a glance

💡 Tip: Hover over any button in the settings screen for a detailed tooltip explaining what it does.

Commands

All commands use the /aws prefix. Type /aws help in-game for the full list with pagination.

💡 Tip: /aws resolution supports tab-completion. Type a ratio (e.g. 16:9) and press Tab to see available presets.

Key Bindings

All keybinds are unbound by default. Set them in Options → Controls → Auto Window Size.

💡 All keybinds give chat feedback when pressed (e.g. "Window centered", "Borderless mode enabled").

Config Files

All config files live in .minecraft/config/AutoWindowSize/:

Main config options (config.toml)

💡 You can also edit these in-game via a config-screen mod (e.g. Configured, Cloth Config). Config option names and tooltips follow the game language.

Downloads

Prefer GitHub Releases. Other platforms (CurseForge / Modrinth / MC Baike / MCBBS / BBSMC / KLBBS / HIMCBBS) may lag behind by a few days due to review or sync delays.

• GitHub Releases (always latest, recommended): https://github.com/3270728922/AutoWindowSize/releases
• CurseForge: https://www.curseforge.com/minecraft/mc-mods/auto-window-size
• Modrinth: https://modrinth.com/mod/autowindowsize
• MC Baike: https://www.mcmod.cn/class/30769.html
• MCBBS: https://www.mcbbs.co/thread-6322-1-1.html
• BBSMC: https://bbsmc.net/mod/autowindowsize
• KLBBS: https://klpbbs.com/thread-173769-1-1.html
• HIMCBBS: https://www.himcbbs.com/resources/1499/

Notes

• When upgrading this mod, manually delete the old config folder: .minecraft/config/AutoWindowSize/ (and the old .minecraft/config/autowindowsize-client.toml if upgrading from pre-1.0.9). Due to changes in config entries and file layout, Forge won't rewrite an existing file; deleting it and launching generates a fresh one. Client-side only; desktop Minecraft (Windows/macOS/Linux), not mobile.

Wiki

Detailed feature explanations, design decisions, and troubleshooting live in the Wiki:

• English Wiki: WIKI.md
• 中文 Wiki: WIKI_ZH-CN.md

Feedback

• Issues / Bug reports: https://github.com/3270728922/AutoWindowSize/issues
• Discussions: https://github.com/3270728922/AutoWindowSize/discussions
• Author email: [email protected]

Latest: v1.1.0

• Borderless mode: removes window title bar and borders; supports windowed, maximized, and fullscreen (pseudo-fullscreen) states; auto-borderless on launch option.
• Always-on-top: three modes — off, normal (GLFW floating), and force (re-claims focus every frame, can override other always-on-top windows).
• Window state cycle button: one click to cycle windowed → maximized → fullscreen.
• 5 keybinds: Open Settings, Center, Toggle Borderless, Cycle State, Toggle Always-on-Top (all unbound by default, with chat feedback).
• About page: in-game info screen with mod purpose, usage, downloads, feedback, and author info (20 languages).
• Settings entry moved to Accessibility Settings (compatible with Embeddium and other mods that replace the video settings screen).
• 15 commands total: added /aws borderless, /aws top, /aws debug, /aws gui, /aws status, /aws toggle; /aws help now has pagination (2 pages, 8 commands per page).
• Resolution presets: presets smaller than the configured minimum are now auto-disabled (in addition to larger-than-screen and matching-current).
• Custom resolution input: live validation with hover tooltip showing valid range; apply button disabled when input is invalid.
• Config files unified in config/AutoWindowSize/ (config.toml + window.json); config screen supports 20 languages.
• 20 languages supported.
• Various bug fixes: scroll position preservation, button highlight overflow, aspect ratio sync, preset disabling logic, window state detection in borderless mode, and more.

Full changelog: CHANGELOG.md · CHANGELOG_ZH-CN.md