hytale-server/.env.example at main · Terkea/hytale-server · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
# Hytale Server Docker Environment Variables
# Copy this file to .env and customize as needed

# =============================================================================
# Server Settings
# =============================================================================

# Server name displayed to players
SERVER_NAME=My Hytale Server

# Message of the day (shown on login)
MOTD=Welcome to my Hytale server!

# Server password (leave empty for public server)
PASSWORD=

# Maximum number of concurrent players
MAX_PLAYERS=50

# View distance in chunks (recommended: 12 for performance)
MAX_VIEW_RADIUS=12

# Default world to load
DEFAULT_WORLD=default

# Default game mode for players
DEFAULT_GAMEMODE=Adventure

# =============================================================================
# Memory/JVM Settings
# =============================================================================

# Java heap size (both -Xms and -Xmx)
MEMORY=4G

# Initial heap size (defaults to MEMORY if not set)
# INIT_MEMORY=4G

# Maximum heap size (defaults to MEMORY if not set)
# MAX_MEMORY=8G

# Additional JVM arguments
# JVM_OPTS=

# Additional -XX JVM arguments
# JVM_XX_OPTS=

# Enable AOT (Ahead-of-Time) caching for faster startup
USE_AOT_CACHE=true

# =============================================================================
# Network Settings
# =============================================================================

# UDP port for game connections (Hytale uses QUIC over UDP)
SERVER_PORT=5520

# Network bind address
BIND_ADDRESS=0.0.0.0

# =============================================================================
# User/Permission Settings
# =============================================================================

# Linux user ID for file ownership
UID=1000

# Linux group ID for file ownership
GID=1000

# Container timezone
TZ=UTC

# =============================================================================
# Backup Settings
# =============================================================================

# Enable automatic backups
ENABLE_BACKUP=false

# Backup frequency in minutes
BACKUP_FREQUENCY=30

# Backup storage directory
BACKUP_DIR=/data/backups

# =============================================================================
# Configuration Settings
# =============================================================================

# Regenerate config.json from environment variables on each start
OVERRIDE_CONFIG=true

# Skip config updates entirely (use existing config.json as-is)
# SKIP_CONFIG_UPDATE=false

# =============================================================================
# Download/Update Settings
# =============================================================================

# Hytale server version (LATEST or specific version)
VERSION=LATEST

# Custom URL for server JAR (if not mounting directly)
# SERVER_JAR_URL=

# Custom URL for assets file (if not mounting directly)
# ASSETS_URL=

# Force re-download of server files
FORCE_REDOWNLOAD=false

# =============================================================================
# Debug/Development Settings
# =============================================================================

# Disable Sentry error reporting (useful during mod development)
# DISABLE_SENTRY=false