Terasology多人服务器搭建：完整部署与配置指南

Terasology是一款开源的体素世界游戏，支持多人联机功能。本指南将详细介绍如何快速搭建Terasology多人服务器，包括环境准备、服务器部署、配置优化和权限管理等关键步骤，帮助你轻松创建自己的在线游戏世界。

🚀 准备工作：服务器环境要求

在开始部署Terasology服务器前，请确保你的系统满足以下要求：

• Java环境：安装Java 11或更高版本（推荐OpenJDK 11）
• 硬件配置：最低2核CPU、4GB内存，推荐4核CPU、8GB内存以获得更好性能
• 网络要求：开放TCP端口25777（默认端口），并配置端口转发（如使用路由器）

图1：Terasology多人游戏场景展示

⚙️ 三种部署方式对比

1. 快速启动：使用官方发行版（推荐新手）

1. 下载服务器文件
   访问Terasology官方发布页面下载最新的Omega Release版本

2. 启动服务器
   在终端中执行以下命令：

   java -jar Terasology.jar --headless
   

   默认服务器端口为25777，首次启动会自动生成配置文件和世界数据

3. 验证启动
   查看终端输出，当显示"Server started successfully"时表示启动成功

2. Docker部署：适合Linux服务器

1. 安装Docker
   确保已安装Docker引擎：

   sudo apt-get install docker.io  # Ubuntu/Debian系统
   

2. 拉取镜像并启动

   docker run -d -p 25777:25777 qwick/terasology
   

   注：Docker镜像相关问题请反馈至qwc/docker-terasology

3. 源码编译：适合开发者

1. 克隆代码仓库

   git clone https://gitcode.com/gh_mirrors/te/Terasology
   cd Terasology
   

2. 编译并启动

   ./gradlew server  # Linux/MacOS
   # 或使用Intellij IDEA运行配置"TerasologyPC (Headless)"
   

图2：Terasology服务器架构示意图

🔧 核心配置详解

基础配置文件：config.cfg

服务器启动后会在工作目录生成config.cfg文件，关键配置项说明：

{
  "network": {
    "serverPort": 25777,  // 服务器端口
    "maxPlayers": 16      // 最大玩家数
  },
  "defaultModSelection": {  // 默认模块选择
    "modules": [
      "Core",
      "CoreWorlds",
      "Sample"
    ]
  },
  "defaultGenerator": "CoreWorlds:facetedPerlin"  // 默认世界生成器
}

自定义端口与模块

1. 修改服务器端口
   启动时指定端口：

   java -jar Terasology.jar --headless --server-port=25778
   

2. 模块配置
   编辑config.cfg中的defaultModSelection部分添加模块，例如：

   "defaultModSelection": {
     "modules": [
       "Core",
       "CoreWorlds",
       "Inventory",
       "Behaviors"
     ]
   }
   

   修改后需删除saves目录并重启服务器使配置生效

世界生成器选择

Terasology支持多种世界生成器，常用选项：

• CoreWorlds:facetedPerlin：默认的多生物群系世界
• CoreWorlds:flat：平坦世界，适合测试
• WildAnimals:hilly：带有野生动物的丘陵地形

在config.cfg中设置：

"defaultGenerator": "CoreWorlds:facetedPerlin"

🔑 管理员权限与安全设置

获取管理员权限

1. 服务器首次启动后，在config.cfg中找到oneTimeAuthorizationKey字段
2. 客户端连接服务器后，在聊天框输入：

   /auth <your_authorization_key>
   

   即可获得管理员权限（除debug权限外的所有权限）

常用管理命令

命令	功能
/shutdownServer	优雅关闭服务器
/kick <玩家名>	踢出玩家
/ban <玩家名>	封禁玩家
/tp <玩家名> <x> <y> <z>	传送玩家
/help	查看所有命令

📊 服务器维护与优化

定期备份

建议定期备份saves目录，可使用以下脚本：

# 创建备份脚本 backup.sh
#!/bin/bash
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
zip -r "backup_$TIMESTAMP.zip" saves/

性能优化建议

1. 调整视距
   在config.cfg中修改：

   "rendering": {
     "viewDistance": 16  // 降低视距可减少内存占用
   }
   

2. 限制实体数量
   安装PerformanceMonitor模块监控服务器性能：

   "defaultModSelection": {
     "modules": [
       ...,
       "PerformanceMonitor"
     ]
   }
   

❓ 常见问题解决

客户端无法连接服务器

1. 检查服务器端口是否开放：

   netstat -tuln | grep 25777
   

2. 确认防火墙设置，开放25777端口：

   sudo ufw allow 25777/tcp
   

3. 检查路由器端口转发配置

服务器启动失败

1. 删除config.cfg后重新启动，生成默认配置
2. 检查Java版本是否符合要求：

   java -version  # 需显示Java 11+
   

3. 查看日志文件logs/latest.log定位错误原因

📚 进阶资源

• 官方文档：docs/Setup-a-headless-server.md
• 模块开发指南：docs/Developing-Modules.md
• 命令参考：docs/Developing-Commands.md

图3：Terasology模块管理界面

通过本指南，你已经掌握了Terasology多人服务器的搭建与配置技巧。现在邀请你的朋友一起探索这个无限可能的体素世界吧！如有其他问题，欢迎参与Terasology社区讨论。