🧠 AnimatedNPCs

A powerful Paper 1.20.x plugin that makes your existing NPCs feel truly alive.

Instead of static NPCs, AnimatedNPCs adds animations, reactions, and immersive behavior to your already existing NPC systems – without replacing them.

---

⚠️ IMPORTANT

This plugin works with:

• FancyNPCs
• Citizens

It does NOT:

• create its own NPC system
• replace FancyNPCs or Citizens
• require ProtocolLib
• spawn new NPC systems

AnimatedNPCs only enhances existing NPCs.

---

🎯 WHAT IT DOES

AnimatedNPCs turns static NPCs into immersive world entities.

NPCs move, react to players, and use visual + audio effects to feel naturally alive inside your server world.

---

✨ FEATURES

🧍 Animations

• Smooth head tracking toward nearby players
• Idle animations (breathing, swaying)
• Waving, nodding, gestures
• Smooth rotation system
• Floating & small jumps
• Random micro-movements for realism

---

🎆 VISUAL EFFECTS

• Fully configurable particle system per NPC
  • Aura effects
  • Proximity-based particles
• Optional glow effect
• ✨ name tags
• Smooth holograms (no flicker)

---

🔊 SOUNDS

• Ambient sounds near NPCs
• Interaction sounds on click
• Anti-spam cooldown system
• Fully configurable per NPC

---

🧠 BEHAVIOR (VISUAL LOGIC)

• NPCs react to nearby players
• Random animation intervals
• Configurable range & probability
• Cooldown-based movement logic for realism

---

⚙️ CONFIGURATION

Each NPC is fully individual:

• Enable/disable animations
• Particle type & intensity
• Sound settings
• Multi-line holograms
• Glow & name tag effects
• Trigger ranges
• Random behavior probabilities

Everything can be changed via commands and reloaded instantly.

---

📋 COMMANDS

Command	Description
/animatednpcs list	Show all NPCs
/animatednpcs info <npc>	NPC information
/animatednpcs reload	Reload config
/animatednpcs animate <npc> <anim> on/off	Toggle animations
/animatednpcs particle <npc>	Set particles
/animatednpcs hologram <npc>	Set hologram
/animatednpcs glow <npc>	Toggle glow
/animatednpcs sound <npc>	Manage sounds

---

🔐 PERMISSIONS

• animatednpcs.admin – full access
• animatednpcs.reload – reload config
• animatednpcs.list – list NPCs
• animatednpcs.info – view NPC info
• animatednpcs.animate – manage animations
• animatednpcs.particle – manage particles
• animatednpcs.hologram – manage holograms
• animatednpcs.glow – toggle glow
• animatednpcs.sound – manage sounds

---

⚡ PERFORMANCE

Built for large servers:

• No ProtocolLib required
• Centralized update system
• NPC caching instead of repeated lookups
• Optimized for high NPC counts

---

🌍 LANGUAGES

• English
• German
• Fully configurable
• Expandable for more languages

---

📦 COMPATIBILITY

• Paper 1.20.x
• Java 21
• Requires FancyNPCs OR Citizens
• No ProtocolLib required
• No custom NPC system included

---

🚀 GOAL

Make NPCs feel alive instead of decorative – perfect for modern lobby, city, and network servers.

---

🧠 AnimatedNPCs (Deutsch)

Ein leistungsstarkes Paper 1.20.x Plugin, das bestehende NPCs lebendig macht.

Statt statischer NPCs fügt AnimatedNPCs Animationen, Reaktionen und visuelle Effekte hinzu – ohne das NPC-System zu ersetzen.

---

⚠️ WICHTIG

Das Plugin funktioniert mit:

• FancyNPCs
• Citizens

Es:

• erstellt keine eigenen NPCs
• ersetzt kein NPC-System
• benötigt kein ProtocolLib

AnimatedNPCs erweitert nur bestehende NPCs.

---

🎯 FUNKTION

NPCs wirken nicht mehr wie Dekoration, sondern wie Teil der Welt.

Sie bewegen sich, reagieren auf Spieler und nutzen visuelle sowie akustische Effekte.

---

✨ FEATURES

🧍 Animationen

• Spieler-Tracking (sanft)
• Idle Bewegungen (Atmen, Swaying)
• Winken, Nicken, Gesten
• Smooth Rotation
• Floating & kleine Sprünge
• Zufällige Mikro-Bewegungen

---

🎆 EFFEKTE

• Partikel pro NPC konfigurierbar
• Aura & Nähe-Effekte
• Optionaler Glow
• ✨ Nametags
• Smooth Hologramme

---

🔊 SOUNDS

• Ambient Sounds bei Nähe
• Klick-Sounds bei Interaktion
• Cooldown gegen Spam
• Pro NPC einstellbar

---

🧠 VERHALTEN

• NPC reagiert auf Spieler
• Zufällige Animationen
• Reichweite & Wahrscheinlichkeit
• Cooldown-System für Natürlichkeit

---

⚙️ KONFIGURATION

Jeder NPC ist individuell konfigurierbar:

• Animationen an/aus
• Partikel & Intensität
• Sounds
• Hologramme (mehrzeilig)
• Glow & Nametags
• Trigger & Reichweite
• Zufallsverhalten

Alles per Command & sofort reloadbar.

---

📋 BEFEHLE

Befehl	Beschreibung
/animatednpcs list	NPC Liste
/animatednpcs info <npc>	NPC Infos
/animatednpcs reload	Config reload
/animatednpcs animate <npc> <anim> on/off	Animationen
/animatednpcs particle <npc>	Partikel
/animatednpcs hologram <npc>	Hologramm
/animatednpcs glow <npc>	Glow
/animatednpcs sound <npc>	Sounds

---

🔐 PERMISSIONS

• animatednpcs.admin – Vollzugriff
• animatednpcs.reload – Reload
• animatednpcs.list – NPC Liste
• animatednpcs.info – Infos
• animatednpcs.animate – Animationen
• animatednpcs.particle – Partikel
• animatednpcs.hologram – Hologramme
• animatednpcs.glow – Glow
• animatednpcs.sound – Sounds

---

⚡ PERFORMANCE

Optimiert für große Server:

• Kein ProtocolLib
• Zentrale Update-Logik
• NPC Caching
• Skalierbar für viele NPCs

---

🌍 SPRACHEN

• Englisch
• Deutsch
• Vollständig konfigurierbar
• Erweiterbar

---

📦 KOMPATIBILITÄT

• Paper 1.20.x
• Java 21
• FancyNPCs ODER Citizens erforderlich
• Kein ProtocolLib

---

🚀 ZIEL

NPCs sollen sich lebendig anfühlen statt statisch – ideal für moderne Server-Netzwerke.