ВЕРСИИ (13)

**English** | [简体中文](https://github.com/INF32768/UltimateScaler/blob/main/docs/CHANGELOG_CN.md) Marking the completion of the [project refactor](https://github.com/INF32768/UltimateScaler/wiki/Project.Refactoring.en), this release rebuilds the project's foundation rather than adding gameplay features. In-game behavior remains compatible, and existing V2/V3 configurations migrate automatically to the new V4 format. ### Added - A new configuration screen with five categories, unified environment/risk/performance/restart labels, a distance-effect legend, dependent sub-options, decimal validation, block dropdowns, and clickable Wiki/Issue links. - Automatic migration from V2/V3 configurations to the V4 configuration model. - AppVeyor nightly and release pipelines; tagging a release now builds, packages and publishes automatically. - Project documentation and community infrastructure: a rewritten README, CONTRIBUTING, a contributors list, bilingual Issue templates, expanded Wiki pages, and Javadocs for core code. - Third-party license files for bundled dependencies. ### Changed - The configuration model is now V4, organized into General, World Generation, Fixes & Expansion, and Utilities, with field names that better match their behavior. - Configuration migration results are written back immediately; the V2 file is deleted only after the new configuration has been saved successfully. - The keybind now opens the new configuration screen directly. Configuration loads at startup, a default file is generated on first launch, and `/reload` re-reads the file. - The configuration file header now links to the Wiki; detailed documentation lives in the Wiki and in the screen's tooltips. - Migrated to mojmap and the modern Fabric template, renamed the package to `xyz.inf32768.ultimatescaler`, and split client/common sources. - Unified configuration naming, added `ModMetadata` for shared constants, and switched version checks to Fabric's built-in `Version`. - Upgraded to Gradle 9.5.1, Loom 1.17, Fabric Loader 0.19.3 and Fabric API 0.136.1. - Replaced fragile `@ModifyConstant` injections to improve cross-version compatibility. - Rewrote `locate pos`: all parameters are now `double`, negative values are supported, manual range selection is gone, and calculations are dramatically faster. - Cached debug HUD coordinate conversions to avoid repeated work. - Adopted Conventional Commits, trunk-based development, and atomic commits as the project workflow. ### Deprecated - The old configuration screen remains as a transition and is marked deprecated; hold Shift while clicking the mod icon in Mod Menu to reach it. It will be removed in a future release. ### Removed - Per-option comments are no longer written to the configuration file. - Manual range selection in `locate pos`. - The vendored toml4j source; toml4j is now a regular dependency. ### Fixed - Fixed configuration loading so it no longer replaces the active configuration with defaults when loading or V3 migration fails. The previous configuration is kept and written back; if there is no previous configuration, defaults are used. Before a fallback write, the original file is backed up as `ultimate_scaler.toml.bak`; saves use a temporary file with atomic replacement when the filesystem supports it. - Fixed the `RELEASE` Far Lands position behavior. - Fixed incorrect End island offsets in certain configurations. - Fixed `rarity` calculation in `WeirdScaledSampler`. - Fixed a wrong mixin target for mineshafts. - Fixed several 1.21.x compile/runtime issues, including a fluid sampler crash and mixin loading conditions. > **Upgrade note:** Existing V2/V3 configurations migrate to V4 automatically; back up custom configurations before > upgrading. The old configuration screen is deprecated and will be removed in a future release. > Automated smoke tests remain a deferred follow-up; build verification is currently in place. Normal feature > development resumes from this release.

## 0.3.3.2 - 2025-9-17 ### 漏洞修复 | Bug Fixes - 修复了在Minecraft 1.21.2至1.21.5版本无法启动的问题。 | Fixed that the mod could not launch properly in versions 1.21.2 to 1.21.5 of Minecraft. - 修复了Modrinth上未正确标识支持的游戏版本的问题。 | Fixed that the supported game versions on Modrinth were not correctly identified.

## 0.3.3.1 - 2025-8-23 ### 改进 | Improvements - 把`MixinAbstractChunkHolder`和`MixinMineshaftPart`两个类移动到`fixing`包中。 | Moved `MixinAbstractChunkHolder` and `MixinMineshaftPart` two classes to the `fixing` package. - 把`shadowed`包移动到`srcmainjava`目录下。 | Moved the `shadowed` package to the `srcmainjava` directory. ### 漏洞修复 | Bug Fixes - 修复了在1.21.2以上版本中，X/Z坐标超过±30000512或Y坐标超过±20000000的实体，在加载时会被限制到此位置的问题。 | Fixed that entities with X/Z coordinates beyond ±30000512 or Y coordinates beyond ±20000000 in versions 1.21.2 and above, will be restricted to this position when loading. - 在根目录下添加了`LICENSE-toml4j`文件（很抱歉之前因为疏忽没有添加）。 | Added the `LICENSE-toml4j` file to the root directory (sorry for missing this earlier). - 在`README.md`中添加了对上述文件的引用。 | Added a reference to the above files in `README.md`. - 回退了0.3.0-pre1对`toml4j`库的误更改。 | Reverted the change to `toml4j` library in 0.3.0-pre1.

## 0.3.3 - 2025-8-19 ### 新特性 | New Features - 新增了扩展世界边界的功能。 | Added the ability to extend the world border. - 新增了修复废弃矿井在极大坐标下无法生成导致游戏崩溃的功能。 | Added the ability to fix the crash caused by generating mineshafts in extremely large coordinates. - 移植到1.21.9（25w33a）。 | Ported to 1.21.9 (25w33a). - 在`README.md`中添加了显示兼容版本的徽章。 | Added a badge to show compatible versions in `README.md`. ### 改进 | Improvements - 不再要求Fabric Loader的版本高于0.17.0。 | No longer requires Fabric Loader version higher than 0.17.0. - 整理了Mixin类。 | Organized Mixin classes. - 把“‘修复’ 选项”更改为“实用调整”，并将“修复‘末地环’”功能移入。 | Changed "'Fix' option" to "Useful tweaks", and moved the "Fix End Rings" feature into it. - 升级构建环境到Fabric Loom 1.11-SNAPSHOT。 | Upgraded build environment to Fabric Loom 1.11-SNAPSHOT. - 现在使用accessWidener来访问内部protected类。 | Now using accessWidener to access internal protected classes. - 配置文件版本号现在是3。 | The configuration file version number is now 3. - 现在使用Makedown的“任务列表”功能来管理更新计划。 | Now using the "Task List" feature of Makedown to manage the update plan. ### 漏洞修复 | Bug Fixes - 修复了上一版本未指定Minecraft版本的问题。 | Fixed that the previous version did not specify the Minecraft version.

## 0.3.2 - 2025-8-13 ### 改进 | Improvements - 由于使用了新的版本管理策略和兼容代码，此分支向下兼容到1.21，并撤销了其他分支。 | This branch is now compatible down to 1.21, and all other branches have been cancelled. - 现在使用`@Inject`注解而非`@Overwrite`注解来修改`maintainPrecision`方法。 | Now using `@Inject` annotation instead of `@Overwrite` annotation to modify `maintainPrecision` method. ### 漏洞修复 | Bug Fixes - 修复了“扩展数据包字面量取值范围”无法扩展数值下限的问题。 | Fixed that the "Extend the literal value range of datapacks" option could not extend the lower limit of the value. - 修复了上传到CurseForge的版本无法正常运行的问题。 | Fixed that the uploaded version to CurseForge could not run properly.

## 0.3.2 - 2025-8-13 ### 改进 | Improvements - 由于使用了新的版本管理策略和兼容代码，此分支向下兼容到1.21，并撤销了其他分支。 | This branch is now compatible down to 1.21, and all other branches have been cancelled. - 现在使用`@Inject`注解而非`@Overwrite`注解来修改`maintainPrecision`方法。 | Now using `@Inject` annotation instead of `@Overwrite` annotation to modify `maintainPrecision` method. ### 漏洞修复 | Bug Fixes - 修复了“扩展数据包字面量取值范围”无法扩展数值下限的问题。 | Fixed that the "Extend the literal value range of datapacks" option could not extend the lower limit of the value. - 修复了上传到CurseForge的版本无法正常运行的问题。 | Fixed that the uploaded version to CurseForge could not run properly.

## 0.3.1.1 - 2025-8-12 ### 改进 | Improvements - 升级了Fabric Loom至1.10.1。 | Upgraded Fabric Loom to 1.10.1. ### 漏洞修复 | Bug Fixes - ※ 修复了因`accessWidener`文件导致的启动失败问题。 | Fixed the failure to launch due to the `accessWidener` file.

## 0.3.1.1 - 2025-8-12 ### 漏洞修复 | Bug Fixes - ※ 修复了加载世界时崩溃的问题。 | Fixed a crash when loading a world. - 修复了类`MixinTitleScreen`未被声明为抽象的问题。 | Fixed `MixinTitleScreen` not being declared as abstract.

## 0.3.1 - 2025-8-11 ### 新特性 | New Features - 新增了两条常见问题。 | Added two frequently asked questions. ### 改进 | Improvements - 创建了多个分支，用于支持不同版本的Minecraft。 | Created multiple branches to support different versions of Minecraft. - 移除了不必要的版本校验。 | Removed unnecessary version validation. - 替换了`README.md`中的一个徽章。 | Replaced one badge in `README.md`. - 升级了Gradle版本。 | Upgraded Gradle version. - 升级了Fabric Loader版本。 | Upgraded Fabric Loader version. - 整理了语言文件。 | Organized language files. - 为大多数分支启用了Minotaur和CurseGradle支持。 | Enabled Minotaur and CurseGradle support for most branches.

## 0.3.1 - 2025-8-11 ### 新特性 | New Features - 新增了两条常见问题。 | Added two frequently asked questions. ### 改进 | Improvements - 创建了多个分支，用于支持不同版本的Minecraft。 | Created multiple branches to support different versions of Minecraft. - 移除了不必要的版本校验。 | Removed unnecessary version validation. - 替换了`README.md`中的一个徽章。 | Replaced one badge in `README.md`. - 升级了Gradle版本。 | Upgraded Gradle version. - 升级了Fabric Loader版本。 | Upgraded Fabric Loader version. - 整理了语言文件。 | Organized language files. - 为大多数分支启用了Minotaur和CurseGradle支持。 | Enabled Minotaur and CurseGradle support for most branches.

## 0.3.1 - 2025-8-11 ### 新特性 | New Features - 新增了两条常见问题。 | Added two frequently asked questions. ### 改进 | Improvements - 创建了多个分支，用于支持不同版本的Minecraft。 | Created multiple branches to support different versions of Minecraft. - 移除了不必要的版本校验。 | Removed unnecessary version validation. - 替换了`README.md`中的一个徽章。 | Replaced one badge in `README.md`. - 升级了Gradle版本。 | Upgraded Gradle version. - 升级了Fabric Loader版本。 | Upgraded Fabric Loader version. - 整理了语言文件。 | Organized language files. - 为大多数分支启用了Minotaur和CurseGradle支持。 | Enabled Minotaur and CurseGradle support for most branches. ## 0.3.1.1 - 2025-8-11 ### 漏洞修复 | Bug Fixes - 修复了某些平台上更新日志乱码的问题。 | Fixed a bug where the update log was garbled on some platforms. - 用`-`代替版本号中的`+`符号。 | Replaced the `+` sign in the version number with `-`. ## 0.3.1.2 - 2025-8-11 ### 漏洞修复 | Bug Fixes - 再次尝试修复更新日志乱码的问题。 | Re-attempt to fix the update log garbled issue. - 将0.3.1.1的更新日志移入`BRANCH.Changelog.md`。 | Move the update log of 0.3.1.1 to `BRANCH.Changelog.md`.

## 0.3.1 - 2025-8-11\n\n### \u65b0\u7279\u6027 | New Features\n\n- \u65b0\u589e\u4e86\u4e24\u6761\u5e38\u89c1\u95ee\u9898\u3002 | Added two frequently asked questions.\n\n### \u6539\u8fdb | Improvements\n\n- \u521b\u5efa\u4e86\u591a\u4e2a\u5206\u652f\uff0c\u7528\u4e8e\u652f\u6301\u4e0d\u540c\u7248\u672c\u7684Minecraft\u3002 | Created multiple branches to support different versions of Minecraft.\n- \u79fb\u9664\u4e86\u4e0d\u5fc5\u8981\u7684\u7248\u672c\u6821\u9a8c\u3002 | Removed unnecessary version validation.\n- \u66ff\u6362\u4e86`README.md`\u4e2d\u7684\u4e00\u4e2a\u5fbd\u7ae0\u3002 | Replaced one badge in `README.md`.\n- \u5347\u7ea7\u4e86Gradle\u7248\u672c\u3002 | Upgraded Gradle version.\n- \u5347\u7ea7\u4e86Fabric Loader\u7248\u672c\u3002 | Upgraded Fabric Loader version.\n- \u6574\u7406\u4e86\u8bed\u8a00\u6587\u4ef6\u3002 | Organized language files.\n- \u4e3a\u5927\u591a\u6570\u5206\u652f\u542f\u7528\u4e86Minotaur\u548cCurseGradle\u652f\u6301\u3002 | Enabled Minotaur and CurseGradle support for most branches.\n\n## 0.3.1.1 - 2025-8-11\n\n### \u6f0f\u6d1e\u4fee\u590d | Bug Fixes\n\n- \u4fee\u590d\u4e86\u67d0\u4e9b\u5e73\u53f0\u4e0a\u66f4\u65b0\u65e5\u5fd7\u4e71\u7801\u7684\u95ee\u9898\u3002 | Fixed a bug where the update log was garbled on some platforms.\n- \u7528`-`\u4ee3\u66ff\u7248\u672c\u53f7\u4e2d\u7684`+`\u7b26\u53f7\u3002 | Replaced the `+` sign in the version number with `-`.

# 0.3.0 - 2025-8-8 ## 新特性 | New Features - 在`README.md`中添加了更新计划。 | Added the update plan in `README.md`. - 开始使用BigInteger重写原版地形生成算法，目前已重写噪声类密度函数和`end_islands`密度函数。 | Started the rewrite of the vanilla terrain generation algorithm with BigInteger, currently rewritten the noise-based density function and `end_islands` density functions. - 配置了Mixin Config Plugin。 | Configured the "Mixin config plugin". - 新增了偏移密度函数 `weird_scale_multiplier` 的功能。 | Added the ability to offset the density function `weird_scale_multiplier`. - 新增了扩展数据包字面量取值范围的功能。 | Added the ability to extend the literal value range of datapacks. - 新增了“Y轴扩展偏移”选项。 | Added the "Extra Y-axis offset" option. - 支持服务端运行。 | Support for server-side running. - 在配置文件中添加了注释。 | Added comments to the configuration file. - 新增了使用/reload命令重载配置文件的功能。 | Added the ability to reload the configuration file using the /reload command. - 新增了替换默认流体和地底熔岩的功能。 | Added the ability to replace the default fluids and underground lava. - 向下兼容至1.21。 | Ported down to 1.21. - 在选项界面中添加了常见问题。 | Added frequently asked questions to the options screen. - 现在AppVeyor构建版本将自动发布到GitHub Release。 | The AppVeyor build version will automatically release to GitHub Release. ## 改进 | Improvements - 从现在开始，`Changelog.md` 将使用中英双语编写。 | From now on, `Changelog.md` will be written in both Chinese and English. - 提取了常用的偏移代码到 `Util` 类中。 | Extracted common offset code to `Util` class. - 调试屏幕中的 `TerrainXYZ` 现在会基于方块坐标计算，且会根据是否启用了 BigInteger 重写而显示不同的信息。 | The `TerrainXYZ` in the debug HUD now calculates based on block coordinates, and displays different information depending on whether BigInteger has been rewritten. - 优化了内部类的访问形式，不再使用 `accesswidener`。 | Optimized the access of internal classes, no longer using `accesswidener`. - 优化了“shift”类密度函数的偏移方式，不再使用 `@Overwrite` 而改用 `@ModifyArgs`，且类不再实现 `DensityFunctionTypes.Offset`。 | Optimized the offset of the "shift" class density function, no longer using `@Overwrite` but `@ModifyArgs`, and the class no longer implements `DensityFunctionTypes.Offset`. - 清除了编译时警告（再次）。 | Cleared compile-time warnings (again). - [!] 更改了Mod ID，不再兼容旧版本。 | Changed the Mod ID, no longer compatible with old versions. - 彻底重写了配置系统（不再兼容旧版，但是会自动迁移）。 | Completely rewrote the configuration system (not compatible with old versions, but will automatically migrate). - 在配置文件中添加了文件版本号。 | Added file version number to the configuration file. - Cloth Config 不再是必须依赖。 | Cloth Config is no longer required as a must-have dependency. - 为客户端类添加了注解。 | Added annotations to client classes. - 重写了末地岛屿生成算法。 | Revised the algorithm for generating the end islands. - 将“模拟末地环”更改为“修复末地环”，功能同样修改，且不需要再开启BigInteger重写。| Changed "Simulate End Rings" to "Fix End Rings", function is the same, and no longer need to enable BigInteger rewrite. - 将“替换地底熔岩”移入实验性功能。 | Moved "Replace Underground Lava" to experimental features. - 向`README.md`添加了徽章和更多内容。 | Added badges and more content to `README.md`. - 替换了ObjectValueWriter.class中已弃用的方法。 | Replaced the deprecated methods in ObjectValueWriter.class. - 去除了无用的import。 | Removed unnecessary imports. - 用中英双语重写了`Changelog.md`中原本只有英文的部分。 | Revised the English parts of `Changelog.md` into both Chinese and English. - 从现在开始，若一个次要更新的正式版发布，则将`Changelog.md`中其对应的开发版本的更新内容进行整合。 | From now on, if a formal release of a minor update is made, the corresponding development version update content in `Changelog.md` will be integrated. ## 漏洞修复 | Bug Fixes - 修复了类 `MixinAbstractChunkHolder` 未被声明为抽象类的问题。 | Fixed that the class `MixinAbstractChunkHolder` was not declared as an abstract class. - 修复了修改后 `weird_scale_multiplier` 密度函数无法正常工作的问题。 | Fixed that the modified `weird_scale_multiplier` density function did not work properly. - 修复了当边境之地位置为`RELEASE`时，噪声不会在负半轴上溢出的问题。 | Fixed that the noise would not overflow below the negative half-axis when the far lands position is set to `RELEASE`.