What's New / 更新内容

Fixed / 修复

• If you went fullscreen or maximized the window while still on the loading screen, the mod no longer yanks it back to the configured resolution once the main menu loads. It now checks the window state first. 加载期间手动全屏或最大化，进主菜单后不再被强制改回配置分辨率。
• After maximizing on the loading screen and then un-maximizing, the window used to land at the OS default size; and after entering fullscreen on the loading screen and exiting, it was not centered. Now it resizes back to the configured resolution and centers. 加载期间最大化后取消最大化、或加载期间全屏后退出，现在都会回到配置分辨率并居中。
• Maximizing first then going fullscreen on the loading screen used to leave a "fake maximized" state (restore button still shown, but size was the configured one). It now truly restores maximized, and un-maximizing afterwards finishes with a recenter. 加载期间先最大化再全屏，退出全屏后不再假最大化，而是真正恢复最大化；再取消最大化会自动居中。游戏中正常的取消最大化不受影响，仍恢复原位。

📥 Install / 安装

Drop autowindowsize-1.0.5.jar into your mods folder (Forge 1.20.1, client side only). 把 autowindowsize-1.0.5.jar 放进 mods 文件夹（Forge 1.20.1，仅客户端）。

📦 Requirements / 环境

Minecraft 1.20.1 · Forge 47.x

What's New in 1.0.4 / 1.0.4 更新内容

✨ New Features / 新功能

• Center Window button / 居中窗口按钮 One-click centers the window on its current monitor. Auto-disabled (with a reason shown) in fullscreen, maximized, minimized, or already-centered states. 一键把窗口在当前所在显示器居中。全屏、最大化、最小化、已居中时自动禁用并显示原因。
• /aws center command / 指令 Centers the window from chat; tells you why it's unavailable when it is. 聊天栏执行即可居中，不可用时会说明原因。

🐛 Fixes & Improvements / 修复与优化

• Window drag no longer freezes live resolution numbers; refreshes 0.5s after you stop dragging. 拖动窗口时分辨率数字冻结，停止拖动 0.5 秒后刷新。
• Fixed fullscreen no longer leaving the yellow "resolution changing" hint stuck on screen. 修复全屏时黄色"分辨率变化中"提示常驻不消失的问题。
• Fixed config minimum being able to go below the hardcoded minimum (856×482). 修复配置下限可低于硬写死最小分辨率（856×482）的问题。
• Config descriptions are now bilingual (English above, Chinese below). 配置描述改为上英下中双语。
• Mod screen description expanded with release links. 模组列表描述扩充详细，并加入发布链接。
• Window applies 1.5s after the loading screen finishes. 加载屏幕完成后 1.5 秒应用窗口设置。

📥 Installation / 安装

Drop autowindowsize-1.0.4.jar into your mods folder (Forge 1.20.1, client side only). 把 autowindowsize-1.0.4.jar 放进 mods 文件夹（Forge 1.20.1，仅客户端）。

📦 Requirements / 环境要求

• Minecraft 1.20.1
• Minecraft Forge

v1.0.3 — 延迟初始化和全屏消息改进 / 延迟初始化与全屏提示优化 新增 / 新增 窗口大小设置为启动后2秒，避免加载画面拉伸/启动2秒后设置窗口大小，避免加载界面拉伸 全屏消息现在显示锁定是否会恢复/全屏提示区分退出后恢复开启还是保持关闭 Bilingual config comments / 配置文件中英双语注释 固定 / 修复 首次启动的引导界面不再跳过窗口init/首次启动引导界面不再跳过窗口初始化

v1.0.2 — Commands, Fullscreen & UI Improvements / 指令、全屏支持与界面优化 Added / 新增 /aws command system: toggle, lock, unlock, status, gui /aws 指令系统：切换、锁定、解锁、状态、打开设置 Fullscreen auto-disable: lock temporarily disabled in fullscreen, restored on exit 全屏自动禁用：进入全屏时临时禁用锁定，退出全屏后按全屏前状态恢复 Real-time button state sync in Window Settings screen 窗口设置界面按钮状态实时同步，无需重开 Red reason text when lock is disabled (low resolution or fullscreen) 锁定禁用时显示红色原因（分辨率过低或全屏模式） Screen resolution display in /aws status /aws status 显示当前屏幕分辨率 GitHub and Issues links in Mods list Mods 界面添加 GitHub 和 Issues 链接 Changed / 调整 Key binding now opens Window Settings screen (previously toggled lock) 键位改为打开窗口设置界面（原为切换锁定） Hardcoded minimum resolution lowered from 1024×576 to 856×482 硬编码最小分辨率从 1024×576 降为 856×482，兼容更多老显示器 Exit fullscreen no longer forces window size — Minecraft restores naturally 退出全屏不再强制设置窗口大小，由 Minecraft 自动恢复 Improved chat message styling with ✔/✘/ℹ/● symbols 优化聊天提示样式，使用符号区分不同类型消息 Authors: JujuMLQwQ, ML 作者：JujuMLQwQ、ML Fixed / 修复 ConfigScreen: minimized window restore no longer gets stuck on refreshing hint 修复最小化再恢复后"1秒刷新提示"常驻的问题 Fullscreen detection uses GLFW native API for reliability 全屏检测改用 GLFW 原生 API，更可靠 Button width matches native Video Settings buttons exactly 按钮宽度与视频设置原生按钮完全一致

✨ 新增 / Added 视频设置原生入口：在「选项 → 视频设置」中原生插入「窗口设置」按钮，位于「全屏分辨率」下方，随列表滚动和 GUI 缩放正常布局

窗口设置界面：全新的设置界面，可手动开关锁定，显示当前屏幕分辨率和游戏窗口分辨率

实时分辨率显示：窗口设置界面实时显示当前屏幕分辨率和游戏窗口分辨率，拖动窗口后 1 秒自动刷新

进游戏状态提示：每次进入世界时，聊天栏提示当前锁定状态（已锁定 / 已解锁 / 已禁用）

拖动延迟刷新：拖动窗口时显示提示，松开后 1 秒自动更新分辨率数值，避免拖动时卡顿

Native Video Settings entry: "Window Settings" button natively inserted into Options → Video Settings, right below "Fullscreen Resolution", scrolling and scaling properly with the list

Window Settings screen: New settings screen with manual lock toggle, live display of screen resolution and game window resolution

Live resolution display: Shows current screen resolution and game window resolution in real time, auto-refreshes 1 second after window drag

Status notification on join: Chat notification of current lock status each time you enter a world (Locked / Unlocked / Disabled)

Delayed refresh on drag: Shows hint while dragging, auto-updates resolution values 1 second after release to avoid lag during dragging

🔧 调整 / Changed 键位默认未绑定：切换锁定的按键默认改为未绑定，玩家自行在控制设置中绑定

默认分辨率改为 1280×720：从 1440×810 下调，兼容更多老显示器

优化提示文本样式：聊天栏提示使用更专业的颜色和格式

Key binding default unbound: Toggle lock key defaults to unbound, player sets it in Controls

Default resolution changed to 1280×720: Lowered from 1440×810 for better compatibility with older monitors

Improved notification styling: Chat notifications use more professional colors and formatting

🐛 修复 / Fixed 重写全屏逻辑：配置分辨率高于屏幕分辨率时，自动禁用锁定功能且不改动窗口大小，避免显示 bug

修复按钮布局：按钮在不同 GUI 缩放下的布局问题，现在原生插入列表，随滚动和缩放正常变化

禁用状态防护：锁定被禁用时，按钮灰色不可点击，按键触发时聊天栏提示原因

Rewrote fullscreen logic: When config resolution exceeds screen resolution, lock is auto-disabled and window is left unchanged to avoid display bugs

Fixed button layout: Button layout issues at different GUI scales — now natively inserted into the list, scrolling and scaling properly

Disabled state protection: When lock is disabled, button is greyed out and unclickable; key trigger shows reason in chat

📦 下载 / Download 下方附件下载 jar 文件，放入 .minecraft/mods 文件夹即可。

Download the jar below and place it in your .minecraft/mods folder.

⚠️ 注意 / Notes 适用于 Minecraft 1.20.1 + Forge 47.x

配置文件：.minecraft/config/autowindowsize-client.toml

代码硬编码最小分辨率 1024×576，配置值低于此值时仍以 1024×576 为最小锁定尺寸

For Minecraft 1.20.1 + Forge 47.x

Config file: .minecraft/config/autowindowsize-client.toml

Hardcoded minimum resolution 1024×576; even if config is lower, 1024×576 is used as minimum lock size

✨ 功能特性 / Features 启动自动设置窗口大小：启动游戏时自动将窗口设置为配置的分辨率

自动居中：窗口在屏幕上自动居中

锁定最小窗口尺寸：锁定后窗口只能放大，不能缩小到配置尺寸以下

自定义按键切换：可在控制设置中绑定按键，快速切换锁定状态

多显示器支持：自动检测游戏窗口所在的显示器，在对应显示器上居中

Auto window size on launch: Automatically resizes the game window to the configured resolution on startup

Auto centering: Window is automatically centered on screen

Minimum size lock: When locked, the window can only be enlarged, not shrunk below the configured size

Custom hotkey toggle: Bind a key in Controls settings to quickly toggle lock state

Multi-monitor support: Automatically detects which monitor the game window is on and centers accordingly

🔧 配置/Configuration
配置文件路径/Config file: .minecraft/config/autowindowsize-client.toml

[window]
width = 1280   启动窗口宽度 / Startup window width
height = 720   启动窗口高度 / Startup window height