Desired Servers

Desired Servers

你所需的服务器将始终列出。

杂项

Desired Servers

Community and socials

 

Join the Discord Twitter Reddit

 

Get 25% off your first month at BisectHosting using code kreezxil

如果你想要几乎零成本地为任何整合包搭建服务器,可以选择 BisectHosting 的服务器,新用户使用优惠码 kreezxil 即可享受首月 25% 折扣。

 

在 Discord 上加入我们。


Description

Desired Servers

Desired Servers 会在每次游戏启动时,将你在 JSON 文件中列出的服务器添加到多人游戏服务器列表中,且不会替换玩家自己添加的服务器。整合包作者不再需要附带会覆盖玩家自己列表的 servers.dat。

Desired Servers 仅限客户端。请安装在客户端;在专用服务器上它只会记录一行日志,不做任何事。

 

要求

Minecraft 26.3、NeoForge 26.3.0.x 和 Java 25。较旧的 Minecraft 版本由本页面的旧文件覆盖;旧的 Fabric 文件需要 Fabric API。

 

工作原理

每次游戏启动时,模组会读取 config/desiredservers/desiredservers.json。对于每个条目:

  • 如果服务器列表中已经存在同名同地址(忽略大小写)的服务器,则跳过该条目。
  • 否则,将该服务器添加到列表末尾。

仅当至少添加了一个服务器时才会保存服务器列表,并且会先加载并保留玩家已有的服务器。如果玩家从列表中删除了你的某个服务器,它会在下次启动时重新出现,因为它仍在 JSON 文件中。

 

多人游戏界面中的服务器

多人游戏界面中的服务器

 

文件

首次启动会创建文件夹 config/desiredservers/,其中包含两个文件:

  • desiredservers.json:模组读取的列表。它创建时为空列表([]),因此全新安装不会添加任何内容,直到你列出服务器。
  • desiredservers.json.example:一个填写好的示例。模组从不读取此文件。不要重命名它;而是将其内容复制到 desiredservers.json 中。

 

desiredservers.json 是一个 JSON 数组,每个服务器对应一个对象。示例文件的布局也可用:一个带有 servers 数组的 JSON 对象,其他所有键(例如 _WARNING)都会被忽略。你可以将整个示例文件粘贴到 desiredservers.json 中。

[
  {
    "serverName": "My Server",
    "serverIP": "mc.example.com",
    "forceResourcePack": true
  },
  {
    "serverName": "\u00a76Gold Server",
    "serverIP": "play.example.org:25566",
    "forceResourcePack": false
  }
]

要添加另一个服务器,只需添加另一个包含其详细信息的块。

  • serverName(文本,必需):服务器列表中显示的名称。
  • serverIP(文本,必需):地址,可选择带 :端口。
  • forceResourcePack(true 或 false,可选,默认 false):见下文。

 

使用 forceResourcePack

如果服务器有玩家应始终使用的资源包,请将其设为 true。服务器条目添加时其 服务器资源包 选项会被设为 已启用,因此服务器的资源包会被自动接受,而不会弹出提示。设为 false 或省略该字段时,条目保持 Minecraft 的默认值,玩家会收到提示。

这是客户端对该条目的设置;它不会让服务器发送或要求资源包,后者是在服务器端配置的。它仅适用于模组添加的条目,绝不适用于列表中已有的服务器。旧版本使用的文本值 "true" 和 "false" 仍然被接受。

 

服务器名称中的颜色代码

在 serverName 中放入分节符颜色代码,可以写成字符本身或 \u00a7 后跟代码,例如 \u00a76 表示金色。

JSON 文件中带颜色代码的 serverName 值

多人游戏界面中的彩色名称

不支持 CMS 模组的 % 颜色代码,仅支持分节符。

 

如果文件中出现问题

  • 缺少非空 serverName 和 serverIP 文本值的条目会被跳过,并在 logs/latest.log 中记录一条警告。其他条目仍然会被使用。
  • 如果 desiredservers.json 不是有效的 JSON,或者既不是数组也不是带有 servers 数组的对象,则不会添加任何内容,文件保持原样。原因会作为错误记录在 logs/latest.log 中。
  • 如果文件有效但未列出任何服务器(例如默认的 []),logs/latest.log 中会有一条警告说明这一点。
  • 如果游戏的 servers.dat 存在但无法读取,则不会添加任何内容,servers.dat 保持不变。

 

在游戏内编辑:Config 按钮

在模组列表中,Desired Servers 的 Config 按钮会打开 desiredservers.json 的编辑器。

  • 列表会显示每个有效条目及其地址,以及资源包选项是否开启。
  • Add Server 和 Edit(或双击条目)会打开一个表单,包含服务器名称、服务器地址和服务器资源包开/关切换。名称和地址必须填写,且两个条目不能有相同的名称和地址。
  • Remove 将所选条目从列表中移除。
  • 在你按下 Save 之前不会写入任何内容;Cancel 会丢弃你的更改。
  • 保存会将 desiredservers.json 写为纯文本、美化打印的 JSON 数组(UTF-8),然后以与游戏启动时相同的方式添加尚未在多人游戏列表中的服务器。会显示一条消息说明添加了多少个。
  • 移除或编辑条目只会更改文件。编辑器从不删除或更改你多人游戏列表中已有的服务器:重命名条目后,新名称会被添加,而旧服务器会一直保留,直到你在多人游戏界面中删除它。
  • 文件中的无效条目不会显示,并会在保存时被丢弃;界面会告诉你数量。如果文件完全无法读取,编辑器会以只读方式打开,且绝不会覆盖它。

 

配置

desiredservers.json 就是全部配置;模组没有其他配置文件。模组在创建后不会自行重写它;只有你在编辑器中按下 Save 时才会重写。

编辑器的文本框使用与 Minecraft 自带“添加服务器”界面相同的限制:服务器名称最多 32 个字符(颜色代码计入),服务器地址最多 128 个。它们只限制编辑器中的输入;JSON 文件中已经更长的条目会原样显示和保存,不会被截断。

 

Info

其他信息

• 许可证:GNU GPLv3。Desired Servers 衍生自 Jake Evans 的 Featured Servers,同样为 GPLv3。感谢 Jake 提供原模组和许可证。

• 源码:gitlab.com/kreezxil/desired-servers。请在 问题追踪器 或 Discord 中报告问题。

• 仅限客户端。

 


以下为 26.3 NeoForge 之前版本的说明。

 

 

Get 25% off 1st months rent at Bisect Hosting using code Kreezxil

如果你想要几乎零成本地为任何整合包搭建服务器,可以选择 BisectHosting 的服务器,新用户使用优惠码 kreezxil 即可享受首月 25% 折扣

 

 

来自一个 GPLv3 许可、听起来与本模组非常相似的页面。

 

Fabric 版本需要 Fabric API。

 


Desired Servers

 

这是一个无需附带会覆盖玩家添加服务器的 servers.dat 文件的模组。

别再附带那个文件了,改用 Desired Servers!你可以用简单的 json 格式添加多个服务器。

 

首次运行时,如果不存在 desiredservers.json,模组会生成包含以下内容的文件:

[
  {
    "serverName": "Desired Server",
    "serverIP": "127.0.0.1",
"forceResourcePack":"true" }, { "serverName": "Another Desired Server!", "serverIP": "192.168.1.1",
"forceResourcePack":"false" } ]

 添加服务器就像添加另一个包含详细信息的 json 块一样简单。

 

服务器会在加载时添加到服务器列表,如果已存在则会被忽略。

 

服务器列表 JSON

 

使用 forceResourcePack

 如果服务器有玩家无论如何都必须拥有才能连接的资源包,请将其设为 true。当值为 true 时,玩家将被强制接收服务器强制的资源包。

 

如果服务器没有必须安装的资源包,即没有要强制给用户的资源包,请将其设为 false。或者在连接不需要资源包的情况下。

 

多人游戏界面中的服务器

 

小提示

Featured Servers/ 文件夹现在位于 config 文件夹中。

 

贴心功能

你可以使用 /u(通用)和分号来为服务器条目着色。

我们测试了在 desiredservers.json 的 servername 中放入 §6

 

在 Fabric 上同样有效

CMS 兼容性

CMS 唯一做的事就是允许你使用 % 而不是 § 来使用颜色代码

所以根本没有理由添加 CMS 支持

 

前因后果

Forge 不喜欢模组的布局方式,希望它更像默认示例。所以我为此添加了一些东西。此外,模组在报告方面捕获了太多内容,所以我拆开了它,并在绝对必要的地方添加了 try/catch 子句。

 

其他信息

* 与原始 GPLv3 相同的许可证,见 https://www.curseforge.com/minecraft/mc-mods/featured-servers

* 已移植到 1.16.1

* 源码现已可用

* 仅限客户端