GTO 0.6.0 服务器开设指南

本文介绍如何使用官方服务端包开设 GregTech Odyssey 多人服务器。服务端包自带安装脚本，可自动安装 Forge 并下载全部服务端模组，无需手动组装服务端文件。

阅读指引

1. 安装 Java
2. 解压服务端
3. 安装模组
4. 同意 EULA
5. 选择难度
6. 配置服务器
7. 启动

开服前准备

在服务器上安装 Java 25（可使用 Eclipse Temurin 等发行版），安装后在终端中执行以下命令，确认显示的版本为 25：

1. 前往 Releases 页面下载 GregTech-Odyssey-server.zip；

2. 将压缩包完整解压至一个空文件夹，下文称为“服务端目录”。

注意：请确保完整解压。服务端目录中的 gto-installer 文件夹缺失时，安装脚本将无法运行。

在服务端目录中运行安装脚本，并按提示选择语言：

脚本会自动安装 Forge 1.20.1-47.4.20，并下载全部服务端模组。出现「安装已成功完成」即表示安装结束。

提示：安装脚本可以重复运行。如需强制重新检查全部模组，可删除服务端目录中的 packwiz.json 后重新运行。请勿同时运行多个安装窗口。

1. 运行启动脚本：Windows 运行 run.bat，Linux / macOS 执行 bash run.sh；

2. 首次启动会生成 eula.txt 等文件，并自动退出；

3. 打开 eula.txt，将 eula=false 改为 eula=true 并保存。

说明：将 eula 设为 true 即表示同意 Minecraft 最终用户许可协议。此时尚未生成世界，请先完成第五、六步再正式启动。

服务器的难度由 config/gtocore-rules.txt 中的 preset 一行决定，可选值如下。各难度的差异请参阅难度特性指南。

例如，将难度设为普通：

注意：世界的难度在首次生成时即被锁定，之后无法更改，请在正式启动前确定。若已有世界与该文件中的难度不一致，服务器将拒绝启动，并生成 gtocore-rules.world.txt 记录该世界的规则。

说明：玩家客户端的难度设置无须手动调整。与服务器不一致时，进入服务器会自动同步服务器的规则，并提示玩家重启游戏。

内存：编辑服务端目录中的 user_jvm_args.txt，通过 -Xmx 参数设置最大内存，例如：

服务器属性：编辑 server.properties，常用设置如下：

再次运行启动脚本。控制台出现 Done 字样即表示启动完成，玩家可通过「服务器地址:端口」加入。常用控制台命令如下：

提示：在 Linux 上通过 SSH 运行时，建议在 screen 或 tmux 会话中启动服务器，以免断开连接后服务器随之关闭。关闭服务器时请使用 stop 命令，避免直接结束进程导致存档损坏。

本整合包使用 Open Parties and Claims 管理领地。如需在玩家离线时保持其领地区块加载，可在 world/serverconfig/openpartiesandclaims-default-player-config.toml 中设置：

注意：开启区块离线强加载会显著增加服务器负载，请根据服务器配置谨慎开启。

说明：更新时应将新版本解压至新的文件夹，再将旧服务端中的数据复制过去。请勿将新版本直接解压覆盖至旧服务端目录。复制完成后旧服务端保持原样，可直接作为备份，在确认新服务端运行正常之前请勿删除。

1. 安装新版本
2. 复制服务器数据
3. 启动并检查

按照「一、开设服务器」中的第二、三步，将新版本服务端解压至新的文件夹，并运行安装脚本。请勿删除旧服务端，它将作为备份保留。

先在旧服务器的控制台中执行 stop 关闭服务器，再将旧服务端目录中的下列文件夹与文件复制至新服务端目录的相同位置。遇到同名文件时选择覆盖；旧服务端中不存在的项目可直接跳过。

必须复制

按需复制

注意：请勿复制 mods 文件夹。新版本的模组存在升级与增删，复制旧的 mods 文件夹会造成模组重复或版本不匹配，导致服务器无法启动。如有自行添加的模组，请将对应的 jar 文件单独放入新服务端的 mods 文件夹。

提示：如在 server.properties 中修改过 level-name，请复制对应名称的世界文件夹。config/gtocore-rules.txt 须与世界的难度一致，否则服务器将拒绝启动，复制整个 config 即可保留该文件。

启动新服务端，确认世界正常加载、玩家可正常进入后，再视需要删除旧服务端。

注意：玩家的客户端须更新至与服务器相同的版本。客户端的更新方法请参阅GTO 0.6.0 安装与更新指南。

如问题仍未解决，请在聊天群中反馈，或前往 Issues 提交问题报告，并附上服务端日志或崩溃报告。