Skip to content

Configuration

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

Configuration

Purpose

This page documents the real runtime configuration of FaunaReborn as generated in:

  • plugins/FaunaReborn/config.yml
  • plugins/FaunaReborn/entities/chicken.yml
  • plugins/FaunaReborn/entities/cow.yml
  • plugins/FaunaReborn/entities/pig.yml

Configuration Layout

Global file

config.yml controls plugin-wide behavior:

  • Global enable/disable
  • Language selection
  • World filter
  • LOD and processing cadence
  • Targeting logic and ignore filters
  • Difficulty/world damage scaling
  • Activation gates
  • Performance hard caps
  • Optional visual/night behaviors

Entity files

entities/*.yml control per-species behavior:

  • Chicken hostility engine and territorial pickup logic
  • Cow milk provocation + resource provocation
  • Pig rod provocation + resource provocation
  • Social alerts and environment modifiers per species

Global Configuration (config.yml)

Core toggles

  • config-version
  • global-enabled

If global-enabled: false, FaunaReborn systems are effectively disabled.

Language

language:
  file: en

Supported shipped files:

  • en -> lang/english.yml
  • es -> lang/spanish.yml
  • pt -> lang/portuguese.yml

World filter

world-filter:
  mode: ALL # ALL | WHITELIST | BLACKLIST
  worlds: []
  • ALL: enabled everywhere
  • WHITELIST: enabled only in listed worlds
  • BLACKLIST: enabled except listed worlds

LOD (Level of Detail)

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: 10

Controls processing frequency by player distance to reduce CPU pressure.

Targeting

targeting:
  ignore:
    adventure: true
    invisible-potion: true
    vanished: true
    god-mode: true
  scoring:
    enabled: true

Scoring block also includes weight values and retarget behavior:

  • health-weight
  • distance-weight
  • current-threat-weight
  • line-of-sight-bonus
  • retarget-cooldown-seconds
  • require-multiple-candidates

Damage scaling

  • damage-scaling.difficulty-multipliers (peaceful/easy/normal/hard)
  • damage-scaling.world-multipliers (per-world overrides)

Activation gates

activation:
  chance: 1.0
  only-natural: true
  ignore-named: true

Performance caps

  • max-active-hostile-chickens-per-chunk
  • max-active-hostile-chickens-per-world
  • max-processed-chickens-per-tick

These are key protections against spikes.

Optional behavior blocks

  • night-behavior
  • visual-effects (glow, particles, sound)

Entity Configuration

entities/chicken.yml

Primary blocks:

  • chicken-hostility.enabled
  • Attack tuning (attack-damage, attack-cooldown, attack-range)
  • Threat lifecycle (threat-timeout, retarget-grace, LOS reset)
  • Target limits (max-simultaneous-attackers-per-player)
  • social-alert (triggers, radius, cooldowns, max responders)
  • Movement controller (movement-speed-multiplier, jump/distance boost)
  • item-pickup-territoriality (thresholds, time window, aggression duration)
  • environment-modifiers (rain, thunderstorm, full-moon, combinations)

entities/cow.yml

Primary blocks:

  • cow.enabled
  • cow-hostility.social-alert
  • cow-milk-provocation (warning, chase, charge, attack, targeting)
  • cow-resource-provocation (thresholds, detection, cooldown, aggression)
  • environment-modifiers

entities/pig.yml

Primary blocks:

  • pig.enabled
  • pig-hostility.social-alert
  • pig-rod-provocation (rod trigger, warning, charge, attack, targeting)
  • pig-resource-provocation (thresholds, detection, cooldown, aggression)
  • environment-modifiers

Troubleshooting Config Issues

  • YAML syntax errors: check indentation/spaces, then reload/restart.
  • Behavior not changing: verify edited file path is under plugins/FaunaReborn/.
  • Unexpected aggression volume: reduce social responder limits and raise provocation thresholds.
  • Tick spikes: increase LOD intervals and lower active/processed caps.

Related Pages

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

Clone this wiki locally