Back to Details

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：私有服务器

QuestionOptionsNotes
Where will you host?Local PC, VPS, Game HostLocal = 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, specificCan make new worlds later
Backups?Manual, automatedSet 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：公开服务器

QuestionOptionsNotes
Expected player count?10, 50, 100+Affects RAM/hosting needs
Moderation team?Solo, trusted friends, hiredPlan roles
Rules?PvP, griefing, chatDocument before opening
Server listing?Private, public discoveryAuthentication level
Anti-cheat?Plugins, vanillaConsider early
DDoS protection?Host-provided, CloudflareRequired for public
问题选项说明
预计玩家数量？10人、50人、100人以上影响内存/托管需求
管理团队配置？单人管理、信任的好友、雇佣管理员规划好角色分工
服务器规则？PvP、破坏行为、聊天规范开放前先整理成文
服务器列表可见性？私有、公开可发现关联身份验证级别
反作弊措施？插件、原版自带尽早考虑
DDoS防护？托管服务商提供、Cloudflare公开服务器必备

Requirements

需求条件

Hardware (Self-Hosting)

硬件（自行托管）

PlayersRAMCPUNotes
1-54GB2 coresMinimum
5-208GB4 coresRecommended
20-5016GB6 coresWith mods
50+32GB+8+ coresHeavy mods
玩家数量内存CPU说明
1-5人4GB2核最低要求
5-20人8GB4核推荐配置
20-50人16GB6核带模组场景
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：下载服务器文件

  1. Download 
    HytaleServer.jar
    from official source
  2. Download 
    Assets.zip
    (game assets)
  3. Place in a dedicated folder
  1. 从官方渠道下载
    HytaleServer.jar
  2. 下载
    Assets.zip
    （游戏资源包）
  3. 将文件放入专用文件夹

Step 2: First Launch

步骤2：首次启动

bash
undefined
bash
undefined

Windows

Windows

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

Linux

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
}
SettingDescription
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>
/op add <username>

Remove operator status

移除管理员权限

/op remove <username>
/op remove <username>

View player permissions

查看玩家权限

/permissions user <username> info

---
/permissions user <username> info

---

Networking

网络设置

Port Configuration

端口配置

ProtocolPortPurpose
UDP5520Game traffic (default)
Important: Hytale uses UDP, not TCP!
协议端口用途
UDP5520游戏流量（默认）
重要提示：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)

端口转发（家用路由器）

  1. Access router admin (usually 192.168.1.1)
  2. Find Port Forwarding section
  3. Add rule:
    • Protocol: UDP
    • External Port: 5520
    • Internal IP: Your server PC's IP
    • Internal Port: 5520
  1. 访问路由器管理后台（通常为192.168.1.1）
  2. 找到“端口转发”设置项
  3. 添加规则：
    • 协议：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

密码保护

In 
config.json
:
json
{
  "Password": "secretpassword123"
}
在
config.json
中设置：
json
{
  "Password": "secretpassword123"
}

Going Public Checklist

公开服务器检查清单

Before Launch

启动前准备

  • Rules documented - Create /rules command
  • Moderation team ready - Assign roles
  • Backup system working - Test restore
  • Anti-grief plugins - Protect builds
  • Reporting system - How players report issues
  • DDoS protection - If self-hosting
  • 规则文档化 - 创建/rules命令
  • 管理团队就绪 - 分配角色
  • 备份系统正常运行 - 测试恢复功能
  • 防破坏插件 - 保护建筑
  • 举报系统 - 玩家问题举报渠道
  • DDoS防护 - 自行托管时需配置

Server Hardening

服务器加固

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

Recommended Plugins

推荐插件

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

Hosting Options

托管选项

Self-Hosting

自行托管

ProsCons
FreeYour hardware/bandwidth
Full controlYou handle maintenance
No monthly costUptime depends on you
优点缺点
免费占用自身硬件/带宽
完全控制权需自行维护
无月度费用在线时长取决于个人

VPS Hosting

VPS托管

ProsCons
Always onlineMonthly cost ($10-50+)
Better bandwidthSome technical knowledge
ScalableYou manage software
Recommended VPS:
  • Hetzner, OVH, Linode, DigitalOcean
优点缺点
全天候在线月度费用（10-50美元以上）
带宽更优需要一定技术知识
可扩展需自行管理软件
推荐VPS服务商：
  • Hetzner、OVH、Linode、DigitalOcean

Game Server Hosts

游戏服务器托管商

ProsCons
Easy setupHigher cost
Control panelLess flexibility
Support includedLimited customization
Popular Hosts:
  • BisectHosting, Apex, Shockbyte, PebbleHost
优点缺点
搭建简便费用更高
提供控制面板灵活性较低
包含技术支持自定义空间有限
热门托管商：
  • BisectHosting、Apex、Shockbyte、PebbleHost

Common Commands

常用命令

CommandDescription
/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

故障排查

IssueSolution
Players can't connectCheck firewall + port forward (UDP!)
Authentication failedRe-run 
/auth login device
Server crashesCheck RAM allocation, reduce view distance
LagLower MaxPlayers, optimize plugins
World corruptionRestore 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

快速参考

TaskCommand/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 portUDP 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
    技能文档