WorldPulse

Wildlife that reacts to hunting, breeds and grows
For single-player worlds, friend-hosted worlds and dedicated servers.

Hunt the same area every day and its wildlife becomes scarce. Leave it alone and populations recover, with suitable neighbouring regions helping them return. Healthy wildlife can breed, and young animals grow into adults.

WorldPulse runs automatically in single-player worlds, friend-hosted worlds and dedicated servers. Install it and play. Commands are for administration and diagnosis.

■ Features

• Regional populations: each species has its own population health in every region, 8 x 8 chunks by default. Player hunting reduces future natural spawning there.
• Recovery and hunting pressure: populations recover over in-game days. Habitat and pressure affect recovery, while healthy neighbours can support recolonization.
• Physical breeding: eligible natural wildlife can produce young when parents, population health, habitat and native spawn limits allow it.
• Growing young: young animals start smaller and weaker, then grow gradually. Native juvenile roles are used when a reliable relation exists; otherwise the original model is scaled.
• Notices for each affected species: nearby players receive chat messages about decline, scarcity, recovery, hunting pressure, actual births and adulthood, with cooldowns.
• Native and modded wildlife: registered role metadata supplies classification, models and names. No player setup or built-in list of another mod's animals is required.
• Learned predator relations: repeated predator kills establish local prey links. Prey scarcity can then reduce future predator spawning; unknown diets remain neutral.
• Persistent worlds: populations, pressure, breeding cooldowns, young animal state and learned food relations survive saves and restarts.
• Hungry predators: 20 configured native predator roles can search nearby loaded terrain for food using native navigation. Prey scarcity accelerates hunger, while native aggression remains independent.
• Marker and beacon fauna: eligible natural animals from map markers and ambient beacons participate in ecology and breeding within their own native spawn limits. Pets, monsters and scripted encounters retain their exclusions.

■ How it plays

Each region keeps a population-health index for each wildlife species. Hunting reduces future natural spawning, while habitat, hunting pressure and suitable neighbours influence recovery. Existing animals are not removed. Healthy eligible wildlife can produce young animals within native spawn and collision limits.

Species names and capabilities come from the registered game data, including other mods. Unknown diets remain neutral until repeated natural predation supplies evidence. No player commands or manual species registration are needed for ordinary play.

■ Predator hunger and foraging

Eligible adult predators accumulate hunger only while loaded. With normal prey availability, the default pace is 40 loaded minutes from fed to fully hungry; known prey scarcity can double that pace. Searching starts at 50% hunger, uses 24-block steps and allows up to eight simultaneous searches per world by default. Successful eligible hunts reduce hunger.

Predators use native navigation and combat. They search nearby loaded terrain and suitable neighbouring areas, with bounded work and retries for blocked routes. WorldPulse does not locate beds, homes or distant players and does not spawn or teleport predators to create encounters. Existing native aggression remains active regardless of hunger.

The default list contains 20 native roles. Adding a modded role to foragingRoles does not guarantee compatibility: the role also needs a supported native template, movement and usable metadata. Tamed animals leave this system. Loaded-time hunger and lifecycle state persist with the animal; offline time does not accumulate a queue of hunts or births.

Compatibility uses registered data rather than bundled copies or per-pack patches. WildTale 5.2 was checked alongside WorldPulse, including eligible wildlife and capture/taming transitions. Invalid third-party roles and item spawners remain the responsibility of their source mod. Foraging support is narrower than population tracking; an animal can participate in ecology without gaining a new foraging AI.

■ Installation

1. Requires Hytale 0.7.0+.
2. Download WorldPulse-0.3.0.jar from the CurseForge Files tab.
3. Close the world or server. Replace the previous WorldPulse JAR in UserData/Mods/ or the server's mods/ folder, keeping only one copy.
4. Start the world. No player commands are needed. Configuration is created at mods/durkz_WorldPulse/WorldPulse.json.

■ Commands

Admin command: /wp. Regular players receive ecology notices without command permission.

/wp here
/wp set <species> <percent>
/wp tick <days>
/wp reset
/wp stats
/wp inspect <role>

■ Config

File: mods/durkz_WorldPulse/WorldPulse.json. Restart after editing. Breeding, foraging, messages, automatic wildlife discovery, habitat, migration and the food web have separate toggles. See the documentation for all defaults.

■ Permissions

• durkz.worldpulse.command.wp: access to /wp commands and update notices. Operators have it by default.

■ Recommended

• Start with the defaults and give populations several in-game days to respond.
• Rotate hunting grounds. Raise recoveryDays or lower killImpact to adjust the pace.
• Use /wp inspect <role> before adding compatibility overrides. Most correctly classified wildlife needs no manual registration.
• Back up world data before changing regionSizeChunks; a different region grid changes how saved coordinates map to terrain.

■ Status and known limitations

Automatic discovery depends on usable role metadata and valid models. Broken third-party assets can exclude individual roles. Regional migration changes population health; compatible hungry predators can separately move through loaded terrain using native navigation. Searches depend on terrain, prey and native behaviour and do not guarantee an encounter. Existing animals are not culled. Ecology message sentences are currently English; species labels use available game translations with a readable fallback.

Full documentation | Report a bug

License: All Rights Reserved