A Minecraft 1.20.1 / Forge client-side mod — auto window sizing, centering, minimum-size lock, fixed window size 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 3270728922@qq.com for the correct source.
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 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.
- Auto-fullscreen / auto-maximize on launch: players can persistently toggle "start fullscreen" or "start maximized" on next launch (mutually exclusive); modpack authors can set a one-time onboarding flag so the first launch enters fullscreen or maximized once.
- Window position memory: optionally save and restore the window position and size across launches instead of forcing center; compatible with auto-fullscreen / auto-maximize.
- 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.
Full details, command list, config options and FAQ live in the Wiki.
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/
- When upgrading this mod, manually delete the old config folder:
.minecraft/config/AutoWindowSize/(and the old.minecraft/config/autowindowsize-client.tomlif 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.
- English Wiki: WIKI.md
- 中文 Wiki: WIKI_ZH-CN.md
- Issues / Bug reports: https://github.com/3270728922/AutoWindowSize/issues
- Author email: 3270728922@qq.com
- Resolution presets expanded: 5 aspect ratios (16:9 / 16:10 / 4:3 / 5:4 / 21:9) with 12 presets each, plus custom resolution input with live validation; presets larger than the screen or matching the current size are auto-disabled.
- Startup delay is now configurable (
startupDelay, 0.5–10.0s, default 1.5s) in the config file. - Window position memory (
rememberPosition): optionally save and restore the window position and size across launches; compatible with auto-fullscreen / auto-maximize. - Config files moved to
config/AutoWindowSize/(config.toml + window.json) for a cleaner config folder. - Settings entry moved from Video Settings to Accessibility Settings (compatible with Embeddium and other mods that replace the video settings screen).
- Settings screen rework: four-line info area (screen resolution / window state + config status / detailed status / custom input bounds), button hover tooltips, scrollbar and layout fixes.
- New commands:
/aws help,/aws fullscreen,/aws maximize,/aws remember,/aws resolution(supports ratio+preset and custom width/height). - Config screen translations: option names and descriptions follow the game language when opened via a config-screen mod.
- 20 languages supported (added Arabic, Thai, Swedish, Czech, Indonesian).
- Various bug fixes: aspect ratio display after maximize/fullscreen toggle, preset click ratio sync, custom input live update, fixed-size lock disabling presets, button highlight overflow, scrollbar overlap, and more.
Full changelog: CHANGELOG.md · CHANGELOG_ZH-CN.md