Turn passive farm mobs into dynamic, configurable, performance-safe hostile encounters.
FaunaReborn is a premium-style Paper/Folia plugin that transforms chickens, cows and pigs into intelligent hostile entities with environmental scaling, social alert behavior, and server-friendly safeguards.
FaunaReborn is built for servers that want more tension, replayability and survival depth without replacing vanilla identity.
- Native Paper support (
1.21+API). - Folia-compatible architecture.
- Modular design per species (Chicken, Cow, Pig).
- Production-focused config layout with world filtering and hard safety caps.
- Chicken Hostility Engine with multi-attacker control, threat decay, line-of-sight logic, and configurable movement behavior.
- Cow Milk Provocation: milking can trigger warning, chase, charge and attack phases.
- Pig Rod Provocation: fishing-rod interaction can trigger pig retaliation and charge behavior.
- Resource Territoriality for chickens/cows/pigs when players repeatedly pick up species-related drops.
- Social Alert Propagation lets nearby mobs join aggression events.
- Configurable responder radius, join cooldowns, and maximum responders.
- Optional adult-only response behavior.
- Rain, thunderstorm and full-moon behavior modifiers.
- Night combo profiles (night+rain, night+storm, night+full moon).
- Tunable multipliers for aggression, detection, damage, speed and persistence.
- Weighted target scoring (health, distance, threat, line of sight).
- Retarget cooldown and multi-candidate requirements.
- Ignore filters for adventure mode, invisibility, vanish and god-mode setups.
- Built-in LOD (Level of Detail) tiers with hysteresis and per-tier tick intervals.
- Global/chunk processing caps to avoid spikes.
- Tick-level processing limits.
- Cache-based environment context updates.
- Built with production operation in mind for long-running servers.
- In-game GUI toggles for entity modules.
- Live reload workflow without restarting the server.
- Config-driven world filtering (
ALL,WHITELIST,BLACKLIST).
| Command | Description | Permission |
|---|---|---|
/fauna |
Opens the help menu. | fauna.command.help |
/fauna help [page] |
Shows command help filtered by sender permissions. | fauna.command.help |
/fauna version |
Shows plugin/runtime version information. | fauna.command.version |
/fauna about |
Shows a short professional plugin summary. | fauna.command.about |
/fauna entities |
Lists supported entities and enabled/disabled state. | fauna.command.entities |
/fauna reload |
Reloads plugin configuration and modules. | fauna.command.reload (or fauna.admin / fauna.*) |
/fauna gui |
Opens the FaunaReborn management GUI. | fauna.command.gui (or fauna.admin / fauna.*) |
/faunareborn/fr
| Permission | Description | Default |
|---|---|---|
fauna.* |
Grants access to all FaunaReborn commands. | op |
fauna.admin |
Grants access to FaunaReborn administrative commands. | op |
fauna.command.help |
Allows viewing the FaunaReborn help menu. | true |
fauna.command.help.admin |
Allows viewing administrative commands in /fauna help. |
op |
fauna.command.version |
Allows viewing plugin version/runtime info. | true |
fauna.command.about |
Allows viewing information about FaunaReborn. | true |
fauna.command.entities |
Allows viewing supported FaunaReborn entities. | true |
fauna.command.reload |
Allows reloading configuration and modules. | op |
fauna.command.gui |
Allows opening the admin GUI. | op |
- Server software: Paper (recommended)
- Minecraft API target:
1.21 - Folia: Supported
- Dependencies: None required
- Stop your server.
- Place the plugin
.jarinplugins/. - Start server once to generate default files.
- Edit:
plugins/FaunaReborn/config.ymlplugins/FaunaReborn/entities/chicken.ymlplugins/FaunaReborn/entities/cow.ymlplugins/FaunaReborn/entities/pig.yml
- Run
/fauna reloador restart.
global-enabled: master switch.world-filter: global activation mode and world list.lod: distance-based LOD tiers with hysteresis and per-tier tick cadence.targeting.scoring: weighted target priority behavior.activation.*: natural-spawn and naming filters.- Entity files (
entities/*.yml): species-specific aggression, social and environmental behavior.
Use one of the following lod blocks in config.yml depending on your server profile.
lod:
enabled: true
hysteresis-distance: 3.0
distances:
high: 14.0
medium: 28.0
low: 44.0
interval-ticks:
high: 1
medium: 2
low: 5
off: 10lod:
enabled: true
hysteresis-distance: 2.0
distances:
high: 18.0
medium: 34.0
low: 52.0
interval-ticks:
high: 1
medium: 2
low: 4
off: 8lod:
enabled: true
hysteresis-distance: 4.0
distances:
high: 10.0
medium: 22.0
low: 36.0
interval-ticks:
high: 2
medium: 4
low: 8
off: 14- Keeps vanilla mobs recognizable while adding premium-tier encounter depth.
- Fully configurable for casual SMP, hardcore survival, or RPG progression.
- Safe defaults with explicit performance guardrails.
- Designed for production deployments and marketplace-grade delivery.
FaunaReborn is a configurable hostile-fauna combat plugin for Paper/Folia servers, featuring per-species AI modules, social propagation, weather/moon aggression scaling, GUI controls, and performance-focused safeguards.
Use the repository channels according to purpose:
- Bug reports: Issues
- Feature requests: Issues
- Questions and setup help: Discussions (Q&A)
- Project updates and announcements: Discussions (Announcements)
Please follow the pinned discussion:
Contributions are welcome and reviewed in detail by the maintainer.
- Read the contribution guide first: CONTRIBUTING.md
- Use the provided issue forms and pull request template for consistency.
- Keep changes focused, validated, and production-safe (Paper/Folia compatibility and performance-aware behavior).
Do not disclose vulnerabilities publicly first. Please report security issues privately to the maintainer.
This project is licensed under the MIT License. See LICENSE for full details.