hytale-server-admin

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Hytale Server Administration

Hytale服务器管理

Set up, configure, and manage Hytale servers.

搭建、配置并管理Hytale服务器。

Server Planning Questions

服务器规划问题

Before setting up, work through these questions with the server owner:

在搭建之前，请与服务器所有者一起梳理以下问题：

Phase 1: Private Server

阶段1：私有服务器

Question	Options	Notes
Where will you host?	Local PC, VPS, Game Host	Local = free, VPS = flexible, Host = easy
Who will have access?	Friends list (whitelist)	Start restricted
Starting vanilla or modded?	Vanilla first is great!	Can add mods anytime
World seed?	Random, specific	Can make new worlds later
Backups?	Manual, automated	Set schedule before playing

Tip: Starting vanilla is perfectly fine! You can add mods later - just make a new world if needed. Many groups prefer to learn vanilla first anyway!

问题	选项	说明
服务器托管位置？	本地电脑、VPS、游戏托管服务商	本地=免费，VPS=灵活，托管服务商=操作简便
允许哪些人访问？	好友列表（白名单）	初始阶段建议限制访问
从原版还是模组版开始？	建议先从原版开始！	可随时添加模组
世界种子？	随机、特定种子	之后可创建新的世界
备份方式？	手动备份、自动备份	开始游玩前设置备份计划

提示：从原版开始完全没问题！之后可以随时添加模组——如果需要的话，只需创建一个新世界即可。很多团队都倾向于先熟悉原版内容！

Phase 2: Going Public

阶段2：公开服务器

Question	Options	Notes
Expected player count?	10, 50, 100+	Affects RAM/hosting needs
Moderation team?	Solo, trusted friends, hired	Plan roles
Rules?	PvP, griefing, chat	Document before opening
Server listing?	Private, public discovery	Authentication level
Anti-cheat?	Plugins, vanilla	Consider early
DDoS protection?	Host-provided, Cloudflare	Required for public

问题	选项	说明
预计玩家数量？	10人、50人、100人以上	影响内存/托管需求
管理团队配置？	单人管理、信任的好友、雇佣管理员	规划好角色分工
服务器规则？	PvP、破坏行为、聊天规范	开放前先整理成文
服务器列表可见性？	私有、公开可发现	关联身份验证级别
反作弊措施？	插件、原版自带	尽早考虑
DDoS防护？	托管服务商提供、Cloudflare	公开服务器必备

Requirements

需求条件

Hardware (Self-Hosting)

硬件（自行托管）

Players	RAM	CPU	Notes
1-5	4GB	2 cores	Minimum
5-20	8GB	4 cores	Recommended
20-50	16GB	6 cores	With mods
50+	32GB+	8+ cores	Heavy mods

玩家数量	内存	CPU	说明
1-5人	4GB	2核	最低要求
5-20人	8GB	4核	推荐配置
20-50人	16GB	6核	带模组场景
50人以上	32GB+	8核以上	重度模组场景

Software

软件

Java 25 (required)
HytaleServer.jar (from Hytale)
Assets.zip (game assets)

Java 25（必填）
HytaleServer.jar（来自Hytale官方）
Assets.zip（游戏资源包）

Initial Setup

初始搭建

Step 1: Download Server Files

步骤1：下载服务器文件

Download
```
HytaleServer.jar
```
from official source
Download
```
Assets.zip
```
(game assets)
Place in a dedicated folder

从官方渠道下载
```
HytaleServer.jar
```
下载
```
Assets.zip
```
（游戏资源包）
将文件放入专用文件夹

Step 2: First Launch

步骤2：首次启动

bash

undefined

bash

undefined

Windows

java -Xmx4G -jar HytaleServer.jar --assets ./Assets.zip

Linux

java -Xmx4G -jar HytaleServer.jar --assets ./Assets.zip


This creates the folder structure:

server/ ├── HytaleServer.jar ├── Assets.zip ├── config.json # Server settings ├── permissions.json # Player permissions ├── whitelist.json # Allowed players ├── bans.json # Banned players └── universe/ └── worlds/ └── default/ └── config.json # World settings

undefined

java -Xmx4G -jar HytaleServer.jar --assets ./Assets.zip


此操作会生成如下文件夹结构：

server/ ├── HytaleServer.jar ├── Assets.zip ├── config.json # 服务器设置 ├── permissions.json # 玩家权限 ├── whitelist.json # 允许访问的玩家列表 ├── bans.json # 封禁玩家列表 └── universe/ └── worlds/ └── default/ └── config.json # 世界设置

undefined

Step 3: Authenticate

步骤3：身份验证

bash

undefined

bash

undefined

In server console

在服务器控制台中执行

/auth login device


1. Copy the URL and code shown
2. Visit URL in browser
3. Enter code to authenticate
4. Server can now accept connections

---

/auth login device


1. 复制显示的URL和验证码
2. 在浏览器中访问该URL
3. 输入验证码完成身份验证
4. 服务器现在可以接受玩家连接

---

Configuration Files

配置文件

config.json (Main Server)

config.json（主服务器配置）

json

{
  "ServerName": "My Hytale Server",
  "MOTD": "Welcome to our server!",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 12,
  "LocalCompressionEnabled": true
}

Setting	Description
`ServerName`	Displayed to players
`MOTD`	Message of the day
`Password`	Empty = no password
`MaxPlayers`	Concurrent player limit
`MaxViewRadius`	Render distance

json

{
  "ServerName": "My Hytale Server",
  "MOTD": "Welcome to our server!",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 12,
  "LocalCompressionEnabled": true
}

设置项	说明
`ServerName`	显示给玩家的服务器名称
`MOTD`	每日提示消息（Message of the day）
`Password`	留空则无需密码
`MaxPlayers`	同时在线玩家上限
`MaxViewRadius`	渲染距离

World config.json

世界config.json

Located in

universe/worlds/[name]/config.json

json

{
  "seed": "my-custom-seed",
  "pvp": true,
  "fallDamage": true,
  "keepInventory": false,
  "difficulty": "normal"
}

位于

universe/worlds/[name]/config.json

：

json

{
  "seed": "my-custom-seed",
  "pvp": true,
  "fallDamage": true,
  "keepInventory": false,
  "difficulty": "normal"
}

Permissions System

权限系统

permissions.json Structure

permissions.json结构

json

{
  "groups": {
    "default": {
      "permissions": [
        "hytale.command.help",
        "hytale.command.spawn"
      ]
    },
    "moderator": {
      "inherits": ["default"],
      "permissions": [
        "hytale.command.kick",
        "hytale.command.mute",
        "hytale.command.tp"
      ]
    },
    "admin": {
      "inherits": ["moderator"],
      "permissions": [
        "hytale.command.*",
        "hytale.admin.*"
      ]
    }
  },
  "users": {
    "player-uuid-here": {
      "groups": ["admin"]
    }
  }
}

json

{
  "groups": {
    "default": {
      "permissions": [
        "hytale.command.help",
        "hytale.command.spawn"
      ]
    },
    "moderator": {
      "inherits": ["default"],
      "permissions": [
        "hytale.command.kick",
        "hytale.command.mute",
        "hytale.command.tp"
      ]
    },
    "admin": {
      "inherits": ["moderator"],
      "permissions": [
        "hytale.command.*",
        "hytale.admin.*"
      ]
    }
  },
  "users": {
    "player-uuid-here": {
      "groups": ["admin"]
    }
  }
}

Permission Commands

权限命令

bash

undefined

bash

undefined

Grant operator status

授予管理员权限

/op add <username>

Remove operator status

移除管理员权限

/op remove <username>

View player permissions

查看玩家权限

/permissions user <username> info

---

/permissions user <username> info

---

Networking

网络设置

Port Configuration

端口配置

Protocol	Port	Purpose
UDP	5520	Game traffic (default)

Important: Hytale uses UDP, not TCP!

协议	端口	用途
UDP	5520	游戏流量（默认）

重要提示：Hytale使用UDP协议，而非TCP！

Firewall Rules

防火墙规则

Windows PowerShell (Admin):

powershell

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Linux (ufw):

bash

sudo ufw allow 5520/udp

Linux (iptables):

bash

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Windows PowerShell（管理员权限）：

powershell

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Linux（ufw）：

bash

sudo ufw allow 5520/udp

Linux（iptables）：

bash

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Port Forwarding (Home Router)

端口转发（家用路由器）

Access router admin (usually 192.168.1.1)
Find Port Forwarding section
Add rule:
- Protocol: UDP
- External Port: 5520
- Internal IP: Your server PC's IP
- Internal Port: 5520

访问路由器管理后台（通常为192.168.1.1）
找到“端口转发”设置项
添加规则：
- 协议：UDP
- 外部端口：5520
- 内部IP：服务器电脑的IP地址
- 内部端口：5520

Custom Port

自定义端口

bash

java -jar HytaleServer.jar --assets ./Assets.zip --bind 0.0.0.0:25565

bash

java -jar HytaleServer.jar --assets ./Assets.zip --bind 0.0.0.0:25565

Private Server Setup

私有服务器搭建

Whitelist-Only Access

仅白名单访问

Edit

whitelist.json

json

{
  "enabled": true,
  "players": [
    "friend1-uuid",
    "friend2-uuid"
  ]
}

Or use commands:

bash

/whitelist add <username>
/whitelist remove <username>
/whitelist on
/whitelist off

编辑

whitelist.json

：

json

{
  "enabled": true,
  "players": [
    "friend1-uuid",
    "friend2-uuid"
  ]
}

或使用命令：

bash

/whitelist add <username>
/whitelist remove <username>
/whitelist on
/whitelist off

Password Protection

密码保护

config.json

json

{
  "Password": "secretpassword123"
}

在

config.json

中设置：

json

{
  "Password": "secretpassword123"
}

Going Public Checklist

公开服务器检查清单

Before Launch

启动前准备

Server Hardening

服务器加固

json

{
  "MaxPlayers": 50,
  "RateLimit": {
    "ConnectionsPerIP": 2,
    "CommandsPerMinute": 30
  }
}

json

{
  "MaxPlayers": 50,
  "RateLimit": {
    "ConnectionsPerIP": 2,
    "CommandsPerMinute": 30
  }
}

Recommended Plugins

Purpose	Examples
Permissions	HyperPerms
Economy	HyVault
Protection	WorldGuard-equivalent
Moderation	Essentials-equivalent

用途	示例
权限管理	HyperPerms
经济系统	HyVault
世界保护	类似WorldGuard的插件
服务器管理	类似Essentials的插件

Hosting Options

托管选项

Self-Hosting

自行托管

Pros	Cons
Free	Your hardware/bandwidth
Full control	You handle maintenance
No monthly cost	Uptime depends on you

优点	缺点
免费	占用自身硬件/带宽
完全控制权	需自行维护
无月度费用	在线时长取决于个人

VPS Hosting

VPS托管

Pros	Cons
Always online	Monthly cost ($10-50+)
Better bandwidth	Some technical knowledge
Scalable	You manage software

Recommended VPS:

Hetzner, OVH, Linode, DigitalOcean

优点	缺点
全天候在线	月度费用（10-50美元以上）
带宽更优	需要一定技术知识
可扩展	需自行管理软件

推荐VPS服务商：

Hetzner、OVH、Linode、DigitalOcean

Game Server Hosts

游戏服务器托管商

Pros	Cons
Easy setup	Higher cost
Control panel	Less flexibility
Support included	Limited customization

Popular Hosts:

BisectHosting, Apex, Shockbyte, PebbleHost

优点	缺点
搭建简便	费用更高
提供控制面板	灵活性较低
包含技术支持	自定义空间有限

热门托管商：

BisectHosting、Apex、Shockbyte、PebbleHost

Common Commands

常用命令

Command	Description
`/help`	List all commands
`/op add <user>`	Grant admin
`/kick <user>`	Kick player
`/ban <user>`	Ban player
`/whitelist add <user>`	Allow player
`/tp <user>`	Teleport to player
`/gamemode <mode>`	Change gamemode
`/plugin list`	List plugins
`/plugin reload`	Reload plugins
`/save-all`	Force world save
`/stop`	Gracefully stop server

命令	说明
`/help`	列出所有命令
`/op add <user>`	授予管理员权限
`/kick <user>`	踢出玩家
`/ban <user>`	封禁玩家
`/whitelist add <user>`	添加白名单玩家
`/tp <user>`	传送到指定玩家位置
`/gamemode <mode>`	切换游戏模式
`/plugin list`	列出已安装插件
`/plugin reload`	重新加载插件
`/save-all`	强制保存世界数据
`/stop`	优雅停止服务器

Troubleshooting

故障排查

Issue	Solution
Players can't connect	Check firewall + port forward (UDP!)
Authentication failed	Re-run `/auth login device`
Server crashes	Check RAM allocation, reduce view distance
Lag	Lower MaxPlayers, optimize plugins
World corruption	Restore from backup

问题	解决方案
玩家无法连接	检查防火墙设置及端口转发（注意是UDP协议！）
身份验证失败	重新执行 `/auth login device` 命令
服务器崩溃	检查内存分配，降低渲染距离
服务器卡顿	降低最大玩家数，优化插件
世界数据损坏	从备份恢复

Backup Strategy

备份策略

Manual Backup

手动备份

bash

undefined

bash

undefined

Stop server first!

请先停止服务器！

cp -r universe/ backup/universe_$(date +%Y%m%d)/

undefined

cp -r universe/ backup/universe_$(date +%Y%m%d)/

undefined

Automated (Linux cron)

自动备份（Linux cron）

bash

undefined

bash

undefined

Daily backup at 4 AM

每日凌晨4点备份

0 4 * * * /path/to/backup-script.sh

---

0 4 * * * /path/to/backup-script.sh

---

Quick Reference

快速参考

Task	Command/File
Start server	`java -Xmx4G -jar HytaleServer.jar --assets ./Assets.zip`
Authenticate	`/auth login device`
Main config	`config.json`
Permissions	`permissions.json`
Whitelist	`whitelist.json` / `/whitelist`
Default port	UDP 5520

任务	命令/文件
启动服务器	`java -Xmx4G -jar HytaleServer.jar --assets ./Assets.zip`
身份验证	`/auth login device`
主配置文件	`config.json`
权限配置文件	`permissions.json`
白名单配置	`whitelist.json` / `/whitelist` 命令
默认端口	UDP 5520

Resources

参考资源

Official Manual: Hytale Server Manual
Plugin Development: See
```
hytale-plugin-dev
```
skill
Team Workflow: See
```
git-workflow
```
skill

官方手册：Hytale Server Manual
插件开发：参考
```
hytale-plugin-dev
```
技能文档
团队协作流程：参考
```
git-workflow
```
技能文档

hytale-server-admin

Original

Translation

Hytale Server Administration

Hytale服务器管理

Server Planning Questions

服务器规划问题

Phase 1: Private Server

阶段1：私有服务器

Phase 2: Going Public

阶段2：公开服务器

Requirements

需求条件

Hardware (Self-Hosting)

硬件（自行托管）

Software

软件

Initial Setup

初始搭建

Step 1: Download Server Files

步骤1：下载服务器文件

Step 2: First Launch

步骤2：首次启动

Windows

Windows

Linux

Linux

Step 3: Authenticate

步骤3：身份验证

In server console

在服务器控制台中执行

Configuration Files

配置文件

config.json (Main Server)

config.json（主服务器配置）

World config.json

世界config.json

Permissions System

权限系统

permissions.json Structure

permissions.json结构

Permission Commands

权限命令

Grant operator status

授予管理员权限

Remove operator status

移除管理员权限

View player permissions

查看玩家权限

Networking

网络设置

Port Configuration

端口配置

Firewall Rules

防火墙规则

Port Forwarding (Home Router)

端口转发（家用路由器）

Custom Port

自定义端口

Private Server Setup

私有服务器搭建

Whitelist-Only Access

仅白名单访问

Password Protection

密码保护

Going Public Checklist

公开服务器检查清单

Before Launch

启动前准备

Server Hardening

服务器加固

Recommended Plugins

推荐插件

Hosting Options

托管选项

Self-Hosting

自行托管

VPS Hosting

VPS托管

Game Server Hosts