Server documentation

QuantumHy

Active

Hytale • Version 0.2.3

Instalación, claves de config, radio adaptativo de chunks y entidades, freeze de expand, gobernador de presión y convivencia con LeanCore en Hytale 0.6.

Mod overview GitHub CurseForge

Instalación, configuración y comportamiento en tiempo de ejecución de QuantumHy.

Resumen

QuantumHy es un mod de FPS del lado del servidor para Hytale 0.6. El cliente es nativo y no se puede modificar, pero el servidor decide cuánto tiene que renderizar cada cliente, así que QuantumHy lo recorta por jugador. Cada pocos segundos muestrea la densidad de entidades alrededor de cada jugador, la suaviza y la usa para reducir dos cosas: el radio de visión en chunks del cliente y el radio de stream de entidades por jugador. Un ajuste global de LOD de entidades descarta entidades pequeñas y lejanas antes, por encima de eso.

Nunca infla la visión más allá de lo que el jugador pidió. El radio no vuelve en el instante en que la densidad parece abierta: el expand se congela hasta que la carga esté calmada, el disco de density esté al menos a medio cargar, el jugador no esté volando y el mundo no esté bajo presión MSPT. Solo ayuda donde está instalado, nunca en un servidor remoto al que solo te conectas.

Instalación

Descarga QuantumHy-0.2.3.jar desde la pestaña Files de CurseForge
Coloca el JAR en la carpeta mods/ del servidor, o en solo Windows: %AppData%\Hytale\data\release\Mods
Inicia el servidor. La config se genera como QuantumHy.json en la carpeta de datos del plugin
Observa el registro del servidor por la línea de setup (ver Comprobando que funciona)

Comandos

/q status
/q help

Aliases: /quantumhy, /qhy. /q status es diagnóstico de solo lectura. No hay /q perf público.

Cómo funciona

En cada pasada (5s por defecto) QuantumHy hace el trabajo por jugador en el hilo del mundo dueño:

Muestrea la densidad (a veces se omite). Cuenta entidades en un disco de densityScanChunkRadius chunks (dx²+dz² ≤ r²). El barrido de 49 columnas se omite en la primera pasada, en vuelo (2+ chunks/pasada), en streaming, con caché del mismo chunk, y mientras ya está en el mínimo con expand congelado.
La suaviza. Una muestra válida pasa por una media móvil exponencial (densitySmoothing).
La convierte en un factor de reducción. La densidad usa smoothstep entre densityLowPerChunk y densityHighPerChunk. Se combina con shrink por chunk-load (sections cargadas + cargando) y un suelo baseline. El factor combinado solo aumenta el shrink hasta que el expand está permitido (ratchet).
Rampa dos palancas. La visión en chunks se mueve como máximo +1 / −2 por pasada (−4 bajo presión). El radio de entidades usa el mismo factor; en shrink completo ([min]) baja a minEntityViewBlocks en una escritura. Las escrituras paran después de worldPassBudgetMs o durante streaming.

El expand solo se permite tras expandHysteresisPasses pasadas calmadas, disco de density ≥ 50% cargado, sin streaming, sin desplazamiento rápido y sin presión MSPT.

entityLodAggressiveness es aparte: un único multiplicador de servidor sobre el culling de LOD del motor, aplicado al arrancar y restaurado al apagar.

Configuración

Archivo de runtime: QuantumHy.json en la carpeta de datos del plugin, creado en el primer arranque. Las instalaciones nuevas reciben configVersion 5.

Clave	Por defecto	Qué hace
`enabled`	`true`	Interruptor maestro. Cuando es false, QuantumHy nunca toca ningún radio de visión.
`verboseLog`	`false`	Registra cada pasada con la densidad y la decisión de visión de cada jugador. Off en instalaciones nuevas.
`checkForUpdates`	`true`	Al arrancar, lee la página de QuantumHy y avisa a operadores o `durkz.quantumhy.admin` si hay un JAR más nuevo.
`tickIntervalSeconds`	`5`	Cada cuánto revisa a cada jugador.
`initialDelaySeconds`	`20`	Espera este tiempo tras el arranque antes de la primera pasada.
`targetClientViewRadius`	`0`	Tope fijo en chunks. `0` significa sin tope, solo adapta por densidad.
`minClientViewRadius`	`6`	Nunca baja a nadie por debajo de este radio en chunks.
`maxClientViewRadius`	`32`	Tope para el límite fijo (el propio radio de visión del jugador sigue ganando).
`densityScanChunkRadius`	`4`	Cuántos chunks a cada lado contar entidades.
`densityLowPerChunk`	`1.0`	Entidades ponderadas por chunk en o por debajo de esto: sin shrink por densidad.
`densityHighPerChunk`	`4.0`	Entidades ponderadas por chunk en o por encima de esto: bajado al mínimo.
`densityRingWeighting`	`true`	Los chunks centrales cuentan al 100%, los anillos exteriores menos.
`densityRingEdgeWeight`	`0.55`	Peso en el anillo del borde (`1.0` = conteo plano).
`baselineShrinkFraction`	`0.10`	Shrink mínimo incluso con densidad “abierta” (`0` = off).
`chunkLoadShrinkEnabled`	`true`	Shrink extra por el recuento de sections cargadas + en streaming.
`chunkLoadLowChunks`	`700`	Sections loaded+loading en o por debajo de esto: sin shrink por chunk-load.
`chunkLoadHighChunks`	`1550`	En este recuento de sections o por encima: shrink por chunk-load al máximo.
`densitySmoothing`	`0.4`	Peso de la muestra más nueva en la EMA, en (0, 1]. `1.0` lo desactiva.
`adaptEntityRadius`	`true`	También reduce el radio de stream de entidades por jugador, no solo los chunks.
`minEntityViewBlocks`	`48`	Límite inferior del radio de entidades, en bloques (16 bloques = 1 chunk).
`entityLodAggressiveness`	`2.0`	Culling global de LOD de entidades. `1.0` es el valor del motor.
`maxEntityVerticalDistance`	`32`	Descarta entidades demasiado lejos arriba/abajo del jugador. `0` = off.
`maxVisibleEntitiesPerPlayer`	`80`	Tope de entidades streameadas por jugador en multitudes. `0` = off.
`holdSpawnOnLoadingChunks`	`true`	Pausa el spawn ambiental mientras algún jugador tiene backlog de sections.
`minViewRadiusDelta`	`2`	Cambio mínimo (chunks) antes de enviar una actualización. Los expands +1 siguen aplicándose.
`maxExpandChunksPerPass`	`1`	Máximo de chunks que el radio de visión sube en una pasada.
`maxShrinkChunksPerPass`	`2`	Máximo que baja en una pasada (duplicado bajo presión).
`maxExpandEntityBlocksPerPass`	`16`	Máximo de bloques que el radio de entidades sube en una pasada.
`expandHysteresisPasses`	`2`	Pasadas calmadas exigidas antes de permitir expand.
`worldPassBudgetMs`	`8`	Presupuesto de reloj para escrituras de radio en el hilo del mundo. `0` lo desactiva.
`pressureExitRequiresLastTick`	`true`	Pressure solo sale cuando el promedio de 10s y el último tick están calmados.
`respectStreamingGrace`	`true`	Retiene recortes mientras el jugador todavía transmite sections.
`streamingBacklogThreshold`	`80`	Cuántas sections cargando cuentan como “todavía transmitiendo”.
`smoothChunkStreaming`	`true`	Limita la velocidad a la que llegan sections a cada cliente gestionado.
`maxChunksPerSecond`	`128`	Tope de sections por segundo. `0` mantiene el valor del motor.
`maxChunksPerTick`	`8`	Tope de sections por tick (el motor usa 40 en 0.6).
`leanCoreTakeover`	`true`	Si LeanCore está instalado, le toma el radio de visión.
`yieldToLeanCoreViewRadius`	`false`	Deja el radio de visión del cliente enteramente a LeanCore.
`pressureGovernorEnabled`	`true`	Aprieta las palancas de render cuando el MSPT del mundo se mantiene alto.
`pressureMsptEnter`	`48`	Promedio de 10s de MSPT en este valor o por encima entra en pressure.
`pressureMsptExit`	`43`	MSPT en este valor o por debajo sale de pressure.
`pressureSustainSeconds`	`4`	Cuánto debe mantenerse alto el MSPT antes de apretar.
`pressureCooldownSeconds`	`15`	Cuánto debe mantenerse bajo el MSPT antes de restaurar.
`pressureDensityMultiplier`	`1.45`	Bajo presión, los umbrales de densidad se aprietan por este factor.
`pressureChunkRateMultiplier`	`0.75`	Bajo presión, multiplica los topes de streaming de chunks.
`pressureLodMultiplier`	`1.15`	Bajo presión, culling extra de LOD de entidades.
`pressureVerticalTrimBlocks`	`8`	Bajo presión, resta de `maxEntityVerticalDistance`.
`pressureWorldLevers`	`false`	Bajo presión, pausa spawn de NPC y tick de bloques (se restaura al salir).
`pressureTrimClientEffects`	`true`	Bajo presión, recorta bloom/sunshaft (se aplaza si el último tick es un hitch).
`pressureEffectScale`	`0.5`	Multiplicador de las intensidades de efecto mientras están recortadas.

Permisos

Permiso	Quién
`durkz.quantumhy.admin`	Avisos de update in-game. Los operadores del servidor lo heredan a través de `*`.

Usándolo con LeanCore

QuantumHy y LeanCore pueden ambos ajustar el radio de visión del cliente, y solo uno debe hacerlo. Por defecto QuantumHy lo toma: al arrancar detecta LeanCore y apaga la gobernanza de radio de visión de LeanCore (viewRadiusGovernanceEnabled, liteViewRadiusEnabled, motionViewRadiusBoostEnabled), y luego pasa a controlar el radio él mismo. LeanCore conserva el radio de simulación, el throughput de chunks y la memoria. No hace falta ningún cambio de config en ninguno de los dos lados. LeanCore es una dependencia opcional: cuando no está presente, QuantumHy se ejecuta por su cuenta.

leanCoreTakeover: false deja a LeanCore en paz. Entonces ambos pueden pelear por el radio de visión.
yieldToLeanCoreViewRadius: true hace que QuantumHy se quede fuera del radio de visión del cliente por completo y deja que LeanCore lo conserve.

Comprobando que funciona

Inicia el servidor y busca la línea de setup: QuantumHy 0.2.3 setup. config: verboseLog=false tickInterval=5s ... densityLow=1.0/ch densityHigh=4.0/ch baseline=10% ... entityLod=2.00x ... expand=1 shrink=2 ... budget=8ms
Luego la línea de inicio del runtime: QuantumHy runtime started (interval=5s, hardCap=0, min=6, max=32, scan=4, entityRadius=true).
Si LeanCore está presente: LeanCore detected: took over the client view radius (governance turned off). Si no: LeanCore not detected after 3 checks: QuantumHy owns the client view radius standalone.
Con verboseLog=true, cada pasada registra una línea por jugador. Leyéndola: Durkz_z 32/49ch 0.7/ch~0.5 cl 6=6 ent 48=48 [hold] significa 32 entidades en 49 chunks, visión en chunks retenida en 6, radio de entidades en 48 bloques, expand congelado (hold). Otros motivos comunes: [min], [pressure], [baseline], [chunk-load], [density].
El radio no salta 6→13 en una pasada. Bajo presión o volando deberías ver [pressure] o [hold], no 6->7 [baseline].

Licencia

Licencia MIT