Описание
# 🧠 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](https://modrinth.com/plugin/fancynpcs/versions)
- [Citizens](https://www.spigotmc.org/resources/citizens.13811/)
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
- Rainbow 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 information |
| `/animatednpcs reload` | Reload config |
| `/animatednpcs animate on/off` | Toggle animations |
| `/animatednpcs particle ` | Set particles |
| `/animatednpcs hologram ` | Set hologram |
| `/animatednpcs glow ` | Toggle glow |
| `/animatednpcs sound ` | 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](chatgpt://generic-entity?number=2)
- [Citizens](chatgpt://generic-entity?number=3)
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
- Rainbow 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 Infos |
| `/animatednpcs reload` | Config reload |
| `/animatednpcs animate on/off` | Animationen |
| `/animatednpcs particle ` | Partikel |
| `/animatednpcs hologram ` | Hologramm |
| `/animatednpcs glow ` | Glow |
| `/animatednpcs sound ` | 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.