Source: Decompiled from
HytaleServer.jar(pre-release2026.02.05-9ce2783f7)
Settings control performance tuning for the V2 world generation system. They are loaded from HytaleGenerator/Settings/ and affect threading, buffer allocation, and generation targeting.
Class: SettingsAsset
Asset Store Path: HytaleGenerator/Settings
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
CustomConcurrency |
int |
No | -1 |
Custom thread count for generation (> -2). Use -1 for auto-detect (75% of CPU cores) |
BufferCapacityFactor |
double |
No | 0.3 |
Buffer capacity multiplier for memory allocation (>= 0.0) |
TargetViewDistance |
double |
No | 512.0 |
Target view distance in blocks (>= 0.0) |
TargetPlayerCount |
double |
No | 3.0 |
Target simultaneous player count (>= 0.0) |
StatsCheckpoints |
int[] |
No | [] |
Checkpoint intervals for generation statistics |
Controls the thread pool size for world generation. The default value of -1 triggers auto-detection, which uses 75% of available CPU cores (defined in ChunkGenerator.POOL_SIZE).
Setting this to a positive integer overrides the auto-detection with a fixed thread count.
Multiplier for internal buffer allocation during chunk generation. Higher values allocate more memory for generation buffers, which can improve throughput at the cost of memory usage.
These values are used together for performance calculations — determining how many chunks need to be generated and cached based on expected player distribution and view distances.
The default chunk cache size is 50,000 entries and the cave cache is 5,000 entries (defined in ChunkGenerator).
An array of chunk generation counts at which statistics should be logged. Useful for benchmarking and profiling generation performance.
{
"CustomConcurrency": 8,
"BufferCapacityFactor": 0.5,
"TargetViewDistance": 768.0,
"TargetPlayerCount": 10.0,
"StatsCheckpoints": [100, 500, 1000, 5000]
}Source files: SettingsAsset.java