🐣 NPresents Fork — Easter Edition v2.0

Extended seasonal event plugin for Minecraft servers.
Fork of NPresents by n1zamu — with 19 animations, new commands, localization and bug fixes.

---

📝 Description

NPresents Fork is a plugin for organizing seasonal collection events on your server. Admins hide custom player heads (eggs, pumpkins, presents — texture is configurable) around the map, and players search for them. Breaking a head triggers a reward command, a fancy animation, and tracks progress. Collect all of them to earn a final prize.

Works for any holiday — Easter, Halloween, New Year, server anniversary — just change the head texture and animation type in the config.

---

🎬 19 Collection Animations

The main feature of this fork. Each animation is a unique combination of particles, sounds, and ArmorStand movement that plays when a player collects a present. Set it with one line in config:

animationType: "EGG_CRACK"

| Theme | Animations |
|-------|-----------|
| Universal (4) | RISE_AND_EXPLODE · SPIRAL_UP · FIREWORK_BURST · BOUNCE_FADE |
| Halloween (5) | GHOST_FLOAT · SOUL_DRAIN · BAT_SWARM · WITCH_CAULDRON · PUMPKIN_SMASH |
| New Year (5) | CONFETTI_POP · SNOWFLAKE_RISE · CHAMPAGNE_BURST · CLOCK_COUNTDOWN · STAR_TRAIL |
| Easter (5) | EGG_CRACK · RAINBOW_ARC · BUNNY_HOP · FLOWER_BLOOM · SPRING_BREEZE |

Preview any animation in-game: /nPresent test BUNNY_HOP

---

🆕 5 New Commands

In addition to the original give, edit, clear, reload:

| Command | Description |
|---------|-------------|
| /nPresent setcoords <cmd> | Enter a reward command, then right-click any block to place a present there |
| /nPresent search [radius] [minY] [maxY] | Async search for all placed presents in a radius |
| /nPresent test [type/list/off] | Admin test mode — break presents to preview animations, no rewards given |
| /nPresent list | Show all placed presents with coordinates |
| /nPresent basehead | Display the texture of the held skull and compare it with config |

---

🌍 Localization

All messages are stored in separate language files. Russian and English included out of the box. Switch with one line:

language: "en"  # or "ru"

Files are in plugins/NPresents/lang/ — edit them or add your own language.

---

🛡️ Fixes & Improvements

• SQL injection fixed — all queries now use PreparedStatement (original concatenated strings)
• Null-safety — plugin won't crash if world is unloaded or texture is missing
• ConcurrentHashMap for animations — no concurrent modification errors
• Marker ArmorStand — zero hitbox, doesn't interfere with players
• Placement feedback — coordinates shown in chat when a present is placed
• Admin RMB info — right-click any head with admin permission to see its texture & bound command
• Command aliases — /npresent, /np, /egg
• api-version updated to 1.16 (was 1.13)

---

📋 Commands & Permissions

| Command | Permission |
|---------|------------|
| /nPresent give <player> <command> | nPresent.give |
| /nPresent setcoords <command> | nPresent.give |
| /nPresent edit | nPresent.edit |
| /nPresent clear | nPresent.clear |
| /nPresent reload | nPresent.reload |
| /nPresent search [r] [minY] [maxY] | nPresent.search |
| /nPresent test [type/list/off] | nPresent.test |
| /nPresent list | nPresent.list |
| /nPresent basehead | nPresent.basehead |

nPresent.admin grants access to all commands.

---

⚙️ Requirements

• Minecraft 1.16+
• Spigot / Paper
• Java 8+
• SQLite (default) or YAML database

---

📦 Installation

1. Download the .jar from the files section
2. Place it in your server's plugins folder
3. Restart the server
4. Configure config.yml — choose animation type, language, head texture
5. Place presents using give or setcoords

---

Based on NPresents by n1zamu · MIT License

---

---

🇷🇺 Описание на русском

NPresents Fork — Easter Edition v2.0

Расширенный плагин для сезонных ивентов по сбору подарков. Форк NPresents от n1zamu.

Админ прячет на карте специальные головы (подарки, яйца, тыквы — текстура настраивается), игроки ищут и ломают их, получая награды. Кто соберёт все — получит финальный приз.

Что нового в форке

19 анимаций при сборе (в оригинале была 1) — тематики: Хэллоуин, Новый Год, Пасха, универсальные. Каждая анимация — уникальные партиклы, звуки, движения. Настраивается одной строкой: animationType: "EGG_CRACK"

5 новых команд:

• /nPresent setcoords <cmd> — ввёл команду → ПКМ по блоку → подарок установлен
• /nPresent search [радиус] [minY] [maxY] — асинхронный поиск подарков в радиусе
• /nPresent test [тип/list/off] — тест анимаций без выдачи наград
• /nPresent list — список всех подарков с координатами
• /nPresent basehead — текстура головы в руке + сравнение с конфигом

Локализация — русский и английский в комплекте. Переключение: language: "ru"

Исправления:

• SQL-инъекция исправлена (PreparedStatement вместо конкатенации строк)
• Null-safety, ConcurrentHashMap для анимаций
• Marker ArmorStand (нулевой хитбокс)
• Админ-инфо по ПКМ, уведомления при установке
• Алиасы: /npresent, /np, /egg

Типы анимаций

| Тема | Анимации |
|------|----------|
| Универсальные (4) | RISE_AND_EXPLODE, SPIRAL_UP, FIREWORK_BURST, BOUNCE_FADE |
| Хэллоуин (5) | GHOST_FLOAT, SOUL_DRAIN, BAT_SWARM, WITCH_CAULDRON, PUMPKIN_SMASH |
| Новый Год (5) | CONFETTI_POP, SNOWFLAKE_RISE, CHAMPAGNE_BURST, CLOCK_COUNTDOWN, STAR_TRAIL |
| Пасха (5) | EGG_CRACK, RAINBOW_ARC, BUNNY_HOP, FLOWER_BLOOM, SPRING_BREEZE |

Совместимость

• Minecraft 1.16+
• Spigot / Paper
• Java 8+
• SQLite или YAML

---

Основано на NPresents от n1zamu · Лицензия MIT