A Minecraft 1.20.1 / Forge client-side mod — auto window sizing, centering, minimum-size lock, fixed window size, borderless mode, always-on-top (3 modes), window state cycle, 5 keybinds, 128 resolution presets (8 ratios × 16), 17 commands (18 including borderless auto subcommand), and auto-fullscreen/maximize/borderless on launch.
⚠ Platform notice: this mod only supports desktop Minecraft (Windows / macOS / Linux). It does not work on mobile / Bedrock. Windows is fully tested; macOS / Linux are experimental and may have edge-case issues with borderless mode, always-on-top, and window state detection.
📮 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 jujuawa@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 8 aspect ratios (16:9 / 16:10 / 4:3 / 5:4 / 21:9 / 3:2 / 2:1 / 9:16) with 16 one-click presets per ratio (128 total), 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 Management & Resolution 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.
📸 Screenshots (click to expand — 7 images)
1. Settings entry — Options → Accessibility Settings → Window Management & Resolution Settings
2. Main settings screen — all toggles, info area, and 16:9 resolution presets
3. Custom resolution input — width/height fields with live validation and range hint
4. In-game commands — /aws help pagination and command feedback in chat
5. Key bindings — 5 configurable keybinds in Options → Controls
6. Borderless mode — window title bar and borders removed
7. Maximized state — relevant buttons auto-disabled with yellow status hint
- Install Minecraft 1.20.1 with Forge (47.x or newer).
- Drop
AutoWindowSize-1.20.1-1.1.2.jarinto your.minecraft/mods/folder. - Launch the game. The window will automatically resize to 1280×720 and center after 1.5 seconds.
- Open Options → Accessibility Settings → Window Management & Resolution Settings to configure everything.
Go to Options → Accessibility Settings, then click the Window Management & Resolution Settings button at the top of the list.
| Feature | What it does |
|---|---|
| Auto window size | On launch, sets the window to your configured resolution and centers it |
| Minimum size lock | Prevents the window from being resized below the configured minimum |
| Fixed window size | Completely locks the window size (maximize button disabled at OS level) |
| Center window | One-click centering on the current monitor |
| Borderless mode | Removes window decorations (title bar + borders) |
| Always-on-top | Keeps the window above other windows (3 modes) |
| Remember position | Saves/restores window position and size across launches |
| Resolution presets | 128 presets across 8 aspect ratios, plus custom input |
| Cycle state | Cycles windowed → maximized → fullscreen |
💡 Tip: Hover over any button in the settings screen for a detailed tooltip explaining what it does.
All commands use the /aws prefix. Type /aws help in-game for the full list with pagination.
| Command | Description |
|---|---|
/aws help [page] |
Show the command list (3 pages, 8 commands per page) |
/aws gui |
Open the Window Management & Resolution Settings screen |
/aws about |
Open the About page |
/aws info |
Show detailed window info (resolution, state, lock, top, borderless, etc.) |
/aws version |
Show mod version, author, license, and contact info |
/aws config |
Open the config folder in file explorer |
/aws status |
Show current window state, config status, and resolution |
/aws toggle [true/false] |
Toggle minimum size lock on/off (optional explicit value) |
/aws fixed [true/false] |
Toggle fixed window size on/off |
/aws center |
Center the window on the current monitor |
/aws fullscreen [true/false] |
Toggle fullscreen mode on/off |
/aws maximize [true/false] |
Toggle maximized mode on/off |
/aws remember [true/false] |
Toggle window position memory on/off |
/aws top [off/normal/force] |
Cycle always-on-top mode, or set directly by name |
/aws debug [true/false] |
Toggle debug logging on/off |
/aws borderless [true/false] |
Toggle borderless mode on/off |
/aws borderless auto [true/false] |
Toggle auto-borderless on next launch on/off |
/aws resolution [ratio] <preset> |
Set window resolution and center; supports ratio+preset (e.g. 16:9 1920x1080) with tab-completion |
💡 Tip: All toggle commands accept optional
true/falsefor explicit on/off./aws topacceptsoff/normal/force./aws resolutionsupports tab-completion.
All keybinds are unbound by default. Set them in Options → Controls → Auto Window Size.
| Keybind | Default | Description |
|---|---|---|
| Open Auto Window Size Settings | None | Open the Window Management & Resolution Settings screen |
| Center Window | None | Center the window on the current monitor |
| Toggle Borderless | None | Toggle borderless mode on/off |
| Cycle Window State | None | Cycle windowed → maximized → fullscreen |
| Toggle Always-on-Top | None | Cycle always-on-top mode (off → normal → force) |
💡 All keybinds give chat feedback when pressed (e.g. "Window centered", "Borderless mode enabled").
All config files live in .minecraft/config/AutoWindowSize/:
| File | Purpose |
|---|---|
config.toml |
Main configuration (window size, lock, auto-fullscreen, etc.) |
window.json |
Saved window position/size (only used when "Remember position" is enabled) |
[meta] — Internal (usually no need to touch)
| Option | Default | Range | Description |
|---|---|---|---|
configVersion |
2 | 1–999 | Internal config version for automatic migration. Do not modify manually. |
[window] — Window size & state
| Option | Default | Range | Description |
|---|---|---|---|
width |
1280 | 856–7680 | Startup window width; also the minimum width when locked |
height |
720 | 482–4320 | Startup window height; also the minimum height when locked |
rememberPosition |
false | — | Save on exit and restore window position/size on next launch |
alwaysOnTopMode |
0 | 0–2 | Always-on-top mode (0=off, 1=normal, 2=force) |
borderless |
false | — | Enable borderless mode (windowed only; fullscreen is inherently borderless) |
debug |
false | — | Output detailed diagnostics to the log |
[startup] — Launch behavior
| Option | Default | Range | Description |
|---|---|---|---|
startupDelay |
1.5 | 0.5–10.0 | Seconds to wait before applying window size/position on launch |
autoFullscreen |
false | — | Auto-fullscreen on next launch (mutually exclusive with autoMaximized) |
autoMaximized |
false | — | Auto-maximize on next launch (mutually exclusive with autoFullscreen) |
autoBorderless |
false | — | Auto-enable borderless on next launch |
applyStartupGuide |
false | — | One-time onboarding flag (modpack authors), auto-resets after use |
startFullscreen |
false | — | Onboarding target: whether the first launch starts fullscreen |
startMaximized |
false | — | Onboarding target: whether the first launch starts maximized |
💡 "Minimum size lock" and "Fixed window size" are runtime states, not config fields. Toggle them from the settings screen or via
/aws toggleand/aws fixed.
🔄 Auto config migration: Since v1.1.1, the mod automatically migrates old config files on first launch — no need to manually delete the config folder when upgrading. A chat notice confirms the migration when you enter a world.
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/
- Windows Snap (split-screen): when minimum size lock is enabled, Windows Snap (window tiling / split screen) may not work correctly — the window may be forced to a fixed aspect ratio instead of snapping to half screen. Workaround: temporarily disable minimum size lock, arrange the window with Snap, then re-enable the lock. This is a known limitation and will be improved in a future version.
- Windowed borderless mode: has some edge-case bugs with window resizing and position. Maximized borderless and fullscreen borderless work correctly.
- Config auto-migration (since v1.1.1): when upgrading from an older version, the mod automatically detects the old config and migrates it on first launch — no need to manually delete the config folder. A chat notice confirms the migration when you enter a world. If upgrading from pre-1.0.9, the old
autowindowsize-client.tomlis detected and a warning is logged (you may delete it manually). - Client-side only; desktop Minecraft (Windows/macOS/Linux), not mobile.
- Version plan: ports to Minecraft 1.21.1, 26.2, and 26.3 are planned for future releases (separate branches/builds).
Detailed feature explanations, design decisions, and troubleshooting live in the Wiki:
- English Wiki: WIKI.md
- 中文 Wiki: WIKI_ZH-CN.md
- Issues / Bug reports: https://github.com/3270728922/AutoWindowSize/issues
- Discussions: https://github.com/3270728922/AutoWindowSize/discussions
- Author email: jujuawa@qq.com
- More presets: 3 new aspect ratios (3:2, 2:1, 9:16) — now 8 ratios total, 16 presets each (128 total).
- Aspect ratio split button: left/right arrows + center info display, no more cycling all the way around.
- Command overhaul: 4 new commands (
/aws about,/aws info,/aws version,/aws config); all toggle commands accepttrue/false;/aws topacceptsoff/normal/force; removed redundant/aws lock//aws unlock. - Enter-to-apply: press Enter in custom resolution fields to apply immediately.
- About page improvements: clickable links (URL opens browser, email copies to clipboard), scroll position restore, 3x faster scrolling.
- UI polish: settings entry renamed to "Window Management & Resolution Settings", unified button state text (On/Off), improved tooltips with manual line breaks.
- Bug fixes: preset disable logic when lock is off, input field focus loss, language file JSON parse error, config migration false positive on fresh installs.
- Config auto-migration: no more manual config deletion when upgrading! The mod detects old config versions and automatically migrates them on first launch, with a chat confirmation.
- Fixed license: root
LICENSE.txtis now the actual MIT text (was Forge MDK LGPL template), so GitHub correctly recognizes the license. - Package name normalized:
com.example.autowindowsize→com.jujumlqwq.autowindowsize(Forge MDK template leftover removed). - Config version field: new
configVersionin[meta]group (internal use only) with full multi-language support in config screens. - Issue template dead link fixed: "FAQ" link now points to the existing
#notessection. - README platform notice: macOS / Linux explicitly marked as experimental support.
- Author info corrected:
JujuMLQwQ, MLeverywhere (mods.toml description, about pages). - Email updated:
jujuawa@qq.com.
- 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 9 sections (Purpose, About, Usage, Commands, Keybinds, Downloads, Feedback, Notes, Author), clickable links and email copy (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 helpnow 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