Files
ServerAddressSpaceFix/README_EN.md
TheWhiteDog9487 ca8953d52e 0.2.5
修复Windows文件系统对大小写不敏感导致配置文件迁移会实际上导致原始配置文件被删除的问题
2026-06-17 13:29:24 +08:00

4.8 KiB
Raw Blame History

Note: This document was originally written in Chinese and translated to other languages by AI. If possible, I recommend reading the original Chinese document instead of a translated version.
简体中文GitHub     简体中文Gitea     EnglishGitHub     EnglishGitea

Introduction

This mod is intended to fix a bug that was reported on November 26, 2021 and still has not been fixed. Bug tracker link

Features

If the server address you enter on the "Add Server" or "Direct Connect" screen contains spaces at the beginning, the end, or in the middle, this mod will automatically remove them. This prevents the "Unknown Host" bug mentioned above.

Why this mod exists
        A few months ago, I wanted to play on a server. I copied the address from the server's official website, pasted it into the "Server Address" field, saved it, and unexpectedly got an "Unknown Host" error.
        No panic, this was obviously DNS failing to resolve the corresponding address. Let's try pinging it first.
        Ping could resolve the domain name to an address, and then I suspected the Great Firewall might be doing something again, so I used a tool from ZhanZhangJia to test it. The results were exactly the same as mine.
        That was rather strange.
        Then, after fiddling with it for a while, I found the problem.
        There was a space at the end of the server address I copied.
        That was pretty hard to accept. After continuing to tinker for a while and confirming that the problem could be reproduced reliably, I submitted a bug report to the tracker.
        And guess what?
        The issue I filed on the bug tracker
        The comment below
        An earlier bug report
        My English is completely terrible, so I did not continue talking about it. The issue description was written using a translator.
        But honestly, I felt this was kind of absurd.
        Since your address is a String, how hard could it be to call trim on it afterwards?
        Also, as a player, when you tell me, "This was your own carelessness, so it does not even count as a bug," I cannot accept that.
        So, this mod was born.
    

Configuration file

  • If you have version isolation enabled, it should be located at .minecraft\versions\<version name>\config\ServerAddressSpaceFix.json5
  • If you do not have version isolation enabled, it should be located at .minecraft\config\ServerAddressSpaceFix.json5

This is just a regular JSON text file, except that JSON5 supports additional features such as comments. All properties include comments, covering things such as functionality, value ranges, types, default values, and more. You can edit it with a normal text editor. You can even edit the configuration file while the game is running; it will be applied automatically after saving.

Known issues

All known issues have been fixed. If you find any new ones, please let me know. If anyone is willing to help fix a bug, PRs are welcome ╰(°▽°)╯

License

I use the even more aggressive WTFPL than MIT.