🐣 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 · ✨_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, ✨_ARC, BUNNY_HOP, FLOWER_BLOOM, SPRING_BREEZE

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

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

---

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