Skip to content

FAQ

Jump to bottom
SkyCore edited this page May 14, 2026 · 2 revisions

FAQ

General

What is FaunaReborn?

FaunaReborn is a Paper/Folia plugin that turns passive farm mobs into configurable hostile encounters.
Current species modules are:

  • Chicken
  • Cow
  • Pig

Which server software is supported?

FaunaReborn is built against Paper API 1.21.x and is designed for Paper-compatible servers.
folia-supported: true is declared in the plugin metadata.

Which Java version do I need?

Use Java 21.

Does FaunaReborn require other plugins?

No. It has no required runtime dependencies.

Installation and Startup

Where do I place the plugin JAR?

In your server plugins/ directory.

What files are generated on first startup?

Under plugins/FaunaReborn/:

  • config.yml
  • entities/chicken.yml
  • entities/cow.yml
  • entities/pig.yml
  • lang/english.yml
  • lang/spanish.yml
  • lang/portuguese.yml

How do I confirm the plugin loaded correctly?

Check startup logs for successful enable and absence of exceptions.
Then run /fauna version and /fauna entities.

Commands

What is the base command?

/fauna

Are there aliases?

Yes:

  • /faunareborn
  • /fr

Which subcommands exist right now?

  • help
  • version
  • about
  • entities
  • reload
  • gui
  • lang

What happens if I run /fauna with no subcommand?

It opens help (if you have fauna.command.help).

Why does /fauna help show different commands for different users?

Help output is permission-filtered per sender.

How do I change language at runtime?

Use /fauna lang <code> with fauna.command.lang.
Available bundled codes are en, es, and pt.

Permissions

What is the difference between fauna.admin and fauna.*?

  • fauna.admin grants admin operations (reload, gui, lang).
  • fauna.* grants all FaunaReborn permissions, including admin and non-admin command nodes.

Which nodes are usually safe for regular players?

Typically:

  • fauna.command.help
  • fauna.command.version
  • fauna.command.about
  • fauna.command.entities

Why can a user run /fauna version but not /fauna reload?

version is default true, while reload is default op.

Which permission reveals admin commands in help?

fauna.command.help.admin

Configuration

What does global-enabled do?

It is the master on/off switch for plugin behavior.

How do I restrict FaunaReborn to specific worlds?

Use world-filter in config.yml:

  • mode: ALL
  • mode: WHITELIST
  • mode: BLACKLIST
  • worlds: [...]

What is LOD and why is it important?

lod (Level of Detail) adjusts processing cadence by player distance to reduce CPU load and tick pressure.

Where do I tune targeting behavior?

In config.yml under:

  • targeting.ignore
  • targeting.scoring

What do targeting ignore flags control?

They avoid selecting protected players, including adventure mode, invisibility potion users, vanished users, and god-mode users (depending on your environment/tooling).

How do I reduce aggression globally?

Start with:

  • Raising thresholds in entities/*.yml provocation sections
  • Lowering social responder counts
  • Increasing cooldowns
  • Reducing detection radius and speed multipliers

How do I reduce performance impact?

Start with:

  • More conservative lod.interval-ticks
  • Smaller lod high/medium/low ranges
  • Lower hard caps (active per chunk/world, processed per tick)
  • Lower social responder limits in entity files

Entity Behavior

Where is chicken behavior configured?

entities/chicken.yml
Includes hostility engine, social alert, movement tuning, item pickup territoriality, and environment modifiers.

Where is cow behavior configured?

entities/cow.yml
Includes milk provocation, resource provocation, social alert, attack/charge tuning, and environment modifiers.

Where is pig behavior configured?

entities/pig.yml
Includes rod provocation, resource provocation, social alert, attack/charge tuning, and environment modifiers.

Do weather and moon phases affect aggression?

Yes. Entity configs include environment modifiers for rain, thunderstorm, full moon, and combination profiles.

Reloads, Restarts, and Changes

Should I use /fauna reload or restart?

Use /fauna reload for normal config iteration.
For major rollout changes or unstable behavior, prefer a full restart.

I changed config but behavior did not update. Why?

Most common causes:

  • Edited wrong file path (not under plugins/FaunaReborn/)
  • YAML indentation/syntax issue
  • Reload not executed successfully
  • Cached/live state requiring a full restart

Is frequent reload in production recommended?

Use cautiously. Batch changes and validate in staging first.

Troubleshooting

Plugin does not enable

Check:

  • Java 21 runtime
  • Paper-compatible server and version
  • JAR in correct plugins/ path
  • Full startup stack trace

Command says “no permission”

Check assigned nodes and inheritance (fauna.admin, fauna.*, granular command nodes).

Unknown command/subcommand

Use /fauna help and verify spelling and available subcommands.

Language does not change

Confirm:

  • Correct language code (en, es, pt)
  • fauna.command.lang permission
  • Language files exist and are valid YAML

Server lag increases after enabling FaunaReborn

Tune:

  • lod distances/intervals
  • Processing caps
  • Social propagation limits
  • Provocation thresholds

Quick Reference

Runtime language codes

  • en for English
  • es for Spanish (español)
  • pt for Portuguese (Português)

Core admin commands

  • /fauna reload
  • /fauna gui
  • /fauna lang <code>

Core validation commands

  • /fauna help
  • /fauna version
  • /fauna entities
  • /fauna about

Last updated: 2026-05-14
Project: https://github.com/devskycore/FaunaReborn

Clone this wiki locally