Documentación del servidor

WorldPulse

Activo

Hytale • Version 0.3.0

Ecología regional con reproducción, crecimiento, búsqueda de alimento de depredadores y avisos por especie. Incluye fauna natural elegible del juego y otros mods.

Resumen del mod CurseForge

Resumen

Caza en la misma zona cada día y su fauna escaseará. Déjala descansar y las poblaciones se recuperarán, con ayuda de regiones vecinas adecuadas. Los animales sanos pueden reproducirse y las crías crecen hasta ser adultas.

WorldPulse funciona automáticamente en mundos de un jugador, mundos con amigos y servidores dedicados. Instala y juega. Los comandos son para administración y diagnóstico.

Instalación

Requiere Hytale 0.7.0+.
Descarga WorldPulse-0.3.0.jar desde la pestaña Files de CurseForge.
Cierra el mundo o servidor. Sustituye el JAR anterior de WorldPulse en UserData/Mods/ o en mods/ del servidor, dejando una sola copia.
Inicia el mundo. No necesitas comandos para jugar. La configuración se crea en mods/durkz_WorldPulse/WorldPulse.json.

Regiones, caza y recuperación

La salud poblacional es un índice regional, no un recuento de todos los animales vivos. La región predeterminada mide 8 x 8 chunks, o 256 x 256 bloques. Cada mundo mantiene poblaciones independientes por especie. Una muerte de fauna natural elegible causada por un jugador resta killImpact al índice local, hasta minHealth. Cuentan los golpes directos y proyectiles atribuidos al jugador.

La recuperación usa el calendario del mundo. El valor base de recoveryDays es 4 días de 10% a 90%; demografía, hábitat, presión de caza y migración modifican el ritmo real. Los vecinos adecuados pueden ayudar a recolonizar. Esto no mueve físicamente animales existentes. Dormir y avanzar el tiempo pueden acelerar la recuperación; con el calendario parado, el tiempo real no envejece animales.

La escasez reduce objetivos de futuros spawns naturales y respeta grupos, cuotas regionales/globales y spawns pendientes. No se sacrifican animales existentes. La fauna natural elegible de marcadores y balizas usa límites propios de su origen. Animales creados por comandos, mascotas, monstruos y encuentros programados o de facciones permanecen excluidos por defecto.

Detección de fauna y compatibilidad

WorldPulse lee los roles registrados, categorías resueltas, capacidades de modelos y claves de nombre del juego, incluidos los de otros mods. Siguen disponibles las reglas por carpeta, y la detección por categoría amplía la cobertura sin una lista fija de especies. La fauna nativa incluye roles terrestres, acuáticos y de aves adecuados; monstruos, humanoides y animales domesticados quedan excluidos por la política predeterminada.

extraRoles y excludedRoles son ajustes administrativos opcionales. Consulta /wp inspect <role> para conocer el motivo real de inclusión o exclusión, limitaciones de modelo o ciclo vital, evidencias alimentarias y cuotas nativas activas. Un rol elegible puede admitir seguimiento poblacional sin disponer de los datos de modelo necesarios para reproducirse. La compatibilidad no cubre automáticamente todos los paquetes ni todos los NPC registrados.

La compatibilidad usa datos registrados, sin copias incluidas ni parches específicos de paquetes. Se comprobó WildTale 5.2 junto a WorldPulse, incluida fauna elegible y transiciones de captura y domesticación. Los roles y generadores de objetos defectuosos de terceros siguen siendo responsabilidad del mod original. La búsqueda de alimento admite menos roles que el seguimiento poblacional; un animal puede participar en ecología sin recibir una nueva IA de búsqueda.

Reproducción y crecimiento

La reproducción necesita padres adultos elegibles, hábitat adecuado, salud poblacional de al menos 60%, presión de caza no superior al 50%, intervalos de los padres y espacio en las cuotas nativas. Los tiempos se derivan del volumen del modelo, limitados a entre 1 y 4 días de juego. Los nacimientos también respetan espacio de colisión y límites de reservas.

Se elige un rol juvenil nativo solo si su relación con el adulto es inequívoca. De lo contrario, el modelo original empieza al 60% de escala. Las crías empiezan con el 50% de vida y daño nativos y crecen gradualmente conservando su IA nativa. Si la caja de colisión adulta no cabe, se mantiene la fase juvenil hasta que haya espacio. Se preservan identidad y proporción de vida durante el crecimiento.

El ciclo vital se guarda con el animal. Volver a un chunk descargado puede avanzar el crecimiento según el calendario del mundo en ejecución, pero no hay cola de nacimientos mientras está descargado. La domesticación retira efectos de edad identificables de WorldPulse y preserva cambios independientes de modelo o atributos.

Un nacimiento cancelado o fallido devuelve su cuota diaria reservada y los intervalos de los padres. Una cría creada conserva la reserva aunque falle una operación posterior. Un cierre abrupto con resultado de spawn desconocido conserva la reserva persistida para evitar duplicados; la recuperación de registros nunca crea animales.

Mensajes ecológicos

Los jugadores de la región afectada reciben avisos con la especie correspondiente: declive por caza, escasez, recuperación, presión que dificulta el retorno, un nacimiento completado o la llegada a la edad adulta. Los avisos se basan en cambios reales de estado o eventos completados. No anuncian migración física.

Hay un límite compartido de un mensaje por jugador cada 10 segundos y una espera de dos minutos por especie/evento y contexto, con excepción para declive crítico. Así las comprobaciones repetidas no llenan el chat. Los nombres usan registros y traducciones disponibles del juego; las frases están en inglés. Define enableEcologyMessages como false para desactivarlos.

Las búsquedas por hambre, las concentraciones de depredadores hambrientos y las cacerías completadas también pueden generar avisos locales. Un aviso informa de actividad observada; no garantiza un ataque ni identifica una casa como objetivo.

Hambre y búsqueda de alimento

Los depredadores adultos elegibles acumulan hambre solo mientras están cargados. Con presas normales, el ritmo predeterminado es de 40 minutos cargados de alimentado a totalmente hambriento; la escasez de presas conocidas puede duplicarlo. La búsqueda empieza con un 50% de hambre, usa pasos de 24 bloques y permite hasta ocho búsquedas simultáneas por mundo. Las cacerías elegibles completadas reducen el hambre.

Los depredadores usan navegación y combate nativos. Buscan en terreno cercano cargado y áreas vecinas adecuadas, con trabajo limitado y reintentos controlados para rutas bloqueadas. WorldPulse no localiza camas, casas ni jugadores distantes, y no crea ni teletransporta depredadores para provocar encuentros. La agresividad nativa sigue funcionando con independencia del hambre.

La lista predeterminada contiene 20 roles nativos. Añadir un animal de otro mod a foragingRoles no garantiza compatibilidad: también necesita una plantilla nativa compatible, movimiento y metadatos utilizables. Los animales domesticados salen del sistema. El hambre por tiempo cargado y el ciclo vital se guardan con el animal; el tiempo sin conexión no acumula cacerías ni nacimientos pendientes.

Red alimentaria

Una relación depredador/presa se activa tras la muerte de tres UUID distintos de presas a manos del mismo rol de depredador en ese mundo. Solo las interacciones letales atribuidas a depredadores naturales elegibles aportan evidencias; el miedo o la hostilidad por sí solos no definen dieta. Con un vínculo conocido, la disponibilidad local de presas puede reducir futuros spawns del depredador, limitada por predatorMinFactor.

Esto representa interacciones letales repetidas, no animaciones de alimentación ni una dieta biológica completa. Las dietas desconocidas permanecen neutrales. Las evidencias se guardan por mundo y aparecen en /wp inspect <role>.

Características

Poblaciones regionales: cada especie tiene su propia salud poblacional por región, de 8 x 8 chunks por defecto. La caza de jugadores reduce sus próximos spawns naturales allí.
Recuperación y presión de caza: las poblaciones se recuperan durante los días de juego. Hábitat y presión modifican la recuperación, y vecinos sanos pueden favorecer la recolonización.
Reproducción física: la fauna natural elegible puede tener crías cuando lo permiten los padres, la salud poblacional, el hábitat y los límites nativos de spawn.
Crías que crecen: empiezan más pequeñas y débiles y crecen gradualmente. Se usan roles juveniles nativos si existe una relación fiable; de lo contrario, se reduce la escala del modelo original.
Avisos por cada especie afectada: los jugadores de la región reciben mensajes sobre declive, escasez, recuperación, presión de caza, nacimientos reales y madurez, con intervalos.
Fauna nativa y de otros mods: los metadatos de roles registrados aportan clasificación, modelos y nombres. No hace falta que el jugador configure ni registre los animales de cada mod.
Relaciones de depredación aprendidas: las muertes repetidas causadas por depredadores establecen vínculos con presas. Su escasez puede reducir futuros spawns del depredador; las dietas desconocidas permanecen neutrales.
Mundos persistentes: poblaciones, presión, intervalos de reproducción, estado de las crías y relaciones alimentarias aprendidas sobreviven a guardados y reinicios.
Depredadores hambrientos: 20 roles nativos configurados pueden buscar alimento en terreno cercano cargado mediante navegación nativa. La escasez de presas acelera el hambre; la agresividad nativa sigue siendo independiente.
Fauna de marcadores y balizas: los animales naturales elegibles de estos puntos participan en ecología y reproducción dentro de los límites nativos de su origen. Mascotas, monstruos y encuentros programados mantienen sus exclusiones.

Comandos

Comando de administración: /wp. Los jugadores normales reciben avisos ecológicos sin permiso de comandos.

Comando	Descripción
`/wp here`	Muestra la salud poblacional de la fauna en la región actual.
`/wp set <species> <percent>`	Define la salud poblacional local de 0 a 100 para un rol de spawn registrado.
`/wp tick <days>`	Avanza la recuperación poblacional de este mundo los días solicitados; no adelanta todo el tiempo del mundo.
`/wp reset`	Borra poblaciones regionales, hábitat, presión y reservas/intervalos de reproducción de este mundo. No borra el archivo alimentario separado.
`/wp stats`	Muestra contadores de caza, spawn, catálogo y capacidades.
`/wp inspect <role>`	Explica elegibilidad, soporte de modelo/ciclo vital, evidencias de presas y cuotas nativas activas.

Permisos

durkz.worldpulse.command.wp: acceso a comandos /wp y avisos de actualización. Los operadores lo tienen por defecto.

Configuración

Archivo: mods/durkz_WorldPulse/WorldPulse.json. Los valores siguientes corresponden a una configuración nueva. Se conservan los ajustes válidos existentes, por lo que un mundo antiguo puede mantener su recuperación anterior. Reinicia tras editar. El mod gestiona configVersion.

Campo	Predeterminado	Descripción
`configVersion`	`3`	Formato interno de configuración.
`enabled`	`true`	Activa WorldPulse.
`regionSizeChunks`	`8`	Lado de la región en chunks, de 1 a 64.
`killImpact`	`0.1`	Salud poblacional perdida por muerte atribuida al jugador.
`killImpactByRole`	`{}`	Ajustes opcionales de impacto por rol.
`minHealth`	`0.02`	Salud poblacional mínima.
`recoveryDays`	`4.0`	Días de juego de 10% a 90%, modificados por la ecología.
`enableDemography`	`true`	Aplica modificadores demográficos a la recuperación.
`enableHuntingPressure`	`true`	Registra y aplica presión de caza.
`enableBreeding`	`true`	Permite nacimientos y crecimiento de fauna elegible.
`enableEcologyMessages`	`true`	Envía avisos automáticos por especie al chat.
`autoDetectWildlife`	`true`	Detecta fauna mediante categorías nativas resueltas.
`enableMigration`	`true`	Permite recolonización regional estadística.
`enableHabitat`	`true`	Aplica idoneidad de hábitat observada.
`enableFoodWeb`	`true`	Aplica disponibilidad de relaciones depredador/presa aprendidas.
`migrationPerDay`	`0.04`	Ganancia máxima de migración regional por día de juego.
`predatorMinFactor`	`0.4`	Factor mínimo de spawn de depredadores por disponibilidad alimentaria.
`faunaFolders`	`["Creature", "Aquatic", "Avian"]`	Carpetas aceptadas como fauna.
`excludedFolders`	`["Creature/Mythic", "Creature/Hunt"]`	Subcarpetas de fauna excluidas.
`excludedRoles`	`[]`	Exclusiones opcionales por rol.
`extraRoles`	`[]`	Inclusiones explícitas opcionales por rol.
`checkForUpdates`	`true`	Consulta el sitio y avisa de actualizaciones a jugadores con acceso al comando.
`debugLog`	`false`	Decisiones detalladas de spawn para diagnóstico.
`enableForaging`	`true`	Activa búsquedas por hambre para depredadores elegibles de la lista.
`foragingRoles`	`20 roles nativos`	Lista explícita de roles; consulta la lista predeterminada abajo.
`forageHungerMinutes`	`40.0`	Minutos reales cargados de alimentado a totalmente hambriento con presas normales.
`forageStartHunger`	`0.5`	Fracción de hambre que permite iniciar búsquedas.
`forageStepBlocks`	`24`	Longitud de cada paso de búsqueda en bloques.
`maxForagers`	`8`	Máximo de búsquedas simultáneas por mundo; 0 desactiva las búsquedas.

Roles predeterminados para buscar alimento

["Wolf_Black", "Wolf_White", "Fox", "Hyena", "Bear_Grizzly", "Bear_Polar", "Leopard_Snow", "Tiger_Sabertooth", "Raptor_Cave", "Crocodile", "Rex_Cave", "Toad_Rhino", "Toad_Rhino_Magma", "Snake_Cobra", "Snake_Marsh", "Snake_Rattle", "Spider", "Molerat", "Spider_Cave", "Spider_Cave_Ambush"]

Archivos de datos y recuperación

Ruta	Finalidad
`populations.json`	Poblaciones, hábitat, presión y control reproductivo.
`populations.journal`	Actualizaciones incrementales confirmadas de población.
`food-relations.json`	Checkpoint de evidencias aprendidas de depredador/presa.
`food-relations.json.journal`	Evidencias alimentarias incrementales confirmadas.

Los archivos están en <world save>/WorldPulse/. Los componentes de ciclo vital de las crías se guardan con las entidades nativas. Conserva entidades y archivos de WorldPulse juntos en las copias de seguridad.

Los checkpoints se reemplazan de forma atómica y los journals reproducen registros confirmados. Se ignora una última línea incompleta. Los registros confirmados inválidos o formatos futuros no compatibles preservan los originales y suspenden la capacidad afectada en vez de reiniciar silenciosamente. Un fallo alimentario queda aislado de los checkpoints poblacionales. Logs y /wp inspect informan de fallos alimentarios. Un cierre abrupto antes de confirmar una escritura asíncrona aún puede perder esa observación pendiente.

Ante un error de persistencia, detén el servidor y haz copia de los archivos antes de restaurar una copia válida. No borres datos como paso habitual de actualización.

Recomendaciones

Empieza con los valores predeterminados y deja pasar varios días de juego para observar la respuesta.
Alterna las zonas de caza. Aumenta recoveryDays o reduce killImpact para ajustar el ritmo.
Usa /wp inspect <role> antes de añadir ajustes de compatibilidad. La mayoría de animales bien clasificados no necesita registro manual.
Haz copia de los datos antes de cambiar regionSizeChunks; otra cuadrícula regional cambia la correspondencia entre coordenadas guardadas y terreno.

Cómo comprobar el funcionamiento

Comprueba WorldPulse y enabled=true en los logs de inicio; no se necesitan comandos para jugar.
Usa /wp stats para ver el catálogo y /wp inspect <role> con un rol real del juego o paquete instalado.
Caza fauna natural elegible y consulta /wp here para observar la reducción local. Los animales creados manualmente no sustituyen la prueba.
Deja funcionar el mundo varios días de juego. Observa recuperación y, cuando haya condiciones, nacimientos y crecimiento. Los avisos tienen intervalos.
Guarda, cierra y reinicia el mundo. Comprueba una región reducida y las crías para verificar la persistencia.

Estado y limitaciones conocidas

Proyecto activo. La detección automática necesita metadatos utilizables y modelos válidos. Los assets defectuosos de terceros pueden excluir roles concretos. La migración regional modifica la salud poblacional; los depredadores hambrientos compatibles pueden desplazarse por terreno cargado mediante navegación nativa. Las búsquedas dependen del terreno, las presas y el comportamiento nativo y no garantizan encuentros. No se sacrifican animales existentes. Las frases de los avisos ecológicos están en inglés; los nombres de especies usan traducciones disponibles del juego con una alternativa legible.