Auto Window Size

Minecraft 1.20.1 / Forge 纯客户端模组 — 自动窗口大小、居中、最小尺寸锁定、固定窗口大小、无边框模式、窗口置顶与启动自动全屏

⚠ 平台提示：本模组仅支持桌面版 Minecraft（Windows / macOS / Linux），不支持手机版（基岩版 / 手机端）。

📮 关于源码：作者是 GitHub / Git 新手，早期仓库更新曾出现过操作失误导致文件混乱。如果你下载到的源码与实际发布的 jar 对不上，请发邮件至 3270728922@qq.com 获取正确源码。

English

这是什么

在整合包里把各模组 UI 一点点调好后，玩家换个分辨率启动，窗口一变、布局全乱。Auto Window Size 把"游戏窗口大小"从偶然变成可控的选择：启动后自动按指定分辨率把窗口设好并居中，还能锁定最小尺寸、彻底固定窗口大小、一键居中、下次启动自动全屏，几乎不碰游戏内逻辑，不和别的模组冲突。

• 启动自动设窗口：启动后延迟可配置（默认1.5秒），把窗口设为配置分辨率（默认 1280×720）并居中，不拉伸加载界面。
• 分辨率预设：按宽高比（16:9 / 16:10 / 4:3 / 5:4 / 21:9）分组，每种12个常用分辨率一键切换，也支持自定义分辨率输入；超过屏幕、低于配置最小值或匹配当前大小的预设自动禁用。
• 最小尺寸锁定：窗口只能放大、不能缩小到配置值以下，保护调好的 UI。
• 固定窗口大小：把当前窗口大小完全锁死，最大化按钮在系统层禁用，从根上杜绝"假最大化"。
• 居中窗口：一键把窗口在它所在的显示器居中。
• 无边框模式：去除窗口标题栏和边框；支持窗口化、最大化和全屏（伪全屏）三种状态。
• 窗口置顶：三种模式 — 关闭、普通（GLFW 悬浮）、强制（每帧重新抢焦点，可覆盖教室监控软件等其他置顶窗口）。
• 启动自动全屏 / 自动最大化 / 自动无边框：玩家可在设置里持久勾选"下次启动自动全屏"、"自动最大化"或"自动无边框"；整合包作者也可在配置里设一次性引导。
• 窗口位置记忆：可选择退出时保存窗口位置与大小，下次启动恢复（而非强制居中）；与自动全屏/最大化兼容。
• 循环切换窗口状态：一个按钮/快捷键即可在 窗口化 → 最大化 → 全屏 之间循环切换。
• 辅助功能设置原生入口：在「选项 → 辅助功能设置」里插一个「窗口设置」按钮（从视频设置迁移，兼容 Embeddium 等替换视频设置界面的模组）。
• 纯客户端，不需要装在服务端；默认 1280×720 即装即用。

快速开始

1. 安装 Minecraft 1.20.1 与 Forge（47.x 或更高版本）。
2. 将 autowindowsize-1.1.0.jar 放入 .minecraft/mods/ 文件夹。
3. 启动游戏。1.5秒后窗口会自动调整为 1280×720 并居中。
4. 打开 选项 → 辅助功能设置 → 窗口设置 进行所有配置。

使用说明

打开设置界面

进入 选项 → 辅助功能设置，点击列表顶部的 窗口设置 按钮。

核心功能一览

💡 提示：在设置界面中将鼠标悬停在任意按钮上，可查看该功能的详细说明。

指令

所有指令均以 /aws 开头。在游戏内输入 /aws help 可查看分页的完整指令列表。

💡 提示：/aws resolution 支持 Tab 自动补全。输入比例（如 16:9）后按 Tab 可查看可用预设。

快捷键

所有快捷键默认未绑定。在 选项 → 控制 → Auto Window Size 中设置。

💡 所有快捷键按下时都会在聊天框给出反馈（如"窗口已居中"、"无边框模式已开启"）。

配置文件

所有配置文件位于 .minecraft/config/AutoWindowSize/ 目录下：

主配置选项（config.toml）

💡 你也可以通过配置界面模组（如 Configured、Cloth Config）在游戏内修改这些选项。配置名称和描述会随游戏语言切换。

下载

建议优先从 GitHub Releases 下载，其他平台（CurseForge / Modrinth / MC 百科 / MCBBS / BBSMC / 苦力怕论坛 / HIMCBBS）可能因审核或同步延迟，版本会比 GitHub 慢几天。

• GitHub Releases（推荐，始终最新）：https://github.com/3270728922/AutoWindowSize/releases
• CurseForge：https://www.curseforge.com/minecraft/mc-mods/auto-window-size
• Modrinth：https://modrinth.com/mod/autowindowsize
• MC 百科：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/

注意事项

• 升级本模组时请手动删除旧配置文件夹：.minecraft/config/AutoWindowSize/（如果是从 1.0.9 之前版本升级，还需删除旧的 .minecraft/config/autowindowsize-client.toml）。由于部分原因，新版对配置项和文件布局做了调整，不删旧文件的话 Forge 不会重写、也可能缺少新增项；删除后启动游戏会自动生成全新的配置文件。本模组为纯客户端模组，仅支持桌面版 Minecraft，不支持手机版。

Wiki

详细的功能说明、设计决策和故障排除请见 Wiki：

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

反馈

• 问题反馈 / 提 Bug：https://github.com/3270728922/AutoWindowSize/issues
• 讨论区：https://github.com/3270728922/AutoWindowSize/discussions
• 作者邮箱：3270728922@qq.com

最新版本：v1.1.0

• 无边框模式：去除窗口标题栏和边框；支持窗口化、最大化和全屏（伪全屏）三种状态；新增启动自动无边框选项。
• 窗口置顶：三种模式 — 关闭、普通（GLFW 悬浮）、强制（每帧重新抢焦点，可覆盖其他置顶窗口）。
• 循环切换窗口状态按钮：一键在 窗口化 → 最大化 → 全屏 之间循环切换。
• 5个快捷键：打开设置、居中、切换无边框、循环状态、切换置顶（默认未绑定，带聊天反馈）。
• 关于页面：游戏内信息页面，包含模组目的、使用方法、下载渠道、反馈渠道和作者信息（20种语言）。
• 设置入口迁移到辅助功能设置（兼容 Embeddium 等完全替换视频设置界面的模组，避免按钮消失）。
• 共15个指令：新增 /aws borderless、/aws top、/aws debug、/aws gui、/aws status、/aws toggle；/aws help 现在支持分页（共2页，每页8条）。
• 分辨率预设：低于配置最小值的预设现在也会自动禁用（除了超过屏幕和匹配当前大小之外）。
• 自定义分辨率输入：实时校验，鼠标悬停显示合法范围；输入非法值时应用按钮禁用。
• 配置文件统一到 config/AutoWindowSize/ 目录（config.toml + window.json）；配置界面支持20种语言。
• 支持20种语言。
• 修复大量 bug：滚动位置保持、按钮高亮溢出、比例同步、预设禁用逻辑、无边框模式下窗口状态检测等。

完整更新日志：CHANGELOG_ZH-CN.md · CHANGELOG.md